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 context fields when creating launch-in-context URLs


When creating launch-in-context URLs, context fields are added to the Request Entry console to specify which view to launch, the context to display, and the behavior of the console after it is launched. The following table lists the context fields, and provides a description of the values used to set the context.

Warning

Important

To display Service Review on the Request Entry console, users must hover the mouse pointer over the service title.


Field name

Database ID

Values

Description

Context_View

303900000

1 – Browse Categories view

2 – Browse Subcategories view
This value requires that the Context_Category1_Base_InstanceId field be set.

3 – Services view
This value requires that the Context_Category1_Base_InstanceId and Context_Search_String fields be set.

4 – Provide Information view
This value requires that the Context_SRD_InstanceId field be set. It also optionally uses the Context_SRD_Number field in place of the Context_SRD_InstanceId field.

5 – Cart view

6 – Submitted Requests view
This value requires that the Context_Request_Show field be set.

This field value is required for all views. The Context_View field is used to designate which view to launch.

Context_Category1_
Base_InstanceId

303906900

Category 1 (Navigational Category) instanceId. This value might need to be URL encoded.

All – Search within all services.

Quick Picks – Search within services that are designated as Quick Picks. These include user favorites, system requests, and services most requested.

categoryName – Search within services that are configured with the designated category 1 navigational category. This value might need to be URL encoded.

This field value is required when the value of Context_View is 2 or 3. It is used to specify the category to display subcategories, and to specify the category under which a search for services is constrained.

Context_Search
_String

303901700

A URL encoded string used to limit the search for services.

(Optional) This field value is used when the value of Context_View is 3. This string is used to check the Service Request Definition search cache field. The search cache field contains a string representation of a combination of an SRD's title, navigational categories, and keywords.

Context_SRD
_InstanceId

303900900

The Service Request Definition instance ID. This value might need to be URL encoded.

This field value is required when the value of Context_View is 4 or 5. It is used to specify the SRD to be used in the context of the view. If the Context_SRD_Number field value is set instead, the Context_SRD_InstanceId value is set by workflow that looks up the value based on the Context_SRD_Number value.

Context_SRD
_Number

301628200

Service Request Definition ID

(Optional) This field value is used when the value of Context_View is 4 or 5. It is used to specify the SRD to be used in the context of the view. It can be used in place of the Context_SRD_InstanceId field value. It is used by workflow to look up the Context_SRD_InstanceId field value.

Context_Request
_Show

303901600

10 – All open requests (default)
This value in SRS:SRCLaunchURLBuilder corresponds to the All option in the Show field on the My Requests pod in the Request Entry console.

20 – Draft requests
This value in SRS:SRCLaunchURLBuilder corresponds to the Open and Draft Requests option in the Show field on the My Requests pod in the Request Entry console.

30 – Requests needing attention

40 – Recently closed requests

50 – Requests closed since last log in

60 – Closed requests

This field value is required when the value of Context_View is set to 7. It is used to specify the filter value for the Submitted Requests.

Context_Restrict_
Navigation

303902000

0 – No (default)
1 – Yes

This field is required, but is set to 0 by default. Its value determines whether the navigation links outside the work area (Popular Services, Submitted Requests, Broadcasts, and so on) are disabled when the console is launched. If the value is set to 1, the links are disabled, forcing users to drill down towards submitting a request only by using the buttons in the work area to control the navigation.

Context_Restrict
_OBO

303906700

0 – No (default)
1 – Yes

This field is required, but is set to 0 by default. Its value determines whether the On Behalf Of link is disabled when the console is launched. If the value is set to 1, the link is disabled, and users cannot act on behalf of another user.

Context_PI_
CloseAfterSubmit

303902100

0 – No (default)
1 – Yes

This field is required when the value of Context_View field is set to 4 or 5. It is set to 0 by default. Its value determines whether the console closes immediately after the user submits a request.

Context_
EntitlementVerified

303931400

 

This field is used when Entitlement Management is set to On, to verify whether the user is entitled to request the SRD specified in the context. The value is set by workflow on the Service Request console.

Context_
TakeSRDOfflineFlag

302792000

1000 – Online
2000 – Offline

This field is used when the value of Context_View is set to 4 or 5. It verifies that the SRD specified in the context is online for users to request. The value is set by workflow on the Service Request console.

Context_VerifyFailed

303932500

0 – No (default)
1 – Yes

This field is used when the value of Context_View is set to 4 or 5. It verifies that the SRD specified in the context is online and the user is entitled to request it when Entitlement Management is set to On. The value is set by workflow on the Service Request console.

 

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

BMC Service Request Management 20.02