ProDon:Modules d'importation : Différence entre versions
m |
(Balise : Éditeur visuel) |
||
(34 révisions intermédiaires par 4 utilisateurs non affichées) | |||
Ligne 1 : | Ligne 1 : | ||
− | {{ | + | {{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. 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.<br><br>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. | 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.<br><br>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. | ||
− | <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 | + | 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. 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. 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" |
|- | |- | ||
! 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" | + | ! 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 105 : | Ligne 106 : | ||
'''<br>''' | '''<br>''' | ||
− | Vous pouvez consulter la liste complète des champs [[ProDon:Module d'importation clients#Liste_des_champs_clients| | + | ==== Liste complète des champs clients, contacts et liens ==== |
+ | |||
+ | {| width="480" cellspacing="1" cellpadding="1" border="1" class="wikitable" | ||
+ | |- | ||
+ | ! scope="col" | Vous pouvez consulter la liste complète des champs clients, contacts et liens, ainsi que leurs particularités. | ||
+ | |- | ||
+ | | [[ProDon:Module d'importation clients#Liste_des_champs_clients|Clients]] | ||
+ | |- | ||
+ | | [[ProDon:Module d'importation clients#Liste_des_champs_contacts|Contacts]] | ||
+ | |- | ||
+ | | [[ProDon:Module d'importation clients#Liste_des_champs_liens|Liens]] | ||
+ | |} | ||
== Module d'importation de transaction == | == 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 | + | 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.<br><br>L'importation de reçus est possible uniquement vers des transactions déjà existantes dans '''''ProDon'''''. '''Attention : '''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> |
==== Champs obligatoires pour la création de transactions<br> ==== | ==== Champs obligatoires pour la création de transactions<br> ==== | ||
Ligne 125 : | Ligne 137 : | ||
<br> | <br> | ||
− | Vous pouvez consulter la liste complète des champs [[ProDon:Module d'importation transactions#Liste_des_champs_transaction| | + | ==== Liste complète des champs transactions et reçus ==== |
+ | |||
+ | {| width="480" cellspacing="1" cellpadding="1" border="1" class="wikitable" | ||
+ | |- | ||
+ | ! scope="col" | Vous pouvez consulter la liste complète des champs transactions et reçus, ainsi que leurs particularités. | ||
+ | |- | ||
+ | | [[ProDon:Module d'importation transactions#Liste_des_champs_transaction|Transactions]] | ||
+ | |- | ||
+ | | [[ProDon:Module d'importation transactions#Liste_des_champs_re.C3.A7us|Reçus]] | ||
+ | |} | ||
== 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 | + | 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> |
− | |||
+ | <br> | ||
==== Champs obligatoires pour la création d'un engagement de type « Objectif »<br> ==== | ==== Champs obligatoires pour la création d'un engagement de type « Objectif »<br> ==== | ||
Ligne 143 : | Ligne 164 : | ||
<br> | <br> | ||
− | Vous pouvez consulter la liste complète des champs [[ProDon:Module d'importation engagements| | + | ==== Liste complète des champs engagements ==== |
+ | |||
+ | {| width="480" cellspacing="1" cellpadding="1" border="1" class="wikitable" | ||
+ | |- | ||
+ | ! scope="col" | Vous pouvez consulter la liste complète des champs engagements, ainsi que leurs particularités. | ||
+ | |- | ||
+ | | [[ProDon:Module d'importation engagements|Engagements]] | ||
+ | |} | ||
== Configuration et processus général d'importation == | == Configuration et processus général d'importation == | ||
Ligne 215 : | Ligne 243 : | ||
<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. 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. 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" | {| width="200" cellspacing="1" cellpadding="1" border="1" class="wikitable" | ||
Ligne 234 : | Ligne 262 : | ||
<br> | <br> | ||
− | {| cellspacing="1" cellpadding="1" border="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> |
|- | |- | ||
| width="50%" | <span style="color: rgb(255, 0, 0);">'''A'''</span> : 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> : 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> | ||
Ligne 277 : | Ligne 305 : | ||
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> | ||
− | {| cellspacing="1" cellpadding="1" border="1" style=" | + | {| width="372" cellspacing="1" cellpadding="1" border="1" style="" class="wikitable" |
|- | |- | ||
− | | | + | ! scope="col" | Statut |
+ | ! width="400" scope="col" | Description | ||
|- | |- | ||
− | | Il y a une erreur pour ce client. | + | | rowspan="4" | [[Image:ProDon Modules importations 010.png|126x92px]] |
+ | | Il y a une erreur pour ce client. | ||
|- | |- | ||
− | | Tout est en ordre. | + | | Tout est en ordre. |
|- | |- | ||
− | | Il y a un avertissement | + | | Il y a un avertissement. |
|- | |- | ||
− | | Il y a un avertissement validé. | + | | Il y a un avertissement validé. |
|} | |} | ||
+ | |||
+ | <br> | ||
<br> | <br> | ||
Ligne 298 : | Ligne 330 : | ||
| 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 '''</span>: Un résumé de la fiche client. Les boutons à droite de la ligne « | + | | width="50%" | <span style="color: rgb(255, 0, 0);">'''A '''</span>: Un résumé de la fiche client. Les boutons à droite de la ligne « Ligne/Doublon » permettent d'assigner manuellement un doublon à une fiche. |
| <span style="color: rgb(255, 0, 0);">'''B'''</span> : 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> : 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> : Une liste de tous les autres champs ainsi que l'information qu'ils contiennent. | | <span style="color: rgb(255, 0, 0);">'''C'''</span> : 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. '''<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. '''<span style="color: rgb(255, 0, 0);">ATTENTION, CETTE PROCÉDURE EST DÉFINITIVE.</span>''' |
− | == | + | == Utilitaires disponibles sur demande == |
− | L’utilitaire d’importation automatique est un programme console qu’on appelle à partir d’une tâche planifiée Windows | + | *[[ProDon:Utilitaire d'importation automatique|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. |
+ | *[[Fonctions communes:Utilitaire de téléchargement FTP|Utilitaire de téléchargement FTP]] : Permet de télécharger des fichiers sur un serveur FTP (pour effectuer une importation automatique par exemple). | ||
− | + | <br> | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | <br> | ||
− | + | {{BasPage_ProDon_Version|4.6.3.25}}<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 ProDon. Attention : 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 ».
Cliquez sur pour créer un nouveau modèle d'importation. |
En cliquant sur vous accéderez à une ou plusieurs boîtes d'options (en fonction des modules actifs et du type d'importation choisi).
|
B : Options des transactions vous permettant de forcer la création de certains éléments. |
En cliquant sur (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.
En cliquant sur la fenêtre suivante apparaît.
|
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 |
---|---|
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.
En cliquant sur (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