ProDon:Modules d'importation

De Logilys
Aller à : navigation, rechercher

Modèle:Entete ProDon

Explications générales

Les modules sont tous regroupés en un même endroit. Vous avez la possibilité d’analyser vos données pour détecter toutes les erreurs qui pourraient s’y être glissées avant de confirmer l’importation. Les modules sont indépendants; en conséquence, vous aurez accès uniquement aux fonctionnalités relatives aux modules que vous possédez.


Généralement l'importation est faite depuis un fichier Excel sauvegardé en utilisant le type de fichier « CSV ».  Ce type de fichier utilse le « ; » pour delimiter les informations à l'intérieur du fichier, il faut donc s'assurer que les données en elle-même ne comporte pas cette ponctuation.  Le format « txt » est disponible, mais il vous reviendra alors d'indiquer au module le caractère qui sépare deux informations ainsi que le caractère qui marque le début et la fin d'une information.


La première ligne du fichier sert d'entête de colonne et, pour faciliter le processus, devrait correspondre aux libellé ou abrégés indiqués dans les sections pertinentes.


Les libellé ne sont pas sensibles à la casse ni aux caractères accentués, à l'exception de la cédille.


L'information dans la colonne particularité est cliquable et redirige vers une explication.


Les champs obligatoires pour chaque forme d'importation sont indiqués sous la légende de chaque liste de champ.

Liste des champs communs à tous les modules

Les champs communs sont principalement utilisé pour faire le lien entre un fichier que vous désirez importer et votre base de données.  S'il y a de l'information dans les 2 champs, le NUC sera prioritaire.

Libellé complet Abrégé 1 Abrégé 2 Valeurs possibles Longeur maximale Particularité
NUC NoClient NoCli Numéro de client existant 7
NoRéférence Réf NoRéf
25


Module d'importation et mise à jour client

Ce module répond à une vaste gamme de besoin.  Principalement, il sert à créer et corriger massivement les clients de votre base de données.  Il est fréquement utilisé conjointement avec les modules d'importation de transactions ou d'engagements (voir sections respectives pour plus de détails).


Liste des champs clients

Champs obligatoires pour la création d'un nouveau client

Clinom OU CliCompagnie

ET

CliLibelléCaractéristique (si des caractéristiques sont obligatoire pour les clients dans ProDon)


Champs obligatoires pour la détection de doublons

(CliPrénom ET CliNom) OU CliCompagnie

ET

CliAdresse

ET

CliCodePostal


Libellé complet Abrégé 1 Abrégé 2 Valeurs possibles Longeur maximale Particularité
CliAdresse CliAdr


150
[+]
CliAdrVoie



100
1
CliAdrPointRemise
CliAdrRemise


100
1
CliAdrBatiment



100
1
CliAdrComplVoie



100
1
CliAdrSuccursale
CliAdrSucc


100
1
CliCedex



100
1
CliAnonyme
CliAnony
CliAno
N ou F = Non (Vide = Non)
O ou V = Oui
1

CliAppellation
CliApp


50

CliBénéficiaire
CliBénéf
CliBén
N ou F = Non (Vide = Non)
O ou V = Oui
5

CliCodeCatégorie
CliCat

Code de catégorie existant
255
[*], [+]
CliCodePostal
CliCP


15

CliCodeSecteur
CliSec
CliSecteur
Code secteur existant
15
[*]
CliCommentaires
CliCom


5000
[+]
CliCompagnie
CliCie


100

CliCompagnieSuite
CliCieSuite


100

CliCourriel
CliE-Mail
CliEmail

100

CliDateDécès



10
2
CliDateNaissance
CliNais


10
2
CliDateInscription
CliDateInsc


10
2
CliDécédé


N ou F = Non (Vide = Non)
O ou V = Oui
1

CliExclurePublipostage
CliExclure
CliExcl
N ou F = Non (Vide = Non)
O ou V = Oui
1
3
CliGenre


M = Masculin
F = Féminin
Vide = Selon appellation (Monsieur = Masculin / Madame = Fémin)
1

CliInactif


N ou F = Non (Vide = Non)
O ou V = Oui
1
4
CliLangue


Code langue existant
2

CliNePasSuggerer


N ou F = Non (Vide = Non)
O ou V = Oui
1

CliNePlusTéléphoner


N ou F = Non (Vide = Non)
O ou V = Oui
1

CliNom



100

CliParticule
CliPart


15

CliSuffixe



50

CliPays



40

CliPrénom
CliPré


100

CliProvince
CliProv
CliPro

