CLP - Kör en fråga med en parameter – Supportcenter

Parametrar i Wdata Queries är det som gör Queries dynamiska och användbara över rapporteringsperioder. I denna Connected Learning Path kommer vi att ändra vår Query genom att lägga till en parameter, göra den dynamisk och sedan redigera vår Chain för att ta hänsyn till parametern. Sedan exporterar vi Query-resultaten till en Workiva Kalkylark.

Primärt användningsfall för verksamheten	Rapportering av data som lagras i Wdata
Primärt lärandemål	Exekvera en fråga med en parameter från en kedja
Sekundära inlärningsmål	Skapa en parameter i en fråga
Förkunskapskrav	Konfigurera Workiva Connector Fyll i CLP \| Skapa en fråga med ett beräknat fält Fyll i CLP \| Kör en fråga och exportera resultat Identifiera fråge-ID för CLP:s detaljfråga om anställda Valfritt - Identifiera URL:en till ett befintligt kalkylark som du vill skriva resultaten till
Mall för support	CLP \| Kör en fråga med en parameter

Steg 1: Redigera befintlig fråga

Först måste vi redigera vår CLP Employee Detail Query för att lägga till en parameter. Vi kommer att skapa en parameter som låter oss bestämma vilket land vi vill se det totala antalet anställda för.

Från Wdata öppnar du förfrågan CLP Employee Detail Query för att redigera den
- Följ anvisningarna på CLP | Skapa en fråga med ett beräknat fält för att skapa frågan
I panelen längst till höger klickar du på ikonen Parametrar

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å Ansök

- 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: Redigera befintlig kedja

Navigera till Chain Builder och leta reda på kedjan CLP | Kör en fråga och exportera resultat
Klicka på pennknappen för att redigera kedjan
Klicka på Kedjeinställningar längst upp till höger
- Byt namn på kedjan: CLP | Kör en fråga och med en parameter
Rädda kedjan

Steg 3: Inmatningar vid exekvering

Vi använder kedjehändelsen Runtime Inputs för att starta kedjan. Detta gör att vi kan fråga efter ID:t för den fråga som ska köras, värdet för dess parameter och URL:en för ett befintligt kalkylark att skriva resultaten till. Fältet URL för kalkylark är valfritt

Redigera kedjehändelsen för exekvering av ingångar genom att dubbelklicka på kommandot
Klicka på knappen Add Input och lägg till följande input:
- Typ av fält: Textfält
- Visa namn: Fråga Parametervärde
- Krävs: Kontrollerad
  - Om du vill kan du dra och släppa den här nya inmatningen så att den visas efter Query ID-ingången och före kalkylarkets URL-ingång
Spara kommandot

Steg 4: Kör förfrågan

För att kunna hämta de senaste uppgifterna måste Query först köras. När Query har körts framgångsrikt kan vi exportera Query-resultaten för att använda dem i rapporteringen längre fram eller för att skicka dem till andra externa system. Vi kommer att använda kommandot Run Query för att köra Wdata Query.

Dubbelklicka på kommandot Run Query för att konfigurera det
Klicka på knappen ADD i avsnittet Parametrar
- I fältet Name skriver du in namnet på Query Parameter, i det här fallet heter vår parameter Country
- I fältet Type väljer du Query Parameter Type, i det här fallet är vår parametertyp Text
- Klicka på fältet Värde
  - I den vänstra panelen Variabler klickar du på nedåtpilen för att expandera Trigger
  - Klicka på nedåtpilen för att expandera Exekvering Inputs
  - Klicka på Query Parameter Value
Spara kommandot

Steg 5: Testa övningen

Nu när kedjan är klar kan du testa resultatet.

Publicera kedjan
Klicka på Execute och välj sedan Run with Inputs
Lägg till värden för dina ingångar för exekvering
- Query ID - ID för CLP Employee Detail Query i Wdata
  - Kolla in det här dokumentet för att få hjälp med att hitta ID
- Query Parameter Value - det värde som du vill att din Query ska filtrera till
  - I det här exemplet filtrerar vi data till Brazil
- URL till kalkylark - fullständig URL till det kalkylark som du vill exportera resultaten till
När kedjan har slutförts, visa kalkylarket för att verifiera resultaten
- Kedjan bör ha kört frågan och exporterat resultaten till kalkylarket
- Du kan verifiera att data exporterades till kalkylarket och filtrerades korrekt genom att navigera till arkets URL

Om du vill veta mer om hur du använder kedjor för att effektivisera datacentralisering, kolla in resten av Datainsamlingsvägar!

Support

Community

Workiva supportcenter