Page Comparison

Specifies the list of options where CSV data is located. The included data follows the body data based on the location selected.

• Attachment - Data is read from the list of options selected for the following parameters:
  • Space - Lists all available spaces.
  • Page - Lists all the pages available from the selected space.
    The following options indicate:
    • @self - current space or page
    • @home - homepage of current space

    • @parent - parent page of current page or space
      

      Note
      While previewing the page before publishing for the first time, the result for @parent may not be displayed as expected. Once you save the document, you can view the result as expected.

      
      

  • Attachment - Lists all the attachments from the selected page.

• Filename - Data is read from the input specified in the File name field. You can specify the file located in Confluence home directory/script/filename, also subdirectories.

• Template - Data is read from a global page template specified in the Name of the template field. 
  

  Info
  Special note: How to deal with templates on Confluence 4.3 and later.

  
  

• URL - Data is read from the URL of CSV data, Username, Password, and Connection timeout fields that are explained in the succeeding rows.

• Profile - Data is read from external applications such as GitLab and GitHub with a pre-defined set of parameters. If selected, you must then specify the profile (Profiles) and the URL (URL of CSV data) of the CSV file(s). Available from 8.1.0 version. 
  

  Info
  This option appears only if at least one profile exists in your instance. For more information about profiles, refer to the Configuration documentation.

  
  

Specifies the URL of a CSV file. If specified, the included data follows the body and script data. If a profile is specified in the Profiles field, enter the relative path of the actual location of the CSV file(s) here. Support for profiles is available from 8.1.0 version.

User password for URL access via basic authentication. The Password is encrypted and remains secure (available from version 8.6.0).

• , (comma) - The default column separator.
• whitespace - Blanks, tabs, and other white space are used to separate columns.
• tab - A single tab character is used to separate columns.
• blanks - Blank or blanks only.
• pipe - To use pipe as a delimiter, enter the text ‘pipe’ as macro does not support pipe character(|) and throws an error message.

• other single character delimiter - may be within double quotes with some restrictions. Examples: ";" and "=" work. "|" does not.

  Info

  Ensure to enter delimiter, the same as in the CSV data, with no additional spaces before and after the delimiter. Other single character delimiters may have some restrictions while used in large data sets and may lead to performance issues. Hence it is always advisable to use a small data set and test if the application supports the delimiter. If the delimiter is supported, then go ahead to provide the large data sets.