Welcome to the Enerj JSDC Documentation

This documentation shows how to use the Enerj JCDI Web Service and the related FTP Channel. The JCDI module is the indexing component created to receive the files for many services. Web service is commonly used to send documents to the digital preservation system named JSDC (aka 'Sistema di Conservazione').

Jcdi Web Service v4, created in 2021, is compliant with AGID regulations.

• The use of the web services is not open to anonymous users. Almost every access to the web service is conditioned by the login procedure that requires an user name and password.

• JCDI module is the primary interface to send documents to the preservation system. Each document in the JSDC system follows a workflow. Refer to the JSDC workflow diagram for a better comprehension.

Recommendation no. 1. The use of SOAP Web Service requires, as a necessary first step, the request for a JWT access token. The token lasts 24 hours. You are required to use an access token for all its validity time. Avoid discarding it once you have finished managing a document. Note: An excess of login attempts could result in being black-listed, preventing subsequent calls.

Recommendation no. 2 Tracking a document status update with the SOAP Web Service, involves two steps, after sending it to the document preservation. Step 1. Tracing the document status until it is associated to a document collection (PdV). Step 2: Tracing the state of a PdV until it is in a final state, ideally "Preserved". The frequency of a document status update request should be as low as possible, e.g once or twice a day, as long as the document entered in a PdV. The frequency of update PdV status request should be on daily basis and consistent with the storage configuration. For instance, if a PdV is configured to be stored on a monthly basis, it is good practice to check it on the first days of the month (hence, after being sent) and possibly NOT every single day. The inclusion of update logic on user request is also recommended in order to have an updated status in advance with respect to the configured preservation. Note: An excess of login attempts could result in being black-listed, preventing subsequent calls.

Metadata Specification about Documento Informatico, Documento Amministrativo Informatico and Aggregazione Documentali Informatiche

• Medatata specification: Metadata Description

Status Codes

• Status Codes: Status Codes

Web Services description (Version 2021)

• Web Service Jcdi: Enerj.CDI.WebService.V4Jcdi

FTP Samples

• FTP Samples for document transfer: FTP Sample

C# Examples

• Framework 4.8 C# Examples: C# Framework Code Sample

C# Examples (.Net Core)

• .Net Core C# Examples: C# .Net Code Sample