Erstellen Sie eine UI Action

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 5 Minuten Lesedauer

    • 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 Umfang wie die UI-Aktion befinden, und Tabellen, die die Ausführung von UI-Aktionen aus einem anderen Anwendungsbereich zulassen.

    Prozedur

    1. Navigieren zu Alle > Systemdefinition > UI-Aktionenan.
    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, um alle Felder anzuzeigen.
      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, für die die UI-Aktion verfügbar ist. Standardmäßig wird die UI-Aktion auch in Tabellen angezeigt, die die ausgewählte Tabelle erweitern (z. B. werden Aufgabenaktionen in der Incident-Tabelle angezeigt).

      Wählen Sie Aus Global 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 verwendet werden soll, wenn in Skripts auf die UI-Aktion verwiesen 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 nicht eingefügt wurden.
      Bei Update anzeigen Eine Option zum Anzeigen einer Schaltfläche in vorhandenen Datensätzen.
      Client Eine Option für die UI-Aktion zum Ausführen des Skripts im Browser des Anwenders, nicht auf dem Server. Wenn diese Option aktiviert ist, wird Beim Klicken Das Feld wird über dem Bedingungsfeld angezeigt.
      Formularschaltfläche Eine Option zum Einfügen einer Schaltfläche in ein Formular.
      Formular-Kontextmenü Eine Option zum Einfügen eines Elements in ein Formularkontextmenü (Rechtsklick auf den Formularheader).
      Formular-Link Eine Option zum Einfügen 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.
      • Nicht formatiert: Färbt die UI-Aktion nicht.
      Listen-Kopfzeile Schaltfläche Eine Option zum Platzieren einer Schaltfläche im Banner einer Liste.
      Hinweis:
      Listenbanner-Schaltflächen sollen keine datensatzspezifischen Bedingungen unterstützen, 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 der Listenbanner-Schaltfläche.
      Unterste Listen-Schaltfläche Eine Option zum Platzieren einer Schaltfläche am Ende einer Liste.
      Hinweis:
      Die unteren Listenschaltflächen werden unabhängig von der Bedingung angezeigt und pro Datensatz bei der Ausführung ausgewertet.
      Listen-Kontextmenü Eine Option zum Einfügen eines Elements in ein Listenfeld-Kontextmenü (Rechtsklick auf eine Zelle in einer Liste).
      Listenauswahl Eine Option zum Einfügen eines Elements in die Aktionsauswahlliste am Ende einer Liste.
      Hinweis:
      Die unteren Listenschaltflächen wie Listenauswahlaktionen werden unabhängig von der Bedingung angezeigt und bei der Ausführung pro Datensatz ausgewertet.
      Listen-Link Eine Option zum Einfügen 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.
      • Nicht formatiert: Färbt die UI-Aktion nicht.
      Überschreibungen Eine UI-Aktion, die diese UI-Aktion überschreibt.
      Nachrichten Textzeichenfolgen, die die UI-Aktion als Schlüssel zum Suchen einer lokalisierten Nachrichtenalternative aus der Tabelle „Nachricht“ [sys_ui_message] verwenden kann. Jeder Nachrichtenschlüssel befindet sich in einer separaten Zeile im Feld Nachrichten.

      Die Instanz sucht immer nach einer lokalisierten Nachrichtenzeichenfolge, wenn die UI-Aktion einen getMessage(msg)-Aufruf ausführt, bei dem 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 ist in definiert Skript Feld.
      Bedingung Eine bedingte JavaScript-Anweisung, die einschränkt, wenn eine UI-Aktion angezeigt wird. Bedingungen werden immer auf dem Server ausgeführt.
      Hinweis:
      • Das aktuelle Objekt ist für Bedingungen in einem Listenkontextmenü nicht verfügbar. Wenn Listenkontextmenü Option ist ausgewählt, beliebige Verwendung von currentBei diesen Aktionen wird ignoriert.
      • Sie können auf den übergeordneten Datensatz für die UI-Aktionsbedingungen auf einer Schaltfläche für zugehörige Listen verweisen. Beispiel: Um zu deaktivieren Neu Und Bearbeiten Schaltflächen in der zugehörigen Liste „Betroffene CIs“ für geschlossene Changes kopieren Sie die globalen m2m-UI-Aktionen in die Tabelle „Task_ci“, und fügen Sie eine Bedingung von hinzu parent.active.
      • Wenn Sie eines der Felder leer lassen, die Sie in Ihrer Bedingungsanweisung angeben, wird diese Bedingung standardmäßig auf festgelegt Wahr .
      Skript Das Skript, das ausgeführt werden soll, wenn die UI-Aktion ausgeführt wird. Funktionsnamen müssen eindeutig sein.
      Arbeitsbereich
      Arbeitsbereich-Formularschaltfläche Eine Option, damit die UI-Aktion in der Liste der UI-Aktionen in einem Arbeitsbereich angezeigt wird.
      Arbeitsbereich-Formularmenü Eine Option, damit die UI-Aktion als Listenelement im Menü angezeigt wird, 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 Rollen, die für die Anwendung der UI-Aktion erforderlich sind. Anwender müssen mindestens eine der Rollen haben, 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 von Ihnen angegebene Formularansichten zu beschränken. Eine UI-Aktion ist für die angegebene Ansicht gemäß den folgenden Regeln verfügbar:
      1. Wenn keine Sichtbarkeitsregeln vorhanden sind, wird die Aktion in allen Ansichten angezeigt.
      2. Jede Ausschlussregel in einer bestimmten Ansicht bedeutet, dass die Aktion nicht in dieser Ansicht angezeigt wird.
      3. Wenn mindestens eine Einbindungsregel vorhanden ist, wird die Aktion nur für Ansichten angezeigt, die speziell enthalten 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 UI-Aktion auf der Client-Seite ausgeführt werden kann, umschließen Sie sie in eine Funktion. Andernfalls der Inhalt von Skript Feld wird ausgeführt, wenn die Seite geladen wird.

    Beispiel

    Im Rahmen eines UI-Aktionsskripts können Sie einen Anwender 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 in Skript Feld zum Definieren des Umleitungslinks:
    action.setRedirectURL ( 'http://www.mysite.com/mypage.htm' );
    Um einen Anwender zu einem Datensatz zu leiten, verwenden Sie diese Syntax, wo new_recordIst der Variablenname für GlideRecord :
    action.setRedirectURL (new_record );