About configuring the import in replace mode

Overview

By default the Enabler import is made in copy mode. If you want to import your objects in replace mode, you must configure it in the composer.properties file.

The import update rules are based on the dependency relations that exist between AccountingIntegrator Enablerobjects. If an object property is set to replace, all objects that are used by this object are also replaced during import even if the corresponding properties are set to copy in the composer.properties file.

For example, if you decide to replace a given Transformation Rule, objects such as Variables, Tables and Business-Documents are also replaced even if the corresponding properties are set to copy in the composer.properties file.

Dependencies:

Object Use Are used by
Business-Documents
  • Business-Fields
  • Transformation-Rules
  • Enrichment-Rules
  • Aggregation-Rules
  • Audit-Rules
  • Balancing-Rules
  • Mapping-Templates
  • Input-Events
  • Processing-Context-Ins
  • Processing-Context-Outs
Business-Fields
  • None
  • Business-Documents
  • Transformation-Rules
  • Enrichment-Rules
  • Aggregation-Rules
  • Audit-Rules
  • Balancing-Rules
  • Mapping-Templates
  • Input-Events
  • Processing-Context-Ins
  • Processing-Context-Outs
  • Tables
Tables
  • Business-Fields
  • Transformation-Rules
  • Enrichment-Rules
  • Input-Events
Variables
  • None
  • Transformation-Rules
  • Enrichment-Rules
  • Input-Events
Financial-Procedures
  • None
  • Financial-Events
  • Input-Events
Financial Events
  • Financial-Procedures
  • Input-Events
Transformation Rules
  • Processing-Context-Outs
  • Tables
  • Variables
  • Business-Documents
  • Mapping-Templates
  • Financial-Tags
  • Input-Events
Enrichment Rules
  • Business-Documents
  • Mapping-Templates
  • Variables
  • Tables
  • Input-Events
Aggregation Rule
  • Business-Documents
  • Input-Events
  • Processing-Context-Out
  • Transformation-Rule
Audit-Rules
  • Business-Documents
  • Input-Events
  • Processing-Context-Outs
  • Transformation-Rule
Balancing-Rules
  • Business-Documents
  • Financial-Tags
  • Processing-Context-Outs
  • Transformation-Rules
  • Input Event
Financial-Tags
  • None
  •  
  • Aggregation-Rules
  • Balancing-Rules
  • Transformation-Rules
  • Input-Events
Mapping-Templates
  • Variables
  • Business-Documents
  • Tables
  •  
  • Enrichment-Rules
  • Transformation-Rules
  • Input-Events
Input-Events
  • None
  • None
Transformation-Domains
  • None
  • Input-Events
Processing-Context-Ins
  • Business-Documents
  • Input-Events
Processing-Context-Outs
  • Business-Documents
  • Aggregation-Rules
  • Audit-Rules
  • Balancing-Rules
  • Processing-Context-Ins
  • Transformation-Rules
  • Input-Events

Defining the properties

To implement the import in replace mode, you can set in the composer.properties file:

  • Either the XRDJ.ReplaceAllObjectsproperty to "true" to replace all objects.
  • Or the replace option for each type of AccountingIntegrator Enablerobject in the corresponding properties (set by default to copy).
  • Properties:
    • XRDJ.Business-Document
    • XRDJ.Business-Field:
    • XRDJ.Table
    • XRDJ.Variable
    • XRDJ.Financial-Procedure
    • XRDJ.Financial-Event
    • XRDJ.Transformation-Rule
    • XRDJ.Enrichment-Rule
    • XRDJ.Aggregation-Rule
    • XRDJ.Audit-Rule
    • XRDJ.Balancing-Rule
    • XRDJ.Financial-Tag
    • XRDJ.Mapping-Template
    • XRDJ.Input-Event
    • XRDJ.Transformation-Domain
    • XRDJ.Processing-Context-In
    • XRDJ.Processing-Context-Out

Prerequisite: Objects from the repository are replaced only if they are in CHECKED or TO_BE_CHECKED status.

You can also request a backup copy of the replaced objects in the repository by setting the XRDJ.import.backup property to true.

Example of a simple case

Repository

The repository contains:

  • An Enrichment Rule A that uses Business-Document B.
  • A Business-Document B.
  • An Aggregation Rule C that uses Business-Document B.

Import file

The import XML file contains an Enrichment Rule named A that uses a Business-Document named B. Both objects have been modified and differ from the objects in the repository.

Composer properties

The composer.properties file contains:

XRDJ.Business-Document=copy

...............

XRDJ.Enrichment-Rule=replace

XRDJ.Aggregation-Rule=copy

..............

Import operation

After import in replace mode:

  • The Enrichment Rule A in the repository is replaced by the Enrichment Rule from the import file.
  • The Business-Document B in the repository is replaced by the Business-Document B from the import file. As the Enrichment Rule A uses Business-Document B, the Business-Documents objects are replaced although the corresponding property was set to copy.
  • The integrity of the Aggregation-Rule C is not guaranteed since Business-Document B has changed.

Example of a more complex case

Repository

The repository contains the following objects.

Object Uses... Refers to...
Transformation Rule - TR1 BDIN, VAR, BDO1, BDO2 PCO, BAL
Transformation Rule - TR2 BDO2  
Enrichment Rule - ER1 BDIN  
Input Business Document - BDIN TR1, ER1, IE  
Input/Output Business Document - BDO1 TR1  
Input/Output Business Document - BDO2 TR1, TR2, BAL, BF  
Input/Output Business Document - BDO3    
Variable - VAR TR1  
Processing-Context-Out - PCO   TR1, BAL
Balancing Rule - BAL BDO2 PCO
Business Field - BF BDO1, BDO2  
Input-Event - IE BDIN TR1, ER1

Import file

The import file contains the following objects.

Object Uses Modified
Transformation Rule - TR1 BD03, TABLE Yes
Input Business Document - BDIN - Yes
Input/Output Business Document - BDO2 - Yes
Input/Output Business Document - BDO3 - No
Variable - VAR - No
Business Field - BF - No
Table - TABLE - New

Composer properties

The composer.properties file contains:

XRDJ.Input-Event = copy

XRDJ.Enrichment Rule = copy

XRDJ.Balancing Rule = copy

XRDJ.Transformation Rule = replace

XRDJ.Input Output Business Document = replace

XRDJ.Input Business Document = replace

XRDJ.Variable = replace

XRDJ.Processing Context Out = copy

XRDJ.Business Field = replace

XRDJ.Table = replace

….

XRDJ.import.backup =true

Import operation

After import in replace mode:

Object Action Impact
Transformation Rule - TR1

Replaced

  • Will not refer to PCO
  • Will use BDO3 instead of BDO1
  • Will use TABLE that has been imported
Input Business Document - BDIN Replaced
  • Will impact the integrity of ER and IE
Input/Output Business Document - BDO2 Replaced
  • Will the integrity of BAL and TR2
Input/Output Business Document - BDO3 Not imported  
Variable - VAR Not imported  
Business Field - BF Not imported  
Table - TABLE Created  

As the backup option in the composer.properties was set to true, backup objects for TR1, BDIN and BD02 have been created.

The integrity of the following objects in the repository will not be guaranteed:

  • Transformation Rule TR2
  • Balancing Rule BAL
  • Enrichment Rule ER
  • Input Event IE

Related Links