Konfigurieren Sie ein Aktionselement

  • Freigeben Version: Australia
  • Aktualisiert 12. März 2026
  • 4 Minuten Lesedauer
  • Damit eine Aktionsfunktion funktioniert, müssen Sie ein Aktionselement erstellen, das der Aktionsfunktion zugeordnet werden soll. Aktionselemente definieren, was die Aktionsfunktion ist und wie sie funktioniert.

    Vorbereitungen

    Erstellen Sie vor dem Erstellen eines Aktionselements eine Aktionsfunktion.

    Erforderliche Rolle: Administrator

    Warum und wann dieser Vorgang ausgeführt wird

    Die meisten Aktionselemente verwenden Parameter.

    Verwenden Sie Aktionselemente, um zu definieren, was eine Aktionsfunktion tut, wenn ein Anwender diese Funktion verwendet. Die folgenden Schritte beschreiben die Erstellung einer Aktion ohne Parameter. Informationen zum Erstellen eines parametrisierten Aktionselements finden Sie unter Konfigurieren Sie ein Aktionselement mit Parametern.

    Hinweis:
    ServiceNow Mobile-Apps können keine Aktionen ausführen, die in der webbasierten Oberfläche der Plattform nicht ausgeführt werden können. Wenn Sie beispielsweise ACLs verwenden, um zu verhindern, dass ein Anwender einen Incident schließt, ohne einen Lösungscode und Notizen hinzuzufügen, kann der Anwender einen Incident in der App nicht ohne die gleichen Anforderungen schließen. Beachten Sie dies beim Erstellen von Aktionen, damit Sie die richtigen Parameter hinzufügen können.

    Prozedur

    1. Navigieren zu Alle > System Mobil > Mobile App Builderan.
      Mobile App Builder wird in einer neuen Browserregisterkarte geöffnet und der Auswahlbildschirm für den Anwendungsbereich wird angezeigt.
    2. Suchen Sie nach dem Anwendungsbereich, in dem Sie arbeiten, und wählen Sie dann den Namen des Anwendungsbereichs aus.
      Der Startbildschirm der Mobile App Builder-Kategorien wird angezeigt.
    3. Wählen Sie Aus Funktionen Wählen Sie im Menü aus, und wählen Sie dann aus Neu .
    4. Wählen Sie Aus Neu Im Abschnitt „Aktionselement“ und füllen Sie dann die folgenden Felder nach Bedarf aus.
      Tabelle : 1. Aktionselementfelder
      Feld Beschreibung
      Name Ein Name für das Aktionselement. Sie können mehrere Aktionselemente mit demselben Namen haben. Stellen Sie sicher, dass Sie einen Namen auswählen, der leicht identifiziert werden kann.
      Beschreibung Weitere Informationen zur Identifizierung des Aktionselements.
      Typ Die Art des Aktionselements. Wählen Sie aus Folgendem:Je nach Typ der ausgewählten Aktion werden im Aktionselementformular verschiedene Felder angezeigt.
      Tabelle Die Tabelle, für die das Aktionselement gilt, z. B. Incident.
      Ausführungsskript

      Das von der Aktion ausgeführte Skript. Dieses Feld wird nur angezeigt, wenn Sie auswählen Skript Als Typ. Weitere Informationen finden Sie im Beispiel unten.

      Um eine Eingabe aus einem Parameterbildschirm in Ihren Skripts zu verwenden, verwenden Sie Parm_input.<InputName>

      Um eine Variable aus einem Parameterbildschirm in Ihren Skripts zu verwenden, verwenden Sie Parm_variable.<VariableName>

      Aktuellen Datensatz als Bedingung verwenden Gibt an, ob Sie einen separaten Satz von Abfragebedingungen für das Aktionselement wünschen. Wenn diese Option ausgewählt ist, ist das Feld „Abfragebedingungen“ deaktiviert. Für Aktualisierungs- oder Löschaktionen müssen Sie den Datensatz definieren, den Sie aktualisieren oder löschen, indem Sie eine SYS-ID angeben. Markierung Aktuellen Datensatz als Bedingung verwenden Mit „wahr“ können Sie dies tun, ohne einen Parameter zu erstellen.
      Abfragebedingung Filterbedingungen, die für das Aktionselement gelten.
      Feldwerte festlegen Bestimmen Sie die Feldwerte für eine Aktion. Wenn Sie beispielsweise eine Aktion erstellen möchten, die einen Incident mit dem Status „gelöst“ aktualisiert, verwenden Sie die Feldwerte Status = gelöst. Sie können auch parametrisierte Elemente erstellen, die an den Feldwert übergeben werden sollen.
      Eingabeformular-Bildschirm Wählen Sie einen Eingabeformularbildschirm aus, der für dieses Aktionselement verwendet werden soll. Weitere Informationen finden Sie unter Konfigurieren Sie einen Eingabeformularbildschirm.
    5. Wählen Sie Speichern.

    Beispiel

    Im folgenden Beispiel wird ein Skript verwendet, um dem aktuellen Anwender mithilfe des SMTask-Objekts eine Aufgabe zuzuweisen. Die erste Wenn Die Anweisung überprüft, ob die Eingabe gültig ist wm_Aufgabe Datensatz und beendet das Skript, wenn nicht. Die zweite Wenn Anweisung enthält Code, der die Aufgabe dem aktuellen Anwender zuweist, wenn der Anwender über eine Berechtigung verfügt, wie von festgelegt CanZuweisungsich selbst. Methode. Diese Aktion wurde als Skript und nicht als Update ausgeführt, damit diese Prüfungen einbezogen werden konnten.

    (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);

    Im folgenden Beispiel wird ein Skript verwendet, um nach der Ausführung einer Aktion eine Navigationsabschlussfunktion auszuführen. Eingabetaste ActionResult Als Funktion und dann definieren SetRedirectionInfo(gr.getUniqueValue(), gr.getTableName() Um anzugeben, wohin navigiert werden soll, sobald die Aktion ausgeführt wurde.

    (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);
    Im folgenden Beispiel wird ein Skript verwendet, um zu bestimmen, wo die vom Anwender im Eingabetyp „Anhang“ ausgewählten Anhänge gespeichert werden. Das Skript hängt die ausgewählte Datei an einen bestimmten Incident-Datensatz mit an sys_ID In der Tabelle „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);
    

    Wenn Sie Parameter für das Aktionselement verwenden, können Sie sie im Skript aufrufen. Der Aufruf im Skript muss genau mit dem Parameternamen übereinstimmen. Wenn der Parametername beispielsweise wb_wot_reject_work_note ist, wie im ersten Skript oben, können Sie ihn im Skript aufrufen mit gr.work_Notes = input.wb_wot_reject_work_note; .

    Nächste Maßnahme

    Ordnen Sie das Aktionselement einer Aktionsfunktion zu, siehe Aktionsfunktion .

    Ordnen Sie Aktionsschritte einem Aktionselement zu, siehe Konfigurieren Sie Aktionsschritte innerhalb eines Aktionselements.