contents - ca technologies global search results · contents web service connector configuration...

32
Contents Web Service Connector Configuration Examples ......................................................................................... 1 An Example to Get Stock Value Using Markit On Demand Web Services. ............................................... 2 To Configure the Web Service Request ................................................................................................ 2 To Configure the Response Processing for the Metrics ........................................................................ 4 To Select Metrics for Business Indicators ............................................................................................. 5 An Example to Get Sentiment Value Using General Sentiment Web Services ......................................... 6 To Configure the Web Service Request ................................................................................................ 7 To Configure the Response Processing for the Metrics ...................................................................... 10 To Select Metrics for Business Indicators ........................................................................................... 11 An Example to Get Currencies Exchange Rate Using Yahoo Web Services ............................................ 12 To Configure the Web Service Request .............................................................................................. 13 To Configure the Response Processing for the Metrics ...................................................................... 14 To Select Metrics for Business Indicators ........................................................................................... 17 An Example to Get Weather Information Using Yahoo Web Services ................................................... 18 To Configure the Web Service Request .............................................................................................. 19 To Configure the Response Processing for the Metrics ...................................................................... 21 To Select Metrics for Business Indicators ........................................................................................... 23 An Example to Get Brand Influence Score Using Klout Web Services .................................................... 23 To Configure the Web Service Request for a Variable........................................................................ 24 To Configure the Response Processing for a Variable ........................................................................ 26 To Configure the Web Service Request for the Metric ....................................................................... 27 To Configure the Response Processing for the Metrics ...................................................................... 29 To Select Metrics for Business Indicators ........................................................................................... 31 Web Service Connector Configuration Examples All examples listed in this document are running on http://caexecbeta.myaws.net. Note: Before using these examples read the ‘Using Web Service Connector’ section in the CA Executive Insight Configuration and Administration Guide.

Upload: vothuan

Post on 04-Jun-2019

221 views

Category:

Documents


0 download

TRANSCRIPT

Contents Web Service Connector Configuration Examples ......................................................................................... 1

An Example to Get Stock Value Using Markit On Demand Web Services. ............................................... 2

To Configure the Web Service Request ................................................................................................ 2

To Configure the Response Processing for the Metrics ........................................................................ 4

To Select Metrics for Business Indicators ............................................................................................. 5

An Example to Get Sentiment Value Using General Sentiment Web Services ......................................... 6

To Configure the Web Service Request ................................................................................................ 7

To Configure the Response Processing for the Metrics ...................................................................... 10

To Select Metrics for Business Indicators ........................................................................................... 11

An Example to Get Currencies Exchange Rate Using Yahoo Web Services ............................................ 12

To Configure the Web Service Request .............................................................................................. 13

To Configure the Response Processing for the Metrics ...................................................................... 14

To Select Metrics for Business Indicators ........................................................................................... 17

An Example to Get Weather Information Using Yahoo Web Services ................................................... 18

To Configure the Web Service Request .............................................................................................. 19

To Configure the Response Processing for the Metrics ...................................................................... 21

To Select Metrics for Business Indicators ........................................................................................... 23

An Example to Get Brand Influence Score Using Klout Web Services .................................................... 23

To Configure the Web Service Request for a Variable ........................................................................ 24

To Configure the Response Processing for a Variable ........................................................................ 26

To Configure the Web Service Request for the Metric ....................................................................... 27

To Configure the Response Processing for the Metrics ...................................................................... 29

To Select Metrics for Business Indicators ........................................................................................... 31

Web Service Connector Configuration Examples All examples listed in this document are running on http://caexecbeta.myaws.net.

Note: Before using these examples read the ‘Using Web Service Connector’ section in the CA Executive

Insight Configuration and Administration Guide.

An Example to Get Stock Value Using Markit On Demand Web Services.

This example illustrates a web connector with a simple request and response to obtain stock value.

Only one metric will be obtained.

The URL to the Web Services documentation: http://dev.markitondemand.com/#doc

To create a Web Service connector that is using Markit on Demand web services please perform the

following steps:

1. Log in to the Admin UI.

2. Click Metric Connectors under the Admin tab. The Metric Connector page opens.

