Wiki

Javasr'Utt

---

Introduction

Cette librairie a été développée dans le cadre d’un projet de l'unité de valeur « GL02 – Génie Logiciel » à l’Université de technologie de Troyes lors du semestre d'Automne 2015.

Contexte

La société ClearWater est un leader dans l'installation d'adoucisseur d'eau chez de nombreuses organisations. Son équipe de commerciaux détient la totalité des contacts de leurs clients. Le logiciel doit permettre d'importer et exporter les contacts au format csv et vCard. La librairie permettra alors à la société de mettre à jour certains contacts et d'en garder une copie dans le cas où l'équipe de commerciaux venait à changer.

Détails

Présentation de la librairie
Le principe de ce logiciel est de pouvoir importer les contacts que détiennent les différents commerciaux et d'exporter les contacts soit sous format vCard soit sous format csv. Le logiciel permet de corriger certains contacts dans le cas où ils doivent être modifiés ou supprimés. Pour cela, la société pourra le faire soit en utilisant un logiciel qui exploite le format csv soit directement à partir du logiciel et de l'invite de commande.

Prérequis d’installation :

• Installer Node.js 5.1.1

Fonctionnement du logiciel :

Le logiciel se manipule uniquement avec l’invite de commandes (Windows) ou le Terminal (MacOS). L’application a été développée pour être intégrée à un logiciel en tant que librairie externe, il n’y a donc pas d’interface graphique.
Avant de commencer :
Afin de pouvoir utiliser le logiciel, il faut d’abord ouvrir une fenêtre d’invite de commandes ou du Terminal.
Pour ouvrir l’invite de commandes sur Windows il faut utiliser la combinaison de touches suivante : Touche Windows + Touche R. Cette combinaison ouvre une petite fenêtre d'exécution. Dans cette fenêtre, il faut entrer “cmd” et appuyer sur la touche entrée. Après ces étapes, vous devez avoir une invite de commande qui a s’est ouverte.

Fonctionnement de l'application :

Pour lancer l'application, il faut taper la commande
node vCardParser.js <fichier.vcf> help
L'application est lancée et une aide est affichée.

1) Afficher tous les contacts

node vCardParser.js <fichier_a_traiter> toutafficher

Chaque contact est encadré par des accolades et sont affichés au format vCard.
Firstname : désigne le prénom
lastname : désigne le nom
org : désigne le nom de l'organisation
title :
telfixe : désigne le numéro de téléphone fixe
telmobile : désigne le numéro de téléphone mobile
email : désigne l'email
id : désigne le numéro unique qui détermine un contact

2)Afficher un seul contact

node vCardParser.js <fichier_a_traiter> afficher <informationDuContact>

3) Ajouter un contact

node vCardParser.js <fichier_a_traiter> ajouter <nom> <prenom> <organisation> <fonction> <telephone> <mobile> <email> <id>

4) Supprimer un contact

node vCardParser.js <fichier_a_traiter> supprimer <id_contact>

5) Modifier un contact

node vCardParser.js <fichier_a_traiter> modifier <id_contact> <nouveau_prenom> <nouveau_nom> <nouvelle_organisation> <nouvelle_fonction> <nouveau_telephone> <nouveau_mobile> <nouveau_email>

6) Fusionner deux contacts

node vCardParser.js <fichier_a_traiter> fusionner <id_contact_1> <id_contact_2>

7) Importer un fichier vCard

node vCardParser.js <fichier_ou_on_importe> importer <fichier_a_importer>

8) Exporter au format CSV

node vCardParser.js <fichier_a_exporter> toutexporter

9) Exporter au format CSV

node vCardParser.js <fichier_a_traiter> detecterConflits

Organisation des ressources :

Le dossier est composé d'un fichier JavaScript « vCardParser.js » contenant le code source de l'application. L'application. Le dossier contient aussi les fichiers de type vCard ou CSV qui contiennent l'ensemble des contacts. Pour finir, un fichier README.TXT est présent afin de guider l'utilisateur lors de son utilisation.