MCC Client en 1.1 fr

MCC Client en 1.1 fr
Version: 1.1 Stable
Release date: 2011/07/28
Sommaire
• 1 Introduction
♦ 1.1 Historique
• 2 Structure du paquet
♦ 2.1 launch_mcc_client_XXX.bat
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
.. _PDF Creator: http://www.pdfforge.org/
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
|
`-- 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
|
`-- launch_mcc_client_mlb.bat.default
# Exemple de lanceur pour Maarch LetterBox
|
|-- tools/
|
`-- php-gtk2/
# Librairie utilisée pour l'interface graphique
|
|-- class_http_request.php
# Classe pour la communication avec le MCC Serveur
`-- mcc_client.php
# Script principal
== Installation ==*
1. Créez le répertoire C:/maarch/mcc/client. 2. Se placer dans le répertoire puis exécutez la commande suivante
svn checkout http://svn.maarch.org/mcc/branches/1.1/client/ .
3. Enlevez le .default : le fichier config/config_XXX.xml.default devient config/config_XXX.xml 4. Editez le fichier config_XXX.xml et personnalisez-le en
fonction de votre environnement 5. Editez le fichier launch_mcc_client_XXX.bat et personnalisez-le en fonction de votre environnement 6. 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.
7. 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?pag
• 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 formulaire. 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.