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

Maarch Capture Connector/MCC Client en 1.1 fr

De Maarch // Wiki.

Version: 1.1 Stable
Release date:2011/07/28

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 Client ne fonctionne que si Maarch Capture Connector Serveur est installé sur votre serveur.

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 Client

MCC_Client/
|-- certif/                            # Certificat SSL
|-- 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
|                                      # Maarch Entreprise
|   `-- config_mlb.xml.default         # Le fichier de configuration entre le MCC server et
|                                      # Maarch LetterBox
|
|-- incoming/                          # Répertoire où les documents sortants sont stockés
|-- logs/
|-- os_scripts/
|   `-- launch_mcc_client_mass.bat.default  # Lanceur de l'application pour le mode numérisation de masse
|   `-- launch_mcc_client_mcc.bat.default   # Exemple de lanceur pour Maarch Entreprise
|   `-- launch_mcc_client_mlb.bat.default   # Exemple de lanveur pour Maarch LetterBox
|
|-- tools/
|   `-- php-gtk2/                      # Librairie utilisée pour l'interface graphique
|
|-- class_http_request.php             # Classe pour la communication avec me MCC Serveur
`-- mcc_client.php                     # Script principal

Installation

  1. Faites une extraction de l'archive sur votre ordinateur
  2. Enlevez le .default : le fichier config/config_XXX.xml.default devient config/config_XXX.xml
  3. Editez le fichier config_XXX.xml et personnalisez-le en fonction de votre environnement
  4. Editez le fichier launch_mcc_client_XXX.bat et personnalisez-le en fonction de votre environnement
  5. Paramétrez les driveurs de votre scanner (ou de votre imprimante virtuelle) pour lancer launch_mcc_client_XXX.bat après la numérisation. Vous devez lancer launch_mcc_client_XXX.bat en vous assurant que le chemin au fichier est un argument.
  6. Lancez votre scanner ou votre imprimante virtuelle (PDFCreator) pour tester les paramètres (MCC Serveur doit être paramétré en premier).

Détails de la configuration

config.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 entrer XXX dans le tag CONFIG_NAME
  • MCC_PATH: chemin vers le dossier dans lequel vous avez installé MCC client ex: C:\maarch\mcc\client\
  • SCAN_IMPORT_PATH: Répertoire dans lequel le PCC va chercher les fichiers à envoyer vers le serveur.
  • MAARCH_URL: URL pour lancer après que le fichier ait été téléchargé sur le serveur. Ce n'est pas utilisé quand le le mode formulaire est désactivé. - ex: http://127.0.0.1/maarch_entreprise/apps/maarch_entreprise/index.php?page=view_baskets&amp;module=basket&amp;baskets=IndexingBasket
  • UPLOAD_URL: URL to the MCC Server page for file upload only - ex: http://127.0.0.1/mcc/server/mcc_server.php
  • GET_DATAS_URL: Si le mode formulaire est désactivé, c'est l'URLL que le MCC Client va utiliser pour communiquer avec le MCC Serveur
  • WEB_PORT: Précisez le port à utiliser, si différent du 80 (ou du 443 sous https)
  • SSL_CERT: Précisez le chemin vers la certification de votre serveur si vous utilisez HTTPS. Laissez vide si vous ne voulez pas l'utiliser. - ex: C:\maarch\mcc\client\certif\cert-server.crt
  • URL_PROXY: Précisez l'URL et le port de votre proxy. Laissez vide si vous ne souhaitez pas utiliser de proxy. - ex: http://192.168.21.39:3128/
  • USER_PROXY: si vous avez besoin de vous identifier sur votre proxy, précisez vos droits ici. Si besoin, précisez également votre domaine. - ex: \\MAARCH\user\password
  • AUTH_TYPE_PROXY: si vous avez besoin de vous identifier sur votre proxy, précisez lequel le MCC doit utiliser. Valeurs possibles: CURLAUTH_BASIC, CURLAUTH_NTLM
  • TYPE_PROXY: Précisez ici le typ de proxy. Valeurs possibles: CURLPROXY_HTTP, CURLPROXY_SOCKS5
  • BROWSER_PATH: chemin absolu vers votre navigateur. - ex: C:\Program Files\Mozilla Firefox\firefox.exe

L'autre section se rapporte au mode "Formulaire":

  • FORM_MODE: Permet de basculer sur le mode formulauie. Valeurs. Values: true, false
  • MASS_SCAN: L'import de masse permet de télécharger de nombreux documents simultanément. En réalité, il envoie tous les documents de ce dossier.
  • IMAGE_FORMAT: vous pouvez filtrer quel type de document le MCC va envoyer au serveur. Précisez un seul type (ex: PDF) ou ALL pour désactiver le filtrage.
  • IS_FOR_MLB: si vous utilisez le MCC avec Maarch LetterBox, mettez la valeur à true. Sinon laissez à false.

launch_mcc_client_XXX.bat

Vous devez trouver dans le fichier une ligne de type

C:\maarch\mcc\client\tools\php-gtk2\php.exe \
              c:\maarch\mcc\client\mcc_client.php \
              c:\maarch\mcc\client\config\config_XXX.xml %pathToImage%

Vous devez adapter les chemins en fonction de votre environnement.

Outils personnels
Language