Om onze Verbindingen kwartaal na kwartaal en jaar na jaar bruikbaar te maken zonder de Query aan te passen, is het nodig om Parameters te gebruiken. In dit Connected Leerpad leren we hoe we onze Chain kunnen bijwerken om een verbinding met een parameter tussen het Workiva Platform en een Wdata Query te vernieuwen met behulp van de Connection ID.
| Primaire zakelijke gebruikssituatie | Gegevensconnectiviteit tussen Workiva en Wdata |
| Primair leerdoel | Leer hoe u een Verbinding met een Parameter kunt vernieuwen, door de Parameterwaarde in te stellen tijdens het uitvoeren van de Ketting |
| Vereisten |
Workiva Connector configureren Voltooi de CLP | Verbinding vernieuwen met ID Geef rechten aan het werkblad voor de bijbehorende Workiva OAuth Grant Gebruiker |
| Ondersteunende sjabloon | CLP | Verbindingen vernieuwen met een parameter |
Stap 1: Kopieer bestaande query
Eerst hebben we een Query met een Parameter nodig. We maken een kopie van onze bestaande Query en voegen een Parameter toe waarmee we kunnen bepalen voor welk Land we het totale aantal werknemers willen zien.
- Ga vanuit Wdata Home naar de Query CLP Employee Detail Query en open het menu
- Kopiëren selecteren
- Werk de Query Naam bij naar CLP Werknemer Detail per Land Query
- Klik op Query opslaan
- Klik in het scherm Query bewerken op het pictogram Parameters uiterst rechts
- Klik op Parameters toevoegen en selecteer Nieuwe parameter aanmaken
- Geef de Parameter een naam: Land
- Zet de keuzelijst op ingeschakeld
- Maak in het vak Lijstopties een lijst van de volgende Landen, elk Land op een eigen regel:
- Australië
- Brazilië
- Italië
- Kenia
- Verenigde Staten
- Werk de standaardinstelling bij naar Geen
- Klik op Maken
- Om de Parameter de resultaten van onze Query te laten bepalen, moeten we de Parameter koppelen aan de kolom in de brongegevens met behulp van Filters. Navigeer naar het tabblad Filters in de Query.
- Zoek de kolom Land in de brongegevens aan de linkerkant en klik en sleep deze naar het filtergebied aan de linkerkant
- Klik op de filterwaarde, waar staat Lege tekenreeks, om de filterwaarde in te vullen
- Klik rechts van het filterwaardeveld op de parametertoets
- Selecteer Land
- Klik op Toepassen
-
- U hebt nu een Query met een parameter voor Land. Wanneer u op Query uitvoeren klikt, wordt u gevraagd welk Land u in de resultaten van uw Query wilt weergeven
- Klik op Opslaan
Stap 2: Een inkomende verbinding maken
Om te leren hoe u een Verbinding kunt vernieuwen met behulp van een Ketting, moeten we eerst een verbinding tot stand brengen tussen een Wdata Query en een Spreadsheet.
- Navigeer naar het CLP-werknemersoverzicht werkblad
- Voeg een nieuw blad toe door op
- Hernoem het naar CLP-werknemersgegevens per land
- Voeg een Inkomende Verbinding toe aan het blad CLP-werknemergegevens per land:
- Open het paneel Verbindingen aan de rechterkant door op het pictogram Verbindingen te klikken
- Op het tabblad Inkomende verbindingen selecteert u Verbinding toevoegen
- Selecteer Wdata Query
- Selecteer de query CLP Werknemergegevens per land
- Stel de landenparameter in op Australië
- Klik op Verbinden
- Open het paneel Verbindingen aan de rechterkant door op het pictogram Verbindingen te klikken
- Er zijn nu twee bladen met Inkomende verbindingen in het CLP Werknemersoverzicht werkblad
Stap 3: Bestaande ketting bewerken
- Navigeer naar Chain Builder en zoek de Chain CLP | Verbinding vernieuwen met ID
- Klik op de potloodknop om de ketting te bewerken
- Klik op Keteninstellingen in de rechterbovenhoek
- Hernoem de ketting: CLP | Verbindingen verversen met een parameter
- Red de Ketting
Stap 4: Runtime-ingangen
We gebruiken het commando Runtime Inputs om de Chain te starten. Hiermee kunnen we aangeven welke Verbinding we willen verversen tijdens het uitvoeren van de Ketting, en voor welke Parameter we de waarde willen verversen.
- Bewerk de gebeurtenis van de Runtime Inputs Chain door te dubbelklikken op de opdracht
- Klik tweemaal op de knop Add Input en voeg de volgende ingangen toe:
- Ingang 1:
- Type: Tekstveld
- Weergavenaam: Parameter Naam
- Vereist: Niet aangevinkt
- Ingang 2:
- Type: Tekstveld
- Weergavenaam: Parameter Waarde
- Vereist: Niet aangevinkt
- Ingang 1:
- De opdracht opslaan
Stap 5: Verbinding vernieuwen
Om rekening te houden met de toegevoegde parameter, moeten we het commando Verbindingen vernieuwen bijwerken om rekening te houden met de parameter en waarde die naar de query moeten worden doorgestuurd.
- Bewerk de Verbinding verversen door te dubbelklikken op de opdracht
- Verbindings-ID: Blijf de Connection ID variabele van Runtime Inputs gebruiken
- Een parameter toevoegen
- Aangezien onze Parameters bij de bron (in de Query) worden opgeslagen, willen we de Parameters bij de bron invullen. Klik op de knop + naast Bronparameters
- Parameter Name: Gebruik de variabele Parameter Name van Runtime Inputs - hiermee kunnen we de waarde van de Parameter Name die tijdens het uitvoeren van de keten is opgegeven, doorsturen naar het Refresh Connections-commando
- Klik op het veld Parameter Name
- Vouw in het linkerpaneel de vervolgkeuzelijst Trigger uit
- Vouw de vervolgkeuzelijst Runtime Inputs uit
- Selecteer de variabele Parameter Name
- Parameterwaarde: Gebruik de variabele Parameter Value van Runtime Inputs - hiermee kunnen we de parameterwaarde die is opgegeven tijdens het uitvoeren van de keten, doorsturen naar het Refresh Connections-commando
- Klik op het veld Parameter Name
- Vouw in het linkerpaneel de vervolgkeuzelijst Trigger uit
- Vouw de vervolgkeuzelijst Runtime Inputs uit
- Selecteer de variabele Parameterwaarde
- De opdracht opslaan
Stap 6: De oefening testen
Nu de Chain compleet is, kunt u het resultaat testen
- Publiceer de keten
- Klik op Uitvoeren en selecteer vervolgens Uitvoeren met ingangen
- Zoek de verbindings-ID
- Navigeer naar de CLP Werknemersoverzicht spreadsheet
- Zoek in het paneel Verbindingen de CLP Employee Detail by Country Query Connection en klik op de pijl omhoog. Zodra de vervolgkeuzelijst verschijnt, selecteert u Eigenschappen bekijken
- Kopieer de verbindings-ID - zorg ervoor dat u geen tekens mist of spaties toevoegt
- Navigeer terug naar Chain Builder en plak de Connection ID in de Connection ID Runtime Input
- Vul de Parameter-ingangen
- Parameter Naam: de naam van de Parameter in de Query - in deze oefening is de Parameter naam Land
- Parameterwaarde: de waarde waarop de Query moet worden gefilterd - in deze oefening filteren we op Brazilië
- Opmerking: Als u een andere parameterwaarde selecteert dan wat al in de spreadsheet is opgeslagen, wordt de spreadsheet overschreven; we zullen onze gegevens zien veranderen van Australië in Brazilië.
- Klik op Starten
- Zodra de ketting voltooid is, navigeert u terug naar de spreadsheet en ziet u dat de verbinding met succes ververst is!
Succesvolle kettingloop:
Verbinding met succes vernieuwd:
Leer meer over het verversen van Verbindingen met behulp van Ketens door het volgende pad te voltooien: Vernieuw de lijst met verbindingen!