Configurer un élément d’action

Pour qu’une fonction d’action fonctionne, vous devez créer un élément d’action à associer à la fonction d’action. Les éléments d’action définissent la fonction d’action et son fonctionnement.

Avant de commencer

Avant de créer un élément d’action, créez une fonction d’action.

Rôle requis : admin

Pourquoi et quand exécuter cette tâche

La plupart des éléments d’action utilisent des paramètres.

Utilisez des éléments d’action pour définir ce que fait une fonction d’action lorsqu’un utilisateur utilise cette fonction. Les étapes suivantes détaillent la création d’une action sans paramètres. Pour créer un élément d’action paramétré, reportez-vous à .Configurer un élément d’action avec des paramètres

Remarque :

Les applications mobiles ServiceNow ne peuvent effectuer aucune action qui ne peut pas être effectuée dans l’interface Web de la plateforme. Par exemple, si vous utilisez des ACL pour empêcher un utilisateur de fermer un incident sans ajouter de code de résolution et de notes, l’utilisateur ne peut pas fermer un incident dans l’application sans les mêmes exigences. Gardez cela à l’esprit lors de la création d’actions afin de pouvoir ajouter les paramètres corrects.

Procédure

1. Accédez à la Tous > Mobile système > Générateur d'application mobile.
   Il s’ouvre Générateur d'apps mobiles dans un nouvel onglet de navigateur et affiche l’écran de sélection du périmètre de l’application.
2. Recherchez le périmètre de l’application dans lequel vous travaillez, puis sélectionnez son nom.
   L'écran d'accueil des catégories Générateur d'apps mobiles s'affiche.
3. Sélectionnez Fonctions dans le menu, puis sélectionnez Nouveau.
4. Sélectionnez Nouveau dans la section Élément d’action, puis renseignez les champs suivants selon vos besoins.

   Tableau 1. Champs des éléments d’action

   Champ	Description
   Nom	Nom attribué à l’élément d’action. Vous pouvez avoir plusieurs éléments d’action portant le même nom. Assurez-vous de choisir un nom facilement identifiable.
   Description	Plus d’informations pour vous aider à identifier l’élément d’action.
   Type	Type d’élément d’action. Vous pouvez choisir entre : Nouveau Mettre à jour Supprimer Script MultiStep. Pour plus d'informations, consultez Configurer les étapes d’action dans un élément d’action. Différents champs apparaissent sur le formulaire d’élément d’action en fonction du type d’action que vous sélectionnez.
   Table	La table à laquelle l’élément d’action s’applique, par exemple, Incident.
   Script d’exécution	Script exécuté par l’action. Ce champ s’affiche uniquement si vous sélectionnez Script comme type. Pour plus d’informations, consultez l’exemple ci-dessous. Pour utiliser une entrée provenant d’un écran de paramètres dans vos scripts, utilisez parm_input.<InputName> Pour utiliser une variable provenant d’un écran de paramètres dans vos scripts, utilisez parm_variable.<VariableName>
   Utiliser l'enregistrement en cours en tant que condition	Indique si vous souhaitez un ensemble distinct de conditions de requête pour l’élément d’action. Si cette option est sélectionnée, le champ Query conditions (Conditions de la requête) est désactivé. Pour les actions de mise à jour ou de suppression, vous devez définir l’enregistrement que vous mettez à jour ou supprimez à l’aide d’un ID système. Le marquage de l’option Utiliser l’enregistrement en cours comme condition sur vrai vous permet de le faire sans créer de paramètre.
   Condition de la requête	Conditions de filtre qui s’appliquent à l’élément d’action.
   Définir des valeurs de champ	Déterminez les valeurs de champ d’une action. Par exemple, si vous souhaitez créer une action qui met à jour un incident avec l’état Résolu, utilisez les valeurs de champ État = Résolu. Vous pouvez également créer des éléments paramétrés à transmettre dans la valeur du champ.
   Écran du formulaire d'entrée	Sélectionnez un écran de formulaire d’entrée à utiliser pour cet élément d’action. Consultez Configurer un écran de formulaire d’entrée.

5. Sélectionnez Enregistrer.

Exemple

L’exemple suivant utilise un script pour affecter une tâche à l’utilisateur actuel, à l’aide de l’objet SMTask. La première instruction if vérifie que l’entrée est un enregistrement wm_task valide et met fin au script si ce n’est pas le cas. La deuxième instruction if contient du code qui affecte la tâche à l’utilisateur actuel, si celui-ci en a l’autorisation, telle que déterminée par la méthode canAssignToSelf . Cette action a été effectuée sous forme de script plutôt que de mise à jour afin que ces vérifications puissent être incluses.

(function WriteBackAction(parm_input, parm_variable) {
	var smTask = new global.SMTask();
       var work_order_task_id = parm_variable['sys_id'];
	var wotGR = new GlideRecord("wm_task");
	if (!wotGR.get(work_order_task_id)) {
		gs.error("wot_assign_to_me write-back action - failed to find work order task");
		gs.addErrorMessage(gs.getMessage("Task assignment failed."));
		return;
	}
	
	if (smTask.canAssignToSelf(wotGR))
		smTask.assignToMe(gs.getUserID(), work_order_task_id);
	else
		gs.addErrorMessage(gs.getMessage("Not a valid task assignment."));
})(parm_input, parm_variable);

L’exemple suivant utilise un script pour exécuter une fonctionnalité de complétion de navigation après l’exécution d’une action. Entrez actionResult en tant que fonction, puis définissez setRedirectionInfo(gr.getUniqueValue(), gr.getTableName() pour spécifier où naviguer, une fois l’action effectuée.

(function WriteBackAction(parm_input, parm_variable, actionResult) {​
            var gr = new GlideRecord('incident');​
            gr.get(parm_variable['sys_id']);​
            gr.short_description = 'Updated by Scripted Action';​
            gs.addInfoMessage(gs.getMessage("This is the First success message"));​
            gs.addInfoMessage(gs.getMessage("This is the Second success message"));​
            gs.addInfoMessage(gs.getMessage("This is the Third success message"));​
            gs.addInfoMessage(gs.getMessage("This is the Forth success message"));​
            gr.update();​
        actionResult.setRedirectionInfo(gr.getUniqueValue(), gr.getTableName());         ​
})(parm_input, parm_variable, actionResult);

L’exemple suivant utilise un script pour déterminer où sont stockées les pièces jointes sélectionnées par l’utilisateur dans le type d’entrée de pièce jointe. Le script joint le fichier sélectionné à un enregistrement d’incident spécifique avec le sys_id dans la table Incident [incident].

(function WriteBackAction(parm_input, parm_variable, actionResult) { 
var targetTableName = "incident";
var targetTableRecordSysId = "37aa099533b352102ed2923fad5c7b09";
var inputName = "input2"; // input2 stands for the input's name. The input type must be "Attachment" 
actionResult.addAttachment(inputName, targetTableName, targetTableRecordSysId);
})(parm_input, parm_variable, actionResult);

Si vous utilisez des paramètres pour l’élément d’action, vous pouvez les appeler dans le script. L’appel dans le script doit correspondre exactement au nom du paramètre. Par exemple, si le nom du paramètre est wb_wot_reject_work_note, comme dans le premier script ci-dessus, vous pouvez l’appeler dans le script en utilisant gr.work_notes = input.wb_wot_reject_work_note ;.

Que faire ensuite

Associez l’élément d’action à une fonction d’action, voir Fonction d’action.

Associez des étapes d’action à un élément d’action, reportez-vous à la section Configurer les étapes d’action dans un élément d’action.