Créer un document au format PDF/A3

ETAPE 1: Créer les documents préalables
ETAPE 2 : Créer le document PDF/A3
Etape 3 : Créer la requête REB et la rattacher au document PDF/A3
- Quelles sont les variables qui peuvent être utilisées ?
- Quelle est la chronologie d’exécution des différentes requêtes ?

🔊

Cette fonctionnalité est disponible à partir de la révision V5.08.

Un document au format PDF/A3 ( norme ISO-19005-3 ) est constitué :

d’un document PDF
de documents d’autres formats qui y sont associés (CSV, XML, DOCX, images, etc.)

Dans DIAPASON, ce format a été créé dans le cadre de la facturation électronique pour les FACTUR-X, qui sont constituées d’un PDF, d’un XML et de pièces jointes optionnelles.

Cependant, on peut aussi utiliser le PDF/A3 avec d’autres types de pièces jointes ! Pour cela il suffira de ne pas remplir le champs dédié au XML, et de remplir le champs dédié aux pièces jointes. Cela pourra par exemple servir pour constituer un document PDF/A3 avec un BL en PDF et des images des palettes chargée.

➡️ Pour constituer un document PDF/A3 dans DIAPASON, il faut au préalable avoir créé un document PDF, qui sera converti en PDF/A3, et des documents dédiés aux pièces jointes ou le document XML. On viendra ensuite associer ces documents ensemble dans la définition du document PDF/A3 !

🧐 Comment créer un document en format PDF/A3 ?

Pour mettre en place un PDF/A3 de type FACTUR-X, vous pouvez consulter cette page : Créer le document Factur-X en PDF/A3.

ETAPE 1: Créer les documents préalables

Avant de créer le document PDF/A3, il faut créer les documents qui en feront partie :

Le document PDF qui sera converti en PDF/A3 : document Diapason de type 6 (REB/MFD) avec mise en forme Crystal Report et format de sortie PDF
Les autres documents à associer au PDF/A3 :
- Document XML pour la factur-x.xml : création d’un document de type 8 ( REB/Liste) au format XML. Voir Créer le document Factur-X en PDF/A3
- autre format…

ETAPE 2 : Créer le document PDF/A3

On va ensuite pouvoir créer le document PDF/A3. Les documents PDF/A3 sont accessibles ici :

A noter que les fichiers PDF/A3 sont également accessibles depuis la liste “Documents tous types”, mais ils ne peuvent pas être créés depuis cette liste. Ils peuvent uniquement être créés depuis le menu spécifique “Documents PDF/A3”.

Et on remplit:

Globalement, on y trouve les même champs que pour un document de type 6, visibles ici :Définition des documents ( champs des documents ) . Les différences sont affichées ci-dessous👇.

Doc. Factur-X XML : on vient sélectionner le document .xml à associer à notre PDF/A3, parmi tous les documents de type 8 qui, dans l’onglet Mise en Forme, ont le champ “Type de sortie” = XML. Si on souhaite créer un PDF/A3 dans un autre contexte que la Factur-X, avec des pièces jointes qui ne sont pas au format XML, on ne remplit simplement pas ce champ. ( non obligatoire : le fichier sera inséré dans le pdf-a3 avec le nom factur-x.xml si présent)
DOC.PDF : on vient sélectionner ici le document PDF à convertir au format PDF/A3 parmi tous les documents de type 6 qui, dans l’onglet Mise en Forme, ont le champ “Type de sortie”=Crystal report.
PJ. PDF/A3 : listes des fichiers complémentaires à joindre au PDF : (non obligatoire)
- les fichiers sont séparés par des “;”
- il s’agit des chemins complets des fichiers
- soit le chemin est accessible depuis le Serveur d’application (UNIX)
- Soit le chemin est accessible depuis le serveur de services utilisé (Windows)

Requête : on rentre ici la requête REB associée au PDF/A3. Voir ci-dessous 👇 !

Etape 3 : Créer la requête REB et la rattacher au document PDF/A3

La requêter REB associée au document PDF/A3 permet :

d’initialiser les critères nécessaires à l’exécution des documents PDF, XML ou autres formats qui font partie du PDF/A3.
d’exécuter d’autres documents complémentaires par fonction macro langage
de compléter la liste des fichiers à joindre (initialisation de la SCR.DOC_PDFA3LisPJ)
de modifier le document XML pour factrur-x.xml ( initialisation de la SCR.DOC_PDFA3RefDocFacX)
de modifier le document PDF à exécuter ( initialisation de la DOC_PDFA3RefDocPDF)
…

Quelles sont les variables qui peuvent être utilisées ?

