Workiva kundestøttesenter

Med Workiva-koblingen kan du bruke kommandoer i kjeder for å samhandle med Workiva-plattformen, inkludert andre Wdata-funksjoner, regneark og GraphDB. Med denne kontakten kan du for eksempel:

• Opprett og administrer tabeller, spørringer og visninger
• Liste opp datasettene eller importfeilene til en tabell
• Opprett og administrer regneark eller tilhørende ark
• Administrer poster og rapporter

Krav

For å samhandle med Workiva-plattformen bruker koblingen Workiva REST API-ene. For å sette opp koblingen trenger du:

• En dedikert Workiva-integrasjonsbruker med en OAuth2-rettigheter.

  Merk: Denne integrasjonsbrukeren krever nødvendige tillatelser for kommandoene koblingen utfører, for eksempel eier av regnearkene eller arbeidsområdet den samhandler med.

• Integrasjonsbrukerens OAuth2-tildelings-ID og hemmelighet.
• For å kjøre kjeden i et testmiljø, må URL-ene overstyre API-ets verter og basisstier.

Merk: Selv om eierne av arbeidsområdet har tilgang til kjeder som bruker koblingen, krever selve koblingen en dedikert integrasjonsbruker for å utføre kommandoene. Ved å bruke en dedikert integrasjonsbruker – i stedet for en samarbeidspartners brukerkonto – kan du spore koblingens aktivitet og begrense tilgangen til kun det den trenger for å utføre kommandoene sine.

Konfigurer Workiva-koblingen

1. Fra Kjedebyggerklikker du på Tilkoblingercompare_arrowsog deretter på Opprett øverst til høyre.
2. Under Opprett tilkoblingvelger du Workiva og standard CloudRunner.
   
3. Under Grunnleggende informasjonskriver du inn et unikt navn og en beskrivelse for å identifisere koblingen.

4. Under Ressurservelger du ressursene som skal knyttes til denne tilkoblingen.
   Denne delen gir en sikker plassering for alle filer (skript, sikkerhetstokener, sertifikater osv.) som koblingen trenger for å fungere, for eksempel for autentisering eller miljøkrav. Når du lagrer tilkoblingen, blir disse filene automatisk AES-256-kryptert. For mer informasjon, se Workiva Chain Builder sikkerhetsarkitektur støttesiden.

   Fordeler:

   • Sikker lagring: Fordi disse filene krypteres ved lagring og lagres på tilkoblingsnivå, er de ideelle for sensitive eller statiske konfigurasjonsdata som ikke bør hardkodes inn i selve kjeden.
   • Portabilitet: Hvis du flytter kjeden din fra et «Test»-arbeidsområde til et «Produksjon»-arbeidsområde, forblir ressursene knyttet til tilkoblingsinnstillingene, noe som betyr at du ikke trenger å omskrive filbanene i kjedenodene dine.
   • Tilgjengelighet: Lagring av filene her gjør filene tilgjengelige for Runner (agenten som utfører oppgaven) uten at filen må plasseres manuelt på løperens fysiske vertsmaskin.

   Ulemper:

   • Fordi de er krypterte, kan de ikke redigeres direkte. Du må slette filen og laste opp den endrede versjonen.

5. Under Egenskaperskriver du inn tilkoblingsdetaljene:
   

   Egenskap	Detaljer
   ID	Skriv inn ID-en for integrasjonsbrukernes OAuth-tildeling.
   Hemmelig	Skriv inn hemmeligheten for ID -egenskapen.
   Overstyring av cerebral vert	For å overstyre URL-verten og basisbanen for Wdata-endepunktene, for eksempel for et testmiljø, skriver du inn URL-en som skal brukes i stedet.
   Overstyring av regnearkvert	For å overstyre URL-verten og basisbanen for regnearksendepunktene, for eksempel for et testmiljø, skriver du inn URL-en som skal brukes i stedet.
   IAM-vertsoverstyring	For å overstyre URL-verten og basisbanen for IAM-endepunktene (Identify and Access Management), for eksempel for et testmiljø, skriver du inn URL-en som skal brukes i stedet.
   Overstyring av administratorvert	For å overstyre URL-verten og basisbanen for administrator-endepunktene, for eksempel for et testmiljø, skriver du inn URL-en som skal brukes i stedet.
   Overstyring av GraphDB-vert	For å overstyre URL-verten og basisbanen for GraphDB-endepunktene, for eksempel for et testmiljø, skriver du inn URL-en som skal brukes i stedet.
   Overstyring av plattform-API-vert	For å overstyre URL-verten og basisbanen for Workiva-plattformens endepunkter, for eksempel for et testmiljø, skriver du inn URL-en som skal brukes i stedet.

   Merk: Alle sensitive påloggingsinformasjoner krypteres og lagres automatisk med AES-256-kryptering.

6. Velg miljøene du vil bruke tilkoblingen i, og klikk på Lagre.
7. For å teste tilkoblingen, opprett og kjør en kjede med -koblingens List Files -kommando, og bekreft at den returnerer en gyldig utdata.

URL-overstyringer

Avhengig av regionen i produksjonsmiljøet ditt, kan det gjelde en overstyrings-URL.Du kan bekrefte dette ved å sammenligne med URL-en som ble brukt til å logge inn på Wdesk.Hvis URL-en inneholder EU eller APAC, kreves en overstyring.

Merk: Informasjon om den amerikanske regionen er oppført som referanse.

Feilsøking

Hvis tilkoblingen til Workiva-plattformen mislykkes:

• Kontroller at OAuth-legitimasjonen for koblingsprogrammet er til stede, korrekt og gyldig. OAuth-legitimasjon har definerte utløpsdatoer, og sertifikatet kan ha utløpt. Hvis dette er tilfelle, må du opprette et nytt sertifikat og angi den nye klienthemmeligheten i koblingen. 
• Sørg for at integrasjonsbrukeren har nødvendige tillatelser for kommandoen som utføres.
• Hvis du bruker en vertsoverstyring, må du kontrollere at URL-en som er angitt for koblingen er riktig.

• Bekreft at ID-en til Workiva-filen – for eksempel tabellen, spørringen eller regnearket – som brukes, er riktig.

  Merk: En fils ID vises i URL-en når den åpnes i Workiva. For eksempel vises ID-en til et regneark etter spreadsheet/ i URL-en; ID-en til en tabell vises etter tables/.