25

CliRaisonExclusion
CliRaison


100
5
CliReçuAnnuel
CliReçuA

N ou F = Non (Vide = Non)
O ou V = Oui
1

CliReçuStatut
CliReçuS

J = Jamais de reçu pour ce client
Vide = Non
1

CliSiteInternet
CliWeb


100

CliSolliciteurCode
CliSolCode

Code solliciteur existant
15
6
CliSolliciteurNom
CliSolNom

Prénom Nom d'un solliciteur existant
N.B. Il n'est pas recommandé d'utiliser ce champ.
Problème connu si plusieurs solliciteurs existant identiques.
15
6
CliEstUnSolliciteur
CliEstUnSol

N ou F = Non (Vide = Non)
O ou V = Oui
1
7
CliSolliciteurCodePerso
CliSolCodePerso


25
7
CliSolliciteurActifDepuis
CliSolDateActif


10
2, 7
CliSolliciteurInactif
CliSolInactif

N ou F = Non (Vide = Non)
O ou V = Oui
1
7
CliSolliciteurInactifDepuis
CliSolDateInactif


10
2, 7
CliTéléavertisseur
CliPaget


25

CliTélécopieur
CliFax


25

CliTéléphoneBureau
CliBur


25

CliTéléphoneBureauPoste
CliBurPoste


10

CliTéléphoneCellulaire
CliCell


25

CliTéléphoneRésidence
CliRés


25

CliTitre



150

CliVille



50

CliLibelléDeLaCaractéristique


Variable
Variable
8
CliLibelléDuChampPersonnalisé


Variable
Variable
8
EnvActProvenance


Provenance existante
100
11
EnvCodeActivité
EnvAct
EnvActivité
Code d'activité existant
15
[*], 10
EnvCodeOccasion
EnvOcc
EnvOccasion
Code d'occasion existant
15
[*]
EnvDateInsc



10
2
EnvDescActivité



100
10
EnvDescOccasion



100

EnvRéponse
EnvRép

Réponse de sollicitation existante
100

[+] : Si le code [+] est ajouté à la fin du libellé, l'information importée sera ajoutée à l'information déjà présente dans la base de données. Dans le cas contraire, l'information importée, remplacera l'information déjà présente.

[*] : Si le code [*] est ajouté à la fin du libellé, le code sera créé s'il n'existe pas déjà.

1 : Pour utiliser ce champ, vous devez sélectionner l'option « Utiliser le pavé d'adresse » plutôt que l'importation d'adresse standard.

2 : Le format de date est dicté par le format choisi dans les options d'importations. Les caractères en trop par rapport à la longueur maximale seront ignorés.

3 : La date d'exclusion du publipostage est systématiquement la date du jour.

4 : Si la colonne « CliInactif » existe, la valeur quelle contient est toujours appliquée. Si la colonne est inexistante, le client sera inactif si le client à une date de décès ou si la colonne « CliDécédé » contient « O » ou « V ».

5 : Cette valeur sera traitée seulement si le client est exclu du publipostage.

6 : Permet de définir le solliciteur attribué au client. Attention de ne pas confondre avec 7.

7 : Permet de définir les information d'un client qui est solliciteur. Attention de ne pas confondre avec 6.

8 : Pour les valeurs personnalisées ou les caractéristiques, il faut indiquer le libellé défini dans ProDon précédé du préfixe « Cli », en ne conservant que les lettres et les chiffres. Par exemple, un champ nommé % d'individus deviendrait CliDIndividus.

Variables
Type
Valeurs possibles
Longeur maximale
Numérique
Chiffre uniquement

Texte

255
Date et heure
Format de date tel que specifié dans les options d'importation
10
Vrai/Faux
N ou F = Non (Vide = Non)
O ou V = Oui
1
Liste de choix
Si la valeur Nexiste pas déjà, elle sera automatiquement ajoutée à la liste
250
Liste de choix prédéfinie
Choix existant dans ProDon
250

Pour ajouter une note, une date de début ou de fin à une caractéristique par une importation, il faut ajouter un suffixe approprié.  Les suffixes sont _note, _début et _fin. Par exemple : CliDIndividus_note.  La note peut contenir jusqu'à 255 charactères, et les dates doivent correspondre au format spécifié dans les options d'importation.  Ces informations sont ignorées si la colonne de base ne contient pas de valeurs (ie CliDIndividus serait vide).  Pour pourvoir utiliser les date de début et fin, il faut aussi que les cases correspondante soient cochées dans la configuration de la caractéristique.

