Définition de la visibilité des vues

Pour autoriser ou empêcher un utilisateur de voir ou de modifier une vue, définissez sa propriété de visibilité.

A propos de cette tâche

Par défaut, les vues sont visibles et modifiables. Toutefois, vous pouvez modifier les options ci-dessous dans la page Visibilité de la vue.
  • Same as parent (valeur par défaut)
  • Required
  • Editable
  • Read only
  • None
  • Hidden

Lorsque vous définissez la visibilité sur Same as parent, vous définissez la vue pour qu'elle hérite de la visibilité du coach ou de la vue qui la contient. Par exemple, votre vue se trouve dans une vue dotée de la visibilité Read only . Si la visibilité de votre vue est définie sur Same as parent, votre vue hérite de la valeur Read only . Pour plus d'informations sur ces options et sur la visibilité en général, voir Afficher les propriétés de visibilité.

Le contenu de la page Visibilité varie selon que la vue se trouve dans un Coach ou dans une vue.
Dans une page Dans une vue
Pour une vue située dans la présentation d'une page, vous pouvez définir la visibilité de la vue en fonction d'une valeur, d'une règle ou d'un script.
Page Visibilité avec trois options source: valeur, règle et script. La valeur est sélectionnée et la page affiche l'interface utilisateur pour définir la visibilité en fonction d'une valeur.

En règle générale, la configuration de la visibilité à l'aide d'une valeur constitue l'option la plus simple, mais certes la moins flexible tandis que sa configuration à l'aide d'un script constitue l'option la plus flexible, mais certes la plus complexe.

Vous pouvez également modifier la visibilité en fonction de la taille de l'écran si vous choisissez de définir la visibilité à l'aide d'une valeur. Par exemple, supposons que vous voulez afficher une vue dans un écran de grande taille, mais la masquer sur un écran moyen ou de petite taille. Pour ce faire, vous devez définir la visibilité sur Editable lorsque vous modifiez la présentation sur grand écran. Vous passez ensuite à la présentation de l'écran moyen et changez la visibilité en Hidden ou None. Si vous n'indiquez aucune valeur pour la présentation de l'écran de petite taille, il hérite de la valeur de visibilité de la présentation de taille moyenne. Pour plus d'informations, voir Paramètres de réponse pour les vues.
Restriction: Vous ne pouvez pas avoir des règles ou des scripts différents pour chaque paramètre de taille d'écran.
 Lorsqu'il s'agit d'une vue comprise dans la présentation d'une vue, vous pouvez configurer la visibilité de la vue en fonction d'une valeur uniquement.
Page Visibilité qui affiche l'interface utilisateur pour définir la visibilité en fonction d'une valeur

Dans la procédure ci-dessous, seule la première option s'applique.

Procédure

Dans les propriétés Visibilité d'une vue, définissez sa visibilité de l'une des manières suivantes:
A l'aide d'une valeur
Sélectionnez Valeur , puis sélectionnez une valeur dans la liste ou cliquez sur Assigner une variable, puis sélectionnez la variable qui détermine la visibilité de la vue. Vous pouvez aussi définir une valeur différente pour les différents paramètres de taille d'écran en sélectionnant d'abord le paramètre de l'écran, puis en sélectionnant la valeur de visibilité de cette taille d'écran.
Remarque: En fonction de la manière dont vous définissez sa propriété de visibilité, la vue peut être affichée comme étant désactivée (pour Hidden) ou non affichée sur le canevas (pour None). Lorsque vous définissez la propriété de visibilité sur None, la vue n'est plus visible sur le canevas, mais elle est répertoriée dans la fenêtre en incrustation Eléments invisibles Eléments invisibles . Pour réafficher la vue, sélectionnez-la dans la liste déroulante, puis redéfinissez la visibilité sur Afficher. Pour plus d'informations, voir Afficher les propriétés de visibilité.
A l'aide d'une règle
Sélectionnez Règle, puis créez un ensemble de règles de visibilité. Un ensemble de règles de visibilité possède une ou plusieurs règles, ainsi qu'une valeur par défaut lorsque aucune règle ne s'applique. Les règles incluent une relation OR. Placez les règles en fonction de leur applicabilité, car la vue utilise la valeur de visibilité de la première règle qui s'applique.
  1. Déterminez si la première règle de l'ensemble de règles est basée sur la valeur d'une variable ou sur l'appartenance à une équipe, puis sélectionnez Variable ou Equipe.
  2. Définissez la valeur par défaut de l'ensemble de règles en sélectionnant une valeur dans la zone Sinon.
  3. Créez la première règle dans l'ensemble de règles.
    Pour une variable, le format de la règle est visibilité variable condition valeur. Pour créer une règle de visibilité basée sur la valeur d'une variable :
    • Pour visibilité, définissez la valeur de visibilité dans la zone Définir à.
    • Pour variable, cliquez sur Sélectionner, puis sélectionnez la variable définie dans le service utilisateur qui détermine quand la valeur de visibilité s'applique.
    • Pour condition, sélectionnez le type de comparaison utilisé pour la valeur de la variable.
    • Pour valeur, entrez la valeur de la variable qui déclenche l'application de la valeur de visibilité.
    Pour une équipe, le format de la règle est visibilité appartenance équipe. Pour créer une règle de visibilité basée sur l'appartenance à une équipe :
    • Pour visibilité, définissez la valeur de visibilité dans la zone Définir à.
    • Pour l'appartenance, sélectionnez le type d'appartenance de l'utilisateur dans l'équipe.
    • Pour l'équipe, sélectionnez l'équipe dont l'utilisateur fait partie.

    Pour ajouter d'autres valeurs de variable ou d'appartenance à une équipe à une règle, cliquez sur Ajouter. Les clics suivants ajoutent une valeur de variable ou une appartenance à une équipe pour chaque clic. S'il y a plusieurs variables ou appartenances à une équipe dans une règle, elles sont liées entre elles par une relation AND. Elles doivent toutes être vraies pour permettre l'application de la règle.

  4. Créez autant de règles que nécessaire.
  5. Cliquez sur Sauvegarder Ou Terminer l'édition.
