Richten Sie anwenderdefinierte UI-Aktionen in ein veralteter Arbeitsbereich

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 2024
  • 4 Minuten Lesedauer
  • Richten Sie UI-Aktionen ein, um veralteter Arbeitsbereich für Ihre Organisation anzupassen. Zu den UI-Aktionen gehören anwenderdefinierte Schaltflächen, Menüelemente und das Einschränken des Zugriffs auf Formulare basierend auf der Rolle eines Anwenders.

    Vorbereitungen

    Erforderliche Rolle: workspace_admin

    Warum und wann dieser Vorgang ausgeführt wird

    UI-Aktionen werden entweder als Formularschaltflächen oder Listenelemente im UI-Aktionsmenü angezeigt.

    UI-Aktionsschaltflächen und Listenelemente

    Jeder Arbeitsbereich ist mit UI-Aktionen vorkonfiguriert. Sie können jedoch vorkonfigurierte UI-Aktionen hinzufügen oder entfernen.

    Sie können UI-Aktionen für Personen ausblenden, die keine Aktionen für Datensätze ausführen müssen. Weitere Informationen finden Sie unter Registerkarte „Details“ und UI-Aktionen ausblenden.

    Prozedur

    1. Navigieren zu Alle > Systemdefinition > UI-Aktionen und klicken Sie auf Neu.
    2. Füllen Sie die Felder des Formulars aus.
      Hinweis:
      Andere Felder als die in der folgenden Tabelle erscheinen im Formular, haben jedoch keine Funktion in Arbeitsbereichen. Weitere Informationen zu den einzelnen Feldern im Formular „UI-Aktionen“ finden Sie unter UI-Aktionen.
      Name Name der UI-Aktion. Dies wird auf der Arbeitsbereich-UI angezeigt, z. B. Mir Incident zuweisen.
      Tabelle Tabelle, für die die UI-Aktion gilt. Jedes Mal, wenn ein Service Desk-Mitarbeiter einen Datensatz aus dieser Tabelle anzeigt, wird diese UI-Aktion angezeigt.
      Bestellung Platzierung in der horizontalen Liste der UI-Aktionen. Von links nach rechts werden die Bestellnummern von klein nach groß angezeigt.
      Aktionsname Äquivalent des Namens, der in Protokollen und Tabellenspalten angezeigt wird, z. B. assigned_incident_to_me
      Aktiv Umschalten, um die UI-Aktion anzuzeigen.
      Beim Einfügen anzeigen Umschalten, um den Datensatz in die Tabelleeinzufügen.
      Bei Update anzeigen Schalten Sie um, um das Update in der Tabelle anzuzeigen.
      Client

      Schalten Sie diesen Umschalter ein, damit das System nach clientseitigen Skripts sucht. Standardmäßig werden serverseitige Skripts verwendet. Verwenden Sie die GlideAgentWorkspace- API in einem Skript, um einen angegebenen Datensatz auf der Registerkarte Arbeitsbereich zu öffnen.

      Überschreibungen UI-Aktionen, die diese UI-Aktion überschreiben.
      Kommentare Beschreibung dieser UI-Aktion.
      Tipp Beschreibt die UI-Aktion, wenn der Mauszeiger über die UI-Aktion bewegt wird.
      Beim Klicken Aktion, die per Mausklick auf die UI-Aktion ausgeführt wird, z. B. confirmAndDeleteFromForm().
      Bedingung Bedingungen, die erfüllt sein müssen, damit die UI-Aktion angezeigt wird, z. B. current.isValidRecord() && current.canDelete().
      Skript Serverseitiges Skript, das die UI-Aktion implementiert.
      Anwendung

      Anwendung, für die diese Komponente gilt. Global bedeutet, dass die Komponente für alle Anwendungen gilt.

      Formularschaltfläche Schalten Sie um, um die UI-Aktion als Schaltfläche im Formularbereich anzuzeigen.
      Formular-Kontextmenü Schalten Sie um, um die UI-Aktion als Registerkarte im Menü „Zugehörige Elemente“ anzuzeigen.
      Formular-Link Schalten Sie um, um die UI-Aktion als Link im Formularbereich anzuzeigen.
      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 Schalten Sie um, um die UI-Aktion als Schaltfläche im Listenbanner anzuzeigen.
      Unterste Listen-Schaltfläche Schalten Sie um, um die UI-Aktion als Schaltfläche am unteren Rand der Liste der Datensätze anzuzeigen.
      Listen-Kontextmenü Wechseln Sie, um die UI-Aktion als Eintrag im Kontextmenü der Liste anzuzeigen.

      Kontextmenü

      Listenauswahl Schalten Sie um, um die UI-Aktion als Dropdown-Liste mit Auswahlmöglichkeiten in der Listenansicht anzuzeigen.
      Listen-Link Schalten Sie um, um die UI-Aktion als Link in der Listenansicht anzuzeigen.
      Listenformat
      • Primär: Färbt die UI-Aktion blau.
      • Destruktiv – Färbt die UI-Aktion rot.
      • Unformatiert: Färbt die UI-Aktion nicht ein.
    3. Wahlweise: Um ein serverseitiges Skript zu erstellen, das die UI-Aktion implementiert, geben Sie das Skript in das Feld Skript ein.
      Wenn Sie beispielsweise den Namen des Anrufers und die Kurzbeschreibung in einen Incident aufnehmen möchten, der aus einem Interaktionsdatensatz erstellt wurde, können Sie das folgende Skript verwenden, das GlideRecordverwendet
      if(current.update()){
      	var inc = new GlideRecord("incident");
      	inc.newRecord();
      	inc.caller_id = current.opened_for;
      	inc.short_description = current.short_description;
      	action.openGlideRecord(inc);
      }

      Das System ignoriert alle Client-Skripts, die in diesem Feld enthalten sind. Sie können nur das Clientskript-Feld des Arbeitsbereichs für Clientskripts verwenden.

    4. Wahlweise: Informationen zum Erstellen eines clientseitigen Skripts, das die UI-Aktion implementiert, finden Sie unter Unterstützte Client-Skripttypen und APIs und Service Portal und Client-Skripts.
      Hinweis:
      Im Formular „Client-Skript“ müssen Sie die Option Skript isolieren auswählen, damit ein Client-Skript in einem veralteter Arbeitsbereichfunktioniert.
    5. Wählen Sie auf der Registerkarte „Arbeitsbereich“ Folgendes aus: Arbeitsbereich-Formularschaltfläche, damit die UI-Aktion in der Zeile der UI-Aktionen angezeigt wird, oder Arbeitsbereich-Formularmenü, damit sie als Listenelement in der Menüliste angezeigt wird.
      • Schaltfläche „Arbeitsbereich-Formular“, mit der die UI-Aktion in der Liste der UI-Aktionen angezeigt wird.
      • Formularmenü des Arbeitsbereichs, um die UI-Aktion als Listenelement im Menü anzuzeigen, das den UI-Aktionen zugeordnet ist.
      • DasFormat für konfigurierbare Arbeitsbereiche ermöglicht die Anzeige der UI-Aktion in konfigurierbaren Arbeitsbereichen.
        Hinweis:
        Wenn ein Benutzer bei neuen UI-Aktionen Arbeitsbereich-Formularschaltfläche oder Arbeitsbereich-Formularmenüauswählt, wird diese Eigenschaft automatisch ausgewählt.
        • Wenn ein Benutzer versucht, Format für konfigurierbaren Arbeitsbereich auszuwählen, bevor er Arbeitsbereich-Formularschaltfläche oder Arbeitsbereich-Formularmenüauswählt, wird eine Fehlermeldung angezeigt.
        • Wenn ein Anwender möchte, dass die Aktion nur in Legacy-AWS (nicht konfigurierbar) angezeigt wird, sollte er dieses Kontrollkästchen deaktivieren.
        • Wenn ein Benutzer möchte, dass eine vorhandene UI-Aktion in konfigurierbaren Arbeitsbereichen angezeigt wird, muss er dieses Kontrollkästchen aktivieren und den Datensatz speichern.
    6. Wahlweise: Erstellen Sie im Feld Workspace Client Script (Arbeitsbereichs-Client-Skript) ein arbeitsbereichsspezifisches Client-Skript.
      Für den Arbeitsbereich gelten ähnliche Einschränkungen beim Client-Skripting wie für Serviceportal. Um beispielsweise ein Formular durch Anklicken zu öffnen, können Sie das folgende Client-Skript hinzufügen:
      function onClick(g_form) {
      
      }
    7. Fügen Sie auf der Registerkarte Erfordert Rolle des Abschnitts „Arbeitsbereich“ die Rollen hinzu, auf die Sie den Zugriff auf die UI-Aktion beschränken möchten.
    8. Klicken Sie auf Absenden oder Aktualisieren.

    Nächste Maßnahme