Commande IMPORT MULTIEXCEL

Crée plusieurs tables Analytics en définissant et en important plusieurs plages nommées ou feuilles de calcul Microsoft Excel.

Syntaxe

IMPORT MULTIEXCEL <TO dossier_import> FROM {nom_fichier_source|dossier_source} TABLE saisie_feuilles_calcul_ou_plages_nommées <PREFIX> <KEEPTITLE> <CHARMAX longueur_champ_max>

Remarque

Vous devez indiquer les paramètres IMPORT MULTIEXCEL 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 dossier_import

optionnel

Dossier dans lequel importer les données.

Pour indiquer le dossier, utilisez un chemin d'accès au fichier absolu ou un chemin d'accès au fichier relatif au dossier contenant le projet Analytics. Indiquez dossier_import sous forme de chaîne entre guillemets.

Exemple

TO "C:\Point of Sale Audit\Données\Données de travail transaction"
TO "Données\Données de travail transaction"

Si vous omettez TO, les données sont importées dans le dossier contenant le projet Analytics.

FROM nom_fichier_source | dossier_source

Nom du ou des fichiers de données source, ou du dossier contenant le(s) fichier(s) de données source.

Indiquez nom_fichier_source ou dossier_source sous forme de chaîne entre guillemets.

Fichier(s) de données source dans le dossier de projet Analytics racine

  • un seul fichier Excel

    Indiquez le nom et l'extension de fichier complets.

    Exemple

    FROM "Transactions_FY18.xlsx"
  • plusieurs fichiers Excel

    Pour indiquer plusieurs fichiers, utilisez un caractère générique (*) au lieu de caractères uniques dans les noms de fichiers. Le caractère générique représente zéro (0) occurrence ou plus de n'importe quel lettre, chiffre ou caractère spécial.

    Exemple

    FROM "Transactions_FY*.xlsx"

    sélectionne :

    Transactions_FY18.xlsx

    Transactions_FY17.xlsx

    Vous pouvez utiliser un caractère générique dans plusieurs emplacements d'un nom de fichier et dans une extension de fichier.

    Exemple

    FROM "Transactions_FY*.*"

    sélectionne :

    Transactions_FY18.xlsx

    Transactions_FY17.xls

Fichier(s) de données source absent(s) du dossier de projet Analytics racine

Si le(s) fichier(s) de données source ne sont pas enregistrés dans le même dossier que le projet Analytics, vous devez utiliser un chemin d'accès absolu ou un chemin d'accès relatif au fichier contenant le projet pour indiquer l'emplacement du fichier :

Exemple

FROM "C:\Point of Sale Audit\Données\Fichiers maîtres Transaction\Transactions_FY18.xlsx"
FROM "Données\Fichiers maîtres Transaction\Transactions_FY*.xlsx"

Dossier contenant le(s) fichier(s) de données source

Au lieu d'indiquer un nom de fichier, vous pouvez simplement indiquer le nom du dossier contenant un ou plusieurs fichiers de données source.

Pour indiquer un dossier de données source, utilisez un chemin d'accès au fichier absolu ou un chemin d'accès au fichier relatif au dossier contenant le projet Analytics.

Exemple

FROM "C:\Point of Sale Audit\Données\Fichiers maîtres Transaction"
FROM "Données\Fichiers maîtres Transaction"

Remarque

Lorsque vous indiquez un dossier, une feuille de calcul de fichier Excel dans le dossier est importée si le nom de la feuille de calcul correspond à la valeur TABLE.
TABLE saisie_feuilles_calcul_ou_plages_nommées

Nom des feuilles de calcul ou plages nommées à importer. Une table Analytics distincte est créée pour chaque feuille de calcul ou plage nommée importée.

Indiquez saisie_feuilles_calcul_ou_plages_nommées sous forme de chaîne entre guillemets.

Dans les noms des feuilles de calcul ou des plages, utilisez un caractère générique (*) au lieu de caractères uniques.

Par exemple, "Trans_*$" sélectionne les feuilles de calcul suivantes :

  • Trans_Jan
  • Trans_Fév
  • Trans_Mar
  • et ainsi de suite

Remarque

Le caractère générique (*) représente zéro (0) occurrence ou plus de n'importe quel lettre, chiffre ou caractère spécial.

