Richten Sie benutzerdefinierte UI-Aktionen in ein veralteter Arbeitsbereich

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 4 Minuten Lesedauer
  • Richten Sie UI-Aktionen ein, um veralteter Arbeitsbereich für Ihre Organisation anzupassen. Zu den UI-Aktionen gehören benutzerdefinierte Schaltflächen, Menüelemente und die Beschränkung des Zugriffs auf Formulare basierend auf der Rolle eines Benutzers.

    Vorbereitungen

    Erforderliche Rolle: workspace_admin

    Warum und wann dieser Vorgang ausgeführt wird

    UI-Aktionen werden entweder als Formularschaltflächen oder als 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 Maßnahmen für Datensätze ergreifen 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 werden im Formular angezeigt, funktionieren jedoch nicht in Arbeitsbereichen. Weitere Informationen zu den einzelnen Feldern im Formular „UI-Aktionen“ finden Sie unter UI-Aktionen.
      Name Name der UI-Aktion. Dies wird in der Benutzeroberfläche des Arbeitsbereichs angezeigt, z. B. Incident mir 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.
      Reihenfolge Platzierung in der horizontalen Liste der UI-Aktionen. Von links nach rechts gehen die Reihenfolgennummern von klein nach groß.
      Aktionsname Äquivalent zu Name, der in Protokollen und Tabellenspalten angezeigt wird, z. B. „assign_incident_to_me“.
      Aktiv Schalten Sie um, um die UI-Aktion anzuzeigen.
      Beim Einfügen anzeigen Umschalten, um die Datensatzänderung in die Tabelleeinzufügen.
      Bei Update anzeigen Schalten Sie um, um das Update in der Tabelle anzuzeigen.
      Client

      Schalten Sie um, damit das System nach clientseitigen Skripts sucht. Der Standardwert sind serverseitige Skripts. 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ü Umschalter, 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.
      • Nicht formatiert: Färbt die UI-Aktion nicht.
      Listen-Kopfzeile Schaltfläche Umschalter, um die UI-Aktion als Schaltfläche im Listenbanner anzuzeigen.
      Unterste Listen-Schaltfläche Umschalter, um die UI-Aktion als Schaltfläche am unteren Rand der Datensatzliste anzuzeigen.
      Listen-Kontextmenü Umschalter, um die UI-Aktion als Eintrag im Kontextmenü der Liste anzuzeigen.

      Kontextmenü

      Listenauswahl Umschalter, um die UI-Aktion als Dropdown-Liste mit Auswahlmöglichkeiten in der Listenansicht anzuzeigen.
      Listen-Link Umschalter, 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.
      • Nicht formatiert: Färbt die UI-Aktion nicht.
    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 wird, 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 Client- Skriptformular 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 eine der folgenden Optionen 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.
      • Arbeitsbereich-Formular Schaltfläche, um die UI-Aktion in der Liste der UI-Aktionen anzuzeigen.
      • Arbeitsbereich-Formularmenü, um die UI-Aktion als Listenelement im Menü anzuzeigen, das den UI-Aktionen zugeordnet ist.
      • Format für konfigurierbaren Arbeitsbereich 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 den konfigurierbaren Arbeitsbereich auszuwählen, bevor er Arbeitsbereich-Formularschaltfläche oder Arbeitsbereich-Formularmenüauswählt, wird eine Fehlermeldung angezeigt.
        • Wenn ein Benutzer 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 (Arbeitsbereich-Client-Skript) ein arbeitsbereichsspezifisches Client-Skript.
      Für den Arbeitsbereich gelten ähnliche Client-Skripting-Einschränkungen wie für Serviceportal. Um beispielsweise ein Formular durch Klicken 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 Arbeitsbereichsabschnitts alle 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