M-PS Digitech Connector 7.2 fr

Différence entre versions

De MappingDoc
(Valeur des champs non METADONNEES)
 
(8 révisions intermédiaires par 2 utilisateurs non affichées)
Ligne 9 : Ligne 9 :
 
*Le PDF généré est à la norme PDF/A et il peut être signé et horodaté (certificat serveur)
 
*Le PDF généré est à la norme PDF/A et il peut être signé et horodaté (certificat serveur)
 
*Le flux XML au format Digitech s’appuie sur un fichier modèle (ou patron) renseigné lors de la construction du Workflow.
 
*Le flux XML au format Digitech s’appuie sur un fichier modèle (ou patron) renseigné lors de la construction du Workflow.
 +
  
 
Ce guide détaille les étapes et éléments nécessaires à la production de documents vers l’outil de GED Digitech : l’apport des fichiers XML modèles et la définition du Workflow.
 
Ce guide détaille les étapes et éléments nécessaires à la production de documents vers l’outil de GED Digitech : l’apport des fichiers XML modèles et la définition du Workflow.
  
Ce guide s’adresse à un public maîtrisant la conception de modèles de documents avec M-Designer, et la mise en place de Workflow dans M-Processing Server.
+
Ce guide s’adresse à un public maîtrisant la conception de modèles de documents avec M-Designer, et la mise en place de Workflows dans ONYX Server.
  
 
 
==Préparation de l'export : le fichier modèle==
 
==Préparation de l'export : le fichier modèle==
  
 
L’export de document vers la solution de GED Digitech s’effectue au format XML, à partir d’un fichier d’exemple défini par l’utilisateur. Ce fichier contient :
 
L’export de document vers la solution de GED Digitech s’effectue au format XML, à partir d’un fichier d’exemple défini par l’utilisateur. Ce fichier contient :
*La classe d’objets, c’est-à-dire le modèle de données (1)
 
*Les métadonnées : ce sont les index positionnés dans la maquette M-Designer (2)
 
*Le lien vers le fichier à exporter au format PDF (3)
 
 
Figure 1 Un patron d'export, et les valeurs à renseigner.
 
  
Plusieurs fichiers XML patrons peuvent être nécessaires pour des appels dynamiques en fonction des types de documents à archiver. Ils devront être stockés localement dans un dossier du serveur hébergeant la solution M-Processing Server. Le chemin de ce dossier est à renseigner dans le Menu d’Administration/Gestion de la configuration, sous une entrée PATH_CLASS_DIGITECH :
+
*La classe d’objets, c’est-à-dire le modèle de données
 +
*Les métadonnées : ce sont les index positionnés dans la maquette M-Designer
 +
*Le lien vers le fichier à exporter au format PDF
 +
 
  
+
Plusieurs fichiers XML patrons peuvent être nécessaires pour des appels dynamiques en fonction des types de documents à archiver. Ils devront être stockés localement dans un dossier du serveur hébergeant la solution ONYX Server. Le chemin de ce dossier est à renseigner dans le Menu d’Administration/Gestion de la configuration, sous une entrée PATH_CLASS_DIGITECH
 
==Environnement de l 'exécution de l'export==
 
==Environnement de l 'exécution de l'export==
  
Dans un fichier XML patron, deux types de champs de remplacement sont distingués. Les premiers sont les champs de métadonnées, qui reprennent les valeurs des index positionnés dans M-Designer. Les autres données sont renseignées par le contexte d’exécution : paramètres du Workflow ou table de résolution.
+
Dans un fichier XML patron, deux types de champs de remplacement sont distingués. Les premiers sont les champs de métadonnées, qui reprennent les valeurs des Index positionnés dans M-Designer. Les autres données sont renseignées par le contexte d’exécution : paramètres du Workflow ou table de résolution.
 
   
 
   
Figure 2 Exemple de table de résolution pour la définition de champs lors d’un export Digitech
+
<br />
 
 
==MISE EN ŒUVRE DANS LES WORKFLOWS==
 
 
 
  
 +
