What is Permanent Link?

Permanent Links are a good way for sharing the current settings of a view in codeBeamer (report, tracker etc) without actually saving the view. For example if you set up a complex report but you don't want to save it just want to share the results and the actual settings (filters, ordering etc.) with someone you can send them a permanent link that encapsulates all the settings.

How to create a permanent link?

The permanent link feature is available on the following pages:

• Document View
• Document Edit View
• Table View
• Traceability Browser
• Coverage Browser
• Planner
• Tracker Cardboard
• Release Cardboard
• Item History compare
• Baseline Difference compare
• Reports page

On these pages there is an icon on the action menu bar for accessing the feature:

To create a permanent link you just have to click on this icon. By clicking on the icon codeBeamer will collect all the settings specific to the current page, save them to the database and generate an URL that can be used to restore the same settings on an other browser with an other user. On the permanent link creation dialog you can also decide who you want to share the permanent link with:

You can share the link with codeBeamer users and via email. All the users listed will get an email message. Note that the URL can be shared in other ways, you can create an email manually or send it via instant messaging. Every user possessing the URL can access it, not just the ones who you shared it with.

Permission handling

The permission handling for permanent links is specific to the shared page. When a user enters the permanent link to the address bar of the browser codeBeamer simply resolves to the target URL and redirects to it. The permission handling is done completely by the shared page. For example if you share a tracker view with a user who has no permission to the tracker then codeBeamer will resolve the correct tracker view URL but the user will get a permission error.
Permanent link data always overwrite the Page View data after the page loading! You must login to see this link. Register now, if you have no user account yet.

How long do Permanent Links live?

A permanent link by default is available for 30 day from the last access. This means that if you create a permanent link and no one opens it then codeBeamer will remove it from its database after 30 day. If you create a permanent link and a user opens it then the counter restarts from zero.

You can override the default 30 days in the application configuration under System Administration using this snippet:

  "permanent-link": {
  	"timeToLive": 10