Constructing a URL for a specific page

You can use a programmable or manual way to construct a page URL to display specific business data for which you can integrate your own user interface with a predefined Monitor dashboard space page.

1. Obtain the base URL of the page by completing the following steps:
   1. Open the page menu by clicking the action button .
   2. Click Show Link. The Page Link window opens.
   3. Copy the entire URL to the clipboard and then click OK to close the Page Link window.
   4. Paste the URL into a text editor and then decode it. A base URL will look similar to the following example:

      http://host_name:port/mum/enabler?nst=pid=09BA762
      A1F5B515A7D39F35D3E35C5000006&w0=ns_edee00c0899311df9581a133f9942442&w0cp=%7
      B%7D&w1=ns_5c86fcc0899f11dfbe70f10be7347fbe&w1cp=%7B%7D&w2=ns_67453b40899f11
      dfbe70f10be7347fbe&w2cp=%7B%7D&

      This base URL can be divided into two main sections, the Monitoring dashboard space URL and the page ID, widget ID, and widget payload.
      • Example of the Monitoring dashboard space URL ("section 1"):

        http://host_name:port/mum/enabler?nst=

      • Example of the Page ID, widget ID, and widget payload ("section 2"):

        pid=09BA762A1F5B515A7D39F35D3E35C5000006&w0=ns_edee00c089
        9311df9581a133f9942442&w0cp=%7B%7D&w1=ns_5c86fcc0899f11df
        be70f10be7347fbe&w1cp=%7B%7D&w2=ns_67453b40899f11dfbe70f10
        be7347fbe&w2cp=%7B%7D&

      Page ID

      pid=09BA762A1F5B515A7D39F35D3E35C5000006

      Widget ID

      w0=ns_edee00c0899311df9581a133f9942442

      Widget payload

      w0cp=%7B%7D

      The payload value is encoded again, for this example, the decoded payload value is empty: w0cp={}

2. When there are two or more widgets on the page, use the following procedure to determine the individual ID for each widget.
   1. Create a new space and add one page to it.
   2. Add one IBM Business Monitor widget to the page. This is the widget for which you are finding the ID.
   3. Open the page menu by clicking the action button .
   4. Click Show Link. The Page Link window opens.
   5. Within the URL text, decipher the widget ID as described in step 1.d using UTF-8 URL decoding.
3. Construct the payloads for the widgets in the page. For information about payload formatting, see "Payload formats of widgets". Your constructed payloads for the three widgets on the page could look similar to the following examples:

   {"p0": "ClipsAndTacks:20070911120730:Ship_Count_KPI"}

   {"p0": "ClipsAndTacks:20070911120730:Ship_Count_KPI", "p1":
   "weekly", "p2": "Iran", "p3": "repeatingPeriod" , "p4":
   "periodInProgress", "p5": "quarterly", "p6": 3}

   {"p0":"ClipsAndTacks:ALL","p1":"CLIPSANDTACKS_CLIPSANDTACKS
   _MC_CUBE:ClipsAndTacks_MC","p2":"basic","p3":"[CLIPSANDTACKS
   _CLIPSANDTACKS_MC_CUBE].[Order Status Dimension]","p4":"0.18"
   ,"p5":"1245220743000","p6":"1277188743000","p7":"monthly","p8"
   :"InstancesCount"}

4. Encode the payloads (use the URL UTF-8 encoding method). Your encoded payloads might look similar to the following examples:

   %7B%22p0%22%3A%20%22ClipsAndTacks%3A20070911120730%3AShip_Count_KPI%22%7D

   %7B%22p0%22%3A%20%22ClipsAndTacks%3A20070911120730%3AShip_Count_KPI%22%2C%20%22
   p1%22%3A%20%22weekly%22%2C%20%22p2%22%3A%20%22Iran%22%2C%20%22p3%22%3A%20%22
   repeatingPeriod%22%20%2C%20%22p4%22%3A%20%22periodInProgress%22%2C%20%22p5%22
   %3A%20%22quarterly%22%2C%20%22p6%22%3A%203%7D

   %7B%22p0%22%3A%22ClipsAndTacks%3AALL%22%2C%22p1%22%3A%22CLIPSANDTACKS_CLIPSAND
   TACKS_MC_CUBE%3AClipsAndTacks_MC%22%2C%22p2%22%3A%22basic%22%2C%22p3%22%3A%22%
   5BCLIPSANDTACKS_CLIPSANDTACKS_MC_CUBE%5D.%5BOrder%20Status%20Dimension%5D%22%2C
   %22p4%22%3A%220.18%22%2C%22p5%22%3A%221245220743000%22%2C%22p6%22%3A%2212771887
   43000%22%2C%22p7%22%3A%22monthly%22%2C%22p8%22%3A%22InstancesCount%22%7D

