ONYX:9.0:Utilisation:Connecteur EasyFolder

Prérequis et Concept

Ce guide décrit les procédures de paramétrage et d’utilisation du connecteur EasyFolder. Il est basé sur la documentation fournie par CIMAIL : Capture en mode SAS.

Le fonctionnement de ce connecteur est lié avec DESIGNER et ONYX Server.

Le principe du connecteur EasyFolder est de générer des flux PDF et XML en se basant sur les index positionnés dans la maquette DESIGNER :

• un PDF généré à la norme PDF/A.

• Un flux XML fournissant les informations nécessaires au classement, appelé documentInformation

Ce document décrit le mode de fonctionnement attendu dans Mapping pour créer des fichiers importables par EasyFolder Capture.

Architecture générale cible

Schéma d'architecture fonctionnelle

D’un point de vue Mapping, la mise en place de la solution ne nécessite l’ajout d’aucun logiciel complémentaire à une architecture classique de traitement. Il s’agit d’ajouter un connecteur EasyFolder pour produire un fichier d’index/métadonnées conforme au standard EasyFolder Capture.

Chaine d’intégration

L’objet est de définir les critères d’indexation permettant de stocker et de rechercher les documents dans EasyFolder. La récupération de ces critères se fait soit au moment de la définition du modèle de composition du document, dans DESIGNER, ou dans la chaine de traitement du Workflow par extraction de données, dans ONYX Server.

La création du fichier d’index/métadonnées au format EasyFolder se fera dans le workflow Mapping en utilisant le nouveau connecteur permettant la production d’un XML structuré selon le schéma communiqué.

Plan de classement

Le plan de classement EasyFolder doit être défini en amont de l’intégration des fichiers Mapping, le contenu et une partie de la structure des fichiers XML étant dépendant de ce plan de classement. Si l’arborescence définie dans le fichier XML n’existe pas, le fichier sera rejeté. Une solution d’import automatique avec création dynamique du plan de classement est à l’étude chez CIMAIL (soit solution fonctionnelle FindOrCreate mais non intégrée de base dans le produit aujourd’hui, soit paramétrage d’un import automatique via l’outil Import2Folder, sous la responsabilité de l’intégrateur de la solution chez le client final). L’approche générale est donc de définir un plan de classement simple en fonction des informations définies dans le fichier de données provenant de l’application (métadonnées permettant de définir et d’indexer le document dans Mapping : type de document, date, critères de recherche).

De même, les métadonnées sont à créer dans EasyFolder avant d’être utilisées dans Mapping.

Exemple d’arborescence :

Documents des ventes (catégorie de documents)  // défini dans le Workflow (action spécifique ou table de paramétrage)
  Société (Index) // défini dans le modèle de composition et/ou le Workflow
     Factures (Type de document) // repris dans les attributs du fichier et/ou le Workflow
        Année (Index) // défini dans le modèle de composition et/ou le Workflow
            Numéro de facture (Index) // défini dans le modèle de composition et/ou le Workflow

Modèle de données

Le fichier XML permettant l’intégration dans EasyFolder doit contenir les éléments suivants :

• Un bloc DOCUMENTINFORMATION
• Un bloc CAPTURE (imbriqué dans le bloc DOCUMENTINFORMATION)
• Un bloc DESTINATION (imbriqué dans le bloc CAPTURE)

Entete / Format

Le fichier est à créer en utf-8, sans indicateur d’ordre des octets (BOM en anglais, pour Byte Order Mark).

<?xml version="1.0" encoding="utf-8" ?>

Bloc DocumentInformation

Ce bloc est présent une seule fois.

Paramètre	Valeurs possible	Mapping	Remarque
Title	Chaîne	[%MAP_TITLE%]	Nom du fichier attendu dans EasyFolder. Défini par l’utilisateur
AdditionnalInformation		N/A	Optionnel
EventLog		Texte de la cellule	Géré automatiquement par le système
Actions	Cf. bloc CAPTURE	Texte de la cellule	UNE seule balise Actions est possible