Dot-Walking-Beispiele

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 5 Minuten Lesedauer
  • Greifen Sie per Dot-Walking über ein Formular, eine Liste oder ein Skript auf Felder in einer zugehörigen Tabelle zu. Dieses Thema enthält Beispiele für die verschiedenen Möglichkeiten, wie Sie Dot-Walking durchführen können.

    Listenfelder

    Sie können per Dot-Walk zu zugehörigen Feldern in einer Liste gelangen, z. B. zur Feldliste in einem Filter. Dieses Beispiel zeigt, wie die Incident-Tabelle [incident] nach dem Unternehmen des Anrufers gefiltert wird, der den Incident registriert hat.

    Wenn Sie die Liste der Felder öffnen, die Sie filtern möchten, sehen Sie die Liste der verfügbaren Incident-Tabellenfelder. Auf die Referenzfelder folgen die zugehörigen Felder. Beispiel: Auf Anrufer folgt Anrufer > Benutzerfelder, was bedeutet, dass Anrufer ein Referenzfeld ist und die zugehörigen Felder Benutzerfelder im Anrufer -Datensatz sind. Wenn die zugehörigen Felder nicht in der Liste vorhanden sind, wählen Sie Zugehörige Felder anzeigen am Ende der Liste aus.
    Zugehörige Felder anzeigen

    Wenn Sie Zugehörige Felderanzeigen auswählen, wird das Menü neu geladen, um zugehörige Felder anzuzeigen.Zugehörige Felder

    Wenn Sie ein zugehöriges Feld auswählen, wird das Menü mit den Feldern der zugehörigen Tabelle neu geladen.
    Zugehörige Tabellenfelder

    Wenn Sie Unternehmen unter Anrufer > Benutzerfelder auswählen, wird das Feld zu Caller.Company.

    Das folgende Beispiel zeigt, wo Sie sich im Dot-Walk befinden. Jede ausgewählte Referenz wird oben im Feldermenü gespeichert, und die Anzahl der Punkte vor der Feldbezeichnung gibt an, wie viele Punkte aus dem ursprünglichen Datensatz der Benutzer erreicht hat.
    Dot-Walking-Feld

    Das Beispiel zeigt, dass sich der Benutzer bei Incident.Caller.Companybefindet. Sie können zu höheren Ebenen in der Hierarchie zurückkehren, indem Sie Felder oben im Menü auswählen. Wenn Sie beispielsweise Incident-Felder auswählen, kehren Sie zur Liste der Incident-Felder zurück.

    Die zugehörigen Felder können entfernt werden, indem Sie Zugehörige Felder entfernen am Ende der Liste auswählen.
    Entfernen Sie zugehörige Felder

    Bedingungsgeneratoren

    Sie können eine detaillierte Abfrage für eine Tabelle erstellen, indem Sie im Bedingungsgenerator Dot-Walking durchführen.

    Um einen Dot-Walk in einem Bedingungsgenerator durchzuführen, wählen Sie zuerst im Menü „Felder“ die Option Zugehörige Felder anzeigen aus. Mit dieser Aktion können Sie Ihrer Abfrage Felder aus zugehörigen Tabellen hinzufügen.

    Das folgende GIF zeigt, wie Sie Dot-Walk-Felder in einem Bedingungsgenerator verwenden, um alle Incident-Datensätze zu finden, die einer bestimmten Benutzerin, Beth Anglin, zugewiesen sind. Im Beispiel navigiert der Benutzer zu Incident > Offen und öffnet dann den Bedingungsgenerator. Im Feldermenü wählt der Benutzer zuerst Zugehörige Felder anzeigen aus und öffnet dann das Feldermenü erneut, um Zugewiesen an > Benutzerfelderauszuwählen. Der Benutzer öffnet das Feldermenü erneut, um Nachnameauszuwählen. Der Benutzer erstellt die folgende Bedingung: [Nachname] [ist] [Anglin]. Nachdem der Benutzer Ausführenausgewählt hat, werden in der Incident-Liste nur die Datensätze angezeigt, die Beth Anglin zugewiesen sind.


    Das GIF veranschaulicht das Dot-Walking in einem Bedingungsgenerator

    Listensammler

    Hinweis:
    Das Hinzufügen neuer Felder per Dot-Walking durch Ausfüllen des Abschnitts „Neues Feld erstellen“ (im Beispiel „A“) im Feld „Name“ (im Beispiel „B“) wird nicht unterstützt. Das Hinzufügen nicht autorisierter Felder und das Hinzufügen von Feldern für Empfehlungen über Dot-Walking kann zu unerwartetem Verhalten in der Plattform führen. Nicht autorisiertes Dot-Walking aus dem Abschnitt „Neues Feld erstellen“.
    Wenn Sie eine Liste von Feldern aus einem Listensammler auswählen (z. B. beim Konfigurieren eines Formulars), können Sie per Dot-Walk zu Feldern aus anderen Formularen gelangen.
    Um zu sehen, welche Felder Referenzfelder sind und für die ein Dot-Walk durchgeführt werden kann, suchen Sie nach grünen Feldern mit einem Plus-Symbol.
    Referenzfelder
    Sobald ein Referenzfeld hervorgehoben ist, wird das Erweiterungssymbol ( Erweiterungssymbol) über dem Hinzufügen-Symbol angezeigt.
    Referenzfelder mit der Erweiterungsoption
    Wenn Sie auf das Erweiterungssymbol klicken, wird die Liste der Felder aus der zugehörigen Liste im Bereich Verfügbar geöffnet. Das folgende Beispiel zeigt, dass die Felder Zugewiesen an ausgewählt wurden. Die vorherigen Feldlisten werden oben in der Liste angezeigt.
    Listen von Feldern
    Sobald das Feld dem Bereich Ausgewählt hinzugefügt wurde, wird es mit seiner vollständigen Dot-Walking-Syntax angezeigt. Das folgende Beispiel zeigt, dass Zugewiesen an.Aktiv ausgewählt wurde.
    Dot-Walking-Feld

    Skripts

    Sie können innerhalb eines Skripts Dot-Walking durchführen, indem Sie die Dot-Walk-Syntax aufrufen. Diese Funktionalität erfordert Kenntnisse in JavaScript.

    Für Skripts, die auf der Serverseite ausgeführt werden, z. B. Business Rules, ist das Hinzufügen von current erforderlich.

    Das folgende Skript ist beispielsweise eine geskriptete Genehmigungsregel, die eine Genehmigung vom Manager des Benutzers anfordert, der das Ticket geöffnet hat.
    try{
      current.opened_by.manager;
    }
    catch(err){}
    Für Skripts, die auf der Client-Seite ausgeführt werden, z. B. Client-Skripts, ist „ current “ nicht erforderlich. Beispielsweise wird das folgende Skript „VIP-Anrufer hervorheben“ auf der Clientseite ausgeführt.
    function onChange(control, oldValue, newValue, isLoading){
      //wait until there is a valid record in the field
      if(newValue){ 
        //get the caller object so we can access fields
        var caller = g_form. getReference('caller_id');
        var callerLabel = document.getElementById('label.incident.caller_id');
        var callerField = document.getElementById('sys_display.incident.caller_id');
     
      //check for VIP status
      if(caller.vip == 'true') { 
        //change the caller label to red background
        //style object is CSSStyleDeclaration, style names are not standard css names
      if(callerLabel) 
        document.getElementById('label.incident.caller_id').style.backgroundColor = 'red';
     
      //change the caller's name field to red text
      if(callerField)
         document.getElementById('sys_display.incident.caller_id').style.color = 'red';
      } 
        else { //not a VIP, remove temporary styles if(callerLabel)
         document.getElementById('label.incident.caller_id').style.backgroundColor = '';
    
        if(callerField)
          document.getElementById('sys_display.incident.caller_id').style.color = '';
        }
      }
    }

    Variablen

    Häufig können Sie Variablen zu Vorlagen, Benachrichtigungen oder anderen Formularen hinzufügen, in denen ein Wert aus dem Formular aufgerufen wird.

    Beispiel: ${assigned_to} ist die Variable für das Feld Zugewiesen an.

    Wie im Beispiel gezeigt, können Sie per Dot-Walk zu Feldern im ursprünglichen Datensatz eines beliebigen Referenzfelds gelangen. Es ist möglich, per Dot-Walk zu jedem Feld im Datensatz „assigned_to“ zu gelangen, z. B. ${assigned_to.manager}.

    Beim Dot-Walking können Sie bei Bedarf eine längere Kette haben, wie in diesem Beispiel: ${assigned_to.department.manager.mobile_phone}.

    Manchmal können Sie diese Variable aus einer Strukturauswahl auswählen.

    Strukturauswahl

    Die Strukturauswahl-Schnittstelle verfügt über eine erweiterbare, hierarchische Ansicht, in der Sie nach den folgenden Elementen suchen können:
    • Konfigurationselemente (CIs), die einem anderen, übergeordneten CI untergeordnet sind.
    • Mitglieder einer bestimmten Gruppe. Beispielsweise würden Sie eine Strukturauswahl verwenden, um nach einem Benutzer in der Service Desk-Gruppe zu suchen.
    • Referenzelemente für eine beliebige hierarchische Tabelle. Eine hierarchische Tabelle ist eine Tabelle, bei der ein übergeordnetes Feld auf sich selbst verweist. Die Gruppentabelle [sys_user_group] wird beispielsweise als hierarchische Tabelle betrachtet, da bestimmte Gruppen untergeordnete Elemente von übergeordneten Gruppen sind.

    Das folgende Beispiel zeigt, wie Sie eine Strukturauswahl verwenden, um einem Benutzer in der Datenbankgruppe einen Incident-Datensatz zuzuweisen.

    Sie navigieren zuerst zu einem beliebigen Incident-Datensatz und geben dann Datenbank in das Feld Zuweisungsgruppe ein.


    Listenfeld

    In diesem Beispiel ist die Datenbankgruppe eine übergeordnete Gruppe mit mehreren untergeordneten Gruppen. Wenn Sie das Suchsymbol ( Suchsymbol ) neben dem Feld Zugewiesen an auswählen, werden in einem Fenster Referenzfelder in der Datenbankgruppe angezeigt.


    Wählen Sie Felder aus

    Referenzfelder weisen neben ihrem Namen das Erweiterungssymbol (+) auf. Durch Klicken auf das + wird eine Liste der Felder in diesem referenzierten Feld erweitert. In diesem Beispiel wird durch Erweitern der Felder Datenbank Atlanta oder Datenbank San Diego eine Liste von Benutzerdatensätzen in jeder untergeordneten Gruppe geöffnet.


    Wählen Sie referenzierte Felder aus

    Wählen Sie einen der Benutzerdatensätze aus, um ihn als Wert im Feld Zugewiesen an hinzuzufügen.


    Dot-Walking-Variable
    Hinweis:
    Sie können die Strukturauswahl so konfigurieren, dass sie bis zu 1.000 Knoten erfasst, wenn Sie die Eigenschaft glide.ui.group_heirarchy.max_nodes konfigurieren. Um die Eigenschaft festzulegen, öffnen Sie die Wörterbuchattribute für das Feld, und fügen Sie tree_picker=true zum Feld Attribute hinzu. Wenn mehrere Attribute vorhanden sind, trennen Sie sie durch ein Komma ohne Leerzeichen.