3. Click Add New, and select Web Connector from the drop-down list. The Web Connector page opens.

4. In the Name field, enter Markit on Demand Connector

To Configure the Web Service Request

5. On the Properties tab, enter the following:

Leave Active Request field empty, as this will be filled in with the Request Name once saved and

allows for multiple requests for the same connector using the New and Clone buttons.

In the Request Name field, enter Stock

Leave Method as GET

In the URL field, enter http://dev.markitondemand.com/Api/v2/Quote

Click Add new parameter link, enter the following:

symbol CA

Leave Authentication, Content, and Headers with the default field values.

6. Verify your screen looks like the image below:

7. Click Test

8. In the Response radio button group, select Status to verify that the Response status is OK.

Status:

Request Name: Stock

Status Line: HTTP/1.1 200 OK

Status Code: 200

9. In the Response radio button group, select Body to verify that XML data is displayed as the following:

Body:

Request Name: Stock

Body: <StockQuote>

<Status>SUCCESS</Status>

<Name>CA Inc</Name>

<Symbol>CA</Symbol>

< XML element above that could be used as a metric name

<LastPrice>31.98</LastPrice>

< XML element above that could be used as a metric value

<Change>-0.5</Change>

<ChangePercent>-1.539408867</ChangePercent>

<Timestamp>Wed Dec 18 12:47:46 UTC-05:00 2013</Timestamp>

<MSDate>41626.5331712963</MSDate>

<MarketCap>14431742520</MarketCap>

<Volume>284794</Volume>

<ChangeYTD>21.98</ChangeYTD>

<ChangePercentYTD>45.4959053685</ChangePercentYTD>

<High>32.5</High>

<Low>31.935</Low>

<Open>32.44</Open>

</StockQuote>

To Configure the Response Processing for the Metrics

10. On the Processing tab, enter the following:

In the Type drop-down list, select Metric.

Leave Parser with the default field value.

In the Metric Name field, enter the XPath expression //Symbol to parse the metric name from

the XML body.

In the Metric Value field, enter the XPath expression //LastPrice to parse the metric value from

the XML body.

Leave Metric Timestamp field empty to use the poller provided timestamp.

11. Click Test

12. In the Response radio button group, select Result to verify the processing results.

Results:

Request Name: Stock

Expression: //Symbol

[CA]

Expression: //LastPrice

[31.98]

13. Set Polling interval field to desired value, for example 15 minutes.

14. Verify your screen looks like the image below:

15. Click Save

To Select Metrics for Business Indicators

16. On Metrics tab, expand Stock and select metric CA to make it an business indicator

17. Verify your screen looks like the image below:

18. Click Save

An Example to Get Sentiment Value Using General Sentiment Web Services This example illustrates a web connector that requires OAuth 1.0 authentication. For the response

processing it will obtain the timestamp from the response and use the JSON parser.

The URL to the Web Services documentation: http://api.generalsentiment.com/doc/. To get OAuth 1.0

credentials (consumer key and consumer secret); you will need an account with

http://www.generalsentiment.com.

To create a WS connector that is using General Sentiment web services, please perform the following

steps:

1. Log in to the Admin UI.

2. Click Metric Connectors under the Admin tab. The Metric Connector page opens.

3. Click Add New, and select Web Connector from the drop-down list. The Web Connector page opens.

4. In the Name field, enter Google Sentiment Connector.

To Configure the Web Service Request

5. On the Properties tab, enter the following:

Leave the Active Request field empty, as this will be filled in with the Request Name once saved

and allows for multiple requests for the same connector using the New and Clone buttons.

In the Request Name field, enter Google Sentiment.

Select POST in the Method.

In the URL field, enter http://api.generalsentiment.com/api/getSentiment.

Leave Parameters and Raw Body with the default field values.

Click Add new body parameter link, enter the following:

synset Google\tGOOG

start_date $startTime{yyyyMMdd}

end_date $endTime{yyyyMMdd}

time_unit day

depository twitter

aggregate_sources true

Select OAuth in Authentication drop-down.

Select Default in the OAuth Provider drop-down.

