Overview

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

<Property> 
  <NameValue name="ln.SalesIndicator" type="IndicatorType">true</NameValue> 
</Property>

Sometimes, you need to add a well-defined structure as extra information. In such cases, you can use an XSD Extension.

Title

📋 Requirements

Access to a CloudSuite.
User privileges to ION Desk.
Security roles: IONDeskAdmin

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 .xsd extension.

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.

Card Title

Add description here

Card Title

Add description here

Downloads

XSD_Schema

Sections

XSD Extension for UserArea