The runppmimport argument

-merger anonymizing

All process instances in the PPM database that have not yet been anonymized are now anonymized.
Normally, only new process instance fragments added are anonymized when importing process instance fragments. Existing instances that are not processed by the merger are not anonymized.

It is not possible to change the anonymization of process instances already anonymized, as the information about the actual processor is overwritten when an instance is anonymized.

-typifier new

All process instances in the PPM database (new and those already typified) are retypified using the specified process type definition.

Retypifying process instances also requires the recalculation of the measures and dimensions, as they depend on the process type.

-keyindicator new

The measures and dimensions for all process instances are re-calculated. You should use this option if you have imported a new Measure calculator configuration (see also chapter Recalculation).

-reinitanalysisserver {yes|no|auto}

With -reinitanalysisserver yes you specify that the analysis server is to be reinitialized after a successful PPM import. If you use the auto argument, the analysis server is reinitialized only if required. With the default setting no (default) you prevent reinitializing completely. This option applies to process instance data, process instance-independent data, and Data analytics data.

If recovery files are recreated during the reinitialization of the analysis server (runppmimport –reinitanalysisserver [yes|auto] –recoveryfile yes), all recovery files will be generated.

The technical documentation PPM Data Analytics provides details on the reinitialization of Data analytics analysis realms of the analysis server.

-ps <paramset>

Specifies the XML file containing the paramset to limit the quantity of process instances for which one of the options -typifier new or -keyindicator new are to be used (see also chapter Recalculation). If necessary, specify the complete path for the file.

Even if you specify a paramset, error instance inclusion is controlled by the -errorinstances parameter and needs to be turned off explicitly, if required.

-genstats {before|after|keyindicator|merger|delete}

Updates or deletes the database statistics before the planned values are checked. before executes the function at the start, after at the end, merger before each call of the merger, and keyindicator before each measure calculation. You can use delete to delete the database statistics at the start of the PPM import. The parameter values can be combined. The generation of statistics as a standard database user is only supported by Oracle. For all other DB systems, the calculation of statistics is a task for administrators and must be executed by users with DB administrator rights.

-errorinstances {yes|no}

You use -errorinstances yes to specify that all error instance are to be recalculated as part of the PPM import. Default value: yes.

Example

In the analysis component, the Number of processes measure has been displayed over time with filters for the Material/MACH (machines) and Time (2nd quarter 2002) dimensions for the Cash sales process type in the Order processing process type group. The corresponding paramset was saved in the file paramset.xml.

<?xml version="1.0" encoding="ISO-8859-1"?>

<!DOCTYPE paramset SYSTEM "paramset.dtd">

<paramset>

<analysewizparam selectedrow="0"/>

<chartparam>

<chart-chartposition>0.16388889,0.20876624

</chart-chartposition>

<chart-legend-visible> false</chart-legend-visible>

<chart-zoom>75</chart-zoom>

<chart-scale>1.0,10.00.10.0</chart-scale>

<chart-colinfo/>

</chartparam>

<cpiparam/>

<epkparam/>

<favoritparam usecache="yes"/>

<kiquery usecache="yes" showzero="auto">

<keyindicator>

<criterion name="PNUM">Number of processes</criterion>

</keyindicator>

<iteration>

<criterion name="PROCESSTYPE">Process type</criterion>

<refinement name="BY_LEVEL2">Detailed</refinement>

</iteration>

<iteration>

<criterion name="TIME">Time</criterion>

<refinement name="BY_MONTH">By month</refinement>

</iteration>

<iteration>

<criterion name="MATERIAL">Material</criterion>

<refinement name="BY_LEVEL2">Detailed</refinement>

</iteration>

<filter>

<criterion name="PROCESSTYPE">Process type</criterion>

<filteritem operator="or">

<datalist usewildcard="no">

Order processing

<dataitem>

Order processing\cash sales

<datatype name="TEXTPAIR">Text pair</datatype>

<scale name="LEVEL1SCALE">Rough</scale>

</dataitem>

</datalist>

</filteritem>

</filter>

<filter>

<criterion name="TIME">Time</criterion>

<filteritem operator="or">

<datarange operator="range">

2. Quarter 02

<dataitem value="2ND QUARTER.2002">

2. Quarter 02

<datatype name="TIME">Time</datatype>

<scale name="QUARTERSCALE" factor="7776000.0">

Quarter(s)

</scale>

</dataitem>

<dataitem value="2ND QUARTER.2002">

2. Quarter 02

<datatype name="TIME">Time</datatype>

<scale name="QUARTERSCALE" factor="7776000.0">

Quarter(s)

</scale>

</dataitem>

</datarange>

</filteritem>

</filter>

<filter>

<criterion name="MATERIAL">Material</criterion>

<filteritem operator="or">

<datalist usewildcard="no">

Machines (MACH)

<dataitem>

MACH{Machines}

<datatype name="TEXTPAIR">Text pair</datatype>

<scale name="LEVEL2SCALE" factor="2.0">

Detailed

</scale>

</dataitem>

</datalist>

</filteritem>

</filter>

</kiquery>

<navparam>

<nav-view>chart</nav-view>

</navparam>

<tableparam view="listtable">

<tbl-cross totalresult="yes"/>

<tbl-instance split="horizontal"/>

</tableparam>

</paramset>

Executing the following command line only retypifies and calculates those process instances, which match the filter specifications in the above paramset:

runppmimport -user system -password manager -typifier new -ps paramset.xml

-recoveryfile {yes|no}

With -recoveryfile yes (default setting) you specify that the analysis server recovery files relevant for process analysis are to be created under <installation directory>\ppmmashzone\server\bin\work\data_ppm\recovery\<client> after a successful PPM import.