Spécification des paramètres d’export et mise en correspondance des champs

Cette section décrit les champs des fichiers de configuration M-Files - ExportScript - Configure by script.cs et default.config.xml. Server contient l’URL à utiliser pour accéder à M-Files via Internet. Par exemple, <Server>http://m-files-server</Server>.

Pour obtenir des instructions détaillées sur la configuration de l’accès web, consultez le Guide de l’utilisateur M-Files.

Username contient le nom de l’utilisateur dans M-Files. Il peut s’agir soit d’un nom de domaine, soit d’un nom local sur M-Files Server. Par exemple, <Username>username</Username>. Password contient le mot de passe de l’utilisateur. Par exemple, <Password>password</Password>. Repository contient le nom du coffre documentaire dans M-Files. Par exemple, <Repository>DocumentVault</Repository>. FolderPath contient le nom du type d’objet. Par exemple, <FolderPath>Document</FolderPath>. FileName contient le nom du document qui sera créé au moment de l’export. Par exemple, <FileName><Batch>_<Identifier></FileName>.

Le nom du document peut comporter une partie statique fixe et une partie dynamique variable. La partie dynamique est définie par des balises, qui sont remplacées par les valeurs des propriétés du document ABBYY FlexiCapture au moment de l’export. Chaque balise doit être placée entre crochets angulaires. Dans le fichier XML :

‘<’ représente ‘<’ ;
‘>’ représente ‘>’.

Balises possibles pour la partie dynamique du nom :

Project pour le nom du projet dans ABBYY FlexiCapture ;
Batch pour le nom du lot ;
DocumentDefinition pour le nom de la définition de document dans ABBYY FlexiCapture ;
SourceFile pour le nom du fichier source ;
Identifier pour l’identifiant du document dans le lot ;
BatchType pour le nom du type de lot ;
Time pour l’heure actuelle au format yyyy-MM-dd_HH-mm-ss.

Vous pouvez utiliser les balises de remplacement dynamique ”<FolderPath>”, ”<Template>,” et ”<FileName>” pour mettre à jour les documents envoyés de M-Files vers FlexiCapture pour traitement. Si le lot FlexiCapture a été créé par l’activité de workflow M-Files “Abbyy.MFiles.FlexiCapture.Activity.dll” :

Une balise de remplacement d’exécution ”<FolderPath>” peut être utilisée dans le champ de configuration FolderPath au lieu d’un nom de type d’objet explicite.
Une balise ”<Template>” peut être utilisée dans le champ de configuration DmsMetadataTemplate au lieu d’un nom de classe explicite.
Une balise ”<FileName>” peut être utilisée dans le champ de configuration FileName au lieu d’un nom de document explicite.

Ces balises sont remplacées par la valeur des Paramètres d’enregistrement du lot. Les Paramètres d’enregistrement du lot sont créés par l’activité de workflow M-Files. Le document d’origine dans M-Files sera mis à jour en fonction de ces paramètres d’enregistrement. Ces balises de remplacement dynamique sont sensibles à la casse et la casse des caractères utilisés dans les balises ci-dessus doit être respectée. Voici un exemple de nom de document comportant une partie statique :

<FileName>My_static_prefix_&lt;DocumentDefinition&gt;_&lt;Identifier&gt;and_postfix</FileName>

Voici un exemple de nom de document sans partie fixe :

<FileName>&lt;Project&gt;_&lt;Identifier&gt;</FileName>

NameConflictResolution permet de résoudre les conflits de noms. Valeurs possibles :

NewVersion – Une nouvelle version du document est créée.
NewName – Un nouveau document portant un nouveau nom est créé.

Par exemple,

<CreationPolicy> 
  <NameConflictResolution>NewVersion</NameConflictResolution> 
</CreationPolicy>

L’option NewVersion permet de mettre à jour le document dans M-Files si le nom et le format spécifiés dans le script correspondent au nom et au format du document dans M-Files. Si les noms et les formats des deux documents ne correspondent pas, un nouveau document sera créé dans M-Files.

DmsMetadataTemplate contient le nom de la classe de document dans M-Files. Par exemple,

<DmsMetadataTemplate>
  <Name>Facture</Name>
</DmsMetadataTemplate>

FieldPairs contient une collection de paires de champs. Cette collection est utilisée pour la mise en correspondance des champs de la définition de document ABBYY FlexiCapture avec les définitions de propriétés M-Files. Si vos paramètres d’export sont stockés dans un fichier XML, mettez les champs en correspondance comme suit :

<FieldPairs>
 <FieldPair>
   <AfcField>Invoice\InvoiceNumber</AfcField>
   <DmsField>InvoiceNumber</DmsField>
 </FieldPair>
</FieldPairs>

où :

AfcField est le chemin complet du champ de la définition de document de FlexiCapture à partir duquel les données doivent être lues lors de l’export.
DmsField est le nom de la définition de propriété M-Files dans laquelle les données seront écrites lors de l’export.

Si vos paramètres d’export sont définis dans le script, mettez les champs en correspondance dans un dictionnaire comme suit :

Dictionary<string, string> pairs = new Dictionary<string, string>()
{
    { @"Invoice Layout\InvoiceNumber", "Numéro de facture" },
    { @"Invoice Layout\InvoiceDate", "Date de facture" },
};

Dans les paires ci-dessus, la valeur située avant la virgule correspond au nom complet d’un champ dans la définition de document de FC, et la valeur située après la virgule correspond au nom de la définition de propriété associée dans M-Files. SaveDocumentImages – Indique s’il faut exporter l’image ou non. Lorsqu’elle est définie sur true, le connecteur envoie à M-Files à la fois l’image du document et les champs extraits ; sinon, seuls les champs extraits sont envoyés à M-Files. ExportImageSavingOptions contient les options d’enregistrement de l’image à utiliser lors de l’export, telles que le format de l’image exportée, sa qualité et les zones masquées. Pour une description détaillée des options d’enregistrement de l’image, consultez ABBYY FlexiCapture Developer’s Help. DmsSpecificOptions – Il s’agit des paramètres spécifiques à M-Files :

Workflow – Le nom ou l’alias du workflow qui sera attribué au document une fois l’export de FC vers M-Files terminé (facultatif). Par exemple,

<DmsSpecificOptions>
    <Option>
      <Name>Workflow</Name>
      <Value xsi:type="xsd:string">Invoice.Workflow</Value>
    </Option>
  </DmsSpecificOptions>