Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Warning

Removal notice:

Please note that the URL user and URL user password parameters were removed in 5.8.5 (see Deprecation notice: URL user and URL user password parameters). We recommend using  profiles to access external data.

Description

This article illustrates how to create a profile using a URL to be used with any of the HTML for Confluence macros.

...

There are two ways to work with URLs where you can use:

Info

For this example, let's use the Html-bobswift macro to illustrate profile creation and usage. The screenshots illustrate where the relevant parameters are to be given. Specify information in the profile window and macro editor as per your requirement in your instance.

...

Info
titlePoints to remember!
  • Only raw URLs must be given in either, the URL field in profiles or the Location fields, in the macros.
  • 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 HTML file in a public Bitbucket repository is valid. But to render an HTML 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, GitLab or GitHub. 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.

Helpful resources