Displaying BMC Service Level Management status in custom applications

The BMC Service Level Management (BMC SLM) status indicator shows the following behaviors in Remedy Asset Management, Remedy Change Management, the Release Management module, and Remedy Service Desk. The status indicator represents the worst-case status. The following sections describe how to display the BMC SLM status in custom applications.

You must have completed the following items to display the BMC Service Level Management (BMC SLM) status in custom applications.

• Configured Remedy AR System server (including Data Visualization Fields (DVF) Server configuration)
• Installed BMC SLM (with SLM Sample Application)
  
  If you have configured a DVF server, the server needs to have either BMC SLM installed or a Data Visualization Module record for SlmDVF with the SlmDVF.jar file. The SlmDVF.jar file can be independently obtained by exporting the specific record from a server with an existing BMC SLM installation. For more information about Data Visualization fields in BMC Remedy AR System, seeData visualization fields.

To display BMC SLM status in custom applications

1. Copy the fields SlmDVF, Details..., and z1D_ButtonSLMImage from the SLM:Service Request form and place them on your custom form. Align as needed and make them all visible by default.
2. Create a set of Active Links that will execute appropriately for your design. Each Active Link should consist of the following two separate Actions: A Set Fields Action that sets SlmDVF as follows:
   "action=setvalue"
   • A Set Fields Action that sets SlmDVF as follows:
     "param1=x"
     where x = 0 for Gray/No service targets Attached image
     where x = 1 for Green/Within Service Target image
     where x = 2 for Yellow/Service Targets Warning image
     where x = 3 for Red/service target Breached image
     You can also reuse the following existing BMC SLM Active Links in your custom application:
   • SLM:ServiceRequest:SetIconStatusByCopyingSLMStatusValueGray
   • SLM:ServiceRequest:SetIconStatusByCopyingSLMStatusValueGreen
   • SLM:ServiceRequest:SetIconStatusByCopyingSLMStatusValueYellow
   • SLM:ServiceRequest:SetIconStatusByCopyingSLMStatusValueRed
     Change the form name to match the form on which you want these Active Links to execute, and set the Run If condition to apply to your application.
3. Copy and appropriately name the following Active Links, and set the Primary form to the form on which you want them to execute:
   • SLM:ServiceRequest:OnClickDetailsDisplayIntegrationDialog
   • SLM:ServiceRequest:TrapDVFEventAndDisplayIntegrationDialog

   • The following is the table qualification in SLM:IntegrationDialog:

     *( $instanceId$ = 'ApplicationInstanceID') AND
     ( 'deleted' = "false") AND (( 'GoalTypes' = "Request-Based")
     OR ( 'GoalTypes' = "Availability")) AND (EXTERNAL( $z1D Char01$))
     AND (EXTERNAL( $z1D Char31$))*

     where instanceId, z1D Char01, and z1D Char31 are set by the Active Links.

4. Edit the copied Active Links as follows:
   1. Set the value of instanceId to an appropriate field value, which should match the ApplicationInstanceId in the SLM:Measurement form.
   2. Set the value of z_TmpCharHeading to an appropriate value (for example "Request ID:" + $Request ID$).
   3. Set the value of z1D Char01 and/or z1D Char31 to any suitable qualification if you want to filter the table on the SLM:IntegrationDialog form based on the qualification.
   4. Leave the SLMVersion value set at 7.5000.
5. Launch the SLM:IntegrationDialog dialog by clicking either Details... or the SlmDVF image.

For more information, see the following topics: