--- sourceDocument: Yokohama Mobile-Konfiguration und -Navigation sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/mobile Release : - yokohama ft:locale : - de-DE ft:publication_title : - Yokohama Mobile-Konfiguration und -Navigation ft:clusterId : - mobile bundleId : - mobile workflow : - Platform --- # Konfigurieren Sie ein Aktionselement # Konfigurieren Sie ein Aktionselement {#ariaid-title1} * Freigeben Version: Yokohama * * Aktualisiert 30. Januar 2025 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 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](https://servicenow-prod.fluidtopics.net/Cu1N32NC2nv_iTfFKAhexg "Parameter bestimmen die Informationen, die Sie an die Aktion übergeben, um sicherzustellen, dass Sie den richtigen Datensatz ändern und erforderliche Felder nach Bedarf erzwingen. Erstellen Sie ein Aktionselement mit Parametern, um die Änderungen zu definieren, die an einer Aktion vorgenommen werden, und wie die Änderungen vorgenommen werden."). 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 AlleSystem MobileMobile App Builderan. Die Mobile App BuilderWird in einer neuen Browserregisterkarte geöffnet und zeigt den Bildschirm für die Auswahl des Anwendungsbereichs an. 2. Suchen Sie nach dem Anwendungsbereich, in dem Sie arbeiten, und wählen Sie dann den Namen des Anwendungsbereichs aus. Die Mobile App BuilderDer Startbildschirm für 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. {#sg-studio-create-action-item__table_dcb_qzh_2fb__entry__2} | 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: * Neu * Aktualisieren * Löschen * Skript * Mehrstufig. Weitere Informationen finden Sie unter [Konfigurieren Sie Aktionsschritte innerhalb eines Aktionselements](https://servicenow-prod.fluidtopics.net/MPl~M7e9pQh86YUWAJ_V~A "Damit ein Aktionselement mehrere Prozesse ausführen kann, müssen Sie separate Aktionsschritte definieren."). {#sg-studio-create-action-item__ul_w1w_x13_2fb}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. ` Um eine Variable aus einem Parameterbildschirm in Ihren Skripts zu verwenden, verwenden Sie `Parm_variable. ` | | 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](https://servicenow-prod.fluidtopics.net/1juxsquACDLIzFLIKw5EtA "Konfigurieren Sie einen Eingabeparameter, damit Ihre Anwender eine Liste von Datensätzen aus ihrer mobilen App sehen können. Um auf einen Datensatz aus der Liste zuzugreifen, muss ein Anwender nur auf den Datensatznamen tippen."). | [Tabelle : 1. Aktionselementfelder] {#sg-studio-create-action-item__table_dcb_qzh_2fb} 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"));​ 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](https://servicenow-prod.fluidtopics.net/JncKFo_5KSeyxCOiMqlSyQ "Mit Aktionsfunktionen kann der Anwender etwas in der Datenbank ändern. Beispielsweise erfordert das Aktualisieren oder Hinzufügen eines Kommentars zu einem Datensatz eine Aktionsfunktion."). Ordnen Sie Aktionsschritte einem Aktionselement zu, siehe [Konfigurieren Sie Aktionsschritte innerhalb eines Aktionselements](https://servicenow-prod.fluidtopics.net/MPl~M7e9pQh86YUWAJ_V~A "Damit ein Aktionselement mehrere Prozesse ausführen kann, müssen Sie separate Aktionsschritte definieren.").