Contents

 
PPM Compendium
PPM Process Analysis Quick Start Guide
General
PPM demo database
Introduction to ARIS Process Performance Manager
Key terms
Process intelligence
Business process
Event-driven process chain (EPC)
Process instance
Process type
Measure
Dimension
Filter
Planned value
Query
Favorite
Start the PPM user interface
Analyze processes
Display favorites
Save analyses
Display analysis as a chart
Display measure values and legend in the chart
Display planned values
Set filter
Replace dimension
Set step width
Add dimension
Change analysis view
Display process instance distribution
Display process instances
Compare processes
Process variants
Variants bar
Use variants
Variants in scaled systems
General handling
Quick-start an analysis
Adapt user interface
Move views
Swap views
Adjust view size
Move bars
Combine bars
Show and hide bars
Adjust bar size
Change tab order
Restore bar positions
Quickly find entries in lists and tree structures
PPM Data Analytics
General
Introduction
Tables
Associations
Analysis realm
Configure Data analytics
Open the Data analytics view of a client
Create a data connection
Create an analysis realm
Configure an analysis realm
Add tables
Define keys
Link tables
Define partial data extraction
Configure Cross analytics
Add process tables
Import analysis realms
Overwrite analysis realm configuration
Reinitialize analysis realm in analysis server
Replace analysis realm configuration
Import data
Delete data
Delete table data
Appendix
Query logic
Query structure
Data filtering
Iteration
Aggregation
Combination of iteration and aggregation
Cross analytics
Restrictions and special cases
Missing links
Missing values
Loops
Self-reference
Values without assignment
Split text dimension data
Time dimensions with different accuracies
Directory and file structure
Configuration versioning
Data versioning
Import and export of configurations
Export mode
Import mode
-replace parameter
-overwrite parameter
Data import
Persistence
runtableimport.bat
Formats supported
Number ranges supported
Troubleshooting after data import was canceled
Save and restore data
Delete analysis realm and table data
Reinitialize analysis server
Reinitialize an individual analysis realm
Reinitialize entire analysis server
Automatically reinitialize analysis realm
XML configuration of analysis realms and data import
Document type definition (DTD)
Configuration elements
tables
associations
criterion-definitions
Example
Data sources
XML event format
Data format transformation
datasource.dtd extension
Example: The 'timestamp' transformation type
Standard deviation and percentiles
PPM Advanced Analysis
General
Report automations
Define and manage report automations
Export and import individual configurations
Export and import overall configuration
Export configuration
Import configuration
Run report automations
Call runppmreport
EPC templates
Configuration
Planned values
Authorization and visibility privileges
Planned value definitions
Planned value definitions for process instance-independent measures
Identification of the displayed planned value
PPM Operation Guide
General
IT service and application management
Early alert system in case of memory shortage
Memory monitoring
System messages
Configuration
Workload monitoring
Maintenance concept
System update
Data archiving
Restore
Backup and restore user data
High availability systems
Support desk management concept
Third-party software
Performance aspects
Dimension indices
Updating the indices
Dependency on the process tree
Administration
ARIS PPM Cloud Agent
Change the ARIS PPM Cloud Agent user credentials
System status
Configuration
Load balancer configuration
Change the registry addresses
System messages
Proxy configuration
PPM system messages
Overview
Log file directories
System messages (log output)
Audit messages (audit logging)
Command line programs
Handle personal data in log files
Log files of client-specific runnables
Log files of system-specific runnables
PPM system monitoring
Using ACC commands
Monitor runnable's health
Show node
Configure health monitoring
Monitor the memory usage
Stop the system monitoring
Globalization
Job automation
Accessibility
SSO integration
Configure parameters
SAML2 connection
Kerberos
Integrate MashZone NextGen in a SSO scenario
Security aspects
Safe communication channels
Load balancer
Integrate SSL certificate
Further security measures for load balancer
PPM server
Generate and sign an SSL keystore
Configure PPM for SSL
Security measures for the server system
SSL between PPM client downloader and PPM server
Session timeouts
Command line programs
General structure and function-specific structure
PPM command line programs
Common parameters
runinitdb
runppmanalytics
runppmanalytics parameters
runppmconfig
runppmconfig parameters
Export the system configuration
Import and export of user data
Import and export of favorites
runppmcpi
runppmcpi parameters
runppmimport
runppmimport parameters
Recalculation
runppmcompress
runppmcompress parameters
runppmdelete
runppmdelete parameters
runppmexport
runppmexport parameters
runppmadmin
runppmadmin parameters
runppmsendmail
runppmsendmail parameters
runtableimport
Frequently asked questions
System integration
Database connection
SAP-2-PPM Process Extractor
Using Content Packages
System administration
PPM command line programs: Log output
Inconsistent data pools
PPM System Architecture
General
Overview
The PPM client concept
System components
Infrastructure
ARIS PPM Cloud Agent
ARIS Cloud Controller
Apache Load Balancer
Apache ZooKeeper
Elasticsearch
Central user management (User management)
PPM components
PPM user interface
PPM client server
PPM Web
PPM Core
Customizing Tool Kit (CTK)
Database server (DBMS)
Basic information on in-memory technology
PPM network
Network protocols
Loading the PPM front-end
HTTPS protocol
Data communication between PPM front-end and PPM client server
Data communication between PPM server components
Data transfer operation modes
Compressed data transfer (default)
Direct RMI data transfer
Encrypted data transfer
Distributed PPM server systems
Access to a distributed system
Data import in distributed systems
Structure of a distributed system
Initializing a scaled system
Expanding a scaled system
Restrictions
Supported scenarios
Query types
Configure the PPM system
PPM configuration files
Structure
Global configuration files
Registry
SSL
Kerberos
Client-specific configuration files
AdapterConfig
AnalysisServer
AnalysisServer_Log
Chart
CNet (Communication Net)
Database
EPC
Adjustment of the EPC representation
Function-specific adjustments
EPC aggregator settings
EPC import
Help
Initdb
InitSystem
Kerberos
Keyindicator
Mail
RE (Relation Explorer)
RMI server
Report
Server
Server_Log
Sysmon
Templates
PPM Database Systems
General
PPM database schema
Measure and dimension names
Database tables
PPM and database interaction
PPM server access to the database
Connection to the database
Database user
Database objects
Handling of NULL values
Transactions
Data import
Import fragments
Create process instances and calculate measures
Data analysis
Tablespaces
Tablespace types
Tablespace configuration
Supported database systems
Oracle
JDBC driver
Create a database user
Export and import a PPM database
Tablespace configuration
Oracle 19
Oracle 18
Oracle 12c
Oracle 11g
IBM DB2
JDBC driver
DB2
Create a database user
Export and import a PPM database
Tablespace configuration
DB2
Microsoft SQL Server
Create a database user
Export and import a PPM database
Tablespace configuration
Create a database
JDBC driver
Unicode support
Migration
Performance tuning
Overall performance
Hardware-related
Configuration-related
Import performance
PPM Customizing Toolkit User Guide
General
Introduction to PPM Customizing Toolkit
User interface
Functions
PPM client
Getting started
Step 1: Create client
Set client properties
Step 2: Configure data source
Create data source
Set database access parameters
Step 3: Configure and manage client using programs
Step 4: Automatically create documentation for your client
Configure the client
Set client properties
Set configurations
Check client configuration
Check calculation rules
Check dependent calculation rule
How a calculation works
Appendix
Transfer client
Job automation
Create a job automation
Transport container
Client directory structure
Client templates
base
jdbc
sortmerge
natural_applications
organalysis
predecessormerge
process_mining_configurator
ppm4sd
ppm4mm
wm_process
Data management and configuration programs
Data archiving
Function flow diagram
Extend existing customizing with function follows relation
Process variants
Overview
Extend existing customizing with process variants
Adding variant feature by client migration
Affected modules and functionalities
Usage of variant attributes during import
Add process types (groups) to the process tree
Configure language-specific process names
ARIS process conformance check
Overview
Workflow
PPM Integration in ARIS
Extend the client configuration
PPM import
Characteristics of conformance calculation
The meaning of conformance
Conformance issues
Process hierarchies
Scaled systems
Process Mining configurator
Create a Process Mining client
Start the Process Mining configurator
Upload the process data
Process criteria mapping
Analysis criteria mapping
Configuration and data import
Restrictions
PPM Customizing
General
Overview
Configuration components
Command line programs
Methodological procedure
Configuration component hierarchy
Interface languages
User interface languages
Interface language for display of configuration elements
Using multi-byte character sets for configuration elements
Internal names
Attribute types and attribute type groups
Data types
Internal data types
User-defined data types
User-defined data types in multi-byte character sets
Definition of attribute types and attribute type groups
Definition of attribute types
Definition of attribute type groups
Configuration of attribute types and attribute type groups
Attribute type and attribute type group definition in multi-byte character sets
Process merge
Process hierarchies
Key rules
Process key rules
Hierarchy key rules
Shared fragment key rules
Merge key rules
Key-based merge
Merge based on sort order
Combining merge methods
Object key rules
Output behavior of messages
Configuration file
Process fragment merge
Merge mode "Replace"
Merge mode "Update"
Merge events
Parallel paths with multi-valued keys
Merge mode
Attribute copy rules
Anonymizing
Process typification
Create typification rules
Measure configuration
Process tree configuration
Prioritization
Definition of attribute calculations
Calculation classes
Log output for calculation classes
Time measures
Function measures
Process measures
Frequency measures
Function measures
Process measures
Process cost rates
More process measures
Environmentally relevant calculations
Relation measures
Process conformance
Conformance rate measure
Conformance issue relation
Convert time spans in milliseconds
Mark as large EPC
Operands
Set of values (XML element attribute)
Values (XML element filteredattribute)
Constants (XML element constant)
Determining attribute values
Attribute values without object reference
Attribute values with object reference
Conditional attribute type access
Operators
Mathematic operators
Operators resulting in a set of values
Operators producing a value
Logical operators
Conditional operator
String operators
Time operators
Conditional attribute type calculation
Nesting of operators
Calculation functions
Change the attribute type
Summary
Example attribute calculations
Special features of attribute calculation
AT_INTERNAL_NO_CUBE_ENTRY function attribute
Typification rules in CTK
Typification by attribute calculation
Definition of measures, dimensions, attribute calculations, and relations
Terminology
Measures
Process instance-dependent measures
Process instance-independent measures (PIKIs)
Dimensions
Definition of measures
Definition of standard measures
Formatting measure values
Definition of process cost measures
Measure definition in multi-byte character sets
Definition of cardinality measures
Definition of process instance-independent measures
Usage (type) of a data series
Dimension reference
Definition of process instance-independent measures in multi-byte character sets
Configuration import
Data series migration
Additional information: User-defined measures based on process instance-independent measures
Definition of measure groups
Visible measure groups
Group of invisible measures
Definition of dimensions
Definition of dimension groups
Text dimensions
General XML structure
One-level dimension
Two-level dimension
N-level dimension
Configuration
One-level dimensions
Two-level dimensions
N-level dimensions
Import dimension values
Floating point dimensions
Time dimensions
Time dimensions for the Early alert system
Special feature for calculation of critical time attributes
Time range dimensions
Time of day dimensions
Search dimensions
Variant dimension
Attribute configuration
Measure configuration - dimension type
Process tree configuration
Usage of variant attributes during import
Shared function dimension
Using organizational units as dimensions
Definition of data access dimensions
Using data access dimensions
Process tree definition
Registration of measures and dimensions at the PPM system
Register measure
Register relation measure
Register measures and dimensions of process instance-independent data series
Special case: Register referenced dimensions
Register dimension
Register reference dimension
Register relation dimension
Automatic process tree expansion
Manual process tree expansion
Definition of process tree in multi-byte character sets
Relations
Definition of relations
Reference dimensions
Definition of relation calculations
Definition of relation measures
Definition of relation and organizational dimensions
Change aggregation behavior
Configure the internal aggregation attribute
Assign aggregation values
System connections
SAP executables
Software requirements
Privileges in the SAP system
Transaction call
Configuration
Configuration examples
Explanations regarding the DTD
PPM Data Import
General
XML
What is XML?
Structure of an XML document
XML data import
Graph format
Object types
Connections
Relations (optional)
Guidelines for the graph structure
Attributes
XML example graph
System event format
Definition of process fragments
Definition of mapping
Definition of process fragment mapping
Definition of attribute mapping
Attribute transformations
Time stamp transformations
Floating point number transformation
Organizational units
Special case of attribute mapping
Create fragment definitions in ARIS
Modeling the overall process
Modeling the process fragment definitions
Format of system event file
Run the ARIS report
Generating the XML output file
Summary
Data formats
Special characters in XML documents
Generating the process instance fragments
Extending the attribute configuration
Specify the data type of unknown attributes
Extending the mapping configuration
Multi-valued system event attributes
Direct import of process attributes
Special case of scaled system
Archiving of XML import files
runxmlimport command line program
runxmlimport arguments
Import multiple data sources
Re-importing the same data
Graph format
System event format
Import of process instance-independent data
Process instance-independent measures
Data import formats
XML format
CSV format
XLS format
Data reimport
Export of values of process instance-independent data series
Deletion of values of process instance-independent data series
runpikidata command line program
Dimension values
XML format
CSV format
Default and replacement values
Data reimport
Delete dimension values
rundimdata command line program
Data analytics
How to handle large EPCs
Import large EPCs
Delete large EPCs
Appendix
Design of a Process Warehouse
Generate process fragments
Merge process fragments
Copying the process instance attributes
Making organizational units anonymous
Typify processes
Calculate measures
Checking planned values
Import scenarios
Parameter values
PPM Process Extractors
General
XML
What is XML?
Structure of an XML document
PPM and XML
Overview
Data extraction
Data import
PPM Process Extractor SAP-2-PPM
Architecture
R/3 system configuration
R3 table configuration (system event specification)
Global meta data
Sort system events
Add up values of a field
Extract multi-valued fields
Concatenate new attribute values from extracted attribute values
Link tables
Comparison of foreign key relations
Extraction using conditions
Condition operators
Complex conditions
Extract database fields
Example: XML configuration and output file
Table configuration
XML output file (PPM system event format)
Block extraction
Block extraction of large data volumes
Extract change documents
Create source system events from individual changes
Extract system events including changes
Extract the first change document of a table field
Extract the last change document of a table field
Extract the last change document from multiple table fields
Extract the first or last line in a sorting
Create attributes with inverted date
Multiplication of system events in tables
Extract fields of individual tables for Data analytics
Restrict data extraction
Extract tables with key/value columns
Command line program
Command line program arguments
General arguments
Source system-specific arguments
Output file-specific arguments
Continuous automated extraction
Extract multiple data sources
SAP Secure Network Communication
Prerequisites
XML configuration of SAP data sources
PPM Process Extractor JDBC-2-PPM
Architecture
JDBC system configuration
JDBC table configuration
Table access configuration
Global meta data
Sort system events
Concatenate new attribute values from extracted attribute values
Extraction using conditions
Condition operators
Complex conditions
Extract database fields
Handling of NULL values
Extract multi-valued fields
Table access configuration
Example: XML configuration and output file
Table configuration
XML output file (PPM system event format)
Block extraction
Extract the first or last line in a sorting
Extract the first or last row using a time stamp
Multiplication of system events in tables
Extract fields of individual tables for Data analytics
Restrict data extraction
Extract tables with key/value columns
Command line program
Command line program arguments
General arguments
Source database specific arguments
Output file-specific arguments
Continuous automated extraction
Extract multiple data sources
Extract data of BIT data type
Appendix
Supported data types
Special characters and capitalization
Special case: Schema and table name
PPM Process Extractor CSV-2-PPM
CSV
Architecture
CSV reader and CSV system event generator
Example 1: Complete header
Example 2: Header with missing column heading
Example 3: Header with several missing column headings
Example 4: No header
CSV configuration
CSV configuration extension
Command line program
Command line program arguments
General arguments
CSV-specific arguments
Output file-specific arguments
Extract multiple data sources
PPM Process Extractor Universal Messaging-2-PPM
Architecture
Universal Messaging system configuration
Conversion of Universal Messaging EDA events
Universal Messaging EDA events
Conversion into a PPM event
Header data
Payload
Conversion of namespaces into PSICs
Command line program
Command line program arguments
General arguments
Source system-specific arguments
Output file-specific arguments
Continuous automated extraction
Extract multiple data sources
Functionalities of all extractors
Attribute transformation
Operations
unmask
trim
concat
substring
if_then_else
set_with_default
integer_plus
integer_minus
string_equal
string_in
boolean_not
boolean_and
boolean_or
exists
get_null
getCurrentTimestamp
Example of attribute transformation
Data source
Configuration of multiple output files
Configuration of an offset extraction in terms of time or value
XML output file (formats)
PPM system event format
PIKIDATA format
DIMDATA format
Data pseudonymization
Scaled systems
Configuration of pseudonymized attributes
Dimensions of pseudonymized data
PPM pseudonymization tool
Adding new encrypted attributes
PPM Process Extractor SAP-2-PPM
General
Functioning and requirements
Requirements of SAP source systems
SAP transport request
Architecture
Data extraction
Connection parameters
SAP event specification
Extraction process
Requirements for R/3 source systems
R/3 access
R/3 function modules
R/3 user
R/3 table indices
Initializing a number range
Check installation using PPM Customizing Toolkit
PPM Content Package for SAP MM
General
Overview
Data extraction
Data import (Example: XML import in PPM system event format)
Installation
Install PPM Content Package for SAP MM
Install PPM clients
Create table indices
Data extraction and import
Data extraction
Data import
Individual adjustments
Appendix
Processes contained
Measures and dimensions contained
'PO amount in base unit' measure
Documentation
PPM Content Package for SAP SD
General
Overview
Data extraction
Data import (Example: XML import in PPM system event format)
Installation
Install PPM Content Package for SAP SD
Install PPM clients
Create table indices
Data extraction and import
Data extraction
Data import
Individual adjustments
Appendix
Data sources included
ACCOUNTING
BILLING
BILLING_ACCOUNTING_HIER
CLEARING
DELIVERY
DELIVERY_HEADER_CHANGES
DELIVERY_SHIPMENT_HIER
GOODS_RECEIPT_PO
MATERIAL_DOCUMENT
PICK_ORDER
PURCHASE_ORDER_DELIVERY
SALES
SALES_ITEM_HEADER_CHANGES
SALES_HEADER
SALES_ITEM_DELETED
SALES_ITEM_CHANGES
SHIPMENT
SHIPMENT_HEADER_CHANGES
WM_TRANSFER_ORDER
Processes contained
Measures and dimensions contained
Process measures
Function measures
Process dimensions
Function dimensions
"PO amount in base unit" measure
Documentation
PPM Installation Guide
General
Hardware and software requirements
Infrastructure components
Apache ZooKeeper
Load balancer
ARIS PPM Cloud Agent
ARIS Cloud Controller
Central user management
Notes on installation
ARIS Process Performance Manager
PPM Customizing Toolkit
PPM Process Extractor SAP-2-PPM
Installation on a Windows system
Start installation
Accept license terms
Select the installation scenario
Select installation directory
Specify external IP
Change ARIS PPM Cloud Agent user credentials
Specify port number
Select system configuration
Finish installation
Installation on a Linux system
Preparing to install PPM on a Linux system
Install ARIS PPM Cloud Agent
Install PPM Analysis GUI
Install a PPM Service Release
Install a PPM Fix
Procedure after installation
Install database drivers
Import license
Create client
Basic settings
Server settings
Language and e-mail settings
Database settings
Program integrations
Create demo database
Create settings files
Set server
Set database connection
Initialize demo database and import data
Import Data analytics demo data
Transfer client
Start PPM
Start infrastructure and PPM components
Start PPM user interface
Start PPM user interface via download client
Start parameters
Use users in PPM
Use user groups in PPM
Adapt date format to British English language area
Uninstall PPM
Uninstall PPM Analysis GUI
Uninstall PPM download client
PPM Migration
General
Version and directory references
Before migration
Back up the database system
Back up the user data
Back up the user management configuration
Clients based on the "wm_process" template (only versions before PPM 9.9)
Migrate MashZone NextGen custom widgets
Migrate the database system
Migrate the PPM installation
Migrate the user management
Migrate the customized SSO
Migrate customized cloud controller settings
Migrate Kerberos_settings.properties
Migrate PPM clients
Perform automated migration
Select clients
Create custom directory
Specify server settings
Specify language and e-mail settings
Specify database settings
Set up a MashZone NextGen connection
PPM variant feature
Complete the migration
The custom directory
Patch files
Configuration programs (batch files)
Report definitions
PPM database
Client settings
Migrate measures documentation
Job automation
Perform manual migration
Overview
Create client
Migrate client customizing
Transfer "custom" directory without changes
Migrate the "xml" directory
Migrate the "bat" directory
Migrate the "config" directory
Migrate the "patch" directory
Migrate the "automation" directory
Adapt settings in file <client>_CTK.xml
Migrate the "keyfiles" directory
Migrate client settings
Adapt parameters for server programs in the file _vmparam.bat
Convert PPM database
Converter test run
Start the converter
Migrate recovery files
Migrate report definitions
Migrate measures documentation
Job automation
Business data of the "ProcessStepInstanceChange" EDA event type
Procedure after conversion (PPM 10.5.1)
Conformance configuration
Enable process variants in process analysis
Enable standard deviation for Data analytics
ARIS Interface
General
Business process management
Procedure (taking ARIS Architect as an example)
Export from PPM
Import into ARIS Architect
EPC format in PPM
The EPC model type
Objects and connections
Aggregating process instances
Aggregation process
Identity criteria
Equality of functions
Equality of events
Equality of organizational units
Equality of connections
Equality of rules
Equality of attributes
Attribute calculation during the aggregation process
Configure the ARIS product interface
Object definition and attribute type mapping
Object type transformation
Object symbol transformation
Connection type transformation
Attribute type transformation
Transformation rules
Customize the ARIS product interface
PPM Cloud Infrastructure
General
PPM Infrastructure
Network infrastructure
Connection parameters
Cloud infrastructure
Overview
Public cloud
Network infrastructure
Connection Parameters
Private cloud
Network infrastructure
Connection Parameters
Local cloud
Network Infrastructure
Connection parameters
Installation
Installation requirements
Installation steps
Local installation
Remote installation
Distributed installation
Operations
Security settings
Reconfigure host and port parameters
Change host parameters
Change port parameters
Usage restrictions
PPM Widgets for MashZone NextGen
General
Install custom widgets
Update custom widgets
Insert custom widget in a dashboard
Function Flow widget
What is the Function Flow diagram?
Single functions in the function flow
Assign data sources
Assign data columns of a Process Mining context
Configure thresholds
Column matching
Settings
Specify the widget settings
Set selections and filters
Use the Function Flow diagram
How to display function data
Jump to PPM client widget
Insert text
Specify the widget settings
SAML Authentication
Process Variants widget
What is the Process Variants widget?
Specify the widget settings
Assign data sources to the Variant widget
Assign data columns of a PPM context
Column matching
Settings
Set selections and filters
Root Cause Miner widget
Start a root cause analysis
Analyze the Root Cause Miner results
Specify the widget settings
Appendix
What is the Process Mining context?
Automatic filtering
Multi-lingual dashboards
PPM Process Conformance Checking with ARIS
General
Process conformance
Conformance rate
Conformance issues
Process conformance analysis
How to perform a process conformance analysis
Prepare the process data in ARIS Architect
Import measured functions and create mapping
Refine mapping
Transfer flat process model and mapping
How are BPMN models handled?
Analyze your processes conformance in PPM
Analyze the conformance rate
Analyze the conformance issue
Create dashboards in ARIS Aware
Example
Appendix
Configure the process conformance check
Extend the PPM client configuration
Import the transport container
Adapt the PPM client customizing
Activate the conformance measures and dimensions
Calculate conformance level and root causes
Conformance check in process hierarchies
Conformance check in scaled systems
ARIS report descriptions
Report: Select PPM process type and create function mapping
Report: Transfer process model and mapping information to PPM
Specify report parameters for function import and function mapping
Specify report parameters for the transfer of process model and function mapping
Conformance check for Process Mining analyses
Conformance check widget
Assign data columns to Conformance check widget
Column matching
Settings
Text conventions
Legal information
Documentation scope
Data protection
Legal notices
Index