required_access_grants (pour les champs)

Cette page fait référence au paramètre required_access_grants qui fait partie d'une dimension, d'un groupe de dimensions, d'une mesure, d'un filtre ou d'un paramètre.

required_access_grants peut également faire partie d'une exploration, décrite sur la page de documentation du paramètre required_access_grants (pour les explorations).

required_access_grants peut également faire partie d'une jointure, décrite sur la page de documentation du paramètre required_access_grants (pour les jointures).

required_access_grants peut également faire partie d'une vue, comme décrit sur la page de documentation du paramètre required_access_grants (pour les vues).

Utilisation

view: view_name {
  dimension: field_name {
    required_access_grants: [access_grant_name, access_grant_name, ...]
  }
}
Hiérarchie
view
Type de champ
required_access_grants
Types de champs possibles
Dimension, groupe de dimensions, mesure, filtre, paramètre

Acceptation
Crochets contenant une liste de noms d'octrois d'accès séparés par une virgule

Définition

required_access_grants est associé au paramètre access_grant au niveau du modèle pour limiter l'accès à un champ aux seuls utilisateurs auxquels une valeur d'attribut utilisateur spécifique est attribuée.

required_access_grants fonctionne comme suit :

  1. Vous définissez un accès à l'aide du paramètre access_grant. Dans la définition, vous associez l'autorisation d'accès à un attribut utilisateur. Vous spécifiez également les valeurs d'attribut utilisateur qui donnent accès au droit d'accès.
  2. Ensuite, vous utilisez required_access_grants pour limiter le champ aux seuls utilisateurs ayant accès à tous les droits d'accès listés.

Par exemple, le code LookML suivant exige que les utilisateurs disposent des droits d'accès can_view_financial_data et view_payroll pour afficher la dimension salary :

dimension: salary {
  ...
  required_access_grants: [can_view_financial_data, view_payroll]
}

Les utilisateurs qui n'ont pas accès à tous les droits d'accès attribués au champ n'y auront pas accès. Il ne verra pas le champ dans le sélecteur de champs lors de l'exploration. Si les utilisateurs consultent un Look qui inclut le champ restreint, le message d'avertissement suivant s'affiche : "<view.field> n'existe plus dans <view>, ou vous n'y avez pas accès. Cet élément sera ignoré." Le message d'avertissement est masqué dans les vignettes du tableau de bord.

Pour savoir comment définir un accès, consultez la page de documentation access_grant.

Exemple

N'exposez la dimension salary qu'aux utilisateurs ayant accès au droit d'accès payroll :

dimension: salary {
  type: number
  required_access_grants: [payroll]
}

Informations complémentaires

Afficher les vues restreintes avec des champs calculés dans les Looks et les tableaux de bord enregistrés

Étant donné que les utilisateurs qui n'ont pas accès à un champ restreint ne peuvent pas y accéder, cela peut entraîner des modifications dans les données affichées dans une requête enregistrée ou une tuile de tableau de bord.

Par exemple, une requête qui utilise une dimension restreinte n'aura pas accès aux données de cette dimension. L'agrégation de la mesure se fera donc sans ces données. Par conséquent, les utilisateurs qui n'ont pas accès à la dimension restreinte verront des résultats différents dans la mesure par rapport à ceux qui y ont accès.

Les calculs de table basés sur un champ restreint affichent une erreur pour les utilisateurs qui n'y ont pas accès, car le calcul de table n'a pas accès au champ restreint.