CLP - Skapa och läsa en kontrollark – Supportcenter

Att använda ark med kontroller är det mest effektiva sättet att lagra olika variabler som används för ett enda arbetsflöde. Kontrollark är värdefulla för att ge slutanvändare möjlighet att ange indata för en kedja utan att behöva redigera själva kedjan. För att kunna använda ett kontrollblad måste vi först förstå hur man strukturerar ett kontrollblad och hur man läser data från kontrollbladet. I denna Connected Learning Path kommer vi att skapa en kontrollark och använda ett Workiva-kommando för att hämta data från kontrollarket.

Primärt användningsfall för verksamheten	Orkestrering av rapporteringsarbetsflöden från en central plats Förenklad arbetsflödeshantering för slutanvändare
Primärt lärandemål	Lär dig hur du strukturerar ett kontrollark och hämtar data från ett kontrollark med hjälp av kedjor
Förkunskapskrav	Konfigurera Workiva Connector Slutför CLP \| Överföra data till en tabellväg Slutför CLP \| Uppdatera listan över anslutningar Ge behörighet till kalkylarket för den associerade användaren av Workiva API Grant
Mall för support	CLP \| Avläsning från en kontrollark

Steg 1: Skapa ett kontrollark

Vi kommer att skapa ett kontrollark för att lagra variabler som används för att ladda upp data till en Wdata-tabell och sedan uppdatera anslutningarna för dessa data. I stället för att ange dessa variabler som Runtime Inputs varje gång kedjan körs, lägger vi till våra variabler i ett ark som kedjan kommer att läsa och använda under hela exekveringen.

Detta kontrollark visar hur man laddar upp flera filer till en enda Wdata-tabell och uppdaterar anslutningar i ett enda kalkylark, men processen kan utökas till att omfatta flera tabeller och kalkylark genom att helt enkelt lägga till det unika ID:t för tabellen eller kalkylarket i kontrollarket.

Navigera till Workiva Platform för att skapa ett nytt kalkylark
Klicka på Skapa och välj Kalkylark
Namnge kalkylarket: CLP kontroll ark
- Namnge det första arket: Ark för primär kontroll
I det primära kontrollarket skapar du följande rubriker
- AktivFlagga
  - Denna kolumn anger om arbetsflödet behöver köras för den raden i arket
- Filnamn
  - Denna kolumn anger namnet på datasetet som det kommer att visas i Wdata-tabellen
- TabellID
  - ID för den tabell i Wdata där data kommer att laddas upp
- KalkylbladID
  - ID för den kalkylark där data kommer att uppdateras
- Filplacering
  - Plats för den fil som ska laddas ner
Fyll i arket med följande värden, genom att fylla i <TableID> kolumnen med ID för CLP Employee Detail Table och <SpreadsheetID> kolumnen med ID för CLP Employee Overview kalkylark, dessa ID skapades i tidigare Connected Learning Paths, se förutsättningarna för att se de nödvändiga Connected Learning Paths.
- Kolla in det här dokumentet för att få hjälp med att hitta ID:n

ActiveFlag,FileName,TableID,FileLocation
TRUE,EmployeeDetailsP01,<TableID>,<SpreadsheetID>,https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail_P01.csv
TRUE,EmployeeDetailsP02,<TableID>,<SpreadsheetID>,https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail_P02.csv
TRUE,EmployeeDetailsP03,<TableID>,<SpreadsheetID>,https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail_P03.csv

Steg 2: Uppdatera behörigheter för kalkylark

För att säkerställa en effektiv kommunikation mellan ett Workiva-kommando och ett kalkylark måste API Beviljande som genereras associeras med en användare som har behörighet som ägare eller redaktör för kalkylarket.

Från CLP Control Sheet Kalkylark, klicka på File i menyfliksområdet längst upp
Klicka på Behörigheter, sedan Kalkylark
- Ge åtkomst till den Workiva-användare som är associerad med det konfigurerade API-tillståndet inom Workiva Connection

image (7).png

Steg 3: Skapa en kedja

För att använda variablerna som vi skapade i arket skapar vi en kedja som läser från den. Eftersom vi alltid kommer att använda samma kalkylark och ark kommer vi att skapa kedjevariabler för att lagra dessa detaljer för konsekvent åtkomst.

Navigera till Chain Builder
Skapa en ny Chain
- Namnge kedjan: CLP | Läser från en kontroll ark
Under Chain Variables, klicka på plustecknet två gånger för att skapa två Chain Variables och konfigurera dem enligt nedan:
- Variabel 1:
  - typ: Kedja variabel (cv)
  - Namn: cv-Kontroll av kalkylark ID
  - Värde: ange ID för kalkylarket för CLP-kontroll
    - För att hitta kalkylarkets ID, navigera till CLP Control Sheet Spreadsheet
      - I URL:en väljer du ID för kalkylarket, som finns efter "spreadsheet/" och före "/sheet"
      - Till exempel är kalkylarkets ID fetmarkerat här: app.wdesk.com/a/QWNjb3VudB8yMDkwNzExMDQ0/spreadsheet/6c4a23966c3c4a10a3178ae5791db7fd/-1/sheet/3161ee0402ec4b9fa4e937e6f0f63b13
- Variabel 2:
  - typ: Kedja variabel (cv)
  - Namn: cv-Kontroll ark Namn
  - Värde: Primär kontroll ark
Rädda kedjan

Steg 4: Hämta uppgifter om arket

Vi använder kommandot Get Sheet Data för att starta kedjan. Detta gör att vi kan hämta information från arket för att mata in i kedjan.

Lägg till ett Get Sheet Data -kommando från Workiva Connector till kedjans startområde
Dubbelklicka på kommandot för att konfigurera det
- Klicka på fältet ID för kalkylark
  - I panelen Välj en variabel klickar du på nedåtpilen för att expandera Chain
  - Välj ID för cv-Control kalkylark Kedjevariabel
- Klicka på fältet Ark ID/Namn
  - I panelen Välj en variabel klickar du på nedåtpilen för att expandera Chain
  - Välj namn på cv-Control Sheet Kedjevariabel
- Region: ange gärna en region. Om kommandot lämnas som ":" kommer kommandot att hämta data i hela kalkylarket
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 Chain
När kedjan har slutförts klickar du på noden Get Sheet Data för att verifiera att det har gått bra
- Kommandot ska ge en .csv-utdata av data i det angivna arket i kalkylarket, du ser .csv genom att klicka på ögonglobsikonen

Läs mer om hur du använder ark genom att slutföra nästa steg: Använda värden från ett kontrollark!

Support

Community

Workiva supportcenter