Services Communauté Forum Documentation Contact : info@maarch.org +33 1 47 24 51 59

Maarch Capture Connector/MCC Server en 1.1 fr

De Maarch // Wiki.


:Version : 1.1 Stable

Release date : 2011/06/13

Introduction

Maarch Capture Connector (MCC) est un connecteur bureautique / scanner. Lors de l’impression vers une imprimante virtuelle, ce module permet d'envoyer les documents en format PDF directement dans l'application Maarch, sur la page de saisie des métadonnées. Maarch Capture Connector Serveur fonctionne avec Maarch Capture Connector Client.

Historique

Maarch Capture Connector (MCC) remplace Maarch Scansnap Connector (MSC). Le MSC a entièrement été réécrit en PHP pour devenir MCC. En voici les raisons :

  • A cause de son nom : on pensait à tort que MSC n’était compatible qu’avec les scanners Fujitsu Scansnap
  • Il était écrit en VB6, qui en plus de ne pas être gratuit n’est pas supporté par Microsoft
  • il n’était pas portable

De bonnes nouvelles :

  • MCC est entièrement compatible avec tous les scanners et tous les générateurs de PDF (comme PDF Creator)
  • MCC tourne (en théorie) sous Windows, Linux et MacOS X

Nouvelles fonctionnalités :

  • Fonctionne avec les Proxies
  • Fonctionne avec le protocole sécurisé HTTPS
  • Nouveau mode formulaire : s’il est activé, quelques informations de base vous seront demandées après la numérisation du document et avant l’envoi au serveur. Vous pouvez le mettre en forme grâce au form.xml
  • Un mode d’enregistrement de masse : téléchargez de nombreux documents en même temps sur le serveur. Vous pouvez préparer l’import de masse grâce au module AutoImport en utilisant le fichier structrure.xml

Structure du paquet

Liste de fichiers pour le MCC Serveur:

MCC_Server/
|-- config/
|    -- config_mass.xml.default   # Le fichier de configuration entre le MCC server et
|                                 # la numérisation de masse
|    -- config_mcc.xml.default    # Le fichier de configuration entre le MCC server et
|                                 # l’application Maarch Entreprise
|    -- config_mlb.xml.default    # Le fichier de configuration entre le MCC server et
|                                 # l’application Maarch LetterBox
|    -- form.dtd                  # DTD du form.xml
|    -- form.xml.default          # Type de formulaire pour l’application Maarch Entreprise
|    -- form_mlb.xml.default      # Type de formulaire pour l’application Maarch LetterBox
|    -- structure.xml.default     # Type de structure AutoImport pour Maarch Entreprise
|    -- structure_mlb.xml.default # Type de structure AutoImport pour Maarch LetterBox
|-- outcome/                      # En mode import de masse, les fichiers sont sauvegardés ici
|-- logs/
|-- class_db.php                  # Classe pour gérer les connections à la base de données
|-- get_datas.php                 # Script d’échange d’informations avec MCC client
|-- mcc_server.php                # Script principal

Installation

  1. Faites une extraction de cette archive sur votre serveur. Il doit être accessible par le web, il faut donc le placer dans le www-root de votre serveur.
  2. Enlevez le .default : le fichier config/config_XXX.xml.default devient config/config_XXX.xml
  3. Éditez le fichier config_XXX.xml et personnalisez-le en fonction de votre environnement
  4. Si vous voulez utiliser le mode formulaire et/ou l’import de masse, vous devez copier puis renommer les fichiers config/form_XXX.xml.default and config/structure_XXX.xml.default en config/form_XXX.xml et config/structure_XXX.xml. Puis vous devez configurer Maarch AutoImport pour injecter les documents depuis le répertoire entrant dans la base de données de l’application. Si vous n’utilisez pas l’import de masse cette étape n’est pas nécessaire.

Détails de la configuration

Paramétrage config_XXX.xml

