Configurer l'import en mode <replace>

Vue générale

Par défaut, l'import Enabler se fait en mode <copy>. Si vous souhaitez importer vos objets en mode <replace>, vous devez le paramétrer dans le fichier composer.properties.

Les règles qui gouvernent les mises à jour lors de l'import se basent sur les relations de dépendance qui existent entre les objets AccountingIntegrator Enabler. Si un objet possède la propriété <replace>, tous les objets utilisés par cet objet vont aussi être remplacés lors de l'import même si leurs propriétés correspondantes sont égales à <copy> dans le fichier composer.properties.

Par exemple, si vous décidez de remplacer une Règle de Traduction donnée, les objets tels que Variables, Tables et <Business-Documents> seront aussi remplacés même si leurs propriétés correspondantes valent <copy> dans le fichier composer.properties.

Définir les propriétés

Pour organiser l'import en mode <replace>, vous pouvez, dans le fichier composer.properties :

  • définir à "true" la propriété XRDJ.ReplaceAllObjects pour remplacer tous les objets.
  • ou remplacer pour chaque type d'objet AccountingIntegrator Enabler la propriété correspondante (égale à <copy> par défaut).

Prérequis : les objets du référentiel sont remplacés uniquement s'ils ont le statut Contrôlé (<CHECKED>) ou A contrôler (<TO_BE_CHECKED>).

Vous pouvez également demander la création d'une copie de sauvegarde des objets remplacés dans le référentiel en définissant à "true" la propriété XRDJ.import.backup.

Exemple simplifié

Référentiel

Le référentiel contient :

  • Une Règle de Modification A qui utilise le <Business-Document> B.
  • Un <Business-Document> B
  • Une Règle d'Agrégation C qui utilise le <Business-Document> B.

Fichier d'import

Le fichier d'import XML contient une Règle de Modification appelée A qui utilise un <Business-Document> appelé B. Les 2 objets ont été modifiés et sont différents de ceux qui existent dans le référentiel.

Propriétés de Composer

Le fichier composer.properties contient :

XRDJ.Business-Document=copy

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

XRDJ.Enrichment-Rule=replace

XRDJ.Aggregation-Rule=copy

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

Opération d'import

Après import en mode <replace> :

  • La Règle de Modification A dans le référentiel est remplacée par la Règle de Modification issue du fichier d'import.
  • Le <Business-Document> B dans le référentiel est remplacé par le <Business-Document> B issu du fichier d'import. Puisque la Règle de Modification A utilise le <Business-Document> B, les objets de type <Business-Documents> sont remplacés bien que leur propriété valent <copy>.
  • L'intégrité de la Règle d'Agrégation C n'est pas garantie étant donné que le <Business-Document> B a changé.

Exemple plus complexe

Référentiel

Le référentiel contient les objets suivants.

Objet Utilise... Fait référence à...
Règle de Traduction - TR1 BDIN, VAR, BDO1, BDO2 PCO, BAL
Règle de Traduction - TR2 BDO2  
Règle de Modification - ER1 BDIN  
<input Business-Document> - BDIN TR1, ER1, IE  
<Input/Output Business Document> (type CRE/ME) - BDO1 TR1  
Input/Output Business Document - BDO2 TR1, TR2, BAL, BF  
Input/Output Business Document - BDO3    
Variable - VAR TR1  
Destinataire - PCO   TR1, BAL
Règle d'Équilibre - BAL BDO2 PCO
Champ - BF BDO1, BDO2  
Type de CRE - IE BDIN TR1, ER1

Fichier d'import

Le fichier d'import contient les objets suivants.

Objet Utilise... Modifié
Règle de Traduction - TR1 BD03, TABLE Oui
<input Business-Document> - BDIN - Oui
Input/Output Business Document - BDO2 - Oui
Input/Output Business Document - BDO3 - Non
Variable - VAR - Non
Champ - BF - Non
Table - TABLE - Nouveau

Propriétés de Composer

Le fichier composer.properties contient :

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

Opération d'import

Après import en mode <replace> :

Objet Action Impact
Règle de Traduction - TR1

Remplacé

  • Ne référencera pas PCO
  • Utilisera BDO3 au lieu de BDO1
  • Utilisera la TABLE importée
<input Business-Document> - BDIN Remplacé
  • Aura une influence sur l'intégrité de ER et IE
Input/Output Business Document - BDO2 Remplacé
  • Aura une influence sur l'intégrité de BAL et TR2
Input/Output Business Document - BDO3 Non importé  
Variable - VAR Non importé  
Champ - BF Non importé  
Table - TABLE Créé  

Puisque l'option de sauvegarde a été activée dans composer.properties, des sauvegardes ont été créés pour les objets TR1, BDIN et BD02.

L'intégrité des objets suivants du référentiel ne sera pas garantie :

  • Règle de Traduction - TR2
  • Règle d'Équilibre - BAL
  • Règle de Modification ER
  • Type de CRE - IE

Related Links