Administer > Service Request Catalog Customization > Service Request Catalog customization > Use the Launcher to Link to Third Party Applications

Use the launcher to create third party links

The launcher is an empty space directly below the Dashboard, Services, Support, and Subscription menu bar. You can use the launcher to link to third party applications, such as video training links, an Internet search Web site, an internal HR Web site, or a chat support Web application. You can customize the presentation to show just an icon, or you can display a small amount of text with each icon.

To create a third party application launcher that appears on the Dashboard, Support, or Services landing pages, you will need to modify the following two files:

  • manifest.xml
  • Custom.properties

To create a third party link from the Dashboard, Services, or Support pages, follow these steps.

Important note: In the manifest.xml file, there are many xml elements that end with the term "key." Elements that end with the term "key" correspond to a property specified in the Custom.properties file. For example, the value of the <titleKey> element in the manifest.xml file is specified as "launcher_title" which corresponds to the "launcher_title" property in the Custom.properties file.
  1. Open this file with a text editor.

    C:\...\src-9.61\resources\client\en\Custom.properties
  2. Locate the template example in the file.

  3. Follow the directions to copy the template section and paste it below the template. Customize only the pasted section. It is a good idea to add a comment line above the new section to identify its purpose.

  4. Follow the guidelines in the value table to make sure this section contains values that you want to appear in the Service Request Catalog Dashboard.

    • The identifier can be user-defined; however, when you edit the manifest.xml file, the identifiers have to match.
    • The .value for each identifier is exactly what will display in the user interface.

    In this example, we build a launcher for the XYZ third party business application.

    /* New Launcher Example */
    launcher_title = XYZ
    launcher_desc = You can link to XYZ here. 
    dropdown_list_label = Select
    dropdown_value_1 = I want information
    dropdown_value_2 = I want to order 
    dropdown_value_x = I want to see status
    text_label = Type Your Comments
    action_label = Send
    action_type = GET
  5. Save the file, but keep it open for reference as you configure the next file.
  6. Open this file with a text editor.

    C:\...\src-9.61\secure\configuration\manifest.xml

    Use the following lines as a reference for the remaining steps:.

    <launcher launcherId="XYZ_Launcher" displayOrder="5" showLogoBox="true" showLogoDropShadow="true>
        <logo>XYZ_image.png</logo>
        <titleKey>launcher_title</titleKey>
        <descriptionKey>launcher_desc</descriptionKey>
        <launcherType>APP</launcherType>
        <fields>
            <field fieldId="text_label">
                 <labelKey>text_label</labelKey>
                 <type>TEXT</type>
            </field>
            <field fieldId="text_area">
                 <labelKey>text_area</labelKey>
                 <type>TEXTAREA</type>
            </field>
            <field fieldId="dropdown_list_label">
               <labelKey>dropdown_list_label</labelKey>
               <type>DROPDOWN</type>
               <options>
                   <option>
                       <labelKey>dropdown_value_1</labelKey>
                       <value>X</value>
                   </option>
                   <option>
                       <labelKey>dropdown_value_2</labelKey>
                       <value>Y</value>
                   </option>
                   <option>
                       <labelKey>dropdown_value_x</labelKey>
                       <value>Z</value>
                   </option>	
               </options>
           </field>
        </fields>
        <action>
           <labelKey>action_label</labelKey>
           <link><![CDATA[http://www.XYZ.com]]></link>
           <method>GET</method>
        </action>
    </launcher>
  7. Locate the <launchers></launchers> section.   The <launchers> element may contain one or more <launcher></launcher> sub-sections that describe the attributes of a third party application(s) that you want to display on the Dashboard. Replace the blue italicized text between each tag with a valid value. Follow the guidelines in the value table to make sure this section is syntactically correct and contains values that can be processed successfully.

  8. Save the file, but keep it open for reference as you configure the next file.
  9. If the application is running, log out and log in again to confirm that the third party application link appears in the dashboard.