Versions Compared

Old Version 9

changes.mady.by.user Smita Nair

Saved on

compared with

New Version 10

changes.mady.by.user Smita Nair

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Modified contents as per style guide, changed to new editor and fixed links

Description

This article illustrates how administrators can create a profile using URLs to be used with the Visio Viewer macro.

Info

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

    and includes the query string, if present.

     For

     For example, in the URL string http://www.contoso.com/articles/recent.aspx, the raw URL is /articles/recent.aspx.

  • Know what is a complete URL.

    • A typical path for the raw file on Bitbucket looks like:
      /projects/:id/repository/files/:file_path/raw

    • If the host address begins with:
      https://bitbucket.workspace.com

    • The complete URL, in this example, looks like: 
      https://bitbucket.workspace.com/projects/:id/repository/files/:file_path/raw?ref=master

  • For illustrative purposes, we have used a public Bitbucket repository. Use URLs to add to profiles and in macros as per your requirement and your instance. The process of adding a profile and using it in macros remains the same for other repositories and external sources.

There are two ways to configure profiles with URLs:

Anchor
vis_53_tutl_profileURL_absURL
vis_53_tutl_profileURL_absURL
Using an absolute URL in a profile

You can create a profile by providing the complete URL in the macro editor.

  1. Select Image Modified> Manage apps, either search for Visio for Confluence or scroll to Bob Swift Configuration, and click Visio to view app configuration.

    Tip
    titleTry this for older Confluence versions!

    Navigate to CONFLUENCE ADMINISTRATION > Settings > ATLASSIAN MARKETPLACE > Visio > 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 an absolute URL of the location to be accessed in the URL text box. 

  6. Click Save profile to create the profile.

...

  1. vis_53_tutl_profileURL_absURL_profile.pngImage Added

To use this profile in a Confluence page:

  1. Add the Visio Viewer macro or edit an existing macro on the page.

  2. Select the newly created profile from the Profile list.

  3. See a Preview of the Visio diagram, or click Save.

...

  1. Image Added

Anchor
vis_53_tutl_profileURL_partURL
vis_53_tutl_profileURL_partURL
Using a partial URL in a profile

You can create a profile by providing a base URL to access the remote location, and then users can provide the relative path to the relevant file in the Visio Viewer macro editor.

...

  1. Select Image Modified> Manage apps, either search for Visio for Confluence or scroll to Bob Swift Configuration, and click Visio to view app configuration.

    Tip
    titleTry this for older Confluence versions!

    Navigate to CONFLUENCE ADMINISTRATION > Settings > ATLASSIAN MARKETPLACE > Visio > 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. 

...

  1. 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.

  2. Click Save profile to create the profile.

...

To use this profile in a Confluence page:

  1. Add the Visio Viewer macro or edit an existing macro on the page.

  2. Select the newly created profile from the Profile list in the editor.

  3. Enter the relative path to the Visio file in the URL to Visio file parameter.

...

  1.  The relative URL is appended to the base URL specified in the profile to create an absolute path to the file to be rendered.

  2. Click Save.

...

  1. Image Added

title
Info

Points to remember!

  • Only raw URLs must be given in either

    the 

    the URL

     field

     field in profiles in app configuration or

    the 

    the URL to Visio file

     field

     field in the macro editor.

  • 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 a Visio file in a public Bitbucket repository is valid. But to render a Visio 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

     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.