M-PS On base Connector

Différence entre versions

De MappingDoc
(Prérequis et Concept)
(Mise en œuvre en ligne de commande)
 
(3 révisions intermédiaires par le même utilisateur non affichées)
Ligne 7 : Ligne 7 :
 
*Le PDF généré est à la norme PDF/A.
 
*Le PDF généré est à la norme PDF/A.
 
*Le flux XML au format OnBase s’appuie sur un fichier modèle (ou patron) renseigné lors de l’appel de la commande d’export.
 
*Le flux XML au format OnBase s’appuie sur un fichier modèle (ou patron) renseigné lors de l’appel de la commande d’export.
 +
  
 
Ce guide détaille les étapes et éléments nécessaires à la production de documents vers l’outil de GED OnBase : l’apport des fichiers CSV modèles et la définition de variables spécifiques de l’environnement d’exécution.  
 
Ce guide détaille les étapes et éléments nécessaires à la production de documents vers l’outil de GED OnBase : l’apport des fichiers CSV modèles et la définition de variables spécifiques de l’environnement d’exécution.  
Ligne 14 : Ligne 15 :
  
 
==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 OnBase s’effectue au format CSV, à partir d’un fichier modèle défini par l’utilisateur. Ce fichier contient :
+
L’export de document vers la solution de GED OnBase s’effectue au format CSV, à partir d’un fichier modèle défini par l’utilisateur.  
*(1) Les métadonnées : le nom des index positionnés dans la maquette M-Designer, dans l’ordre attendu par OnBase
+
 
*(2) Le nom du fichier à exporter au format PDF  
+
Ce fichier contient :
Le séparateur de colonnes dans le fichier modèle doit correspondre au séparateur configuré dans OnBase.
+
* Les métadonnées : le nom des index positionnés dans la maquette M-Designer, dans l’ordre attendu par OnBase
M-Processing Server génèrera le fichier PDF et le fichier CSV dans un même répertoire. C’est pourquoi seul le nom du fichier PDF (sans le chemin) apparaît dans le fichier CSV.
+
* Le nom du fichier à exporter au format PDF  
+
 
Figure 1 Contenu d'un fichier modèle
+
 
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. La variable d’environnement PATH_DOC_CLASS permet de renseigner le chemin du dossier local. Sur les plateformes Windows et Unix, cette variable peut être renseignée dans le Menu d’Administration/Gestion de la configuration :
+
Le séparateur de colonnes dans le fichier modèle doit correspondre au séparateur configuré dans OnBase. M-Processing Server génèrera le fichier PDF et le fichier CSV dans un même répertoire. C’est pourquoi seul le nom du fichier PDF (sans le chemin) apparaît dans le fichier CSV.
 
   
 
   
 +
Contenu d'un fichier modèle
 +
 +
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. La variable d’environnement PATH_DOC_CLASS permet de renseigner le chemin du dossier local. Sur les plateformes Windows et Unix, cette variable peut être renseignée dans le Menu d’Administration/Gestion de la configuration.
 +
 
==Mise en œuvre en ligne de commande==
 
==Mise en œuvre en ligne de commande==
 
L’export de fichiers PDF se fait suite à une conversion au format PDF grâce à la commande MAP_XPS. Plusieurs conditions sont nécessaires pour déclencher la génération du fichier CSV attaché au fichier converti.
 
L’export de fichiers PDF se fait suite à une conversion au format PDF grâce à la commande MAP_XPS. Plusieurs conditions sont nécessaires pour déclencher la génération du fichier CSV attaché au fichier converti.
1.Renseigner le format d’export dans la configuration du serveur. Pour cela, créer la variable d’environnement DMS_PROVIDER et lui donner la valeur « OnBase ».
+
 
