Smart URLs - enabling reference to Agile objects from external systems
By Anurag Batra on Sep 08, 2008
Are they as smart as they look? Judge for yourself (and let me know what you think too).
In Agile 9.2.2 and earlier versions, while the system allowed a user to generate a URL for an object, the generated URL was rather cryptic. For example, here's a sample URL for part P0001:
Furthermore, the only way to generate a URL pointing to an Agile object was through Agile.
With Agile 18.104.22.168, any Agile object can be linked to using a URL in the following format:
As a result, macros may be written in excel sheets, wikis, enterprise integrations or other enterprise applications to provide a direct link to any object in Agile PLM as long as you know the object type and the object number. The limitation, of course, is that while the cryptic URL from Agile can point to a specific tab on an object, the simplified URL takes you to the main tab on the object. I must admit that we didn't fix the "Copy Shortcut" button in Agile's web client to generate the Smart URLs rather than the cryptic ones, so these nice to read URLs are a hidden feature.
In a related enhancement in the same release, Smart URLs were also extended to file attachments, so that a file attached to any object in Agile may be directly referenced (and in cases where single signon is implemented, downloaded without logging into the Agile application) using a smart URL like the following:
The smart file URL can be generated to pick up a file attached to a specific revision of an item or a folder, to return a single file or all files as a compressed folder, and to perform either a Get or a View action on the file(s). Unlike the object URLs, the attachment URLs can be generated from the system itself by highlighting the attachment row(s) and clicking on the "Get Shortcut" button on the attachments table.
To learn more about all the possibilities with this feature, and details of the design, please refer to the Administrator's Guide for Agile PLM 22.214.171.124 or higher versions.