Variable	Désignation	Comportement
SCR.DOC_PDFA3LisPJ	Liste Chaînée des PJ pour PDF/A3	En début d’édition elle est alimentée par défaut par la zone “PJ. PDF/A3”. Elle peut être compléter : dans la requête Critère du document PDF/A3 dans la requête REB du document XML dans la requête REB du document Crytsal
SCR.DOC_PDFA3RefDocFacX	Document pour Fichier XML FACTUR-X	Référence du document à utiliser pour générer le fichier XML pour factur-x.xml Elle est initialisée par défaut avec la zone “Doc. Factur-X XML” et peut être mise à jour dans la requête critère du document PDF/A3 pour changer le document dynamiquement ou la vider pour ne pas exécuter le document XML.
SCR.DOC_PDFA3RefDocPDF	Document pour Edition Fichier PDF	Référence du document Crystal à exécuter. Elle est initialisée par défaut avec la zone “Doc. PDF” et peut être mise à jour dans la requête critère du document PDF/A3 pour changer le document dynamiquement ou la vider pour ne pas exécuter le document . si la référence du document est vide ( pas de document à exécuter) le fichier pdf à convertir est obligatoire via la SCR.DOC_PDFA3RefFicPDF
SCR.DOC_PDFA3RefFicFacX	Nom Complet du Fichier XML FACTUR-X	chemin complet du fichier XML “Factur-x.xml” Initialisable dans la requete Critere : Si la SCR.DOC_PDFA3RefDocFacX est vide : le fichier sera ajouter au PDF le chemin peut-être Unix ou Windows Si la SCR.DOC_PDFA3RefDocFacX est non vide (soit surchargé dans la requête, soit issu de la définition du document) : ce sera le chemin complet du fichier XML à générer ( sauf contre indication dans la requete du document XML avec l’initialisation de la SCR.DOC_FicEdt) ( chemin UNIX lié au type du document)
SCR.DOC_PDFA3RefFicPDF	Nom Complet du Fichier PDF	chemin complet du fichier PDF à convertir Initialisable dans la requete Critere : Si la SCR.DOC_PDFA3RefDocPDF est vide , ce critere est obligatoire. Ce fichier sera converti en PDF/A3 le chemin peut-être Unix ou Windows Si la SCR.DOC_PDFA3RefDocPDF est non vide (soit surchargée dans la requête, soit issu de la définition du document) : ce sera le chemin complet du fichier PDF à convertir ( sauf contre indication dans la requête du document Crystal avec l’initialisation de la SCR.DOC_FicEdt)

Quelle est la chronologie d’exécution des différentes requêtes ?

Exécution requête du PDF/A3

En Entrée :
- SCR.DOC_FICEdt : initialisée en fonction du paramétrage du document
- SCR.DOC_PDFA3RefDocFacX : initialisée en fonction du paramétrage du document
- SCR.DOC_PDFA3RefDocPDF : initialisée en fonction du paramétrage du document
- SCR.DOC_PDFA3LisPJ : initialisée en fonction du paramétrage du document
- SCR.DOC_* : initialisée en fonction du paramétrage du document comme les autres documents Diapason :
  - SCR.DOC_BRO
  - SCR.DOC_DocEdt
  - SCR.DOC_DocLib
  - SCR.DOC_ImpEdt
  - SCR.DOC_ImpEdt
  - SCR.DOC_DocPJTyp
  - SCR.DOC_DocPJLib
  - SCR.DOC_DocPJFic
  - SCR.DOC_DocTEn
  - SCR.DOC_DocCl1
  - SCR.DOC_DocCl2
  - SCR.DOC_DocCl3
  - SCR.DOC_GEDCLE
- Tout Autre Critères (Standard et Spécifique Utilisé dans la requête)
Actions Disponibles Pendant l’exécution de la requête
- Utilisation du mot clef “DOC-NON-UTILISE” : l’Edition sera abandonné sans erreur. La suite du traitement ne sera pas exécuté
- Utilisation du mot clef LC-ERREUR : L’Edition se terminera en erreur. La suite du traitement ne sera pas exécuté.
- Initialisation de toutes les SCR, VCR et VBP pour l’exécution des documents suivants
- Initialisation de la liste pour mise en GED (Non encore Mis en place/Tester)
En Sortie en fonction des Initialisation de ces SCR Particulières le comportement est le suivant :
- SCR.Doc_FicEdt : Force le nom du fichier de sortie
- SCR.DOC_PDFA3RefDocFacX : Si vide pas d’exécution du document Pour Factur-X sinon surcharge du document initial
- SCR.DOC_PDFA3RefFicFacX : Si la SCR.DOC_PDFA3RefDocFacX est vide, le fichier donné sera la pièce jointe de type factur-x.xml Sinon Ce sera le chemin complet du fichier XML à générer
- SCR.DOC_PDFA3RefDocPDF : Si Vide le fichier PDF à convertir est obligatoire sinon référence du document pour générer le document à convertir
- SCR.DOC_PDFA3RefFicPDF: Si la SCR.DOC_PDFA3RefDocPDF est vide , ce critère est obligatoire, il doit contenir le chemin complet du fichier PDF à convertir( chemin UNIX ou Windows) sinon ce sera le chemin complet du fichier PDF à convertir à générer par le document PDF
- SCR.DOC_PDFA3LisPJ : liste chainées des chemins complets des fichiers à joindre au PDF/A3 ( chemin UNIX ou Windows)

