Commande SAVE LAYOUT

Enregistre un format de table Analytics dans un fichier de format de table externe (.layout) ou enregistre les métadonnées de format de table dans une table Analytics.

Remarque

Avant la version 11 d'Analytics, les fichiers de format de table externes utilisaient une extension de fichier .fmt. Vous pouvez toujours enregistrer un fichier de format de table avec une extension .fmt en indiquant l'extension manuellement.

Syntaxe

SAVE LAYOUT {FILE|TABLE} TO {nom_fichier|nom_table}

Paramètres

Nom Description

FILE | TABLE
  • FILE enregistrer un format de table Analytics dans un fichier de format de table externe (.layout)
  • TABLE enregistrer les métadonnées d'un format de table dans une table Analytics (.fil)

TO nom_fichier | nom_table

Nom du fichier de sortie et emplacement de la sortie :

  • nom_fichier nom du fichier .layout

    Indiquez le nom_fichier sous forme de chaîne entre guillemets. Par exemple : TO "Trans_Cf.layout".

    L'extension de fichier .layout est utilisée par défaut, il n'est donc pas obligatoire de le mentionner.

    Par défaut, le fichier est enregistré dans le dossier contenant le projet Analytics.

    Utilisez un chemin de fichier absolu ou relatif pour enregistrer le fichier dans un autre dossier existant :

    • TO "C:\Trans_Cf.layout"
    • TO "Formats de table\Trans_Cf.layout"

    Remarque

    La longueur du nom du format de table est limitée à 64 caractères alphanumériques, sans l'extension .layout, pour éviter au nom d'être tronqué lorsque le format de table est réimporté dans Analytics.

    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_tablenom de la table Analytics et du fichier .fil

    Indiquez le nom_table sous forme de chaîne entre guillemets avec une extension de fichier Par exemple : TO "Métadonnées_format_trans_cf.fil".

    L'extension de fichier .fil est utilisée par défaut, il n'est donc pas obligatoire de le mentionner.

    Par défaut, le fichier de données de table (.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 :

    • TO "C:\Métadonnées_format_trans_cf.fil"
    • TO "Métadonnées format\Métadonnées_format_trans_cf.fil"

    Remarque

    La longueur des noms des tables est limitée à 64 caractères alphanumériques, sans l'extension .FIL. 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.

Exemples

Enregistrement d'un format de table dans un fichier de format de table externe (.layout)

Dans les exemples suivants, le format de table utilisé par la table ouverte est enregistré dans un fichier de format de table externe intitulé Trans_Cf.layout :

Ici, le fichier de format de table est enregistré dans le dossier de projet Analytics :

SAVE LAYOUT FILE TO Trans_Cf.layout

Ici, le fichier de format de table est enregistré dans le dossier indiqué :

SAVE LAYOUT FILE TO "C:\ACL_DATA\AP Audit 2013\Trans_Cf.layout"

Enregistrement d'une copie des métadonnées de format de table dans une nouvelle table Analytics

Dans les exemples suivants, une copie des métadonnées du format de table utilisé par la table ouverte est enregistrée dans une nouvelle table Analytics intitulée Métadonnées_format_trans_cf.

Ici, la nouvelle table Analytics est enregistrée dans le dossier de projet Analytics :

SAVE LAYOUT TABLE TO Métadonnées_format_trans_cf

Ici, la nouvelle table Analytics est enregistrée dans le dossier indiqué :

SAVE LAYOUT TABLE TO "C:\ACL_DATA\AP Audit 2013\Métadonnées_format_trans_cf"

Remarques

SAVE LAYOUT fichier et table

La commande SAVE LAYOUT est utilisée à deux fins différentes :

  • La commande FILE enregistre le format de table de la table Analytics ouverte dans un fichier de format de table externe portant une extension .layout
  • La commande TABLE extrait les métadonnées du format de table pour la table Analytics ouverte et les enregistre dans une nouvelle table Analytics.

SAVE LAYOUT FILE

Fonctionnement

La commande SAVE LAYOUT FILE enregistre le format de table de la table Analytics ouverte dans un fichier de format de table externe portant une extension .layout.

Un format de table contient des métadonnées fournissant une interprétation structurée des données brutes dans le fichier de données source. Un format de table ne contient pas de données source lui-même.

Quand utiliser SAVE LAYOUT FILE

L'enregistrement d'un format de table sous un fichier .layout rend le format de table et ses métadonnées portables et réutilisables.

Le fichier .layout peut être importé dans un projet Analytics et être associé à un fichier de données source correspondant. Les éléments de données dans le fichier de données source doit correspondre aux définitions de champs spécifiées par les métadonnées du format de table.

Par exemple, vous pourriez enregistrer le format de table d'un fichier de transactions du mois de mars et l'associer à un fichier de données source contenant des transactions du mois d'avril, en supposant que la structure des données dans les fichiers de données source du mois de mars et du mois d'avril est identique. Utilisés de la sorte, les fichiers .layout peuvent vous éviter de devoir créer un tout nouveau format de table.

Pour plus d'informations sur la structure des tables Analytics, consultez la rubrique Structurer les données avec des formats de tables.

SAVE LAYOUT TABLE

Fonctionnement

La commande SAVE LAYOUT TABLE extrait les métadonnées du format de table pour la table Analytics ouverte et les enregistre dans une nouvelle table Analytics.

La nouvelle table n'est pas le format de table lui-même, mais plutôt une table Analytics ordinaire qui contient un résumé des métadonnées du format de table pour la table d'origine. L'accès à ce résumé dans un script Analytics vous permet de prendre des décisions quant au script à partir de ces informations.

Pour chaque champ de la table d'origine, les éléments suivants des métadonnées du format de table sont extraits dans une nouvelle table.

Remarque

Les noms des champs de la nouvelle table sont toujours générés en anglais indépendamment de la version localisée d'Analytics que vous utilisez.

Nom du champ dans la nouvelle table Métadonnées d'un format de table
nom_champ Nom du champ
type_données Type de données du champ
catégorie Catégorie de données du champ
position_départ Position de début du champ
longueur_champ Longueur du champ
décimales Nombre de décimales du champ (champs numériques uniquement)
format Format du champ (champs de type DateHeure et numérique uniquement)
titre_colonne Autre titre de colonne du champ
largeur_colonne Largeur de la colonne dans la vue

Informations supplémentaires

Champs calculés Les champs calculés sont inclus dans les métadonnées extraites, mais l'expression utilisée par le champ calculé, et ses éventuelles conditions, ne sont pas enregistrées. La position de départ, la longueur du champ et les places des décimales ne sont pas enregistrées non plus pour les champs calculés.
Champs associés Les champs associés ne sont pas inclus, car ils ne font pas partie du format de table.

Filtres au niveau du champ

Commentaires des champs

 Les filtres au niveau des champs et les commentaires des champs ne sont pas inclus.

Autre titre de colonne

Largeur de colonne

 Les valeurs enregistrées pour l'autre titre de colonne et la largeur de colonne correspondent à celles indiquées dans le format de table, et non aux valeurs au niveau de la vue pouvant être indiquées pour les colonnes.