5. Insert the encoded payloads into the second section of the base URL. The following examples show how the URL should look before and after you encode the payloads. The bold text in the Before snippet (%7B%7D) indicates the locations where payload information was inserted in the After snippet.
   • Before:

     pid=09BA762A1F5B515A7D39F35D3E35C5000006&w0=ns_edee00c0899311df
     9581a133f9942442&w0cp=%7B%7D&w1=ns_5c86fcc0899f11dfbe70f10
     be7347fbe&w1cp=%7B%7D&w2=ns_67453b40899f11dfbe70f10be7347
     fbe&w2cp=%7B%7D&

   • After:

     pid=09BA762A1F5B515A7D39F35D3E35C5000006&w0=ns_edee00c0899311df
     9581a133f9942442&w0cp=%7B%22p0%22%3A%20%22ClipsAndTacks
     %3A20070911120730%3AShip_Count_KPI%22%7D&w1=ns_5c86fcc089
     9f11dfbe70f10be7347fbe&w1cp=%7B%22p0%22%3A%20%22ClipsAnd
     Tacks%3A20070911120730%3AShip_Count_KPI%22%2C%20%22p1%22%3A%20%22
     weekly%22%2C%20%22p2%22%3A%20%22Iran%22%2C%20%22p3%22%3A%20%22
     repeatingPeriod%22%20%2C%20%22p4%22%3A%20%22periodInProgress%22%
     2C%20%22p5%22%3A%20%22quarterly%22%2C%20%22p6%22%3A%203%7D&w2=ns
     _67453b40899f11dfbe70f10be7347fbe&w2cp=%7B%22p0%22%3A%22ClipsAnd
     Tacks%3AALL%22%2C%22p1%22%3A%22CLIPSANDTACKS_CLIPSANDTACKS_MC_CUBE%3AClips
     AndTacks_MC%22%2C%22p2%22%3A%22basic%22%2C%22p3%22%3A%22%5BCLIPSANDTACKS
     _CLIPSANDTACKS_MC_CUBE%5D.%5BOrder%20Status%20Dimension%5D%22%2C%22p4%22%3A
     %220.18%22%2C%22p5%22%3A%221245220743000%22%2C%22p6%22%3A%221277188743000%22
     %2C%22p7%22%3A%22monthly%22%2C%22p8%22%3A%22InstancesCount%22%7D&

6. Encode the second section of the URL again (use the URL UTF-8 encoding method): Example:

   pid%3D09BA762A1F5B515A7D39F35D3E35C5000006%26w0%3Dns_edee00c0899311
   df9581a133f9942442%26w0cp%3D%257B%2522p0%2522%253A%2520%2522ClipsAnd
   Tacks%253A20070911120730%253AShip_Count_KPI%2522%257D%26w1%3Dns_5c86f
   cc0899f11dfbe70f10be7347fbe%26w1cp%3D%257B%2522p0%2522%253A%2520%2522
   ClipsAndTacks%253A20070911120730%253AShip_Count_KPI%2522%252C%2520%25
   22p1%2522%253A%2520%2522weekly%2522%252C%2520%2522p2%2522%253A%2520%25
   22Iran%2522%252C%2520%2522p3%2522%253A%2520%2522repeatingPeriod%2522%25
   20%252C%2520%2522p4%2522%253A%2520%2522periodInProgress%2522%252C%2520%25
   22p5%2522%253A%2520%2522quarterly%2522%252C%2520%2522p6%2522%253A%25203
   %257D%20%26w2%3Dns_67453b40899f11dfbe70f10be7347fbe%26w2cp%3D%257B%25
   22p0%2522%253A%2522ClipsAndTacks%253AALL%2522%252C%2522p1%2522%253A%2522
   CLIPSANDTACKS_CLIPSANDTACKS_MC_CUBE%253AClipsAndTacks_MC%2522%252C%2522
   p2%2522%253A%2522basic%2522%252C%2522p3%2522%253A%2522%255BCLIPSANDTACKS
   _CLIPSANDTACKS_MC_CUBE%255D.%255BOrder%2520Status%2520Dimension%255D%2522
   %252C%2522p4%2522%253A%25220.18%2522%252C%2522p5%2522%253A%25221245220743
   000%2522%252C%2522p6%2522%253A%25221277188743000%2522%252C%2522p7%2522%253
   A%2522monthly%2522%252C%2522p8%2522%253A%2522InstancesCount%2522%257D%26

7. Add the first section of the base URL: Example:

   http://host_name:port/mum/enabler?nst=pid%3D09BA762A1F5B515A7D39F
   35D3E35C5000006%26w0%3Dns_edee00c0899311df9581a133f9942442%26w0cp%3D
   %257B%2522p0%2522%253A%2520%2522ClipsAndTacks%253A20070911120730%253A
   Ship_Count_KPI%2522%257D%26w1%3Dns_5c86fcc0899f11dfbe70f10be7347fbe%26
   w1cp%3D%257B%2522p0%2522%253A%2520%2522ClipsAndTacks%253A20070911120730
   %253AShip_Count_KPI%2522%252C%2520%2522p1%2522%253A%2520%2522weekly
   %2522%252C%2520%2522p2%2522%253A%2520%2522Iran%2522%252C%2520%2522p3
   %2522%253A%2520%2522repeatingPeriod%2522%2520%252C%2520%2522p4%2522
   %253A%2520%2522periodInProgress%2522%252C%2520%2522p5%2522%253A%2520
   %2522quarterly%2522%252C%2520%2522p6%2522%253A%25203%257D%20%26w2%3
   Dns_67453b40899f11dfbe70f10be7347fbe%26w2cp%3D%257B%2522p0%2522%253A
   %2522ClipsAndTacks%253AALL%2522%252C%2522p1%2522%253A%2522CLIPSAND
   TACKS_CLIPSANDTACKS_MC_CUBE%253AClipsAndTacks_MC%2522%252C%2522p2%2522
   %253A%2522basic%2522%252C%2522p3%2522%253A%2522%255BCLIPSANDTACKS_CLIPS
   ANDTACKS_MC_CUBE%255D.%255BOrder%2520Status%2520Dimension%255D%2522%252C
   %2522p4%2522%253A%25220.18%2522%252C%2522p5%2522%253A%25221245220743000
   %2522%252C%2522p6%2522%253A%25221277188743000%2522%252C%2522p7%2522%253A
   %2522monthly%2522%252C%2522p8%2522%253A%2522InstancesCount%2522%257D%26

8. Test your work by viewing the URL in a browser and verifying that the page displays the appropriate business data.