Workiva-ondersteuningscentrum

Stap 1: Maak een controleblad

We zullen een controleblad maken om variabelen op te slaan die worden gebruikt om gegevens te uploaden naar een Wdatatabel en vervolgens de verbindingen voor die gegevens te verversen. In plaats van deze variabelen te specificeren als Runtime Inputs telkens wanneer de Chain wordt uitgevoerd, voegen we onze variabelen toe aan een controleblad dat de Chain zal lezen en gebruiken tijdens de gehele uitvoering. 

Dit controleblad demonstreert het uploaden van meerdere bestanden naar een enkele Wdatatabel en het verversen van verbindingen op een enkel werkblad, maar het proces kan uitgebreid worden naar meerdere tabellen en werkbladen door simpelweg de unieke ID van de tabel of het werkblad aan het controleblad toe te voegen.

• Navigeer naar het Workiva Platform om een nieuw werkblad te maken
• Klik op maken en selecteer werkblad
• Geef het spreadsheet een naam: CLP-controleblad
  • Geef het eerste blad een naam: Eerste controleblad
• Maak in het Primary Control Sheet de volgende koppen
  • ActiveFlag
    • Deze kolom geeft aan of de workflow moet worden uitgevoerd voor die regel in het controleblad
  • Bestandsnaam
    • Deze kolom geeft de naam van de dataset aan zoals die in de Wdatatabel zal verschijnen
  • TableID
    • ID van de tabel in Wdata waarin de gegevens worden geüpload
  • WerkbladID
    • ID van het werkblad waar de gegevens zullen worden ververst
  • Bestandslocatie
    • Locatie van het bestand dat wordt gedownload
• Vul het blad met de volgende waarden, door de kolom <TableID> in te vullen met de ID van de CLP Werknemer Detailtabel en de kolom <SpreadsheetID> in te vullen met de ID van de CLP Werknemer Overzicht Spreadsheet, deze ID's zijn aangemaakt in eerdere Connected Learning-trajecten, raadpleeg de vereisten om de vereiste Connected Learning-trajecten te zien.
  • Bekijk dit document voor hulp bij het vinden van de ID's

ActiveFlag,Bestandsnaam,TabelID,Bestandslocatie
TRUE,WerknemerDetailsP01,<TabelID>,<SpreadsheetID>,https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail_P01.csv
TRUE,WerknemerDetailsP02,<TabelID>,<SpreadsheetID>,https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail_P02.csv
TRUE,WerknemerDetailsP03,<TabelID>,<SpreadsheetID>,https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail_P03.csv

Stap 2: Spreadsheet-machtigingen bijwerken

Voor een effectieve communicatie tussen een Workiva Commando en een Spreadsheet, moet de gegenereerde API Grant gekoppeld zijn aan een gebruiker die eigenaar- of bewerkingsrechten heeft op de Spreadsheet.

• Klik in het werkblad CLP-controleblad op Bestand in het lint bovenaan
• Klik op Machtigingen, dan Werkblad
  • Toegang verlenen aan de Workiva gebruiker die geassocieerd is met de geconfigureerde API-subsidie binnen de Workiva Verbinding

Stap 3: Maak een ketting

Om de variabelen te gebruiken die we in het controleblad hebben gemaakt, maken we een Ketting die daaruit leest. Omdat we altijd dezelfde spreadsheet en hetzelfde blad gebruiken, stellen we Chain Variables in om deze gegevens op te slaan voor consistente toegang.

• Navigeer naar Kettingbouwer
• Maak een nieuwe Ketting aan
  • Noem de ketting: CLP | Lezen van een controleblad
• Klik onder Chain Variables tweemaal op het plusteken om twee Chain Variables aan te maken en configureer ze zoals hieronder:
  • Variabele 1:
    • Type: Ketting variabel (cv)
    • Naam: cv-Controle Spreadsheet ID
    • Waarde: voer de ID van het CLP-controleblad in
      • Om de werkblad-ID te vinden, navigeert u naar het werkblad CLP-controleblad
        • Selecteer in de URL de werkblad-ID, die te vinden is na "spreadsheet/" en voor "/sheet"
        • Bijvoorbeeld, de Spreadsheet ID is hier vetgedrukt: app.wdesk.com/a/QWNjb3VudB8yMDkwNzExMDQ0/spreadsheet/6c4a23966c3c4a10a3178ae5791db7fd/-1/sheet/3161ee0402ec4b9fa4e937e6f0f63b13
  • Variabele 2:
    • Type: Ketting variabel (cv)
    • Naam: cv-Controleblad Naam
    • Waarde: Primair Controleblad
• Red de Ketting

Stap 4: Verkrijg velgegevens

We gebruiken het commando Get Sheet Data om de Chain te starten. Hierdoor kunnen we informatie uit het controleblad halen om aan de ketting te geven.

• Voeg een commando Get Sheet Data van de Workiva Connector toe aan het startgebied van de ketting
• Dubbelklik op de opdracht om deze te configureren
  
  • Klik op het veld Spreadsheet-ID
    • Klik in het paneel Select a Variable op de pijl omlaag om Chain uit te vouwen
    • Selecteer de cv-Control Spreadsheet ID Ketenvariabele
  • Klik op het veld Blad-ID/Naam
    • Klik in het paneel Select a Variable op de pijl omlaag om Chain uit te vouwen
    • Selecteer de cv-Controleblad Naam Ketenvariabele
  • Regio: geef gerust een regio op. Als u ":" laat staan, haalt het commando gegevens op in het hele spreadsheet
• De opdracht opslaan

Stap 5: De oefening testen

Nu de Chain compleet is, kunt u het resultaat testen.

• Publiceren de keten
• Klik op Uitvoeren en selecteer vervolgens Keten uitvoeren
• Zodra de ketting voltooid is, klikt u op het knooppunt Get Sheet Data om het succes te verifiëren
  • Het commando moet een .csv-uitvoer geven van de gegevens in het opgegeven blad in het spreadsheet, u ziet de .csv door op het oogbolpictogram te klikken

Leer meer over het gebruik van controlebladen door het volgende pad te voltooien: Waarden uit een controleblad gebruiken!