Si la caractérisitue le permet, il est possible d'importer plusieurs valeurs en utilisant le suffixe -1, -2 à la toute fin du libellé.  Par exemple : CliDIndividus_note-1.


10 : Ce champ requiert la présence du champ similaire en Occasion.

11 : Utile seulement si vous utilisez l'option « Créer les activités inexistantes ». Il est impossible d'avoir plus d'une provenance pour un code d'activité donné.


Liste des champs contacts

Champs obligatoires pour la création de contacts

ConOpération

ET

ConLien


Libellé complet Abrégé 1 Abrégé 2 Valeurs possibles Longeur maximale Particularité
NoContact

Numéro de contact existant
10
1
ConNom



100

ConPrenom
ConPre


100

ConTéléphoneRésidence ConRés

25
ConTéléphoneBureau ConBur

25
ConTéléphoneBureauPoste ConBurPoste

10
ConTélécopieur ConFax

25
ConTéléphoneCellulaire ConCell

25
ConTéléavertisseur ConPaget

25
ConCourriel ConE-mail ConEmail
100
ConSiteInternet ConWeb

100
ConDateNaissance ConNais

10 2
ConAppellation ConApp

50
ConTitre


255
ConGenre


M = Masculin
F = Féminin
Vide = Selon appellation (Monsieur = Masculin / Madame = Fémin)
1

ConCommentaires
ConCom


5000
[+]
ConOrdre


Entre 1 et 10 chiffre
10
3
ConOpération


A = Ajouter un contact
M = Modifier un contact existant
D = Détruire un contact existant
1

ConLien


Code de type de lien existant
25

ConLienInverse


N ou F = Non (Vide = Non)
O ou V = Oui
1

ConDateDebut



10
2
ConDateFin



10
2

[+] : Si le code [+] est ajouté à la fin du libellé, l'information importée sera ajoutée à l'information déjà présente dans la base de données. Dans le cas contraire, l'information importée, remplacera l'information déjà présente.

1 : Champ obligatoire sauf si on ajoute un nouveau contact. En lien avec ConOpération.

2 : Le format de date est dicté par le format choisi dans les options d'importations. Les caractères en trop par rapport à la longueur maximale seront ignorés.

3 : Le comportement de cette valeur est dictée par l'opération indiquée dans ConOpération.

En destruction, l'ordre est inutile. Sinon, une procédure détermine le numéro à utiliser afin d'éviter des incohérences.

En modification, le contact se verra attribuer l'ordre spécifié dans la colonne. Si la colonne est vide ou inexistante, le contact gardera son ordre actuel.

En ajout, le contact se verra attribuer l'ordre spécifié dans la colonne. Si la colonne est vide ou inexistante, le contact se verra attribuer l'ordre 0.

Pour déterminer quel client obtiendra un ordre plutôt qu'un autre ayant le même numéro d'ordre, ProDon utilisera la séquence suivante :

  1. Les contacts ayant déjà un ordre plus grand que 0 sont attribués en premier.
  2. Si deux contacts obtiennent le même numéro d'ordre, le contact le plus récent conservera son numéro d'ordre.
  3. Les contacts ayant un ordre 0 obtiendront leur ordre en dernier.

Liste des champs liens

Champs obligatoires pour la création de liens

NUC2 OU NoRéférence2

ET

LienOpération

Libellé complet Abrégé 1 Abrégé 2 Valeurs possibles Longeur maximale Particularité
NUC2 NoClient2
NoCli2
NUC existant du client à lier
7

NoRéférence2
Réf2
NoRéf2
Numéro de référence existant du client à lier
25

LienOpération


A = Ajouter
D = Détruire
I = Ignorer
1

Lien


Code de type de lien existant
25

LienInverse


N ou F = Non (Vide = Non)
O ou V = Oui
1

LienType


L = Lien (Vide = Lien)
C = Contact
1

LienDateDébut



10
1
LienDateFin


10 1
LienNote


5000

1 : Le format de date est dicté par le format choisi dans les options d'importations. Les caractères en trop par rapport à la longueur maximale seront ignorés.

Module d'importation de transaction

Le module d'importation de transaction, lorsqu'il est utilisé seul, sert à créer des transactions pour des clients déjà existant dans ProDon et nécessite l'utilisation du champ ou NUC ou NoRéférence pour faire le lien entre le client et la transaction à créer.  Si vous possédez le module d'importation client, il est possible de remplacer le champ NUC ou NoRéférence par une série de champ client.  Ceci permettera de trouver le client s'il existe déjà ou de le créer dans le cas contraire.