Vous pouvez utiliser un caractère générique dans plusieurs emplacements. Par exemple, *Trans*$ sélectionne :

  • Trans_Jan
  • Jan_Trans

Signification du symbole dollar ($)

Dans un fichier Excel, les feuilles de calcul sont identifiées par un symbole dollar ($) ajouté au nom de la feuille de calcul (Trans_Jan$). Le symbole dollar n'est pas visible dans Excel.

Les plages nommées sont identifiées par l'absence d'un symbole dollar (Trans_Jan_commercial).

Il n'est pas obligatoire d'indiquer le symbole dollar pour utiliser IMPORT MULTIEXCEL. Toutefois, vous devez l'inclure ou l'exclure dans les situations suivantes :

  • Inclure "$" si vous souhaitez importer uniquement des feuilles de calcul, et aucune plage nommée, incluez le symbole dollar à la fin du nom de la feuille de calcul
  • Exclure "$" si vous souhaitez importer des plages nommées ou des feuilles de calcul et des plages nommées dans une seule opération d'importation, n'incluez pas le symbole dollar

PREFIX

optionnel

Ajoutez comme préfixe le nom du fichier Excel au nom des tables Analytics.

Astuce

Si les feuilles de calcul de différents fichiers portent le même nom, ajouter comme préfixe le nom du fichier Excel vous permet d'éviter des conflits de noms de table.
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.

Remarque

L'ensemble des premières lignes des feuilles de calcul et des plages nommées que vous importez doit utiliser une approche cohérente. Les premières lignes doivent être soit des noms de champs soit des données dans tous les jeux de données. Évitez de mélanger les deux dans une seule et même opération d'importation.

Si les jeux de données adoptent une approche incohérente pour les premières lignes, utilisez deux opérations d'importation distinctes.
CHARMAX longueur_champ_max

optionnel

La longueur maximale en caractères d'un champ d'une table Analytics qui provient d'une donnée de type caractère dans un fichier de données source.

Exemples

Dans les exemples qui suivent, on suppose que les données des transactions mensuelles pendant trois ans sont stockées dans trois fichiers Excel :

  • Transactions_FY18.xlsx
  • Transactions_FY17.xlsx
  • Transactions_FY16.xlsx

Chaque fichier Excel comporte 12 feuilles de calcul, une pour chaque mois de l'année. Les feuilles de calcul incluent aussi certaines plages nommées identifiant différents sous-ensembles de transactions.

Remarque

Une table Analytics distincte est créée pour chaque feuille de calcul ou plage nommée que vous importez.

Importer des feuilles de calcul

Importer toutes les feuilles de calcul FY18

Vous souhaitez importer les 12 feuilles de calcul mensuelles du fichier Excel FY18 et ignorer les plages nommées.

  • vous utilisez le symbole caractère générique (*) à l'emplacement du mois dans le nom de chaque feuille de calcul
  • incluez le symbole dollar ($) à la fin du nom de la feuille de calcul pour sélectionner uniquement des feuilles de calcul, et aucune plage nommée
IMPORT MULTIEXCEL FROM "Transactions_FY18.xlsx" TABLE "Trans_*$"

Importez toutes les feuilles de calcul FY18, conservez les noms des champs et indiquez la longueur maximale des champs caractère

Cet exemple est le même que le précédent, mais vous souhaitez conserver les noms de champs des fichiers Excel ainsi que limiter la longueur des champs caractère.

  • vous incluez KEEPTITLE pour utiliser la première ligne de données Excel comme noms de champ

  • vous incluez CHARMAX 50 pour que les champs provenant de données de type caractère dans le fichier Excel aient une longueur limitée à 50 caractères dans la table Analytics ainsi créée

IMPORT MULTIEXCEL FROM "Transactions_FY18.xlsx" TABLE "Trans_*$" KEEPTITLE CHARMAX 50

Importer toutes les feuilles de calcul de l'ensemble des trois fichiers

