Information de concept
Crée une table Analytics en définissant et en important une feuille de calcul Microsoft Excel ou une plage nommée.
Remarque
La version 32 bits du moteur de base de données Microsoft Access doit être installée pour que la commande IMPORT EXCEL fonctionne avec des fichiers Excel utilisant l'ancien format (*.xls). Pour plus d'informations, consultez la section Exclure le moteur de base de données Microsoft Access facultatif.
Syntaxe
IMPORT EXCEL TO table nom_fichier_importation FROM nom_fichier_source TABLE feuille_calcul_ou_plage_nommée_entrée <KEEPTITLE> <STARTLINE numéro_ligne> <ALLCHAR> {ALLFIELDS|CHARMAX longueur_champ_max|[syntaxe_champ] <...n> <IGNORE num_champ> <...n>} <OPEN>
syntaxe_champ ::=
FIELD nom_importation type {PIC format|WID caractères DEC valeur} AS nom_affichage
Remarque
Vous devez indiquer les paramètres IMPORT EXCEL exactement dans le même ordre que ci-dessus et dans le tableau ci-dessous.
Analytics ne peut pas importer de données d'un classeur Excel si le mode Vue protégée est actif pour ce classeur. Vous devez d'abord activer le mode édition dans le classeur, l'enregistrer et le fermer puis procéder à l'importation.
Paramètres
Nom | Description |
---|---|
TO table |
Nom de la table Analytics dans laquelle les données doivent être importées. Remarque La longueur des noms des tables est limitée à 64 caractères alphanumériques. Le nom peut inclure le caractère de soulignement ( _ ), mais aucun autre caractère spécial ni espace. Le nom ne peut pas commencer par un chiffre. |
nom_fichier_importation |
Nom du fichier de données Analytics à créer. Indiquez nom_fichier_importation sous forme de chaîne entre guillemets avec une extension de fichier .FIL. Par exemple, "Factures.FIL". Par défaut, le fichier de données (.FIL) est enregistré dans le dossier contenant le projet Analytics. Utilisez un chemin de fichier absolu ou relatif pour enregistrer le fichier de données dans un autre dossier existant :
|
FROM nom_fichier_source |
Nom du fichier de données source. nom_fichier_source doit être une chaîne entre guillemets. Si le fichier de données source n'est pas enregistré dans le même répertoire que le projet Analytics, vous devez utiliser un chemin d'accès absolu ou un chemin d'accès relatif pour indiquer l'emplacement du fichier :
|
TABLE feuille_calcul_ou_plage_nommée |
La feuille de calcul ou la plage nommée à importer à partir du fichier de données source Excel. Conditions requises requises pour l'installation :
|
KEEPTITLE optionnel |
|
STARTLINE numéro_ligne optionnel |
Numéro de la ligne à laquelle commencer la lecture de la feuille de calcul. Par exemple, si les trois premières lignes d'une feuille de calcul contiennent des informations d'en-tête qui ne vous intéressent pas, spécifiez STARTLINE 4 pour commencer la lecture des données à la quatrième ligne. Si vous omettez STARTLINE, la ligne de début est la première ligne de la feuille de calcul. Remarque La ligne de début d'une plage nommée est toujours la première ligne de la plage nommée, quel que soit le paramètre STARTLINE. |
ALLCHAR optionnel |
Le type de données caractère est automatiquement attribué à tous les champs importés. Astuce Affecter le type de données caractère à tous les champs importés simplifie le processus d'importation des fichiers Excel. Une fois que les données sont dans Analytics, vous pouvez affecter différents types (Numérique ou DateHeure par exemple) de données aux champs et en spécifier les informations de format. ALLCHAR s'avère utile si vous importez une table dans laquelle le type de données Numérique est affecté automatiquement aux champs des identificateurs par Analytics alors qu'en réalité, ils devraient utiliser le type de données Caractère. |
ALLFIELDS |
Tous les champs du fichier de données source sont importés. Remarque Si vous spécifiez ALLFIELDS, n'indiquez aucune syntaxe FIELD individuelle ni IGNORE. |
CHARMAX longueur_champ_max |
La longueur maximale en caractères d'un champ de la table Analytics qui provient d'une donnée de type caractère dans le fichier Excel de données source. Les données dans le fichier Excel dépassant la longueur de champ maximale sont tronquées lors de l'importation dans Analytics. Tous les champs du fichier Excel, quel que soit le type de données, sont importés. Remarque Si vous spécifiez CHARMAX, n'indiquez aucune syntaxe FIELD individuelle ni ALLFIELDS ou IGNORE. |
FIELD nom_importation type |
Les champs individuels à importer à partir du fichier de données source, y compris le nom et le type de données du champ. nom_importation devient le nom de champ dans la table Analytics. nom_importation ne doit pas forcément être identique au nom de champ dans le fichier de données source, même si cela peut être le cas. Astuce Vous pouvez utiliser AS en plus pour indiquer un nom d'affichage différent de nom_importation. type devient le type date du champ dans la table Analytics. type ne doit pas forcément être identique au type de données du champ dans le fichier de données source, même si cela peut être le cas. Pour plus d'informations sur le type, consultez la rubrique Identificateurs des types de données de champ. Remarque Si vous spécifiez ALLCHAR, le type est ignoré. Si vous spécifiez la syntaxe FIELD individuelle, n'indiquez pas ALLFIELDS ou CHARMAX. Exclure un champPour empêcher l'importation d'un champ, ne l'indiquez pas. Vous devez aussi indiquer IGNORE pour les champs exclus. |
PIC format |
Remarque S'applique aux champs numériques ou DateHeure.
Le format doit être placé entre guillemets. |
WID caractères |
La longueur du champ en caractères dans le format de la table Analytics. |
DEC valeur |
Nombre de décimales contenues par les champs numériques |
AS nom_affichage |
Le nom d'affichage (titre de la colonne) pour le champ dans la vue dans la nouvelle table Analytics. Indiquez le nom_affichage sous forme de chaîne entre guillemets. Utilisez un point-virgule (;) entre les mots si vous souhaitez insérer un saut de ligne dans le titre de la colonne. AS est requis lors de la définition de FIELD. Pour que le nom d'affichage soit identique au champ nom, saisissez une valeur nom_affichage vide à l'aide de la syntaxe suivante : AS "". Vérifiez qu'il n'y a aucune espace entre les deux guillemets doubles. |
IGNORE num_champ <...n> optionnel |
Exclut le champ du format de table. num_champ indique la position du champ exclus dans le fichier de données source. Par exemple, IGNORE 5 exclut le cinquième champ du fichier de données source du format de la table Analytics. Remarque Veillez à aligner correctement num_champ avec la position des champs exclus. Si vous spécifiez num_champ pour un champ inclus (définition FIELD) ou pour une position de champ inexistante, l'importation ne fonctionne pas correctement. Le nombre de paramètres FIELD et IGNORE combinés doit être égal au nombre total de champs dans la table de données source. Si les nombres totaux ne correspondent pas, l'importation ne fonctionne pas correctement. Si vous spécifiez ALLFIELDS ou CHARMAX, n'indiquez pas IGNORE. |
OPEN optionnel |
Ouvre la table créée par la commande après l'exécution de la commande. Valide uniquement lorsque la commande crée une table de sortie. |
Exemples
Importer des champs spécifiés
Vous effectuez une importation définissant une nouvelle table Analytics appelée Cartes_crédit. Elle utilise la première ligne de données Excel comme noms de champs.
Dans les douze champs de la table source, la table Analytics définit et inclut trois champs de la table source, et exclut neuf champs :
IMPORT EXCEL TO Cartes_Crédit "Cartes Crédit.fil" FROM "Cartes_Crédit_Metaphor.xls" TABLE "Cartes_Crédit_Entreprise$" KEEPTITLE FIELD "NUMCARTE" C WID 16 AS "Numéro de carte" FIELD "DATEEXP" D WID 10 PIC "AAAA-MM-JJ" AS "Date Expiration" FIELD "MONTECHU" N WID 6 DEC 2 AS "Montant Échu" IGNORE 2 IGNORE 3 IGNORE 5 IGNORE 6 IGNORE 7 IGNORE 9 IGNORE 10 IGNORE 11 IGNORE 12
Importer tous les champs
Vous effectuez une importation définissant une nouvelle table Analytics appelée Transactions_mai. Elle utilise la première ligne de données Excel comme noms de champs.
La table Analytics inclut tous les champs de la table source et elle utilise les définitions de champs par défaut.
Longueur de champ définie sur la valeur la plus longue
Dans le premier exemple, les champs à l'origine des données de type caractère dans le fichier de données source sont définis sur la longueur de la valeur la plus longue dans le champ :
IMPORT EXCEL TO Transactions_Mai "Transactions_Mai.fil" FROM "Trans_Mai.xls" TABLE "Trans1_Mai$" KEEPTITLE ALLFIELDS
Longueur de champ limitée
Dans le deuxième exemple, les champs à l'origine des données de type caractère dans le fichier de données source sont définis sur la longueur de la valeur la plus longue dans le champ ou sur la valeur CHARMAX de 50 caractères si elle est plus courte :
IMPORT EXCEL TO Transactions_Mai "Transactions_Mai.fil" FROM "Trans_Mai.xls" TABLE "Trans1_Mai$" KEEPTITLE CHARMAX 50
Importer tous les champs comme données caractère
Vous effectuez une importation définissant une nouvelle table Analytics appelée Transactions_mai. Tous les champs, y compris les nombres et les dates, sont importés sous forme de données caractères.
IMPORT EXCEL TO Transactions_Mai "Transactions_Mai.fil" FROM "Trans_Mai.xls" TABLE "Trans1_Mai$" KEEPTITLE ALLCHAR ALLFIELDS
Importer tous les champs sous forme de données caractères, sauter les informations d'en-tête
Vous effectuez une importation définissant une nouvelle table Analytics appelée Rapport_échéance_passée.
Vous sautez les deux premières lignes du fichier Excel, qui contiennent les informations d'en-tête du rapport, et vous commencez à lire le fichier à la troisième ligne, qui contient les noms des champs. Tous les champs, y compris les nombres et les dates, sont importés sous forme de données caractères.
IMPORT EXCEL TO Rapport_échéance_passée "Rapport_échéance_passée.fil" FROM "Rapport_échéance_passée.xlsx" TABLE "Feuil1$" KEEPTITLE STARTLINE 3 ALLCHAR ALLFIELDS
Remarques
Pour plus d'informations sur le fonctionnement de cette commande, consultez Importer des données Microsoft Excel.
Définissez les champs un à un ou bien importez tous les champs à l'aide d'une définition par défaut
Lorsque vous importez un fichier Excel dans une table Analytics, vous pouvez utiliser les paramètres FIELD pour définir chaque champ individuellement ou vous pouvez utiliser le paramètre ALLFIELDS ou le paramètre CHARMAX pour importer tous les champs avec les définitions de champ Analytics par défaut.
Différentes combinaisons de paramètres produisent différents résultats. Le tableau ci-dessous résume les différentes possibilités.
Remarque
« Définir » signifie qu'il faut spécifier manuellement des éléments tels que le nom des champs, le type de données, la longueur, le format DateHeure, etc.
Je souhaite : | Utiliser ces paramètres : | Ne pas utiliser ces paramètres : |
---|---|---|
|
ALLFIELDS | CHARMAX, FIELD |
|
CHARMAX | ALLFIELDS, FIELD |
|
FIELD |
ALLFIELDS, CHARMAX |
|
FIELD IGNORE |
ALLFIELDS, CHARMAX |
|
ALLCHAR FIELD |
ALLFIELDS, CHARMAX |
|
STARTLINE | |
|
KEEPTITLE | |
|
KEEPTITLE STARTLINE |
Méthode d'affectation des types de données par Analytics lorsque vous utilisez ALLFIELDS ou CHARMAX
Lorsque vous utilisez les paramètres ALLFIELDS ou CHARMAX, plutôt que de définir les champs individuellement, Analytics examine un sous-ensemble d'enregistrements au début du fichier Excel et affecte les types de données en fonction d'un ensemble de règles internes.
Une fois que les données sont dans Analytics, si besoin vous pouvez affecter différents types (Numérique ou DateHeure par exemple) de données aux champs et en spécifier les informations de format.
Taille maximale de l'importation de données
Format de fichier .xlsx ou .xlsm
Le nombre maximal de colonnes Excel, et le nombre maximal de caractères dans un champ, que vous pouvez importer à partir de fichiers .xlsx ou .xlsm n'est pas limité à un nombre spécifique.
L'importation de ces types de fichiers Excel est régie par la limite de longueur d'enregistrement dans les fichiers de données Analytics (.fil) de 32 Ko. Si un enregistrement dans le fichier Excel source crée un enregistrement Analytics de longueur supérieure à 32 Ko, l'importation échoue.
Format de fichier .xls
L'importation de fichiers .xls (Excel 97-2003) utilise un autre type de traitement ; elle est soumise à un maximum de :
- 255 colonnes
- 255 caractères par champ
- 32 Ko par enregistrement
- 65 000 lignes
Identificateurs des types de données de champ
Le tableau ci-dessous répertorie les lettres que vous devez utiliser lorsque vous indiquez type pour FIELD. Chaque lettre correspond à un type de données Analytics.
Par exemple, si vous définissez un champ Nom, qui requiert un type de données caractère, vous devez indiquer « C » : FIELD "Nom" C.
Pour plus d'informations, consultez la section Types de données dans Analytics.
Remarque
Lorsque vous utilisez l'Assistant de définition de données pour définir une table qui comprend des champs EBCDIC, Unicode ou ASCII, ces derniers se voient automatiquement attribuer la lettre « C » (pour le type CHARACTER).
Lorsque vous saisissez manuellement une instruction IMPORT ou que vous modifiez une instruction IMPORT existante, vous pouvez remplacer les lettres « E » ou « U » par des champs EBCDIC ou Unicode.
Lettre |
Type de données Analytics |
---|---|
A |
ACL |
B |
BINARY |
C |
CHARACTER |
D |
DATETIME |
E |
EBCDIC |
F |
FLOAT |
G |
ACCPAC |
I |
IBMFLOAT |
K |
UNSIGNED |
L |
LOGICAL |
N |
|
P |
PACKED |
Q |
BASIC |
R |
MICRO |
S |
CUSTOM |
T |
PCASCII |
U |
UNICODE |
V |
VAXFLOAT |
X |
NUMERIC |
Y |
UNISYS |
Z |
ZONED |