CLP - Aktualisieren von Verbindungen mit einem Parameter

Primärer geschäftlicher Anwendungsfall	Datenkonnektivität zwischen Workiva und Wdata
Primäres Lernziel	Erfahren Sie, wie Sie eine Verbindung mit einem Parameter aktualisieren und den Parameterwert zur Laufzeit der Kette festlegen
Voraussetzungen	Konfigurieren Sie Workiva Connector Füllen Sie das CLP | Verbindung aktualisieren mit ID Berechtigungen für das Spreadsheet für den zugehörigen Workiva OAuth Grant User bereitstellen
Unterstützende Vorlage	CLP | Aktualisieren von Verbindungen mit einem Parameter

Schritt 1: Vorhandene Abfrage kopieren

Zunächst benötigen wir eine Abfrage mit einem Parameter. Wir erstellen eine Kopie unserer bestehenden Abfrage und fügen einen Parameter hinzu, mit dem wir entscheiden können, für welches Land wir die Gesamtzahl der Mitarbeiter anzeigen möchten.

• Suchen Sie auf Wdata Home die Abfrage CLP Employee Detail Query und öffnen Sie das Menü
  • Kopie auswählen

• Aktualisieren Sie den Abfragenamen zu CLP-Mitarbeiterdetails nach Land Abfrage

• Klicken Sie auf Abfrage speichern
• Klicken Sie auf dem Bearbeitungsbildschirm der Abfrage auf das Symbol Parameter ganz rechts im Feld

• Klicken Sie auf Add Parameters und wählen Sie Create New Parameter
  • Benennen Sie den Parameter: Land
  • Schalten Sie die Auswahlliste auf um
  • Geben Sie im Feld Listenoptionen die folgenden Länder an, jedes Land in einer eigenen Zeile:
    • Australien
    • Brasilien
    • Italien
    • Kenia
    • Vereinigte Staaten
  • Aktualisieren Sie die Standardeinstellung auf Keine
  • Klicken Sie auf Erstellen
• Damit der Parameter die Ergebnisse unserer Abfrage steuern kann, müssen wir den Parameter mithilfe von Filtern mit der Spalte in den Quelldaten verbinden. Wechseln Sie in der Abfrage zur Registerkarte Filter. 
  • Suchen Sie die Spalte Land in den Quelldaten auf der linken Seite, klicken Sie darauf und ziehen Sie sie in den Filterbereich auf der linken Seite
  • Klicken Sie auf den Filterwert, wo leere Zeichenfolge steht, um den Filterwert auszufüllen
    • Klicken Sie rechts neben dem Feld für den Filterwert auf die Schaltfläche Parameter
    • Wählen Sie Land
    • Klicken Sie auf Anwenden

• • Sie haben jetzt eine Abfrage mit einem Parameter für Land. Wenn Sie auf Abfrage ausführen klicken, werden Sie gefragt, welches Land die Abfrageergebnisse anzeigen sollen

• Klicken Sie auf Speichern

Schritt 2: Erstellen einer eingehenden Verbindung

Um zu lernen, wie man eine Verbindung mit Hilfe einer Kette aktualisiert, müssen wir zunächst eine Verbindung zwischen einer Wdata Query und einem Spreadsheet herstellen. 

• Navigieren Sie zur CLP-Mitarbeiterübersicht Tabellenkalkulation
• Fügen Sie ein neues Blatt hinzu, indem Sie auf
  • Umbenennen in CLP-Mitarbeiterdetails nach Land
• Fügen Sie dem Blatt CLP-Mitarbeiterdetails nach Land eine eingehende Verbindung hinzu:
  • Öffnen Sie das Bedienfeld Verbindungen auf der rechten Seite durch Klicken auf das Symbol Verbindungen
  • Wählen Sie auf der Registerkarte Eingehende Verbindungen Verbindung hinzufügen
    • Select Wdata Abfrage
    • Wählen Sie die Abfrage CLP Employee Detail by Country
    • Setzen Sie den Parameter Land auf Australien
    • Klicken Sie auf Verbinden

• Es gibt jetzt zwei Blätter mit eingehenden Verbindungen in der CLP-Kalkulationstabelle für Mitarbeiter

Schritt 3: Vorhandene Kette bearbeiten

• Navigieren Sie zum Chain Builder und suchen Sie die Kette CLP | Refresh Connection using ID
• Klicken Sie auf die Bleistift-Schaltfläche, um die Kette zu bearbeiten
• Klicken Sie oben rechts auf Ketteneinstellungen
  • Benennen Sie die Kette um: CLP | Aktualisieren von Verbindungen mit einem Parameter