Exécution Document XML factur-x.xml (facultatif) ( destination FICHIER)

En Entrée :
- SCR.DOC_FICEdt : initialisée en fonction de la SCR.DOC_PDFA3RefFicFacX
- SCR.DOC_PDFA3RefDocPDF : initialisée en fonction du paramétrage du document
- SCR.DOC_PDFA3LisPJ : initialisée en fonction du paramétrage du document
- SCR.DOC_* : initialisée en fonction du paramétrage du document comme les autres documents Diapason :
  - SCR.DOC_BRO
  - SCR.DOC_DocEdt
  - SCR.DOC_DocLib
  - SCR.DOC_ImpEdt : Imprimante du document PDF/A3 si de type Fichier Sinon impirmante “FICHIER”
  - SCR.DOC_DocPJTyp
  - SCR.DOC_DocPJLib
  - SCR.DOC_DocPJFic
  - SCR.DOC_DocTEn
  - SCR.DOC_DocCl1
  - SCR.DOC_DocCl2
  - SCR.DOC_DocCl3
  - SCR.DOC_GEDCLE
- Tout Autre Critères (Standard et Spécifique Utilisé dans la requête)
Actions Disponibles Pendant l’exécution de la requête
- Utilisation du mot clef “DOC-NON-UTILISE” : ce document et son résultat sera ignoré dans la suite du traitement ( pas de fichier factur-x.xml rattaché au document au PDF/A3) . la conversion PDF/A3 ira quand même à son terme.
- Utilisation du mot clef LC-ERREUR : L’Edition se terminera en erreur. La suite du traitement ne sera pas exécuté.
- Initialisation de toutes les SCR, VCR et VBP pour l’exécution de la suite du traitement
En Sortie en fonction des Initialisations de ces SCR Particulières le comportement est le suivant :
- SCR.Doc_FicEdt : Force le nom du fichier XML factur-x.xml à joindre au PDF/A3 ( contredit l’initialisation de la SCR.DOC_PDFA3RefFicFacX ayant pu être fait dans la requête Critère)
- SCR.DOC_PDFA3RefDocPDF : Si Vide le fichier PDF à convertir est obligatoire sinon référence du document pour générer le document à convertir
- SCR.DOC_PDFA3RefFicPDF: Si la SCR.DOC_PDFA3RefDocPDF est vide , ce critère est obligatoire, il doit contenir le chemin complet du fichier PDF à convertir( chemin UNIX ou Windows) sinon ce sera le chemin complet du fichier PDF à convertir à générer par le document PDF
- SCR.DOC_PDFA3LisPJ : liste chainées des chemins complets des fichiers à joindre au PDF/A3 ( chemin UNIX ou Windows)

Exécution Document PDF si renseigné (destination FICHIER)

En Entrée :
- SCR.DOC_FICEdt : initialisée en fonction de la SCR.DOC_PDFA3RefFicPDF
- SCR.DOC_PDFA3LisPJ : initialisée en fonction du paramétrage du document
- SCR.DOC_* : initialisée en fonction du paramétrage du document comme les autres documents Diapason :
  - SCR.DOC_BRO
  - SCR.DOC_DocEdt
  - SCR.DOC_DocLib
  - SCR.DOC_ImpEdt : Imprimante du document PDF/A3 si de type Fichier Sinon imprimante “FICHIER”
  - SCR.DOC_DocPJTyp
  - SCR.DOC_DocPJLib
  - SCR.DOC_DocPJFic
  - SCR.DOC_DocTEn
  - SCR.DOC_DocCl1
  - SCR.DOC_DocCl2
  - SCR.DOC_DocCl3
  - SCR.DOC_GEDCLE
- Tout Autre Critères (Standard et Spécifique Utilisé dans la requête)
Actions Disponibles Pendant l’exécution de la requête
- Utilisation du mot clef “DOC-NON-UTILISE” : l’édition courante ET l’édition du PDF/A3 seront abandonnés sans erreur. La suite du traitement ne sera pas exécutée
- Utilisation du mot clef LC-ERREUR : l’édition courante ET l’édition du PDF/A3 se termineront en erreur. La suite du traitement ne sera pas exécutée.
- Initialisation de toutes les SCR, VCR et VBP pour l’exécution de la suite du traitement
En Sortie en fonction des Initialisations de ces SCR Particulières le comportement est le suivant :
- SCR.Doc_FicEdt : Force le nom du fichier PDF à convertir ( contredit l’initialisation de la SCR.DOC_PDFA3RefFicPDF ayant pu être fait dans la requête Critère)
- SCR.DOC_PDFA3LisPJ : liste chainées des chemins complets des fichiers à joindre au PDF/A3 ( chemin UNIX ou Windows)