2.Préciser le fichier modèle pour l’export : paramètre exporttemplate sur la ligne de commande.
+
#Renseigner le format d’export dans la configuration du serveur. Pour cela, créer la variable d’environnement DMS_PROVIDER et lui donner la valeur « OnBase ».
3.Préciser le nom du fichier CSV résultant de l’export : paramètre indexfile sur la ligne de commande.
+
#Préciser le fichier modèle pour l’export : paramètre exporttemplate sur la ligne de commande.
Exemple : map_xps.exe  infile:C:\Temp\in.xps  outfile:C:\Temp\out.pdf  toPDF  indexfile:C:\temp\out.csv  
+
#Préciser le nom du fichier CSV résultant de l’export : paramètre indexfile sur la ligne de commande.
  exporttemplate:bill_template.csv
+
 
 +
 
 +
Exemple :  
 +
map_xps.exe  infile:C:\Temp\in.xps  outfile:C:\Temp\out.pdf  toPDF  indexfile:C:\temp\out.csv  exporttemplate:bill_template.csv
 +
 
 
La ligne de commande en exemple exporte les critères placés dans le document infile dans le fichier indexfile d’après le fichier modèle construit avec PATH_DOC_CLASS et exporttemplate.
 
La ligne de commande en exemple exporte les critères placés dans le document infile dans le fichier indexfile d’après le fichier modèle construit avec PATH_DOC_CLASS et exporttemplate.
  

Version actuelle datée du 10 juillet 2019 à 09:39

Prérequis et Concept

Ce guide décrit les procédures de paramétrage et d’utilisation du connecteur OnBase. Le fonctionnement de ce connecteur est assuré avec M-Designer et M-Processing Server sur Windows, Unix et iSeries, versions 7.2 et suivantes.

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

  • Le PDF généré est à la norme PDF/A.
  • Le flux XML au format OnBase s’appuie sur un fichier modèle (ou patron) renseigné lors de l’appel de la commande d’export.


Ce guide détaille les étapes et éléments nécessaires à la production de documents vers l’outil de GED OnBase : l’apport des fichiers CSV modèles et la définition de variables spécifiques de l’environnement d’exécution.

Ce guide s’adresse à un public maîtrisant la conception de modèles de documents avec M-Designer, et la conversion de documents via la commande map_xps.  

Préparation de l’export : Le fichier modèle

L’export de document vers la solution de GED OnBase s’effectue au format CSV, à partir d’un fichier modèle défini par l’utilisateur.

Ce fichier contient :

  • Les métadonnées : le nom des index positionnés dans la maquette M-Designer, dans l’ordre attendu par OnBase
  • Le nom du fichier à exporter au format PDF


Le séparateur de colonnes dans le fichier modèle doit correspondre au séparateur configuré dans OnBase. M-Processing Server génèrera le fichier PDF et le fichier CSV dans un même répertoire. C’est pourquoi seul le nom du fichier PDF (sans le chemin) apparaît dans le fichier CSV.

Contenu d'un fichier modèle

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. La variable d’environnement PATH_DOC_CLASS permet de renseigner le chemin du dossier local. Sur les plateformes Windows et Unix, cette variable peut être renseignée dans le Menu d’Administration/Gestion de la configuration.

Mise en œuvre en ligne de commande

L’export de fichiers PDF se fait suite à une conversion au format PDF grâce à la commande MAP_XPS. Plusieurs conditions sont nécessaires pour déclencher la génération du fichier CSV attaché au fichier converti.

  1. Renseigner le format d’export dans la configuration du serveur. Pour cela, créer la variable d’environnement DMS_PROVIDER et lui donner la valeur « OnBase ».
  2. Préciser le fichier modèle pour l’export : paramètre exporttemplate sur la ligne de commande.
  3. Préciser le nom du fichier CSV résultant de l’export : paramètre indexfile sur la ligne de commande.


Exemple :

map_xps.exe  infile:C:\Temp\in.xps  outfile:C:\Temp\out.pdf  toPDF  indexfile:C:\temp\out.csv  exporttemplate:bill_template.csv

La ligne de commande en exemple exporte les critères placés dans le document infile dans le fichier indexfile d’après le fichier modèle construit avec PATH_DOC_CLASS et exporttemplate.

Mise en œuvre dans les Workflows

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

Les paramètres présentés dans la ligne de commande sont repris dans cette boite. Les variables PATH_DOC_TEMP et DMS_PROVIDER sont toujours à renseigner dans l’environnement.