================================= Maarch Capture Connector - Client ================================= :Version: 1.1 Stable :Release date: 2011/06/13 :Copyright: Copyright (c) 2011 Maarch :Contact: Maarch :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 Other components: PHP GTK is released under LGPL (see ./tools/php-gtk2/README.txt) Contents of this file : 1. Introduction 2. Package structure 3. Installation 4. Configuration details 1. Introduction =============== This is Maarch Capture Connector Client. It can only work if Maarch Capture Connector Server is set up on your server. 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. .. _PDF Creator: http://www.pdfforge.org/ 2. Package structure ==================== File listing for the MCC Client :: MCC_Client/ |-- certif/ # Place holder for the server's | # SSL certifacate |-- config/ | `-- config_mass.xml.default # A sample config file for the MCC Client with mass scan mode | `-- config_mcc.xml.default # A sample config file for the MCC Client with entreprise application | `-- config_mlb.xml.default # A sample config file for the MCC Client with letterbox application | |-- incoming/ # Folder where documents to send \ | # to the server must be stored |-- logs/ |-- os_scripts/ | `-- launch_mcc_client_mass.bat.default # Application launcher for mass scan mode sample | `-- launch_mcc_client_mcc.bat.default # Application launcher for entreprise sample | `-- launch_mcc_client_mlb.bat.default # Application launcher for letterbox sample | |-- tools/ | `-- php-gtk2/ # Library used for the UI | |-- class_http_request.php # Wrapper for cURL `-- mcc_client.php # Main script 3. Installation =============== 1. Extract this archive on your computer 2. Copy config/config.xml.default to config/config.xml 3. Edit config.xml, and set it up according to your environment 4. Edit launch_mcc_client.bat and set it up according to your environment 5. Set your scanner drivers (or virtual printer) to launch launch_mcc_client.bat after the scan. You must run launch_mcc_client.bat with the path to the fil as an argument. 6. Run your scanner or your virtual printer (PDFCreator) to test the settings (MCC Server must be set up first). 4. Configuration details ======================== config.xml ---------- Main configuration is done in the 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: Path to MCC client (this folder) - ex: C:\\maarch\\mcc\\client\\ * SCAN_IMPORT_PATH: Folder where MCC will look for files to send to the server * MAARCH_URL: URL to launch after the file has been uploaded to the server. It is not used when form mode is enabled. - ex: http://127.0.0.1/maarch_entreprise/apps/maarch_entreprise/index.php?page=view_baskets&module=basket&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: If form mode is enabled, this is the URL the MCC Client will use to communicate with the MCC Server. * WEB_PORT: Specify here the port to use, if different than 80 (or 443 for https) * SSL_CERT: Specify the path to the certificate of your server if you use HTTPS. Leave empty if you don't want to use it. - ex: C:\maarch\mcc\client\certif\cert-server.crt * URL_PROXY: Specify the URL and port of your proxy. Leave empty if you don't want to use any proxy. - ex: http://192.168.21.39:3128/ * USER_PROXY: If your proxy needs identification, specify your credentials here. If applicable, specify the domain too. - ex: \\\\MAARCH\\user\\password * AUTH_TYPE_PROXY: If your proxy needs identification, specify which one MCC must use. Available values: CURLAUTH_BASIC, CURLAUTH_NTLM * TYPE_PROXY: Specify here the type of proxy. Available values: CURLPROXY_HTTP, CURLPROXY_SOCKS5 * BROWSER_PATH: Absolute path to your browser. - ex: C:\Program Files\Mozilla Firefox\firefox.exe The other section is about the mode "Form": * FORM_MODE: Enables the form mode. Values: true, false * MASS_SCAN: mass scan mode allows you to upload several documents in the same time. Actually, it will send all the documents of a folder. * IMAGE_FORMAT: You can filter here which type of document MCC will send to the server. Specify a single type (ex: PDF) or ALL to disable filtering. * IS_FOR_MLB: If MCC is used with Maarch LetterBox, set it to true. Leve it to false otherwise launch_mcc_client_XXX.bat ------------------------- This file must contain a line like this:: 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% The only thing you have to do is adapt the paths to your environment.