The second step of creating a data service is to select input parameters for the web service. Where do these input parameters come from?
As mentioned in the overview,
every Yahoo! search result has one or more data services available,
represented in SearchMonkey as a DataRSS <adjunct>.
Within each of these adjuncts, there might be parameters that you want
to pass to a remote web service call. These parameters are the literal
contents of <meta> elements within the adjunct. For
example, the site RestaurantHelper.com creates a feed of its
restaurant info:
<adjunct id="smid:someID">
<item rel="dc:subject">
<type typeof="commerce:Restaurant">
<meta property="rdfs:label">Chez TJ</meta>
<item rel="vcard:adr">
<type typeof="vcard:Address">
<meta property="vcard:street-address">938 Villa Street</meta>
<meta property="vcard:locality">Mountain View</meta>
<meta property="vcard:region">CA</meta>
<meta property="vcard:country-name">United States</meta>
</type>
</item>
<meta property="commerce:cuisine">Contemporary French</meta>
</type>
</item>
</adjunct>
For any given search result from RestaurantHelper.com,
you could extract the commerce:cuisine and
vcard:locality and pass those values to a remote web
service API, perhaps to retrieve information about related restaurants
in the area. To select your web service input parameters, such as
commerce:cuisine and vcard:locality in the
above example, you must specify an <adjunct id>,
<item rel>, and <meta property> in
the Inputs screen.
Parent Adjunct (id) — Specifies the
id of an <adjunct> that contains
parameters to pass in to a remote web service (optional).
Parent Item (rel) — Selects the
rel of an <item> that contains
parameters to pass in to a remote web service (can be
grandparent).
Meta (property — Specifies the
property of a <meta> to pass in to a
remote web service. To add more inputs, click the green
+. To remove an input, click the red
x.
— Saves your changes and continues to “Step 3: Test Data”.
— Saves your changes and returns to “Step 1: Basic Info”.
— Returns to the Application Dashboard.
