In this section we show how to create a new delivery agreement. Delivery agreements formalize the exchange of data, both incoming data as data that is exported.
{warning} A delivery agreement can only be created if an interface and a tenant already exists.
Delivery Agreements can be defined using the UI or you can use our API /acmDatadel/deliveryAgreement
to create, read, update and delete delivery agreement data. The configuration of Data Delivery Agreements is explained based on how to define Delivery Agreements with our UI.
Management > Delivery Agreement
New
Effective From
and Effective To
dates)With these options you can define settings that influence the validation process
include Existing Data For Skipped Rows In Set Validation
:
In a delivery, if basic constraints are violated and rows are rejected, i-refactory will by default try to fetch the known data of these rejected rows from previous deliveries. The default behavior can be changed for deliveries see i-refactory server release notes v.3.2.0 for more details
Default
: inherits the value from the interfaceYes
: i-refactory tries to fetch the known data of these rejected rows from previous deliveries. This data is then used to perform set validations on rows in the current delivery that did not get rejected.No
: If this flag is set to 'NO' the i-refactory will not fetch the data of skipped rows for set validation.include Existing Data For Skipped Rows In Set Validation Conclusion
shows the computed value for this Delivery Agreement.
The table below shows how includeExistingDataForSkippedRowsInSetValidationConclusion
is computed for a Delivery Agreement vis-a-vis the Interface.
Delivery Agreement value | Interface value | Delivery Agreement Conclusion |
---|---|---|
DEFAULT | YES | YES |
DEFAULT | NO | NO |
YES | NO | YES |
NO | YES | NO |
{note} This setting can also be found when creating an individual delivery, the setting there takes precedence over the delivery agreement.
maxConcurrentEntityUpdates
. The sum of entity updates used by this delivery shall not exceed this limit.defaultMaxConcurrentEntityUpdates
. Value used for a delivery if the delivery doesn't specify a maximum of entity updates.defaultReservedEntityUpdates
. The number of entity updates that should be reserved for this delivery agreement. If the delivery doesn't specify a reservation, this value is used.maxReservedEntityUpdates
. The sum of reservations made by deliveries for this delivery agreement cannot exceed the number speficied here.Save
button.Management > Delivery Agreement
New
Effective From
and Effective To
dates)Save
button.Management > Delivery Agreement
.New
. Effective From
and Effective To
dates).maxConcurrentEntityUpdates
. The sum of entity updates used by this delivery shall not exceed this limit.defaultMaxConcurrentEntityUpdates
. Value used for a delivery if the delivery doesn't specify a maximum of entity updates.defaultReservedEntityUpdates
. The number of entity updates that should be reserved for this delivery agreement. If the delivery doesn't specify a reservation, this value is used.maxReservedEntityUpdates
. The sum of reservations made by deliveries for this delivery agreement cannot exceed the number speficied here.Save
button.After these steps, you have successfully created a new delivery agreement. You can modify the delivery agreement by using the pencil icon.