Commande IMPORT EXCEL

Crée une table Analytics en définissant et en important une feuille de calcul Microsoft Excel ou une plage nommée.

Syntaxe

IMPORT EXCEL TO table nom_fichier_importation FROM nom_fichier_source TABLE feuille_calcul_ou_plage_nommée_entrée <KEEPTITLE> {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

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 : "C:\données\Factures.FIL" "données\Factures.FIL"
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 : "C:\données\nom_fichier_source" "donnéesnom_fichier_source"
TABLE feuille_calcul_ou_plage_nommée	La feuille de calcul Microsoft Excel ou la plage nommée dans le fichier de données source à importer : vous devez saisir un signe « $ » à la fin du nom d'une feuille de calcul feuille_calcul_ou_plage_nommée doit être indiqué sous forme de chaîne entre guillemets
KEEPTITLE optionnel	Traitez la première ligne de données en tant que noms de champs plutôt que comme données. Si vous ignorez ce paramètre, les noms des champs génériques sont utilisés. Si vous définissez les champs individuellement, KEEPTITLE doit apparaître avant le premier FIELD.
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	S'applique uniquement lorsque vous ne définissez pas les champs individuellement. 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 de données source.
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. Exclure un champ Pour 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. champs numériques format d'affichage des valeurs numériques dans les vues et rapports Analytics champs DateHeure format physique des valeurs DateHeure dans les données source (ordre des caractères date et heure, séparateurs, etc.) Remarque Pour les champs DateHeure, le format doit correspondre exactement au format physique dans les données source. Par exemple, si les données source sont 12/31/2014, vous devez saisir la date au format "MM/JJ/AAAA". 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, 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

Importation 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" N WID 16 DEC 0 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 100 caractères si elle est plus courte :

IMPORT EXCEL TO Transactions_Mai "Transactions_Mai.fil" FROM "Trans_Mai.xls" TABLE "Trans1_Mai$" KEEPTITLE CHARMAX 100

Remarques

Remarque

Pour plus d'informations sur le fonctionnement de cette commande, consultez le Aide d'Analytics.

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.

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 obtenir plus d'informations, consultez la section Types de données Analytics.