Dot-Walking-Beispiele

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 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 verschiedene Möglichkeiten des Dot-Walkings.

    Listenfelder

    Sie können einen Dot-Walk zu zugehörigen Feldern in einer Liste ausführen, z. B. zur Feldliste in einem Filter. In diesem Beispiel wird veranschaulicht, 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 > Anwenderfelder, was bedeutet, dass Anrufer ein Referenzfeld ist und die zugehörigen Felder Benutzerfelder im Anruferdatensatz sind. Wenn die zugehörigen Felder nicht in der Liste vorhanden sind, wählen Sie Verwandte Felder anzeigen am Ende der Liste aus.
    Zugehörige Felder anzeigen

    Wenn Sie Zugehörige Felder anzeigenauswä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 unter Anrufer → BenutzerfelderUnternehmenauswählen, ändert sich das Feld in Anrufer.Unternehmen.

    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 Verwandte Felder entfernen unten in der Liste auswählen.
    Entfernen Sie zugehörige Felder

    Bedingungsgeneratoren

    Im Bedingungsgenerator können Sie eine detaillierte Abfrage durch Dot-Walking durchführen.

    Für das Dot-Walking in einem Bedingungsgenerator wählen Sie im Feldmenü zuerst Verwandte Felder anzeigen. Mit dieser Aktion können Sie Ihrer Abfrage Felder aus zugehörigen Tabellen hinzufügen.

    Das folgende GIF zeigt, wie Sie in einem Bedingungsgenerator ein Dot-Walking durchführen, 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, öffnet dann das Feldmenü erneut und wählt Zugewiesen an → Benutzerfelderaus. 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 demonstriert das Dot-Walking in einem Bedingungsgenerator

    Listensammler auf

    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 gegen Empfehlungen per Dot-Walking kann zu unerwartetem Verhalten auf der Plattform führen. Nicht autorisiertes Dot-Walking im 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 wechseln.
    Um zu sehen, welche Felder Referenzfelder sind und punktweise durchlaufbar sind, suchen Sie nach grünen Feldern mit einem Pluszeichen.
    Referenzfelder
    Sobald ein Referenzfeld hervorgehoben ist, wird das Erweiterungssymbol ( Erweiterungssymbol) über dem Hinzufügen-Symbol angezeigt.
    Referenzfelder mit Erweiterungsoption
    Wenn Sie das Erweiterungssymbol auswählen, 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 vorherige Feldliste wird 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

    Skripte

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

    Für serverseitige Skripts (z. B. Geschäftsregeln) muss current hinzugefügt werden.

    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 Client-Seite ausgeführt werden, z. B. Client-Skripts, ist current nicht erforderlich. Beispielsweise wird das folgende Skript zum Hervorheben von VIP-Anrufern auf Client-Seite 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 zu Feldern im ursprünglichen Datensatz eines beliebigen Referenzfelds navigieren. Ein Dot-Walk zu jedem Feld im Datensatz „assigned_to“ ist möglich, z.  B. ${assigned_to.manager}.

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

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

    Strukturauswahlen

    Die Strukturauswahloberfläche verfügt über eine erweiterbare, hierarchische Ansicht, mit der Sie nach den folgenden Elementen suchen können:
    • Configuration Items (CIs), die einem anderen CI einer höheren Ebene untergeordnet sind.
    • Mitglieder einer bestimmten Gruppe Beispielsweise können Sie mithilfe der Strukturauswahl nach einem Benutzer in der Service Desk-Gruppe suchen.
    • Referenzelemente für eine beliebige hierarchische Tabelle. Eine hierarchische Tabelle ist jede Tabelle, die über ein übergeordnetes Feld verfügt, das auf sich selbst verweist. Die Tabelle „Gruppe“ [sys_user_group] würde 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 im Feld Zuweisungsgruppe den Wert Datenbank ein.


    Listenfeld

    In diesem Beispiel ist die Gruppe Datenbank 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 haben das Erweiterungssymbol (+) neben ihrem Namen. Durch Klicken auf + wird eine Liste der Felder im referenzierten Feld erweitert. In diesem Beispiel öffnet das Erweitern der Felder Database Atlanta oder Database San Diego eine Liste von Benutzerdatensätzen in jeder untergeordneten Gruppe.


    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 bis zu 1.000 Knoten ausgewählt werden, 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 im Feld Attribute das Feld „tree_picker=true“ hinzu. Wenn mehrere Attribute vorhanden sind, verwenden Sie ein Komma, um sie ohne Leerzeichen zu trennen.