==Mise en œuvre dans les WORKFLOWS==
 
===Le fichier de sortie===
 
===Le fichier de sortie===
  
L’appel au connecteur Digitech est placé dans la section ‘XPS to Web Format’ :
+
L’appel au connecteur Digitech est placé dans la section ‘XPS to Web Format’.
 
  
 
La boîte reprend pour l’essentiel les onglets de l’export vers PDF. Pour l’exécution d’un export, seul le nom du PDF de sortie est spécifié par l’utilisateur. Le fichier XML aura au final le même nom que le fichier PDF (à l’extension près).
 
La boîte reprend pour l’essentiel les onglets de l’export vers PDF. Pour l’exécution d’un export, seul le nom du PDF de sortie est spécifié par l’utilisateur. Le fichier XML aura au final le même nom que le fichier PDF (à l’extension près).
  
Dans cet exemple, la zone d’index NOMPDF est utilisée pour nommer dynamiquement le fichier PDF (et le XML rattaché). Pour chaque valeur distincte de l’index, un nouveau couple PDF/XML sera créé.
+
Par exemple, la zone d’index NOMPDF est utilisée pour nommer dynamiquement le fichier PDF (et le XML rattaché). Pour chaque valeur distincte de l’index, un nouveau couple PDF/XML sera créé.
 
 
  
 
===Valeur des champs non METADONNEES===
 
===Valeur des champs non METADONNEES===
  
 
L’onglet index de la boîte « To Digitech » sert à désigner le fichier XML patron à utiliser, et les valeurs de remplacement pour les champs suivants :
 
L’onglet index de la boîte « To Digitech » sert à désigner le fichier XML patron à utiliser, et les valeurs de remplacement pour les champs suivants :
*[[DGT_TYPE_EDI]] le type d’édition (4)
 
*[[DGT_LIBELLE]] le libellé du document PDF dans l’outil de GED Digitech (6)
 
  
Par ailleurs, il servira à choisir le fichier patron XML approprié (5) parmi l’ensemble de ceux déposés dans le dossier [PATH_CLASS_DIGITECH].
+
*<nowiki>[[DGT_TYPE_EDI]] </nowiki>le type d’édition
 +
*<nowiki>[[DGT_LIBELLE]] </nowiki>le libellé du document PDF dans l’outil de GED Digitech
 +
 
 +
 
 +
Par ailleurs, il servira à choisir le fichier patron XML approprié parmi l’ensemble de ceux déposés dans le dossier [PATH_CLASS_DIGITECH].
  
+
Renseigner les champs d'export, appel à la table de résolution et paramètres du Workflow.
Figure 3 Renseigner les champs d'export, appel à la table de résolution et paramètres du Workflow
 
 
Si le type d’édition n’est pas renseigné, la chaîne vide sera placée dans le fichier XML.
 
Si le type d’édition n’est pas renseigné, la chaîne vide sera placée dans le fichier XML.
 
Si le libellé du document n’est pas renseigné, le nom du fichier physique sera placé dans le fichier XML.
 
Si le libellé du document n’est pas renseigné, le nom du fichier physique sera placé dans le fichier XML.
  
Certaines valeurs dans le modèle d’export sont quant à elles remplacées par des valeurs prédéfinies. Ainsi [[DGT_PDF_PATH]] aura toujours pour valeur « . », et [[DGT_PDF_NAME]] aura automatiquement pour valeur le nom du fichier PDF.
+
Certaines valeurs dans le modèle d’export sont quant à elles remplacées par des valeurs prédéfinies. Ainsi <nowiki>[[DGT_PDF_PATH]</nowiki>] aura toujours pour valeur « . », et <nowiki>[[DGT_PDF_NAME]]</nowiki> aura automatiquement pour valeur le nom du fichier PDF. 
 
 
 
Figure 4 Un fichier XML produit par l'export vers l'outil GED Digitech
 
 

