Author: echatellier Date: 2014-07-18 16:04:42 +0200 (Fri, 18 Jul 2014) New Revision: 425 Url: http://forge.codelutin.com/projects/faxtomail/repository/revisions/425 Log: Update web site. Add doc about csv encoding Added: trunk/src/site/ trunk/src/site/resources/ trunk/src/site/resources/img/ trunk/src/site/resources/img/notepad.png trunk/src/site/resources/img/txt-to-csv.png trunk/src/site/rst/ trunk/src/site/rst/import.rst trunk/src/site/site_fr.xml Removed: trunk/src/rst/ Modified: trunk/src/site/rst/install.rst trunk/src/site/rst/mssql.rst Added: trunk/src/site/resources/img/notepad.png =================================================================== (Binary files differ) Property changes on: trunk/src/site/resources/img/notepad.png ___________________________________________________________________ Added: svn:mime-type + image/png Added: trunk/src/site/resources/img/txt-to-csv.png =================================================================== (Binary files differ) Property changes on: trunk/src/site/resources/img/txt-to-csv.png ___________________________________________________________________ Added: svn:mime-type + image/png Added: trunk/src/site/rst/import.rst =================================================================== --- trunk/src/site/rst/import.rst (rev 0) +++ trunk/src/site/rst/import.rst 2014-07-18 14:04:42 UTC (rev 425) @@ -0,0 +1,98 @@ +.. - +.. * #%L +.. * FaxToMail +.. * $Id$ +.. * $HeadURL$ +.. * %% +.. * Copyright (C) 2014 Franciaflex, Code Lutin +.. * %% +.. * 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, see +.. * <http://www.gnu.org/licenses/gpl-3.0.html>. +.. * #L% +.. - + +Import par fichier CSV +====================== + +Format +------ + +Les fichiers d'import doivent être formater suivant le standart CSV (Comma-separated values) et +utiliser le séparateur ``;``. + +Exemple avec le fichier d'import des États d'attente:: + + etatattente + etat 1 + etat 2 + etat 3 + +Ce fichier ne comporte qu'une seule colonne ``etatattente``, les séparateurs ``;`` ne sont donc pas requis. + +Voici un exemple plus complet avec le fichier client:: + + Id_Correspondance;Societe;Nom;Caracteristique1;Caracteristique2;Caracteristique3;Numero_Fax;Adresse_Mail;Code_Client + 253042;FX;John Doe;A;71 Allo;NULL;03 12 34 56 78;john@doe.fr;99153 + 253142;FX;Gerard Menvussa;A+;40 Nabi;NULL;05 12 23 34 45;gerard.menvussa@code.com;99154 + 253242;FX;Ella Elli;NULL;38 LA;NULL;04 98 87 76 65;NULL;99184 + +Ce fichier comporte 9 colonnes séparée par le séparateur ``;``. Il comporte une ligne d'entete et +3 lignes de données. + + +Encodage +-------- + +Il est très difficile de déterminé le format d'encodage du fichier texte (CSV). L'application FaxToMail +impose donc l'utilisation du format d'encodage standardisé unicode (UTF-8). + +Cependant, certains système d'exploitation, comme Windows, n'utilisent pas ce standard. + +Il faut donc spécifier lors de l'enregistrement du fichier: + * l'encodage des caractères à utiliser + * le format du fichier (séparateur ``;``, délimiteur...) + +notepad++ +~~~~~~~~~ + +Pour éditer un fichier au format texte, le logiciel `notepad++`_ est plus évolué que les outils +basique mis à la disposition par défaut par Windows. Il dispose de plus d'une option pour spécifier +le format d'encodage lors de la sauvegarde. + +.. _notepad++: http://notepad-plus-plus.org/ + +.. image:: img/notepad.png + +Openoffice/Libreoffice +~~~~~~~~~~~~~~~~~~~~~~ + +Openoffice et Libreoffice sont deux equivalents libre de la suite bureautique Microsoft Office. Ce +logiciel propose plus facilement les options d'encodage lors de l'enregistrement du fichier CSV. + +Il s'agit d'une simple option à sélection dans la fenêtre de sauvegarde. + +Excel +~~~~~ + +Pour spécifier l'encodage sous Microsoft Excel, c'est un peu compliqué car l'option n'est pas +facilement accessible. + +Pour pouvoir changer cette option, il faut: + * ouvrir la boite de dialogue "Enregistrer sous..." + * Choisir de sauver le document en type "Tous les fichiers (*.*) + * modifier le nom du fichier en xxx.csv + +comme montré dans cette image: + +.. image:: http://www.ablebits.com/_img-blog/excel-csv/txt-to-csv.png Property changes on: trunk/src/site/rst/import.rst ___________________________________________________________________ Added: svn:keywords + Author Date Id Revision HeadURL Added: svn:eol-style + native Modified: trunk/src/site/rst/install.rst =================================================================== --- trunk/src/rst/install.rst 2014-07-18 09:29:44 UTC (rev 417) +++ trunk/src/site/rst/install.rst 2014-07-18 14:04:42 UTC (rev 425) @@ -28,33 +28,44 @@ Téléchargement -------------- - * Installer Java JRE 7 (minimum) : http://www.oracle.com/technetwork/java/javase/downloads/jre7-downloads-18802... - * Télécharger Tomcat 7 : http://apache.crihan.fr/dist/tomcat/tomcat-7/v7.0.53/bin/apache-tomcat-7.0.5... - * Télécharger Apache 2.4 : http://www.apachelounge.com/download/VC11/binaries/httpd-2.4.9-win64-VC11.zi... +* Installer Java JRE 7 (minimum) : http://www.oracle.com/technetwork/java/javase/downloads/jre7-downloads-18802... +* Télécharger Tomcat 7 : http://apache.crihan.fr/dist/tomcat/tomcat-7/v7.0.53/bin/apache-tomcat-7.0.5... +* Télécharger Apache 2.4 : http://www.apachelounge.com/download/VC11/binaries/httpd-2.4.9-win64-VC11.zi... - * Installer Java - * Installer tomcat. Tomcat s'installe automatiquement en tant que service windows. - * Décompresser httpd-2.4.9-win64-VC11.zip dans ''C:\Apache24'' - * Installer apache en tant que service windows : ''httpd.exe -k install'' - * Si un message à propos de msvcr110.dll s'affiche, c'est que "Microsoft Visual C++ Redistributable" n'est pas installé - * http://answers.microsoft.com/en-us/windows/forum/windows_8-winapps/the-progr... - * http://www.microsoft.com/en-us/download/details.aspx?id=30679 - * Démarrer les services "Apache tomcat 7.0 Tomcat7" et "Apache2.4" +* Installer Java +* Installer tomcat. Tomcat s'installe automatiquement en tant que service windows. +* Décompresser httpd-2.4.9-win64-VC11.zip dans ''C:\Apache24'' +* Installer apache en tant que service windows : ''httpd.exe -k install'': + * Si un message à propos de msvcr110.dll s'affiche, c'est que "Microsoft Visual C++ Redistributable" n'est pas installé + * http://answers.microsoft.com/en-us/windows/forum/windows_8-winapps/the-progr... + * http://www.microsoft.com/en-us/download/details.aspx?id=30679 +* Démarrer les services "Apache tomcat 7.0 Tomcat7" et "Apache2.4" + À ce stade, les adresses http://localhost/ et http://localhost:8080 doivent répondre. Apache ------ - * Dans le fichier 'C:\Apache24\conf\httpd.conf', décommenter les lignes:: +Étapes: +* Dans le fichier 'C:\Apache24\conf\httpd.conf', décommenter les lignes + +:: + LoadModule proxy_module modules/mod_proxy.so LoadModule proxy_ajp_module modules/mod_proxy_ajp.so - * Ajouter à la fin du fichier:: +* Ajouter à la fin du fichier + +:: + Include conf/extra/httpd-faxtomail.conf - * Créer le fichier ''conf/extra/httpd-faxtomail.conf'' avec en contenu:: +* Créer le fichier ''conf/extra/httpd-faxtomail.conf'' avec en contenu + +:: + <VirtualHost *:80> ServerAdmin webmaster@franciaflex.com ServerName 192.168.100.247 @@ -74,10 +85,14 @@ Tomcat ------ - * Télécharger le war depuis l'adresse : http://forge.codelutin.com/projects/faxtomail/files - * Enregistrez le dans le dossier ''C:\Program Files\Apache Software Foundation\Tomcat 7.0\webapps\'' avec le nom ''ROOT.war'' (supprimer le dossier ROOT) - * Créer le fichier ''C:\Windows\System32\faxToMail.properties'' avec en contenu:: +* Télécharger le war depuis l'adresse : http://forge.codelutin.com/projects/faxtomail/files +* Enregistrez le dans le dossier ''C:\Program Files\Apache Software Foundation\Tomcat 7.0\webapps\'' avec le nom ''ROOT.war'' (supprimer le dossier ROOT) +* Créer le fichier ''C:\Windows\System32\faxToMail.properties'' avec en contenu + +:: + faxtomail.storage=C:\\faxtomail\\data - * Relancer le service ''Apache Tomcat 7.0 Tomcat7'' +* Relancer le service ''Apache Tomcat 7.0 Tomcat7'' + L'application doit maintenant être installée et répondre sur l'adresse : http://192.168.100.247/ Modified: trunk/src/site/rst/mssql.rst =================================================================== --- trunk/src/rst/mssql.rst 2014-07-18 09:29:44 UTC (rev 417) +++ trunk/src/site/rst/mssql.rst 2014-07-18 14:04:42 UTC (rev 425) @@ -37,5 +37,5 @@ hibernate.dialect=org.hibernate.dialect.SQLServer2008Dialect hibernate.connection.driver_class=net.sourceforge.jtds.jdbc.Driver hibernate.connection.url=jdbc:jtds:sqlserver://192.168.100.247:1433/faxtomail - hibernate.connection.username=fx - hibernate.connection.password=FX2013! + hibernate.connection.username=user + hibernate.connection.password=pass Added: trunk/src/site/site_fr.xml =================================================================== --- trunk/src/site/site_fr.xml (rev 0) +++ trunk/src/site/site_fr.xml 2014-07-18 14:04:42 UTC (rev 425) @@ -0,0 +1,41 @@ +<?xml version="1.0" encoding="UTF-8"?> + +<project name="${project.name}"> + + <skin> + <groupId>org.apache.maven.skins</groupId> + <artifactId>maven-fluido-skin</artifactId> + <version>1.3.1</version> + </skin> + + <publishDate format="dd/MM/yyyy" position="right" /> + <version position="right" /> + + <poweredBy> + <logo href="http://maven.apache.org" name="Maven" img="images/logos/maven-feather.png" /> + </poweredBy> + + <body> + + <breadcrumbs> + <item name="${project.name}" href="${project.url}" /> + </breadcrumbs> + + <menu name="Documentation"> + <item name="Accueil" href="index.html" /> + + <item name="Utilisateur" href="import.html"> + <item name="Import" href="import.html" /> + </item> + + <item name="Développeur" href="install.html"> + <item name="Installation" href="install.html" /> + <item name="SQL Serveur" href="mssql.html" /> + </item> + </menu> + + <menu ref="reports" /> + + </body> + +</project> Property changes on: trunk/src/site/site_fr.xml ___________________________________________________________________ Added: svn:mime-type + text/xml Added: svn:keywords + Author Date Id Revision HeadURL Added: svn:eol-style + native