Aktualizacja środowiska Piaskownicy i nowe metody API EZD RP
27.06.2023
Zaktualizowane zostało środowisko Piaskownicy API EZD RP do wersji 15. Z zupełnie nowych oraz zmodyfikowanych metod API mogą korzystać podmioty zainteresowane testowaniem integracji z EZD RP swoich aplikacji dziedzinowych, z których korzysta m.in. administracja publiczna.
Piaskownica API EZD RP, która została udostępniona przez NASK w 2021 roku, jest stale rozwijana. W ostatnich dniach środowisko zostało zaktualizowane do wersji 15, dzięki czemu oferuje jeszcze większe możliwości integracji oprogramowania dziedzinowego firm trzecich z nowym systemem do elektronicznego zarządzania dokumentacją EZD RP.
Proces rejestracji
Aby uzyskać dostęp do Piaskownicy EZD RP, należy wypełnić formularz zgłoszeniowy z podstawowymi informacjami o wnioskującym podmiocie. Po zarejestrowaniu się za pomocą wspomnianego formularza, przedstawiciele zainteresowanych firm i instytucji otrzymają niezbędne informacje techniczne oraz materiały szkoleniowe. Zostanie im też udostępnione środowisko Piaskownicy z gotową instancją EZD RP do prowadzania testów.
Wypełnij formularz zgłoszeniowy
Ważne jest, aby wypełniając wniosek wskazać potrzeby zarówno w zakresie biznesowym jak i technicznym, co pozwoli lepiej określić zakres integracji.
Usunięte, dodane i zmodyfikowane metody API
Wprowadzone zmiany przynosły kilka zmian w zakresie metod API EZD RP. Po pierwsze, usunięta została metoda /ezdrp/integrator/v1/sprawa/metryka/pobierz. Jednocześnie dodano nową metodę /ezdrp/integrator/v1/pismo/kopiuj, która umożliwia kopiowanie pism. Aby skorzystać z niej, należy podać identyfikator pisma oraz listę identyfikatorów dokumentów, do których pismo ma być skopiowane. Proces kopiowania pisma składa się z dwóch kroków. W pierwszym należy dodać pismo lub przesyłkę wpływającą, wykonując punkt 3 lub 9 z instrukcji zamieszczonej w podręczniku użytkownika systemu EZD RP. Następnie, w drugim kroku, wykonuje się kopię tego pisma, wskazując załączniki, które mają zostać skopiowane.
Ponadto wprowadzono zmiany w istniejących metodach API. W przypadku metody /ezdrp/integrator/v1/sprawa/utworz-pusta, w poprzedniej wersji należało przekazać symbol JRWA, natomiast teraz należy podać identyfikator tego symbolu w schemacie JRWA. Identyfikator można uzyskać poprzez wykonanie określonych kroków, pobierając dostępne schematy i wykazy. Z kolei w metodzie /ezdrp/integrator/v1/dokument/metadane/aktualizuj zmieniono sposób przekazywania metadanych. W nowej wersji metody należy podać identyfikator dokumentu oraz listę metadanych, które mają być zaktualizowane. Metadane powinny być przekazane w formacie "id": "wartość", gdzie "id" jest identyfikatorem słownika. Informacje o dostępnych metadanych można pobierać z metody /ezdrp/integrator/v1/dokument/metadane/konfiguracja.
W metodzie /ezdrp/integrator/v1/jrwa-schemat-wykaz/pobierz wprowadzono zmiany, które, oprócz symbolu JRWA przekazywanego w poprzedniej wersji metody, wprowadzają wymóg podania dodatkowych parametrów: identyfikatora schematu JRWA oraz roku. W wersji 15 środowiska pojawiło się także dodawanie podteczki do wykazu /ezdrp/integrator/v1/jrwa/dodaj-podteczke.
Precyzyjne operacje na danych
Wprowadzone modyfikacje mają na celu rozszerzenie funkcjonalności API i integrację z EZD RP rozwiązań stosowanych w podmiotach publicznych. Umożliwia to precyzyjne operacje na danych w systemie oraz powiązanie prowadzonych spraw w EZD z realizacją konkretnych zadań w innych systemach dziedzinowych. Wszystko to zwiększa efektywność i transparentność wykonywanych operacji oraz pozwala na elektronicznie zarządzanie dokumentacją w podmiotach administracji publicznej.