Attributs d'écran du formulaire d'entrée pour les entrées
Différents types d'entrées sont disponibles pour une utilisation dans les écrans du formulaire d'entrée, et vous pouvez utiliser différents attributs pour configurer les entrées.
Utilisez des attributs d'entrée pour définir l'apparence et spécifier des limites pour vos entrées. Il peut s'agir, par exemple, de spécifier des valeurs minimale et maximale ou d'afficher une valeur d'entrée sous la forme d'un 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. |
Entrées de pièces jointes
Utilisez les entrées de pièces jointes pour permettre aux utilisateurs de joindre des fichiers à un écran du formulaire d'entrée. Les entrées de pièces jointes nécessitent un élément d'action scripté et un objet actionResult pour charger un fichier. Remarque : les entrées de pièces jointes sont uniquement prises en charge 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);
Entrées de codes-barres
Utilisez les entrées de codes-barres pour scanner un ou plusieurs codes-barres. Les codes-barres sont des codes lisibles par machine sous la 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 entrer 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 numérisations uniques, des numérisations multiples ou des numérisations groupées. Les analyses uniques permettent à l’utilisateur de numériser une seule fois. Dans ce cas, l’utilisateur doit scanner à 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 entrée de code-barres à balayage unique.
- Les entrées d’analyse multiple peuvent être configurées avec l’attribut MaxEntries . Si l’entrée du code-barres de l’écran du formulaire d’entrée est configurée avec l’attribut MaxEntries , les utilisateurs peuvent rapidement scanner plusieurs codes-barres de manière séquentielle sans quitter l’interface de lecture.
- Les scans groupés peuvent être configurés pour scanner 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 de saisie qui comporte uniquement des entrées de codes-barres. Ensuite, l’attribut de section MaxEntries doit être configuré pour la section de codes-barres groupée afin que les utilisateurs puissent scanner plusieurs groupes de codes-barres.
| Attribut | Description |
|---|---|
| MaxEntries | Utilisé uniquement pour configurer la numérisation multiple 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 à lecture multiple. Si votre saisie 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 de saisie avec des entrées de codes-barres, reportez-vous aux sections Configurer les écrans du formulaire d’entrée avec des entrées de codes-barres à un ou plusieurs scans et Configurer les écrans du formulaire d’entrée avec des entrées de codes-barres de numérisation groupées.
Entrées booléennes
Utilisez des entrées booléennes pour les entrées avec des valeurs true ou false. Vous pouvez configurer des entrées booléennes pour qu'elles s'affichent sous la forme de cases à cocher ou de commutateurs. |
 |
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 différentes options de sélection. Vous pouvez créer ces choix manuellement ou utiliser une table et un champ existants pour proposer les choix. Les entrées de choix peuvent s'afficher sous forme de textes ou d'images. Vous pouvez configurer une entrée de choix pour permettre aux utilisateurs de sélectionner un seul ou plusieurs choix. |
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 true ou false. |
| Table | La table dans laquelle se trouve le champ de choix. Remarque : utilisez cette option pour vous servir des choix d'une table et d'un champ existants plutôt que de créer manuellement des choix. Vous devez sélectionner un champ de cette table à l’aide de l’attribut Field . |
| Field | Le champ qui contient vos choix. Remarque : utilisez cette option pour vous servir des choix d'une table et d'un champ existants plutôt que de créer manuellement des choix. Le champ défini dans cet attribut doit se trouver sur la table définie dans l’attribut Table . |
| RenderType | Option permettant d’afficher les options de choix sous forme d’image pour l’entrée de choix. La valeur doit être image. |
Entrées de carte personnalisée
Utilisez des entrées de carte personnalisée pour ajouter un lien à une carte intérieure dans votre application Mobile. Les utilisateurs peuvent utiliser ces cartes pour obtenir des itinéraires vers des ressources telles que des bureaux, des salles de réunion ou des casiers ainsi que pour les réserver. Les administrateurs peuvent également configurer un élément de données paramétré avec des conditions de requête qui activent 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 ne doivent utiliser que l’attribut ScreenId . N’utilisez aucun autre type d’attribut pour les entrées de carte personnalisées 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 | Le sys_id de la table sys_sg_custom_map_config. |
| CustomMapDefaultProviderId | Le sys_id de l'enregistrement du fournisseur dans la table sys_sg_custom_map_provider. |
| CustomMapInputs | Le sys_id de l'étage dans la table sys_sg_input. Cette valeur doit être saisie en tant que tableau JSON. |
| ScreenId | Le 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 d’autres attributs d’entrée de carte personnalisée. 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/d'heure
Utilisez les entrées de date/d'heure pour permettre à vos utilisateurs d'entrer des valeurs de date et d'heure. Vous pouvez configurer l'entrée pour autoriser la date et l'heure, ou seulement la date. |
 |
