Aller au contenu principal

Extraction et traitement

L'écran Extraction et traitement exécute une extraction suivie d'un traitement en un seul clic. C'est équivalent à enchaîner l'une des pages Extract puis la page Processing correspondante, avec les mêmes paramètres regroupés sur un seul formulaire.

La partie extraction propose les trois sources documentées dans Extract :

  • Extraction d'archive — récupération d'un document archivé en base NomaUBL (XML source F564230 ou UBL généré F564231) par clé documentaire.
  • Extraction FTP — téléchargement d'un fichier depuis un serveur SFTP avec la clé rapport / version / langue / job.
  • Extraction BIP — extraction d'un job de la file d'impression BI Publisher JD Edwards (XML d'entrée, sortie générée ou les deux).

La partie traitement propose les deux pipelines documentés dans Processing :

  • Traitement de document — point d'entrée unique. Le pipeline (transformation XML ou validation UBL directe) est sélectionné par la propriété source du modèle de document. Remplace les anciennes pages Process XML et Process UBL.

La page fonctionne quel que soit le système source — JD Edwards, SAP, NetSuite ou ERP personnalisé — sauf pour la source BIP, qui est spécifique à JD Edwards.

Vue d'ensemble​

Extraction et traitementSourceArchiveFTPBIP (JDE)N° JOB42803LANGFREXTRACT MODEInput (XML) ▾Type de traitementXMLUBLMODÈLEinvoices ▾MODEAUTODépôt PAUse settings▶ Extraire + traiterRésultat de l'extraction✓ Job BIP 42803 extrait → dirInput/invoices/R42565_FBL00001_42803.xmlRésultat du traitementSEVERITY · MODULE · SUBMODULE · MESSAGESUCCESSXSL · transform · 1 document → UBL 2.1SUCCESSPA · submit · 200 Déposée · post-gen appliquée au BIP 42803Sélecteur de sourceArchive · FTP · BIPChamps par sourcese reconfigurentType de traitementenchaîne XML ou UBLBouton uniqueenchaîne les deux étapesDeux panneauxextraction → traitement

Vue d'ensemble du pipeline​

▶ Exécuter⚙ Sourcedécision📦 Extraction d'archiveF564230 / F564231🌐 Extraction FTPserveur SFTP🖨 Extraction BIPfile d'impression JDEArchiveFTPBIP📄 Fichier extraitdans dirInput/template/⚙ Extraction OK ?décision⛔ Arrêttraitement ignoréNon⚙ Type de traitementdécisionOui⚙ Process Document (XML)SINGLE / BURST / UBL / AUTO⚙ Process Document (UBL)Validate / Persist / SubmitXMLUBL⚙ Post-générationmise à jour statut JDE📋 Résultatbilan agrégé

L'enchaînement comporte deux étapes. L'extraction écrit un fichier dans dirInput/<template>/ ; en cas de succès, le pipeline de traitement correspondant le reprend. Tout échec à l'extraction interrompt l'enchaînement — l'étape de traitement est sautée et seul le Résultat d'extraction contient un message.

Source​

Le sélecteur Source en haut choisit l'un des trois canaux d'extraction. Le formulaire dessous s'adapte à la source choisie.

Archive​

Récupère un document archivé via sa clé documentaire en base.

ChampDescription
DOCNuméro de document — clé primaire de l'archive.
DCTCode du type de document (par ex. RI, RN).
KCOCode société (par ex. 00070).

Le fichier extrait est écrit dans dirInput/<template>/ (avec %TEMPLATE% résolu) sous le nom <DOC>_<DCT>_<KCO>.xml (ou _ubl.xml si la source est UBL). Voir Extraction d'archive pour la référence complète.

FTP​

Télécharge un fichier depuis le serveur SFTP configuré.

ChampDescription
ReportNom de rapport (par ex. R42565).
VersionVersion du rapport (par ex. XJDE0001).
LanguageCode langue (par ex. FR).
JobNuméro de job.

Le fichier extrait est écrit dans dirInput/<template>/<REPORT>_<VERSION>_<LANG>_<JOB>.xml. Voir Extraction FTP pour la référence complète.

BIP​

Extrait un job de la file d'impression BI Publisher JDE.

ChampDescription
Job NumberNuméro de job BIP JDE (RJJOBNBR).
LanguageFiltre optionnel sur la langue BIP.
Extract ModeExtract Input (XML), Extract Output ou Extract Both. Voir Extraction BIP pour la sémantique de chaque mode.

Le nom de base du fichier extrait (<report>_<version>_<job>) est réutilisé comme entrée du traitement.

Traitement​

Sous le sélecteur de source, Process Type choisit entre les deux pipelines.

Process Type = XML​

Équivalent à l'exécution de la page Traitement de document sur le fichier qui vient d'être extrait, quand le modèle choisi a source = XML.

ChampDescription
TemplateTemplate du document — obligatoire. Pilote le pipeline XSL et le jeu de règles de validation.
ModeAUTO, SINGLE, BURST ou UBL. Voir Traitement de document — Modes (source XML).
ReplaceSkip laisse intactes les factures existantes ; Overwrite les ré-importe.
Send to PAUse settings (défaut) ou Skip sending.

Quand la source est BIP, un appel Apply post-generation supplémentaire est fait après une exécution réussie — il met à jour le statut du job JDE, généralement pour le marquer comme traité.

Process Type = UBL​

Équivalent à l'exécution de la page Traitement de document sur le fichier qui vient d'être extrait, quand le modèle choisi a source = UBL. Le fichier extrait doit déjà être au format UBL — cas typiques :

  • la source Archive est positionnée sur la variante UBL ;
  • le système amont émet directement de l'UBL ;
  • la source BIP est positionnée sur Extract Output et le rapport JDE produit du XML UBL en sortie (et non du PDF). Les fichiers UBL extraits de F95631 sont alors repris directement par le pipeline UBL — aucune transformation XSL ne s'exécute.
ChampDescription
ModeProcess & Validate (pipeline complet) ou Validate only.
Replace ModeOverwrite existing (défaut) ou Skip.
Send to PAUse settings, Force send ou Skip sending.

La clé primaire (doc, dct, kco) est extraite du cbc:ID de la facture via la regex idPattern du modèle de document — les fichiers peuvent avoir n'importe quel nom. Voir Documents → Extraction de clé depuis cbc:ID pour la mise en place de la regex.

Combinaisons non prises en charge​

SourceProcess TypeStatut
BIP, Extract Mode = BothUBLNon pris en charge — l'ensemble extrait contient à la fois le XML et la sortie générée, qui ne peut pas être traitée en UBL.
BIP, Extract Mode = Both avec plusieurs lignes de sortieXMLRejeté — l'extraction produit plusieurs fichiers, le pipeline XML attend un seul fichier par exécution.

Un message d'erreur explicite apparaît dans la section Résultat de traitement quand l'une de ces combinaisons est tentée.

Résultats​

L'écran sépare le résultat en deux sections :

  • Résultat d'extraction — message renvoyé par l'API d'extraction ; renseigné en premier.
  • Résultat de traitement — table de logs structurée du traitement (mêmes colonnes que sur les pages XML et UBL : Sévérité / Module / Sous-module / Message) ; renseigné uniquement quand l'extraction a réussi et que le traitement s'est effectivement exécuté.

Si l'extraction échoue, l'étape de traitement est sautée — l'enchaînement s'interrompt au premier échec.

Conseils & bonnes pratiques​

  • Utiliser Extraction et traitement pour des exécutions ponctuelles. La page combine deux opérations sur un seul écran : récupérer puis traiter un document se fait en un clic. Pour des exécutions répétées et automatisées, préférer Synchronisation → Fetch Input — il enchaîne le même pipeline en lot.
  • Adapter Process Type à la sortie d'extraction. Le tableau des combinaisons ci-dessus liste les paires non prises en charge ; vérifier la cohérence entre le mode d'extraction BIP et le type de traitement choisi avant de cliquer sur Exécuter.
  • Pour un workflow piloté par BIP, garder Process Type sur XML. Ce choix déclenche Apply post-generation en cas de succès, qui met à jour le statut du job JDE — sans cela, le même job sera ré-extrait au tour suivant.
  • Le résultat d'extraction garde la sortie brute de l'API. Quand une erreur survient côté extraction (job manquant, fichier introuvable, identifiants SFTP), le message renvoyé par l'API d'extraction reste le diagnostic de référence — à lire avant toute relance.
  • Skip sending pendant la mise au point d'un template. Les deux pipelines proposent l'option (No send / Skip sending) — l'utiliser pendant le développement d'un template évite de produire des doublons de soumission PA entre les itérations.