Select application/x-www-form-urlencoded in the Content drop-down.

6. Verify your screen looks like the image below:

7. Click Setup OAuthand perform the following:

Leave Version and Token Verb with the default field values.

In the Consumer Key field, enter a Consumer Key obtained from General Sentiment.

In the Consumer Secret field, enter a Consumer Secret obtained from General Sentiment.

Leave Token Key, Token Secret and OAuth Verifier empty.

Check the Auto Authorize check box.

In the Request Token URL field, enter http://api.generalsentiment.com/oauth/request_token.

In the Access Token URL field, enter http://api.generalsentiment.com/oauth/access_token.

In the Authorization URL field, enter http://api.generalsentiment.com/oauth/authorize.

Leave Callback URL with the default field value.

8. Verify your screen looks like the image below:

9. Click OK to save and close the OAuth Authentication dialog.

10. Click Test

11. In the Response radio button group, select Status to verify that the Response status is OK.

Status:

Request Name: Google Sentiment

Status Line: OK

Status Code: 200

12. In the Response radio button group, select Body to verify that JSON data is displayed as the

following:

Body:

Request Name: Google Sentiment

Body: [ {

"sentiment" : 0.36857569574356347,

< JSON element value above that could be used as a metric value

"date" : 20131218

< JSSON element value above that could be used as a metric timestamp

}, {

"sentiment" : 0.47353098525409215,

"date" : 20131219

} ]

To Configure the Response Processing for the Metrics

13. On the Processing tab, enter the following:

In the Type drop-down list, select Metric.

In the Parser drop-down list, select JSON

o Consult with http://goessner.net/articles/JsonPath/ to find more info about JsonPath.

In the Metric Name field, enter {Sentiment} to create the metric name.

In the Metric Value field, enter the JsonPath expression $..sentiment to parse the metric value

from the JSON body.

In the Metric Timestamp field, enter the JsonPath expression $..date to parse the metric

timestamp from the JSON body.

In the Date/Time Format field, enter yyyyMMdd to indicate that timestamp is coming in this

format.

14. Click Test.

15. In the Response radio button group, select Result to verify the processing results.

Results:

Request Name: Google Sentiment

Expression: {Sentiment}

[Sentiment]

Expression: $..sentiment

[0.36857569574356347, 0.47353098525409215]

Expression: $..date

[20131218, 20131219]

16. Set Polling interval field to 1440 minutes (1 day).

17. Verify your screen looks like the image below:

18. Click Save.

To Select Metrics for Business Indicators

19. On Metrics tab, expand Google Sentiment and select metric Sentiment to create a business indicator.

20. Verify your screen looks like the image below:

21. Click Save.

An Example to Get Currencies Exchange Rate Using Yahoo Web Services This example illustrates a web connector that obtains multiple metrics from multiple XML elements in

the response.

To create a Web Service connector that is using Yahoo financial web services please perform the

following steps:

1. Log in to the Admin UI.

2. Click Metric Connectors under the Admin tab. The Metric Connector page opens.

3. Click Add New, and select Web Connector from the drop-down list. The Web Connector page opens.

4. In the Name field, enter Yahoo Finance Connector

To Configure the Web Service Request

5. On the Properties tab, enter the following:

Leave the Active Request field empty, as this will be filled in with the Request Name once saved

and allows for multiple requests for the same connector using the New and Clone buttons.

In the Request Name field, enter Currencies.

Leave Method as GET

In the URL field, enter http://finance.yahoo.com/webservice/v1/symbols/allcurrencies/quote

No Parameters are required for this request.

Leave Authentication, Content, and Headers with the default field values.

6. Verify your screen looks like the image below:

7. Click Test .

8. In the Response radio button group, select Status to verify that the Response status is OK.

Status:

Request Name: Currencies

Status Line: HTTP/1.1 200 OK

Status Code: 200

9. In the Response radio button group, select Body to verify that XML data is displayed as the following:

Body:

Request Name: Currencies

Body: <list version="1.0">

<meta>

<type>resource-list</type>

</meta>

<resources count="168" start="0">

<resource classname="Quote">

<field name="name">USD/KRW</field>

