---
title: "How to create a profile with a URL - data center"
canonical: "https://support.appfire.com/space/GVIZ/70223044/How%20to%20create%20a%20profile%20with%20a%20URL%20-%20data%20center"
format: markdown
---
> Macro (aura-html)

> ❌ **Removal notice:**
> ❌ 
> ❌ Please note that the URL user and URL user password parameters were removed in 3.4.2. We recommend using [<span style="color: #000000">profiles</span>](https://appfire.atlassian.net/wiki/spaces/GVIZ/pages/70222033/Configure+for+data+center#profiles)<span style="color: #000000"> </span>to access external data.

> ⚠️ **Exception:**
> ⚠️ 
> ⚠️ <span style="color: #000000">This article is not applicable to the following macros:</span>
> ⚠️ 
> ⚠️ - <span style="color: #000000">Space graph</span>
> ⚠️ - <span style="color: #000000">Graph from table</span>

<span style="color: #000000">This article illustrates how to create a profile</span><span style="color: #000000"> with a URL</span><span style="color: #000000"> and for this scenario, the profile is then specified in the </span>*<span style="color: #000000">Graphviz</span>*<span style="color: #000000"> macro. </span>

> ℹ️ ## <span style="color: #000000">Before you begin:</span>
> ℹ️ 
> ℹ️ - <span style="color: #000000">Before you enter the URL for a repository, ensure that it </span><span style="color: #000000">is a raw URL</span>.  
> ℹ️ <span style="color: #000000">A raw URL is defined as the part of the URL following the domain information and </span><span style="color: #000000">includes the query string, if present. </span><span style="color: #000000">For example, in the URL string </span>*<span style="color: #000000">http://www.contoso.com/articles/recent.aspx</span>*<span style="color: #000000">, the raw URL is </span>*<span style="color: #000000">/articles/recent.aspx</span>*<span style="color: #000000">. </span>
> ℹ️ - <span style="color: #000000">Know what is a complete URL. </span>
> ℹ️   - <span style="color: #000000">A typical path for the raw file on GitLab looks like:</span>  
> ℹ️ `/projects/:id/repository/files/:file_path/raw`
> ℹ️   - <span style="color: #000000">Since the host address begins with:</span>  
> ℹ️ `https://gitlab.com/api/v4`
> ℹ️   - The <span style="color: #000000">complete URL, in this example, looks like: </span>  
> ℹ️ `https://gitlab.com/api/v4/projects/:id/repository/files/:file_path/raw?ref=master`
> ℹ️ - <span style="color: #000000">For illustrative purposes, a public</span> <span style="color: #000000">Bitbucket public repository is used</span>. <span style="color: #000000">Use URLs to add to profiles and in macros as per your requirement and your instance.</span><span style="color: #333333"> </span><span style="color: #000000">The process for adding a profile and using it in macros remains the same for other repositories and external sources. </span>


<span style="color: #000000">You can work with URLs in two ways where you can:</span>

- <span style="color: #000000">Use </span>[<span style="color: #000000">an absolute URL</span>](#HowtocreateaprofilewithaURL-datacenter-md_URLProfile_absURL)<span style="color: #000000"> in the profile</span>
- <span style="color: #000000">Use </span>[<span style="color: #000000">a partial URL</span>](#HowtocreateaprofilewithaURL-datacenter-md_URLProfile_partialURL)<span style="color: #000000"> in the profile</span>

# > Macro (anchor)

<span style="color: #000000">Use an absolute URL</span>

<span style="color: #000000">You can create a profile by providing the absolute URL to access the Graphviz content from a remote location.</span>

1. <span style="color: #000000">Navigate to </span>***<span style="color: #000000">CONFLUENCE ADMINISTRATION ></span>****<span style="color: #000000"> </span>****<span style="color: #000000">Manage Apps > </span>******<span style="color: #000000">BOB SWIFT CONFIGURATION > </span>***<span style="color: #000000">***Graphviz***</span>***<span style="color: #000000"> > Profiles</span>***<span style="color: #000000">.</span>
2. <span style="color: #000000">Click </span>**<span style="color: #000000">Add Profile.</span>**
3. <span style="color: #000000">Enter a unique name for the profile in the </span>*<span style="color: #000000">Profile name</span>*<span style="color: #000000"> text box.</span>
4. <span style="color: #000000">Select </span>*<span style="color: #000000">URL</span>*<span style="color: #000000"> from the options in </span>*<span style="color: #000000">Profile type</span>*<span style="color: #000000">. </span>
5. <span style="color: #000000">Enter the relevant absolute URL of the location to be accessed</span> <span style="color: #000000">in the </span>*<span style="color: #000000">URL</span>*<span style="color: #000000"> text box.</span>
6. <span style="color: #000000">Click </span>**<span style="color: #000000">Save profile</span>**<span style="color: #000000"> to create a profile.</span>

![image](media://fe7ae686-1c3d-4a13-a57c-989a1a8c22dc)

<span style="color: #000000">To use this profile in a Confluence page:</span>

1. <span style="color: #000000">Add the </span><span style="color: #000000">Graphviz</span><span style="color: #000000"> macro, or edit an existing macro on a page.</span>
2. <span style="color: #000000">Select the newly created profile, in this case </span>*<span style="color: #000000">BitURL</span>*<span style="color: #000000">, from the </span>*<span style="color: #000000">Profile</span>*<span style="color: #000000"> drop-down, and click </span>**<span style="color: #000000">Save</span>**<span style="color: #000000">.</span>

# > Macro (anchor)

<span style="color: #000000">Use a partial URL</span>

<span style="color: #000000">You can create a profile by providing a partial URL for the Graphviz content, and enter the relative path to the Graphviz file in the </span>*<span style="color: #000000">Graphviz</span>*<span style="color: #000000"> macro.</span>

1. <span style="color: #000000">Navigate to </span>**<span style="color: #000000">CONFLUENCE ADMINISTRATION</span>**<span style="color: #000000"> > </span>**<span style="color: #000000">Manage apps </span>**<span style="color: #000000">></span>**<span style="color: #000000">BOB SWIFT CONFIGURATION </span>**<span style="color: #000000">></span>**<span style="color: #000000"> Graphviz</span>**<span style="color: #000000">></span>**<span style="color: #000000"> Profiles</span>**<span style="color: #000000">.</span>
2. <span style="color: #000000">Click </span>**<span style="color: #000000">Add Profile.</span>**
3. <span style="color: #000000">Enter a unique name for the profile in </span>**<span style="color: #000000">Profile name</span>**<span style="color: #000000">.</span>
4. <span style="color: #000000">Select URL from the options in </span>**<span style="color: #000000">Profile type</span>**<span style="color: #000000">. </span>
5. <span style="color: #000000">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.</span>
6. <span style="color: #000000">Click </span>**<span style="color: #000000">Save profile</span>**<span style="color: #000000"> to create a profile.</span>

![image](media://4eb0c3f6-0489-4be1-8f1d-976e4e3bff5c)

<span style="color: #000000">To use the profile in a Confluence page:</span>

1. <span style="color: #000000">Add the Graphviz macro, or edit an existing macro on a page.</span>
2. <span style="color: #000000">Select the newly created profile in </span>*<span style="color: #000000">Profile</span>*<span style="color: #000000"> in the macro editor. </span>
3. <span style="color: #000000">Enter the relative path of the Graphviz file in the </span>*<span style="color: #000000">URL to Graphviz file</span>*<span style="color: #000000"> 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. </span>  
<span style="color: #000000">For example, consider: </span>  
<span style="color: #000000">Base URL given in the profile: </span>`https://api.bitbucket.org/2.0`<span style="color: #000000"> </span>  
<span style="color: #000000">Relative path given in the macro editor: </span>`/repositories/appfire/ac-app-dist/src/17f199444d1386c543ac642e9155b396aaeca403/sample.txt`  
<span style="color: #000000">The macro combines the two to refer to the absolute path to the required file as </span>`https://api.bitbucket.org/2.0/repositories/appfire/ac-app-dist/src/17f199444d1386c543ac642e9155b396aaeca403/sample.txt`<span style="color: #000000">.</span>
4. <span style="color: #000000">Click </span>**<span style="color: #000000">Save</span>**<span style="color: #000000">.</span>

> ℹ️ **Points to remember!**
> ℹ️ 
> ℹ️ - <span style="color: #000000">Only raw URLs must be given in either, the</span><span style="color: #000000"> </span>*<span style="color: #000000">URL</span>*<span style="color: #000000"> </span><span style="color: #000000">parameter</span><span style="color: #000000"> in profiles or the</span><span style="color: #000000"> </span>*<span style="color: #000000">URL to </span>**<span style="color: #000000">Graphviz/Diagraph/Graph/PlantUML</span>**<span style="color: #000000"> file</span>*<span style="color: #000000"> </span><span style="color: #000000">parameter in the macro.</span>
> ℹ️ - <span style="color: #000000">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 </span><span style="color: #000000">Graphviz</span><span style="color: #000000"> file in a public Bitbucket repository is valid. But to render an </span><span style="color: #000000">Graphviz</span><span style="color: #000000"> file located in a private repository, we recommend using a profile.</span>
> ℹ️ - <span style="color: #000000">Profiles are a means to access and retrieve contents from external applications such as Bitbucket, GitLab or GitHub. </span><span style="color: #000000">A profile already contains the base URL and the required credentials (user credentials or an access token) to access the relevant application.</span>
> ℹ️ - <span style="color: #000000">This method allows multiple users to access a profile across pages and instances of the macros.</span>