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. |
| 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è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);
- Restreindre les sources de 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 téléphonique 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 sources suivantes : caméra, fichiers ou galerie, dans le champ Valeur . Remarque :Pour éviter que les images et les fichiers ne soient obtenus à partir de plusieurs sources, ajoutez des attributs supplémentaires HiddenAttachmentSources après avoir enregistré l’attribut que vous configurez actuellement.
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 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 d’analyser une seule fois. 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 numérisation.
- Les entrées multi-balayages 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 lecture.
- Les analyses groupées peuvent être configurées pour analyser 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 a uniquement des entrées de code-barres. Ensuite, l’attribut MaxEntries section 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 des lecteurs multiples 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 de scanner à nouveau 5 fois. Remarque : Utilisez cet attribut pour les entrées de codes-barres à balayage multiple uniquement. Si votre entrée de code-barres est destinée à des numérisations 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 code-barres, consultez 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 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. 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’un jeton dans une catégorie est marquée par un signe + sur les jetons. Définissez le nombre de jetons à afficher, ce qui permet à l’utilisateur de voir toutes les options disponibles sur un seul écran de formulaire de saisie. Si le nombre défini de jetons à afficher dépasse la quantité définie, 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 true ou false. Les options à sélection multiple sont indiquées par un signe « + » sur la puce. |
| 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 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 se trouve sur le même écran, ce qui évite d’avoir à 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 l’endroit 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. |
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ées qui prennent en charge les éléments de données paramétrés doivent uniquement utiliser 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 être utilisé avec aucun 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/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 sur le fuseau horaire de l’appareil ainsi que la date et la valeur 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 : JJ-MM-AAAA 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é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 date/heure est ajoutée. Cet attribut prend en charge les valeurs de nombres 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 les dates passées peuvent être sélectionnées lorsqu’une entrée date/heure est ajoutée. Cet attribut prend en charge les valeurs de nombres entiers positifs et négatifs. 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 de nombres 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 et heures actuelles ou passées. Remarque :
MaxRangeHours peut être utilisé avec MaxRangeDays, MinRangeDays, et MinRangeHours. |
| MinRangeHours |
Attribut facultatif qui détermine si les dernières heures peuvent être sélectionnées lorsqu’une entrée de date/heure est ajoutée. Cet attribut prend en charge les valeurs de nombres 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. |
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. 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 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 faux 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 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 le classement des entrées autre 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 voulez 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 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 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ête 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 les entrées de signature pour capturer les signatures électroniques sur un écran de formulaire d’entrée. Les entrées de signature peuvent être incluses sur les sections ou les 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 d’attribut est définie sur vrai, les IsOverlay signatures sont restituées dans une fenêtre demi-modale.
| Attribut | Description |
|---|---|
| IsOverlay | Définit si l’entrée de signature est ouverte dans une fenêtre demi-modale. Vous pouvez définir la valeur sur true ou false. La valeur vrai configure la signature à ouvrir dans une demi-fenêtre modale. Remarque : Si l’entrée de signature est configurée comme la seule entrée d’une page et que l’attribut isOverlay est défini sur true, l’attribut isOverlay est ignoré et l’entrée de signature s’affiche en plein écran. |
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 la suppression du texte lors de l’utilisation ShowDeleteAllde . 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 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. |