< XML attribute above that could be used as metric names

<field name="price">1052.199951</field>

< XML attribute above that could be used as metric values

<field name="symbol">KRW=X</field>

<field name="ts">1387395810</field>

< XML attribute above that could be used as metric timestamps

<field name="type">currency</field>

<field name="utctime">2013-12-18T19:43:30+0000</field>

<field name="volume">0</field>

</resource>

……………………………………………………

<resource classname="Quote">

<field name="name">USD/ARS</field>

<field name="price">6.375500</field>

<field name="symbol">ARS=X</field>

<field name="ts">1387395903</field>

<field name="type">currency</field>

<field name="utctime">2013-12-18T19:45:03+0000</field>

<field name="volume">0</field>

</resource>

</resources>

</list>

To Configure the Response Processing for the Metrics

10. On the Processing tab, enter the following:

In the Type drop-down list, select Metric.

Leave Parser with the default field value.

In the Metric Name field, enter the XPath expression //field[@name='name'] to parse the

metric name from the XML body.

In the Metric Value field, enter the XPath expression //field[@name='price'] to parse the metric

value from the XML body.

In the Metric Timestamp field, enter the XPath expression //field[@name='ts'] to parse the

metric timestamp from the XML body.

In the Date/Time Format field, enter Seconds to indicate that timestamp is coming in this

format.

11. Click Test.

12. In the Response radio button group, select Result to verify the processing results.

Results:

Request Name: Currencies

Expression: //field[@name='name']

[USD/KRW, SILVER 1 OZ 999 NY, USD/VND, USD/BOB, USD/MOP, USD/BDT, USD/MDL, USD/VEF,

USD/GEL, USD/ISK, USD/BYR, USD/THB, USD/MXV , USD/TND, USD/JMD, USD/DKK, USD/SRD,

USD/BWP, USD/NOK, USD/MUR, USD/ZMK, USD/AZN, USD/INR, USD/MGA, USD/CAD, USD/XAF,

USD/LBP, USD/XDR, USD/IDR, USD/IEP, USD/AUD, USD/MMK, USD/LYD, USD/ZAR, USD/IQD,

USD/XPF, USD/TJS, USD/CUP, USD/UGX, USD/NGN, USD/PGK, USD/TOP, USD/TMT, USD/KES,

USD/CRC, USD/MZN, USD/SYP, USD/ANG, USD/ZMW, USD/BRL, USD/BSD, USD/NIO, USD/GNF,

USD/BMD, USD/SLL, USD/MKD, USD/BIF, USD/LAK, USD/BHD, USD/SHP, USD/BGN, USD/SGD,

USD/CNY, USD/EUR, USD/TTD, USD/SCR, USD/BBD, USD/SBD, USD/MAD, USD/GTQ, USD/MWK,

USD/PKR, USD/PEN, USD/AED, USD/LVL, PALLADIUM 1 UZ, USD/UAH, USD/LRD, USD/LSL,

USD/SEK, USD/RON, USD/XOF, USD/COP, USD/CDF, USD/USD, USD/TZS, USD/GHS, USD/NPR,

USD/ZWL, USD/SOS, USD/DZD, USD/FKP, USD/LKR, USD/JPY, USD/CHF, USD/KYD, USD/CLP,

USD/IRR, USD/AFN, USD/DJF, USD/SVC, USD/PLN, USD/PYG, USD/ERN, USD/ETB, USD/ILS,

USD/TWD, USD/KPW, USD/GIP, USD/BND, USD/HNL, USD/CZK, USD/HUF, USD/BZD, USD/JOD,

USD/RWF, USD/LTL, USD/RUB, USD/RSD, USD/WST, PLATIN 1 UZ 999, USD/PAB, USD/NAD,

USD/DOP, USD/ALL, USD/HTG, USD/AMD, USD/KMF, USD/MRO, USD/HRK, USD/KHR, USD/PHP,

USD/KWD, USD/XCD, COPPER HIGHGRADE, USD/CNH, USD/SDG, USD/CLF, USD/KZT, USD/TRY,

USD/FJD, USD/NZD, USD/BAM, USD/BTN, USD/STD, USD/VUV, USD/MVR, USD/AOA, USD/EGP,

USD/QAR, USD/OMR, USD/CVE, USD/KGS, USD/MXN, USD/MYR, USD/GYD, USD/SZL, USD/YER,

USD/SAR, USD/UYU, USD/GBP, USD/UZS, USD/GMD, USD/AWG, USD/MNT, GOLD 1 UZ,

USD/HKD, USD/ARS]

