Share your work items with users of the same application by defining URL patterns for
the work items in your application, for example, cases, reports, landing pages, or other work
items, such as sitemap.xml. Simple, meaningful URLs make collaboration more
efficient for users. For example, they can bookmark a case for quick access, and then send a
direct link to the case to other users.
Before you define URL patterns for work items, your application must contain a URL
Mappings rule. Each application can have only one URL Mappings rule, whose name is always
pyDefault. You define URL patterns by editing this rule.
Create a URL Mappings rule in your application:
Note: If your application already contains a URL Mappings rule, go to step 2.
In the header of Dev Studio, click CreateTechnicalURL Mappings.
In the Context section, in the Add to
ruleset list, select the name and version of a ruleset to store the URL
Mappings rule.
Click Create and open.
Click Save.
In the navigation pane of Dev Studio, click Records.
Expand the Technical category, and
then click URL Mappings.
In the list of URL Mappings instances, click pyDefault.
Each application has only one valid URL Mappings rule, whose name is always
pyDefault.
On the Definition tab, expand the category of work items for which
you want to define the URL pattern.
Start configuring a URL pattern:
To modify a pattern, click the Switch to edit mode icon, as
shown in the following figure:Switch to edit mode icon on the URL Mappings form
To add a URL pattern to a work item, click Add URL
alias.
In the Identifier field, enter a name for the URL alias that
uniquely identifies it in all patterns in the rule.For example: Enter OpenWorkForReview.
Optional: To generate a valid URL for an object, apply the URL pattern to the object:
Select the Map path elements for URL generation
checkbox.
In the Class field, specify the class of the object for the
properties mapping.
In the Path element type column, select
Constant.
The first path element must be a constant.
In the Value field, enter text that is a constant element in the
URL pattern.For example: Enter Bug.
Optional: To add more path elements to the URL pattern, click Add path
element.
To define text, in the Path element type column, select
Constant and then, in the Value field,
enter the text.
To define a parameter, in the Path element type column, select
Parameter.
If you selected Map path elements for URL generation in step
8, in the Property mapping column, enter a
clipboard property to map to the URL path element.
Note: You can preview the URL pattern that you create below the Build resource
path label, as shown in the following figure:Preview of a resource path and the configured path elements
Optional: To make this URL pattern the default for objects in specific classes, in the
Make this resource path the default for the following classes
section, click Add class, and then in the text field, enter the
name of the class.
The class can be the same class that you entered in step 8, or
any of the child classes.Note: The option is available only if you selected Map
path elements for URL generation in step 8.
Click Next.
In the Edit processing activity dialog box, in the
Class field, enter the class of the processing activity for the
URL pattern.
In the Activity field, specify the processing activity that
controls running the URL.Result: The system identifies activity parameters and displays them in the
table.
In the Value column, enter the values for the processing activity
parameters.
Map your URL path elements (parameters) to the processing activity parameters. For
example, in step 11, if you defined a URL path element as the {param1} parameter, in the
Value field for an activity parameter, enter
{param1}.
Optional: To pass an additional parameter to the activity that the current activity invokes,
click Add parameter, and then repeat step 16.For example: The following figure shows an additional parameter configured for the processing activity:Mapping a processing activity to the URL mapping
Click Finish.
Optional: To add a URL pattern to another category, expand the category, and then repeat steps
6 through 18.
On the URL Mappings form, click Save. (Note
that if you make any changes to an activity referenced in a URL Mapping, you must re-save
the individual URL Mapping. This step is necessary irrespective of any change in the
individual URL Mappings rule.)
For example: You can use the mappings to generate URLs that follow the patterns that you define by
configuring a Copy shareable link button in a case. The following
figure shows the results of the configuration at run time:Copying a simplified URL for a case