Configuring the Adapter for XML

In this section:

How to:

x

You can configure the Adapter for XML from the Web Console or the Data Management Console.

Top of page
x
Procedure: How to Configure the Adapter

You can configure the adapter from either the Web Console or the Data Management Console.

  1. From the Web Console menu bar, click Adapters.

    or

    From the Data Management Console, expand the Adapters folder.

    The Adapters folder opens.

  2. Expand the Available folder, if it is not already expanded.
  3. Expand the appropriate group folder and the specific adapter folder. The group folder is described in the connection attributes reference.
  4. Right-click the adapter name and/or version and select Configure.

    The Add Adapter to Configuration pane opens.

  5. Enter values for the parameters required by the adapter, as described in the connection attributes reference.
  6. Click Configure. The configured adapter is added to the Adapters list in the navigation pane.

Note: The XML adapter is under the XML-based group folder. No input parameters are required.

Top of page
x
Associating a Master File With an XML Document

How to:

You must explicitly issue a FILEDEF command to associate a Master File with an XML document. In order to properly code the FILEDEF command, you need to determine how the XML documents are organized. If the documents are in one file and are described by the same DTD, the organization is called a COLUMN. If there are various documents in one directory and all are described by the same DTD, then the organization is called a COLLECTION.

Source

Collection Organization

Column Organization

disk

supported

supported

http

not supported

supported

https

not supported

supported
x
Syntax: How to Associate a Master File With an XML Document
FILEDEF ddname source filename

where:

ddname

Is the logical reference name matching the desired Master File.

source

Is the location of the XML document. Possible values are http, https, and disk.

filename

For an XML Column, is the full path to the source file.

For an XML Collection, is the full path to the source directory. The directory name must be followed by the wildcard characters '*.*'.

The file name must start with 'http://' or 'https://' if the XML documents are to be read using an HTTP or HTTPS session.
Example: Issuing a FILEDEF Command for an XML Column

Note: If you are working on the Web Console or Data Management Console Create Synonym panes, see Synonym Creation Parameters for XML for details about how FILEDEFs are created.

For Windows, when you have the ordercol.xml document under C:\, use the following FILEDEF in your profile: 

FILEDEF ordercol disk C:\ordercol.xml

For UNIX, when you have the ordercol.xml document under /usera/xml/, use the following FILEDEF in your profile: 

FILEDEF ordercol DISK /usera/xml/ordercol.xml

For z/OS, when you have the ordercol.xml document in TEST.XML.DOC, use the following FILEDEF in your profile:

FILEDEF ordercol DISK //'TEST.XML.DOC'

For HTTP and HTTPS, when you have the ordercol.xml document under http://www.test.com/xmltest/ (or https://www.test.com/xmltest/), use the following FILEDEF in your profile: 

FILEDEF order http http://www.test.com/xmltest/ordercol.xml

or

FILEDEF order http https://www.test.com/xmltest/ordercol.xml
Example: Issuing a FILEDEF Command for an XML Collection

Note: If you are working on the Web Console or Data Management Console Create Synonym panes, see Synonym Creation Parameters for XML for details about how FILEDEFs are created.

For Windows, when you have the order1.xml and order2.xml documents under C:\ORDERS, use the following FILEDEF in your profile: 

FILEDEF order disk C:\orders\*.*

For UNIX, when you have the ordercol.xml document under /usera/orders, use the following FILEDEF in your profile:

FILEDEF ordercol DISK //'TEST.XML.DOC(dtd)'

For z/OS, when you have the order document in TEST.XML.DOC (DTD), use the following FILEDEF in your profile:

FILEDEF order DISK /usera/orders/*.*
WebFOCUS