L'importation de reçus est possible uniquement vers des transactions déjà existante dans ProDonAttention : si vous importez un reçu vers une transaction qui en possède déjà un, votre importation écrasera le reçu déjà existant.


Champs obligatoire pour la création de transactions

(NUC ou NoRéférence) OU (((CliPrénom et Clinom) ou CliCompagnie) ET (Cliadresse et CliCodePostal))
ET
TrxCodeOccasion
ET
TrxCodeActivité (si indiqué comme obligatoire dans l’occasion choisie)
ET
TrxCodeGL (si indiqué comme obligatoire dans l’activité ET qu’aucun compte n’est choisi dans l’activité)
ET
TrxMontantDon OU TrxQuantité
ET
TrxModePaiement ET champs reliés si paiement électronique (no carte/no compte/clé RIB etc.)
ET
TrxLibelléCaractéristique si caractéristique obligatoire dans transactions


Champs obligatoire pour la création de reçus

RecNoTrx

ET

RecNoReçu

Liste des champs transactions

Liste des champs reçus

Module d'importation d'engagement

Le module d'importation d'engagement, lorsqu'il est utilisé seul, sert à créer des engagements pour des clients déjà existant dans ProDon et nécessite l'utilisation du champ ou NUC ou NoRéférence pour faire le lien entre le client et l'engagement à créer. Si vous possédez le module d'importation client, il est possible de remplacer le champ NUC ou NoRéférence par une série de champ client. Ceci permettera de trouver le client s'il existe déjà ou de le créer dans le cas contraire.


Champs obligatoires pour la création d'un engagement de type « Objectif »

(NUC ou NoRéférence) OU (((CliPrénom et Clinom) OU CliCompagnie) ET (Cliadresse et CliCodePostal))
ET
EngType
ET
EngLibelléCaractéristique si caractéristique obligatoire dans les engagements

Champs obligatoires pour la création d'un engagement de type « Automatique »

(NUC ou NoRéférence) OU (((CliPrénom et Clinom) OU CliCompagnie) ET (Cliadresse et CliCodePostal))
ET
EngOccasion
ET
EngActivité (si indiqué comme obligatoire dans l’occasion choisie)
ET
EngCodeGL (si indiqué comme obligatoire dans l’activité ET qu’aucun compte n’est choisi dans l’activité)
ET
EngModePaiement
ET
EngLibelléCaractérisitque si caractéristique obligatoire dans engagements

Liste des champs engagements

Configuration et processus général d'importation

Utilitaire d'importation automatique

L’utilitaire d’importation automatique est un programme console qu’on appelle à partir d’une tâche planifiée Windows. Vous pouvez vous procurer l’utilitaire d’importation automatique en communiquant avec Logilys.  Lors de l'installation de ce programme, vous devrez configurer certaines information une première fois avant de planifier la tâche windows.  Ensuite vous pourre planifier votre tâche avec les paramètres suivants.

Voici les paramètres d’appel pour l’utilisation :


On doit premièrement spécifier le chemin de l’exécutable qui doit être dans le même répertoire que le fichier « ProDon.exe ».
Exemple : C:\Logilys\ProDon\ImportAuto.Exe [paramètre]


/n=15
Ce paramètre est obligatoire

« 15 » réprésente une variable qui correspond à un numéro d'importation configuré au préalable dans ProDon.


/o=2
« 2 » représente une variable qui correspond au numéro de l’organisme tel que défini dans ProDon.
Si ce paramètre est absent, l’organisme 1 sera utilisé.


/u=SUPERVISEUR
« SUPERVISEUR » représente une variable qui correspond au code de l’utilisateur ProDon qui sera utilisé pour l’importation
Si ce paramètre est absent, le code SUPERVISEUR sera utilisé


/c= "C:\Logilys\ProDon\Importation\Importation.csv"
Permet de spécifier l'emplacement du fichier à charger dans le module.
Si ce paramètre n’est pas là aucun chargement ne sera exécuté et le chargement de l'importation spécifié par « /n » doit avoir été exécuté manuellement au préalable.
Les guillemets anglais sont utilisés pour encadrer le nom du fichier afin que les espaces soient bien reconnus.


/i
Si ce paramètre est présent et que le paramètre /c n’est pas présent, on utilisera le fichier spécifié dans l’importation de ProDon
Si ce paramètre n’est pas présent, l’importation n’aura pas lieu


/d
Si ce paramètre est présent, le fichier utilisé pour le chargement ou l'importation sera détruit.