ProDon:Importation Modules

General Explanations

Les modules sont tous regroupés en un même endroit. Vous avez la possibilité d’analyser vos données The modules are all grouped in a single location. You can analyze your data before confirming the import to detect any errors that might have slipped into the data. Because the modules are independent, you will only be able to access features offered by the module(s) that you own.

Importing is generally performed from an Excel file saved in .CSV format. Because this file type uses a semicolon (;) as a delimiter, you must ensure that the data do not contain semicolons. Import of .TXT files is also supported, but if you use this file type you will need to indicate both the delimiter that separates data entries as well as the text qualifier that indicates the beginning and end of an entry.

The first row in the file contains column headers. To facilitate the process, the headers should match the labels or abbreviations used in the relevant sections.

Labels are not case-sensitive and do not take accented characters into account, except for the cedilla (ç).

The contents of the Specific Properties column are clickable and point toward an explanation.

The required fields for each type of import are indicated above the corresponding list in the field list.

List of fields that are shared by all modules

Shared fields are used mainly to link a file that you wish to import to your database. If both fields contain data, the UCN will take precedence.

Full Label	Abbreviation 1	Abbreviation 2	Possible Values	Maximum Length	Specific Properties
UCN	NoClient	NoCli	Existing client number	7
ReferenceNo	Ref.	RefNo		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 OR CliCompany

AND

CliCharacteristicLabel (if characteristics are required for clients in ProDon)

Required fields for detecting duplicates

(CliFirstName AND CliName) OR CliCompany

AND

CliAddress

AND

CliPostalCode

Required fields for creating contacts

ConOperation

AND

ConLink

Required fields for creating links

UCN2 OR ReferenceNo2

AND

LinkOperation

AND

Link

You can view the complete list of clients, contacts and liens fields, as well as their specific properties.

Transaction import module

When used by itself, the transaction import module allows you to create transactions for clients that already exist in ProDon and requires that you use the UCN or ReferenceNo field in order to link each client to the corresponding transaction being created. If you have the client import module, you can replace the UCN or ReferenceNo field with a series of client fields. This will enable the system to retrieve a given client if it already exists or to create the client if it does not already exist.

Receipts can only be imported into transactions that already exist in ProDon.  Caution:  if you import a receipt into a transaction that already has one, the import will overwrite the existing receipt.

Required fields for creating transactions

(UCN or ReferenceNo) OR (((CliFirstName and CliName) or CliCompany) AND (CliAddress and CliPostalCode))
AND
TrxOccasionCode
AND
TrxActivityCode (if marked as required in the selected occasion)
AND<brTrxGLCode (if marked as required in the activity AND no account is selected in the activity)
AND
TrxGiftAmount OR TrxQuantity
AND
TrxPaymentMethod AND related fields if payment is electronic (card number, account number, RIB key, etc.)
AND
TrxCharacteristicLabel if characteristics are required for the transactions

Required fields for creating receipts

RecNoTrx

ET

RecNoReçu

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

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 permettera de trouver le client s'il existe déjà ou de le créer dans le cas contraire.

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

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

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

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

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

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.

Tous les champs sont obligatoires à l'exception des cases à cocher et de la note.
Pour le fichier, cliquez sur 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 vous accéderez à une ou plusieurs boîtes d'options (en fonction des modules actifs et du type d'importation choisi).

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­.

B : Options des transactions vous permettant de forcer la création de certains éléments.

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 (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.

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 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 ».

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 la fenêtre suivante apparaît.

Cette fenêtre vous permet de voir chacune des colonnes pour chacun des clients qui seront importés.

Le bouton  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.

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.

A : 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 (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.

Utilitaire d'importation automatique

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

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

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

/n=15
Ce paramètre est obligatoire

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

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

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

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

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

/d
Si ce paramètre est présent, le fichier utilisé pour le chargement ou l'importation sera détruit.
---- Document name: ProDon:Importation Modules

Printable version