Workiva kundestøttesenter

Innledning

Denne artikkelen går gjennom hvordan du erstatter en fil i Wdata ved hjelp av Workiva API-ene. Du henter den eksisterende filen, avimporterer og sletter den, og laster deretter opp en ny versjon.

Forutsetninger

Før du begynner, sørg for at du har fullført alle trinnene i veiledningen Importering av Workiva API-samlinger til Postman. Dette sikrer at API-samlingen og miljøvariablene dine er riktig konfigurert.

Autentisering

1. Åpne Postman-arbeidsområdet ditt og bekreft at du bruker riktig miljø.
2. Utvid samlingen IAM-tjenester, åpne mappen oauth2 og velg forespørselen Hent et token.
3. Klikk på Send for å generere autentiseringstokenet ditt. Tokenet lagres automatisk i miljøvariabelen {{access_token}} og vil bli brukt i alle påfølgende API-kall.

Merk: Tokener utløper etter 600 sekunder (10 minutter). Når dette skjer, gjentar du ganske enkelt dette trinnet for å generere en ny.

Hent fil-ID-en ved hjelp av API-et for henting av filliste

Før du laster opp eller erstatter en fil i en Wdata-tabell, må du bekrefte om filen allerede finnes. Du kan gjøre dette ved hjelp av API-et Hent en filliste for å finne filen og hente dens fil-ID.

Følg trinnene nedenfor.

1. Åpne API-endepunktet
   • Gå til Wdata API → Fil → Hent en liste over filer.
2. Skriv inn de nødvendige parameterne
   • TableId: din Wdata-tabell-ID
   • Søketekst: filnavnet (f.eks. Kontrolltabell (3).csv)
3. Kjør forespørselen
   • API-et vil returnere alle filer som samsvarer med søket ditt.
4. Finn fil-ID-en
   • I JSON-svaret, se etter:
     • id → fil-ID-en
     • navn → bekrefter riktig fil

(Valgfritt) Bekreft i Wdata
Åpne datasettet i brukergrensesnittet og bekreft at fil-ID-ene samsvarer.

Avimporter filen ved hjelp av fil-ID-en

Bruk endepunktet Avimporter en enkelt fil for å fjerne en importert fil fra en Wdata-tabell. Dette trinnet forbereder tabellen til å motta en erstatningsfil.

1. I Postman åpner du forespørselen Avimporter en enkelt fil.
2. I Stivariabler, sett:
   • TableId til din Wdata-tabell-ID.
   • Fil-ID til fil-ID-en som ble hentet i forrige trinn.
3. Klikk på Send for å kjøre forespørselen.
4. I svarinnholdet bekrefter du at filposten nå viser en oppdatert status (for eksempel flyttet tilbake til staged). 
   
5. I Wdata → Datasettåpner du datasettet og bekrefter at filen ikke lenger vises som importert. 
   

Slett filen ved hjelp av fil-ID-en

1. I Postman åpner du forespørselen Slett en enkelt fil.
2. I Path Variableslimer du inn den samme fileId.
3. Send forespørselen.
4. Bekreft at svarinnholdet returnerer at fileId, dette bekrefter at filen er slettet fra tabellen.

Valgfritt: Avimporter og slett filen i ett trinn ved å bruke force=true

Som standard, når en fil avimporteres, fjernes den fra tabellen og returneres til trinnvis modus, men den slettes ikke. For å fjerne filen permanent som en del av én enkelt operasjon, inkluder spørreparameteren force.

Når force=true er spesifisert, blir filen avimportert og slettet i én enkelt forespørsel. Et separat API-kall Slett en enkelt fil er ikke nødvendig.

Eksempel:

SLETT /api/v1/table/{tableId}/import/{fileId}?force=true 

Last opp den nye filen

Etter at du har fjernet den forrige filen, følger du trinnene i veiledningen Last opp og importer en fil for å laste opp og importere den nye versjonen.