Att automatisera uppdateringar av anslutningar är viktigt för att effektivisera centralisering och överföring av data till Workiva Platform, särskilt när det finns flera anslutningar. I denna Connected Learning Path lär vi oss hur man skapar en kedja som uppdaterar en lista över anslutningar mellan Wdata och Workiva Platform med hjälp av ett ID för en kalkylark. Denna kedja genererar en lista över anslutningar på ett enda kalkylark och ger oss sedan ID-listan över dessa anslutningar, så att vi kan automatisera uppdateringen av varje anslutning i kalkylarket.
| Primärt användningsfall för verksamheten | Datakonnektivitet mellan Workiva och Wdata |
| Primärt lärandemål | Lär dig hur du uppdaterar en lista över Connections med hjälp av Chains |
| Sekundära inlärningsmål | Lär dig grunderna i Group Iterators |
| Förkunskapskrav |
Slutför CLP | Uppdatera anslutningar med en parameter Ge behörighet till kalkylarket för den associerade OAuth Grant User |
| Mall för support | CLP | Uppdatera listan över anslutningar |
Steg 1: Skapa en kedja
- Lägg till en ny Kedja
- Namnge kedjan: CLP | Uppdatera listan över anslutningar
- Rädda kedjan
Steg 2: Inmatningar för exekvering
Vi använder kommandot Exekvering av ingångar för att starta kedjan. Detta gör det möjligt för oss att ange vilket kalkylark vi vill uppdatera alla anslutningar för.
- Lägg till en Exekvering Ingångar Kedjehändelse från kedjeutlösande händelser Startnoden
- Redigera kedjehändelsen för exekvering av ingångar genom att dubbelklicka på kommandot
- Typ av fält: Textfält
- Visa namn: ID för kalkylark
- Krävs: Kontrollerad
- Spara kommandot
Steg 3: Lista anslutningar
Vi kommer att använda kommandot List Connections för att hämta listan över Connection ID:n som är associerade med kalkylarkets ID. Utdata från kommandot List Connections blir en JSON-fil som består av varje Connection i kalkylarket med information om Connection, inklusive Connection ID.
- Lägg till en List Connections Command från Workiva Connector till Chain canvas
- Anslut Exekvering Inmatningar Kommando till Listanslutningar Kommando
- Dubbelklicka på kommandot för att konfigurera det
- Mål Typ: Kalkylark
- Mål ID: Använd variabeln ID för kalkylark från Runtime Inputs - detta gör att vi kan skicka det värde som anges vid exekvering av kedjan till kommandot Refresh Connections
- Klicka på fältet Destination ID
- I den vänstra panelen expanderar du rullgardinsmenyn Trigger
- Expandera rullgardinsmenyn Inmatningar för exekvering
- Välj variabeln ID för kalkylark
- Spara kommandot
Steg 4: Kommandogrupp
Vi kommer att använda en Command Group för att möjliggöra iteration över varje Connection. Group Iterator kommer att driva varje Connection på kalkylarket genom följande steg, ett efter ett.
- Lägg till en Command Group till Chain canvas
- Anslut Listanslutningar Command till I avsnitt i Command Group
- Dubbelklicka på kommandot för att konfigurera det
- Namnge gruppen: Anslutningar Iteration
- Navigera till fliken Iteratorer
- Aktivera växlingsknappen Iterations och klicka på fältet Iterations
- I panelen Välj en variabel klickar du på nedåtpilen för att expandera Lista anslutningar
- Välj Anslutningar utdata
- Aktivera växlingsknappen Iterations och klicka på fältet Iterations
- Spara kommandogruppen
Steg 5: Uppdatera anslutningen
Vi kommer att använda kommandot Refresh Connection för att uppdatera våra Connections med hjälp av Connection ID från iterationen.
- Lägg till en Refresh Connection Command från Workiva Connector till Chain canvas
- Anslut avsnittet Starta från Group Iterator till Uppdatera anslutning Kommando
- Dubbelklicka på kommandot för att konfigurera det
- Connection ID: använd Connection ID från Group iterator - Connections Iteration. Detta gör att vi kan skicka ID:t för den aktuella iterationen vidare till Refresh Connections Command
- Klicka på fältet Connection ID
- I den vänstra panelen expanderar du rullgardinsmenyn Group Iterator
- Expandera rullgardinsmenyn Connections Iteration
- Välj variabeln ConnectionId
- Använd tidigare källparametrar: Markerad
- Detta gör att vi kan uppdatera en anslutning med hjälp av de tidigare parametervärdena från källan - i vårt fall kommer frågan med parametern Country fortfarande att uppdateras med Brasilien som filtervärde
- Connection ID: använd Connection ID från Group iterator - Connections Iteration. Detta gör att vi kan skicka ID:t för den aktuella iterationen vidare till Refresh Connections Command
Steg 6: Testa övningen
Nu när kedjan är klar kan du testa resultatet
- Publicera kedjan
- Klicka på Execute och välj sedan Run With Inputs
- Hitta ID för kalkylarket
- Navigera till kalkylarket CLP Employee Overview
- I URL:en väljer du kalkylarkets ID, som finns efter "spreadsheet/" och före "/sheet".
- Till exempel är kalkylarkets ID fetmarkerat här: app.wdesk.com/a/QWNjb3VudB8yMDkwNzExMDQ0/spreadsheet/de9a4ab1374f4d438c9585a94dd9acf4/-1/sheet/3161ee0402ec4b9fa4e937e6f0f63b13
- Gå tillbaka till Chain Builder och klistra in kalkylarkets ID i fältet Spreadsheet ID
- Klicka på Start
- När kedjan har slutförts, navigera tillbaka till kalkylarket och se att båda anslutningarna har uppdaterats framgångsrikt!
Framgångsrik Chain Run med två iterationer:
Framgångsrik Uppdatering av anslutning:
Om du vill veta mer om hur du använder kedjor för att effektivisera datainsamlingen kan du kolla in resten av Data Centralization Paths!