Générer un fichier d'import de données basé sur des fichiers (FBDI)

La première étape consiste à générer un fichier d'import de données basé sur un fichier (FBDI) pour utilisation par Oracle Enterprise Resource Planning Cloud.

La plupart des intégrations en masse à ERP utilisent des fichiers FBDI. Un fichier FBDI est un fichier de données plat avec un contenu semblable au suivant :

NEW,1,2018/03/01,Balance Transfer,Remote Transfer,USD,2018/03/01,A,01,000,1212,0000,000,,,,,,,,,,,,,,,,,,,,,,,,,,99.00,,,,Team A Team Batch5,,,Orange Journal5,,,,,,,,,,,,,,,,,,,,,123,,,,,,,,,,,,,,,,,,,,,,,,,,END
NEW,1,2018/03/01,Balance Transfer,Remote Transfer,USD,2018/03/01,A,01,000,4111,0000,000,,,,,,,,,,,,,,,,,,,,,,,,, ,99.00,,,,Team A Team Batch5,,,Orange Journal5,,,,,,,,,,,,,,,,,,,,,123,,,,,,,,,,,,,,,,,,,,,,,,,,END

Le fichier de données de l'application source ne peut pas toujours être au format FBDI. Dans ce cas, le format de données de l'application source doit être converti au format FBDI. Cela peut être facilement obtenu à l'aide de la fonctionnalité XSLT (Oracle Integration Mapper) pour transformer le format source au format de destination. Toutefois, dans certains cas, il se peut que le fichier source généré soit trop volumineux (par exemple, 500 Mo).

La lecture d'un fichier volumineux en mémoire n'est pas une approche efficace, car il est possible de manquer de mémoire. Oracle Integration est une offre PaaS, il existe des vérifications de la taille des fichiers pouvant être lus avec l'adaptateur FTP. Oracle Integration limite le plus grand fichier pouvant être lu en mémoire à l'aide de l'adaptateur FTP à un maximum de 1 Mo. Toutefois, Oracle Integration peut lire le fichier source volumineux dans une série de tranches de mémoire. Cette fonctionnalité est appelée Lecture intermédiaire. La lecture par étapes est une fonctionnalité de réduction des cartes dans Oracle Integration. Avant d'utiliser l'option Lecture par étapes dans le flux Oracle Integration, vous devez télécharger le fichier en local dans Oracle Integration, où Oracle Integration peut lire le fichier en segments, car la lecture de tranches de mémoire à partir d'un serveur FTP est en cours et la bande passante est consommatrice de ressources.

Utiliser un modèle d'orchestration d'import de données basé sur des fichiers (FBDI)

L'exemple suivant illustre un modèle d'orchestration Oracle Integration permettant de convertir des fichiers dans un fichier ZIP source au format FBDI.

Le flux logique à convertir du format source au format FBDI suit :

1. Lire le fichier de déclenchement.
2. Téléchargez le fichier de données source.
3. Mettez les données en lecture et transformez-les au format FBDI. La boucle externe garantit que plusieurs fichiers de données sont traités.
4. Créez un fichier de liste.
5. Générez des fichiers de propriétés et écrivez le fichier ZIP.
6. Archive le fichier source.
7. Archive le fichier de déclenchement.

Par exemple :

Description de l'illustration journal-entry-1. png

Lire le fichier de déclenchement

La lecture du fichier de déclenchement est une intégration Oracle Integration programmée.

Le fichier de déclenchement est accessible en fonction d'une programmation configurée. La première étape consiste à lire le fichier de déclenchement que vous placez sur un serveur FTP. Le fichier déclencheur est un fichier de zéro octet portant le même nom que le fichier de données source. Le fichier de déclenchement fournit le nom du fichier de données source que les activités en aval dans ce flux Oracle Integration doivent lire. Un fichier de déclenchement est utilisé pour vous assurer que l'application source a totalement écrit le fichier de données avant qu'Oracle Integration tente d'accéder au fichier de données à lire. L'adaptateur FTP dans Oracle Integration prend en charge la propriété d'âge minimal, mais l'application source peut parfois essayer d'ajouter des données à un fichier s'il y en a plusieurs. L'ancienneté minimale n'étant pas disponible pour ces scénarios, un fichier de déclenchement est utilisé à la place.

1. Démarrez le téléchargement de votre fichier de données vers le serveur FTP.
2. Attendez que le fichier de données soit complètement écrit.
3. Ecrivez un fichier de déclenchement au même emplacement sur le serveur FTP.
   Lorsque le flux Oracle Integration programmé voit le fichier déclencheur sur le serveur, il lance le téléchargement du fichier de données portant le même nom.

Télécharger le fichier de données source

L'étape suivante consiste à télécharger le fichier de données source dans Oracle Integration.

Le flux Oracle Integration a été écrit avec l'exigence selon laquelle le fichier de données source est un fichier compressé (fichier .zip) contenant au moins un fichier de format de données source.

1. Dans l'assistant Configuration d'adresse Oracle Adapter, configurez les paramètres d'opération pour l'adresse FTP cible, entrez vos informations de base, puis cliquez sur Suivant pour accéder à l'étape Opérations.
2. Pour l'opération de sélection, sélectionnez Télécharger vers ICS.
3. Pour le chemin du répertoire de téléchargement, entrez /fbdi/
   Le chemin se trouve sur le serveur Oracle Integration auquel vous ne pouvez pas accéder. Oracle Integration créera ce dossier au besoin, puis nettoiera le dossier une fois qu'il aura été effectué.
4. Cochez la case Décompresser le fichier. Cliquez sur Suivant et suivez les étapes restantes de l'assistant.

Lecture de segment et transformation du fichier de données

A cette étape, le segment lit et transforme le fichier de données.

Cette étape consiste à utiliser la fonction Lecture de phase dans Oracle Integration pour lire les données dans un segment. Chaque segment est transformé du format source au format FBDI, puis un fichier FBDI de sortie est écrit. L'élément for-loop externe affiché dans le diagramme garantit que s'il existe plusieurs fichiers dans le cadre du fichier ZIP source, chacun est lu et transformé en fichier au format FBDI-formatted distinct.

Générer le fichier de liste

A cette étape, générez un fichier de liste.

Le fichier de liste est nécessaire pour Oracle Integration afin de déterminer le nombre de fichiers FBDI créés.

Créer les fichiers de propriétés et ZIP

A cette étape, générez un fichier de propriétés et écrivez le fichier ZIP.

Oracle Integration utilise l'adaptateur ERP pour télécharger des fichiers FBDI vers Oracle Enterprise Resource Planning Cloud. Bien que l'adaptateur ERP utilise les services Web fournis par Oracle Enterprise Resource Planning Cloud en interne, il brouille de nombreuses complexités impliquées dans les services Web bruts. L'adaptateur ERP s'attend à ce qu'un fichier ZIP contienne des fichiers FBDI et de propriétés à télécharger vers Oracle Enterprise Resource Planning Cloud. Le fichier de propriétés est un fichier manifeste qui contiendra des informations sur Jobname et la liste des paramètres nécessaires à l'adaptateur ERP pour télécharger le fichier FBDI dans Oracle Enterprise Resource Planning Cloud.

Archiver les fichiers source et de déclencheur

Au cours des deux dernières étapes, vous archivez les fichiers source et de déclenchement.

Les fichiers source et de déclenchement sont archivés pour référence ultérieure à un emplacement FTP. Par exemple, vous pouvez utiliser ces fichiers à des fins de resoumission, si nécessaire.