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

De Logilys
Aller à : navigation, rechercher
m
 
(114 révisions intermédiaires par 5 utilisateurs non affichées)
Ligne 1 : Ligne 1 :
{{Entete_ProDon|21|4.5|Louis-Sébastien Garneau|Jessy Fontaine|2010/05/05}}  
+
{{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 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.<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.
  
 
<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 utilse le «&nbsp;;&nbsp;» 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.&nbsp; Le format «&nbsp;txt&nbsp;» 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és ou abrégés indiqués dans les sections pertinentes.  
  
 
<br>  
 
<br>  
  
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és ne sont pas sensibles à la casse ni aux caractères accentués, à l'exception de la cédille.  
 
 
<br>
 
 
 
Les libellé ne sont pas sensibles à la casse ni aux caractères accentués, à l'exception de la cédille.  
 
  
 
<br>  
 
<br>  
Ligne 23 : Ligne 20 :
 
<br>  
 
<br>  
  
Les champs obligatoires pour chaque forme d'importation sont indiqués sous la légende de chaque liste de champ.
+
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  ==
  
Les champs communs sont principalement utilisé 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.  
  
 
{| width="100%" cellspacing="1" cellpadding="1" border="1" class="wikitable sortable"
 
{| width="100%" cellspacing="1" cellpadding="1" border="1" class="wikitable sortable"
Ligne 53 : Ligne 50 :
 
|}
 
|}
  
<br>
+
<br>  
  
 
== Module d'importation et mise à jour client  ==
 
== Module d'importation et mise à jour client  ==
  
Ce module répond à une vaste gamme de besoin.&nbsp; Principalement, il sert à créer et corriger massivement les clients de votre base de données.&nbsp; Il est fréquement utilisé conjointement avec les modules d'importation de transactions ou d'engagements&nbsp;(voir sections respectives pour plus de détails).  
+
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&nbsp;(voir sections respectives pour plus de détails).  
  
 
<br>  
 
<br>  
  
<br>
+
==== Champs obligatoires pour la création d'un nouveau client  ====
  
=== Champs obligatoires pour la création de contacts <br>  ===
+
Clinom '''OU''' CliCompagnie
 
 
ConOpération
 
  
 
'''ET'''  
 
'''ET'''  
  
ConLien
+
CliLibelléCaractéristique (si des caractéristiques sont obligatoires pour les clients dans '''''ProDon''''')
  
 
<br>  
 
<br>  
  
=== Champs obligatoires pour la création de liens ===
+
==== Champs obligatoires pour la détection de doublons ====
  
NUC2 '''OU''' NoRéférence2
+
(CliPrénom ET CliNom) '''OU''' CliCompagnie
  
 
'''ET'''  
 
'''ET'''  
  
LienOpération
+
CliAdresse
  
 
'''ET'''  
 
'''ET'''  
 +
 +
CliCodePostal
  
 
<br>  
 
<br>  
  
=== Liste des champs clients ===
+
==== Champs obligatoires pour la création de contacts <br> ====
  
==== Champs obligatoires pour la création d'un nouveau client  ====
+
ConOpération
 
 
Clinom '''OU''' CliCompagnie
 
  
 
'''ET'''  
 
'''ET'''  
  
CliLibelléCaractéristique (si des caractéristiques sont obligatoire pour les clients dans '''''ProDon''''')
+
ConLien
  
 
<br>  
 
<br>  
  
==== Champs obligatoires pour la détection de doublons ====
+
==== Champs obligatoires pour la création de liens ====
  
(CliPrénom ET CliNom) '''OU''' CliCompagnie
+
NUC2 '''OU''' NoRéférence2
  
 
'''ET'''  
 
'''ET'''  
  
CliAdresse
+
LienOpération <br>
  
 
'''ET'''  
 
'''ET'''  
  
CliCodePostal
+
Lien
 +
 
 +
'''<br>'''
  
<br>
+
==== Liste complète des champs clients, contacts et liens  ====
  
{| width="100%" cellspacing="1" cellpadding="1" border="1" class="wikitable sortable"
+
{| 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" align="center" scope="col" | Longeur maximale
 
! width="90" scope="col" | Particularité
 
|-
 
| CliAdresse
 
| CliAdr<br>
 
| <br>
 
| <br>
 
| style="text-align: center;" | 150<br>
 
| align="center" | [[#plusclients|[+]]]<br>
 
|-
 
| CliAdrVoie<br>
 
| <br>
 
| <br>
 
| <br>
 
| style="text-align: center;" | 100<br>
 
| align="center" | [[#1clients|1]]<br>
 
|-
 
| CliAdrPointRemise<br>
 
| CliAdrRemise<br>
 
| <br>
 
| <br>
 
| style="text-align: center;" | 100<br>
 
| align="center" | [[#1clients|1]]<br>
 
|-
 
| CliAdrBatiment<br>
 
| <br>
 
| <br>
 
| <br>
 
| style="text-align: center;" | 100<br>
 
| align="center" | [[#1clients|1]]<br>
 
|-
 
| CliAdrComplVoie<br>
 
| <br>
 
| <br>
 
| <br>
 
| style="text-align: center;" | 100<br>
 
| align="center" | [[#1clients|1]]<br>
 
|-
 
| CliAdrSuccursale<br>
 
| CliAdrSucc<br>
 
| <br>
 
| <br>
 
| style="text-align: center;" | 100<br>
 
| align="center" | [[#1clients|1]]<br>
 
|-
 
| CliCedex<br>
 
| <br>
 
| <br>
 
| <br>
 
| style="text-align: center;" | 100<br>
 
| align="center" | [[#1clients|1]]<br>
 
|-
 
| CliAnonyme<br>
 
| CliAnony<br>
 
| CliAno<br>
 
| '''N''' ou '''F''' = Non ('''Vide''' = Non)<br>'''O''' ou '''V '''= Oui<br>
 
| style="text-align: center;" | 1<br>
 
| align="center" | <br>
 
|-
 
| CliAppellation<br>
 
| CliApp<br>
 
| <br>
 
| <br>
 
| style="text-align: center;" | 50<br>
 
| align="center" | <br>
 
|-
 
| CliBénéficiaire<br>
 
| CliBénéf<br>
 
| CliBén<br>
 
| '''N''' ou '''F''' = Non ('''Vide''' = Non)<br>'''O''' ou '''V''' = Oui<br>
 
| style="text-align: center;" | 5<br>
 
| align="center" | <br>
 
|-
 
| CliCodeCatégorie<br>
 
| CliCat<br>
 
| <br>
 
| '''Code''' de catégorie existant<br>
 
| style="text-align: center;" | 255<br>
 
| align="center" | [[#etoileclients|[*]]][[#plusclients|, [+]]]<br>
 
|-
 
| CliCodePostal<br>
 
| CliCP<br>
 
| <br>
 
| <br>
 
| style="text-align: center;" | 15<br>
 
| align="center" | <br>
 
|-
 
| CliCodeSecteur<br>
 
| CliSec<br>
 
| CliSecteur<br>
 
| '''Code''' secteur existant<br>
 
| style="text-align: center;" | 15<br>
 
| align="center" | [[#etoileclients|[*]]]<br>
 
|-
 
| CliCommentaires<br>
 
| CliCom<br>
 
| <br>
 
| <br>
 
| style="text-align: center;" | 5000<br>
 
| align="center" | [[#plusclients|[+]]]<br>
 
|-
 
| CliCompagnie<br>
 
| CliCie<br>
 
| <br>
 
| <br>
 
| style="text-align: center;" | 100<br>
 
| align="center" | <br>
 
|-
 
| CliCompagnieSuite<br>
 
| CliCieSuite<br>
 
| <br>
 
| <br>
 
| style="text-align: center;" | 100<br>
 
| align="center" | <br>
 
|-
 
| CliCourriel<br>
 
| CliE-Mail<br>
 
| CliEmail<br>
 
| <br>
 
| style="text-align: center;" | 100<br>
 
| align="center" | <br>
 
|-
 
| CliDateDécès<br>
 
| <br>
 
| <br>
 
| <br>
 
| style="text-align: center;" | 10<br>
 
| align="center" | [[#2clients|2]]<br>
 
|-
 
| CliDateNaissance<br>
 
| CliNais<br>
 
| <br>
 
| <br>
 
| style="text-align: center;" | 10<br>
 
| align="center" | [[#2clients|2]]<br>
 
|-
 
| CliDateInscription<br>
 
| CliDateInsc<br>
 
| <br>
 
| <br>
 
| style="text-align: center;" | 10<br>
 
| align="center" | [[#2clients|2]]<br>
 
|-
 
| CliDécédé<br>
 
| <br>
 
| <br>
 
| '''N''' ou '''F''' = Non ('''Vide''' = Non)<br>'''O''' ou '''V''' = Oui<br>
 
| style="text-align: center;" | 1<br>
 
| align="center" | <br>
 
|-
 
| CliExclurePublipostage<br>
 
| CliExclure<br>
 
| CliExcl<br>
 
| '''N''' ou '''F''' = Non ('''Vide''' = Non)<br>'''O''' ou '''V''' = Oui<br>
 
| style="text-align: center;" | 1<br>
 
| align="center" | [[#3clients|3]]<br>
 
|-
 
| CliGenre<br>
 
| <br>
 
| <br>
 
| '''M''' = Masculin<br>'''F''' = Féminin<br> '''Vide''' = Selon appellation&nbsp;(Monsieur = Masculin / Madame = Fémin)<br>
 
| style="text-align: center;" | 1<br>
 
| align="center" | <br>
 
|-
 
| CliInactif<br>
 
| <br>
 
| <br>
 
| '''N''' ou '''F''' = Non (Vide = Non)<br>'''O''' ou '''V''' = Oui<br>
 
| style="text-align: center;" | 1<br>
 
| align="center" | [[#4clients|4]]<br>
 
|-
 
| CliLangue<br>
 
| <br>
 
| <br>
 
| '''Code''' langue existant<br>
 
| style="text-align: center;" | 2<br>
 
| align="center" | <br>
 
|-
 
| CliNePasSuggerer<br>
 
| <br>
 
| <br>
 
| '''N''' ou '''F''' = Non ('''Vide''' = Non)<br>'''O''' ou '''V''' = Oui<br>
 
| style="text-align: center;" | 1<br>
 
| align="center" | <br>
 
|-
 
| CliNePlusTéléphoner<br>
 
| <br>
 
| <br>
 
| '''N''' ou '''F''' = Non ('''Vide''' = Non)<br>'''O''' ou '''V''' = Oui<br>
 
| style="text-align: center;" | 1<br>
 
| align="center" | <br>
 
|-
 
| CliNom<br>
 
| <br>
 
| <br>
 
| <br>
 
| style="text-align: center;" | 100<br>
 
| align="center" | <br>
 
|-
 
| CliParticule<br>
 
| CliPart<br>
 
| <br>
 
| <br>
 
| style="text-align: center;" | 15<br>
 
| align="center" | <br>
 
|-
 
| CliSuffixe<br>
 
| <br>
 
| <br>
 
| <br>
 
| style="text-align: center;" | 50<br>
 
| align="center" | <br>
 
|-
 
| CliPays<br>
 
| <br>
 
| <br>
 
| <br>
 
| style="text-align: center;" | 40<br>
 
| align="center" | <br>
 
|-
 
| CliPrénom<br>
 
| CliPré<br>
 
| <br>
 
| <br>
 
| style="text-align: center;" | 100<br>
 
| align="center" | <br>
 
|-
 
| CliProvince<br>
 
| CliProv<br>
 
| CliPro<br>
 
| <br>
 
| style="text-align: center;" | 25<br>
 
| align="center" | <br>
 
|-
 
| CliRaisonExclusion<br>
 
| CliRaison<br>
 
| <br>
 
| <br>
 
| style="text-align: center;" | 100<br>
 
| align="center" | [[#5clients|5]]<br>
 
|-
 
| CliReçuAnnuel<br>
 
| CliReçuA<br>
 
| <br>
 
| '''N''' ou '''F''' = Non ('''Vide''' = Non)<br>'''O''' ou '''V''' = Oui<br>
 
| style="text-align: center;" | 1<br>
 
| align="center" | <br>
 
|-
 
| CliReçuStatut<br>
 
| CliReçuS<br>
 
| <br>
 
| '''J''' = Jamais de reçu pour ce client<br>'''Vide''' = Non
 
| style="text-align: center;" | 1<br>
 
| align="center" | <br>
 
|-
 
| CliSiteInternet<br>
 
| CliWeb<br>
 
| <br>
 
| <br>
 
| style="text-align: center;" | 100<br>
 
| align="center" | <br>
 
|-
 
| CliSolliciteurCode<br>
 
| CliSolCode<br>
 
| <br>
 
| '''Code '''solliciteur existant<br>
 
| style="text-align: center;" | 15<br>
 
| align="center" | [[#6clients|6]]<br>
 
|-
 
| CliSolliciteurNom<br>
 
| CliSolNom<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 existant identiques.<br>
 
| style="text-align: center;" | 15<br>
 
| align="center" | [[#6clients|6]]<br>
 
|-
 
| CliEstUnSolliciteur<br>
 
| CliEstUnSol<br>
 
| <br>
 
| '''N''' ou '''F''' = Non ('''Vide''' = Non)<br>'''O''' ou '''V''' = Oui<br>
 
| style="text-align: center;" | 1<br>
 
| align="center" | [[#7clients|7]]<br>
 
|-
 
| CliSolliciteurCodePerso<br>
 
| CliSolCodePerso<br>
 
| <br>
 
| <br>
 
| style="text-align: center;" | 25<br>
 
| align="center" | [[#7clients|7]]<br>
 
 
|-
 
|-
| CliSolliciteurActifDepuis<br>
+
! scope="col" | Vous pouvez consulter la liste complète des champs clients, contacts et liens, ainsi que leurs particularités.
| CliSolDateActif<br>
 
| <br>
 
| <br>
 
| style="text-align: center;" | 10<br>
 
| align="center" | [[#2clients|2]], [[#7clients|7]]<br>
 
 
|-
 
|-
| CliSolliciteurInactif<br>
+
| [[ProDon:Module d'importation clients#Liste_des_champs_clients|Clients]]
| CliSolInactif<br>
 
| <br>
 
| '''N''' ou '''F''' = Non ('''Vide''' = Non)<br>'''O''' ou '''V''' = Oui<br>
 
| style="text-align: center;" | 1<br>
 
| align="center" | [[#7clients|7]]<br>
 
 
|-
 
|-
| CliSolliciteurInactifDepuis<br>
+
| [[ProDon:Module d'importation clients#Liste_des_champs_contacts|Contacts]]
| CliSolDateInactif<br>
 
| <br>
 
| <br>
 
| style="text-align: center;" | 10<br>
 
| align="center" | [[#2clients|2]], [[#7clients|7]]<br>
 
 
|-
 
|-
| CliTéléavertisseur<br>
+
| [[ProDon:Module d'importation clients#Liste_des_champs_liens|Liens]]
| CliPaget<br>
 
| <br>
 
| <br>
 
| style="text-align: center;" | 25<br>
 
| align="center" | <br>
 
|-
 
| CliTélécopieur<br>
 
| CliFax<br>
 
| <br>
 
| <br>
 
| style="text-align: center;" | 25<br>
 
| align="center" | <br>
 
|-
 
| CliTéléphoneBureau<br>
 
| CliBur<br>
 
| <br>
 
| <br>
 
| style="text-align: center;" | 25<br>
 
| align="center" | <br>
 
|-
 
| CliTéléphoneBureauPoste<br>
 
| CliBurPoste<br>
 
| <br>
 
| <br>
 
| style="text-align: center;" | 10<br>
 
| align="center" | <br>
 
|-
 
| CliTéléphoneCellulaire<br>
 
| CliCell<br>
 
| <br>
 
| <br>
 
| style="text-align: center;" | 25<br>
 
| align="center" | <br>
 
|-
 
| CliTéléphoneRésidence<br>
 
| CliRés<br>
 
| <br>
 
| <br>
 
| style="text-align: center;" | 25<br>
 
| align="center" | <br>
 
|-
 
| CliTitre<br>
 
| <br>
 
| <br>
 
| <br>
 
| style="text-align: center;" | 150<br>
 
| align="center" | <br>
 
|-
 
| CliVille<br>
 
| <br>
 
| <br>
 
| <br>
 
| style="text-align: center;" | 50<br>
 
| align="center" | <br>
 
|-
 
| CliLibelléDeLaCaractéristique<br>
 
| <br>
 
| <br>
 
| Variable<br>
 
| style="text-align: center;" | Variable<br>
 
| align="center" | [[#8clients|8]]<br>
 
|-
 
| CliLibelléDuChampPersonnalisé<br>
 
| <br>
 
| <br>
 
| Variable<br>
 
| style="text-align: center;" | Variable<br>
 
| align="center" | [[#8clients|8]]<br>
 
|-
 
| EnvActProvenance<br>
 
| <br>
 
| <br>
 
| '''Provenance''' existante<br>
 
| style="text-align: center;" | 100<br>
 
| align="center" | [[#11clients|11]]<br>
 
|-
 
| EnvCodeActivité<br>
 
| EnvAct<br>
 
| EnvActivité<br>
 
| '''Code''' d'activité existant<br>
 
| style="text-align: center;" | 15<br>
 
| align="center" | [[#etoileclients|[*]]], [[#10clients|10]]<br>
 
|-
 
| EnvCodeOccasion<br>
 
| EnvOcc<br>
 
| EnvOccasion<br>
 
| '''Code''' d'occasion existant<br>
 
| style="text-align: center;" | 15<br>
 
| align="center" | [[#etoileclients|[*]]]<br>
 
|-
 
| EnvDateInsc<br>
 
| <br>
 
| <br>
 
| <br>
 
| style="text-align: center;" | 10<br>
 
| align="center" | [[#2clients|2]]<br>
 
|-
 
| EnvDescActivité<br>
 
| <br>
 
| <br>
 
| <br>
 
| style="text-align: center;" | 100<br>
 
| align="center" | [[#10clients|10]]<br>
 
|-
 
| EnvDescOccasion<br>
 
| <br>
 
| <br>
 
| <br>
 
| style="text-align: center;" | 100<br>
 
| align="center" | <br>
 
|-
 
| EnvRéponse<br>
 
| EnvRép<br>
 
| <br>
 
| '''Réponse''' de sollicitation existante<br>
 
| style="text-align: center;" | 100<br>
 
| align="center" | <br>
 
 
|}
 
|}
  
'''{{Anchor|[+]|plusclients}}'''&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|[*]|etoileclients}}'''&nbsp;: Si le code [*] est ajouté à la fin du libellé, le code sera créé s'il n'existe pas déjà.  
+
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|1|1clients}}'''&nbsp;: Pour utiliser ce champ, vous devez sélectionner l'option «&nbsp;Utiliser le pavé d'adresse&nbsp;» plutôt que l'importation d'adresse standard.
+
==== Champs obligatoires pour la création de transactions<br>  ====
  
'''{{Anchor|2|2clients}}'''&nbsp;: 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.  
+
(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|3|3clients}}'''&nbsp;: La date d'exclusion du publipostage est systématiquement la date du jour.
+
==== Champs obligatoires pour la création de reçus  ====
  
'''{{Anchor|4|4clients}}'''&nbsp;: Si la colonne «&nbsp;CliInactif&nbsp;» 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 «&nbsp;CliDécédé&nbsp;» contient «&nbsp;O&nbsp;» ou «&nbsp;V&nbsp;».
+
RecNoTrx
  
'''{{Anchor|5|5clients}}'''&nbsp;: Cette valeur sera traitée seulement si le client est exclu du publipostage.
+
'''ET'''  
  
'''{{Anchor|6|6clients}}'''&nbsp;: Permet de définir le solliciteur attribué au client. Attention de ne pas confondre avec&nbsp;'''7'''.
+
RecNoReçu
  
'''{{Anchor|7|7clients}}'''&nbsp;: Permet de définir les information d'un client qui est solliciteur. Attention de ne pas confondre avec&nbsp;'''6'''.
+
<br>
  
'''{{Anchor|8|8clients}}'''&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;Cli&nbsp;», en ne conservant que les lettres et les chiffres. Par exemple, un champ nommé&nbsp;% d'individus deviendrait CliDIndividus.<br>
+
==== Liste complète des champs transactions et reçus  ====
  
{| width="635" cellspacing="1" cellpadding="1" border="1" class="wikitable" style=""
+
{| width="480" cellspacing="1" cellpadding="1" border="1" class="wikitable"
|+ Variables
 
 
|-
 
|-
! scope="col" | Type<br>
+
! scope="col" | Vous pouvez consulter la liste complète des champs transactions et reçus, ainsi que leurs particularités.
! scope="col" | Valeurs possibles<br>
 
! scope="col" | Longeur maximale<br>
 
 
|-
 
|-
| Numérique<br>
+
| [[ProDon:Module d'importation transactions#Liste_des_champs_transaction|Transactions]]
| Chiffre uniquement<br>
 
| <br>
 
 
|-
 
|-
| Texte<br>  
+
| [[ProDon:Module d'importation transactions#Liste_des_champs_re.C3.A7us|Reçus]]
| <br>  
+
|}
| 255<br>
+
 
|-
+
== Module d'importation d'engagement  ==
| Date et heure<br>  
+
 
| Format de date tel que specifié dans les options d'importation<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 permettra de trouver le client s'il existe déjà ou de le créer dans le cas contraire.<br>  
| 10<br>
+
 
|-
+
<br>  
| Vrai/Faux<br>  
+
 
| '''N''' ou '''F''' = Non ('''Vide''' = Non)<br>'''O''' ou '''V''' = Oui<br>  
+
==== Champs obligatoires pour la création d'un engagement de type «&nbsp;Objectif&nbsp;»<br> ====
| 1<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>  
 +
 
 +
==== 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>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>  
 +
 
 +
==== Liste complète des champs engagements  ====
 +
 
 +
{| width="480" cellspacing="1" cellpadding="1" border="1" class="wikitable"
 
|-
 
|-
| Liste de choix<br>
+
! scope="col" | Vous pouvez consulter la liste complète des champs engagements, ainsi que leurs particularités.
| Si la valeur Nexiste pas déjà, elle sera automatiquement ajoutée à la liste<br>
 
| 250<br>
 
 
|-
 
|-
| Liste de choix prédéfinie<br>
+
| [[ProDon:Module d'importation engagements|Engagements]]
| 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 _note, _début et _fin. Par exemple&nbsp;:&nbsp;CliDIndividus_note.&nbsp; La note peut contenir jusqu'à 255 charactè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 CliDIndividus serait vide).&nbsp; 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.
+
== Configuration et processus général d'importation ==
  
Si la caractérisitue 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;CliDIndividus_note-1.  
+
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.  
  
<br> '''{{Anchor|10|10clients}}'''&nbsp;: Ce champ requiert la présence du champ similaire en Occasion.  
+
Pour vous rendre dans la gestion des importations vous devez d'abord passer par le menu «&nbsp;''Configuration''&nbsp;» puis «&nbsp;''Importation''&nbsp;».  
  
'''{{Anchor|11|11clients}}'''&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é.
+
<br>
  
<br>
+
{| width="200" cellspacing="1" cellpadding="1" border="1" class="wikitable"
 +
|-
 +
| [[Image:ProDon Modules importations 001.png]]
 +
|-
 +
| Cliquez sur [[Image:Petit Bouton Plus Ajouter.png]] pour créer un nouveau modèle d'importation.
 +
|}
  
=== Liste des champs contacts  ===
+
<br>
  
{| width="100%" cellspacing="1" cellpadding="1" border="1" class="wikitable sortable"
+
{| width="200" cellspacing="1" cellpadding="1" border="1" class="wikitable"
 
|-
 
|-
! scope="col" | Libellé complet
+
| colspan="2" | [[Image:ProDon Modules importations 002.png]]
! scope="col" | Abrégé 1
 
! scope="col" | Abrégé 2  
 
! scope="col" | Valeurs possibles
 
! width="75" align="center" scope="col" | Longeur maximale
 
! width="90" scope="col" | Particularité
 
 
|-
 
|-
| NoContact
+
| colspan="2" | Tous les champs sont obligatoires à l'exception des cases à cocher et de la note.
| <br>
 
| <br>
 
| Numéro de contact existant<br>
 
| style="text-align: center;" | 10<br>
 
| align="center" | [[#1con|1]]<br>
 
 
|-
 
|-
| ConNom<br>
+
| width="50%" | Pour le fichier, cliquez sur [[Image:Bouton Selection 3 petits points.png]] pour indiquer l'emplacement de votre fichier source.
| <br>
+
| Le nom permet de définir le nom à donner à votre modèle d'importation.
| <br>
 
| <br>
 
| style="text-align: center;" | 100<br>
 
| align="center" | <br>
 
 
|-
 
|-
| ConPrenom<br>
+
| Les types disponibles dépendent des modules que vous possédez.&nbsp;Choisissez le type d'importation que vous voulez faire.
| ConPre<br>
+
| Champ permet d'indiquer ce qui sépare 2 colonnes dans le fichier '''''Excel'''''.
| <br>
 
| <br>
 
| style="text-align: center;" | 100<br>
 
| align="center" | <br>
 
 
|-
 
|-
| ConTéléphoneRésidence
+
| Chaine indique le caractère utilisé pour limiter le texte dans le fichier '''''Excel'''''.
| ConRés
+
| Le format de date indiqué ici doit être le même pour toutes les dates du fichier '''''Excel'''''.
| <br>  
+
|}
| <br>  
+
 
| style="text-align: center;" | 25
+
<br>  
| align="center" | <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>  
 +
 
 +
{| width="200" cellspacing="1" cellpadding="1" border="1" class="wikitable"
 
|-
 
|-
| ConTéléphoneBureau
+
| [[Image:ProDon Modules importations 003.png]]<br>
| ConBur
 
| <br>
 
| <br>
 
| style="text-align: center;" | 25
 
| align="center" | <br>
 
 
|-
 
|-
| ConTéléphoneBureauPoste
+
| <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>
| ConBurPoste
+
|}
| <br>  
+
 
| <br>  
+
<br>  
| style="text-align: center;" | 10
+
 
| align="center" | <br>
+
{| width="200" cellspacing="1" cellpadding="1" border="1" class="wikitable"
 
|-
 
|-
| ConTélécopieur
+
| [[Image:ProDon Modules importations 004.png]]<br>
| ConFax
 
| <br>
 
| <br>
 
| style="text-align: center;" | 25
 
| align="center" | <br>
 
 
|-
 
|-
| ConTéléphoneCellulaire
+
| <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>
| ConCell
+
|}
| <br>  
+
 
| <br>  
+
<br>  
| style="text-align: center;" | 25
+
 
| align="center" | <br>
+
{| width="200" cellspacing="1" cellpadding="1" border="1" class="wikitable"
 
|-
 
|-
| ConTéléavertisseur
+
| colspan="2" | [[Image:ProDon Modules importations 005.png]]<br>
| ConPaget
 
| <br>
 
| <br>
 
| style="text-align: center;" | 25
 
| align="center" | <br>
 
 
|-
 
|-
| ConCourriel
+
| colspan="2" | <span style="color: rgb(255, 0, 0);">'''C'''</span>&nbsp;:&nbsp;Options des clients comportent plusieurs onglets.<br>
| ConE-mail
 
| ConEmail
 
| <br>
 
| style="text-align: center;" | 100
 
| align="center" | <br>
 
 
|-
 
|-
| ConSiteInternet
+
| width="50%" | «&nbsp;''Importation''&nbsp;» permet de spécifier quels traitements seront faits par le module.<br>  
| ConWeb
+
| «&nbsp;''Doublons''&nbsp;» permet d'ajouter des détections de doublons supplémentaires à la détection de base.<br>
| <br>  
 
| <br>
 
| style="text-align: center;" | 100
 
| align="center" | <br>
 
 
|-
 
|-
| ConDateNaissance
+
| «&nbsp;''Créer''&nbsp;» permet de forcer la création de certains éléments.<br>
| ConNais
+
| «&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>  
+
 
| style="text-align: center;" | 10
+
<br>  
| align="center" | [[#2con|2]]<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>  
 +
 
 +
{| width="200" cellspacing="1" cellpadding="1" border="1" class="wikitable"
 
|-
 
|-
| ConAppellation
+
| colspan="2" | [[Image:ProDon Modules importations 006.png]]<br>
| ConApp
 
| <br>
 
| <br>
 
| style="text-align: center;" | 50
 
| align="center" | <br>
 
 
|-
 
|-
| ConTitre
+
| colspan="2" | Cette fenêtre permet d'associer les colonnes de votre fichier&nbsp;aux champs correspondants de '''''ProDon'''''.<br>
| <br>
 
| <br>
 
| <br>
 
| style="text-align: center;" | 255
 
| align="center" | <br>
 
 
|-
 
|-
| ConGenre<br>
+
| width="50%" | La colonne «&nbsp;Source&nbsp;» désigne les entêtes du fichier '''''Excel'''''.<br>  
| <br>
+
| La colonne «&nbsp;Destination&nbsp;» désigne les champs de '''''ProDon'''''.<br>
| <br>
 
| '''M''' = Masculin<br>'''F''' = Féminin<br>'''Vide''' = Selon appellation (Monsieur = Masculin / Madame = Fémin)<br>
 
| style="text-align: center;" | 1<br>
 
| align="center" | <br>
 
 
|-
 
|-
| ConCommentaires<br>
+
| La colonne «&nbsp;Constante&nbsp;» permet de spécifier une valeur à utiliser si la ligne correspondante du chiffrier est vide.<br>  
| ConCom<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>
| <br>
 
| <br>
 
| style="text-align: center;" | 5000<br>  
 
| align="center" | [[#pluscon|[+]]]<br>
 
 
|-
 
|-
| ConOrdre<br>
+
| colspan="2" | Dans le cas d'une caractéristique, la colonne contenant la valeur doit être associée à la destination «&nbsp;LibelléDeLaCaractéristique.&nbsp;La note ou les dates de début et fin doivent être associées à la destination «&nbsp;Attaché à LibelléDeLaCaractéristique&nbsp;».
| <br>  
+
|}
| <br>
+
 
| Entre 1 et 10 chiffre<br>
+
<br>  
| style="text-align: center;" | 10<br>
+
 
| align="center" | [[#3con|3]]<br>
+
{| cellspacing="1" cellpadding="1" border="1" style="width: 457px; height: 400px;" class="wikitable"
 
|-
 
|-
| ConOpération<br>
+
| style="text-align: center;" colspan="2" | [[Image:ProDon Modules importations 007.png]]<br>
| <br>
 
| <br>
 
| '''A''' = Ajouter un contact<br>'''M''' = Modifier un contact existant<br>'''D''' = Détruire un contact existant<br>
 
| style="text-align: center;" | 1<br>
 
| align="center" | <br>
 
 
|-
 
|-
| ConLien<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>
| <br>  
 
| <br>  
 
| '''Code''' de type de lien existant<br>
 
| style="text-align: center;" | 25<br>  
 
| align="center" | <br>
 
 
|-
 
|-
| ConLienInverse<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>
| <br>
 
| <br>
 
| '''N''' ou '''F''' = Non ('''Vide''' = Non)<br>'''O''' ou '''V''' = Oui<br>  
 
| style="text-align: center;" | 1<br>
 
| align="center" | <br>
 
 
|-
 
|-
| ConDateDebut<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>
 
| <br>
 
| style="text-align: center;" | 10<br>  
 
| align="center" | [[#2con|2]]<br>
 
|-
 
| ConDateFin<br>
 
| <br>
 
| <br>
 
| <br>
 
| style="text-align: center;" | 10<br>
 
| align="center" | [[#2con|2]]<br>
 
 
|}
 
|}
  
'''{{Anchor|[+]|pluscon}}'''&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.
+
<br>
  
'''{{Anchor|1|1con}}'''&nbsp;: Champ obligatoire sauf si on ajoute un nouveau contact. En lien avec ConOpération.  
+
En cliquant sur [[Image:Bouton Sommaire analyse.png]] la fenêtre suivante apparaît.<br>
  
'''{{Anchor|2|2con}}'''&nbsp;: 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.
+
{| width="200" cellspacing="1" cellpadding="1" border="1" class="wikitable"
 +
|-
 +
| colspan="2" |  
 +
<br>[[Image:ProDon Modules importations 008.png]]
  
'''{{Anchor|3|3con}}'''&nbsp;: Le comportement de cette valeur est dictée par l'opération indiquée dans ConOpération.  
+
[[Image:ProDon Modules importations 009.png|584x207px]]<br>
  
En destruction, l'ordre est inutile. Sinon, une procédure détermine le numéro à utiliser afin d'éviter des incohérences.  
+
|-
 +
| Cette fenêtre vous permet de voir chacune des colonnes pour chacun des clients qui seront importés.<br>
 +
|-
 +
| Le bouton [[Image:Bouton Engrenage.png]]&nbsp;lance une analyse préliminaire.&nbsp;C'est l'étape ou vous devez vérifier l'intégrité de vos données.<br>
 +
|-
 +
| '''''ProDon''''' compare alors les informations à importer avec votre base de données actuelle.<br>
 +
|}
  
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.
+
<br>
  
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.  
+
{| width="200" cellspacing="1" cellpadding="1" border="1" class="wikitable"
 +
|-
 +
| [[Image:ProDon Modules importations 011.png]]<br>
 +
|-
 +
| Des notes seront inscrites dans les cases appropriées si présence de doublons potentiels, d'erreurs ou d'autres avertissements.<br>
 +
|}
  
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&nbsp;:
+
<br>
  
#Les contacts ayant déjà un ordre plus grand que 0 sont attribués en premier.
+
Un code de couleur facilite le repérage des clients problématiques.<br>
#Si deux contacts obtiennent le même numéro d'ordre, le contact le plus récent conservera son numéro d'ordre.
 
#Les contacts ayant un ordre 0 obtiendront leur ordre en dernier.
 
  
=== Liste des champs liens  ===
+
{| width="372" cellspacing="1" cellpadding="1" border="1" style="" class="wikitable"
 
 
{| width="100%" cellspacing="1" cellpadding="1" border="1" class="wikitable sortable"
 
|-
 
! scope="col" | Libellé complet
 
! scope="col" | Abrégé 1
 
! scope="col" | Abrégé 2
 
! scope="col" | Valeurs possibles
 
! width="75" align="center" scope="col" | Longeur maximale
 
! width="90" scope="col" | Particularité
 
|-
 
| NUC2
 
| NoClient2<br>
 
| NoCli2<br>
 
| '''NUC''' existant du client à lier<br>
 
| style="text-align: center;" | 7<br>
 
| align="center" | <br>
 
 
|-
 
|-
| NoRéférence2<br>
+
! scope="col" | Statut
| Réf2<br>
+
! width="400" scope="col" | Description
| NoRéf2<br>
 
| '''Numéro de référence''' existant du client à lier<br>
 
| style="text-align: center;" | 25<br>
 
| align="center" | <br>
 
 
|-
 
|-
| LienOpération<br>
+
| rowspan="4" | [[Image:ProDon Modules importations 010.png|126x92px]]
| <br>
+
| Il y a une erreur pour ce client.
| <br>
 
| '''A''' = Ajouter<br>'''D''' = Détruire<br>'''I''' = Ignorer
 
| style="text-align: center;" | 1<br>
 
| align="center" | <br>
 
 
|-
 
|-
| Lien<br>
+
| Tout est en ordre.
| <br>
 
| <br>
 
| '''Code''' de type de lien existant<br>
 
| style="text-align: center;" | 25<br>
 
| align="center" | <br>
 
 
|-
 
|-
| LienInverse<br>
+
| Il y a un avertissement.
| <br>
 
| <br>
 
| '''N''' ou '''F''' = Non ('''Vide''' = Non)<br>'''O''' ou '''V''' = Oui
 
| style="text-align: center;" | 1<br>
 
| align="center" | <br>
 
 
|-
 
|-
| LienType<br>
+
| Il y a un avertissement validé.
| <br>
 
| <br>
 
| '''L''' = Lien'''&nbsp;'''('''Vide''' = Lien)<br>'''C''' = Contact
 
| style="text-align: center;" | 1<br>
 
| align="center" | <br>
 
|-
 
| LienDateDébut<br>
 
| <br>
 
| <br>
 
| <br>
 
| style="text-align: center;" | 10<br>
 
| align="center" | [[#1lien|1]]<br>
 
|-
 
| LienDateFin
 
|
 
|
 
|
 
| style="text-align: center;" | 10
 
| align="center" | [[#1lien|1]]
 
|-
 
| LienNote
 
|
 
|
 
|
 
| style="text-align: center;" | 5000
 
| align="center" |
 
 
|}
 
|}
 
'''{{Anchor|1|1lien}}'''&nbsp;: 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.&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 champ client.&nbsp; Ceci permettera de trouver le client s'il existe déjà ou de le créer dans le cas contraire.<br>
 
  
 
<br>  
 
<br>  
 
L'importation de reçus est possible uniquement vers des transactions déjà existante 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>
 
  
 
<br>  
 
<br>  
  
=== Champs obligatoire pour la création de transactions<br>  ===
+
En double-cliquant sur une ligne, vous&nbsp;verrez s'ouvrir&nbsp;la fenêtre suivante.
  
(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
+
{| width="200" cellspacing="1" cellpadding="1" border="1" class="wikitable"
 +
|-
 +
| 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;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);">'''C'''</span>&nbsp;: Une liste de tous les autres champs ainsi que l'information qu'ils contiennent.
 +
| <br>
 +
|}
  
 
<br>  
 
<br>  
  
=== Champs obligatoire pour la création de reçus  ===
+
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>'''  
 
 
RecNoTrx
 
 
 
'''ET'''  
 
 
 
RecNoReçu
 
 
 
=== Liste des champs transactions  ===
 
 
 
=== Liste des champs reçus ===
 
  
== Module d'importation d'engagement ==
+
== Utilitaires disponibles sur demande ==
  
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.<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).
  
 
<br>  
 
<br>  
  
=== Champs obligatoires pour la création d'un engagement de type «&nbsp;Objectif&nbsp;»<br>  ===
+
{{BasPage_ProDon_Version|4.6.3.25}}<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>
 
 
 
=== 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> 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 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'''''.&nbsp; Lors de l'installation de ce programme, vous devrez configurer certaines information une première fois avant de planifier la tâche windows.&nbsp; Ensuite vous pourre planifier votre tâche avec les paramètres suivants.<br>
 
 
 
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 ».<br>Exemple : C:\Logilys\ProDon\ImportAuto.Exe [paramètre]
 
 
 
 
 
 
 
/n=15<br>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<br>« 2 » 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>
 
 
 
 
 
 
 
/u=SUPERVISEUR<br>« SUPERVISEUR » 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>
 
 
 
 
 
 
 
/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 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.<br>Les guillemets anglais sont utilisés pour encadrer le nom du fichier afin que les espaces soient bien reconnus.
 
 
 
 
 
 
 
/i<br>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<br>Si ce paramètre n’est pas présent, l’importation n’aura pas lieu
 
 
 
 
 
 
 
/d<br>Si ce paramètre est présent, le fichier utilisé pour le chargement ou l'importation sera détruit.<br><br>
 

Version actuelle datée du 22 avril 2022 à 14: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