Workiva supportcenter

Introduktion

Den här artikeln går igenom hur man ersätter en fil i Wdata med hjälp av Workiva API:er. Du hämtar den befintliga filen, avimporterar och tar bort den och laddar sedan upp en ny version.

Förkunskapskrav

Innan du börjar, se till att du har slutfört alla steg i guiden Importera Workiva API-samlingar till Postman. Detta säkerställer att din API-samling och dina miljövariabler är korrekt konfigurerade.

Autentisering

1. Öppna din Postman-arbetsyta och bekräfta att du använder rätt miljö.
2. Expandera samlingen IAM-tjänster, öppna mappen oauth2 och välj begäran Hämta en token.
3. Klicka på Skicka för att generera din autentiseringstoken. Token lagras automatiskt i miljövariabeln {{access_token}} och kommer att användas i alla efterföljande API-anrop.

Obs: Tokens upphör att gälla efter 600 sekunder (10 minuter). När detta händer, upprepa helt enkelt detta steg för att skapa en ny.

Hämta fil-ID med hjälp av API:et Hämta en lista med filer

Innan du laddar upp eller ersätter en fil i en Wdata-tabell, bekräfta om filen redan finns. Du kan göra detta med hjälp av API:et Hämta en lista med filer för att hitta filen och hämta dess fil-ID.

Följ stegen nedan.

1. Öppna API-slutpunkten
   • Gå till Wdata API → Fil → Hämta en lista med filer.
2. Ange de obligatoriska parametrarna
   • TableId: ditt Wdata-tabell-ID
   • Söktext: filnamnet (t.ex. Kontrolltabell (3).csv)
3. Kör begäran
   • API:et kommer att returnera alla filer som matchar din sökning.
4. Hitta fil-ID:t
   • I JSON-svaret, leta efter:
     • id → Fil-ID:t
     • namn → bekräftar rätt fil

(Valfritt) Verifiera i Wdata
Öppna datasetet i användargränssnittet och bekräfta att fil-ID:t matchar.

Avimportera filen med hjälp av fil-ID:t

Använd slutpunkten Avimportera en enskild fil för att ta bort en importerad fil från en Wdata-tabell. Det här steget förbereder tabellen för att ta emot en ersättningsfil.

1. I Postman, öppna begäran Avimportera en enskild fil.
2. I Sökvägsvariabler, sätt:
   • TableId till ditt Wdata-tabell-ID.
   • FileId till det fil-ID som hämtades i föregående steg.
3. Klicka på Skicka för att köra begäran.
4. I svarstexten, bekräfta att filposten nu visar en uppdaterad status (till exempel flyttad tillbaka till staged). 
   
5. I Wdata → Datasetöppnar du datasetet och verifierar att filen inte längre visas som importerad. 
   

Ta bort filen med hjälp av fil-ID:t

1. I Postman, öppna begäran Ta bort en enskild fil.
2. I Path Variablesklistra in samma fileId.
3. Skicka förfrågan.
4. Bekräfta att svarstexten returnerar att fileId, detta bekräftar att filen har tagits bort från tabellen.

Valfritt: Avimportera och ta bort filen i ett steg med force=true

Som standard, när en fil avimporteras, tas den bort från tabellen och återgår till mellanlagrat läge, men den raderas inte. För att permanent ta bort filen som en del av en enda åtgärd, inkludera frågeparametern force.

När force=true anges avimporteras filen och tas bort i en enda begäran. Ett separat API-anrop Ta bort en enskild fil krävs inte.

Exempel:

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

Ladda upp den nya filen

När du har tagit bort den föregående filen följer du stegen i guiden Ladda upp och importera en fil för att ladda upp och importera den nya versionen.