.. _batchapi_ingest: ============================= Změna balíčků ============================= Změna balíčků (přidání archivního popisu či komponent) je iniciováno pomocí služby :ref:`FileTransfer `. :ref:`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}``. 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 :token:`type` je nastavena hodnota ``ingest_id`` - V atributu :token:`id` je uveden identifikátor přijaté dávky. Identifikátor předaný v atributu :token:`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. 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 :ref:`changes`. 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ů.