Maarch Capture Connector/MCC Server en

De Maarch // Wiki.

Aller à : Navigation, rechercher
Version: 1.0 Beta
Release date:2010/02/11

WARNING

This is a beta release. Even if it is quite stable, it has to be heavily tested. If you find any bug, please report it on the forum (http://forum.maarch.org).

Introduction

This is Maarch Capture Connector Server. It is intended to work with Maarch Capture Connector Client.

History

Maarch Capture Connector (MCC) is the replacement for Maarch Scansnap Connector (MSC). MSC has been entirely rewritten in PHP. There are multiple for that :

  • Because of its name, MSC was (too) often considered to be only compatible with Fujitsu Scansnap scanners
  • It was written in VB6, which is neither free (as in "free speech"), nor supported by Microsoft
  • It was not portable

So here is the good news:

  • MCC is fully compatible with any scanner, and any PDF-Generators (such as PDF Creator)
  • MCC can (in theory) work on Windows, Linux and MacOS X
  • It has some great new features :
    • Support for Proxies
    • Support for secured protocol (HTTPS)
    • A new "Form Mode": if enabled, you will be prompted for a few basic information after your document is scanned, and before it is sent to the server. These information include: the department to affect the document to, the priority, etc.
    • A new mass upload mode: upload several documents to the server at once.

Package structure

File listing for the MCC Server:

MCC_Server/
|-- config/
|   `-- config.xml.default  # Config file for MCC server
|-- outcome/                # In mass scan mode, processed files are
|                           #    backed up here
|-- logs/
|-- class_db.php            # Class to handle connections to the database
|-- get_datas.php           # Script to exchange informations with MCC Client
`-- mcc_server.php          # Main script

Installation

  1. Extract this archive on your server. It must be available through the web, so place it in the www-root of your server.
  2. Copy config/config.xml.default to config/config.xml
  3. Edit config.xml, and set it up according to your environment
  4. If you want to use form mode and/or mass upload, you must set up Maarch AutoImport to inject documents from the outcome folder into the application database. In single document mode, you do not need this step.

Configuration details

config.xml

Main configuration is done in the <CONFIG> section. Here are the available configuration tags :

  • MCC_PATH: The path to the folder you install MCC Server in. - ex: C:\xampp\htdocs\MCC_server\
  • MAARCH_TMP_PATH: Path to the tmp folder of your application. You can find this path in the main config.xml of any Maarch application. - ex: C:\xampp\htdocs\entreprise\apps\maarch_entreprise\tmp\
  • TARGET_PATH: The folder where the MCC Server copies the files it receives - ex: C:\xampp\htdocs\mcc\server\outcome\

The rest is database configuration. You must set up server and credentials to access the database of the application in which you intend to record documents with MCC (Maarch LetterBox or Maarch Framework-based applications, like Maarch Entreprise).

Set Up Maarch AutoImport

Warning.gif This is only needed if you use mass upload. You do not need to chain Maarch AutoImport with MCC Server otherwise.
Picto infos.gif This is just an outline. Please refer to the `documentation of Maarch AutoImport`_ for more information.


You will find the configuration of Maarch AutoImport in the file ./maarch_autoimport/config_*.xml (the exact name of the file depends on your setup) in the main folder of AutoImport.

The only important point is to make sure that the path given in the tag <SCAN_IMPORT_DIRECTORY> of AutoImport is the same as the <TARGET_PATH> of MCC Server.

Make sure you entered the correct parameters for database access.

Language