Adding Metadata to Mashups
Metadata declarations allow you to set processing flags or pass other information to applications that will use a mashup, use a macro or handle mashup results. Metadata is stored with mashups in the
Presto Repository and can be queried
Using the Built-in Mashup Query Web Service.
The metadata declarations that you can use include:
<emml-meta> for metadata built into
EMML. It provides processing flags or other information used by the
Presto Server.
<presto:macro-meta> for metadata for macros that is used by
Presto. It provides processing flags used by the
Presto Server or by mashup composers such as
Wires.
Note: | <presto:macro-meta> is a new metadata element that replaces variations of the <presto:presto-meta> element specific to macros. |
<presto:presto-meta> for metadata for mashups that is used by
Presto. It provides processing flags used by the
Presto Server or by mashup composers such as
Wires.
Note: | Variations of <presto:presto-meta> specific to macros have been deprecated. Use <presto:macro-meta> instead. |
<user-meta> to define your own custom metadata. You can use this for flags or any other data you wish to associate with a mashup or a macro. You define the names and content of user metadata to fit your requirements.
Metadata Names and Values
Most metadata declarations have a name attribute that identifies the purpose of the metadata. Names for user-defined metadata must:
Be unique.
Start with an ASCII letter and contain only ASCII letters, numbers, dashes (-) or underscores (_). Names are case sensitive.
Metadata declarations can contain a simple value or a complex structure of descendant elements. Simple values for metadata are a string datatype.
For complex structures, descendants can only be your own custom metadata or extensions specifically allowed in <presto:presto-meta> or <presto:macro-meta>. Other EMML statements or declarations are not allowed.
For example:
<user-meta name="refresh-seconds">5</user-meta>
<presto:presto-meta name="created-using">Wires</presto:presto-meta>
<presto:macro-meta>
<block usage="Wires">
<help>Returns all open issues for the customer specified as input.</help>
<icon usage="menu" url="http://myOrg.com/icons/myBlockSmall.png"/>
<icon usage="canvas" url="http://myOrg.com/icons/myBlockMed.png"/>
</block>
<parameters>
<parameter name="query">
<label>Customer</label>
<help>Enter part or all of a customer name to find open issues.</help>
<type datatype="text"/>
</parameter>
</parameters>
</presto:macro-meta>