XSD Extension for UserArea
Intermediate | 45 Minutes
Overview
The UserArea TAG is a standard tag in any standard BOD (Business Object Document). It is used by the application when you need to add extra information that is not included in the standard BOD. You can use a pair of Property TAGs with NameValue.
XML
Sometimes, you need to add a well-defined structure as extra information. In such cases, you can use an XSD Extension.
📋 Requirements
|
Tutorial
In this section, you will learn how to extend a standard UserArea TAG, define an XSD schema, and link it to the UserArea TAG for a specific BOD in the Data Catalog.
1
Check the standard BOD
For this example, you will use the ItemMaster standard BOD.
- Expand the Data Catalog menu and select Object Schema, filter on ItemMaster, and click Search.
- Select the ItemMaster BOD and open it.
- On the Formatted View tab, expand the original schema definition. You can see the standard pair of TAGs (
Property,NameValue) related to the "ItemMaster/ItemMasterHeader/UserArea" tag. The goal is to add an extra tag pointing to your custom XSD schema definition.
2
Create the XSD schema definition file
- Download and extract the item_ext.zip file located in the Downloads section (button labeled XSD_Schema) at the bottom of this tutorial. The zip file contains the item_ext.xsd file.
- First, you need to create the extension with the required tags. Below is the definition. Save the file with the
.xsdextension.
3
Add the XSD extension
- Log into Infor OS Portal and select the ION tab.
- On the left side, expand the Data Catalog menu and select Schema Extensions.
- Select the Schema Files tab and click the Import button to import the schema file item_ext.xsd.
4
Link the XSD extension to the UserArea tag of the standard BOD
- Now, select the Extensions tab and click the (+) icon. Fill in the details as shown below:
- Noun: ItemMaster
- XML Path: ItemMaster/ItemMasterHeader/UserArea
- Schema: Select the uploaded XSD file, item_ext.xsd
- Click OK.
5
Verify the BOD structure
- Go back into the ItemMaster standard BOD.
- Expand the Data Catalog menu and select Object Schema, filter on ItemMaster, and click Search.
- Select the ItemMaster BOD and open it.
- On the Formatted View tab, expand the schema definition for "ItemMaster/ItemMasterHeader/UserArea". You will now see the new XML structure ITEM_EXT below the UserArea TAG as per the XPath defined.
6
How to use the XSD extension in the graphical mapper
- From the ION Connect menu, select Mappings and then click the (+) Add new Graphical Mapping option.
- Supply a Name and Description.
- For the Source option, select the Sync.ItemMaster BOD. You can choose any Verb as the UserArea extension is related to the Noun of the BOD.
- In the Target option, select any other BOD that you like.
- Expand the definition of the UserArea Tag of the ItemMaster BOD and you can find the new XSD structure that you can map to the Target BOD.
Was this section helpful?
On this page
- XSD Extension for UserArea