• Rettet die Kette

Schritt 4: Laufzeit-Eingaben

Wir verwenden den Befehl Runtime Inputs, um die Kette zu starten. Auf diese Weise können wir angeben, welche Verbindung wir zur Laufzeit der Kette aktualisieren wollen, sowie den Parameter, für den wir den Wert aktualisieren wollen.

• Bearbeiten Sie das Runtime Inputs Chain Event durch Doppelklick auf den Command
• Klicken Sie zweimal auf die Schaltfläche Eingang hinzufügen und fügen Sie die folgenden Eingänge hinzu:
  • Eingang 1:
    • Typ: TextField
    • Name anzeigen: Name des Parameters
    • Erforderlich: Nicht angekreuzt
  • Eingabe 2:
    • Typ: TextField
    • Name anzeigen: Parameter Wert
    • Erforderlich: Nicht angekreuzt
• Speichern Sie den Befehl

Schritt 5: Verbindung aktualisieren

Um den hinzugefügten Parameter zu berücksichtigen, müssen wir den Befehl "Verbindungen aktualisieren" aktualisieren, um den Parameter und den Wert zu berücksichtigen, die in die Abfrage übertragen werden sollen.

• Bearbeiten Sie die Refresh Connection durch Doppelklick auf den Befehl
  • Verbindungs-ID: Verwenden Sie weiterhin die Variable Connection ID von Runtime Inputs
  • Einen Parameter hinzufügen
    • Da unsere Parameter an der Quelle (in der Abfrage) gespeichert werden, müssen wir die Parameter an der Quelle auffüllen. Klicken Sie auf die Schaltfläche + neben Quellparameter
    • Parameter-Name: Verwenden Sie die Variable Parametername von Runtime Inputs - dies ermöglicht es uns, den zur Laufzeit der Kette angegebenen Wert für den Parameternamen in den Befehl Refresh Connections zu übertragen
      • Klicken Sie auf das Feld Parametername
      • Erweitern Sie im linken Bereich das Dropdown-Menü Auslöser
      • Erweitern Sie das Dropdown-Menü Runtime Inputs
      • Wählen Sie die Variable Parameter Name
    • Parameterwert: Verwenden Sie die Variable Parameter Value von Runtime Inputs - damit können wir den zur Laufzeit der Kette angegebenen Parameterwert an den Befehl Refresh Connections weiterleiten
      • Klicken Sie auf das Feld Parametername
      • Erweitern Sie im linken Bereich das Dropdown-Menü Auslöser
      • Erweitern Sie das Dropdown-Menü Runtime Inputs
      • Wählen Sie die Variable Parameterwert
• Speichern Sie den Befehl

Schritt 6: Testen Sie die Übung

Testen Sie das Ergebnis, nachdem die Kette abgeschlossen ist

• Veröffentlichen die Kette
• Klicken Sie auf Execute und wählen Sie dann Run With Inputs
• Finden Sie die Verbindungs-ID
  • Navigieren Sie zum Arbeitsblatt CLP Employee Overview
  • Suchen Sie im Bereich Verbindungen die Verbindung CLP Employee Detail by Country Query und klicken Sie auf den Pfeil nach oben. Sobald das Dropdown-Menü erscheint, wählen Sie View Properties

• Kopieren Sie die Verbindungs-ID - achten Sie darauf, dass Sie keine Zeichen auslassen oder Leerzeichen hinzufügen

• Navigieren Sie zurück zum Chain Builder und fügen Sie die Verbindungs-ID in das Feld Verbindungs-ID Runtime Input
• Befüllen Sie die Parametereingaben
  • Parametername: der Name des Parameters in der Abfrage - in dieser Übung lautet der Parametername Land
  • Parameterwert: der Wert, nach dem die Abfrage gefiltert werden soll - in dieser Übung werden wir nach Brasilien filtern
    • Hinweis: Wenn Sie einen anderen Parameterwert auswählen als den, der bereits in der Kalkulationstabelle gespeichert ist, wird die Kalkulationstabelle überschrieben, d. h. unsere Daten werden von Australien auf Brasilien geändert.
• Start anklicken
• Sobald die Kette abgeschlossen ist, navigieren Sie zurück zum Spreadsheet und sehen Sie, dass die Verbindung erfolgreich aktualisiert wurde!

Erfolgreicher Kettenlauf:

Erfolgreiche Aktualisierung der Verbindung:

Erfahren Sie mehr über das Aktualisieren von Verbindungen mit Hilfe von Ketten, indem Sie den nächsten Pfad durchlaufen: Refresh List of Connections!