Vous souhaitez importer les 36 feuilles de calcul mensuelles des trois fichiers Excel et vous souhaitez ignorer les plages nommées.

  • vous utilisez le symbole caractère générique (*) à l'emplacement du mois dans le nom de chaque feuille de calcul
  • incluez le symbole dollar ($) à la fin du nom de la feuille de calcul pour sélectionner uniquement des feuilles de calcul, et aucune plage nommée
  • vous utilisez le symbole caractère générique (*) à l'emplacement de l'année dans le nom de chaque fichier Excel
  • afin de réduire toute possibilité de conflits de noms, vous utilisez PREFIX pour ajouter le nom du fichier Excel source en guise de préfixe à chaque nom de table Analytics
IMPORT MULTIEXCEL FROM "Transactions_FY*.xlsx" TABLE "Trans_*$" PREFIX

Importer des plages nommées

Importer toutes les plages nommées "Transaction_commerciale" FY18

Vous souhaitez importer toutes les plages nommées "Transaction_commerciale" du fichier Excel FY18 et ignorer les feuilles de calcul et les autres plages nommées.

  • vous utilisez le symbole de caractère générique (*) à l'emplacement d'un identifiant unique dans les noms des différentes plages
  • vous excluez le symbole dollar ($) pour que les plages nommées puissent être sélectionnées
IMPORT MULTIEXCEL FROM "Transactions_FY18.xlsx" TABLE "Transaction_commerciale_*"

Importer les feuilles de calcul et les plages nommées

Importer toutes les feuilles de calcul et toutes les plages nommées FY18

Vous souhaitez importer les 12 feuilles de calcul mensuelles et toutes les plages nommées du fichier Excel FY18.

  • avec TABLE, vous utilisez uniquement le symbole caractère générique (*) pour que toutes les feuilles de calcul et plages nommées du fichier soient sélectionnées
  • vous excluez le symbole dollar ($) pour que les plages nommées puissent être sélectionnées
IMPORT MULTIEXCEL FROM "Transactions_FY18.xlsx" TABLE "*"

Gérer des répertoires

Importer toutes les feuilles de calcul de tous les fichiers Excel dans le dossier spécifié

Vous souhaitez importer toutes les feuilles de calcul de tous les fichiers Excel dans le dossier C:\Point of Sale Audit\Données\Fichiers maîtres Transaction.

  • avec TABLE, vous utilisez uniquement le symbole caractère générique (*) pour que toutes les feuilles de calcul de chaque fichier soient sélectionnées et vous utilisez le symbole dollar ($) pour que seules les feuilles de calcul soient sélectionnées, et aucune plage nommée
  • afin de réduire toute possibilité de conflits de noms, vous utilisez PREFIX pour ajouter le nom du fichier Excel source en guise de préfixe à chaque nom de table Analytics
IMPORT MULTIEXCEL FROM "C:\Point of Sale Audit\Données\Fichiers maîtres Transaction" TABLE "*$" PREFIX

Importez toutes les feuilles de calcul de tous les fichiers Excel dans le dossier spécifié et enregistrez les tables Analytics dans un autre dossier

Cet exemple est le même que le précédent, mais au lieu d'enregistrer les tables Analytics dans le dossier de projet racine, vous voulez les enregistrer dans le dossier C:\Point of Sale Audit\Données\Données de travail transaction.

IMPORT MULTIEXCEL TO "C:\Point of Sale Audit\Données\Données de travail transaction" FROM "C:\Point of Sale Audit\Données\Fichiers maîtres Transaction" TABLE "*$" PREFIX

Remarques

Commandes IMPORT EXCEL multiples

La commande IMPORT MULTIEXCEL exécute en fait plusieurs commandes IMPORT EXCEL individuelles, une pour chaque feuille de calcul importée. Si vous double-cliquez sur l'entrée IMPORT MULTIEXCEL dans la trace, chaque commande IMPORT EXCEL s'affiche individuellement dans la zone d'affichage.

La dernière table importée est ouverte automatiquement

IMPORT MULTIEXCEL ne prend pas en charge le mot-clé OPEN. Toutefois, après l'exécution de la commande, la dernière table importée s'ouvre automatiquement.

Combiner plusieurs feuilles de calcul après les avoir importées

Après avoir importé plusieurs feuilles de calcul dans des tables Analytics individuelles, vous voudrez peut-être les combiner en une seule table Analytics. Par exemple, vous pouvez combiner les données de douze tables mensuelles en une seule table annuelle contenant toutes les données.

Pour obtenir des informations sur la combinaison de plusieurs tables Analytics, consultez la rubrique Commande APPEND.