Version actuelle datée du 10 juillet 2019 à 08:48

Prérequis et concept

Ce guide décrit les procédures de paramétrage et d’utilisation du connecteur Digitech.

Le fonctionnement de ce connecteur est assuré avec M-Designer et M-Processing Server sur Windows ou Unix, en version 7.2 et suivantes.

Le principe du connecteur Digitech est de produire des flux PDF et XML en fonction des informations demandées par l’utilisateur, à destination de l’outil de GED édité par Digitech. Les informations exportées sont basées sur les métadonnées positionnées dans le modèle M-Designer et sur le contexte d’exécution du Workflow.

  • Le PDF généré est à la norme PDF/A et il peut être signé et horodaté (certificat serveur)
  • Le flux XML au format Digitech s’appuie sur un fichier modèle (ou patron) renseigné lors de la construction du Workflow.


Ce guide détaille les étapes et éléments nécessaires à la production de documents vers l’outil de GED Digitech : l’apport des fichiers XML modèles et la définition du Workflow.

Ce guide s’adresse à un public maîtrisant la conception de modèles de documents avec M-Designer, et la mise en place de Workflows dans ONYX Server.

Préparation de l'export : le fichier modèle

L’export de document vers la solution de GED Digitech s’effectue au format XML, à partir d’un fichier d’exemple défini par l’utilisateur. Ce fichier contient :

  • La classe d’objets, c’est-à-dire le modèle de données
  • Les métadonnées : ce sont les index positionnés dans la maquette M-Designer
  • Le lien vers le fichier à exporter au format PDF


Plusieurs fichiers XML patrons peuvent être nécessaires pour des appels dynamiques en fonction des types de documents à archiver. Ils devront être stockés localement dans un dossier du serveur hébergeant la solution ONYX Server. Le chemin de ce dossier est à renseigner dans le Menu d’Administration/Gestion de la configuration, sous une entrée PATH_CLASS_DIGITECH

Environnement de l 'exécution de l'export

Dans un fichier XML patron, deux types de champs de remplacement sont distingués. Les premiers sont les champs de métadonnées, qui reprennent les valeurs des Index positionnés dans M-Designer. Les autres données sont renseignées par le contexte d’exécution : paramètres du Workflow ou table de résolution.


Mise en œuvre dans les WORKFLOWS

Le fichier de sortie

L’appel au connecteur Digitech est placé dans la section ‘XPS to Web Format’.

La boîte reprend pour l’essentiel les onglets de l’export vers PDF. Pour l’exécution d’un export, seul le nom du PDF de sortie est spécifié par l’utilisateur. Le fichier XML aura au final le même nom que le fichier PDF (à l’extension près).

Par exemple, la zone d’index NOMPDF est utilisée pour nommer dynamiquement le fichier PDF (et le XML rattaché). Pour chaque valeur distincte de l’index, un nouveau couple PDF/XML sera créé.

Valeur des champs non METADONNEES

L’onglet index de la boîte « To Digitech » sert à désigner le fichier XML patron à utiliser, et les valeurs de remplacement pour les champs suivants :

  • [[DGT_TYPE_EDI]] le type d’édition
  • [[DGT_LIBELLE]] le libellé du document PDF dans l’outil de GED Digitech


Par ailleurs, il servira à choisir le fichier patron XML approprié parmi l’ensemble de ceux déposés dans le dossier [PATH_CLASS_DIGITECH].

Renseigner les champs d'export, appel à la table de résolution et paramètres du Workflow. Si le type d’édition n’est pas renseigné, la chaîne vide sera placée dans le fichier XML. Si le libellé du document n’est pas renseigné, le nom du fichier physique sera placé dans le fichier XML.

Certaines valeurs dans le modèle d’export sont quant à elles remplacées par des valeurs prédéfinies. Ainsi [[DGT_PDF_PATH]] aura toujours pour valeur « . », et [[DGT_PDF_NAME]] aura automatiquement pour valeur le nom du fichier PDF.