Praca z wieloma wersjami

Ostatnia aktualizacja: 20.10.2026

Kontrakty API umożliwiają utrzymywanie wielu wersji tego samego kontraktu API, dzięki czemu można zachować stabilność opublikowanej wersji podczas przygotowywania zmian w nowej wersji.

Utrzymuj istniejącą wersję API w środowisku produkcyjnym, jednocześnie wprowadzając zmiany powodujące niezgodność w nowej wersji.
Śledź opublikowane wersje i zarządzaj nimi z jednej lokalizacji.
Pracuj nad zmianami w API bez wpływu na istniejące wersje.

Gdy tworzysz nową wersję, cała zawartość jest kopiowana do nowej wersji. Najnowszą wersję można następnie zaktualizować niezależnie, bez wpływu na wcześniejsze wersje.

Tylko najnowsza wersja jest edytowalna i tylko na jej podstawie można utworzyć nową wersję. Starsze wersje są tylko do odczytu.

Strona główna Kontrakty API wyświetla wszystkie API należące do Ciebie oraz wszystkie wersje API udostępnione Tobie.

Tworzenie nowej wersji API

Utwórz nową wersję istniejącej definicji API.

Uwaga:

Nową wersję można utworzyć tylko z najnowszej wersji. Starsze wersje są tylko do odczytu i nie można ich edytować ani używać do tworzenia nowej wersji.

Jesteś właścicielem API lub edytorem co najmniej jednej wersji API.

Na stronie głównej przejdź do API, dla którego chcesz utworzyć nową wersję.
W razie potrzeby możesz filtrować listę według nazwy lub właściciela.
Otwórz najnowszą wersję, aby wyświetlić Podgląd, a następnie kliknij Utwórz nową wersję.
Wprowadź nową wersję.
Kliknij Utwórz.

Tworzona jest nowa wersja Twojego API z taką samą zawartością jak najnowsza wersja. Mock i dokumentacja są domyślnie wyłączone.

Publikowanie wersji API w Qlik Catalog

Opublikuj wersję kontraktu API w przestrzeni Qlik, aby współpracownicy mogli znaleźć ją w Qlik Catalog.

Jesteś właścicielem API lub edytorem wersji API.

Gdy publikujesz wersję, wersja kontraktu staje się niezmienna i dostępna tylko do odczytu w API Contracts. Aby wprowadzić zmiany, utwórz nową wersję na podstawie najnowszej wersji i kontynuuj pracę nad nową wersją.

Na stronie głównej kliknij wersję, którą chcesz opublikować, aby otworzyć Podgląd, a następnie kliknij Publikuj.
W oknie dialogowym publikacji wybierz przestrzeń Qlik, w której chcesz opublikować wersję.
Przejrzyj podgląd wersji i wprowadź notatkę dotyczącą publikacji.
Kliknij Publikuj.

Wybrana wersja zostaje opublikowana w wybranym obszarze Qlik i staje się dostępna tylko do odczytu w kontraktach API. Jeśli musisz ponownie edytować umowę, najpierw utwórz nową wersję.

Usuwanie wersji API

Jesteś właścicielem API.

Na stronie głównej kliknij przycisk obok wersji, którą chcesz usunąć, a następnie kliknij Usuń.
Kliknij Usuń, aby potwierdzić.

Wybrana wersja została usunięta. Jeśli chcesz usunąć całe API, musisz usunąć każdą wersję.

Importowanie zawartości wersji

Zaimportuj zawartość z istniejącego kontraktu do wersji API, zastępując lub scalając jej bieżącą zawartość.

Jesteś właścicielem API lub edytorem wersji API.

Użyj tej cechy, aby zaktualizować wersję z zewnętrznego pliku umowy bez tworzenia nowej wersji. Identyfikator wersji jest zachowywany przez cały proces importu.

Jest to coś innego niż importowanie definicji, co tworzy nowe API w API Contracts.

Otwórz Importuj zawartość wersji dla wersji, którą chcesz zaktualizować.
Ta akcja jest niedostępna w wersji tylko do odczytu.

Dostęp do tej akcji można uzyskać z następujących lokalizacji:
- Na stronie głównej kliknij obok wersji i kliknij Importuj zawartość wersji.
- Na podglądzie wersji kliknij > Importuj zawartość wersji.
- W edytorze wersji kliknij Edycja > Importuj zawartość wersji.
Wybierz format i źródło umowy do zaimportowania.
Możesz importować z pliku lokalnego, adresu URL lub tekstu wklejonego bezpośrednio do okna dialogowego.
W sekcji Zachowanie wybierz sposób zastosowania zaimportowanej zawartości.
- Zastąp: nadpisuje całą bieżącą zawartość zaimportowaną umową. Nazwa API, identyfikator wersji oraz wersja specyfikacji zostają zachowane.
- Scal: łączy zaimportowaną zawartość z zawartością istniejącej wersji. Nazwa API i identyfikator wersji są zachowane. Jeśli zaimportowany element ma taką samą nazwę jak istniejący element, zaimportowany element otrzymuje nową nazwę z sufiksem _merge (na przykład User_merge). Zduplikowane bazowe adresy URL i typy mediów są pomijane.
Kliknij Importuj.

Otwiera się edytor wersji z zastosowaną zaktualizowaną zawartością.

Czy ta strona była pomocna?

Jeżeli natkniesz się na problemy z tą stroną lub jej zawartością — literówkę, brakujący krok lub błąd techniczny — daj nam znać!

Przekaż tu opinię