A l'aide d'un script
Sélectionnez Script, puis créez un script de visibilité :
  1. Cliquez sur Sélectionner.
  2. Sélectionnez une ou plusieurs variables locales qui déclenchent le script à exécuter.
  3. Entrez le code JavaScript dans la zone.
    Les paramètres disponibles pour votre code sont les suivants :
    Paramètre Description
    context Le paramètre context contient des données provenant de context.bpm.system, context.bpm.team.member et context.bpm.team.manager. Les objets system, member et manager sont identiques aux objets portant le même nom dans l'objet view.context.
    Rappel: Si votre script vérifie l'appartenance à l'équipe et que plusieurs équipes portent le même nom dans l' automatisation de flux de travaux et ses kits d'outils dépendants, l'appartenance à ces équipes doit être la même. Dans le cas contraire, utilisez des règles au lieu d'un script pour définir la visibilité.
    event Le paramètre event contient des données provenant de l'événement initialize ou change. L'infrastructure appelle le script de visibilité à l'aide de l'événement initialize (type: "initialize") lors de l'initialisation de la page. La structure appelle le script de visibilité avec l'événement de modification (type: "change") lors de la modification de l'une des variables surveillées. L'événement change est comparable à l'événement traité par le gestionnaire d'événements change() si ce n'est qu'il possède des propriétés supplémentaires :
    • type: "change" or "initialize"
    • path: fully qualified path to the variable that changed: Par exemple, entrez "local.employee.phoneNumber[2].areaCode"
    local Le paramètre local contient toutes les variables du service utilisateur disponibles pour la page. Par exemple, vous pouvez obtenir une valeur de variable en utilisant un appel comparable à local.get("employee").get("phoneNumber").get(0).get("type")

    Dans le code JavaScript, chaque valeur renvoyée doit être une chaîne associée à l'une des valeurs suivantes : REQUIRED EDITABLE READONLY NONE DEFAULT HIDDEN.

    Lorsqu'un utilisateur modifie la valeur de l'une des variables surveillées, l'événement de modification déclenche l'exécution du script. Par exemple, vous pouvez souhaiter que l'interface utilisateur s'affiche dans une vue lorsque l'utilisateur sélectionne tea dans la marque MyDrink. Les utilisateurs de l'équipe des ventes peuvent modifier la vue. Le service inclut les variables Drink et Brand. Vous pouvez sélectionner ces variables, puis ajouter le code suivant dans la zone :
    if(local.get("brand") == "MyDrink" && local.get("drink") == "Tea") {
	if(context.bpm.team.member.indexOf("SalesTeam") != -1) {
		return "EDITABLE";
	} else {
		return "READONLY";
	}
} else {
	return "NONE";
}
  4. Cliquez sur Sauvegarder Ou Terminer l'édition.