XML import files are imported using the runxmlimport command line program. During an import, process instance fragments are imported into the PPM system’s internal buffer and initially not processed further.
Warning
Make sure that the PPM server has been started before the XML import. Only one command line program can be active.
If an error occurs during the import operation, an error message appears on the console and the return value of the program is not equal to 0.
Calling up the program without parameters or with -h or -? outputs the online help on the console. The help describes all available options:
Import process instances in XML format
runxmlimport -user <user name> -password <password> [-client <name>]
[-datasource <file>]
[-datasourcelist <file>]
[-i <file1>[,<file2>...]]
[-f <fragment file> -m <mapping file>]
[-extractattributes <attribute file>] [-autoextendattributes]
[-extractmergeattributes <mergeattribute file>]
[protocoloptions] [-language <ISO code>] [-version]
-user <user name> |
Name of the user |
-password <password> |
User password |
-client <name> |
Name of the client. If no client is specified, the import process for the default client is run. |
-version |
Version number |
-datasource <file> |
Data source to be used for the XML import. |
-datasourcelist <file> |
List of data sources to be used for the XML import. |
-i <file1> [,<file2>...] |
Import files. ZIP files are supported. |
If the import is run in event format, -f and -m must be specified if no data source or data source list have been specified.
[-f <fragment file>] |
Fragment file |
[-m <mapping file>] |
Mapping file |
[-extractattributes <attribute file>] |
Generates an XML file with all attribute types that occur in the input file(s), but that have not been defined yet. |
[-autoextendattributes] |
Before XML import, all attribute types are imported that occur in the input file(s), but that have not been defined yet. |
[-extractmergeattributes <mergeattribute file>] |
Generates an extract of the merge configuration file with all new attributes that are to be retained as process attributes when merging fragment instances. |
The protocoloptions option can consist of the following instructions:
-protocolfile <file name> |
Logging to file <file name> |
-information {yes|no|default} |
Logging of information |
-warning {yes|no|default} |
Logging of warnings |
-error {yes|no|default} |
Logging of errors |
-language <ISO code> |
Log output language |