Arbeta med flera versioner | Qlik CloudHjälp
Gå till huvudinnehåll Gå till ytterligare innehåll

Arbeta med flera versioner

Senast uppdaterad: 2026-10-09

API-kontrakt gör att du kan underhålla flera versioner av samma API-kontrakt så att du kan hålla en publicerad version stabil medan du förbereder ändringar i en ny version.

  • Underhåll en befintlig API-version i produktion samtidigt som icke-bakåtkompatibla ändringar introduceras i en ny version.
  • Spåra och hantera publicerade versioner från en enda plats.
  • Arbeta med API-ändringar utan att påverka befintliga versioner.

När du skapar en ny version kopieras allt innehåll till den nya versionen. Den senaste versionen kan sedan uppdateras oberoende utan att påverka tidigare versioner.

Endast den senaste versionen är redigerbar, och du kan endast skapa en ny version från den. Äldre versioner är skrivskyddade.

Startsidan för API Contracts visar alla API:er som du äger och alla API-versioner som delas med dig.
Startsidan för API-kontrakt.

Skapa en ny API-version

Skapa en ny version av en befintlig API-definition.

Anteckning om information

Observera!

Du kan endast skapa en ny version från den senaste versionen. Äldre versioner är skrivskyddade och kan inte redigeras eller användas för att skapa en ny version.

Du är en ägare till API:et eller en redigerare av minst en version av API:et.
  1. På startsidan går du till det API som du vill skapa en ny version för.
    Du kan filtrera listan efter namn eller ägare om det behövs.
  2. Öppna den senaste versionen för att visa Förhandsgranskning, klicka sedan på Skapa en ny version.
    Vy över Contacts API och knappen Skapa ny version.
  3. Ange den nya versionen.
  4. Klicka på Skapa.
En ny version av ditt API skapas med samma innehåll som den senaste versionen. Mocken och dokumentationen är inaktiverade som standard.

Publicera en API-version till Qlik Catalog

Publicera en version av ett API-kontrakt till ett Qlik-utrymme så att medarbetare kan hitta det i Qlik Catalog.

Du är ägare till API:et eller redigerare för API-versionen.

När du publicerar en version blir kontraktsversionen oföränderlig och skrivskyddad i API-kontrakt. För att göra ändringar skapar du en ny version från den senaste versionen och fortsätter arbeta med den nya versionen.

  1. På startsidan klickar du på den version du vill publicera för att öppna Förhandsgranskning, och klickar sedan på Publicera.
    Vy över Contacts API och knappen Publicera.
  2. I publiceringsdialogrutan väljer du det Qlik-utrymme där du vill att versionen ska publiceras.
  3. Granska förhandsgranskningen av versionen och ange en publiceringsanteckning.
  4. Klicka på Publicera.

Den valda versionen publiceras till det valda Qlik-utrymmet och blir skrivskyddad i API-kontrakt. Om du behöver redigera avtalet igen, skapa en ny version först.

Ta bort en API-version

Du är en ägare till API:et.
  1. På startsidan klickar du på knappen Meny bredvid den version som du vill ta bort och klickar på Ta bort.
  2. Klicka på Ta bort för att bekräfta.
Den valda versionen tas bort. Om du vill ta bort ett helt API behöver du ta bort varje version.

Importera versionsinnehåll

Importera innehåll från ett befintligt kontrakt till en API-version, vilket ersätter eller sammanfogar dess aktuella innehåll.

Du är ägare till API:et eller redigerare för API-versionen.

Använd denna funktion för att uppdatera en version från en extern avtalsfil utan att skapa en ny version. Versionsidentifieraren bevaras under hela importen.

Detta skiljer sig från importera en definition, vilket skapar ett nytt API i API Contracts.

  1. Öppna Importera versionsinnehåll för den version du vill uppdatera.

    Den här åtgärden är inte tillgänglig för en skrivskyddad version.

    Du kan komma åt den här åtgärden från följande platser:

    • På startsidan klickar du på Meny bredvid versionen och klickar på Importera versionsinnehåll.
      Alternativet Importera versionsinnehåll i menyknappen.
    • I versionens förhandsgranskning klickar du på Meny > Importera versionsinnehåll.
      Versionsdetaljvy
    • I versionsredigeraren klickar du på Redigera > Importera versionsinnehåll.
      Alternativet Importera versionsinnehåll i versionsredigeraren.
  2. Välj ett format och en källa för avtalet som ska importeras.
    Du kan importera från en lokal fil, en URL eller text som du klistrar in direkt i dialogrutan.
  3. Under Beteende väljer du hur det importerade innehållet ska tillämpas.
    • Ersätt: skriver över allt befintligt innehåll med det importerade avtalet. API-namnet, versionsidentifieraren och specifikationsversionen bevaras.
    • Slå samman: kombinerar det importerade innehållet med det befintliga versionsinnehållet. API-namnet och versionsidentifieraren bevaras. Om ett importerat element har samma namn som ett befintligt element döps det importerade elementet om med ett _merge-suffix (till exempel User_merge). Duplicerade bas-URL:er och mediatyper hoppas över.
    Dialogrutan Importera versionsinnehåll.
  4. Klicka på Importera.

Versionsredigeraren öppnas med det uppdaterade innehållet tillämpat.

Var den här sidan till hjälp för dig?

Om du stöter på några problem med den här sidan eller innehållet på den, t.ex. ett stavfel, ett saknat steg eller ett tekniskt fel – meddela oss!