Gestionnaire intelligent de capacité, gestion des données stockées sur Microsoft Exchange.
- Décompresser le fichier d'installation.
- Installer WinSCP.
- Remplir le fichier de configuration (se reporter à la section informations sur la configuration).
- Lancer l'executable.
- Enjoy 👍
Optionnel : Si vous souhaitez crypter ou décrypter le fichier de configuration, reportez vous à la section information sur la configuration.
Indication : La trace d'exécution du programme peut être trouvée dans output.log (par défaut).
Ce logiciel fonctionne avec la version 4.0 de la librairie .NET, toute version antérieure à celle-ci pourrait entrainer des disfonctionnements.
Afin de pouvoir décrypter les données sensibles utilisées pour la configuration du programme (mots de passe, noms de compte utilisateur et identifiants FTP) le logiciel ASP_Regiis.exe est utilisé.
Celui-ci est présent dans le répertoire C:\WINDOWS\Microsoft.NET\Framework[v4.0.30319]\.
Ce logiciel pilote WinSCP, il faut donc indiquer au programme où se situe l'executable WinSCP comme indiqué ci-après.
Les données de configuration sont situées dans le fichier MailConnector.exe.config pour le décrypter veillez utiliser la commande suivante : rename MailConnector.exe.config web.config && "\[chemin vers regiis]\aspnet_regiis.exe" -pdf "appSettings" "\[chemin vers le repertoire d'installation]\bin\release" && rename web.config MailConnector.exe.config
La commande de cryptage est quasi similaire : rename MailConnector.exe.config web.config && "\[chemin vers regiis]\aspnet_regiis.exe" -pef "appSettings" "\[chemin vers le repertoire d'installation]\bin\release" && rename web.config MailConnector.exe.config
On retrouve dans le fichier de configuration les données concernant le serveur mail, le serveur ftp, les chemins relatifs et le programme.
- ‘FTP_Protocol’ - correspond au type du serveur, il peut prendre les valeurs suivantes : 'ftp' ou 'sftp'
- ‘FTP_HostName’ - l'adresse du serveur
- ‘FTP_Port’ - le port du serveur
- ‘FTP_UserName’ - l'adresse de connexion au FTP
- ‘FTP_Password’ - le mot de passe de connexion au FTP
- ‘FTP_SshHostKeyFingerprint’ - la clé SSH dans le cas d'une connexion sécurisée au FTP
- Mail_UserName - l'adresse mail de l'utilisateur
- Mail_Password - le mot de passe de l'utilisateur
- Mail_Server - l'adresse du serveur
- WinSCP_ExecutablePath - le chemin vers l'executable WinSCP (pilotage de WinSCP)
- WinSCP_DebugLogPath - le chemin vers les log WinSCP
- Local_TempPath - le chemin vers le dossier cache
- Local_XMLPath - le chemin vers le fichier XML (si non présent, il sera généré depuis le fichier excel)
- Local_XLSXPath - le chemin vers le fichier Excel (si non présent, le programme lira le fichier XML)
- Local_DebugPath - le chemin vers les logs du programme
- Program_ColX - le numéro des colonnes lues par le programme dans le fichier Excel
- Program_DateTimeFormat - Indique le format d'écriture de la date. Il est utilisé pour la sauvegarde des fichiers dans le FTP, il doit donc être conforme aux règles d'écritures des noms de fichiers (caractères \/*:?"<>| interdits).
- Program_RegExSubject - Expression régulière concernant l'écriture des objets dans le tableau Excel. Si la valeur est "exact" seuls les mails dont l'objet est strictement celui indiqué dans le tableau seront traités. Dans le cas contraire (i.e. pour toutes les autres valeurs du champ) le programme selectionnera les mails dont l'objet contient l'expression indiquée.
- Program_AttachmentType - Types de format pris en charge lors de l'importation des pièces jointes séparés par des virgules et sans espace (e.g ".pdf,.xslx,.csv").
- Program_TempSize - Taille en octets au delà de laquelle le fichier de log du programme sera supprimé. Si cette taille vaut 0, le fichier de log sera supprimé après chaque exécution.
Une fois la configuration faite vous pouvez commencer à paramétrer le logiciel. Le paramétrage peut se faire, soit dans le fichier input-data.xlsx soit dans le fichier input-data.xml. Si aucun fichier excel n'est spécifié dans la configuration du programme ou bien si le fichier n'existe pas, seul le fichier XML sera lu. Dans le cas contraire, le programme lira le fichier excel et générera le xml correspondant.
Le programme peut fonctionner avec la structure minimale suivante
.
├── bin
│ └── release
│ ├── WinSCPnet.dll
│ ├── Microsoft.Exchange.WebServices.dll
│ ├── MailConnector.exe.config
│ └── MailConnector.exe
├── data-set.xlsx et/ou data-set.xml
├── WinSCP.exe
└── README.md
Dans le cas où le fichier XML n'est pas déjà présent, il est généré par le programme depuis le fichier Excel, il en va de même pour les fichiers de logs (winscp.log et output.log).
Cette version implémente les actions suivantes : Marque comme lu, Déplacer vers, transférer à, supprimer
L'accentuation et la mise en forme des entrées du tableau n'a pas d'importance, seul l'orthographe compte.
Une suite d'actions est possible si on sépare chacune d'entre elle par une virgule sans laisser d'espace, exemple : Marquer comme lu,déplacer vers,supprimer.
On ne peut en revanche indiquer qu'une valeur pour le type de destinataire (ou destination), exemple : adresse mail,fichier mail n'est pas possible. Par extension la suite d'action Transférer à,déplacer vers n'est pas possible car elle nécessite de rentrer l'adresse mail et le fichier dans le même champ destinataire.
Veillez à toujours étendre les tableaux plutôt que les diminuer. Si vous le diminuez verifiez que les cellules du tableau ne soient pas verrouillées.
- AttentionTOUT DEPLACEMENT EST IRREVERSIBLE Les mails traités le sont depuis la boite de réception uniquement. Dès lors qu'un mail est déplacé ailleurs, il va de soi qu'il ne pourra plus être pris en compte lors des futures opérations.
Un fichier data-set.xsd indique la forme que doit prendre le fichier XML afin d'être conforme au parseur du programme.
Le fichier xsd doit toujours être présent dans le répertoire d'installation, ceci afin que le programme puisse alerter l'utilisateur d'un défaut d'écriture dans le xml.