Attributs de l’écran du formulaire d’entrée pour les entrées
Différents types d’entrées sont disponibles pour être utilisés dans les écrans du formulaire d’entrée, et vous pouvez utiliser différents attributs pour configurer les entrées.
Utilisez les attributs d’entrée pour définir l’apparence et définir des limites sur vos entrées. Par exemple, définissez des valeurs minimales et maximales ou affichez une valeur d’entrée sous forme de pourcentage.
Attribut général
Vous pouvez utiliser cet attribut avec n’importe quel écran de formulaire d’entrée, quel que soit le type d’entrée.
| Attribut | Description |
|---|---|
| DescriptionRenderType | Définissez un type de rendu pour la description de l’entrée. html : vous permet d’utiliser des balises HTML pour formater le texte dans le champ Description de votre entrée. |
| DataSourceId | Définissez cet attribut chaque fois que vous créez un mécanisme de source de données pour charger les valeurs d’entrée. Pour plus d'informations, consultez Sources de données. Remarque : Cet attribut n’est pas pris en charge avec les entrées de signature. |
| ElementIdentifier | Définissez cet attribut chaque fois que vous créez un mécanisme de source de données pour charger les valeurs d’entrée. Pour plus d'informations, consultez Sources de données. Remarque : Cet attribut n’est pas pris en charge avec les entrées de signature. |
Entrées de pièces jointes
|
Utilisez les entrées de pièce jointe pour permettre aux utilisateurs de joindre des fichiers dans un écran de formulaire d’entrée. Les entrées de pièce jointe nécessitent un élément d’action scripté et un actionResult objet pour charger un fichier.
Remarque : Les entrées de pièce jointe ne sont prises en charge que pour les actions scriptées. |
(function WriteBackAction(parm_input, parm_variable, actionResult) {
//other write-back inputs and variables here
actionResult.addAttachment("attach", "incident", gr.getUniqueValue()); //where "attach" is the input name from above screenshot, and “incident” is the table name
})(parm_input, parm_variable, actionResult);
- Restreindre les sources des pièces jointes aux utilisateurs
- Vous avez la possibilité de limiter les origines des pièces jointes, afin de vous assurer que les images proviennent de l’un ou de l’ensemble des éléments suivants :
- sur site via une caméra
- à partir de la galerie de téléphones de l’utilisateur
- à partir du système de fichiers de l’utilisateur
Dans l’enregistrement d’attribut d’entrée, sélectionnez HiddenAttachmentSources. Sélectionnez Caméra, Fichiers ou Galerie, dans le champ Valeur , puis sélectionnez Enregistrer. Répétez le processus si vous souhaitez inclure plusieurs sources de pièces jointes. Pour plus d'informations, consultez Définir les sources de pièces jointes disponibles pour les utilisateurs.
Attribut Description HiddenAttachmentSources Décidez d’où vous ne voulez pas que les images proviennent. Sélectionnez l’une des valeurs de source suivantes : caméra, fichiers ou galerie, dans le champ Valeur . Remarque :Pour éviter que des images et des fichiers ne soient obtenus à partir de plusieurs sources, ajoutez des attributs supplémentaires HiddenAttachmentSources après avoir enregistré l’attribut que vous êtes en train de configurer.
Entrées de codes-barres
Utilisez les entrées de code-barres pour numériser un ou plusieurs codes-barres. Les codes-barres sont des codes lisibles par machine sous forme de chiffres et d’un motif de lignes parallèles de différentes largeurs. Ces codes sont utilisés pour identifier des éléments tels que des produits, des pièces ou des actifs. Vous pouvez utiliser ce type d’entrée pour saisir des informations sur les éléments dans votre ServiceNow instance à l’aide de votre application mobile.
- Les entrées de codes-barres peuvent être configurées pour des scans uniques, des scans multiples ou des scans groupés. Les analyses uniques permettent à l’utilisateur d’effectuer une analyse unique. Dans ce cas, l’utilisateur doit analyser à nouveau en appuyant sur l’icône d’analyse, ce qui efface la valeur d’analyse. Vous n’avez pas besoin de configurer un attribut pour une seule entrée de code-barres de balayage.
- Les entrées multi-balayage peuvent être configurées avec l’attribut MaxEntries . Si l’entrée de code-barres de l’écran de votre formulaire d’entrée est configurée avec l’attribut, les MaxEntries utilisateurs peuvent rapidement scanner plusieurs codes-barres séquentiellement sans quitter l’interface de numérisation.
- Les numérisations groupées peuvent être configurées pour numériser plusieurs codes-barres associés à un actif qui doit être regroupé dans un ensemble. Pour configurer une entrée de code-barres groupée, vous devez créer une section de code-barres dans l’écran du formulaire d’entrée qui comporte uniquement des entrées de code-barres. Ensuite, l’attribut section MaxEntries doit être configuré pour la section de code-barres groupée afin que les utilisateurs puissent scanner plusieurs groupes de codes-barres.
| Attribut | Description |
|---|---|
| MaxEntries | Utilisé uniquement pour configurer plusieurs lecteurs et plusieurs groupes de codes-barres. Définit le nombre maximal de codes-barres qu’un utilisateur peut scanner à la fois. Par exemple, vous pouvez définir la valeur sur 5 pour permettre aux utilisateurs d’analyser à nouveau 5 fois. Remarque : Utilisez cet attribut uniquement pour les entrées de codes-barres à balayage multiple. Si votre entrée de code-barres est destinée à des scans uniques, aucun attribut n’est requis. |
Pour plus d’informations sur la création d’un écran de formulaire d’entrée avec des entrées de code-barres, reportez-vous aux sections Configurer les écrans du formulaire d’entrée avec des entrées de codes-barres à lecture unique et multiple et Configurer les écrans du formulaire d’entrée avec des entrées de codes-barres d’analyse groupées.
Entrées booléennes
|
Utilisez des entrées booléennes pour les entrées avec des valeurs vrai ou faux. Vous pouvez configurer des entrées booléennes pour qu’elles apparaissent sous forme de case à cocher ou de commutateur. |
Vous pouvez utiliser ces attributs avec des entrées booléennes.
| Attribut | Description |
|---|---|
| RenderType | Spécifiez un type de rendu pour l’entrée booléenne.
|
Entrées de choix
|
Utilisez des entrées de choix pour proposer à vos utilisateurs des options parmi lesquelles choisir. Vous pouvez créer ces choix manuellement ou utiliser une table et un champ existants pour fournir les choix. Configurez une entrée de choix pour permettre aux utilisateurs de sélectionner un seul choix ou plusieurs choix. L’option permettant de sélectionner plus d’une puce dans une catégorie est marquée par un signe + sur les puces. Définissez le nombre de jetons à afficher, ce qui permet à l’utilisateur de voir toutes les options disponibles sur un seul écran de formulaire d’entrée. Si le nombre défini de jetons à afficher dépasse le nombre défini, un bouton Voir tout s’affiche. Appuyez sur le bouton Voir tout pour ouvrir une page avec toutes les options répertoriées. |
|
Vous pouvez utiliser ces attributs avec des entrées de choix.
| Attribut | Description |
|---|---|
| MultiSelect | Option permettant aux utilisateurs de sélectionner plusieurs choix pour l’entrée. La valeur doit être vrai ou faux. Les options à sélection multiple sont indiquées par un signe « + » sur la puce. |
| Table | Table dans laquelle se trouve le champ de choix. Remarque : Utilisez cette option pour utiliser les choix dans une table et un champ existants plutôt que de créer manuellement des choix. Vous devez sélectionner un champ dans cette table à l’aide de l’attribut Field . |
| Field | Champ qui contient vos choix. Remarque : Utilisez cette option pour utiliser les choix dans une table et un champ existants plutôt que de créer manuellement des choix. Le champ défini dans cet attribut doit faire partie de la table définie dans l’attribut Table . |
| Inline | Option permettant de sélectionner le mode d’affichage des entrées de votre choix. Par défaut, la valeur est faux, ce qui signifie que l’affichage du choix est sur le même écran, ce qui élimine la nécessité de naviguer vers un écran distinct. Pour un exemple visuel, voir l’image dans l’introduction des entrées de choix. Si vous sélectionnez vrai, une option de type liste s’affiche où les utilisateurs doivent accéder à un écran supplémentaire, une fois la sélection effectuée. |
| InlineMaxItems | Option permettant de définir le nombre de jetons à afficher dans une section d’écran de formulaire d’entrée. Les entrées suivantes sont disponibles dans le champ Valeur :
|
| RenderType | Option permettant d’afficher les options de choix sous forme d’image pour l’entrée de choix. La valeur doit être image. |
| EnableSearch | Option permettant d’afficher la barre de recherche. La valeur doit être vrai ou faux. |
| SearchPlaceholder | Texte qui apparaît dans une barre de recherche en tant qu’espace réservé. |
| SearchType | Définit la requête utilisée pour la recherche. La valeur peut être starts_with ou contient. Si cet attribut n’est pas configuré, l’instance l’utilise starts_with par défaut dans la colonne Étiquette d’affichage. |
Entrées de carte personnalisée
|
Utilisez les entrées de carte personnalisée pour ajouter un lien vers une carte d’intérieur dans votre application mobile. Les utilisateurs peuvent utiliser ces cartes pour obtenir des itinéraires et réserver des ressources telles que des bureaux, des salles de réunion ou des casiers. Les administrateurs peuvent également configurer un élément de données paramétré avec des conditions de requête qui permettent le tri et le filtrage de l’entrée de la carte personnalisée. Important :
Les entrées de carte personnalisée qui prennent en charge les éléments de données paramétrés doivent utiliser uniquement l’attribut ScreenId . N’utilisez aucun autre type d’attribut pour les entrées de carte personnalisée qui prennent en charge les éléments de données paramétrés. Si vous modifiez une entrée de carte personnalisée existante qui utilise le qualificatif de référence avancé pour utiliser un élément de données paramétré, utilisez uniquement l’attribut ScreenId et supprimez tous les autres attributs. |
|
| Attribut | Description |
|---|---|
| CustomMapConfigId | La sys_id de la table sys_sg_custom_map_config. |
| CustomMapDefaultProviderId | La sys_id de l’enregistrement du fournisseur dans la table sys_sg_custom_map_provider. |
| CustomMapInputs | La sys_id du sol dans la table sys_sg_input. Cette valeur doit être saisie sous forme de tableau JSON. |
| ScreenId | La sys_id d’un élément de données paramétré utilisé pour trier et filtrer les entrées de carte personnalisée. Important : Cet attribut ne peut pas être utilisé avec un autre attribut d’entrée de carte personnalisé. Si vous utilisez l’attribut ScreenId avec une entrée de carte personnalisée, n’utilisez pas d’autres attributs avec l’entrée. |
| TargetTable | Définir sur sn_wsd_core_space. |
Entrées de date/heure
|
Utilisez les entrées date/heure pour permettre à vos utilisateurs d’entrer des valeurs de date et d’heure. Vous pouvez configurer l’entrée pour la date et l’heure, ou pour la date uniquement. |
Vous pouvez utiliser ces attributs avec les entrées de date/heure.
| Attribut | Description |
|---|---|
| RenderType | Spécifiez un type de rendu pour l’entrée date/heure.
|
| IncludeTimezone |
Fuseau horaire de l’appareil mobile sur lequel l’entrée est ajoutée. La valeur doit être vrai ou faux. Lorsque la valeur est définie sur vrai, le client mobile envoie les informations du fuseau horaire de l’appareil ainsi que la valeur de la date et de l’heure à l’instance principale au format suivant : JJ-MM-AAAAThh :mm :ss.sssTZD Remarque :
Le fuseau horaire de l’appareil est différent du fuseau horaire du profil d’utilisateur configuré sur la plateforme. Si cet attribut n’est pas configuré, le client mobile n’inclut pas les informations sur le fuseau horaire de l’appareil dans les valeurs d’entrée date/heure. Il s’agit du comportement par défaut. Les valeurs d’entrée date/heure sont au format suivant : AAAA-MM-JJ hh :mm :ss Pour plus d’informations sur la configuration de l’attribut IncludeTimezone des entrées date/heure pour différents types d’actions, reportez-vous à la section Configuration de l’entrée de date/heure pour différents types d’élément d’action. Pour en savoir plus sur les types d’élément d’action, reportez-vous à la section Configurer un élément d’action. |
| MaxRangeDays |
Attribut facultatif qui détermine si des dates futures peuvent être sélectionnées lorsqu’une entrée de date/heure est ajoutée. Cet attribut prend en charge les valeurs d’entiers positifs et négatifs. La valeur MaxRangeDays0 empêche les utilisateurs de sélectionner des dates futures et les limite aux dates actuelles ou passées. Remarque :
MaxRangeDays peut être utilisé avec MinRangeDays, MaxRangeHours, et MinRangeHours. |
| MinRangeDays |
Attribut facultatif qui détermine si des dates passées peuvent être sélectionnées lorsqu’une entrée date/heure est ajoutée. Cet attribut prend en charge les valeurs d’entiers positifs et négatifs. La valeur MinRangeDays0 empêche les utilisateurs de sélectionner des dates passées et les restreint aux dates actuelles ou futures. Remarque :
MinRangeDays peut être utilisé avec MaxRangeDays, MaxRangeHours, et MinRangeHours. |
| MaxRangeHours |
Attribut facultatif qui détermine si les heures futures peuvent être sélectionnées lorsqu’une entrée de date/heure est ajoutée. Cet attribut prend en charge les valeurs d’entiers positifs et négatifs. La valeur MaxRangeHours0 empêche les utilisateurs de sélectionner des dates et heures futures et les limite aux dates actuelles ou passées. Remarque :
MaxRangeHours peut être utilisé avec MaxRangeDays, MinRangeDays, et MinRangeHours. |
| MinRangeHours |
Attribut facultatif qui détermine si les heures passées peuvent être sélectionnées lorsqu’une entrée de date/heure est ajoutée. Cet attribut prend en charge les valeurs d’entiers positifs et négatifs. La valeur MinRangeHours0 empêche les utilisateurs de sélectionner des dates et heures passées et les limite aux dates et heures actuelles ou futures. Remarque :
MinRangeHours peut être utilisé avec MaxRangeDays, MinRangeDays, et MaxRangeHours. |
Nombre d’entrées
|
Utilisez des entrées numériques pour permettre à vos utilisateurs de saisir des valeurs numériques. Définissez des valeurs minimales et maximales facultatives pour définir une plage de nombres pour votre entrée. Vous pouvez éventuellement configurer une entrée numérique pour qu’elle apparaisse sous forme de pourcentage. Par défaut, les entrées numériques prennent en charge les décimales. Pour disposer de l’entrée de zone de base d’un nombre, dans un enregistrement d’entrée, renseignez tous les champs obligatoires et sélectionnez Numéro dans le champ Type d’entrée . |
| Attribut | Description |
|---|---|
| CustomErrorMessage | Définit un message d’erreur personnalisé que vous pouvez spécifier. Ce message s’affiche lorsque la condition de la règle d’interface utilisateur associée est remplie. |
| Max | Spécifiez une valeur maximale pour l’entrée. |
| Min | Spécifiez une valeur minimale pour l’entrée. |
| RenderType | Spécifiez un type de rendu pour l’entrée numéro.
Remarque : Pour obtenir un tableau indiquant quels attributs peuvent être utilisés avec quel type de rendu, reportez-vous à la section Numéroter les types de rendu et les attributs d’entrée compatibles. |
| SkipValidationWhenHidden | Remarque : Peut être défini sur vrai ou faux. Elle est définie sur false par défaut, ce qui signifie que, par défaut, la validation de la règle d’interface utilisateur associée est exécutée sur les entrées masquées. Définissez cette valeur sur vrai uniquement lorsque vous souhaitez ignorer la validation sur les entrées masquées.Cet attribut ne peut être utilisé qu’avec les types de rendu de lignes et de pourcentages. |
| Attribut | Description |
|---|---|
| DefaultValue |
Valeur affichée lorsque l’utilisateur affiche le curseur pour la première fois. Si aucune valeur n’est saisie, la valeur affichée est zéro. La valeur par défaut doit être comprise entre les valeurs minimale et maximale. Remarque :
Cette valeur définie est le point de départ, à moins qu’un mécanisme de chargement, prioritaire, ne soit configuré. Voir Mécanismes de chargement pour les écrans du formulaire d’entrée. |
| StepSize | La taille de chaque étape sur le curseur. Les étapes doivent être un nombre divisible entre le nombre max et min. Par exemple, le nombre minimal est 20 et le nombre maximal est 80, la taille de pas peut être constituée de nombres tels que 2, 5 ou 10. |
| ReferencePoint | Lorsque la valeur est définie sur vrai , un marqueur est ajouté au curseur, fournissant un point de référence visuel à l’utilisateur. Remarque : Par souci de clarté visuelle, cet attribut d’entrée ne doit pas être utilisé avec l’attribut d’entrée VisualStepsEnabled. |
| VisualStepsEnabled | Lorsqu’il est défini sur vrai, le curseur affiche les incréments visuels en fonction de l’attribut d’entrée StepSize spécifié. Remarque : Pour des raisons de clarté visuelle, cet attribut d’entrée ne doit pas être utilisé avec l’attribut d’entrée ReferencePoint. |
| EnforceStepSize | Lorsque la valeur est définie sur vrai, les utilisateurs ne peuvent pas saisir de valeur dans la zone numérique qui ne s’aligne pas sur la valeur StepSize. |
| Decoration | Définit les sections sur le curseur avec les étiquettes correspondantes qui s’affichent lorsqu’un utilisateur appuie sur une section ou saisit une valeur. Chaque section peut être associée à une couleur spécifique pour faciliter la représentation visuelle. Pour plus d'informations, consultez Configurer une option de curseur pour une entrée numérique. |
Entrées de classements
|
Utilisez les entrées de classement pour permettre à vos utilisateurs de trier les choix disponibles par ordre de préférence ou de priorité. Les utilisateurs appuient et font glisser les choix disponibles. Les choix pour l’entrée de classement doivent être définis manuellement. |
Il n’existe aucun attribut pour le classement des entrées autre que les attributs généraux répertoriés dans cette rubrique.
Entrées de référence
Utilisez les entrées de référence pour les entrées qui font référence à un champ dans une table. Ces entrées fonctionnent comme des champs de référence dans les formulaires de votre instance. Vous pouvez configurer votre entrée de référence avec des conditions, des qualificatifs de référence et une option de recherche pour aider vos utilisateurs à trouver rapidement ce dont ils ont besoin.
L’option de recherche facultative utilise les recherches par mot clé « Pour le texte » et peut rechercher des éléments dans la vue mobile.
Vous pouvez utiliser ces attributs avec des entrées de référence.
| Attribut | Description |
|---|---|
| SourceTable | La table source de votre qualificatif de référence. |
| SourceFieldName | Nom de champ du champ référencé dans la table source. |
| TargetTable | La table que vous souhaitez cibler pour votre qualificatif de référence. |
Les attributs supplémentaires suivants sont facultatifs :
| Attribut | Description |
|---|---|
| MultiSelect | Option permettant aux utilisateurs de sélectionner plusieurs choix pour l’entrée. La valeur doit être vrai ou faux. |
| MobileViewId | ID de vue mobile (configuration de la vue) à utiliser pour les éléments de liste de référence. |
| EnableSearch | Option permettant d’afficher la barre de recherche. La valeur doit être vrai ou faux. |
| SearchPlaceholder | Texte qui apparaît dans une barre de recherche en tant qu’espace réservé. |
| Conditions | Entrez une requête codée pour appliquer des conditions à votre liste de référence. Pour plus d’informations sur la création de ces requêtes, consultez Chaînes de requête codées. |
| SearchType | Définit la requête utilisée pour la recherche. La valeur peut être starts_with ou contient. Si cet attribut n’est pas configuré, l’instance l’utilise starts_with par défaut dans la colonne Étiquette d’affichage. |
Cet exemple crée une entrée d’écran de formulaire d’entrée pour le champ Affecté à de la table Incident [incident]. Pour créer cette entrée, vous utilisez les trois attributs requis : TargetTable, SourceTable et SourceFieldName.
- Vos utilisateurs effectuent leur sélection dans une liste d’utilisateurs auxquels affecter l’incident. Vous devez donc définir l’attribut TargetTable sur sys_user.
- Étant donné que vous ajoutez l’utilisateur à un enregistrement d’incident, l’attribut SourceTable est défini sur incident.
- Définissez le SourceFieldName sur assigned_to afin que l’utilisateur sélectionné soit affecté au champ Affecté à .
Entrées de signature
Utilisez les entrées de signature pour capturer des signatures électroniques sur un écran de formulaire d’entrée. Les entrées de signature peuvent être incluses dans des sections ou des pages de l’écran du formulaire d’entrée.
Vous pouvez utiliser l’attribut facultatif IsOverlay avec des entrées de signature. Par défaut, les signatures sont restituées dans la fenêtre modale complète. Lorsque la valeur d’attribut est définie sur vrai, les IsOverlay signatures sont restituées dans une fenêtre de demi-modal.
| Attribut | Description |
|---|---|
| IsOverlay | Définit si l’entrée de signature est ouverte dans une fenêtre de demi-modal. Vous pouvez définir la valeur sur true ou false. La valeur vrai configure l’ouverture de la signature dans une fenêtre de demi-modal. Remarque : Si l’entrée de signature est configurée comme la seule entrée sur une page et que l’attribut isOverlay est défini sur vrai, l’attribut isOverlay est ignoré et l’entrée de signature s’affiche en plein écran. |
Entrées de chaîne
|
Utilisez les entrées de chaîne pour la saisie de texte. Vous pouvez définir une longueur maximale de caractères pour cette entrée. |
Vous pouvez utiliser ces attributs avec des entrées de chaîne.
| Attribut | Description |
|---|---|
| Inline | Option permettant d’afficher l’entrée en ligne ou d’ouvrir l’entrée dans une fenêtre modale distincte. La valeur doit être vrai ou faux. |
| MaxLength | Nombre maximal de caractères pour la valeur entrée. |
| ShowDeleteAll | Option permettant d’afficher un bouton Supprimer chaque fois qu’il y a du texte dans le champ d’entrée. Cette valeur doit être true ou false, et est définie sur false par défaut. |
| ConfirmDeletion | Option permettant d’afficher un message de confirmation à l’utilisateur avant la suppression du texte lors de l’utilisation de ShowDeleteAll. La valeur doit être vrai ou faux, et est définie sur vrai par défaut. |
Entrées d’écran
Utilisez une entrée d’écran pour transformer un écran de liste en entrée de liste sélectionnable. Les utilisateurs peuvent sélectionner plusieurs éléments de liste et effectuer une opération d’écriture différée dans le cache.
Vous pouvez utiliser ces attributs avec les entrées d’écran.
| Attribut | Description |
|---|---|
| ScreenId | Configure l’écran de liste utilisé pour l’entrée de liste sélectionnable. La valeur est le sys_id de l’écran de liste. |
| GetDataFromParent | Transforme un écran de liste d’un écran parent en une entrée de liste sélectionnable. Les filtres appliqués à l’écran de la liste parente sont reportés sur l’entrée d’écran. Entrez vrai pour activer cet attribut. Par défaut, elle est désactivée sur l’instance. |