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, die die Ausführung von UI-Aktionen aus einem anderen Anwendungsbereich zulassen.

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 so konfigurieren, dass alle Felder angezeigt werden.

   Tabelle : 1. UI-Aktionsfelder

   Feld	Beschreibung
   Name	Definiert den Text, der auf der Schaltfläche, dem Link oder dem Kontextmenüelement angezeigt wird.
   Tabelle	Definiert die Tabelle, in der 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 Global aus, um die Aktion für alle Tabellen verfügbar zu machen.
   Bestellung	Definiert 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	Definiert einen Namen, der beim Verweisen auf die UI-Aktion in Skripts verwendet werden soll.
   Aktiv	Aktiviert die UI-Aktion, wenn ausgewählt. Um eine UI-Aktion zu deaktivieren, deaktivieren Sie das Kontrollkästchen.
   Beim Einfügen anzeigen	Zeigt eine Schaltfläche für neue Datensätze an, die nicht eingefügt wurden.
   Bei Update anzeigen	Zeigt eine Schaltfläche für vorhandene Datensätze an.
   Client	Die UI-Aktion führt ihr Skript im Browser des Benutzers aus, nicht auf dem Server. Wenn diese Option aktiviert ist, wird das Feld Beim Klicken über dem Feld Bedingung angezeigt.
   Formularschaltfläche	Fügt eine Schaltfläche in ein Formular ein.
   Formular-Kontextmenü	Fügt ein Element in ein Formular-Kontextmenü ein (klicken Sie mit der rechten Maustaste auf den Formular-Header).
   Formular-Link	Fügt einen Link in den Abschnitt „Zugehörige Links“ eines Formulars ein.
   Listen-Kopfzeile Schaltfläche	Fügt eine Schaltfläche in das Banner einer Liste ein. 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 für Listenbanner-Schaltflächen.
   Unterste Listen-Schaltfläche	Fügt eine Schaltfläche am Ende einer Liste ein. Hinweis: Die unteren Schaltflächen der Liste werden unabhängig von der Bedingung angezeigt und pro Datensatz bei der Ausführung ausgewertet.
   Listen-Kontextmenü	Fügt ein Element in das Kontextmenü eines Listenfelds ein (Rechtsklick auf eine Zelle in einer Liste).
   Listenauswahl	Fügt ein Element in die Aktionsauswahlliste am Ende einer Liste ein. Hinweis: Die unteren Listenschaltflächen werden wie Listenauswahlaktionen unabhängig von der Bedingung angezeigt und bei Ausführung pro Datensatz ausgewertet.
   Listen-Link	Fügt einen Link im Abschnitt „Zugehörige Links“ am Ende einer Liste ein.
   Überschreibungen	Gibt eine UI-Aktion an, die diese UI-Aktion überschreibt.
   Kommentare	Stellt beschreibenden Inhalt zu dieser UI-Aktion bereit.
   Tipp	Definiert den Text, der angezeigt wird, wenn ein Benutzer 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	Definiert die Bedingungen, die einschränken, wann eine UI-Aktion angezeigt wird. Beispiele finden Sie unter Verwenden des Bedingungsgenerators zum Anpassen von UI-Aktionen für Mitarbeiterbereich.
   Skript	Definiert das Skript, das ausgeführt werden soll, wenn die UI-Aktion ausgeführt wird.
   Zugehörige Listen in der Formularansicht:
   UI-Aktion Sichtbarkeit	Gibt andere Ansichten des Formulars an, für die die UI-Aktion gilt. Verwenden Sie diese Option, um die UI-Aktion auf von Ihnen angegebene Formularansichten zu beschränken.
   Versionen	Zeigt alle Versionen der UI-Aktion an. 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 für die Ausführung auf der Clientseite aktiviert ist, schließen Sie sie in eine Funktion ein. Andernfalls wird der Inhalt des Felds Skript ausgeführt, wenn die Seite geladen wird.

Beispiel

Als Teil eines UI-Aktionsskripts können Sie einen Benutzer zu einer URL umleiten. Sie können beispielsweise Links zu einem Formular hinzufügen oder einen neuen Datensatz öffnen, nachdem er aus einer UI-Aktion erstellt wurde. Um einen Benutzer 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 Benutzer zu einem Datensatz weiterzuleiten, verwenden Sie diese Syntax, wobei new_record der Variablenname für den GlideRecordist:

action.setRedirectURL (new_record );

Verwenden des Bedingungsgenerators zum Anpassen von UI-Aktionen für Mitarbeiterbereich

Konfigurieren Sie UI-Aktionen, indem Sie einem UI-Aktionsformular Bedingungen hinzufügen.

Verwenden des Bedingungsgenerators für UI-Aktionen

Die folgende Bedingung ist für die Schaltfläche Incident schließen konfiguriert:

Damit diese Aktion in einem Formular angezeigt wird, müssen diese Bedingungen als „true“ bewertet werden:

• current.incident_state muss gleich 6 sein: Der Incident muss sich bereits im Status Gelöst befinden.
• gs.hasRole("itil_admin"): Der aktuelle Benutzer benötigt die Rolle „itil_admin“.

ODER die folgende Bedingung muss als „true“ bewertet werden:

gs.getUserID() == current.caller_id: Der aktuelle Benutzer ist der Benutzer, der den Change angefordert hat.

Hinweis:

• Das aktuelle Objekt ist nicht für Bedingungen in einem Listenkontextmenü verfügbar. Die Kontextmenüoption Liste ist ausgewählt. Jede Nutzung von current bei diesen Aktionen wird ignoriert.
• Sie können auf der Schaltfläche einer zugehörigen Liste auf den übergeordneten Datensatz für die Bedingungen für die UI-Aktion verweisen. 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 die Bedingung parent.activehinzu.
• Wenn Sie eines der Felder leer lassen, die Sie in Ihrer Bedingungsanweisung angeben, wird diese Bedingung standardmäßig auf truegesetzt.

Einschränken von UI-Aktionen basierend auf Formularansichten

Sie können UI-Aktionen so einschränken, dass sie nur in bestimmten Formularansichten angezeigt werden.

Verwenden Sie die zugehörige Liste Sichtbarkeit von UI-Aktionen im Formular „UI-Aktion“, um eine UI-Aktion nach Ansicht einzuschrä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 für eine bestimmte Ansicht bedeutet, dass die Aktion nicht in dieser Ansicht angezeigt wird.
3. Wenn mindestens eine Einbindungsregel vorhanden ist, wird die Aktion nur in Ansichten angezeigt, die ausdrücklich eingeschlossen wurden.

Beispiel: Eine Aktion überall mit Ausnahme der Ansicht „Kostenmanagement“ anzeigen

Fügen Sie eine Ausschlussregel für die Ansicht „Cost Management“ hinzu.

Abbildung : 1. Beispiel für die UI-Aktionsansicht „Ausschluss“.

Beispiel: Zeigen Sie eine Aktion in den Ansichten „Routine“ und „ITIL“ an, aber sonst nirgendwo

Fügen Sie Include-Regeln für die Ansichten „Routine“ und „ITIL“ hinzu.

Abbildung : 2. Beispiel für UI-Aktionsansichten für Inklusionen