=================================
Maarch Capture Connector - Server
=================================

:Version: 1.0 Beta
:Release date: 2010/02/11
:Copyright: Copyright (c) 2010 Maarch
:Contact: Maarch <dev@maarch.org>
:License:

    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 3 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program; if not, write to the Free Software
    Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA




Contents of this file : 

0. Warning
1. Introduction
2. Package structure
3. Installation
4. Configuration details





0. 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).





1. 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.

.. _PDF Creator: http://www.pdfforge.org/






2. 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
 



3. 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.




4. 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:: This is only needed if you use mass upload. You do not need 
             to chain Maarch AutoImport with MCC Server otherwise.

.. note:: 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 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.

.. _documentation of Maarch AutoImport: 
                        http://wiki.maarch.org/Maarch_AutoImport