Configuration - 8.x
- Nisha Shantilal
- Sireesha Dugginapeddi [Appfire] (Inactive) (Deactivated)
- Former user (Deleted)
After installing or updating the app, as an admin you can configure the app settings in the Global Configuration screen (available since version 8.0.0).
To navigate to the screen:
- Log in as an administrator and select Cog menu
> Manage apps. - Select Advanced Tables for Confluence under the BOB SWIFT CONFIGURATION section in the sidebar.
The following configuration options are available:
- Global Configuration
- Profiles (available for CSV Table and JSON Table macros)
Global Configuration
| Parameter | Description |
|---|---|
| Restrict URL access | Enable this option to restrict access to remote locations specified in the URL parameter of the CSV Table and JSON Table macros must conform to the Confluence Allowlist; provided, the allowlist is enabled. Confluence allows the administrator to turn on the allowlist to restrict incoming and outgoing connections to only those connections that are configured in the Allowlist settings. If enabled, the URL parameter of the CSV Table and JSON Table macros are also restricted to only URLs that are configured in the Allowlist settings for Confluence only. |
| Allow JavaScript | Enable this option to allow execution of JavaScript within the Advanced Tables for Confluence macros. Available since version 8.3.0. This parameter is not applicable for the Attachment Table macro. You can also control JavaScript usage on pages that are using the Advanced Tables for Confluence macros by enabling the relevant entries in the Macro Security for Confluence Configuration page. Refer to Macro Security Configuration to understand how to enable macros. |
| Show JavaScript warning | Enable this option to display the warning message if the macro contains JavaScript content. To hide the warning message disable this option. Available since 8.5.0. This option is available only if Allow JavaScript is disabled. If Allow JavaScript option is disabled, and the macro contains JavaScript content, the JavaScript code is removed, and the macro renders the remaining content on the Confluence page. In such a case:
|
| Blacklist domains | Enable this option to blacklist certain domains. By default, this option is disabled for backward compatibility. Available since version 8.1.0. If enabled, and if a request from any of these sites is received, an error message is displayed. However, if users still need to access a blacklisted site, they must contact their system administrator to disable this option. If this option is disabled, access to all domains is permitted! Click the link named listed (in the description beneath the option) to view a pre-defined list of the most commonly blacklisted domains in a pop-up window. The following sites are blacklisted, by default:
|
| Maximum attachments to process | Administrators can control the maximum number of attachments to process for the Attachment Table macro. Select the limit for processing the maximum number of attachments from the drop-down. The default limit is 1000. The configuration also shows the approximate number of attachments available in the Confluence instance. (Available since app version 8.7.0.) Administrators should be cautious when increasing the configuration limit, as this may lead to heavy Confluence usage and potentially result in degrading the performance of Confluence. |
| Help us improve the product | Enable this option to report usage data that helps us to improve the app continually. The app does not send any private user data or personally identifiable information. To learn more about what is shared, refer to Analytics data. |
Profiles
Profiles consist of a common set of parameters that allow users to choose a profile in the macros. Available since 8.1.0. Some advantages of using profiles are:
- Profiles allow user authentication required by some URLs to be hidden from page viewers and editors. Only Confluence administrators have access to this information.
- Enables macro editors to quickly configure the macro by reusing a shared definition for URL access.
- Relative addressing can be used making the page content less likely to require changes when base URLs are relocated.
- Macro configured URL (that is not a full URL) is appended to the profile provided URL.
As only the CSV Table and JSON Table macros have the ability to access external data through URLs, profiles can be used only in these macros.
The page displays a list of profiles available for the macros. Click Add Profile to open a pop-up window as:
| Parameter | Description |
|---|---|
| Profile name | Enter a name for the profile. This name must be unique; else, the details specified overwrites the details of the existing profile. This may cause errors in pages where the profile is used. |
| Profile type | Specify whether this is a URL, GitLab, or GitHub profile. |
| URL | Enter the URL to be accessed. If the Profile type is either GitLab or GitHub, a default URL is displayed here that is editable. |
| User; Password | Enter the username and password to access the specified URL. |
| Access token | Applicable for GitLab and GitHub URLs. Administrators must generate the access tokens from either the GitLab or GitHub applications and enter that here. |
| URL parameters | Mention any extra parameters that must be appended to the URL here. |
| Request headers | Displays the request headers created as per the given information. |
You can perform the following actions on this page:
- Click
to edit the profile details. - Click
to remove the profile. - Click Save profile to create the profile.
If the first attempt fails while decrypting the password, the JSON Table and CSV Table macro initiates three retry attempts to decrypt the password. (Available since app version 8.7.1.)
Related content
Need support? Create a request with our support team.