-version
The version of the PPM software and the database schema are output on the console. Other arguments are ignored.
-user <user name> -password <password>
Specify the user name and the password of the PPM user who is executing the import. The user must have the Data import function privilege.
-client <client name>
Specify the PPM client in whose database schema the imported process fragments are to be saved. If you do not enter anything here, the default client (Default) is used.
-i <Name of XML files>
Specify any number of files to be imported. The names are allowed to contain placeholders. ? is a placeholder for a single character, * for any number of characters. The file name must not begin with a minus sign.
Example: The argument -i <Path>\?ata*.xml reads all files in the <Path> directory with the extension <.xml that begin with any character followed by the string <ata and then any other string.
If the specified files are a ZIP archive, all XML files in the ZIP archive are read regardless of the folder structure of the archive.
-m <name of mapping file> -f <name of fragment file>
Specify the type of import. If you specify the -f and -m arguments, the PPM system event format is used automatically. If you do not specify these arguments, graph format is used.
-datasource <file name>
The XML elements data, fragments, and mapping indicated in the file specify the XML files to be used and replace the -i, -f, and -m command line parameters. The format of the XML file is described in the document type definition datasource.dtd. PPM Customizing Toolkit uses this file for configuration and to extract data sources.
The file is located under <installation directory>\ppmmashzone\server\bin\agentLocalRepo\.unpacked\ppm-client-run-prod-<version>-runnable.zip\ppm\dtd
The following examples illustrate the contents of a data source file for data import in graph and system event format:
Data source file datasource.xml for graph format
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE datasource SYSTEM "datasource.dtd">
<datasource name="Sales" type="GRAPH">
<description name="default_description"
language="de">Demo-Datenbankinhalt</description>
<description name="default_description"
language="en">Demo database content</description>
<data>C:\SoftwareAG\ppmmashzone\server\bin\work\data_ppm\custom\umg_en\data\umgsales_umg_en.zip</data>
<eventattributetypes />
</datasource>
Data source file datasource.xml for event format
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE datasource SYSTEM "datasource.dtd">
<datasource name="CustomerService" type="EVENT">
<description name="default_description"
language="de">Demo-Datenbankinhalt</description>
<description name="default_description"
language="en">Demo database content</description>
<data>C:\SoftwareAG\ppmmashzone\server\bin\work\data_ppm\custom\umg_en\data\CS\csdemodata.zip</data>
<fragments>C:\SoftwareAG\ppmmashzone\server\bin\work\data_ppm\custom\umg_en\xml\CS\CustomerService_Fragments.xml</fragments>
<mapping>C:\SoftwareAG\ppmmashzone\server\bin\work\data_ppm\custom\umg_en\xml\CS\CustomerService_Mapping.xml</mapping>
<eventattributetypes />
</datasource>
If you specify the parameter -datasource in the command line, the parameters -i, -f, and -m are not considered.
For more detailed information on configuring data sources, refer to the technical reference PPM Process Extractors.
-datasourcelist <file name>
With the -datasourcelist argument, you can import multiple data sources simultaneously, except for data sources of the GRAPH type. The import corresponds to multiple importing using the -datasource argument.
See chapter Import multiple data sources.
-autoextendattributes
If you specify this switch in the command line, new attributes will be identified and the attribute configuration in the PPM system extended accordingly. If you have enabled the automapping option in the data source configuration used, new attributes identified will be transferred to the specified objects in the fragment definition.
-extractattributes <File name>
Attributes contained in the XML import files that are not known in the PPM system are identified and written to the specified file. The file generated is DTD-compatible and can be imported using the runppmconfig command line program to extend the PPM attribute configuration. If you use the -extractattributes argument without the -autoexentattributes switch, no XML import data will be imported.
-extractmergeattributes <File name>
This argument writes attributes transferred to process instances using the automapping option to the specified file. No XML import files are imported.
Log options
These arguments can be used to limit the log output. Error messages resulting in program abortion will always be output in the console.