Cette page a été traduite par l'API Cloud Translation.

Paramètres de configuration pouvant être remplacés

Les paramètres de configuration pouvant être remplacés permettent aux éditeurs de rapports de modifier les valeurs par défaut d'une source de données. Définir des paramètres de configuration comme pouvant être remplacés une source de données plus flexible et permet aux utilisateurs de créer modèles de rapports.

Par exemple, un connecteur fournissant des données météorologiques peut inclure un emplacement paramètre permettant aux lecteurs du rapport de demander un bulletin météo à partir d'un paramètre régional différente de celle par défaut.

Ce document décrit comment les paramètres pouvant être remplacés sont définis, activés pour et la manière dont les utilisateurs du rapport peuvent modifier les valeurs des paramètres. Pour apprendre Pour en savoir plus sur l'utilisation des paramètres dans Looker Studio, consultez Paramètres de source de données :

Rôles

Les rôles utilisateur référencés tout au long du document:

Rôle	Définition
Développeur de connecteurs	Un utilisateur qui a créé un connecteur de communauté.
Propriétaire de la source de données	Un utilisateur qui a créé une source de données et en est propriétaire.
Éditeur de rapports	Un utilisateur disposant d'un accès en mode Édition à un rapport
Lecteur de rapports	Un utilisateur disposant d'un accès en mode Vue à un rapport

Définir des paramètres pouvant être remplacés

Le développeur du connecteur définit les paramètres de configuration dans le fichier fonction getConfig() d'un le connecteur de communauté. Pour définir un paramètre de configuration comme pouvant être remplacé, le connecteur appelle setAllowOverride(true).

L'exemple suivant définit deux paramètres pouvant être remplacés: zipcode et units et 1 paramètre non ignorable: days-to-forcecast.

Capture d'écran de deux paramètres pouvant être remplacés

function getConfig(request) {
  var config = cc.getConfig();

  // A
  config
      .newTextInput()
      .setId("zipcode")
      .setName("ZIP Code")
      .setAllowOverride(true);

  // B
  config
    .newSelectSingle()
    .setId("units")
    .setName("Units")
    .addOption(
        config
          .newOptionBuilder()
          .setLabel("Metric")
          .setValue("metric")
    )
    .addOption(
      config
        .newOptionBuilder()
        .setLabel("Imperial")
        .setValue("imperial")
    )
    .setAllowOverride(true);

  // C
  config
    .newTextInput()
    .setId("days-to-forecast")
    .setName("Days to forecast")
      .setAllowOverride(false);


  return config.build();
}

Quand éviter de définir un paramètre comme pouvant être remplacé

Nous vous recommandons de découvrir le fonctionnement des connecteurs, des sources de données et des rapports les relations entre eux, consultez Comment Looker Studio se connecte à vos données.

Évitez de définir un paramètre comme pouvant être remplacé dans les cas suivants:

Lorsque la valeur d'un paramètre affecte le schéma.
- Si un utilisateur modifie une valeur de paramètre et le schéma des nouvelles données n'est pas la même que celle définie dans la source de données, tout rapport qui dépend de la source de données pourrait ne plus fonctionner en raison de champs manquants.
Si une valeur de paramètre contrôle des données sensibles. Exemple : Sélection du compte.
- Ne définissez pas de paramètre comme étant à remplacer si vous souhaitez empêcher la consultation ou le partage involontaire de données sensibles.

Activer les paramètres pour les utilisateurs des rapports

Les propriétaires de la source de données contrôlent les paramètres pouvant être remplacés par les éditeurs du rapport. De même, les éditeurs de rapports déterminent peuvent être modifiés par les lecteurs de rapports.

Autoriser les éditeurs de rapports à modifier les valeurs des paramètres

Le propriétaire de la source de données détermine les paramètres pouvant être modifiés rapports. Ce paramètre est configuré lors de la création ou de la modification d'une source de données applicables uniquement aux paramètres qui ont été défini comme remplaçable par le connecteur développeur. Si cette option est activée, les éditeurs de rapports pourront : Modifiez les paramètres dans un rapport.

Dans l'exemple suivant, un connecteur comporte deux paramètres pouvant être remplacés: zipcode et units. Le propriétaire de la source de données n'a autorisé que zipcode dans les rapports. Dans le rapport, l'éditeur de rapports permet de modifier la valeur du paramètre zipcode.

Activation de l'option de remplacement

Autoriser les lecteurs du rapport à modifier les valeurs des paramètres

Les éditeurs de rapports déterminent les paramètres pouvant être modifiés par les lecteurs de rapports. Les valeurs des paramètres peuvent ensuite être modifiées via l'URL du rapport par n'importe quel utilisateur du rapport.

