required_access_grants (pour les vues)

Cette page fait référence au paramètre required_access_grants qui fait partie d'une vue.

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 dimension, d'un groupe de dimensions, d'une mesure, d'un filtre ou d'un paramètre, comme décrit sur la page de documentation du paramètre required_access_grants (pour les champs) .

Utilisation

view: view_name {
  required_access_grants: [access_grant_name, access_grant_name, ...]
}

Hiérarchie Afficher le fichier view required_access_grants

Valeur par défaut Aucun 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 à une vue 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 une vue aux seuls utilisateurs ayant accès à tous les droits d'accès listés.

Par exemple, le LookML suivant exige que les utilisateurs aient accès aux droits d'accès can_view_financial_data et view_payroll pour afficher la vue payroll :

view: payroll {
  ...
  required_access_grants: [can_view_financial_data, view_payroll]
}

Les utilisateurs qui n'ont pas accès à toutes les autorisations d'accès attribuées à la vue ne verront aucun champ dans la vue restreinte. Ils ne verront pas ces champs dans le sélecteur de champs lorsqu'ils exploreront les données. Si l'utilisateur consulte un Look qui inclut des champs de la vue restreinte, 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 autorisé, consultez la page de documentation sur le paramètre access_grant.

Exemple

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

view: payroll {
  ...
  required_access_grants: [accounting]
}

Informations complémentaires

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

Étant donné que les utilisateurs qui n'ont pas accès à une vue restreinte ne peuvent pas accéder aux champs de la vue, cela peut entraîner des modifications des données affichées dans un Look ou une tuile de tableau de bord enregistrés.

Par exemple, une mesure qui utilise une dimension d'une vue restreinte n'aura pas accès aux données de cette vue. 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 vue restreinte voient des résultats différents de ceux qui y ont accès.

Les calculs de tableau basés sur un champ dans une vue restreinte affichent une erreur pour les utilisateurs qui n'ont pas accès à la vue restreinte, car le calcul de tableau n'a pas accès au champ dans la vue restreinte.

Restreindre l'accès aux structures LookML sous-jacentes

Restreindre l'accès à une vue ne restreint pas l'accès à ses structures LookML sous-jacentes. Ainsi, un champ non restreint qui fait partie d'autres vues restera disponible si ces vues ne sont pas restreintes. Utilisez le paramètre required_access_grants au niveau du champ pour limiter les champs individuellement.