📘

注

Be careful with adding entities. Adding an entity needs adaptations throughout the SAP Connector. This may impact the structure of the out-of-box SAP Connector.

はじめに

If your actual process contains additional entities you can add these entities to the SAP Connector. Below is a global overview of the steps you need to take to add an entity. Depending on the entity you want to add you may need to perform additional steps.

Step 1: Define input

1. Check whether an extra input table is needed or additional data can be extracted from an existing input table.
2. If an extra input table is needed, add the table in the appropriate folder in the SAP Connector in the folder 1. Input.

Step 2: Add the new entity to the 2. Entities

1. Define the entity in the SAP Connector in the 2. Entities folder.
2. Add the table key of the entity in the TABKEY entity expression.
3. Optionally, add another table key when events are generated on a different level than the entity. For example, add the header of the entity in the TABKEY header expression.
   以下の画像で例をご確認ください。

4. Add relevant attributes, such as Client and (Reference) document number and Reference document item to create additional information about this entity which can be used.

Step 3: Add the new entity to the 3. Event log creation -> Document graph folder

1. If the entity is part of:

• one of the processes, then add the entity in one of the existing tables in the 3. Event log creation -> Document graph folder;
• a new subprocess, then create a new table and union this table with the applicable Document graph table.

2. Add the new TABKEY expression in the corresponding process table in the 3. Event log creation -> Document graph folder to which the entity is added. See illustration below for an example.

3. Add the new TABKEY expression to the Table keys of the Document graph table. See illustration below.

4. Set the availability of the attributes added in Step 2 Add the new entity to the 2. Entities to Hidden on the tables in the folder 3. Event log creation -> Document graph.

Step 4: Add a new group of events in Event log creation

1. Add a <entity>_create_events table and, if applicable a <entity>_header_change _events table and an <entity>_item_change_eventstable for the new entity in a new subfolder in the 3. Event log creation -> Events folder.
2. Add the mandatory attributes Activity and Event end in each event table. Optionally, add event attributes in each event table.
3. Create the <entity>_events table in the subfolder created in step 1. to join all the separate events to create a complete event log.

4. Add the complete sub event log created above to the join expression of the Events_preprocessing table in the folder 5. Preprocessing. See illustration below.