Skip to Content
Information
This documentation supports the 20.02 version of BMC Service Request Management.To view an earlier version, select the version from the Product version menu.

Using the Context URL Builder utility to generate URLs

You can use the Context URL Builder utility (SRS:SRCLaunchURLBuilder) to generate the URLs that open the Request Entry console in context. These URLs can appear in a portal, in a Knowledge Base article, or some other web page that links to BMC Service Request Management.

Related topics

Opening-the-Request-Entry-console-in-context

launch-context.gif

To use the Context URL Builder utility to generate URLs

  1. Log on to BMC Service Request Management as the SRM administrator and navigate to Custom Configuration > Service Request Management > Request Entry Management > Launch-In-Context URL Generator.
     Alternatively, in a browser, open the SRS:SRCLaunchURLBuilder form using SRM administrator permission. Use the following URL example to open the SRS:SRCLaunchURLBuilder form:

    http://<webServer>:<portNumber>/arsys/forms/<serverName>/SRS%3ASRCLaunchURLBuilder

    Based on the server you logged on to, the values in the Mid Tier Path and Server fields are automatically filled in. You can modify these fields as needed (for example, with a different mid tier or server).

  2. Enter the following information to define the launch URL:

    Field name

    Description

    Restrict Acting On Behalf Of

    Determines if the On Behalf Of link is disabled when the console is launched. The default value is No — the link is not disabled, and the user can act on behalf of another user.

    Restrict Navigation

    Determines if the navigation links (Preferences, Approval Central, Give Feedback, Complete Survey, Home) and Favorite, Popular, Browse, and Search buttons are disabled when the console is launched. The default value is No — the link is not disabled, allowing users to navigate away from the specified context.

    Close Console After Request Is Submitted

    Determines if the console closes immediately and the user is logged out after submitting a request. The default value is No.

  3. From the View list, select a Request Entry console view, and then perform the following steps, depending on the view that you selected:

    View

    Perform these steps to generate a URL

    Service Categories

    Click Generate URL.

    Service Subcategories

    1. Select a subcategory.
    2. Click Generate URL.

    Services

    1. Enter a search string.
    2. Click Launch URL Encoder.
       Not all characters are valid in URLs (for example, the # character or certain GUIDs). This utility helps you create valid URLs.
    3. In the ARURLEncoder form, enter the original string.
    4. Click Convert.
    5. Copy the encoded string and paste it into the URL Encoded String field in the Context URL Builder utility.
    6. Click Generate URL.

    Provide Information

    1. Search for an SRD to use in context (for example, by company or title).
    2. Select an SRD from the table list of search results.
    3. Click Generate URL.

    Service Review

    1. Search for an SRD to use in context (for example, by company or title).
    2. Select an SRD from the table list of search results.
    3. Click Generate URL.

    Cart

    Click Generate URL.

    Submitted Requests

    1. From the Show field, select the status to display (for example, All Open Requests or Draft Requests).
    2. Click Generate URL.

    A URL appears in the URL field.
    For examples of URLs for the various views, or context, see Examples-of-launch-in-context-URLs.

  4. (Optional) To ensure that your URLs are properly encoded, perform the following steps:

    1. Open the URL Encoder form.

      http://<webServer>:<port>/arsys/shared/ar_url_encoder.jsp
    2. Enter the original string to encode.
    3. Click Convert.
    4. Copy the encoded string.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

BMC Service Request Management 20.02