Types de variables de catalogue de services
Les variables vous permettent de formuler des questions pour un élément de catalogue. Plusieurs types de variables de catalogue de services sont fournis. Certains types de variables acceptent les attributs de variable.
Voir les sections suivantes pour plus de détails sur chaque type de variable. Pour plus de détails sur la création de variables, voir Créer une variable de catalogue de services. Vous pouvez également fournir du texte d'aide pour n'importe quelle variable de catalogue de services. Pour obtenir des informations sur la définition des informations d'aide, voir Définir les informations d'aide pour une variable de catalogue de services.
Prise en charge dans divers canaux
Les variables de Service Catalog sont prises en charge dans différents canaux. Pour en savoir plus sur leur disponibilité, consultez la rubrique Prise en charge variable dans différents canaux.
Pièce jointe
- Vous devez spécifier uniquement une valeur entière pour les éléments suivants :
- Attribut de variable max_file_size
- Propriété système glide.sc.variable.attachment.default_max_size (au niveau du catalogue). La valeur par défaut est 20.
- Si l'attribut de variable max_file_size n'est pas spécifié, la valeur de la propriété système glide.sc.variable.attachment.default_max_size est considérée comme la limite supérieure de la taille du fichier de pièce jointe.
- Quelle que soit la taille de fichier autorisée dans la variable, la taille du fichier de pièce jointe ne peut pas dépasser la taille spécifiée dans la propriété système com.glide.attachment.max_size, qui s'applique aux pièces jointes sur la Now Platform.
- L'API g_form.setValue() est prise en charge dans les scripts clients du catalogue.
Lorsque vous chargez une pièce jointe dans cette variable, une entrée est créée dans la table Pièce jointe [sys_attachment]. La variable n'est pas mise à jour tant que vous n'avez pas envoyé la demande d'élément, ne l'avez pas ajoutée au panier ou n'avez pas sauvegardé l'enregistrement lors de sa modification (dans les flux de prestataires). Si vous supprimez ou mettez à jour la pièce jointe avant d'envoyer l'élément de catalogue correspondant, l'entrée de la table Pièce jointe [sys_attachment] est effacée.
- Dans un guide de commande, lorsque la variable est mise en cascade sur un élément de catalogue dans la base de la règle.Important :les attributs de variable individuels ne sont pas respectés pour les éléments de catalogue dans la base de la règle. Par exemple, supposons qu'une variable dans la section Décrire les besoins autorise une pièce jointe .pdf et que la variable d'un élément de catalogue dans la base de la règle autorise une pièce jointe .txt. Lorsque vous chargez une pièce jointe de type .pdf pour une variable dans la section Décrire les besoins, celle-ci est initialement mise en cascade sur la variable de l'élément de catalogue et les attributs de variable spécifiés dans l'élément de catalogue ne sont pas respectés. Toutefois, si vous supprimez cette pièce jointe initialement mise en cascade à partir d'un élément individuel et que vous tentez de charger une nouvelle pièce jointe, les attributs de variable individuels de l'élément de catalogue sont respectés.
- Dans un créateur d'enregistrement, lorsque la variable est mappée sur un champ de la table de tâches. Cette variable ne peut être mappée que sur le type de champ Pièce jointe de fichier d'une table de tâches.
- envoyez une demande pour l'élément de catalogue correspondant ;
- ajoutez l'élément de catalogue au panier ou à la liste de souhaits.
- Cette variable n'est pas prise en charge dans un jeu de variables de plusieurs lignes.
- Cette variable est prise en charge dans les flux et les workflows.
- Cette variable est disponible dans le créateur de condition.
- Pour cette variable, l'affectation de variable d'élément n'est pas prise en charge dans le guide de commande.
Pause
La variable Pause affiche une ligne horizontale le long du formulaire. Cette ligne est un élément de formatage qui ne collecte pas de données.
Case à cocher
La variable Case à cocher vous permet d'activer et de désactiver les options en la cochant et en la décochant.
Pour qu'une case à cocher soit obligatoire, sélectionnez l'option Sélection obligatoire lorsque vous créez la variable. Par exemple, utilisez cette option pour exiger que les utilisateurs cochent la case J'accepte dans un formulaire d'accord. Si les utilisateurs essaient d'envoyer le formulaire d'accord sans cocher la case, un message d'alerte s'affiche pour indiquer aux utilisateurs qu'ils doivent cocher la case.
Un groupe de variables Case à cocher est créé lorsque vous créez des variables Case à cocher consécutives. Ces variables Case à cocher sont triées par ordre au sein du groupe. Si vous souhaitez définir une étiquette personnalisée pour le groupe de cases à cocher, créez une variable Étiquette au début des variables Case à cocher consécutives. L'étiquette est alors considérée comme faisant partie de ce groupe et agit comme une étiquette du groupe. S'il n'y a pas d'étiquette personnalisée, les cases à cocher sont regroupées sous une étiquette Options par l'application.
- Si une variable Case à cocher du groupe est obligatoire, l'ensemble du groupe devient obligatoire, quelle que soit la visibilité de la variable Case à cocher obligatoire. Un astérisque (*) s'affiche ensuite à côté de l'étiquette du groupe et vous devez sélectionner au moins l'une de ces cases à cocher.
- Si vous masquez l'étiquette, le groupe tout entier est masqué.
- Si toutes les autres variables Case à cocher d'un groupe de cases à cocher obligatoires sont masquées et décochées, les scénarios suivants sont applicables :
- Le groupe reste obligatoire tant qu'il y a au moins une case à cocher visible et décochée dans le groupe.
- La dernière case à cocher du groupe ne peut pas être masquée si elle est décochée.
Dans Service Portal, pour rendre un groupe de variables Case à cocher obligatoire, définissez au moins l'une des variables Case à cocher comme étant obligatoire. Lors de la définition de l'étiquette d'un groupe de cases à cocher, la définition d'une étiquette obligatoire ne rend pas le groupe de variables Case à cocher obligatoire.
- S'il existe deux cases à cocher consécutives, un conteneur virtuel est créé pour un groupe de cases à cocher. Seuls les types de variables Case à cocher peuvent être ajoutés à l'intérieur du groupe.
- Même si une variable Case à cocher est ajoutée immédiatement après un groupe de cases à cocher, elle est automatiquement ajoutée au groupe.
- Calculé
- Fixe
- Plusieurs
Pour plus d'informations sur la variable Case à cocher, voir la vidéo suivante :
Début conteneur, Séparation du conteneur et Fin conteneur
Les variables Début conteneur, Séparation du conteneur et Fin conteneur définissent une mise en page pour les conteneurs pouvant contenir plusieurs variables. Utilisez les variables Début conteneur et Fin conteneur pour définir les points de début et de fin de la mise en page d'un conteneur. La Variable Fin conteneur doit être utilisée conjointement avec la variable Début conteneur pour fermer un conteneur.
Une mise en page de conteneur peut être divisée en deux ou trois colonnes à l'aide de la variable Séparation du conteneur. Par défaut, la séparation est calculée à la marque des 50 %.
Les conteneurs sont similaires aux jeux de variables. Contrairement aux jeux de variables, les conteneurs peuvent être utilisés n'importe où, y compris à l'intérieur des jeux de variables. Les conteneurs peuvent également être imbriqués l'un dans l'autre.
Pour plus d'aide sur la sélection du type de conteneur approprié, voir l'article Determining if you are using the correct container variable (Déterminer si vous utilisez la variable de conteneur correcte) [KB0539982] dans la base de connaissances HI.
- Les variables de conteneur ne sont pas encore prises en charge sur les équipements mobiles.
- Les variables Début conteneur, Séparation du conteneur et Fin conteneur sont prises en charge dans Service Portal. Toutefois, si les réglages sont effectués sur le conteneur de niveau supérieur, des mises en page à deux colonnes maximum peuvent être réalisées.
- Les jeux de variables sont également considérés comme des conteneurs. Ainsi, une variable Début conteneur avec une mise en page à deux colonnes sous un jeu de variables n'est pas prise en charge dans Service Portal.
- Sélectionnez la Mise en page Élargi sur 2 colonnes, en alternant les côtés.
- Cochez la case Titre d'affichage pour utiliser une barre de titre réductible.
Date
La variable Date crée un widget avec un champ et un calendrier pour sélectionner une date.
Date et heure
La variable Date et heure crée un widget avec un calendrier et des champs pour sélectionner une date et une heure. La valeur de temps est stockée en Heure du méridien de Greenwich (GMT) et affichée dans votre fuseau horaire.
Durée
Utilisez la variable Durée pour spécifier la durée pour laquelle un élément de catalogue est disponible.
La variable E-mail crée un widget pour saisir et sélectionner une adresse e-mail. Cette variable n'accepte que les expressions d'e-mail valides contenant le symbole @ et les informations de domaine.
HTML
La variable HTML vous permet de fournir du contenu avec un formatage avancé, y compris des images, pour un élément de catalogue.
Utilisez cette variable pour créer des champs pour l'entrée de l'utilisateur. Vous pouvez également l'utiliser pour le contenu réutilisable, comme les termes et conditions, lorsqu'elle est ajoutée à un jeu de variables.
Cette variable est disponible en deux modes : Modifiable et Lecture seule. En mode Modifiable, une barre d'outils est disponible et les liens ne fonctionnent pas. En mode Lecture seule, la barre d'outils est désactivée et les liens fonctionnent. Pour passer d'un mode à l'autre, utilisez des autorisations ou créez une politique d'interface utilisateur pour définir le champ HTML en mode lecture seule.
Adresse IP
Utilisez la variable Adresse IP pour spécifier les données IPv4 et IPv6 pour un élément de catalogue. Dans le sous-module Scripts de validation, un type de script de validation associé à cette variable est disponible.
- La validation de la variable n'est pas prise en charge dans Service Portal.
- Lorsque vous configurez la valeur par défaut de la variable Adresse IP ou que vous spécifiez sa valeur dans les fonctions g_form.getValue() et g_form.setValue(), le délimiteur est (.).
Étiquette
La variable Étiquette affiche une étiquette tout le long du formulaire. Les étiquettes sont des éléments de formatage. Aucune donnée n'est collectée.
Vous pouvez utiliser des étiquettes pour organiser les questions en sections. Vous pouvez également utiliser des étiquettes pour les questions avec plusieurs options. Par exemple, étiquetez les cases à cocher pour les différentes options d'une question.
Vous ne pouvez pas définir une variable Étiquette comme étant obligatoire. Toutefois, vous pouvez rendre obligatoire un groupe de variables Case à cocher précédé d'une variable Étiquette.
Collecteur de liste
La variable Collecteur de liste crée une interface qui vous permet de sélectionner et d'ajouter plusieurs enregistrements à partir d'une table. Pour les attributs pris en charge par cette variable, voir Attributs de variable.
Pour plus d'informations sur l'utilisation de la variable Collecteur de liste, voir la vidéo suivante :
- Le qualificatif de référence et l'attribut glide_list ne s'appliquent qu'aux versions à partir d'Helsinki. L'attribut ne s'applique pas à la version Geneva.
- Vous pouvez définir une valeur pour cette variable à l'aide de la fonction g_form.setValue() dans un script client de catalogue.
- Lorsque l'attribut de la liste glide_list n'est pas défini sur true, vous ne pouvez définir la valeur visible dans la liste Disponible qu'à l'aide de la fonction g_form.setValue(). Cette fonctionnalité n'est pas applicable lorsque la fonction setValue() est appelée onLoad.
- Les tables avec des données volumineuses entraînent des problèmes de performances lors du chargement de la page. Utilisez des qualificatifs de référence pour réduire les données ou utilisez l'attribut glide_list.
- Les valeurs de la table référencée n'apparaissent pas si l'utilisateur n'est pas connecté.
- Le collecteur de liste affiche un maximum de 100 éléments dans une liste. Après avoir déplacé des éléments vers la liste Sélectionné, vous pouvez cliquer sur Filtrer pour actualiser la liste Disponible. Cette action ajoute d'autres éléments disponibles à la liste, jusqu'à un maximum de 100 éléments.
Choix multiple de recherche
La variable Choix multiple de recherche crée des cases d'option à l'aide des données d'une table. Sa fonctionnalité est similaire à la variable Zone de sélection de recherche, qui crée une liste de choix à partir de données interrogées. Pour les attributs pris en charge par cette variable, voir Attributs de variable.
- Les tables avec des données volumineuses entraînent des problèmes de performances lors du chargement de la page. Utilisez des qualificatifs de référence pour réduire les données ou utilisez la variable de type de référence.
- Vous ne pouvez pas ajouter plus de 10 000 choix.
Zone de sélection de recherche
La variable Zone de sélection de recherche crée une liste de choix à l'aide des données interrogées depuis une table. Sa fonctionnalité est similaire à celle de la variable Choix multiple de recherche, qui crée des cases d'option à partir de données interrogées. Pour les attributs pris en charge par cette variable, voir Attributs de variable.
- Rechercher depuis la table :
Incident [incident] - Champ de valeur de référence :
ID système - Champ d'étiquette de référence :
nombre, catégorie, priorité - Qualificatif de référence :
caller_id=javascript:gs.getUserID()^active=true
- Les tables avec des données volumineuses entraînent des problèmes de performances lors du chargement de la page. Utilisez des qualificatifs de référence pour réduire les données ou utilisez la variable de type de référence.
- Vous ne pouvez pas ajouter plus de 10 000 choix.
Personnalisé
Cette variable insère une macro d'interface utilisateur dans l'élément de catalogue.
Les macros d'interface utilisateur dans le catalogue de services ne prennent pas en charge les fonctions glide_list suivantes : clic de renvoi, modification des zones de sélection et champ d'e-mail.
- Utilisez uniquement la phase un de la syntaxe Jelly pour les macros d'interface utilisateur ajoutées en tant que variables. La deuxième phase de Jelly dans la macro n'est pas traitée et apparaît sur la page en tant que contenu standard.
- Cette variable n'est pas encore prise en charge sur les appareils Classic Mobile.
- Cette variable est prise en charge dans Service Portal via les widgets. Créez un widget avec la même fonctionnalité que celle d'une macro et reliez le widget à la variable.
Personnalisé avec étiquette
Cette variable insère une macro d'interface utilisateur avec une étiquette.
- Cette variable n'est pas encore prise en charge sur les appareils Classic Mobile.
- Cette variable est prise en charge dans Service Portal via les widgets. Créez un widget avec la même fonctionnalité que celle d'une macro avec étiquette et reliez-le à la variable.
Masqué
La variable Masqué insère un champ qui masque le texte saisi. Chaque caractère saisi s'affiche sous la forme d'un astérisque (*). Utilisez cette variable pour demander aux utilisateurs des données sensibles ou confidentielles telles que les mots de passe.
Sur l'éditeur de variable, vous pouvez aussi déchiffrer et chiffrer les valeurs d'une variable Masqué à l'aide des boutons Afficher et Masquer. Ces boutons ne sont pas disponibles pour les prestataires (ITIL) n'ayant pas le rôle catalog_view_masked. Vous ne pouvez afficher que la valeur que vous avez spécifiée lors de la demande.
| Action | Rôles | ||
| Demandeur | Prestataire avec le rôle catalog_view_masked | Prestataire sans le rôle catalog_view_masked | |
| Afficher ou masquer la valeur chiffrée sur les formulaires de catalogue | Oui | Non applicable | Non applicable |
| Modifier la valeur chiffrée sur les formulaires de catalogue | Oui | Non applicable | Non applicable |
| Afficher ou masquer la valeur chiffrée dans l'éditeur de variable | Oui | Oui | Non |
| Modifier la valeur chiffrée dans l'éditeur de variable | Oui Remarque : si la variable Masqué est en lecture seule sur l'éditeur de variable, la valeur de la variable n'est pas modifiable |
Oui Remarque : si la variable Masqué est en lecture seule sur l'éditeur de variable, la valeur de la variable n'est pas modifiable |
Non |
Texte sur plusieurs lignes
La variable Texte sur plusieurs lignes crée un champ qui vous permet de saisir plusieurs lignes de texte.
Choix multiple
La variable Choix multiple crée des cases d'option pour les choix de questions.
Échelle numérique
La variable Échelle numérique crée un ensemble de cases d'option pour une gamme d'options, comme une échelle de Likert.
Référence
Une variable Référence fait référence à un enregistrement dans une autre table. Par exemple, une variable nommée point_de_contact fait référence à la table Utilisateur [sys_user]. Pour les attributs pris en charge par cette variable, voir Attributs de variable.
- Les variables Référence utilisent la fonctionnalité de saisie semi-automatique. Pour vous assurer que les utilisateurs disposent de suffisamment d'informations pour effectuer la sélection, configurez l'option liste de recherche de référence.
- Les variables Référence stockent le sys_id de l'enregistrement sélectionné (comme les champs de référence). Pour utiliser la valeur d'affichage dans un script, utilisez les mêmes méthodes que pour un champ de référence.
current.variables.<variable name>.getDisplayValue()Demandé pour
Avant d'envoyer une demande d'élément de catalogue, cette variable vous permet d'indiquer à qui envoyer cette demande. Vous devez spécifier ces informations lors de la réponse aux questions d'élément de catalogue.
- Vous ne pouvez spécifier que les utilisateurs à partir de la table Utilisateur [sys_user].
- Si vous ne spécifiez pas la valeur par défaut de cette variable, l'utilisateur connecté actuel qui demande l'élément est considéré comme la valeur de variable Demandé pour par défaut.
- Vous pouvez envoyer la demande d'un utilisateur en fonction de l'accès à un élément de catalogue. Il est possible d'utiliser le champ Type d'accès de l'élément de catalogue pour déterminer si une demande peut être envoyée à un utilisateur qui n'a pas accès à l'élément de catalogue.
- Pour cette variable, l'affectation de la variable d'élément n'est pas prise en charge dans la base de la règle d'un guide de commande. Si le guide de commande contient la variable Demandé pour, la valeur est mise en cascade sur la variable équivalente des éléments dans la base de la règle en lecture seule.
À l'aide du champ Activer également la demande pour de la variable Demandé pour, vous pouvez demander un élément de catalogue pour différents utilisateurs dans une seule demande.
Pour en savoir plus sur l'expérience de demande déléguée, consultez la rubrique Expérience de demande déléguée.
- Vous pouvez ajouter cette variable à un élément de catalogue ou à un jeu de variables. Toutefois, lors de l'envoi de la demande, un élément de catalogue ne peut avoir qu'une seule variable Demandé pour.
- Vous ne pouvez ajouter qu'une seule variable Demandé pour à un jeu de variables.
- Cette variable n'est pas prise en charge dans un jeu de variables de plusieurs lignes.
- Une fois la demande envoyée, cette valeur de variable est visible dans l'éditeur de variable et l'outil de synthèse de variables.
Étiquette de texte enrichi
Cette variable affiche une étiquette formatée sur un formulaire d'élément de catalogue. Dans l'éditeur de texte enrichi TinyMCE, vous pouvez formater l'étiquette et y ajouter des images ou des liens. Cette variable prend en charge les balises HTML.
- Vous pouvez rendre cette variable visible à l'aide de scripts clients de catalogue et de politiques d'interface utilisateur de catalogue.
- Vous ne pouvez pas mettre en cascade cette variable dans un guide de commande.
- Vous ne pouvez pas rendre cette variable obligatoire.
- Dans Automated Test Framework, cette variable n'est prise en charge que dans l'étape de validation de l'état de la variable pour vérifier la visibilité.
- Cette variable n'est pas prise en charge dans les éléments suivants :
- Outil de synthèse de variables
- Jeu de variables de plusieurs lignes
- Créateurs de condition et rapports
- Vous ne pouvez pas spécifier les éléments suivants pour cette variable :
- Texte d'aide et instructions
- Info-bulle
- Autorisations
- Largeur de variable
- Exemple texte
- Les APIs g_form.setValue(),g_form.setReadOnly() et g_form.setMandatory() ne sont pas prises en charge dans les scripts clients du catalogue. Seule l'API g_form.setVisible() est prise en charge.
Zone de sélection
La variable Zone de sélection crée une liste à partir de choix de questions prédéfinis. Pour les attributs pris en charge par cette variable, voir Attributs de variable.
Texte sur ligne unique
La variable Texte sur ligne unique crée un champ pour saisir une seule ligne de texte. Pour les attributs pris en charge par cette variable, voir Attributs de variable.
Page de l'interface utilisateur
La variable Page de l'interface utilisateur insère une page d'interface utilisateur dans l'élément de catalogue.
- Utilisez uniquement la phase un de la syntaxe Jelly pour toutes les macros d'interface utilisateur ajoutées en tant que variables. La phase deux de Jelly dans la macro n'est pas traitée et apparaît sur la page en tant que contenu standard.
- Cette variable n'est pas encore prise en charge sur les appareils Classic Mobile et dans Service Portal.
URL
La variable URL crée un widget pour permettre aux utilisateurs de saisir des URL. Les URL sont validées pour les protocoles suivants : HTTP, HTTPS, FTP.
- la validation de la variable n'est pas prise en charge dans Service Portal.
- Cette variable n'est pas modifiable sur Now Mobile.
Texte sur ligne unique large
La variable Texte sur ligne unique large crée un champ qui étend le formulaire, permettant ainsi aux utilisateurs de saisir des lignes de texte plus longues. Pour les attributs pris en charge par cette variable, voir Attributs de variable.
Oui/Non
La variable Oui/Non crée une liste de choix avec Oui et Non comme options.