Pré-requis : il faut avoir un rôle d'Administrateur Fonctionnel pour pouvoir accéder à cette fonctionnalité.
Depuis le portail, accéder au menu Référentiels / Gestion des métriques.
Sélectionnez la base de données concernée.
En haut à droite, cliquez sur
.
Vous avez la possibilité d'importer ou exporter une liste de métriques.
En cliquant sur "Exporter une liste de métriques", vous allez exporter l'ensemble des métriques de la base de données sélectionnée, dans un fichier Excel.
En cliquant sur "Importer une liste de métriques", vous allez pouvoir importer un fichier Excel, de manière à mettre à jour le référentiel. Attention, lors de l'import à vérifier que la source de données sélectionnée est bien celle voulue.
Structure du fichier
Le fichier contient trois onglets :
le référentiel des métriques
la liste des règles de stockage existantes
la liste des autorisations existantes
Les colonnes présentes dans le fichier reprennent :
Id = identifiant de la métrique
Name = le nom de la métrique
Description = la description de la métrique
Unit = l'unité de la métrique
Storage Rule = la règle de stockage
Access Zones = les autorisations appliquées à la métrique
Type de la métrique : il existe plusieurs types de métriques
raw : il s'agit d'une valeur remontée de manière automatique
calculated : il s'agit d'une valeur qui sera calculée
manual : il s'agit d'une valeur qui sera saisie
système : il s'agit d'une valeur de configuration du système
Formula = la formule (pour les métriques de type Calculated)
Remarque : Le premier onglet contient le référentiel exporté. Dans l'exemple ci-dessous, on voit que les données proviennent de la base de données "test".
Règles de fonctionnement de l'import
Lorsqu'un fichier est importé, voici les règles qui s'appliquent :
l'import ne permet pas la suppression des métriques. Si des lignes sont manquantes dans le fichier par rapport au référentiel, rien ne se produira. Pour supprimer des métriques, il faut passer par le menu Référentiels / Gestion des métriques.
l'import permet de modifier seulement certaines propriétés des métriques :
la description
l'unité
la règle de stockage
les autorisations
la formule d'une métrique calculée ne peut pas être modifiée via l'import. Il faut passer par le menu Formules.
le type d'une métrique ne peut pas être modifié
la valeur saisie dans la colonne Storage Rule doit correspondre au libellé existant dans l'onglet StorageRules du fichier
Si on souhaite positionner plusieurs autorisations sur une métrique, il faut les séparer par des ",".
Création de métriques via l'importation
L'importation permet également la création de nouvelles métriques.
Attention ! Pour créer des métriques via l'importation, il est nécessaire de laisser vide la première colonne "ID".
Il vous suffira ensuite de saisir les autres colonnes comme vous le souhaitez.
Attention toutefois à ne pas utiliser de formules (type formules Excel) lors de vos saisies.
Attention : Le nom de la métrique ne doit pas contenir de caractères spéciaux (seuls les tirets du bas ("_") et les points (".") sont acceptés).
Il est seulement possible de créer des métriques de type raw ou manual (voir les types de métriques plus-haut).
Ci-dessous, encadrée en rouge, une saisie valide pour la création d'une métrique via l'importation pour la base de "test".
Remarque : La dernière colonne "Formula" a une visée informative : elle permet d'afficher la formule des métriques calculées. Par conséquent, vous n'avez pas à la remplir lors de la création d'une nouvelle métrique.
Remarque : La création de métriques via l'importation n'est pas disponible pour Google Sheet. Privilégiez donc l'utilisation d'Excel pour cette fonctionnalité.
Vidéo tutoriel : Import/Export des métriques