Show TOC

Background documentationExport and Import of XML Data Locate this document in the navigation structure

 

You can convert BRFplus objects into an XML representation. This is helpful if you want to transfer objects between systems that are not located in the same system landscape, or if there is no transport connection provided by the SAP transport system.

Prerequisites

You are running the BRFplus workbench in Expert Mode.

Features

Export

The XML export function works in an object-based manner, that is, you start by selecting a BRFplus object that you want to export. However, it is possible to extend the scope of an XML export in the following ways:

  • Include Referenced Objects: With this option set, the selected object is exported together with all objects that are directly referenced by the leading object.

  • Include Surrounding Application: With this option set, the selected object is exported together with the BRFplus application to which the object belongs.

In addition to the scope selection as described above, you can further fine-tune the export by choosing a particular XML version and an XML schema for the export. Depending on the selection you make, the system adapts the format and syntax of the exported data. This is helpful in situations where you have to transport BRFplus objects to a system with a lower release than the source system.

Note Note

To find out which is the highest XML version supported by the target system, start the import function in the target system. The highest version supported is displayed on the screen.

End of the note.
Import

The XML import function is the complementary to the export function. It is used to reimport XML data that have previously been exported from BRFplus into a different system.

Prior to actually importing data, we recommend to first start the import as a Test Run. The system then checks the import data to be uploaded for inconsistencies and other possible problems, without actually writing any data into the target system. You can use the check results for cleaning up and correcting the import data before you start the actual data import.

If the target system into which you want to import the data is not located at the end of the transport chain in your system landscape, the imported data has to be transported to the subsequent systems. To accomplish this, you have to enter the ID of a suitable transport request that you have previously created in the import target system.

Handling of Import Conflicts

If the system detects an object in the import data with the same ID as an already existing object in the target system, the further processing depends on the versioning setting of that object:

  • Versioning is active

    The object contained in the import data is imported as a new version of the object in the target system.

  • Versioning is not active

    The object contained in the import data overwrites the existing object in the target system without further notice. There is no way for a user to influence this behavior.

Activities

Export

To export a BRFplus object from the current system, proceed as follows:

  1. Choose   Tools   XML Export  .

    The system displays the XML Export screen.

  2. Click Select an Object to choose from all BRFplus objects that are available in the current system the one that you want to export.

  3. Choose Include Referenced Objects if you want to include all objects in the export that are referenced by the selected object.

  4. Choose Include Surrounding Application if you want to include the application object in the export to which the selected object belongs.

  5. From the XML Version dropdown list, choose the highest version number that is supported by the target system.

  6. From the XML Schema dropdown list, choose the XML schema that fits your needs best.

  7. Click Generate XML File to start the XML conversion process.

    Note Note

    The Generate XML File is visible only after you have selected an object for export.

    End of the note.
  8. Click Download XML File to define a folder in the file system where the system shall store the XML file generated in the previous step.

Import

To import a file containing BRFplus object data into the current system, proceed as follows:

  1. Choose   Tools   XML Import  .

    The system displays the XML Import screen.

  2. Make sure the XML version of the data to be imported is less than or equal to the Highest XML Version Supported as outlined on the XML Import screen.

  3. Enter the name of the XML File to be imported. You can also select the file by clicking the Browse button and navigating through the file system.

  4. Decide whether the data to be imported shall be written to a transport request:

    • For BRFplus objects that are used only local in the target system, no transport is needed. The same applies if there are no subsequent systems in your system landscape receiving transports from the import target system.

    • For BRFplus objects defined as customizing objects, enter a Customizing Transport Request ID. This is necessary for customer-defined objects.

    • For BRFplus objects defined as system objects, enter a Workbench Transport Request ID. This is necessary for objects delivered by SAP.

  5. Decide whether you want to execute the XML import as Test Run or not.

    The Test Run mode is a simulation mode where the system performs all import steps except for actually writing data into the target system. You can use this mode for checking if the import data is consistent and complete before making physical changes to the target system.

  6. Click Upload File to start either the test run or the XML data import.

More Information

Storage Types

Versioning