Expression: //field[@name='price']

[1049.640015, 0.049965, 21090.000000, 6.910000, 7.985250, 77.660004, 12.570000, 6.287700,

1.708900, 116.500000, 9470.000000, 32.200001, 2.546564, 1.650150, 106.050003, 5.420600,

3.275000, 8.688100, 6.103500, 30.450001, 0.000000, 0.784400, 61.619999, 2255.000000,

1.065505, 478.015747, 1505.500000, 0.649650, 12155.000000, 0.573921, 1.123356,

984.000000, 1.238000, 10.252300, 1163.050049, 86.620003, 4.773100, 1.000000, 2495.000000,

160.050003, 2.533400, 1.858897, 2.850300, 86.161499, 496.100006, 29.900000, 140.800003,

1.774700, 5.400000, 2.328300, 1.000000, 25.155001, 6828.000000, 1.000000, 4335.000000,

44.830002, 1535.000000, 8005.500000, 0.377100, 0.611450, 1.428800, 1.257310, 6.071800,

0.726040, 6.430000, 12.061450, 2.000000, 7.192645, 8.154150, 7.878000, 426.649994,

106.400002, 2.789000, 3.673100, 0.510250, 0.001432, 8.285000, 81.449997, 10.330000,

6.527900, 3.248600, 477.250000, 1944.000000, 911.500000, 1.000000, 1603.500000, 2.302500,

99.919998, 322.355011, 1172.000000, 78.334999, 0.611400, 130.800003, 103.425003,

0.887760, 0.820000, 526.794983, 24794.000000, 54.020000, 180.750000, 8.747500, 3.026850,

4518.845215, 14.880000, 19.115999, 3.505850, 29.730000, 900.000000, 0.611450, 1.260000,

20.405001, 20.037500, 216.294998, 1.990000, 0.707800, 670.000000, 2.502100, 32.762501,

83.335503, 2.320498, 0.000745, 1.000000, 10.352000, 42.500000, 102.099998, 43.240002,

404.950012, 357.725006, 290.500000, 5.546800, 3995.000000, 44.270000, 0.283000, 2.700000,

0.297000, 6.073750, 5.692500, 0.022740, 154.125000, 2.039300, 1.882500, 1.211460, 1.422450,

62.005001, 17835.000000, 96.330002, 15.410000, 97.730003, 6.895850, 3.641450, 0.384950,

79.080002, 49.053501, 12.846800, 3.256000, 207.949997, 10.319000, 214.755005, 3.750700,

21.170000, 0.608180, 2199.929932, 37.599998, 1.789800, 1637.500000, 0.000809, 7.752565,

6.377100]

Expression: //field[@name='ts']

