Parameter in Wdata-Queries machen Queries dynamisch und über Berichtszeiträume hinweg nutzbar. In diesem Connected Learning Path werden wir unsere Abfrage ändern, indem wir einen Parameter hinzufügen und sie dynamisch machen, und dann unsere Kette bearbeiten, um den Parameter zu berücksichtigen. Dann exportieren wir die Abfrageergebnisse in ein Workiva Spreadsheet.
| Primärer geschäftlicher Anwendungsfall | Berichterstattung über in Wdata gespeicherte Daten |
| Primäres Lernziel | Ausführen einer Abfrage mit einem Parameter aus einer Kette |
| Sekundäre Lernziele | Erstellen eines Parameters in einer Abfrage |
| Voraussetzungen |
Workiva Connector konfigurieren Vervollständigen Sie das CLP | Erstellen einer Abfrage mit einem berechneten Feld Vervollständigen Sie das CLP | Führen Sie eine Abfrage aus und exportieren Sie die Ergebnisse Identifizieren Sie die Abfrage-ID der CLP-Detailabfrage für MitarbeiterOptional - Geben Sie die URL einer vorhandenen Kalkulationstabelle an, in die die Ergebnisse geschrieben werden sollen. |
| Unterstützende Vorlage | CLP | Ausführen einer Abfrage mit einem Parameter |
Schritt 1: Vorhandene Abfrage bearbeiten
Zunächst müssen wir unsere CLP-Abfrage für Mitarbeiterdetails bearbeiten, um einen Parameter hinzuzufügen. Wir werden einen Parameter erstellen, mit dem wir entscheiden können, für welches Land wir die Gesamtzahl der Mitarbeiter sehen wollen.
- Öffnen Sie in Wdata die Abfrage CLP Employee Detail Query, um sie zu bearbeiten.
- Befolgen Sie die Anweisungen unter CLP | Erstellen einer Abfrage mit einem berechneten Feld, um die Abfrage zu erstellen.
- Klicken Sie in der rechten Leiste auf das Symbol Parameter
- Klicken Sie auf Add Parameters und wählen Sie Create New Parameter
- Benennen Sie den Parameter: Land
- Schalten Sie die Auswahlliste auf aktiviert um.
- Geben Sie im Feld Listenoptionen die folgenden Länder an, jedes Land in einer eigenen Zeile:
- Australien
- Brasilien
- Italien
- Kenia
- USA
- 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 Empty String steht, um den Filterwert zu füllen.
- Klicken Sie rechts neben dem Feld für den Filterwert auf die Schaltfläche Parameter
- Wählen Sie Land
- Klicken Sie auf Übernehmen
-
- 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: Vorhandene Kette bearbeiten
- Navigieren Sie zum Chain Builder und suchen Sie die Kette CLP | Run a Query and Export Results
- Klicken Sie auf die Bleistift-Schaltfläche, um die Kette zu bearbeiten
- Klicken Sie oben rechts auf Ketteneinstellungen
- Benennen Sie die Kette um: CLP | Eine Abfrage ausführen und mit einem Parameter
- Rettet die Kette
Schritt 3: Laufzeit-Eingaben
Wir verwenden das Runtime Inputs Chain Event, um die Kette zu starten. So können wir nach der ID der auszuführenden Abfrage, dem Wert ihres Parameters und der URL eines vorhandenen Rechenblatts fragen, in das die Ergebnisse geschrieben werden sollen. Das Feld Spreadsheet URL ist optional; wenn es leer gelassen wird, wird ein neues Tabellenblatt erstellt.
- Bearbeiten Sie das Runtime Inputs Chain Event durch Doppelklick auf den Command
- Klicken Sie auf die Schaltfläche Eingabe hinzufügen und fügen Sie die folgende Eingabe hinzu:
- Typ: TextField
- Name anzeigen: Abfrage Parameterwert
- Erforderlich: Abgehakt
- Optional können Sie diese neue Eingabe per Drag & Drop so verschieben, dass sie nach der Eingabe der Abfrage-ID und vor der Eingabe der Tabellenkalkulations-URL erscheint
- Speichern Sie den Befehl
Schritt 4: Abfrage ausführen
Um die aktuellsten Daten abzurufen, muss die Abfrage zuerst ausgeführt werden. Sobald die Abfrage erfolgreich ausgeführt wurde, können wir die Abfrageergebnisse exportieren, um sie für spätere Berichte zu verwenden oder an andere externe Systeme zu senden. Wir werden den Befehl Abfrage ausführen verwenden, um die Wdata-Abfrage auszuführen.
- Doppelklicken Sie auf den Befehl Abfrage ausführen, um ihn zu konfigurieren
- Klicken Sie im Bereich Parameter auf die Schaltfläche ADD
- Geben Sie in das Feld Name den Namen des Abfrageparameters ein, in diesem Fall heißt unser Parameter Land
- Wählen Sie im Feld Typ den Abfrageparametertyp, in diesem Fall ist unser Parametertyp Text
- Klicken Sie auf das Feld Wert
- Klicken Sie im linken Bereich Variablen auf den Pfeil nach unten, um Auslöser zu erweitern
- Klicken Sie auf den Pfeil nach unten, um Runtime Inputs zu erweitern.
- Klicken Sie auf Abfrage Parameterwert
- Speichern Sie den Befehl
Schritt 5: Testen Sie die Übung
Testen Sie nun, nachdem die Kette vollständig ist, das Ergebnis.
- Veröffentlichen Sie die Kette
- Klicken Sie auf Execute und wählen Sie dann Run with Inputs
- Fügen Sie Werte für Ihre Laufzeiteingaben hinzu
- Abfrage-ID - ID der CLP-Mitarbeiter-Detailabfrage in Wdata
- Abfrageparameterwert - der Wert, nach dem Sie Ihre Abfrage filtern möchten
- In diesem Beispiel filtern wir die Daten nach Brasilien.
- Tabellenkalkulations-URL - vollständige URL der Tabellenkalkulation, in die Sie die Abfrageergebnisse exportieren möchten
- Wenn die Kette erfolgreich abgeschlossen wurde, können Sie die Ergebnisse in der Tabelle überprüfen.
- Die Kette sollte die Abfrage erfolgreich ausgeführt und die Ergebnisse in die Tabellenkalkulation exportiert haben
- Sie können überprüfen, ob die Daten in Ihre Tabellenkalkulation exportiert und korrekt gefiltert wurden, indem Sie zur URL der Tabelle navigieren
Wenn Sie mehr über die Verwendung von Chains zur Rationalisierung der Datenzentralisierung erfahren möchten, lesen Sie den Rest des Data Collection Paths!