Configure a Composite entity

Composite entities in the Outbridge solution are regular data entities that are composed of multiple related data entities. They are used to represent business objects composed of a header and one or more dependent data sets, thereby enabling consistent and complete data exchange between systems.

Step 1: Creating a composite entity

1. In the Finance and Operations, expand the Modules and select Outbridge.
2. From the displayed menu, select Composite entities.
3. In the displayed dialog, select New.
4. In the Composite entity ID, specify the name for a new entity.
5. Under the Data entities section, select New.
6. From the displayed list of entities, choose the necessary one that will be a parent entity.
7. Add one more entity from the list to be a child entity.

Step 2: Setting a relation between entities

1. On the Composite entity form, under the Relation section, select New.
2. From the Field name next to the parent entity, choose the appropriate field as a connection between the entities.
3. From the Field name next to the child entity, choose the same field as for the parent entity.
4. Select Save.
5. Select Publish.

Step 3: Configuring a DMF project

1. In the Finance and Operations, expand the Modules and select Outbridge.
2. From the displayed menu, select Definition groups > Export.
3. In the displayed dialog, select New.
4. Provide the name and description for the project.
5. Under the Selected entities, select Add entity.
6. From the list of entities, choose a composite entity that you have created earlier.
7. From the Target data format, choose XML-Attribute and select Add.
8. Select Save.

For more details about DMF projects, see Create a data project by using the Data management Wizard

The example below describes the usage of a composite entity in a sales order scenario for data export. The sales order header is represented by a single data entity, while sales lines are represented by a separate data entity logically linked to the header.

Step 1: Configuring a sales order

1. In the Finance and Operations, expand the Modules and select Accounts receivable.
2. From the displayed menu, select Orders > All sales orders.
3. From the list of available orders, select the appropriate one.
4. On the Sell tab, select Maintain charges.
5. From the Charge code, choose the appropriate code.

Note: Only orders with the specified charge code will be exported.

6. In the Charge value, specify the appropriate number.
7. Select Save.

Step 2: Configuring a DMF project for export

1. Navigate to the Definition groups > Export.
2. Select the project you have created for your composite entity.
3. Under the Selected entities, select Filter.

Note: The set filter will define the sales order for export.

1. In the displayed dialog, in the Table, specify the name of the sales order connected to the composite entity.
2. In the Criteria, specify the number of the sales order.

Note: Ensure that the name and number of the sales order are specified correctly.

3. Select OK.

Step 3: Configuring a data port

1. In the Finance and Operations, expand the Modules and select Outbridge.
2. From the displayed menu, expand Data integration > Data ports and select Data ports.
3. Choose the existing port for data export or create a new one. For details, see Configure a Data port.
4. From the Data Project, choose the DMF project for your composite entity.
5. Select Save.
6. Select Data port > Run.
7. Select OK.