[1387396070, 1387391984, 1387395910, 1387395790, 1387395790, 1387395910, 1387395803,

1387395910, 1387395790, 1387395790, 1387395790, 1387396030, 1387395930, 1387396058,

1387395910, 1387396080, 1387395910, 1387395790, 1387396081, 1387395910, 0,

1387395790, 1387396025, 1387395910, 1387396081, 1387395790, 1387395804, 1387395790,

1387395790, 1387395790, 1387396050, 1387395910, 1387395910, 1387396080, 1387395910,

1387395803, 1387395790, 1387395790, 1387395803, 1387395803, 1387395790, 1387395920,

1387395790, 1387396073, 1387395910, 1387395910, 1387395910, 1387395803, 1387395910,

1387396016, 1387395790, 1387395910, 1387395901, 1387395790, 1387395910, 1387395802,

1387395910, 1387395910, 1387395910, 1387395790, 1387395790, 1387396081, 1387395910,

1387396060, 1387395802, 1387395846, 1387395790, 1387395790, 1387396073, 1387395802,

1387395803, 1387395910, 1387395910, 1387395910, 1387396070, 1387390587, 1387395803,

1387395910, 1387395790, 1387396081, 1387396076, 1387395910, 1387395910, 1387395802,

1387395790, 1387395910, 1387395910, 1387395790, 1387395790, 1387395910, 1387396073,

1387395790, 1387395790, 1387396081, 1387396081, 1387395790, 1387395896, 1387395910,

1387395910, 1387395910, 1387395803, 1387396081, 1387395790, 1387395920, 1387395790,

1387396050, 1387395910, 1387395790, 1387395790, 1387395802, 1387395802, 1387396081,

1387396080, 1387395790, 1387395910, 1387395802, 1387396046, 1387396081, 1387395910,

1387395790, 1387390616, 1387395790, 1387395910, 1387395803, 1387395790, 1387395803,

1387395790, 1387395803, 1387395910, 1387396076, 1387395790, 1387395910, 1387395910,

1387395790, 1387392164, 1387395790, 1387395910, 1387395790, 1387395790, 1387396081,

1387374301, 1387396050, 1387395910, 1387395790, 1387395910, 1387395910, 1387395790,

1387395790, 1387395996, 1387396041, 1387395910, 1387395910, 1387395790, 1387396081,

1387395790, 1387395910, 1387395910, 1387395910, 1387396075, 1387395802, 1387396030,

1387395790, 1387395790, 1387395910, 1387395910, 1387396056, 1387396049, 1387396073]

13. Set Polling interval field to desired value, for example 1 minute.

14. Verify your screen looks like the image below:

15. Click Save.

To Select Metrics for Business Indicators

16. On the Metrics tab, expand Currencies and select desired metrics to create business indicators.

17. Verify your screen looks like the image below:

18. Click Save

An Example to Get Weather Information Using Yahoo Web Services This example illustrates a web connector that obtains multiple metrics from a single XML element.

The URL to the Web Services documentation: http://developer.yahoo.com/weather/

To create a WS connector that is using Yahoo weather web services please perform the following steps:

1. Log in to the Admin UI.

2. Click Metric Connectors under the Admin tab. The Metric Connector page opens.

3. Click Add New, and select Web Connector from the drop-down list. The Web Connector page opens.

4. In the Name field, enter Yahoo Weather Connector.

To Configure the Web Service Request

5. On the Properties tab, enter the following:

Leave Active Request field empty, as this will be filled in with the Request Name once saved and

allows for multiple requests for the same connector using the New and Clone buttons.

In the Request Name field, enter Boston Weather.

Leave Method as GET

In the URL field, enter http://weather.yahooapis.com/forecastrss?w=2367105

No Parameters are required for this request.

Leave Authentication, Content, and Headers with the default field values.

6. Verify your screen looks like the image below:

7. Click Test .

8. In the Response radio button group, select Status to verify that the Response status is OK.

Status:

Request Name: Boston Weather

Status Line: HTTP/1.1 200 OK

Status Code: 200

9. In the Response radio button group, select Body to verify that XML data is displayed as the following:

Body:

Request Name: Boston Weather

Body: <rss version="2.0" xmlns:geo="http://www.w3.org/2003/01/geo/wgs84_pos#"

xmlns:yweather="http://xml.weather.yahoo.com/ns/rss/1.0">

<channel>

<title>Yahoo! Weather - Boston, MA</title>

<link>http://us.rd.yahoo.com/dailynews/rss/weather/Boston__MA/*http://weather.yahoo.

com/forecast/USMA0046_f.html</link>

<description>Yahoo! Weather for Boston, MA</description>

<language>en-us</language>

<lastBuildDate>Wed, 18 Dec 2013 1:52 pm EST</lastBuildDate>

<ttl>60</ttl>

<yweather:location city="Boston" country="United States" region="MA"/>

<yweather:units distance="mi" pressure="in" speed="mph" temperature="F"/>

<yweather:wind chill="26" direction="300" speed="15"/>

< XML attribute above that could be used as a metric value

<yweather:atmosphere humidity="46" pressure="29.91" rising="1" visibility="10"/>

