OmniPortlet: Source (XML) tab

| Field Descriptions | Related Help Topics | Locating this Page |

Use this tab to:

Identify the XML data you want to display in the portlet.
Enter the connection information for accessing the data source.
Specify the portlet parameters.

The XML data must be in standard <ROWSET>/<ROW> format. For example

<rowset> <row> <column1>value</column1> <column2>value</column2> </row> <row> <column1>value</column1> <column2>value</column2> </row> </rowset>

If not, you must specify an XSL Filter that transforms the XML data structure to a <ROWSET>/<ROW> format.

You can optionally specify an XML Schema that defines the structure of the XML data.

Using portlet parameters

You can also use this page to specify portlet parameters. The parameter values determine which data displays in the portlet. After you identify a portlet parameter, you can use it to pass values on a URL or to embed values in portlet text.

Parameter precedence

The following order of precedence applies to the portlet parameters when a page parameter is mapped to a portlet parameter.

The value the end user gave to the portlet parameter on the OmniPortlet Personalize screen.
The value of the page parameter in the URL (for example, "&myPageParameter=30").
The value the end user gave to the page parameter on the Personalize Page screen.
The default value the page designer gave to the portlet parameter on the Source tab.
The default value as defined in the <parameter> tag in the OmniPortlet definition in the provider.xml file.

Field Descriptions

XML

Field	Description
XML URL	Enter the URL to your XML data. The XML data should be in <ROWSET>/<ROW> format. If it isn't, you must also specify a URL to an XSL filter to convert the data to the correct format. Note: For OmniPortlet to access the XML file, ensure other users can access the page on which you added the XML file: To make the page accessible to all users, whether logged in to OracleAS Portal or not: Edit the page. Click the Access link at the top of the page. Click the Access tab. Select Display Page To Public Users, then click OK. For more information about adding these privileges, click Help on the Access page.
XSL Filter URL	Enter the URL to an XSL filter if your XML data is not in <ROWSET>/<ROW> format. The XSL filter should contain the necessary information to transform your XML to the expected format.
XML Schema URL	Enter the URL to an XML Schema that describes the structure of your XML data. You may want to use an XML Schema to describe the new XML data structure created as a result of applying the XSL filter.

Field

Description

XML URL

Enter the URL to your XML data. The XML data should be in <ROWSET>/<ROW> format. If it isn't, you must also specify a URL to an XSL filter to convert the data to the correct format.

Note: For OmniPortlet to access the XML file, ensure other users can access the page on which you added the XML file:

To make the page accessible to all users, whether logged in to OracleAS Portal or not:

Edit the page.
Click the Access link at the top of the page.
Click the Access tab.
Select Display Page To Public Users, then click OK.

For more information about adding these privileges, click Help on the Access page.

XSL Filter URL

Enter the URL to an XSL filter if your XML data is not in <ROWSET>/<ROW> format. The XSL filter should contain the necessary information to transform your XML to the expected format.

XML Schema URL

Enter the URL to an XML Schema that describes the structure of your XML data. You may want to use an XML Schema to describe the new XML data structure created as a result of applying the XSL filter.

Connection

Field	Description
Connection Information	Displays the username of the current connection and whether it is associated with a Named Connection. Note: This connection information is used to provide credentials to URLs secured by basic authentication.
Edit Connection	Click to change the connection information and test the connection.
Use this connection information for all users	Click to allow the end user to use the connection information you entered to retrieve data.
User must re-enter connection information	Click to require the end user to enter the connection information at run time. If you associated the connection information with a Named Connection, the user only needs to provide the connection information once to access all portlets on a page that use the same Named Connection.

Portlet Parameters

Field	Description
Parameter Name	Displays the name of each parameter. Use this name to identify the parameter on a URL.
Default Value	Enter an optional value to display by default in the parameter's entry field in the portlet's Personalize screen.
Personalizable	Select to enable the parameter. End users can choose values for the parameter on the portlet's Personalize screen.
Personalize Page Label	Enter an optional label for the parameter entry field to display on the portlet's Personalize screen.
Personalize Page Description	Enter an optional description of the parameter to display on the portlet's Personalize screen.

Locating this Page

Add an OmniPortlet to your page.
In the OmniPortlet wizard, on the Type tab, choose XML, then click Next.