Function documentationProperty Tree Import

 

These functions enable you to:

  • Import a new property tree into the SAP system

  • Modify an existing property tree

In combination with the Property Tree Export function, you can compare and match up property trees between different SAP systems.

Features

When importing property trees, you can use the following functions:

File Check

The SAP system checks whether the data from the transfer file can be transferred correctly and determines all value assignment types to be changed and created in the SAP system.

A log is created for checking the file, with which you can determine any errors made.

For all selected value assignment types in the SAP system, you can display the differences between the property trees in the source and target systems. The following differences can occur:

  • The descriptions for the value assignment types are different.

  • Different classes are assigned to the value assignment type.

  • A class is defined in different ways.

  • The characteristics in a class are different.

  • The characteristics are defined in different ways.

  • The descriptions for the characteristics are different.

  • The phrase sets assigned to the characteristics are different.

  • The names for the phrase sets are different.

Control

All selected value assignment types are imported.

Caution Caution

You should ensure that:

  • No SAP classes are selected

  • None of the classes you created that contain SAP characteristics are selected

SAP characteristics and classes must not be transported using import or export. Otherwise, the original SAP characteristics and classes cannot be overwritten by an updated property tree during a release upgrade.

You are allowed to transport only the value assignment types you defined yourself.

End of the caution.

In addition, you can use parameters to determine which elements of the value assignment types are imported (for example, descriptions for value assignment types, classes, class descriptions, characteristics, and characteristic descriptions).

Note Note

If a new characteristic is created in the SAP system, all elements of the characteristic that are dependent on other selected elements (such as descriptions) are imported without being specifically selected.

End of the note.
Data Import

The data is transferred in the background using the direct-input procedure. The SAP system creates an import log for this purpose.

Situation in the Target System

Result

A property tree with the same key does not exist.

The property tree is created.

A property tree with the same key exists.

The SAP system matches up the structure:

The SAP system inserts new value assignment types at the appropriate points in the property tree.

Objects that already exist are not deleted as a result of the import.

New characteristics for a value assignment type are always appended at the end of the list of characteristics.

Example Example

The characteristics A and C are assigned to class K. On importing, the characteristics A, B, and C are imported for class K. The sequence of the characteristics is then: A, C, B.

End of the example.

Note Note

Truncated value lengths of characteristics cannot be transported using the import. If, for example, characteristic A already exists in the SAP system with the length CHAR 30, it is not possible to overwrite this characteristic with the length CHAR 1 by means of an import into the SAP system. In this case, an error message will be written in the log. Lengthening values is, however, permitted.

If you reconfigure your SAP system, you can generate phrase sets for all characteristics of data type CHAR 30 in the Customizing activity Generate Standard Phrase Sets in Customizing for Basic Data and Tools if the phrase sets are not part of the export file. In the Customizing activity Exclude Non-Phrase-Enabled Characteristics from Phrase Set Assignment, you can also specify characteristics for which phrase sets are not to be created.

End of the note.