Create a profile with a URL

Parameters removed

  • The URL user and URL user password parameters have been removed from Excel for Confluence. For more information, refer to Removed the URL user and URL user password parameters.
  • Use Profile to access Excel data from a remote location.
  • Parameter removal is effective and available in Excel for Confluence - Server (version 7.3.0 and above).

Description

This article illustrates how to create a profile using a URL in the Excel macro.

Before you begin:

  • Before you enter the URL for a repository, ensure that it is a raw URL.
    A raw URL is defined as the part of the URL following the domain information and includes the query string, if present. For example, in the URL string http://www.contoso.com/articles/recent.aspx, the raw URL is /articles/recent.aspx

    How to identify if a file is valid for the macro?

    Paste the file link into your browser's address bar. If the actual code is displayed in the browser, it is considered to be invalid or in an incorrect format. If the file downloads to your system, the macro can process the file and its contents.

  • Know what is a complete URL.
    • The complete URL, in this example, looks like: 
      https://bitbucket.org/bobswift-test/testfiles/raw/1366d872db9bef51f030a36c94a6b19ba5079c33/SheetJSTableExport.xlsx
  • For illustrative purposes, a public Bitbucket public repository is usedUse URLs to add to profiles and in macros as per your requirement and your instance. The process for adding a profile and using it in macros remains the same for other repositories and external sources.


You can work with URLs in two ways where you can:

Use an absolute URL

You can create a profile by providing the absolute URL to access the Excel content from a remote location.

  1. Navigate to CONFLUENCE ADMINISTRATION > General Configuration > BOB SWIFT CONFIGURATION > Excel > Profiles.

  2. Click Add Profile.

  3. Enter a unique name for the profile in the Profile name text box.
  4. Select URL from the options in Profile type
  5. Enter the relevant absolute URL of the location to be accessed in the URL text box.

  6. Click Save profile to create a profile.

To use this profile in a Confluence page:

  1. Add the Excel macro, or edit an existing macro on a page.
  2. Select the newly created profile from the Profile drop-down, and click Save.

       

Use a partial URL

You can create a profile by providing a partial URL for the Excel content, and enter the relative path to the Excel file in the Excel macro.

  1. Navigate to CONFLUENCE ADMINISTRATION > General Configuration > BOB SWIFT CONFIGURATION > Excel > Profiles.

  2. Click Add Profile.

  3. Enter a unique name for the profile in Profile name.
  4. Select URL from the options in Profile type
  5. Enter the base URL in the URL text box. A base URL is a part of the path that specifies the location that the macro must access.

  6. Click Save profile to create a profile.

        

To use the profile in a Confluence page:

  1. Add the Excel macro, or edit an existing macro on a page.
  2. Select the newly created profile in Profile in the macro editor. 
  3. Enter the relative path of the Excel file in the URL to Excel file parameter. The relative URL is appended to the base URL specified in the profile to create an absolute path to the file to be rendered.
  4. Click Save.

        

Points to remember!

  • Only raw URLs must be given in the URL field in profiles.
  • It is recommended to specify absolute URLs to access files from public locations and to use profiles to access files from private sources. For example, a raw URL that can access an Excel file in a public Bitbucket repository is valid. But to render an Excel file located in a private repository, we recommend using a profile.
  • Profiles are a means to access and retrieve contents from external applications such as Bitbucket. A profile already contains the base URL and the required credentials (user credentials or an access token) to access the relevant application.
  • This method allows multiple users to access a profile across pages and instances of the macros.