Maarch Capture Connector/MCC Server en 1.1

History

Maarch Capture Connector (MCC) is the replacement for Maarch Scansnap Connector (MSC). MSC has been entirely rewritten in PHP. There are multiple reasons 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. You can set the form with form.xml
  • A new mass upload mode: upload several documents to the server at once. You can prepare the stream for mass import AutoImport using the file structrure.xml

Set up config_XXX.xml

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

• CONFIG_NAME: The name of the config -> config_XXX.xml, You must enter XXX in the tag CONFIG_NAME
• 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\
• FORM: the path of the form configuration file (only on form mode or mass upload) ex: C:\xampp\htdocs\MCC_server\config\form_XXX.xml
• CREATE_INDEX: Put true if you want to create an index file for the AutoImport (only on form mode or mass upload)
• STRUCTURE_FILE: The path of the index configuration file for the AutoImport (only on form mode or mass upload) ex: C:\xampp\htdocs\MCC_server\config\structure_XXX.xml

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 form_XXX.xml

First you have to change the location of the DTD:

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

You can set the general structure of the form with:

<FORM>

<TITLE>Maarch Capture Connector</TITLE>

<WIDTH>455</WIDTH>

<HEIGHT>350</HEIGHT>

<CENTER>true</CENTER>

You can edit/create fields with:

• list of fixed values:

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

• list of values in a Maarch application database:

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

Set up structure_XXX.xml

You can prepare the stream for mass import AutoImport using the file 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>

Set Up Maarch AutoImport