Action Options dialog: Action Results tab

Use this tab of the "Action Options dialog" to customize a dialog to display information to users about the results of the action, if the action executed successfully.

For more information, see:

Components

Contains HTML Markup

Use this option to work with HTML codes, as described in "Working with HTML Markup".

Dialog Text

Use this field to enter the Web Service results information to display to users.

XPath Results

Use this area to specify one or more XPath expressions to be used to extract values from the XML returned from the Invoke a Web Service action.

Note:

Before specifying any XPath expressions, you must know what the Web Service returns. You can find out what a Web Service returns by reading the Web Services Definition Language (WSDL).

To add an XPath Expression to the list, click the Add XPath Expression button. A row is added to the list, where you then specify the following information:

In the Name column, enter a unique name for the XPath expression, for example, filename. You then can use this name to embed the XPath expression as a token in the dialog text, for example, @{filename}.
In the XPath Expression column, enter the XPath expression. For example, if you know that the name of a file can be identified by the XPath expression "Body/writeToFileResponse/result", you enter Body/writeToFileResponse/result.
In the Default Value column, enter the value to display when the XPath expression is not found in the action results. If you do not enter a default value and the XPath expression is not found, then an empty string is displayed.

Note:

If multiple values for an XPath expression are found in the results, then only the first value is shown.

To delete an XPath expression from the list, select the XPath expression and click the Delete XPath Expression button.

Dialog Title

Use this box to specify the title of the dialog, for example, Action Results.

Dialog Width

Use this field to specify the width for the dialog. Specifying a width causes the content to wrap and a scroll bar to be displayed, if necessary.

If you do not specify the width, then the dialog is sized based on its content.

You might want to specify a width, for example, if the dialog text contains a long sentence without any explicit line breaks, which would result in a very wide dialog.

Dialog Height

Use this field to specify the height for the dialog. Specifying a height causes the content to wrap and a scroll bar to be displayed, if necessary.

If you do not specify the height, then the dialog is sized based on its content.

You might want to specify a height, for example, if the dialog contains extensive text, which would result in a very long dialog.

Show Preview

Use this button to preview how the dialog is displayed. (Note that this does not run the action.)

Working with HTML Markup

Various dialogs and editors in which you can enter HTML codes include the Contains HTML Markup box. These dialogs and editors include the "Action Options dialog: Action Results tab", the "Edit Footer or Header dialog", the "Results tab: Narrative editor", the "Results tab: Static Text editor", the "Results tab: Ticker editor", and the "Text Properties dialog".

This option is available in the Action Options dialog: Action Results tab only if you have been granted the Save Actions containing embedded HTML privilege, and in the other dialogs and editors only if you have been granted the Save Content with HTML Markup privilege by the administrator.

Use this box to specify whether the text that you enter in the appropriate field contains HTML markup. (For example, in the Action Results tab, the field is labeled Dialog Text.) Select this box if the text contains HTML markup. Deselect this box if it contains only plain text. If the text contains HTML markup and you do not select this box, then the text is displayed as plain text.

You can add HTML that contains formatted text, and depending on the security settings of the servers, Active-X controls or Java scripts, sound bites, animation, a background image, and so on. The HTML code can contain anything that is supported by the browser.

Table E-1 contains usage notes and examples for several HTML elements. If you find an example in the table that is similar to what you want to do, then you can copy and paste the example, then tailor it to your needs.

Table E-1 Usage Notes and Examples for HTML Elements

HTML Element	Usage Notes and Examples
Text	Any HTML tags can be used to control the format of the text. The following HTML tags are examples of some of the formatting you can apply. To center the text in the section: <CENTER>Centered Text</CENTER> To make the text bold: <B>Bold Text</B> To set font size and color: <FONT SIZE="4" COLOR="red">Red Text</FONT> You can also combine tags for additional effects: <CENTER><B><FONT COLOR="red">Bold Centered Red Text</FONT></B></CENTER>
Active-X object	The Active-X object must be self-contained and supported by the browser. Paste or type the object into the HTML text window, ensuring that you include the beginning and ending tags <object...> and </object>.
JavaScript and VBScript	The script must be self-contained and supported by the browser. Paste or type the script into the HTML text window, ensuring that you include the beginning and ending tags <script> and </script>. Specify the script language in the opening <SCRIPT> tag, either <SCRIPT LANGUAGE="javascript"> or <SCRIPT LANGUAGE="vbscript">. Note that Oracle BI EE does not support the use of `document.write()` or `document.writeln()` functions in these custom script entries.
Audio	Ensure that you know where the audio clip is located. If the audio clip is for use in a shared environment, then it must be located on a network drive that is accessible to all users. Use the HTML tag <EMBED> to add audio in the dashboard. The following HTML code is an example: <EMBED SRC="audio" AUTOSTART="true" LOOP="true" HIDDEN="true"></EMBED> where "audio" is the location and name of the audio clip. Note: You might need to adjust the HTML for the browser. The following HTML tags are examples of the <EMBED> tag. To add an audio clip located on the hard drive, specify the following HTML code: <EMBED SRC="c:\mycomputer\MIDIfiles\wakeup.mid" AUTOSTART="true" LOOP="true" HIDDEN="true"></EMBED> To add the same audio clip from a shared location on the Web server, specify the following HTML code: <EMBED SRC="/DashboardFiles/wakeup.mid" AUTOSTART="true" LOOP="true" HIDDEN="true"></EMBED>