ProDon:Modules d'importation : Différence entre versions

De Logilys
Aller à : navigation, rechercher
m
 
(46 révisions intermédiaires par 4 utilisateurs non affichées)
Ligne 1 : Ligne 1 :
{{Entete_ProDon|21|4.5.0.7|Louis-Sébastien Garneau|Jessy Fontaine|2010/05/20}}  
+
{{Entete_TOC}}
 +
Cette documentation nécessite le module « Importation » de Prodon, il faut donc posséder ce module pour avoir accès à ces fonctionnalités.<br>
  
== Explications générales<br> ==
+
== Explications générales<br> ==
  
 
Les modules sont tous regroupés en un même endroit. Vous avez la possibilité d’analyser vos données '''avant''' de confirmer l’importation pour détecter toutes les erreurs qui pourraient s’y être glissées.&nbsp;Les modules sont indépendants; en conséquence, vous aurez uniquement accès&nbsp;aux fonctionnalités relatives au(x) module(s) que vous possédez.<br><br>Généralement, l'importation est faite depuis un fichier '''''Excel''''' sauvegardé en utilisant le type de fichier «&nbsp;CSV&nbsp;».&nbsp;Ce type de fichier utilise le «&nbsp;;&nbsp;» pour délimiter les informations à l'intérieur du fichier, il faut donc s'assurer que les données elles-mêmes ne comportent pas cette ponctuation.&nbsp;Le format «&nbsp;txt&nbsp;» est disponible, mais vous devrez alors 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.  
 
Les modules sont tous regroupés en un même endroit. Vous avez la possibilité d’analyser vos données '''avant''' de confirmer l’importation pour détecter toutes les erreurs qui pourraient s’y être glissées.&nbsp;Les modules sont indépendants; en conséquence, vous aurez uniquement accès&nbsp;aux fonctionnalités relatives au(x) module(s) que vous possédez.<br><br>Généralement, l'importation est faite depuis un fichier '''''Excel''''' sauvegardé en utilisant le type de fichier «&nbsp;CSV&nbsp;».&nbsp;Ce type de fichier utilise le «&nbsp;;&nbsp;» pour délimiter les informations à l'intérieur du fichier, il faut donc s'assurer que les données elles-mêmes ne comportent pas cette ponctuation.&nbsp;Le format «&nbsp;txt&nbsp;» est disponible, mais vous devrez alors 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.  
  
<br>
+
<br>  
  
 
La première ligne du fichier sert d'entête de colonne et, pour faciliter le processus, devrait correspondre aux libellés ou abrégés indiqués dans les sections pertinentes.  
 
La première ligne du fichier sert d'entête de colonne et, pour faciliter le processus, devrait correspondre aux libellés ou abrégés indiqués dans les sections pertinentes.  
  
<br>
+
<br>  
  
 
Les libellés ne sont pas sensibles à la casse ni aux caractères accentués, à l'exception de la cédille.  
 
Les libellés ne sont pas sensibles à la casse ni aux caractères accentués, à l'exception de la cédille.  
  
<br>
+
<br>  
  
 
L'information dans la colonne particularité est cliquable et redirige vers une explication.  
 
L'information dans la colonne particularité est cliquable et redirige vers une explication.  
  
<br>
+
<br>  
  
Les champs obligatoires pour chaque forme d'importation sont indiqués au-dessus de la liste correspondante des listes de champs.<br>
+
Les champs obligatoires pour chaque forme d'importation sont indiqués dans la section correspondante.<br>  
  
 
== Liste des champs communs à tous les modules  ==
 
== Liste des champs communs à tous les modules  ==
Ligne 25 : Ligne 26 :
 
Les champs communs sont principalement utilisés pour faire le lien entre un fichier que vous désirez importer et votre base de données.&nbsp;S'il y a de l'information dans les 2 champs, le NUC sera prioritaire.  
 
Les champs communs sont principalement utilisés pour faire le lien entre un fichier que vous désirez importer et votre base de données.&nbsp;S'il y a de l'information dans les 2 champs, le NUC sera prioritaire.  
  
{| class="wikitable sortable" border="1" cellspacing="1" cellpadding="1" width="100%"
+
{| width="100%" cellspacing="1" cellpadding="1" border="1" class="wikitable sortable"
 
|-
 
|-
 
! scope="col" | Libellé complet  
 
! scope="col" | Libellé complet  
Ligne 31 : Ligne 32 :
 
! scope="col" | Abrégé 2  
 
! scope="col" | Abrégé 2  
 
! scope="col" | Valeurs possibles  
 
! scope="col" | Valeurs possibles  
! width="75" scope="col" align="center" | Longeur maximale  
+
! width="75" align="center" scope="col" | Longeur maximale  
 
! width="90" scope="col" | Particularité
 
! width="90" scope="col" | Particularité
 
|-
 
|-
Ligne 38 : Ligne 39 :
 
| NoCli  
 
| NoCli  
 
| Numéro de client existant  
 
| Numéro de client existant  
| style="text-align: center" | 7  
+
| style="text-align: center;" | 7  
 
| align="center" | <br>
 
| align="center" | <br>
 
|-
 
|-
Ligne 44 : Ligne 45 :
 
| Réf  
 
| Réf  
 
| NoRéf  
 
| NoRéf  
| <br>
+
| <br>  
| style="text-align: center" | 25  
+
| style="text-align: center;" | 25  
 
| align="center" | <br>
 
| align="center" | <br>
 
|}
 
|}
  
<br>
+
<br>  
  
 
== Module d'importation et mise à jour client  ==
 
== Module d'importation et mise à jour client  ==
Ligne 79 : Ligne 80 :
 
CliCodePostal  
 
CliCodePostal  
  
 
+
<br>
  
 
==== Champs obligatoires pour la création de contacts <br>  ====
 
==== Champs obligatoires pour la création de contacts <br>  ====
Ligne 89 : Ligne 90 :
 
ConLien  
 
ConLien  
  
 +
<br>
  
 
+
==== Champs obligatoires pour la création de liens  ====
=== Champs obligatoires pour la création de liens  ===
 
  
 
NUC2 '''OU''' NoRéférence2  
 
NUC2 '''OU''' NoRéférence2  
Ligne 103 : Ligne 104 :
 
Lien  
 
Lien  
  
