6.4. Změna balíčků

Změna balíčků (přidání archivního popisu či komponent) je iniciováno pomocí služby FileTransfer. Změnové balíčky jsou nahrány ve formě dávky do digitálního archivu. Následně dochází k ověření stavu zpracování dávky pomocí funkce GET /ingest/status/{batchId}. Pokud je dávka zpracována, může dojít k převzetí výsledku pomocí funkce GET /ingest/result/{batchId}.

6.4.1. Parametry přenosu

Parametry přenosu se rozumí údaje, které jsou zapotřebí pro jeho zahájení, tj. pro zahájení pomocí metody Begin.

  • Typ přenosu: ingest

  • Volitelné ID: číslo dávky zasílajícího, určeno pro snazší dohledávání případných chyb komunikace

Následně proběhne nahrání dávky změnových SIPů. Na závěr přenosu zasílá klient na server zprávu FinishRequest, odpovědí na úspěšné dokončení přenosu a jeho potvrzením je zpráva FinishResponse, která obsahuje následující údaje potřebné pro další zpracování:

  • V atributu type je nastavena hodnota ingest_id

  • V atributu id je uveden identifikátor přijaté dávky.

Identifikátor předaný v atributu id je možné následně použít pro čtení informací o stavu zpracování a následné stažení výsledku. Použije se jako parametr batchId v příslušných voláních.

6.4.2. Formát dat

Nahrávanou dávkou se vždy rozumí sada adresářů. Každý adresář je jednotlivý změnový SIP balíček. Identifikátory těchto balíčků určuje zasílající. Forma změnových balíčků je v části Změnové balíčky.

Identifikátory předaných SIP balíčků je nutné uchovat do doby zpracování odpovědi. Jednotlivé části odpovědi jsou vázány na předané identifikátory vstupních balíčků.