Mashups in Presto Wires : Customizing Wires : Add Tooltips and Help in Custom Blocks : Add a Help Button and Help Topic
Add a Help Button and Help Topic
For custom Wires blocks that require more than simple tooltips for user assistance, you can also create an HTML page as a help topic and add this to the block properties form using the macro metadata element <help> within <block>. This adds a ? button to the properties form.
The button opens your help topic (HTML page) in a new window that is 550px wide, by default, but can be resized.
How you handle CSS and images for help topics depends on how this HTML page will be accessed:
*Absolute URLs: the help topic HTML page, along with any CSS stylesheets and images must be hosted in a web server or application server that is accessible to the Presto Server. There are no special requirements for links to CSS or images.
*Relative URLs: the help topic HTML page and any images should be uploaded to Presto by a Presto administrator. You may also upload CSS stylesheets or simply define all classes in an internal <style> tag in the <head> element of the help topic HTML page.
With relative URLs, you refer to CSS or images using a URL in the form /presto/files/path/filename-assigned using the path and filename assigned in Presto.
Create the HTML page for the help topic and either:
*Deploy it, with any required resources in an appropriate web server or application server that accessible to the Presto Server.
*Upload it, with any required resources, to Presto.
Then add a URL to <help> in <block>:
<macros xmlns="http://www.open-mashup.org/schemas/v1.0/EMML"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.openmashup.org/schemas/v1.0/EMML/..
/schemas/EMMLPrestoSpec.xsd"
domain="myBlocks">

<macro name="helloWorld"
xmlns:presto="http://www.jackbe.com/v1.0/EMMLPrestoExtensions"
xmlns:macro="http://www.openmashup.org/schemas/v1.0/EMMLMacro">
<presto:macro-meta>
<block usage="Wires">
<label>Hello world!</label>
<help url="http://myOrg.com/help/helloworld.html">
Hello world block tooltip</help>
...
</block>
...
</presto:macro-meta>
....
</macro>
...
</macros>
This example shows an absolute URL. If you have uploaded the help topic to Presto, use a URL in the form /presto/files/path/help-topic-name.
Copyright © 2013-2015 Software AG, Darmstadt, Germany.

Product LogoContact Support   |   Community   |   Feedback