La configuration principale se fait dans la section <CONFIG>. Voici les tags disponibles pour la configuration

  • CONFIG_NAME: le nom de la configuration -> config_XXX.xml, vous devez enter XXX dans le tag CONFIG_NAME
  • MCC_PATH: Le chemin vers le dossier dans lequel vous avez installé le MCC Serveur ex: C:\xampp\htdocs\MCC_server\
  • MAARCH_TMP_PATH: Chemin vers le répertoire temporaire de votre application. Vous pouvez le trouver ce chemin dans le fichier de configuration principale config.xml de chaque application Maarch ex: C:\xampp\htdocs\entreprise\apps\maarch_entreprise\tmp\
  • TARGET_PATH: Le chemin vers le dossier dans lequel le MCC Serveur copie ses fichiers entrants. ex: C:\xampp\htdocs\mcc\server\outcome\
  • FORM: le chemin vers le fichier de configuration (seulement pour le mode formulaire ou l’import de masse) ex: C:\xampp\htdocs\MCC_server\config\form_XXX.xml
  • CREATE_INDEX: A passer à “true” si vous voulez créer un fichier d’index pour l’AutoImport seulement pour le mode formulaire ou l’import de masse)
  • STRUCTURE_FILE: Le chemin vers le fichier de configuration de l’index pour l’AutoImport (seulement pour le mode formulaire ou l’import de masse) ex: C:\xampp\htdocs\MCC_server\config\structure_XXX.xml

Le reste de la configuration se fait dans la base de données. Vous devez configurer le serveur et les droits pour atteindre la base de données de l’application dans laquelle vous allez enregistrer les documents avec le MCC ( Maarch LetterBox ou Maarch Entreprise)

Paramétrage form_XXX.xml

Tout d’abord vous devez changer l’emplacement du DTD

<!DOCTYPE ROOT SYSTEM "http://127.0.0.1/mcc/server/config/form.dtd">

Vous pouvez modifier la structure générale du formulaire avec :

<FORM>

<TITLE>Maarch Capture Connector</TITLE>

<WIDTH>455</WIDTH>

<HEIGHT>350</HEIGHT>

<CENTER>true</CENTER>

Vous pouvez modifier ou créer les champs avec :

  • liste des valeurs fixes

<INPUT>

<TYPE>comboBox</TYPE>

<ID>status</ID>

<LABEL>Statut</LABEL>

<AUTOCOMPLETE>false</AUTOCOMPLETE>

<VALUES>

<VALUE><ID>NEW</ID><LABEL>Nouveau document</LABEL></VALUE>

<VALUE><ID>VAL</ID><LABEL>A valider</LABEL></VALUE>

<VALUE><ID>END</ID><LABEL>Cloturé</LABEL></VALUE>

<VALUE><ID>TRT</ID><LABEL>A traiter</LABEL></VALUE>

</VALUES>

<DEFAULT_VALUE>NEW</DEFAULT_VALUE>

<SHOW_ID>true</SHOW_ID>

<MANDATORY>true</MANDATORY>

</INPUT>

  • liste des valeurs dans la base de données d’une application Maarch :

<INPUT>

<TYPE>comboBox</TYPE>

<ID>folders</ID>

<LABEL>Dossiers</LABEL>

<AUTOCOMPLETE>true</AUTOCOMPLETE>

<TABLE>

<TABLE_NAME>folders</TABLE_NAME>

<FOREIGN_KEY>folders_system_id</FOREIGN_KEY>

<FOREIGN_LABEL>folder_name</FOREIGN_LABEL>

<WHERE_CLAUSE>status = 'NEW'</WHERE_CLAUSE>

<ORDER>order by folder_name</ORDER>

</TABLE>

<DEFAULT_VALUE></DEFAULT_VALUE>

<SHOW_ID>false</SHOW_ID>

<MANDATORY>false</MANDATORY>

</INPUT>

Paramétrage structure_XXX.xml

Vous pouvez préparer l’import de masse avec l’AutoImport en utilisant le fichier de structure™XXX.xml

<ROOT>

<FIELDS>

<TYPEID>'9999'</TYPEID>

<TYPIST>'bblier'</TYPIST>

<STATUS>status</STATUS>

<SCANDATE>'@date'</SCANDATE>

<DESTINATION>entities</DESTINATION>

<PRIORITY>priority</PRIORITY>

<FOLDERID>folders</FOLDERID>

</FIELDS>

</ROOT>

Paramétrage Maarch AutoImport

Warning.gif Ceci n’est nécessaire que si vous utilisez l’import de masse. Sans cela vous n’avez pas besoin de raccorder Maarch AutoImport au MCC Serveur.
Picto infos.gif Ceci est juste une piste. Nous vous proposons de consulter la documentation Maarch AutoImport documentation pour plus d’informations.


Vous trouverez la configuration de Maarch AutoImport dans le fichier ./maarch_autoimport/config_*.xml (Le nom exact dépend de votre configuration) dans le répertoire principal de l’AutoImport

Le seul point important est de vous assurer que le chemin indiqué dans le tag <SCAN_IMPORT_DIRECTORY> de l’AutoImport est le même que celui du <TARGET_PATH> du MCC Serveur.

Assurez-vous que vous avez entré les paramètres corrects pour l’accès à la base de données/

Outils personnels
Language