Exemple de fichier d'import (en ASCII)
Type de fichier
|
Texte délimité
|
Commentaires
|
À tout endroit du fichier, il est permis de mettre des lignes de commentaires. Ces lignes de commentaires commencent par //.
|
Lignes vides
|
À tout endroit du fichier, il est permis de mettre des lignes vides. L'import ne sera pas rejeté en raison des lignes vides.
|
Balise de début de fichier
|
Nom de la balise
|
Explications
|
[BOF]
|
•Le fichier doit commencer par la balise de début de fichier [BOF] (« Beginning of file »). Cependant, il peut y avoir des lignes de commentaires ou des lignes vides avant cette balise. •Si cette balise est absente du fichier, l'import sera rejeté. •Toutes les données avant cette balise, exception faite des lignes de commentaires ou des lignes vides, ne sont pas permises et causeront l'interruption de l'import. •Sur la ligne suivant la balise de début de fichier, vous pouvez spécifier les paramètres généraux de l'import. |
|
|
Balise de fin de fichier
|
Nom de la balise
|
Explications
|
[EOF]
|
•Le fichier doit se terminer par la balise de fin de fichier [EOF] (« End of file »). Cependant, il peut y avoir des lignes de commentaires ou des lignes vides après cette balise. •Si cette balise est absente du fichier, l'import sera rejeté. •Toutes les données après cette balise, exception faite des lignes de commentaires ou des lignes vides, ne sont pas permises et causeront l'interruption de l'import. |
|
|
Balise de section
|
Le fichier d'import peut comprendre une ou plusieurs balises de sections. Chaque balise de section correspond au type de données qui sera importé.
Éléments à vérifier
|
Description
|
Format des balises de section
|
•Le nom de la balise de section est inscrit entre les caractères « [ » et « ] », par exemple, [DossiersEmployes]. •Le nom de la balise de section peut être inscrit en majuscules, en minuscules ou en utilisant une combinaison de majuscules et minuscules. Le système ne tient pas compte de la casse dans le nom de la balise de section. |
|
Noms des balises de section
|
Seules certaines balises de section sont acceptées. Si vous précisez une balise de section non supportée, l'import sera rejeté.
|
Utilisation unique d'une balise de section dans le même fichier d'import
|
La même balise de section ne peut pas être utilisée plus d'une fois dans le même fichier d'import. Si vous précisez la même balise de section plusieurs fois, l'import sera rejeté.
|
Ordre des balises de section
|
Si plusieurs balises de section figurent dans le même fichier d'import, l'ordre de ces balises n'a pas d'importance. C'est le programme d'import qui gère l'ordre d'exécution des diverses données à charger afin d'éviter les rejets.
|
Paramètres disponibles pour certaines balises de section
|
Sur la ligne suivant une balise de section, vous pouvez inclure, pour certaines balises de section, des paramètres de configuration spécifiques aux données à importer dans cette section.
|
Début d'une nouvelle section
|
Une section se termine lorsqu'une nouvelle balise de section est trouvée.
|
|
|
Paramètres généraux
|
Des paramètres généraux peuvent être précisés pour l'ensemble du fichier d'import.
•Peuvent être précisés sur la ligne suivant la balise de début de fichier [BOF]. •Chaque paramètre doit se retrouver sur une ligne distincte. |
|
Paramètres spécifiques aux balises de section
|
Des paramètres spécifiques aux balises de section peuvent modifier la façon dont l'import sera fait pour les données dans une section précise.
Question
|
Réponse
|
Est-ce que les paramètres spécifiques sont obligatoires?
|
Non. Les paramètres spécifiques aux sections de données ne sont pas obligatoires.
•Si aucun paramètre n'est spécifié, une valeur par défaut sera appliquée. •Si des paramètres sont indiqués dans une section, mais que les données à importer ne sont pas présentes, alors les paramètres ne seront pas considérés, aucune donnée ne sera importée dans cette section et l'import se poursuivra si aucune autre erreur n'est présente. •Il n'est pas obligatoire de spécifier une valeur pour chaque paramètre possible. En fait, seulement les noms des paramètres pour lesquelles la valeur par défaut n'est pas requise doivent se retrouver dans la section. •Si le nom du paramètre est présent, mais que la valeur du paramètre est absente, alors l'import sera rejeté et aucune donnée ne sera importée. |
|
Est-ce que toutes les sections de données permettent l'utilisation de paramètres spécifiques?
|
Non. Seules certaines sections de données permettent l'inscription de paramètres. Consultez le tableau synthèse pour connaître les sections de données permettant l'inscription de paramètres.
Les paramètres possibles et les valeurs acceptées pour chaque paramètre varient selon les sections.
|
|
Où doit-on saisir les paramètres spécifiques dans le fichier d'import?
|
•Peuvent être précisés sur la ligne suivant la balise de section, mais avant la première ligne de données à importer. •Chaque paramètre doit se retrouver sur une ligne distincte. |
|
Comment doit-on saisir les paramètres spécifiques dans le fichier d'import?
|
•Chaque paramètre doit commencer par le caractère < et se terminer par les caractères />. •Le nom du paramètre et sa valeur doivent être séparés par le caractère =. Il n'y aucun espacement entre le nom du paramètre, le = et la valeur du paramètre. Exemple : < AssignationPoste=FermerEtAssigner />
|
|
|
|
Titres des colonnes
|
Dans chacune des balises de section, le fichier d'import doit comprendre des titres des colonnes, c'est-à-dire les étiquettes correspondant aux divers champs qui peuvent être importés pour chaque enregistrement.
Exemple de titres de colonnes (en ASCII)
Éléments à vérifier
|
Description
|
Emplacement des titres des colonnes
|
Les titres des colonnes doivent figurer sur la ligne suivant la balise de section ou sur la ligne suivant les paramètres spécifiques à cette balise de section, si ces paramètres sont utilisés.
|
|
Caractère séparateur de titre de colonne
|
Le caractère séparateur peut être défini dans le paramètre général SeparateurDeChamp du fichier d'import. Par défaut, c'est le caractère « | » (barre verticale) qui est utilisé, cependant, vous pouvez configurer un autre caractère, au besoin, par exemple le point-virgule.
Attention : Le dernier titre de colonne ne doit pas être suivi du caractère séparateur configuré dans le paramètre général. Si ce caractère est présent à la fin de la ligne, l'import est rejeté.
|
|
Titres de colonnes pour champs nécessaires seulement
|
Il n'est pas obligatoire de spécifier une valeur pour chaque champ figurant actuellement dans la base de données. En fait, seulement les étiquettes (« titre de colonne ») des champs qui doivent être importés doivent se retrouver dans la section.
|
Champs obligatoires
|
Certains champs sont obligatoires que ce soit en ajout ou en modification. Il faut donc que ces champs soient toujours présents dans le fichier d'import.
|
Format des titres des colonnes
|
Les étiquettes de champs figurant dans les titres des colonnes doivent respecter un format préétabli.
Pour en savoir davantage sur les étiquettes des champs pouvant être utilisées, consultez le tableau synthèse qui vous rédigera vers la rubrique appropriée.
|
|
Ordre des colonnes
|
Il n'est pas nécessaire de placer les titres des colonnes selon l'ordre des champs visibles dans la base de données. Par exemple en format ASCII, lors de l'import, le système ne fait pas la distinction entre les deux lignes suivantes :
EmpCodeStructure1|EmpCodeStructure2
EmpCodeStructure2|EmpCodeStructure1
|
|
|
|
Lignes de données à importer
|
Dans chacune des balises de section, le fichier d'import doit comprendre les données à importer.
Exemple de lignes de données (en ASCII)
Éléments à vérifier
|
Description
|
Emplacement de la valeur à importer
|
•La valeur qui doit être importée dans chaque champ se retrouve dans la colonne correspondant à l'étiquette précisée dans les titres des colonnes. •Sous la ligne réservée aux titres des colonnes, le fichier doit comporter la ou les lignes des données devant être importées pour un enregistrement donné dans cette section de données. |
|
Caractère séparateur de titre de colonne
|
Les valeurs à importer doivent être séparées par le caractère défini dans le paramètre général SeparateurDeChamp du fichier d'import. Par défaut, c'est le caractère « | » qui est utilisé, cependant, vous pouvez configurer un autre caractère, au besoin, par exemple le point-virgule.
Attention : La dernière valeur à importer sur une ligne ne doit pas être suivie du caractère séparateur configuré dans le paramètre général. Si ce caractère est présent à la fin de la ligne, l'import est rejeté.
|
|
Format des données pouvant être importées
|
Le format des données pouvant être importées dans chaque champ est variable. Cependant, il existe des règles standard pour les éléments suivants :
•Caractère séparateur de ligne = CRLF •Caractère entourant les chaînes de caractères = Aucun •Caractère délimiteur de décimales = Point •Caractère délimiteur des milliers = Aucune •Format des dates = AAAAMMJJ •Format des heures = HHMM •Case à cocher = 0 = Non cochée, 1 = Cochée |
|
Supprimer la valeur d'un champ figurant dans la base de données
|
Il faut spécifier le caractère ~ dans l'espace réservé à la valeur.
|
Conserver la valeur d'un champ figurant dans la base de données
|
Il faut que la valeur soit absente dans la ligne de données alors que l'étiquette du champ est présente dans les titres de colonnes, c.-à-d. il faut que le champ soit vide.
|
|
|
|