'''<br>'''
+
'''<br>'''  
 
 
Vous pouvez consultez la liste complète des champs [[ProDon:Module_d'importation_clients#Liste_des_champs_clients|clients]], [[ProDon:Module_d'importation_clients#Liste_des_champs_contacts|contacts]] et [[ProDon:Module_d'importation_clients#Liste_des_champs_liens|liens]], ainsi que leurs particularités. <br>
 
 
 
== Module d'importation de transaction  ==
 
 
 
Lorsqu'il est utilisé seul, le module d'importation de transaction sert à créer des transactions pour des clients déjà existants 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.&nbsp;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 champs client.&nbsp; Ceci permettera de trouver le client s'il existe déjà ou de le créer dans le cas contraire.<br><br>L'importation de reçus est possible uniquement vers des transactions déjà existantes dans&nbsp;'''''ProDon'''''.&nbsp; '''Attention&nbsp;:&nbsp;'''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.<br>
 
 
 
=== Liste des champs transactions  ===
 
 
 
==== Champs obligatoires pour la création de transactions<br> ====
 
 
 
(NUC ou NoRéférence) '''OU''' (((CliPrénom et Clinom) ou CliCompagnie) '''ET''' (Cliadresse et CliCodePostal))<br>'''ET'''<br>TrxCodeOccasion<br>'''ET'''<br>TrxCodeActivité (si indiqué comme obligatoire dans l’occasion choisie)<br>'''ET'''<br>TrxCodeGL (si indiqué comme obligatoire dans l’activité '''ET''' qu’aucun compte n’est choisi dans l’activité)<br>'''ET'''<br>TrxMontantDon '''OU '''TrxQuantité<br>'''ET'''<br>TrxModePaiement '''ET''' champs reliés si paiement électronique (no carte/no compte/clé RIB etc.)<br>'''ET'''<br>TrxLibelléCaractéristique si caractéristique obligatoire dans transactions
 
  
<br>
+
==== Liste complète des champs clients, contacts et liens  ====
  
{| class="wikitable sortable" border="1" cellspacing="1" cellpadding="1" width="100%"
+
{| width="480" cellspacing="1" cellpadding="1" border="1" class="wikitable"
|-
 
! scope="col" | Libellé complet
 
! scope="col" | Abrégé 1  
 
! scope="col" | Abrégé 2
 
! scope="col" | Valeurs possibles
 
! width="75" scope="col" align="center" | Longeur maximale
 
! width="90" scope="col" | Particularité
 
|-
 
| TrxDateDon
 
| TrxDate<br>
 
| <br>
 
| '''Date'''<br>'''Vide''' = Date du jour
 
| style="text-align: center" | 10<br>
 
| align="center" | [[#1trx|1]]<br>
 
|-
 
| TrxCodeOccasion
 
| TrxOcc<br>
 
| TrxOccasion<br>
 
| '''Code''' d'occasion existant<br>
 
| style="text-align: center" | 15<br>
 
| align="center" | <br>
 
|-
 
| TrxCodeActivité
 
| TrxAct<br>
 
| TrxActivité<br>
 
| '''Code''' d'activité existant<br>
 
| style="text-align: center" | 15<br>
 
| align="center" | [[#2trx|2]]<br>
 
|-
 
| TrxActProvenance
 
| <br>
 
| <br>
 
| '''Provenance''' existante<br>
 
| style="text-align: center" | 100<br>
 
| align="center" | [[#3trx|3]]<br>
 
|-
 
| TrxCodeGL
 
| TrxGL<br>
 
| <br>
 
| '''Vide''' = Valeur par défaut de l'activité<br>'''Compte''' de GL existant
 
| style="text-align: center" | 15<br>
 
| align="center" | [[#etoiletrx|[*]]]<br>
 
|-
 
| TrxExpiration
 
| <br>
 
| <br>
 
| '''MM/AA ou MM/AAAA<br>'''Barre oblique obligatoire<br>
 
| style="text-align: center" | 5 ou 7<br>
 
| align="center" | <br>
 
|-
 
| TrxQuantité
 
| TrxQté<br>
 
| <br>
 
| '''Nombre entier'''<br>
 
| style="text-align: center" | 6<br>
 
| align="center" | [[#4trx|4]]<br>
 
|-
 
| TrxMontantDon
 
| TrxDon<br>
 
| <br>
 
| '''Format monétaire'''<br>Sans séparateur de millier
 
| style="text-align: center" | 15<br>
 
| align="center" | [[#4trx|4]]<br>
 
|-
 
| TrxModePaiement
 
| TrxPai<br>
 
| TrxPaiement<br>
 
| '''Code''' de paiement existant<br>
 
| style="text-align: center" | 15<br>
 
| align="center" | <br>
 
|-
 
| TrxRéférencePaiement
 
| TrxRefPai<br>
 
| <br>
 
| <br>
 
| style="text-align: center" | 255<br>
 
| align="center" | <br>
 
|-
 
| TrxBiens
 
| <br>
 
| <br>
 
| <br>
 
| style="text-align: center" | 100<br>
 
| align="center" | [[#5trx|5]]<br>
 
|-
 
| TrxEvaluateurs
 
| <br>
 
| <br>
 
| <br>
 
| style="text-align: center" | 255<br>
 
| align="center" | [[#5trx|5]]<br>
 
|-
 
| TrxTransit
 
| <br>
 
| <br>
 
| '''Nombre entier'''<br>
 
| style="text-align: center" | 10<br>
 
| align="center" | [[#6trx|6]]<br>
 
|-
 
| TrxNoInstitution
 
| <br>
 
| <br>
 
| '''Nombre entier'''<br>
 
| style="text-align: center" | 10<br>
 
| align="center" | [[#6trx|6]]<br>
 
|-
 
| TrxNomInstitution
 
| <br>
 
| <br>
 
| <br>
 
| style="text-align: center" | 255<br>
 
| align="center" | <br>
 
|-
 
| TrxNoCarteCredit
 
| <br>
 
| <br>
 
| '''Nombre entier'''<br>
 
| style="text-align: center" | 30<br>
 
| align="center" | [[#6trx|6]]<br>
 
|-
 
| TrxNoCompte
 
| <br>
 
| <br>
 
| '''Nombre entier'''<br>
 
| style="text-align: center" | 20<br>
 
| align="center" | [[#6trx|6]]<br>
 
|-
 
| TrxCleRIB
 
| <br>
 
| <br>
 
| '''Nombre entier'''<br>
 
| style="text-align: center" | 2<br>
 
| align="center" | [[#7trx|7]]<br>
 
|-
 
| TrxReçuStatut<br>
 
| TrxReçuS<br>
 
| <br>
 
| '''N''' ou '''F''' = Aucun<br>'''O''' ou '''V''' = À émettre<br>'''C''' = À calculer<br>'''Vide''' = Selon l'activité
 
| style="text-align: center" | 1<br>
 
| align="center" | <br>
 
|-
 
| TrxReçuMontant<br>
 
| TrxReçuM<br>
 
| <br>
 
| '''Format monétaire'''<br>'''Vide''' =&nbsp;Selon l'activité et transaction<br>
 
| style="text-align: center" | 15<br>
 
| align="center" | <br>
 
|-
 
| TrxReçuAnnuel<br>
 
| TrxReçuA<br>
 
| <br>
 
| '''N''' ou '''F''' ou '''Vide''' = Non<br>'''O''' ou '''V''' = Oui
 
| style="text-align: center" | 1<br>
 
| align="center" | <br>
 
 
|-
 
|-
| TrxNote<br>
+
! scope="col" | Vous pouvez consulter la liste complète des champs clients, contacts et liens, ainsi que leurs particularités.
| <br>
 
| <br>
 
| <br>
 
| style="text-align: center" | 255<br>
 
| align="center" | [[#plustrx|[+]]]<br>
 
 
|-
 
|-
| TrxSolliciteurCode<br>
+
| [[ProDon:Module d'importation clients#Liste_des_champs_clients|Clients]]
| TrxSolCode<br>
 
| <br>
 
| '''Code''' solliciteur existant<br>
 
| style="text-align: center" | 255<br>
 
| align="center" | <br>
 
 
|-
 
|-
| TrxSolliciteurNom<br>
+
| [[ProDon:Module d'importation clients#Liste_des_champs_contacts|Contacts]]
| TrxSolNom<br>
 
| <br>
 
| '''Prénom Nom''' d'un solliciteur existant<br>'''N.B. '''Il n'est pas recommandé d'utiliser ce champ.<br>Problème connu si plusieurs solliciteurs existants identiques.<br>
 
| style="text-align: center" | 200<br>
 
| align="center" | <br>
 
 
|-
 
|-
| TrxTiersNUC<br>
+
| [[ProDon:Module d'importation clients#Liste_des_champs_liens|Liens]]
| <br>
 
| <br>
 
| '''Numéro''' de client existant<br>
 
| style="text-align: center" | 7<br>
 
| align="center" | <br>
 
|-
 
| TrxTiersNoRef<br>
 
| <br>
 
| <br>
 
| <br>
 
| style="text-align: center" | 25<br>
 
| align="center" | [[#8trx|8]]<br>
 
|-
 
| TrxAnonyme<br>
 
| TrxAnony<br>
 
| TrxAno<br>
 
| '''N''' ou '''F''' ou '''Vide''' = Non<br>'''O''' ou '''V''' = Oui
 
| style="text-align: center" | 1<br>
 
| align="center" | <br>
 
|-
 
| TrxLibellé de la caractéristique<br>
 
| <br>
 
| <br>
 
| Variable<br>
 
| style="text-align: center" | Variable<br>
 
| align="center" | [[#9trx|9]]<br>
 
|-
 
| TrxLibellé du champ personnalisé<br>
 
| <br>
 
| <br>
 
| Variable<br>
 
| style="text-align: center" | Variable<br>
 
| align="center" | [[#9trx|9]]<br>
 
 
|}
 
|}
  
'''{{Anchor|[+]|plustrx}}'''&nbsp;: 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.
+
== Module d'importation de transaction  ==
 
 
'''{{Anchor|[*]|etoiletrx}}'''&nbsp;: Si le code [*] est ajouté à la fin du libellé, le code sera créé s'il n'existe pas déjà.
 
 
 
'''{{Anchor|1|1trx}}'''&nbsp;: Le format de date est dicté par le format choisi dans les options d'importation. Les caractères en trop par rapport à la longueur maximale seront ignorés.
 
  
'''{{Anchor|2|2trx}}'''&nbsp;: Ce champ requiert la présence du champ similaire en Occasion.  
+
Lorsqu'il est utilisé seul, le module d'importation de transaction sert à créer des transactions pour des clients déjà existants 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.&nbsp;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 champs client.&nbsp; Ceci permettra de trouver le client s'il existe déjà ou de le créer dans le cas contraire.<br><br>L'importation de reçus est possible uniquement vers des transactions déjà existantes dans&nbsp;'''''ProDon'''''.&nbsp; '''Attention&nbsp;:&nbsp;'''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.<br>
  
'''{{Anchor|3|3trx}}'''&nbsp;: Utile seulement si vous utilisez l'option «&nbsp;Créer les activités inexistantes&nbsp;». Il est impossible d'avoir plus d'une provenance pour un code d'activité donné.
+
==== Champs obligatoires pour la création de transactions<br>  ====
  
'''{{Anchor|4|4trx}}'''&nbsp;: Si l'activité de la transaction est par «&nbsp;prix de vente&nbsp;», on doit entrer une quantité ou un montant de don.
+
(NUC ou NoRéférence) '''OU''' (((CliPrénom et Clinom) ou CliCompagnie) '''ET''' (Cliadresse et CliCodePostal))<br>'''ET'''<br>TrxCodeOccasion<br>'''ET'''<br>TrxCodeActivité (si indiqué comme obligatoire dans l’occasion choisie)<br>'''ET'''<br>TrxCodeGL (si indiqué comme obligatoire dans l’activité '''ET''' qu’aucun compte n’est choisi dans l’activité)<br>'''ET'''<br>TrxMontantDon '''OU '''TrxQuantité<br>'''ET'''<br>TrxModePaiement '''ET''' champs reliés si paiement électronique (no carte/no compte/clé RIB etc.)<br>'''ET'''<br>TrxLibelléCaractéristique si caractéristique obligatoire dans transactions <br>  
 
 
'''{{Anchor|5|5trx}}'''&nbsp;: Obligatoire si le mode de paiement utilisé est de type «&nbsp;Don en nature&nbsp;».
 
 
 
'''{{Anchor|6|6trx}}'''&nbsp;: Le champ doit contenir au moins 1 caractère et un maximum de&nbsp;? caractères. La longueur maximale est définie dans la «&nbsp;Configuration des paiements électroniques&nbsp;».
 
 
 
'''{{Anchor|7|7trx}}'''&nbsp;: Ce champ est obligatoire si les 3 autres champs liés à la validation RIB sont utilisés.
 
 
 
'''{{Anchor|8|8trx}}'''&nbsp;: Cette colonne est ignorée si la colonne TrxTiersNuc existe.
 
 
 
'''{{Anchor|9|9trx}}'''&nbsp;: Pour les valeurs personnalisées ou les caractéristiques, il faut indiquer le libellé défini dans ProDon, précédé du préfixe «&nbsp;Trx&nbsp;», en ne conservant que les lettres et les chiffres. Par exemple, un champ nommé&nbsp;% d'individus deviendrait TrxDIndividus.<br>
 
 
 
{| class="wikitable" border="1" cellspacing="1" cellpadding="1" width="635"
 
|+ Variables
 
|-
 
! scope="col" | Type<br>
 
! scope="col" | Valeurs possibles<br>
 
! scope="col" | Longeur maximale<br>
 
|-
 
| Numérique<br>
 
| Chiffre uniquement<br>
 
| <br>
 
|-
 
| Texte<br>
 
| <br>
 
| 255<br>
 
|-
 
| Date et heure<br>
 
| Format de date tel que specifié dans les options d'importation<br>
 
| 10<br>
 
|-
 
| Vrai/Faux<br>
 
| '''N''' ou '''F''' = Non ('''Vide''' = Non)<br>'''O''' ou '''V''' = Oui<br>
 
| 1<br>
 
|-
 
| Liste de choix<br>
 
| Si la valeur n'existe pas déjà, elle sera automatiquement ajoutée à la liste<br>
 
| 250<br>
 
|-
 
| Liste de choix prédéfinie<br>
 
| Choix existant dans '''''ProDon'''''<br>
 
| 250<br>
 
|}
 
 
 
Pour ajouter une note, une date de début ou de fin à une caractéristique par une importation, il faut ajouter un suffixe approprié.&nbsp;Les suffixes sont&nbsp;:&nbsp;_note, _début et _fin. Par exemple&nbsp;:&nbsp;TrxDIndividus_note. La note peut contenir jusqu'à 255 caractères et les dates doivent correspondre au format spécifié dans les options d'importation.&nbsp;Ces informations sont ignorées si la colonne de base ne contient pas de valeurs&nbsp;(ie TrxDIndividus serait vide).&nbsp;Pour pouvoir utiliser les dates de début et fin, il faut aussi que les cases correspondantes soient cochées dans la configuration de la caractéristique.
 
 
 
Si la caractéristique le permet, il est possible d'importer plusieurs valeurs en utilisant le suffixe -1, -2 à la toute fin du libellé.&nbsp;Par exemple&nbsp;:&nbsp;TrxDIndividus_note-1. <br>
 
 
 
=== Liste des champs reçus  ===
 
  
 
==== Champs obligatoires pour la création de reçus  ====
 
==== Champs obligatoires pour la création de reçus  ====
Ligne 400 : Ligne 135 :
 
RecNoReçu  
 
RecNoReçu  
  
{| class="wikitable sortable" border="1" cellspacing="1" cellpadding="1" width="100%"
+
<br>
|-
+
 
! scope="col" | Libellé complet
+
==== Liste complète des champs transactions et reçus  ====
! scope="col" | Abrégé 1
+
 
! scope="col" | Abrégé 2
+
{| width="480" cellspacing="1" cellpadding="1" border="1" class="wikitable"
! scope="col" | Valeurs possibles
 
! width="75" scope="col" align="center" | Longeur maximale
 
! width="90" scope="col" | Particularité
 
 
|-
 
|-
| RecNoTrx
+
! scope="col" | Vous pouvez consulter la liste complète des champs transactions et reçus, ainsi que leurs particularités.
| <br>
 
| <br>
 
| Numéro de transaction existant<br>
 
| style="text-align: center" | 15<br>
 
| align="center" | <br>
 
 
|-
 
|-
| RecDateReçu
+
| [[ProDon:Module d'importation transactions#Liste_des_champs_transaction|Transactions]]
| <br>
 
| <br>
 
| '''Date<br>''''''Vide''' = Date du jour<br>
 
| style="text-align: center" | 10<br>
 
| align="center" | [[#1recu|1]]<br>
 
 
|-
 
|-
| RecNoReçu
+
| [[ProDon:Module d'importation transactions#Liste_des_champs_re.C3.A7us|Reçus]]
| <br>
 
| <br>
 
| Nombre entier<br>
 
| style="text-align: center" | 6<br>
 
| align="center" | <br>
 
|-
 
| RecMntReçu
 
| <br>
 
| <br>
 
| '''Format monétaire'''<br>'''Vide''' = Montant de la transaction<br>
 
| style="text-align: center" | 15<br>
 
| align="center" | <br>
 
 
|}
 
|}
  
'''{{Anchor|1|1recu}}'''&nbsp;: Le format de date est dicté par le format choisi dans les options d'importation. Les caractères en trop par rapport à la longueur maximale seront ignorés.
+
== Module d'importation d'engagement  ==
  
== Module d'importation d'engagement ==
+
Lorsqu'il est utilisé seul, le module d'importation d'engagement sert à créer des engagements pour des clients déjà existants 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 champs client. Ceci permettra de trouver le client s'il existe déjà ou de le créer dans le cas contraire.<br>
  
Lorsqu'il est utilisé seul, le module d'importation d'engagement sert à créer des engagements pour des clients déjà existants 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 champs client. Ceci permettera de trouver le client s'il existe déjà ou de le créer dans le cas contraire.<br>
+
<br>  
  
<br>
+
==== Champs obligatoires pour la création d'un engagement de type «&nbsp;Objectif&nbsp;»<br> ====
  
=== Liste des champs engagements ===
+
(NUC ou NoRéférence) '''OU''' (((CliPrénom et Clinom) OU CliCompagnie) '''ET '''(Cliadresse et CliCodePostal))<br>'''ET'''<br>EngType<br>'''ET'''<br>EngLibelléCaractéristique si caractéristique obligatoire dans les engagements<br><br>
  
==== Champs obligatoires pour la création d'un engagement de type «&nbsp;Objectif&nbsp;»<br> ====
+
==== Champs obligatoires pour la création d'un engagement de type «&nbsp;Automatique&nbsp;»<br> ====
  
(NUC ou NoRéférence) '''OU''' (((CliPrénom et Clinom) OU CliCompagnie) '''ET '''(Cliadresse et CliCodePostal))<br>'''ET'''<br>EngType<br>'''ET'''<br>EngLibelléCaractéristique si caractéristique obligatoire dans les engagements<br><br>
+
(NUC ou NoRéférence) '''OU''' (((CliPrénom et Clinom) OU CliCompagnie) '''ET''' (Cliadresse et CliCodePostal))<br>'''ET'''<br>EngOccasion<br>'''ET'''<br>EngActivité (si indiqué comme obligatoire dans l’occasion choisie)<br>'''ET'''<br>EngCodeGL (si indiqué comme obligatoire dans l’activité ET qu’aucun compte n’est choisi dans l’activité)<br>'''ET'''<br>EngModePaiement<br>'''ET'''<br>EngLibelléCaractérisitque si caractéristique obligatoire dans engagements
  
==== Champs obligatoires pour la création d'un engagement de type «&nbsp;Automatique&nbsp;»<br> ====
+
<br>  
  
(NUC ou NoRéférence) '''OU''' (((CliPrénom et Clinom) OU CliCompagnie) '''ET''' (Cliadresse et CliCodePostal))<br>'''ET'''<br>EngOccasion<br>'''ET'''<br>EngActivité (si indiqué comme obligatoire dans l’occasion choisie)<br>'''ET'''<br>EngCodeGL (si indiqué comme obligatoire dans l’activité ET qu’aucun compte n’est choisi dans l’activité)<br>'''ET'''<br>EngModePaiement<br>'''ET'''<br>EngLibelléCaractérisitque si caractéristique obligatoire dans engagements<br><br>
+
==== Liste complète des champs engagements ====
  
{| class="wikitable sortable" border="1" cellspacing="1" cellpadding="1" width="100%"
+
{| width="480" cellspacing="1" cellpadding="1" border="1" class="wikitable"
|-
 
! scope="col" | Libellé complet
 
! scope="col" | Abrégé 1  
 
! scope="col" | Abrégé 2
 
! scope="col" | Valeurs possibles
 
! width="75" scope="col" align="center" | Longeur maximale
 
! width="90" scope="col" | Particularité
 
|-
 
| EngDateInscription
 
| EngInsc<br>
 
| <br>
 
| '''Date'''<br>'''Vide''' = Date du jour
 
| style="text-align: center" | 10<br>
 
| align="center" | [[#1eng|1]]<br>
 
|-
 
| EngDateDébut<br>
 
| EngDébut<br>
 
| <br>
 
| '''Date'''<br>'''Vide '''= Date du jour
 
| style="text-align: center" | 10<br>
 
| align="center" | [[#1eng|1]]<br>
 
|-
 
| EngDateFin<br>
 
| EngFin<br>
 
| <br>
 
| '''Date'''<br>'''Vide''' = Date du jour
 
| style="text-align: center" | 10<br>
 
| align="center" | [[#1eng|1]]<br>
 
|-
 
| EngCommentaires<br>
 
| EngCom<br>
 
| <br>
 
| <br>
 
| style="text-align: center" | 255<br>
 
| align="center" | [[#pluseng|[+]]]<br>
 
|-
 
| EngType<br>
 
| <br>
 
| <br>
 
| '''O''' ou '''Vide''' = Objectif<br>'''A''' = Automatique
 
| style="text-align: center" | 1<br>
 
| align="center" | <br>
 
|-
 
| EngReçuAnnuel<br>
 
| EngReçuA<br>
 
| <br>
 
| '''N''' ou '''F''' ou '''Vide''' = Non<br>'''O''' ou '''V''' = Oui
 
| style="text-align: center" | 1<br>
 
| align="center" | <br>
 
|-
 
| EngCodeOccasion<br>
 
| EngOcc<br>
 
| EngOccasion<br>
 
| '''Code''' d'occasion existant<br>
 
| style="text-align: center" | 15<br>
 
| align="center" | <br>
 
|-
 
| EngCodeActivité<br>
 
| EngAct<br>
 
| EngActivite<br>
 
| '''Code''' d'activité existant<br>
 
| style="text-align: center" | 15<br>
 
| align="center" | [[#2eng|2]]<br>
 
|-
 
| EngActProvenance<br>
 
| <br>
 
| <br>
 
| '''Provenance''' existante<br>
 
| style="text-align: center" | 15<br>
 
| align="center" | [[#3eng|3]]<br>
 
|-
 
| EngCodeGL<br>
 
| EngGL<br>
 
| <br>
 
| '''Code''' de GL&nbsp;existant<br>
 
| style="text-align: center" | 15<br>
 
| align="center" | [[#etoileeng|[*]]]<br>
 
|-
 
| EngFréquence<br>
 
| EngFreq<br>
 
| <br>
 
| '''?S''' = À chaque&nbsp;? semaine<br>'''?M''' = À chaque&nbsp;? mois<br>'''?A''' = À chaque&nbsp;? année
 
| style="text-align: center" | 3<br>
 
| align="center" | <br>
 
|-
 
| EngVersement<br>
 
| EngVers<br>
 
| <br>
 
| '''Format monétaire'''<br>
 
| style="text-align: center" | 15<br>
 
| align="center" | <br>
 
|-
 
| EngModePaiement<br>
 
| EngPai<br>
 
| EngPaiement<br>
 
| '''Code''' de mode de paiement existant<br>
 
| style="text-align: center" | 15<br>
 
| align="center" | <br>
 
|-
 
| EngRéférencePaiement<br>
 
| EngRefPai<br>
 
| <br>
 
| <br>
 
| style="text-align: center" | 255<br>
 
| align="center" | <br>
 
|-
 
| EngTransit<br>
 
| <br>
 
| <br>
 
| '''Nombre entier'''<br>
 
| style="text-align: center" | 10<br>
 
| align="center" | [[#4eng|4]]<br>
 
|-
 
| EngNoInstitution<br>
 
| <br>
 
| <br>
 
| '''Nombre entier'''<br>
 
| style="text-align: center" | 10<br>
 
| align="center" | [[#4eng|4]]<br>
 
|-
 
| EngNomInstitution<br>
 
| <br>
 
| <br>
 
| <br>
 
| style="text-align: center" | 255<br>
 
| align="center" | <br>
 
|-
 
| EngNoCarteCredit<br>
 
| <br>
 
| <br>
 
| '''Nombre entier'''<br>
 
| style="text-align: center" | 30<br>
 
| align="center" | [[#4eng|4]]<br>
 
|-
 
| EngExpiration<br>
 
| <br>
 
| <br>
 
| '''MM/AA''' ou '''MM/AAAA'''<br>Barre oblique obligatoire
 
| style="text-align: center" | 5 ou 7<br>
 
| align="center" | <br>
 
|-
 
| EngNoCompte<br>
 
| <br>
 
| <br>
 
| '''Nombre entier'''<br>
 
| style="text-align: center" | 20<br>
 
| align="center" | [[#4eng|4]]<br>
 
|-
 
| EngCleRIB<br>
 
| <br>
 
| <br>
 
| '''Nombre entier'''<br>
 
| style="text-align: center" | 2<br>
 
| align="center" | [[#5eng|5]]<br>
 
 
|-
 
|-
| EngSolliciteurCode<br>
+
! scope="col" | Vous pouvez consulter la liste complète des champs engagements, ainsi que leurs particularités.
| EngSolCode<br>
 
| <br>
 
| '''Code''' solliciteur existant<br>
 
| style="text-align: center" | 25<br>
 
| align="center" | <br>
 
 
|-
 
|-
| EngSolliciteurNom<br>
+
| [[ProDon:Module d'importation engagements|Engagements]]
| EngSolNom<br>
 
| <br>
 
| '''Prénom Nom''' d'un solliciteur existant<br>'''N.B.''' Il n'est pas recommandé d'utiliser ce champ.<br>Problème connu si plusieurs solliciteurs existants identiques.<br>
 
| style="text-align: center" | 200<br>
 
| align="center" | <br>
 
|-
 
| EngObjectif<br>
 
| EngObj<br>
 
| <br>
 
| '''Format monétaire'''<br>
 
| style="text-align: center" | 15<br>
 
| align="center" | <br>
 
|-
 
| EngTerminerSiObjAtteint<br>
 
| <br>
 
| <br>
 
| '''N''' ou '''F''' ou '''Vide''' = Non<br>'''O''' ou '''V''' = Oui
 
| style="text-align: center" | 1<br>
 
| align="center" | [[#6eng|6]]<br>
 
 
|}
 
|}
 
'''{{Anchor|[+]|pluseng}}'''&nbsp;: 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.
 
 
'''{{Anchor|[*]|etoileeng}}'''&nbsp;: Si le code [*] est ajouté à la fin du libellé, le code sera créé s'il n'existe pas déjà.
 
 
'''{{Anchor|1|1eng}}'''&nbsp;: Le format de date est dicté par le format choisi dans les options d'importation. Les caractères en trop par rapport à la longueur maximale seront ignorés.
 
 
'''{{Anchor|2|2eng}}'''&nbsp;: Ce champ requiert la présence du champ similaire en Occasion.
 
 
'''{{Anchor|3|3eng}}'''&nbsp;: Utile seulement si vous utilisez l'option «&nbsp;Créer les activités inexistantes&nbsp;». Il est impossible d'avoir plus d'une provenance pour un code d'activité donné.
 
 
'''{{Anchor|4|4eng}}'''&nbsp;: Le champ doit contenir au moins 1 caractère et un maximum de&nbsp;? caractères. La longueur maximale est définie dans la «&nbsp;Configuration des paiements électroniques&nbsp;».
 
 
'''{{Anchor|5|5eng}}'''&nbsp;: Ce champ est obligatoire si les 3 autres champs liés à la validation RIB sont utilisés.
 
 
'''{{Anchor|6|6eng}}'''&nbsp;: Ce champ est ignoré si l'engagement est de type «&nbsp;Objectif&nbsp;».
 
  
 
== Configuration et processus général d'importation  ==
 
== Configuration et processus général d'importation  ==
Ligne 663 : Ligne 179 :
 
Pour vous rendre dans la gestion des importations vous devez d'abord passer par le menu «&nbsp;''Configuration''&nbsp;» puis «&nbsp;''Importation''&nbsp;».  
 
Pour vous rendre dans la gestion des importations vous devez d'abord passer par le menu «&nbsp;''Configuration''&nbsp;» puis «&nbsp;''Importation''&nbsp;».  
  
<br>
+
<br>  
  
{| class="wikitable" border="1" cellspacing="1" cellpadding="1" width="200"
+
{| width="200" cellspacing="1" cellpadding="1" border="1" class="wikitable"
 
|-
 
|-
 
| [[Image:ProDon Modules importations 001.png]]
 
| [[Image:ProDon Modules importations 001.png]]
Ligne 672 : Ligne 188 :
 
|}
 
|}
  
<br>
+
<br>  
  
{| class="wikitable" border="1" cellspacing="1" cellpadding="1" width="200"
+
{| width="200" cellspacing="1" cellpadding="1" border="1" class="wikitable"
 
|-
 
|-
 
| colspan="2" | [[Image:ProDon Modules importations 002.png]]
 
| colspan="2" | [[Image:ProDon Modules importations 002.png]]
Ligne 690 : Ligne 206 :
 
|}
 
|}
  
<br>
+
<br>  
  
En cliquant sur [[Image:Bouton Case cochee crochet.png]] vous accéderez à une ou plusieurs boîtes d'options (en fonction des modules actifs et du type d'importation choisi).<br>
+
En cliquant sur [[Image:Bouton Case cochee crochet.png]] vous accéderez à une ou plusieurs boîtes d'options (en fonction des modules actifs et du type d'importation choisi).<br>  
  
{| class="wikitable" border="1" cellspacing="1" cellpadding="1" width="200"
+
{| width="200" cellspacing="1" cellpadding="1" border="1" class="wikitable"
 
|-
 
|-
 
| [[Image:ProDon Modules importations 003.png]]<br>
 
| [[Image:ProDon Modules importations 003.png]]<br>
 
|-
 
|-
| <span style="color: rgb(255,0,0)">'''A'''</span>&nbsp;: Options des engagements vous permet de créer ou non des éléments.&nbsp;Les deux dernières options permettent de créer des transactions en attente plutôt que des engagements s'il n'y a qu'un seul versement, et de spécifier le mode de paiement à utiliser­.<br>
+
| <span style="color: rgb(255, 0, 0);">'''A'''</span>&nbsp;: Options des engagements vous permet de créer ou non des éléments.&nbsp;Les deux dernières options permettent de créer des transactions en attente plutôt que des engagements s'il n'y a qu'un seul versement, et de spécifier le mode de paiement à utiliser­.<br>
 
|}
 
|}
  
<br>
+
<br>  
  
{| class="wikitable" border="1" cellspacing="1" cellpadding="1" width="200"
+
{| width="200" cellspacing="1" cellpadding="1" border="1" class="wikitable"
 
|-
 
|-
 
| [[Image:ProDon Modules importations 004.png]]<br>
 
| [[Image:ProDon Modules importations 004.png]]<br>
 
|-
 
|-
| <span style="color: rgb(255,0,0)">'''B'''</span>&nbsp;:&nbsp;Options des transactions vous permettant de forcer la création de certains éléments.<br>
+
| <span style="color: rgb(255, 0, 0);">'''B'''</span>&nbsp;:&nbsp;Options des transactions vous permettant de forcer la création de certains éléments.<br>
 
|}
 
|}
  
<br>
+
<br>  
  
{| class="wikitable" border="1" cellspacing="1" cellpadding="1" width="200"
+
{| width="200" cellspacing="1" cellpadding="1" border="1" class="wikitable"
 
|-
 
|-
 
| colspan="2" | [[Image:ProDon Modules importations 005.png]]<br>
 
| colspan="2" | [[Image:ProDon Modules importations 005.png]]<br>
 
|-
 
|-
| colspan="2" | C&nbsp;:&nbsp;Options des clients comportent plusieurs onglets.<br>
+
| colspan="2" | <span style="color: rgb(255, 0, 0);">'''C'''</span>&nbsp;:&nbsp;Options des clients comportent plusieurs onglets.<br>
 
|-
 
|-
| width="50%" | «&nbsp;''Importation''&nbsp;» permet de spécifier quels traitements seront faits par le module.<br>
+
| width="50%" | «&nbsp;''Importation''&nbsp;» permet de spécifier quels traitements seront faits par le module.<br>  
 
| «&nbsp;''Doublons''&nbsp;» permet d'ajouter des détections de doublons supplémentaires à la détection de base.<br>
 
| «&nbsp;''Doublons''&nbsp;» permet d'ajouter des détections de doublons supplémentaires à la détection de base.<br>
 
|-
 
|-
| «&nbsp;''Créer''&nbsp;» permet de forcer la création de certains éléments.<br>
+
| «&nbsp;''Créer''&nbsp;» permet de forcer la création de certains éléments.<br>  
 
| «&nbsp;Casse&nbsp;» permet d'uniformiser les lettres majuscules versus les lettres minuscules.&nbsp;La première lettre de presque tous les mots sera majuscule et le reste en minuscule.<br>
 
| «&nbsp;Casse&nbsp;» permet d'uniformiser les lettres majuscules versus les lettres minuscules.&nbsp;La première lettre de presque tous les mots sera majuscule et le reste en minuscule.<br>
 
|}
 
|}
  
<br>
+
<br>  
  
En cliquant sur [[Image:Bouton Association.png]] une fenêtre s'ouvre permettant d'associer les champs du fichier '''''Excel''''' aux champs de la base de données.&nbsp;Utile s'il est impossible de changer l'entête des colonnes du fichier source ou pour repérer des erreurs de nomenclature.<br>
+
En cliquant sur [[Image:Bouton Association.png]](dans la fenêtre d'ajout d'importation) une fenêtre s'ouvre permettant d'associer les champs du fichier '''''Excel''''' aux champs de la base de données.&nbsp;Utile s'il est impossible de changer l'entête des colonnes du fichier source ou pour repérer des erreurs de nomenclature.<br>  
  
{| class="wikitable" border="1" cellspacing="1" cellpadding="1" width="200"
+
{| width="200" cellspacing="1" cellpadding="1" border="1" class="wikitable"
 
|-
 
|-
 
| colspan="2" | [[Image:ProDon Modules importations 006.png]]<br>
 
| colspan="2" | [[Image:ProDon Modules importations 006.png]]<br>
Ligne 735 : Ligne 251 :
 
| colspan="2" | Cette fenêtre permet d'associer les colonnes de votre fichier&nbsp;aux champs correspondants de '''''ProDon'''''.<br>
 
| colspan="2" | Cette fenêtre permet d'associer les colonnes de votre fichier&nbsp;aux champs correspondants de '''''ProDon'''''.<br>
 
|-
 
|-
| width="50%" | La colonne «&nbsp;Source&nbsp;» désigne les entêtes du fichier '''''Excel'''''.<br>
+
| width="50%" | La colonne «&nbsp;Source&nbsp;» désigne les entêtes du fichier '''''Excel'''''.<br>  
 
| La colonne «&nbsp;Destination&nbsp;» désigne les champs de '''''ProDon'''''.<br>
 
| La colonne «&nbsp;Destination&nbsp;» désigne les champs de '''''ProDon'''''.<br>
 
|-
 
|-
| La colonne «&nbsp;Constante&nbsp;» permet de spécifier une valeur à utiliser si la ligne correspondante du chiffrier est vide.<br>
+
| La colonne «&nbsp;Constante&nbsp;» permet de spécifier une valeur à utiliser si la ligne correspondante du chiffrier est vide.<br>  
 
| Le bouton [[Image:Petit Bouton Plus Ajouter.png]] permet d'ajouter des champs de destination même s'il n'existe aucune colonne correspondante dans le chiffrier, et de spécifier la valeur à inscrire dans '''''ProDon'''''.<br>
 
| Le bouton [[Image:Petit Bouton Plus Ajouter.png]] permet d'ajouter des champs de destination même s'il n'existe aucune colonne correspondante dans le chiffrier, et de spécifier la valeur à inscrire dans '''''ProDon'''''.<br>
 
|-
 
|-
Ligne 744 : Ligne 260 :
 
|}
 
|}
  
<br>
+
<br>  
  
{| style="width: 457px; height: 400px" class="wikitable" border="1" cellspacing="1" cellpadding="1"
+
{| cellspacing="1" cellpadding="1" border="1" style="width: 457px; height: 400px;" class="wikitable"
 
|-
 
|-
| style="text-align: center" colspan="2" | [[Image:ProDon Modules importations 007.png]]<br>
+
| style="text-align: center;" colspan="2" | [[Image:ProDon Modules importations 007.png]]<br>
 
|-
 
|-
| width="50%" | <span style="color: rgb(255,0,0)">'''A'''</span>&nbsp;:&nbsp;Cliquer sur ce bouton pour charger les données contenues dans votre fichier ''''''''Excel''''' vers une table temporaire de '''''ProDon'''''. Ce bouton active les boutons <span style="color: rgb(255,0,0)">'''B'''</span> et <span style="color: rgb(255,0,0)">'''C'''</span>.<br>
+
| width="50%" | <span style="color: rgb(255, 0, 0);">'''A'''</span>&nbsp;:&nbsp;Cliquer sur ce bouton pour charger les données contenues dans votre fichier ''''''''Excel''''' vers une table temporaire de '''''ProDon'''''. Ce bouton active les boutons <span style="color: rgb(255, 0, 0);">'''B'''</span> et <span style="color: rgb(255, 0, 0);">'''C'''</span>.<br>
 
|-
 
|-
| <span style="color: rgb(255,0,0)">'''B'''</span>&nbsp;: Cliquer sur ce bouton pour effacer une importation erronée ou terminée.<br>
+
| <span style="color: rgb(255, 0, 0);">'''B'''</span>&nbsp;: Cliquer sur ce bouton pour effacer une importation erronée ou terminée.<br>
 
|-
 
|-
| <span style="color: rgb(255,0,0)">'''C'''</span>&nbsp;:&nbsp;Cliquer sur ce bouton pour afficher la liste des données importées.&nbsp;C'est par ici que vous pouvez analyser vos données afin de voir si l'importation vous convient.<br>
+
| <span style="color: rgb(255, 0, 0);">'''C'''</span>&nbsp;:&nbsp;Cliquer sur ce bouton pour afficher la liste des données importées.&nbsp;C'est par ici que vous pouvez analyser vos données afin de voir si l'importation vous convient.<br>
 
|}
 
|}
  
<br>
+
<br>  
  
En cliquant sur [[Image:Bouton Sommaire analyse.png]] la fenêtre suivante apparaît.<br>
+
En cliquant sur [[Image:Bouton Sommaire analyse.png]] la fenêtre suivante apparaît.<br>  
  
{| class="wikitable" border="1" cellspacing="1" cellpadding="1" width="200"
+
{| width="200" cellspacing="1" cellpadding="1" border="1" class="wikitable"
 
|-
 
|-
 
| colspan="2" |  
 
| colspan="2" |  
 
<br>[[Image:ProDon Modules importations 008.png]]  
 
<br>[[Image:ProDon Modules importations 008.png]]  
  
[[Image:ProDon Modules importations 009.png|584x207px]]<br>
+
[[Image:ProDon Modules importations 009.png|584x207px]]<br>  
  
 
|-
 
|-
Ligne 776 : Ligne 292 :
 
|}
 
|}
  
<br>
+
<br>  
  
{| class="wikitable" border="1" cellspacing="1" cellpadding="1" width="200"
+
{| width="200" cellspacing="1" cellpadding="1" border="1" class="wikitable"
 
|-
 
|-
 
| [[Image:ProDon Modules importations 011.png]]<br>
 
| [[Image:ProDon Modules importations 011.png]]<br>
Ligne 785 : Ligne 301 :
 
|}
 
|}
  
<br>
+
<br>  
  
Un code de couleur facilite le repérage des clients problématiques.<br>
+
Un code de couleur facilite le repérage des clients problématiques.<br>  
  
{| class="wikitable" border="1" cellspacing="1" cellpadding="1" width="338"
+
{| width="372" cellspacing="1" cellpadding="1" border="1" style="" class="wikitable"
 
|-
 
|-
| rowspan="5" | [[Image:ProDon Modules importations 010.png|94x88px]]
+
! scope="col" | Statut
| <br>
+
! width="400" scope="col" | Description
 
|-
 
|-
| Il y a une erreur pour ce client.<br>
+
| rowspan="4" | [[Image:ProDon Modules importations 010.png|126x92px]]
 +
| Il y a une erreur pour ce client.
 
|-
 
|-
| Tout est en ordre.<br>
+
| Tout est en ordre.
 
|-
 
|-
| Il y a un avertissement pour ce client.<br>
+
| Il y a un avertissement.
 
|-
 
|-
| Il y a un avertissement validé.<br>
+
| Il y a un avertissement validé.
 
|}
 
|}
  
<br>
+
<br>
 +
 
 +
<br>  
  
 
En double-cliquant sur une ligne, vous&nbsp;verrez s'ouvrir&nbsp;la fenêtre suivante.  
 
En double-cliquant sur une ligne, vous&nbsp;verrez s'ouvrir&nbsp;la fenêtre suivante.  
  
{| class="wikitable" border="1" cellspacing="1" cellpadding="1" width="200"
+
{| width="200" cellspacing="1" cellpadding="1" border="1" class="wikitable"
 
|-
 
|-
 
| colspan="2" | [[Image:ProDon Modules importations 012.png]]
 
| colspan="2" | [[Image:ProDon Modules importations 012.png]]
 
|-
 
|-
| width="50%" | <span style="color: rgb(255,0,0)">'''A&nbsp;'''</span>: Un résumé de la fiche client.&nbsp;Les boutons à droite de la ligne «&nbsp;NUC/#lLigne&nbsp;» permettent d'assigner manuellement un doublon à une fiche.  
+
| width="50%" | <span style="color: rgb(255, 0, 0);">'''A&nbsp;'''</span>: Un résumé de la fiche client.&nbsp;Les boutons à droite de la ligne «&nbsp;Ligne/Doublon&nbsp;» permettent d'assigner manuellement un doublon à une fiche.  
| <span style="color: rgb(255,0,0)">'''B'''</span>&nbsp;:&nbsp;S'il y a un doublon potentiel, le résumé de l'autre fiche se trouve ici.
+
| <span style="color: rgb(255, 0, 0);">'''B'''</span>&nbsp;:&nbsp;S'il y a un doublon potentiel, le résumé de l'autre fiche se trouve ici.
 
|-
 
|-
| <span style="color: rgb(255,0,0)">'''C'''</span>&nbsp;: Une liste de tous les autres champs ainsi que l'information qu'ils contiennent.  
+
| <span style="color: rgb(255, 0, 0);">'''C'''</span>&nbsp;: Une liste de tous les autres champs ainsi que l'information qu'ils contiennent.  
|  
+
| <br>
 
|}
 
|}
  
<br>
+
<br>  
  
En cliquant sur [[Image:Bouton Baguette.png]] vous lancez l'importation des données vers votre base actuelle.&nbsp; '''<span style="color: rgb(255,0,0)">ATTENTION, CETTE PROCÉDURE EST DÉFINITIVE.</span>'''
+
En cliquant sur [[Image:Bouton Baguette.png]](dans la fenêtre de données chargées) vous lancez l'importation des données vers votre base actuelle.&nbsp; '''<span style="color: rgb(255, 0, 0);">ATTENTION, CETTE PROCÉDURE EST DÉFINITIVE.</span>'''  
  
== Utilitaire d'importation automatique ==
+
== Utilitaires disponibles sur demande ==
  
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'''''.&nbsp;Lors de l'installation de ce programme, vous devrez configurer certaines informations une première fois avant de planifier la tâche Windows.&nbsp; Ensuite vous pourrez planifier votre tâche avec les paramètres suivants.<br>
+
*[[ProDon:Utilitaire d'importation automatique|Utilitaire d'importation automatique]]&nbsp;:&nbsp;L’utilitaire d’importation automatique est un programme console qu’on appelle à partir d’une tâche planifiée Windows afin d'enclencher des importations automatiquement.  
 +
*[[Fonctions communes:Utilitaire de téléchargement FTP|Utilitaire de téléchargement FTP]]&nbsp;:&nbsp;Permet de télécharger des fichiers sur un serveur FTP (pour effectuer une importation automatique par exemple).
  
Voici les paramètres d’appel pour l’utilisation&nbsp;:
+
<br>  
 
 
<br>
 
 
 
On doit premièrement spécifier le chemin de l’exécutable qui doit être dans le même répertoire que le fichier «&nbsp;ProDon.exe&nbsp;».<br>Exemple&nbsp;: C:\Logilys\ProDon\ImportAuto.Exe [paramètre]
 
 
 
<br>
 
 
 
/n=15<br>Ce paramètre est obligatoire
 
 
 
«&nbsp;15&nbsp;» réprésente une variable qui correspond à un numéro d'importation préalablament configuré dans '''''ProDon'''''.
 
 
 
<br>
 
 
 
/o=2<br>«&nbsp;2&nbsp;» représente une variable qui correspond au numéro de l’organisme, tel que défini dans '''''ProDon'''''.<br>Si ce paramètre est absent, l’organisme 1 sera utilisé.<br>
 
 
 
<br>
 
 
 
/u=SUPERVISEUR<br>«&nbsp;SUPERVISEUR&nbsp;» représente une variable qui correspond au code de l’utilisateur '''''ProDon''''' qui sera utilisé pour l’importation<br>Si ce paramètre est absent, le code SUPERVISEUR sera utilisé<br>
 
 
 
<br>
 
 
 
/c= "C:\Logilys\ProDon\Importation\Importation.csv"<br>Permet de spécifier l'emplacement du fichier à charger dans le module.<br>Si ce paramètre est absent, aucun chargement ne sera exécuté et le chargement de l'importation spécifié par «&nbsp;/n&nbsp;» doit avoir été exécuté manuellement au préalable.<br>Les guillemets anglais sont utilisés pour encadrer le nom du fichier afin que les espaces soient bien reconnus.
 
 
 
<br>
 
 
 
/i<br>Si ce paramètre est présent et que le paramètre /c est absent, on utilisera le fichier spécifié dans l’importation de ProDon<br>Si ce paramètre est absent, l’importation n’aura pas lieu
 
 
 
<br>
 
  
/d<br>Si ce paramètre est présent, le fichier utilisé pour le chargement ou l'importation sera détruit.<br>{{BasPage_ProDon}}<br>
+
{{BasPage_ProDon_Version|4.6.3.25}}<br>

Version actuelle datée du 22 avril 2022 à 15:45

Modules d'importation

Cette documentation nécessite le module « Importation » de Prodon, il faut donc posséder ce module pour avoir accès à ces fonctionnalités.

Explications générales

Les modules sont tous regroupés en un même endroit. Vous avez la possibilité d’analyser vos données avant de confirmer l’importation pour détecter toutes les erreurs qui pourraient s’y être glissées. Les modules sont indépendants; en conséquence, vous aurez uniquement accès aux fonctionnalités relatives au(x) module(s) 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 utilise le « ; » pour délimiter les informations à l'intérieur du fichier, il faut donc s'assurer que les données elles-mêmes ne comportent pas cette ponctuation. Le format « txt » est disponible, mais vous devrez alors 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és ou abrégés indiqués dans les sections pertinentes.


Les libellés 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 dans la section correspondante.

Liste des champs communs à tous les modules

Les champs communs sont principalement utilisés 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 besoins. Il sert principalement à créer et corriger massivement les clients de votre base de données. Il est fréquemment utilisé conjointement avec les modules d'importation de transactions ou d'engagements (voir sections respectives pour plus de détails).


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

Clinom OU CliCompagnie

ET

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


Champs obligatoires pour la détection de doublons

(CliPrénom ET CliNom) OU CliCompagnie

ET

CliAdresse

ET

CliCodePostal


Champs obligatoires pour la création de contacts

ConOpération

ET

ConLien


Champs obligatoires pour la création de liens

NUC2 OU NoRéférence2

ET

LienOpération

ET

Lien


Liste complète des champs clients, contacts et liens

Vous pouvez consulter la liste complète des champs clients, contacts et liens, ainsi que leurs particularités.
Clients
Contacts
Liens

Module d'importation de transaction

Lorsqu'il est utilisé seul, le module d'importation de transaction sert à créer des transactions pour des clients déjà existants 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 champs client.  Ceci permettra 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à existantes 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 obligatoires 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 obligatoires pour la création de reçus

RecNoTrx

ET

RecNoReçu


Liste complète des champs transactions et reçus

Vous pouvez consulter la liste complète des champs transactions et reçus, ainsi que leurs particularités.
Transactions
Reçus

Module d'importation d'engagement

Lorsqu'il est utilisé seul, le module d'importation d'engagement sert à créer des engagements pour des clients déjà existants 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 champs client. Ceci permettra 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 complète des champs engagements

Vous pouvez consulter la liste complète des champs engagements, ainsi que leurs particularités.
Engagements

Configuration et processus général d'importation

Cette section présente les différents écrans de configuration d'une importation ainsi qu'une marche à suivre générale pour le processus d'importation.

Pour vous rendre dans la gestion des importations vous devez d'abord passer par le menu « Configuration » puis « Importation ».


ProDon Modules importations 001.png
Cliquez sur Petit Bouton Plus Ajouter.png pour créer un nouveau modèle d'importation.


ProDon Modules importations 002.png
Tous les champs sont obligatoires à l'exception des cases à cocher et de la note.
Pour le fichier, cliquez sur Bouton Selection 3 petits points.png pour indiquer l'emplacement de votre fichier source. Le nom permet de définir le nom à donner à votre modèle d'importation.
Les types disponibles dépendent des modules que vous possédez. Choisissez le type d'importation que vous voulez faire. Champ permet d'indiquer ce qui sépare 2 colonnes dans le fichier Excel.
Chaine indique le caractère utilisé pour limiter le texte dans le fichier Excel. Le format de date indiqué ici doit être le même pour toutes les dates du fichier Excel.


En cliquant sur Bouton Case cochee crochet.png vous accéderez à une ou plusieurs boîtes d'options (en fonction des modules actifs et du type d'importation choisi).

ProDon Modules importations 003.png
A : Options des engagements vous permet de créer ou non des éléments. Les deux dernières options permettent de créer des transactions en attente plutôt que des engagements s'il n'y a qu'un seul versement, et de spécifier le mode de paiement à utiliser­.


ProDon Modules importations 004.png
B : Options des transactions vous permettant de forcer la création de certains éléments.


ProDon Modules importations 005.png
C : Options des clients comportent plusieurs onglets.
« Importation » permet de spécifier quels traitements seront faits par le module.
« Doublons » permet d'ajouter des détections de doublons supplémentaires à la détection de base.
« Créer » permet de forcer la création de certains éléments.
« Casse » permet d'uniformiser les lettres majuscules versus les lettres minuscules. La première lettre de presque tous les mots sera majuscule et le reste en minuscule.


En cliquant sur Bouton Association.png(dans la fenêtre d'ajout d'importation) une fenêtre s'ouvre permettant d'associer les champs du fichier Excel aux champs de la base de données. Utile s'il est impossible de changer l'entête des colonnes du fichier source ou pour repérer des erreurs de nomenclature.

ProDon Modules importations 006.png
Cette fenêtre permet d'associer les colonnes de votre fichier aux champs correspondants de ProDon.
La colonne « Source » désigne les entêtes du fichier Excel.
La colonne « Destination » désigne les champs de ProDon.
La colonne « Constante » permet de spécifier une valeur à utiliser si la ligne correspondante du chiffrier est vide.
Le bouton Petit Bouton Plus Ajouter.png permet d'ajouter des champs de destination même s'il n'existe aucune colonne correspondante dans le chiffrier, et de spécifier la valeur à inscrire dans ProDon.
Dans le cas d'une caractéristique, la colonne contenant la valeur doit être associée à la destination « LibelléDeLaCaractéristique. La note ou les dates de début et fin doivent être associées à la destination « Attaché à LibelléDeLaCaractéristique ».


ProDon Modules importations 007.png
A : Cliquer sur ce bouton pour charger les données contenues dans votre fichier '''Excel vers une table temporaire de ProDon. Ce bouton active les boutons B et C.
B : Cliquer sur ce bouton pour effacer une importation erronée ou terminée.
C : Cliquer sur ce bouton pour afficher la liste des données importées. C'est par ici que vous pouvez analyser vos données afin de voir si l'importation vous convient.


En cliquant sur Bouton Sommaire analyse.png la fenêtre suivante apparaît.


ProDon Modules importations 008.png

ProDon Modules importations 009.png

Cette fenêtre vous permet de voir chacune des colonnes pour chacun des clients qui seront importés.
Le bouton Bouton Engrenage.png lance une analyse préliminaire. C'est l'étape ou vous devez vérifier l'intégrité de vos données.
ProDon compare alors les informations à importer avec votre base de données actuelle.


ProDon Modules importations 011.png
Des notes seront inscrites dans les cases appropriées si présence de doublons potentiels, d'erreurs ou d'autres avertissements.


Un code de couleur facilite le repérage des clients problématiques.

Statut Description
ProDon Modules importations 010.png Il y a une erreur pour ce client.
Tout est en ordre.
Il y a un avertissement.
Il y a un avertissement validé.



En double-cliquant sur une ligne, vous verrez s'ouvrir la fenêtre suivante.

ProDon Modules importations 012.png
: Un résumé de la fiche client. Les boutons à droite de la ligne « Ligne/Doublon » permettent d'assigner manuellement un doublon à une fiche. B : S'il y a un doublon potentiel, le résumé de l'autre fiche se trouve ici.
C : Une liste de tous les autres champs ainsi que l'information qu'ils contiennent.


En cliquant sur Bouton Baguette.png(dans la fenêtre de données chargées) vous lancez l'importation des données vers votre base actuelle.  ATTENTION, CETTE PROCÉDURE EST DÉFINITIVE.

Utilitaires disponibles sur demande

  • Utilitaire d'importation automatique : L’utilitaire d’importation automatique est un programme console qu’on appelle à partir d’une tâche planifiée Windows afin d'enclencher des importations automatiquement.
  • Utilitaire de téléchargement FTP : Permet de télécharger des fichiers sur un serveur FTP (pour effectuer une importation automatique par exemple).



Nom du document : ProDon:Modules d'importation
Version : 4.6.3.25