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 du 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 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 scannages uniques, des scannages multiples ou des scans groupés. Les scans uniques permettent à l’utilisateur de scanner une seule fois. Dans ce cas, l’utilisateur doit scanner à nouveau en appuyant sur l’icône de scannage, ce qui efface la valeur de scan. Vous n’avez pas besoin de configurer un attribut pour une entrée de code-barres de scannage unique.
- Il est possible de configurer des entrées de scannage multiples 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 scanner rapidement plusieurs codes-barres à la suite sans quitter l’interface de scannage.
- 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 d’entrée qui comporte uniquement des entrées de code-barres. Ensuite, l’attribut de 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 la configuration de scannage multiple et de plusieurs groupes de codes-barres. Définit le nombre maximal de codes-barres qu’un utilisateur peut scanner simultanément. 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 à scannage 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 du formulaire d’entrée avec des entrées de code-barres, reportez-vous aux sections Configurer des écrans de formulaire d’entrée avec des entrées de codes-barres à scannage unique et multiple et Configurer des écrans de formulaire d’entrée avec des entrées de codes-barres de scannage groupé.
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 dans 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 dans 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 permettent le tri et le filtrage de l’entrée de carte personnalisée. Important : Les entrées de carte personnalisée qui prennent en charge les éléments de données définis par un paramètre 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 | 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 | 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 être utilisé avec aucun autre attribut d’entrée de carte personnalisée. Si vous utilisez l’attribut ScreenId avec une entrée de carte personnalisée, n’utilisez aucun autre attribut 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’elle est définie sur vrai, le client Mobile envoie les informations sur le fuseau horaire de l’appareil, ainsi que la date et la valeur 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 de date/heure. Ce comportement est utilisé par défaut. Les valeurs d’entrée de date/d’heure sont au format suivant : AAAA-MM-JJ hh :mm :ss Pour en savoir plus sur la configuration de l’attribut IncludeTimezone des entrées de date/d’heure pour différents types d’actions, reportez-vous à la section Configuration de l’entrée de date/d’heure pour différents types d’éléments d’action. Pour plus d’informations sur les types d’éléments d’action, reportez-vous à 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 date/heure est ajoutée. Cet attribut prend en charge les valeurs entières positives et négatives. Définir MaxRangeDays sur 0 empêche les utilisateurs de sélectionner des dates futures et les restreint 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. Définir sur 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 s’il est possible de sélectionner les heures futures lorsqu’une entrée de date/heure est ajoutée. Cet attribut prend en charge les valeurs entières positives et négatives. Définir sur MaxRangeHours0 empêche les utilisateurs de sélectionner des dates/heures futures et les restreint aux dates/heures actuelles ou passées. Remarque : MaxRangeHours peut être utilisé avec MaxRangeDays, MinRangeDays, et MinRangeHours. |
| MinRangeHours | Attribut facultatif qui détermine s’il est possible de sélectionner les heures passées lorsqu’une entrée de date/heure est ajoutée. Cet attribut prend en charge les valeurs entières positives et négatives. Définir MinRangeHours sur 0 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 | 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 true ou false. |
| MobileViewId | ID de la 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 obtenir des détails 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 sur 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 du 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 affichées dans la fenêtre modale complète. Lorsque la valeur de l’attribut IsOverlay est définie sur true, les 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. La valeur true configure l’ouverture de la signature dans une fenêtre demi-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 plus d’informations sur la création d’un écran du formulaire d’entrée avec des entrées de signature, reportez-vous à Configurer des é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 par défaut sur false . |
| 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, elle est désactivée sur l’instance. |