Prenons l'exemple d'un connecteur comportant deux paramètres pouvant être remplacés: zipcode et units (figure 1). Si le propriétaire de la source de données a autorisé zipcode dans les rapports (figure 2). Les éditeurs de rapports n'auront à modifier permettre aux lecteurs de rapports d'autoriser la modification de zipcode. Le rapport éditeur n'aura pas l'accès ni la visibilité nécessaires pour que le paramètre units soit par les lecteurs du rapport.

Paramètre de code postal activé — **Figure 1**: Configuration du connecteur

Seul le paramètre "Zip code" (Code postal) peut être modifié. — **Figure 2**: Gérer les paramètres

Paramètres d'URL

Pour permettre aux lecteurs du rapport de modifier les valeurs des paramètres via l'URL du rapport:

Modifiez le rapport.
Sélectionnez Ressource -> Gérez les paramètres d'URL du rapport.
Cochez les cases Autoriser la modification dans l'URL du rapport pour autoriser ou interdire la modification des valeurs de paramètre dans l'URL du rapport. Les modifications sont automatiquement enregistrées.
Cliquez sur Fermer en haut à droite.

Modifier les valeurs des paramètres

Les éditeurs du rapport peuvent modifier les valeurs des paramètres à l'aide du panneau des propriétés du rapport. tandis que les lecteurs du rapport peuvent modifier les valeurs des paramètres via l'URL du rapport.

Panneau des propriétés du rapport

Pour savoir comment un éditeur de rapports peut définir des valeurs de paramètres, consultez Modifiez les paramètres dans un rapport.

Paramètres d'URL du rapport

Pour les paramètres peuvent être modifiées dans l'URL du rapport, les valeurs peuvent être défini via un objet JSON encodé au format URL ajouté à l'URL du rapport en mode Vue.

Pour créer une configuration d'URL:

Recueillir les noms des paramètres
1. Modifiez le rapport.
2. Sélectionnez Ressource -> Gérez les paramètres d'URL du rapport.
3. Notez le nom des paramètres que vous avez l'intention de définir via le rapport. URL.
Par exemple, dans la figure ci-dessous, le nom du paramètre est ds0.zipcode.
Créer l'objet de paramètre

Les paramètres sont définis via un objet JSON. Les clés des valeurs de paramètres sont les noms des paramètres.
```
{
  "parameterName": parameterValue
}
```
Les types de valeurs de paramètre sont STRING, NUMBER ou BOOLEAN. Pour qui acceptent plusieurs valeurs (listes déroulantes à sélection multiple) utilisent tableau de valeurs.

Par exemple, si le nom du paramètre est ds0.zipcode, définissez le code postal sur 94094, le fichier JSON se présente comme suit:
```
{
  "ds0.zipcode": "94094"
}
```
Encoder l'objet de paramètre en URL

Après avoir créé l'objet de paramètre, utilisez JSON.stringify() pour le transformer dans une chaîne, puis utilisez [encodeURIComponent] pour l'encoder en URL.
```
var params = {
  "ds0.zipcode": "94094"
};
var paramsAsString = JSON.stringify(params);
var encodedParams = encodeURIComponent(paramsAsString)
```
Cela se traduit par la chaîne encodée suivante:
```
"%7B%22ds0.zipcode%22%3A%2294094%22%7D"
```
Créer l'URL du rapport

Une fois que vous disposez de l'objet de paramètre encodé au format URL, ajoutez-le à la vue du rapport. URL à l'aide du paramètre de requête params.

https://lookerstudio.google.com/reporting/REPORT_ID/page/PAGE_ID?params=%7B%22ds0.zipcode%22%3A%2294094%22%7D

Veillez à remplacer REPORT_ID et PAGE_ID par les valeurs correspondant à votre le rapport et la page.
Utiliser l'URL

L'URL du rapport remplace les paramètres définis dans les paramètres JSON. en fonction de l'héritage des paramètres.

Exemple d'objet de paramètre

L'objet de paramètre suivant montre comment définir plusieurs paramètres. Il y a aussi illustre le réglage des valeurs de paramètres pour les différents types d'entrée.

ds0.includeToday correspond à une case à cocher.
ds0.units est une entrée à sélection unique
ds1.countries est une entrée à sélection multiple
ds1.labelName est une entrée de texte.

  {
    "ds0.includeToday": true,
    "ds0.units": "Metric",
    "ds1.countries": ["Canada", "Mexico"],
    "ds1.labelName": "Population"
  }

Héritage des paramètres

La valeur utilisée pour un paramètre suit un ordre de priorité basé sur l'emplacement est défini. Les paramètres définis avec des emplacements ayant une priorité plus élevée remplacent les paramètres définis à des emplacements de priorité inférieure. L'ordre de priorité (à partir de par ordre décroissant) correspond à:

Source de données (par défaut)
URL du rapport
Panneau des propriétés du rapport, en suivant la source de données d'héritage des paramètres.