Het automatiseren van het verversen van verbindingen is essentieel voor het stroomlijnen van het centraliseren en verplaatsen van gegevens naar het Workiva Platform, vooral wanneer er meerdere verbindingen bestaan. In dit Aangesloten Leerpad leren we hoe we een Ketting kunnen maken die een lijst van Verbindingen tussen Wdata en het Workiva Platform vernieuwt met behulp van een Spreadsheet ID. Deze Chain genereert een lijst met Verbindingen op een enkel Spreadsheet en geeft ons vervolgens de lijst met ID's van die Verbindingen, zodat we het verversen van elke Verbinding in het Spreadsheet kunnen automatiseren.
| Primaire zakelijke gebruikssituatie | Gegevensconnectiviteit tussen Workiva en Wdata |
| Primair leerdoel | Leer hoe u een lijst met verbindingen kunt vernieuwen met behulp van Chains |
| Secundaire leerdoelen | Leer de essentie van groepsinteratoren |
| Vereisten |
Workiva Connector configureren Voltooi de CLP | Verbindingen vernieuwen met een parameter Geef rechten aan het werkblad voor de bijbehorende OAuth-subsidiegebruiker |
| Ondersteunende sjabloon | CLP | Lijst met verbindingen vernieuwen |
Stap 1: Maak een ketting
- Een nieuwe Ketting toevoegen
- Geef de Chain een naam: CLP | Lijst met verbindingen vernieuwen
- Red de Ketting
Stap 2: Runtime-ingangen
We gebruiken het commando Runtime Inputs om de Chain te starten. Hiermee kunnen we aangeven voor welke werkblad we alle Verbindingen willen verversen.
- Voeg een Runtime Inputs Chain Event toe van Chain Trigger Events het Startknooppunt
- Bewerk de gebeurtenis van de Runtime Inputs Chain door te dubbelklikken op de opdracht
- Type: Tekstveld
- Naam weergeven: Spreadsheet-ID
- Vereist: Aangevinkt
- De opdracht opslaan
Stap 3: Verbindingen weergeven
We zullen de opdracht List Connections gebruiken om de lijst met verbindings-ID's op te halen die aan de werkblad-ID zijn gekoppeld. De uitvoer van de opdracht List Connections is een JSON-bestand dat bestaat uit elke verbinding in het werkblad met details over de verbinding, inclusief de verbindings-ID.
- Voeg een Lijst Verbindingen commando van de Workiva Connector toe aan het Chain canvas
- Verbind de opdracht Runtime-ingangen met de opdracht Lijstverbindingen
- Dubbelklik op de opdracht om deze te configureren
- Type bestemming: Spreadsheet
- Bestemmings-ID: Gebruik de variabele Spreadsheet ID van Runtime Inputs - hiermee kunnen we de waarde die is opgegeven tijdens het uitvoeren van de ketting doorsturen naar de opdracht Refresh Connections
- Klik op het veld Bestemmings-ID
- Vouw in het linkerpaneel de vervolgkeuzelijst Trigger uit
- Vouw de vervolgkeuzelijst Runtime Inputs uit
- Selecteer de variabele Spreadsheet ID
- De opdracht opslaan
Stap 4: Opdrachtgroep
We zullen een Command Group gebruiken om iteratie over elke Verbinding mogelijk te maken. De Group Iterator zal elke Verbinding op het Spreadsheet één voor één door de volgende stappen duwen.
- Voeg een Commandogroep toe aan het Chain canvas
- Verbind de opdracht Lijstverbindingen met het gedeelte In van de opdrachtgroep
- Dubbelklik op de opdracht om deze te configureren
- Geef de groep een naam: Verbindingen Iteratie
- Navigeer naar het tabblad Iterators
- Schakel de optie Iteraties in en klik op het veld Iteraties
- Klik in het paneel Een variabele selecteren op de pijl omlaag om Lijstverbindingen uit te vouwen
- Selecteer de uitgang Connections
- Schakel de optie Iteraties in en klik op het veld Iteraties
- De commandogroep opslaan
Stap 5: Verbinding vernieuwen
We zullen de opdracht Verbinding verversen gebruiken om onze Verbindingen te verversen met behulp van de Verbindings-ID van de iteratie.
- Voeg een Verbinding verversen commando toe van de Workiva Connector aan het Chain canvas
- Verbind de sectie Start van de Groep Iterator met de opdracht Verbinding verversen
- Dubbelklik op de opdracht om deze te configureren
- Verbindings-ID: gebruik de Verbindings-ID van de Groep iterator - Verbindingen Iteratie. Hierdoor kunnen we de ID voor de huidige iteratie doorsturen naar de opdracht Verbindingen vernieuwen
- Klik op het veld Verbindings-ID
- Vouw in het linkerpaneel de vervolgkeuzelijst Group Iterator uit
- Vouw de vervolgkeuzelijst Connections Iteration uit
- Selecteer de variabele ConnectionId
- Vorige bronparameters gebruiken: Aangevinkt
- Hierdoor kunnen we een Verbinding verversen met behulp van de vorige parameterwaarden van de Bron - in ons geval zal de Query met de parameter Land nog steeds verversen met Brazilië als de filterwaarde
- Verbindings-ID: gebruik de Verbindings-ID van de Groep iterator - Verbindingen Iteratie. Hierdoor kunnen we de ID voor de huidige iteratie doorsturen naar de opdracht Verbindingen vernieuwen
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
- De werkblad-ID vinden
- Navigeer naar de CLP Werknemersoverzicht spreadsheet
- Selecteer in de URL de Spreadsheet-ID, die te vinden is na "spreadsheet/" en voor "/sheet".
- De ID van het werkblad is hier bijvoorbeeld vetgedrukt: app.wdesk.com/a/QWNjb3VudB8yMDkwNzExMDQ0/spreadsheet/de9a4ab1374f4d438c9585a94dd9acf4/-1/sheet/3161ee0402ec4b9fa4e937e6f0f63b13
- Navigeer terug naar Chain Builder en plak de Spreadsheet-ID in het veld Spreadsheet-ID
- Klik op Starten
- Zodra de ketting voltooid is, navigeert u terug naar de spreadsheet en ziet u dat beide Verbindingen met succes ververst zijn!
Succesvolle Chain Run met twee iteraties:
Verbinding met succes vernieuwd:
Als u meer wilt weten over het gebruik van Chains om het verzamelen van gegevens te stroomlijnen, bekijk dan de rest van de Data Centralization Paths!