För att göra våra Connections användbara kvartal för kvartal och år för år utan att behöva göra justeringar i Query, är det nödvändigt att använda parametrar. I denna Connected Learning Path lär vi oss hur vi uppdaterar vår Chain för att uppdatera en anslutning med en parameter mellan Workiva Platform och en Wdata Query med hjälp av Connection ID.
| Primärt användningsfall för verksamheten | Datakonnektivitet mellan Workiva och Wdata |
| Primärt lärandemål | Lär dig hur du uppdaterar en anslutning med en parameter och anger parametervärdet vid körning av kedjan |
| Förkunskapskrav |
Konfigurera Workiva Connector Slutför CLP | Uppdatera anslutningen med hjälp av ID Ge behörighet till kalkylarket för den associerade Workiva OAuth Grant User |
| Mall för support | CLP | Uppdatera anslutningar med en parameter |
Steg 1: Kopiera befintlig fråga
Först behöver vi en Query med en parameter. Vi kommer att skapa en kopia av vår befintliga Query och lägga till en parameter som låter oss bestämma vilket land vi vill se det totala antalet anställda för.
- Från Wdata Home, leta reda på Query CLP Employee Detail Query och öppna menyn
- Välj kopia
- Uppdatera frågans namn till CLP Employee Detail by Country Query
- Klicka på Save Query
- Klicka på ikonen Parameters längst till höger på skärmen för redigering av Query
- Klicka på Add Parameters och välj Create New Parameter
- Namnge parametern: Land
- Byt till för att aktivera plocklistan
- I rutan List Options listar du följande länder, varje land på en egen rad:
- Australien
- Brasilien
- Italien
- Kenya
- USA
- Uppdatera standardvärdet till None
- Klicka på Skapa
- För att parametern ska kunna styra resultatet av vår Query måste vi koppla parametern till kolumnen i källdata med hjälp av filter. Navigera till fliken Filter i Query.
- Leta reda på kolumnen Country från källdata till vänster och klicka och dra den till filterområdet på vänster sida
- Klicka på filtervärdet, där det står Empty String, för att fylla i filtervärdet
- Till höger om fältet för filtervärde klickar du på knappen Parametrar
- Välj Land
- Klicka på Apply
-
- Du har nu en fråga med en parameter för land, när du klickar på Kör fråga kommer du att bli tillfrågad vilket land du vill att dina frågeresultat ska visa
- Klicka på Spara
Steg 2: Skapa en inkommande anslutning
För att lära oss hur man uppdaterar en anslutning med hjälp av en kedja måste vi först upprätta en anslutning mellan en Wdata Query och en kalkylark.
- Navigera till CLP Employee Overview Kalkylark
- Lägg till ett nytt ark genom att klicka på
- Byt namn på CLP Anställningsuppgifter per land
- Lägg till en inkommande anslutning på arket CLP Employee Details by Country:
- Öppna panelen Connections till höger genom att klicka på ikonen Connections
- På fliken Inkommande anslutningar väljer du Lägg till anslutning
- Välj Wdata Query
- Välj CLP Employee Detail by Country Query
- Ställ in Country Parameter på Australia
- Klicka på Connect
- Öppna panelen Connections till höger genom att klicka på ikonen Connections
- Det finns nu två ark med inkommande anslutningar i kalkylarket för CLP-medarbetaröversikt
Steg 3: Redigera befintlig kedja
- Navigera till Chain Builder och leta reda på kedjan CLP | Uppdatera anslutning med ID
- Klicka på pennknappen för att redigera kedjan
- Klicka på Kedjeinställningar längst upp till höger
- Byt namn på kedjan: CLP | Uppdatera anslutningar med en parameter
- Rädda kedjan
Steg 4: 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 vilken Connection vi vill uppdatera vid Chain run time samt vilken Parameter vi vill uppdatera värdet för.
- Redigera kedjehändelsen för exekvering av ingångar genom att dubbelklicka på kommandot
- Klicka två gånger på knappen Add Input och lägg till följande ingångar:
- Ingång 1:
- Typ av fält: Textfält
- Visa namn: Parameterns namn
- Obligatoriskt: Ej markerad
- Ingång 2:
- Typ av fält: Textfält
- Visa namn: Parametervärde
- Obligatoriskt: Ej markerad
- Ingång 1:
- Spara kommandot
Steg 5: Uppdatera anslutningen
För att ta hänsyn till den tillagda parametern måste vi uppdatera kommandot Refresh Connections för att ta hänsyn till den parameter och det värde som ska skickas vidare till Query.
- Redigera Refresh Connection genom att dubbelklicka på kommandot
- Anslutnings-ID: Fortsätt att använda Connection ID variabeln från Exekvering Inputs
- Lägg till en parameter
- Eftersom våra parametrar sparas vid källan (i Query), vill vi fylla i parametrarna vid källan. Klicka på knappen bredvid Källparametrar
- Parameternamn: Använd variabeln Parameter Name från Runtime Inputs - detta gör att vi kan skicka värdet för parameternamnet som anges vid exekveringen av kedjan till kommandot Refresh Connections
- Klicka på fältet Parameternamn
- Expandera rullgardinsmenyn Trigger i den vänstra panelen
- Expandera rullgardinsmenyn Inmatningar för exekvering
- Välj Parameternamn variabel
- Parametervärde: Använd variabeln Parameter Value från Runtime Inputs - detta gör att vi kan skicka det parametervärde som anges vid exekveringen av kedjan till kommandot Refresh Connections
- Klicka på fältet Parameternamn
- Expandera rullgardinsmenyn Trigger i den vänstra panelen
- Expandera rullgardinsmenyn Inmatningar för exekvering
- Välj Parametervärde variabel
- Spara kommandot
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 Connection ID
- Navigera till kalkylarket CLP Employee Overview
- I panelen Anslutningar letar du upp CLP Employee Detail by Country Query Connection och klickar på uppåtpilen. När rullgardinsmenyn visas väljer du View Properties
- Kopiera Connection ID - se till att du inte missar några tecken eller lägger till några mellanslag
- Navigera tillbaka till Chain Builder och klistra in anslutnings-ID:t i Connection ID Exekvering
- Fyll i parameterns ingångar
- Parameternamn: namnet på parametern i förfrågan - i den här övningen är parameternamnet Land
- Parametervärde: det värde som frågan måste filtreras på - i den här övningen filtrerar vi till Brazil
- Obs: Om du väljer ett annat parametervärde än det som redan finns lagrat i kalkylarket skrivs kalkylarket över, och vi ser att våra data ändras från Australien till Brasilien.
- Klicka på Start
- När kedjan har slutförts, navigera tillbaka till kalkylarket och se att anslutningen har uppdaterats framgångsrikt!
Framgångsrik kedjekörning:
Framgångsrik Uppdatering av anslutning:
Läs mer om hur du uppdaterar Connections med hjälp av Chains genom att slutföra nästa sökväg: Uppdatera listan över anslutningar!