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 ce qu’est la fonction d’action et son fonctionnement.
Avant de commencer
Rôle requis : admin
Pourquoi et quand exécuter cette tâche
Utilisez des éléments d'action pour définir ce qu'une fonction d'action fait 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é, voir Configurer un élément d'action avec des paramètres.
Procédure
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 si vérifie si l’entrée est un enregistrement wm_task valide et termine le script si elle ne l’est pas. La deuxième instruction si contient du code qui affecte la tâche à l’utilisateur actuel, si l’utilisateur est autorisé, tel que déterminé par la méthode canAssignToSelf. Cette action a été exécutée en tant que script plutôt qu’en tant que mise à jour afin que ces contrôles puissent être inclus.
(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 effectuer une fonctionnalité d'achèvement de navigation après l'exécution d'une action. Entrez actionResult comme 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);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
Pour associer l'élément d'action à une fonction d'action, consultez fonction d'action.
Pour associer des étapes d'action à un élément d'action, consultez Configurer des étapes d'action dans un élément d'action.