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
.
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
.
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é](https://developers.google.cn/static/looker-studio/connector/images/allow-url-parameters.png?authuser=19&hl=fr)
![Seul le paramètre "Zip code" (Code postal) peut être modifié.](https://developers.google.cn/static/looker-studio/connector/images/allow-url-parameters-2.png?authuser=19&hl=fr)
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
- Modifiez le rapport.
- Sélectionnez Ressource -> Gérez les paramètres d'URL du rapport.
- 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
ouBOOLEAN
. 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 sur94094
, 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 uniqueds1.countries
est une entrée à sélection multipleds1.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.