Référence d'Up ! Electronic Data Interchange

Un échange est défini par un format adossé à un flux et un sens. Le sens correspond au sens d'ouverture du flux.

Up ! Electronic Data Interchange est complété par les pilotes suivants selon le format d'échange utilisé :

Un échange est modélisé par l'interface IEchange. Les API d'Up ! Electronic Data Interchange permettent d'effectuer des échanges indépendemment du format choisi, du transport choisi - le flux - et de la plate-forme.

Outre les formats classiques cités précédemment, un échange de données peut être dans deux formats :

• Format binaire.
  Il a pour extension uei. Par exemple, l'échange de données de nom mon-echange aura pour nom de fichier mon-echange.uei.
  L'avantage du format binaire est qu'il est plus rapide à charger et à enregistrer, sans nécessiter les extensions d'Up ! 5GL Parser et d'Up ! 5GL Generator pour Up ! Electronic Data Interchange. L'inconvénient est que :
  • Il n'est pas modifiable manuellement.
  • Il ne peut comporter du code en Up ! 5GL mixé.
• Format texte en Up ! 5GL.
  Il a pour extension upl. Par exemple, l'échange de données de nom mon-echange aura pour nom de fichier mon-echange.upl. L'avantage du format texte en Up ! 5GL est que :
  • Il est modifiable manuellement.
  • Il peut comporter du code en Up ! 5GL mixé.
  L'inconvénient est qu'il est plus lent à charger et à enregistrer, nécessitant les extensions d'Up ! 5GL Parser et d'Up ! 5GL Generator pour Up ! Electronic Data Interchange.
  Pour connaître la syntaxe de ce format, merci de se référer à la fiche Syntaxe d'Up ! 5GL pour Up ! Electronic Data Interchange.

Il est possible de passer du format binaire au format Up ! 5GL en changeant le mode d'enregistrement.

Les échanges de données sont usuellement conservés dans le répertoire ${UPS_HOME}/upsedi/resources/${UPS_LANGUAGE}. Le fichier conservant le contenu de l'échange de données porte le nom de celui-ci.

Une fois l'échange de données ouvert, Up ! Electronic Data Interchange le présente sous forme d'objets du type EchangeBinaire ou EchangeUps5GL selon le format.

Un échange peut s'effectuer au niveau de soit :

• Le modèle technique.
  En ce cas, le contenu du flux de données sera ou est exactement ce qui est exporté ou importé - Même types de données et même propriétés dans le même ordre.
  
• Le modèle métier.
  En ce cas, le contenu du flux de données ne sera pas ou n'est pas exactement ce qui est exporté ou importé - Différents type de données ou différentes propriétés dans un autre ordre. Cela s'effectue comme suit :
  
  • Up ! Enterprise Application Integration est chargé.
  • Les connecteurs déclarés par le paramètre UpsEai.ModuleConnecteur sont chargés.
  • Les règles d'expertise issues des connecteurs surchargeant les méthodes des interfaces IntegrationExportationUpsEdi et IntegrationImportationUpsEdi sont appliquées.

Au cours de l'échange de données, il est possible de :

• Exporter seulement une partie des enregistrements.
• Importer seulement une partie des enregistrements.
• Demander la validation métier de chaque enregistrement importé.
• Rejetter chaque enregistrement invalide dans un flux ad hoc.

Enfin, un échange de données peut être une source d'objets pour Up ! Query afin d'y effectuer des requêtes d'insertion, sélection, mise à jour ou suppression écrites en Up ! 5GL.

Pour connaître les paramètres d'Up ! Electronic Data Interchange, merci de se référer à la fiche Paramètres d'Up ! Electronic Data Interchange.

Pour avoir un exemple complet d'usage d'Up ! Electronic Data Interchange, merci de se référer à la fiche Format Up ! 5GL.

Chaque tâche peut réaliser simultanément plusiseurs échanges en exportation ou en importation. Cela signifie qu'il est possible de réaliser simplement une conversion de format en faisant une importation depuis un premier échange puis une exportation dans un second.

Enumérés

Interfaces

Types

Variables

Exceptions

EchangeInexistant
ExportationImpossible
ExportationNonOptimiseeRecurrente
ExportationOptimiseeImpossible

FichierEchangeInexistant

ImportationImpossible

NumeroObjetObligatoire

Adaptateurs