< XML attribute above that could be used as a metric value

<yweather:astronomy sunrise="7:07 am" sunset="4:11 pm"/>

<image>

<title>Yahoo! Weather</title>

<width>142</width>

<height>18</height>

<link>http://weather.yahoo.com</link>

<url>http://l.yimg.com/a/i/brand/purplelogo//uh/us/news-wea.gif</url>

</image>

<item>

<title>Conditions for Boston, MA at 1:52 pm EST</title>

<geo:lat>42.36</geo:lat>

<geo:long>-71.06</geo:long>

<link>http://us.rd.yahoo.com/dailynews/rss/weather/Boston__MA/*http://weather.yahoo.

com/forecast/USMA0046_f.html</link>

<pubDate>Wed, 18 Dec 2013 1:52 pm EST</pubDate>

<yweather:condition code="30"

date="Wed, 18 Dec 2013 1:52 pm EST" temp="35" text="Partly Cloudy"/>

<description><![CDATA[

<img src="http://l.yimg.com/a/i/us/we/52/30.gif"/><br />

<b>Current Conditions:</b><br />

Partly Cloudy, 35 F<BR />

<BR /><b>Forecast:</b><BR />

Wed - Sunny. High: 33 Low: 23<br />

Thu - Partly Cloudy. High: 40 Low: 32<br />

Fri - Few Showers. High: 46 Low: 36<br />

Sat - Cloudy. High: 46 Low: 38<br />

Sun - Showers/Wind. High: 58 Low: 49<br />

<br />

<a

href="http://us.rd.yahoo.com/dailynews/rss/weather/Boston__MA/*http://weather.yahoo.

com/forecast/USMA0046_f.html">Full Forecast at Yahoo! Weather</a><BR/><BR/>

(provided by <a href="http://www.weather.com" >The Weather Channel</a>)<br/>

]]></description>

<yweather:forecast code="32" date="18 Dec 2013" day="Wed"

high="33" low="23" text="Sunny"/>

<yweather:forecast code="30" date="19 Dec 2013" day="Thu"

high="40" low="32" text="Partly Cloudy"/>

<yweather:forecast code="11" date="20 Dec 2013" day="Fri"

high="46" low="36" text="Few Showers"/>

<yweather:forecast code="26" date="21 Dec 2013" day="Sat"

high="46" low="38" text="Cloudy"/>

<yweather:forecast code="11" date="22 Dec 2013" day="Sun"

high="58" low="49" text="Showers/Wind"/>

<guid isPermaLink="false">USMA0046_2013_12_22_7_00_EST</guid>

</item>

</channel>

</rss>

To Configure the Response Processing for the Metrics

10. On the Processing tab, enter the following:

In the Type drop-down list, select Metric.

Leave Parser with the default field value.

In the Metric Name field, enter {Temperature};{Humidity} to create 2 metric names.

In the Metric Value field, enter the XPath expression

//yweather:wind[@chill];//yweather:atmosphere[@humidity] to parse the two metric values

from the XML body.

Leave Metric Timestamp field empty to use the poller provided timestamp.

11. Click Test

12. In the Response radio button group, select Result to verify the processing results.

Results:

Request Name: Boston Weather

Expression: {Temperature}

[Temperature]

Expression: //yweather:wind[@chill]

[26]

Expression: {Humidity}

[Humidity]

Expression: //yweather:atmosphere[@humidity]

[46]

13. Set Polling interval field to desired value, for example 60 minutes.

14. Verify your screen looks like the image below:

15. Click Save

To Select Metrics for Business Indicators

16. On Metrics tab, expand Boston Weather and select Temperature and Humidity metrics to create

business indicators.

17. Verify your screen looks like the image below:

18. Click Save.

An Example to Get Brand Influence Score Using Klout Web Services This example illustrates a web connector with a request that depends on another web service request to

obtain a session id that will then be used for the web service to collect the metric.

The URLs to the Web Services documentation: http://bradsknutson.com/blog/display-klout-score-with-klout-api/ http://klout.com/s/developers/v2

To create a WS connector that is using Klout web services please perform the following steps:

1. Log in to the Admin UI.