Vous pouvez utiliser ces attributs avec des entrées de date/d'heure.
| Attribut | Description |
|---|---|
| RenderType | Spécifiez un type de rendu pour l'entrée de date/heure.
|
| IncludeTimezone | Fuseau horaire de l'équipement mobile sur lequel l'entrée est ajoutée. La valeur doit être true ou false. Lorsqu’il est défini sur vrai, le client mobile envoie les informations de fuseau horaire de l’appareil ainsi que la valeur de date et d’heure à l’instance principale au format suivant : AAAA-MM-JJThh :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 de fuseau horaire de l’appareil dans les valeurs d’entrée date/heure. Il s’agit du comportement par défaut. Les valeurs saisies de 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éments d’action. Pour en savoir plus sur les types d’éléments 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 entières positives et négatives. 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 entières positives et négatives. La valeur MinRangeDays0 empêche les utilisateurs de sélectionner des dates passées et les limite 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 entières positives et négatives. La définition MaxRangeHours sur 0 empêche les utilisateurs de sélectionner des dates/heures futures et les limite aux dates/heures 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 entières positives et négatives. La valeur MinRangeHours0 empêche les utilisateurs de sélectionner des dates/heures passées et les restreint aux dates/heures actuelles ou futures. Remarque : MinRangeHours peut être utilisé avec MaxRangeDays, MinRangeDays, et MaxRangeHours. |
Entrées numériques
Utilisez les entrées numériques pour permettre à vos utilisateurs de saisir des valeurs numériques. Définissez des valeurs minimum et maximum facultatives pour spécifier une plage de nombres pour votre entrée. Vous pouvez éventuellement configurer une entrée numérique pour qu'elle s'affiche sous forme de pourcentage. Par défaut, les entrées numériques prennent en charge les décimales. |
 |
Vous pouvez utiliser ces attributs avec des entrées numériques.
| Attribut | Description |
|---|---|
| RenderType | Spécifiez un type de rendu pour l’entrée numérique.
|
| Max | Spécifiez une valeur maximale pour l’entrée. |
| Min | Spécifiez une valeur minimale pour l’entrée. |
Entrées de classements
Utilisez des entrées de classements pour permettre à vos utilisateurs de trier les choix disponibles par ordre de préférence ou de priorité. Les utilisateurs appuient sur les choix disponibles et les font glisser. Les choix pour l'entrée de classement doivent être définis manuellement. |
Il n’existe aucun attribut pour les entrées de classement autres que les attributs généraux répertoriés dans cette rubrique.
Entrées de références
Utilisez des entrées de références 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 des recherches par mots clés « pour du 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 | Le nom de champ du champ référencé dans la table source. |
| TargetTable | 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 true ou false. |
| MobileViewId | ID de vue mobile (configuration de 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 true ou false. |
| 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êtes codées. |
| SearchType | Définit la requête utilisée pour la recherche. La valeur peut être starts_with ou contains. 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 de l'écran du formulaire d'entrée pour le champ Affecté à dans la table Incident [incident]. Pour créer cette entrée, utilisez les trois attributs requis : TargetTable, SourceTable et SourceFieldName.
- Vos utilisateurs effectuent leur sélection à partir d'une liste d'utilisateurs à qui affecter l'incident. Ainsi, vous définissez 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 l'attribut SourceFieldName sur assigned_to de sorte que l'utilisateur sélectionné soit affecté au champ Affecté à.
Entrées de signature
Utilisez des 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 les sections ou les pages de l’écran du formulaire de saisie.
Vous pouvez utiliser l’attribut facultatif IsOverlay avec des entrées de signature. Par défaut, les signatures sont affichées dans la fenêtre modale complète. Lorsque la valeur de l’attribut est définie sur vrai, les IsOverlay signatures sont affichées dans une demi-fenêtre modale.
| Attribut | Description |
|---|---|
| IsOverlay | Définit si l’entrée de signature est ouverte dans une demi-fenêtre modale. Vous pouvez définir la valeur sur vrai ou faux. Une valeur définie sur true configure la signature à ouvrir dans une demi-fenêtre modale. Remarque : Si l’entrée de signature est configurée comme 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. |
Pour en savoir plus sur la création d’un écran de formulaire de saisie avec des entrées de signature, reportez-vous à la section Configurer les écrans du formulaire d’entrée avec des entrées de signature.
Entrées de chaînes
Utilisez des entrées de chaînes pour les entrées de textes. Vous pouvez définir une longueur de caractères maximum pour cette entrée. |
 |
Vous pouvez utiliser ces attributs avec des entrées de chaîne.
| Attribut | Description |
|---|---|
| Inline | Option permettant d'afficher l'inline d'entrée ou d'ouvrir l'entrée dans un modal distinct. La valeur doit être true ou false. |
| MaxLength | Nombre maximal de caractères pour la valeur d'entrée. |
| ShowDeleteAll | Option permettant d’afficher un bouton de suppression chaque fois qu’il y a du texte dans le champ de saisie. Cette valeur doit être true ou false et est définie sur false par défaut. |
| ConfirmDeletion | Option permettant d’afficher à l’utilisateur un message de confirmation avant que le texte ne soit supprimé lors de l’utilisation de .ShowDeleteAll La valeur doit être true ou false et est définie sur true 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 des éléments de liste multiples et effectuer une opération d'écriture différée dans le cache.
Vous pouvez utiliser ces attributs avec des entrées d'écran.
| Attribut | Description |
|---|---|
| ScreenId | Configure l'écran de liste utilisé pour l'entrée de liste sélectionnable. La valeur correspond au sys_id de l'écran de liste. |
| GetDataFromParent | Fait d'un écran de liste d'un écran parent l'entrée de liste sélectionnable. Les filtres appliqués à l'écran de liste parent sont reportés sur l'entrée de l'écran. Saisissez true pour activer cet attribut. Par défaut, cette option est désactivée sur l’instance. |