Configuring Twitter notifications for companies

Social Collaboration functionality introduced in this release allows BMC Remedy ITSM applications to send notifications via Twitter. The out-of-the-box configuration is restricted to ITSM broadcast messages that are Public and provided for the Global company. This functionality is tenant (Company) aware and can be configured to send Twitter notifications for messages other than those designated as Public or defined for the Global company. This section provides guidelines on customizing the application to enable these Twitter notifications.

To configure Twitter accounts to receive ITSM Broadcast messages sent based on company

1. Select Administration Console > Application Administration Console > Custom Configuration > Foundation > Social Collaboration > External Notification Registration.
2. On the External Notification Registration form, create an entry for each company to which you want to send broadcasts via Twitter. For more information, see Configuring the Twitter integration.
3. Open BMC Remedy Developer Studio.
4. Open the SHR:LHP:OpenTwitterBrowserPage active link.
   

   (Click the following figure to expand it.)
   

   
   This active link is executed when the user clicks the Twitter icon on the IT Home page. The initial action is to open the Twitter follow page based on the assumption that only one company, Global, has been set up in the system.
   For a multitenant environment, you must modify this active link action to display a dialog box that displays a table with a list companies configured in Step 2.
5. Create a new dialog box and add a table to display the list of companies.
6. In the Tree/Table Property dialog box, select your Server and then the Data Source values. Then enter the following values:
   • Form name — CFG:ExternalNotificationRegistration
   • Qualification — ('NotificationContent' = "ITSM Broadcast") AND ('NotificationMechanism' = "Twitter") AND ('Status' = "Enable")

     Recommendation

     Manually enter the qualification. If you copy and paste it from this web page, you might receive errors.

   • Select the following fields as Table Columns, as well as any other fields that you want to display in the table:
     • Company
     • NotificationContent
     • ExtNotificationAccountName
       

       (Click the following figure to expand it.)
       

7. On the dialog box, create an active link that will run when you select an entry from the table. The active link should perform a run process similar to the original SHR:LHP:OpenTwitterBrowserPage active link.

   Note

   Make sure you save your configurations and set the permissions to public.

8. Enter the following information in the Run Process action of the active link:
   PERFORM-ACTION-OPEN-URL new
   
   <$col_ExtNotifAccountName$> corresponds to the last column defined in the table created.
9. Open the CFG:PBB:SentNotificationToTwitter filter.
   This filter is executed when a broadcast message is saved with the SendToTwitter flag set to Yes.
   

   (Click the following figure to expand it.)
   

10. Modify the qualification of the first set field action as follows:
    ('Company' = $Company$) AND ('NotificationContent' = "ITSM Broadcast") AND ('NotificationMechanism' = "Twitter") AND ('Status' = "Enable")
    This qualification enables the system to identify the specific Twitter account that matches the company instead of the default Global company.
11. Change the run-if condition of the following active links to remove the Company definition from the condition. The Sent To Twitter field is then enabled or disabled irrespective of the condition in the Company field:
    • CFG:PBB:OnOpen_EnableTwitter
    • CFG:PBB:ViewAccess_EnableTwitter
    • CFG:PBB:Company_EnableTwitter

      Example

      In the first active link you created, change the run-if from:
      ('Company' = "- Global -") AND ('View Access' = "Public") AND ( NOT ($VUI$ LIKE "Dialog View%"))
      to:
      ('View Access' = "Public") AND ( NOT ($VUI$ LIKE "Dialog View%"))

12. Save your changes.