Importing XSD’s Schema With External References (step-by-step guide)

The goal ofthis guideis to provide adetailed step by step to importXSD´s schemawithexternal referencesby using SAP PItool“Import External Definitions…”

In my case I have worked with a customer who uses OASIS UBL 2.1 as standard to Exchange messages (https://www.oasis-open.org/).

First, customer provides me the XSD nested structure in a zipped file.

Procedure:

All the schemasmust be importedunder the samenamespace to keep the reference amongst them.

Select the menu Tools > Import External Definitions… (We use the massive import tool).

This initializes a wizard

Select the Software Component Version and the Namesapace.

Choose all the XSD files to import, in this step isimportant to selectthe option'ImportAllReferences', so it will automatically reference the XSD's.

Click ‘Continue’, the message ‘Generate proposals…’ appears.

Finally it show the list of files to import, in the column name ‘Source’you can see those who has reference to other XSD file.

Sometimes it is necessary to modify a file name since PI doesn´t accept some characters.

At last click 'Finish'.

E.g. UBLContractNoticemain schema has reference to:

UBLCommonAggregateComponents

UBLCommonBasicComponents

UBLCommonExtensionsComponents

if some references are still missing, we will see fields in red on the message as shown in below example.

I hope you find useful this guide.