Oznaczanie obiektów w EZD RP dla systemów zintegrowanych przy użyciu subskrypcji

Aby oznaczać obiekty dla systemów zintegrowanych w EZD RP, można wykorzystać atrybuty. Do tego celu przygotowano atrybut o typie Klucze API.

Dodawanie atrybutów w systemie zostało opisane w artykule Atrybuty spraw, dokumentów i pism. Po skonfigurowaniu atrybutu należy włączyć w EZD RP w Administracja > Klucze API widoczność takiego klucza w metadanych.

Następnym krokiem jest skonfigurowanie w EZD RP subskrypcji, co zostało opisane w artykule Subskrypcje zdarzeń w EZD RP i dodanie w systemie subskrypcji na zdarzenie typu ezdrp.v2.metadane.zmienionoKluczApi. Po skonfigurowaniu subskrypcji i atrybutu dla wybranego typu obiektu system zacznie wysyłać odpowiednie powiadomienia.

Przykład atrybutu typu Klucze API dla dokumentu

Przechodzimy do metadanych dokumentu. W naszym przypadku atrybut z nazwami systemów zintegrowanych ma nazwę System.

Po rozwinięciu listy będą na niej widoczne nazwy systemów, których klucze api wcześniej oznaczyliśmy jako widoczne w metadanych.

Po wskazaniu odpowiedniej nazwy systemu oraz zapisaniu system EZD RP wysyła powiadomienie o zdarzeniu ezdrp.v2.metadane.zmienionoKluczApi. Przykład takiego powiadomienia:

"Zdarzenia": [
	{
	"IdZdarzenie": "c73c6b61-4028-45af-8196-387e4672d959",
	"KluczZdarzenia": null,
	"Dane": {
		"Zdarzenia": [
			{
			"KluczZdarzenia": "ezdrp.v2.metadane.zmienionoKluczApi",
			"KluczObiektu": "EZDRP.Metadane.Klucze1",
			"IdObiekt": "35d0bc9d2316462389c71e6409ba0325",
			"DataZdarzenia": "2025-12-08T08:29:38.1610705+01:00",
			"IdMetadana": "1e16a935148d405a82a1bb05a76411e5",
			"Label": "Metadana API",
			"Wartosc": "ddd309b59d0b441daba987b9681ae8da"
			}
		]
	}
	}
]

Elementy powiadomienia:

• IdZdarzenie – identyfikator zdarzenia.
• KluczZdarzenia – informacja o typie zdarzenia. Wartość ezdrp.v2.metadane.zmienionoKluczApi oznacza zdarzenie związane z dodaniem lub usunięciem metadanej typu Klucze API.
• KluczObiektu – informacja, dla jakiego typu obiektu ustawiono klucz. Dostępne wartości:
  • 1 – Dokumenty
  • 2 – Pisma (RPW)
  • 3 – Adresaci (Kontakty) – osoby fizyczne
  • 4 – Adresaci (Kontakty) – podmioty
  • 5 – Sprawy
• IdObiekt – identyfikator obiektu, np. dokumentu, sprawy itp.
• IdMetadana – identyfikator metadanej.
• Label – etykieta (nazwa) metadanej widoczna w systemie EZD RP.
• Wartość – identyfikator klucza API. Na podstawie tej wartości systemy zintegrowane rozpoznają metadane oznaczone jako przeznaczone do integracji.