Defining URL patterns for work items

You can define URL patterns for work items in your application that can later be used for sharing work with other users of the same application. You can provide URL patterns for cases, reports, and landing pages. You can define any other URL patterns that do not fit in those categories, for example, sitemap.xml in the Others category.

  1. In the Records Explorer, click Technical > URL Mappings.

  2. Open the Default URL Mappings rule for your application. There is only one valid URL Mappings rule for each application and the name is always Default.

  3. On the Definition tab, expand the category of work items for which you want to define the URL pattern (alias).

  4. Click Add URL alias to add a URL pattern to a work item, or click the Gear icon to modify the existing pattern.

  5. In the Identifier field, enter the name for URL alias that uniquely identifies it across all patterns in the rule.

  6. Optional: To generate a valid URL for an existing object, apply the URL pattern to the object.

    1. Select Map path elements for URL generation.

    2. In the Class field, specify the class of the object for the properties mapping. You must specify the property mappings when you define the URL pattern for the work item.

  7. Define the URL pattern for a work item.

    The order of the path elements that you define is the order of the path elements in the URL pattern.

    1. In the Path element type column, select Constant. The first path element must be a constant.

    2. In the Value field, specify the text that is a constant in the URL pattern.

    3. Optional: Click Add path element to add more path elements to the URL pattern.

      • To define a text, in the Path element type column, select Constant and specify the value.

      • To define a parameter, in the Path element type column, select Parameter.

        • If you selected Map path elements for URL generation in step 6, in the Property mapping column, enter a clipboard property to map it to the URL path element.

    Note: You can preview the URL pattern that you create under the Build resource path label.

  8. Optional: Make this URL pattern as a default for all objects in the specific classes. The option is available if you selected Map path elements for URL generation in step 6.

    1. In the Make this as default resource path for following classes section, click Add class.

    2. Enter the name of the class. The class can be the same class that you entered in step 6, or any of the child classes.

  9. Click Next.

  10. Define processing activity for the URL pattern.

    1. In the Class field, specify the class of the processing activity.

    2. In the Activity field, specify the processing activity that controls the execution of the URL. The system identifies activity parameters and displays them in the table.

    3. In the Value field, enter the values for the processing activity parameters. Map your URL path elements (parameters) to the processing activity parameters. For example, if in step 7 you defined a URL path element as a parameter {param1}, enter the {param1} in the Value field for an activity parameter.

    4. Optional: Click Add parameter to add a custom parameter. By adding a custom parameter, you can pass additional parameters to the activities that the current activity invokes.

  11. Click Finish.

  12. Optional: To add a URL pattern (alias) to another category, expand the category and do the steps 4 through 11.

  13. On the URL Mappings form, click Save.