2. Click Metric Connectors under the Admin tab. The Metric Connector page opens.

3. Click Add New, and select Web Connector from the drop-down list. The Web Connector page opens.

4. In the Name field, enter CA Klout Score.

5. In the Description field, enter Brand Influence

To Configure the Web Service Request for a Variable

6. On the Properties tab, enter the following:

Leave Active Request field empty, as this will be filled in with the Request Name once saved and

allows for multiple requests for the same connector using the New and Clone buttons.

In the Request Name field, enter Get Id.

Leave Method as GET

In the URL field, enter http://api.klout.com/v2/identity.json/twitter

Click Add new parameter link, enter the following:

screenName CA

key xxxxxxxxxxxxxxxxxxx - your API key can be obtained using http://developer.klout.com/member/register

Leave Authentication, Content, and Headers with the default field values.

7. Verify your screen looks like the image below:

8. Click Test

9. In the Response radio button group, select Status to verify that the Response status is OK.

Status:

Request Name: Get Id

Status Line: HTTP/1.1 200 OK

Status Code: 200

10. In the Response radio button group, select Body to verify that XML data is displayed as the following:

Body:

Request Name: Get Id

Body: {

"id" : "31525202156550768",

< JSON element value above that could be used as variable

"network" : "ks"

}

To Configure the Response Processing for a Variable

11. On the Processing tab, enter the following:

In the Type drop-down list, select Metadata.

In the Parser drop-down list, select JSON

Click Add new variable link, enter the following:

id $..id

12. Click Test

13. In the Response radio button group, select Result to verify the processing results.

Results:

Request Name: Get Id

Expression: $..id

[31525202156550768]

14. Verify your screen looks like the image below:

To Configure the Web Service Request for the Metric

15. Go to the Properties tab and click the New button to create a new request.

16. Click Yes Add on the Confirm dialog

17. Enter the following:

In the Request Name field, enter CA Score

Leave Method as GET In the URL field, enter http://api.klout.com/v2/user.json/${id}/score

Click Add new parameter link, enter the following:

key xxxxxxxxxxxxxxxxxxx - your API key

Leave Authentication, Content, and Headers with the default field values.

18. Click Test

19. In the Response radio button group, select Status to verify that the Response status is OK.

Status:

Request Name: CA Score

Status Line: HTTP/1.1 200 OK

Status Code: 200

20. In the Response radio button group, select Body to verify that XML data is displayed as the following:

Body:

Request Name: CA Score

Body: {

"score" : 71.17870234963782,

"scoreDelta" : {

"dayChange" : 0.027960410165690064,

"weekChange" : 0.13356043811968732,

"monthChange" : 3.8499299656164254

},

< JSON element values above could be used as metric values

"bucket" : "70-79"

}

21. Verify your screen looks like the image below:

To Configure the Response Processing for the Metrics

22. On the Processing tab, enter the following:

In the Type drop-down list, select Metric.

Leave Parser with the default field value.

In the Metric Name field, enter {Score};{Daily Change};{Weekly Change};{Monthly Change} to

create 4 metric names.

In the Metric Value field, enter the JsonPath expression

$..score;$..dayChange;$..weekChange;$..monthChange to parse the 4 metric values from the

JSON body.

Leave the Metric Timestamp field empty to use the poller provided timestamp.

23. Click Test

24. In the Response radio button group, select Result to verify the processing results.

Results:

Request Name: CA Score

Expression: {Score}

[Score]

Expression: $..score

[71.17870234963782]

Expression: {Daily Change}

[Daily Change]

Expression: $..dayChange

[0.027960410165690064]

Expression: {Weekly Change}

[Weekly Change]

Expression: $..weekChange

[0.13356043811968732]

Expression: {Monthly Change}

[Monthly Change]

Expression: $..monthChange

[3.8499299656164254]

25. Set Polling interval field to 1440 minutes (1 day).

26. Verify your screen looks like the image below:

27. Click Save

To Select Metrics for Business Indicators

28. On the Metrics tab, expand CA Score and select Score and Weekly Change metrics to create business

indicators.

29. Verify your screen looks like the image below:

30. Click Save