About Permanent Links
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 in the address bar of the browser, Codebeamer 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 wil resolves the correct tracker view URL, but the user receives a permission error.
Permanent link data always overwrites the page view data after the page loads.
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
}
"timeToLive": 10
}