Erstellen Sie eine UI Action

Sie können eine neue UI-Aktion erstellen oder eine vorhandene bearbeiten.

Vorbereitungen

Erforderliche Rolle: ui_action_admin or admin

Warum und wann dieser Vorgang ausgeführt wird

Sie können UI-Aktionen zu Tabellen und Datenbankansichten hinzufügen, die sich im selben Bereich wie die UI-Aktion befinden, sowie zu Tabellen, für die UI-Aktionen aus einem anderen Anwendungsbereich ausgeführt werden können.

Prozedur

1. Navigieren zu Alle > Systemdefinition > UI-Aktionen.
2. Klicken Sie auf Neu oder öffnen Sie einen vorhandenen Datensatz.
3. Definieren Sie die UI-Aktion, indem Sie die Felder ausfüllen.
   Möglicherweise müssen Sie das Formular konfigurieren, damit alle Felder angezeigt werden.

   Tabelle : 1. UI-Aktionsfelder

   Feld	Beschreibung
   Name	Der Text, der auf der Schaltfläche, dem Link oder dem Kontextmenüelement angezeigt wird.
   Tabelle	Die Tabelle, in der die UI-Aktion verfügbar ist. Standardmäßig wird die UI Action auch in Tabellen angezeigt, die die ausgewählte Tabelle erweitern (z. B. werden Aufgabenaktionen in der Incident-Tabelle angezeigt). Wählen Sie Global aus, um die Aktion für alle Tabellen verfügbar zu machen.
   Reihenfolge	Die Reihenfolge, in der die UI-Aktion angezeigt wird. Die Reihenfolge gilt für Schaltflächen von links nach rechts und für Menüaktionen von oben nach unten.
   Aktionsname	Ein eindeutiger Name, der beim Verweisen auf die UI-Aktion in Skripts verwendet wird.
   Aktiv	Eine Option zum Aktivieren der UI-Aktion, wenn ausgewählt. Um eine UI-Aktion zu deaktivieren, deaktivieren Sie das Kontrollkästchen.
   Beim Einfügen anzeigen	Eine Option zum Anzeigen einer Schaltfläche für neue Datensätze, die noch nicht eingefügt wurden
   Bei Update anzeigen	Eine Option zum Anzeigen einer Schaltfläche für vorhandene Datensätze
   Client	Eine Option für die UI-Aktion zum Ausführen des Skripts im Browser des Anwenders und nicht auf dem Server. Wenn diese Option aktiviert ist, wird das Feld Beim Klicken über dem Feld Bedingung angezeigt.
   Formularschaltfläche	Eine Option zum Platzieren einer Schaltfläche auf einem Formular.
   Formular-Kontextmenü	Eine Option, um ein Element in ein Formularkontextmenü zu setzen (Rechtsklick auf Formularheader).
   Formular-Link	Eine Option zum Platzieren eines Links im Abschnitt „Zugehörige Links“ eines Formulars.
   Formularformat	Primär: Färbt die UI-Aktion blau. Destruktiv – Färbt die UI-Aktion rot. Unformatiert: Färbt die UI-Aktion nicht ein.
   Listen-Kopfzeile Schaltfläche	Eine Option zum Platzieren einer Schaltfläche im Banner einer Liste. Hinweis: Listenbanner-Schaltflächen unterstützen keine datensatzspezifischen Bedingungen. Daher wird nur die erste Zeile berücksichtigt, wenn die Bedingung ausgewertet wird, um zu bestimmen, ob die Schaltfläche für die Liste angezeigt wird. Verwenden Sie keine datensatzspezifischen Bedingungen (z. B. current.getValue('state') === 'closed') in UI-Aktionen für Listenbanner-Schaltflächen.
   Unterste Listen-Schaltfläche	Eine Option, um eine Schaltfläche am Ende einer Liste zu platzieren. Hinweis: Die unteren Listenschaltflächen werden unabhängig von der Bedingung angezeigt und bei der Ausführung pro Datensatz ausgewertet.
   Listen-Kontextmenü	Eine Option, um ein Element in ein Listenfeld-Kontextmenü zu setzen (Rechtsklick auf eine Zelle in einer Liste).
   Listenauswahl	Eine Option zum Platzieren eines Elements in der Aktionsauswahlliste am Ende einer Liste. Hinweis: Die unteren Listenschaltflächen werden wie Listenauswahlaktionen unabhängig von der Bedingung angezeigt und bei Ausführung pro Datensatz ausgewertet.
   Listen-Link	Eine Option zum Platzieren eines Links im Abschnitt „Zugehörige Links“ am Ende einer Liste.
   Listenformat	Primär: Färbt die UI-Aktion blau. Destruktiv – Färbt die UI-Aktion rot. Unformatiert: Färbt die UI-Aktion nicht ein.
   Überschreibungen	Eine UI-Aktion, die von dieser UI-Aktion überschrieben wird.
   Nachrichten	Textzeichenfolgen, die die UI-Aktion als Schlüssel verwenden kann, um in der Tabelle „Nachricht“ [sys_ui_message] nach einer lokalisierten Nachrichtenalternative zu suchen. Jeder Nachrichtenschlüssel befindet sich in einer separaten Zeile im Feld Nachrichten. Die Instanz sucht jedes Mal nach einer lokalisierten Nachrichtenzeichenfolge, wenn die UI-Aktion einen getMessage(msg)-Aufruf durchführt, wobei die Nachrichtenzeichenfolge mit einem Schlüssel im Feld Nachrichten übereinstimmt.
   Kommentare	Beschreibender Inhalt zu dieser UI-Aktion.
   Tipp	Der Text, der angezeigt wird, wenn ein Anwender auf das UI-Aktionssteuerelement zeigt.
   Beim Klicken	Der Name der JavaScript-Funktion, die ausgeführt werden soll, wenn die UI-Aktion ausgeführt wird. Die Funktion wird im Feld Skript definiert.
   Bedingung	Eine bedingte JavaScript-Anweisung, die einschränkt, wann eine UI-Aktion angezeigt wird. Bedingungen werden immer auf einem Server ausgeführt. Hinweis: Das aktuelle Objekt ist nicht für Bedingungen in einem Listenkontextmenü verfügbar. Wenn die Kontextmenüoption Liste ausgewählt ist, wird jede Verwendung von current für diese Aktionen ignoriert. Sie können den übergeordneten Datensatz für die UI-Aktionsbedingungen auf einer Schaltfläche einer zugehörigen Liste referenzieren. Um beispielsweise die Schaltflächen Neu und Bearbeiten in der zugehörigen Liste „Betroffene CIs“ für geschlossene Changes zu deaktivieren, kopieren Sie die globalen m2m-UI-Aktionen in die Tabelle task_ci, und fügen Sie die Bedingung parent.activehinzu. Wenn Sie eines der in der Bedingungsanweisung angegebenen Felder leer lassen, wird diese Bedingung standardmäßig auf truegesetzt.
   Skript	Das auszuführende Skript, wenn die UI-Aktion ausgeführt wird. Funktionsnamen müssen eindeutig sein.
   Arbeitsbereich
   Arbeitsbereich-Formularschaltfläche	Eine Option, um die UI-Aktion in der Liste der UI-Aktionen in einem Arbeitsbereich anzuzeigen.
   Arbeitsbereich-Formularmenü	Eine Option, um die UI-Aktion als Listenelement in dem Menü anzuzeigen, das UI-Aktionen in einem Arbeitsbereich zugeordnet ist.
   Format für konfigurierbaren Arbeitsbereich	Eine Option zur Verwendung der UI-Aktion in einem konfigurierbaren Arbeitsbereich. Wenn diese Option deaktiviert ist, gilt die UI-Aktion in Legacy-Arbeitsbereichen.
   Arbeitsbereich-Client-Skript	Ein Skript, das ausgeführt werden soll, wenn die UI-Aktion in Arbeitsbereichen ausgeführt wird.
   Erfordert Rolle
   Rolle	Die für die Anwendung der UI-Aktion erforderlichen Rollen. Anwender müssen mindestens eine der Rollen aufweisen, damit die UI-Aktion angewendet werden kann.
   Zugehörige Listen in der Formularansicht
   UI-Aktion Sichtbarkeit	Die Ansichten des Formulars, für das die UI-Aktion gilt. Verwenden Sie diese Option, um die UI-Aktion auf Formularansichten zu beschränken, die Sie angeben. Eine UI-Aktion ist für die angegebene Ansicht gemäß den folgenden Regeln verfügbar: Wenn keine Sichtbarkeitsregeln vorhanden sind, wird die Aktion in allen Ansichten angezeigt. Eine Ausschlussregel in einer bestimmten Ansicht bedeutet, dass die Aktion in dieser Ansicht nicht angezeigt wird. Wenn mindestens eine Einschlussregel vorhanden ist, wird die Aktion nur in Ansichten angezeigt, die ausdrücklich eingeschlossen sind.
   Versionen	Alle Versionen der UI-Aktion. Verwenden Sie diese Liste, um Versionen zu vergleichen oder eine vorherige Version wiederherzustellen.

4. Klicken Sie auf Absenden oder Aktualisieren.
   Hinweis:

   Wenn die Ausführung der UI-Aktion auf Client-Seite aktiviert ist, umschließen Sie sie mit einer Funktion. Andernfalls wird der Inhalt des Felds Skript beim Laden der Seite ausgeführt.

Beispiel

Als Teil eines UI-Aktionsskripts können Sie einen Benutzer zu einer URL umleiten. Sie können beispielsweise einem Formular Links hinzufügen oder einen neuen Datensatz öffnen, nachdem er aus einer UI-Aktion erstellt wurde. Um einen Anwender von einer UI-Aktion zu einer URL umzuleiten, verwenden Sie diese Syntax im Feld Skript, um den Umleitungslink zu definieren:

action.setRedirectURL ( 'http://www.mysite.com/mypage.htm' );

Um einen Anwender zu einem Datensatz zu leiten, verwenden Sie diese Syntax, wobei new_record der Variablenname für GlideRecordist:

action.setRedirectURL (new_record );