How to create a profile with a URL

Owned by Smita Nair
Last updated: May 05, 2022 by Sunita Patro
2 min read

Removal notice

Please note that the URL user and URL user password parameters were removed (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 in the Graphviz macros using a URL.

Profiles are not available for use with the Graph from table and Space graph macros.

Before you begin:

  • Before you enter the URL for a repository, ensure that it complies with the REST standards published by GitHub or GitLab.
    • Click here for more information on REST Pattern for GitLab.
    • Click here for more information on REST Pattern for GitHub.
  • Know what is a complete URL. A typical path for the raw file on GitLab looks like:
    /projects/:id/repository/files/:file_path/raw
  • Since the host address begins with:
     https://gitlab.com/api/v4
  • The complete URL, in this example, looks like: 
 https://gitlab.com/api/v4/projects/:id/repository/files/:file_path/raw?ref=master
  • For illustrative purposes, we have used a public Bitbucket public repository. The process for adding a profile and using it in macros remains the same for other repositories and external sources.


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

Using an absolute URL in a profile

You can create a profile by providing the complete URL for the Graphviz content.

  1. Navigate to CONFLUENCE ADMINISTRATION > Settings > ATLASSIAN MARKETPLACE > Graphviz Configuration > Profiles.

  2. Click Add Profile.

  3. Enter a unique name for the profile in the Profile name text box. For this example, enter BitbucketFullURL in the text box.
  4. Select URL from the options in Profile type. 

  5. Enter https://bitbucket.org/bobswift-test/testfiles/raw/66f9cf5ba2bfe3890caf9dc2d89e81b59210a5e6/digraph in the URL text box. 

  6. Click Save profile to create the profile.

To use this profile in a Confluence page:

  1. Search for the Graphviz macro and edit it.
  2. Enter BitbucketFullURL in Profile and then, click Save.
            

Using a base URL in a profile

You can create a profile by providing a base URL and then, enter the relative path to the relevant files in the Graphviz macro.

  1. Navigate to CONFLUENCE ADMINISTRATION > Settings > ATLASSIAN MARKETPLACE > Graphviz Configuration > Profiles.

  2. Click Add Profile.

  3. Enter a unique name for the profile in the Profile name text box. For this example, enter BitbucketProfile in the text box.
  4. Select URL from the options in Profile type. 

  5. Enter https://bitbucket.org/bobswift-test/ in the URL text box.

  6. Click Save profile to create the profile.

To use this profile in a Confluence page:

  1. Search for the Graphviz macro and edit it.
  2. Enter BitbucketProfile in Profile in the editor.
  3. Enter the relative path to the  file in the URL to Graphviz file parameter.
  4. Click Save.

This method allows multiple users to access a profile across pages and instances of the Graphviz macro.

Using an absolute URL directly

You can skip creating a profile entirely and enter an absolute URL in the URL to Graphviz file parameter.

  1. In a Confluence page, search for the Graphviz macro and edit it.
  2. Enter https://bitbucket.org/bobswift-test/testfiles/raw/4e437c71635ac79f796456495807fb6c65218c84/grphviz in the the URL to Graphviz file parameter.
  3. Click Save.

     


Find answers from the community.

Ask a question to the community.

Log a request with our support team.

Confluence®, Jira®, Atlassian Bamboo®, Bitbucket®, Fisheye®, and Atlassian Crucible® are registered trademarks of Atlassian®
Copyright © 2005 - 2024 Appfire | All rights reserved. Appfire™, the 'Apps for makers™' slogan and Bob Swift Atlassian Apps™ are all trademarks of Appfire Technologies, LLC.