API di piattaforma > JamioPlug > JamioPlug Digitalitaly > Conservazione a norma

Per poter utilizzare il servizio di DocumentConservation di JamioPlug Digitalitaly è necessario configurarlo tramite risorsa di tipo configurazione. Si ricorda che per poter usufruire del JamioPlug Digitalitaly in esecuzione sulla propria area Jamio è necessario contattare il customer service.

La risorsa di tipo configurazione consente l'interfacciamento con il provider esterno di conservazione e la definizione della tipologia di profilo da inviare in conservazione.

La risorsa di tipo configurazione deve avere valorizzate le proprietà come segue:

PlugName: Digitalitaly;

ServiceName: DocumentConservation;

Name: Nome da assegnare alla configurazione;

Description: descrizione opzionale della configurazione;

AuthorizationScheme: 0;

Fields: Dataset contenente i campi riportati nelle tabelle che seguono.

Nickname: Nome univoco assegnato alla configurazione. Per quanto riguarda i caratteri speciali ammessi:

•può contenere lettere maiuscole e minuscole dell'alfabeto inglese, numeri e i caratteri "-", "_", "."

•non è case-sensitive

•non può iniziare con uno dei caratteri "-", "_", "."

•non può terminare con "."

•non può contenere spazi

Se la configurazione viene creata mediate Jamio Admin Console, la valorizzazione di alcuni parametri viene eseguita implicitamente con la selezione del tipo di Configurazione da creare.

Impostazioni generali di Jamio DocumentConservation
Nome	Descrizione	Tipo	Opzionale
Provider	Testo che indica il nome del provider utilizzato per la conservazione. Il valore di default è "Unimatica".	String
ProviderFields	Dato strutturato che contiene le proprietà specifiche del provider di conservazione	Dataset
Profile	Testo che identifica la struttura del set di metadati del pacchetto di versamento e dei singoli documenti attesi dal servizio. Il valore di default è "DocumentoInformatico".	String

Per il parametro Profile, i valori attualmente ammessi sono DocumentoInformatico e DocumentoAmministrativoInformatico.

Il contenuto del dato strutturato ProviderFields è specifico del provider. Nel caso del provider di conservazione “Unimatica", contiene i seguenti campi:

Impostazioni specifiche del provider di conservazione
Nome	Descrizione	Tipo	Opzionale
Organization	Testo che indica il nome dell'organizzazione di appartenenza dei documenti nell'ambiente di conservazione del provider.	String
Structure	Testo che indica il nome della struttura di appartenenza dei documenti nell'ambiente di conservazione del provider.	String

E' possibile istruire il Plug per valorizzare i metadati attesi secondo la normativa AGID a partire da diverse risorse dalle quali attingere le informazioni.

Il contenuto di ogni metadato può essere valorizzato con una stringa o con un'espressione. Nel primo caso le informazioni vengono ricercate nei campi della risorsa stessa, nel secondo caso le informazioni vengono ricercate nei campi e nelle proprietà delle risorse ivi specificate, mediante l'utilizzo di alcune chiavi riservate.

Nello specifico, se le informazioni devono essere ricercate:

•nella risorsa principale, il metadato può essere valorizzato con una stringa che indica il nome del campo o della proprietà della risorsa principale che contiene l'informazione o, equivalentemente, con un'espressione che utilizza la chiave riservata #resource, ad esempio #resource.Fields["nome_campo"];

•nella configurazione, il metadato deve essere valorizzato con un'espressione che utilizza la chiave riservata #configuration, ad esempio #configuration.Fields["nome_campo"];

•nella risorsa già inviata in conservazione in una versione precedente, il metadato deve essere valorizzato con un'espressione che utilizza la chiave riservata #previousVersion;

•nella risorsa che contiene il documento principale, il metadato deve essere valorizzato con un'espressione che utilizza la chiave riservata #sourceDocument;

•in una risorsa che contiene un TrackingMessage, il metadato deve essere valorizzato con un'espressione che utilizza la chiave riservata #owner.

Mapping per i metadati richiesti secondo normativa Agid
Nome	Descrizione	Tipo
Contenuti del documento informatico, file principale e allegati
DocumentNameField	Testo che indica il nome del campo che, nell'invio in conservazione secondo le linee guida Agid, identifica il nome del documento.	String
DocumentTypeField	Testo che indica il nome del campo che, nell'invio in conservazione secondo le linee guida Agid, identifica la tipologia del documento.	String
PrimaryFileField	Testo che indica il nome del campo che, nell'invio in conservazione secondo le linee guida Agid, identifica il collegamento al File Primario.	String
AttachmentsField	Testo che indica il nome del campo che, nell'invio in conservazione secondo le linee guida Agid, identifica il collegamento alla lista degli allegati.	String
SignatureField	Testo che indica il nome del campo che, nell'invio in conservazione secondo le linee guida Agid, identifica il collegamento al file di segnatura. Il valore di default è RefFileSegnatura.	String
Dati di registrazione
RegistrationTypeField	Testo che indica il nome del campo che, nell'invio in conservazione secondo le linee guida Agid, identifica la tipologia di registrazione. Il valore di default è TipologiaProtocollo.	String
RegisterTypeField	Testo che indica il nome del campo che, nell'invio in conservazione secondo le linee guida Agid, identifica il tipo di registro. Il valore di default è TipoRegistro.	String
RegisterNumberField	Testo che indica il nome del campo che, nell'invio in conservazione secondo le linee guida Agid, identifica il numero di registro. Il valore di default è NumeroRegistro.	String
DocumentNumberField	Testo che indica il nome del campo che, nell'invio in conservazione secondo le linee guida Agid, identifica il numero del documento da conservare. Il valore di default è NumeroDocumento.	String
DocumentDateField	Testo che indica il nome del campo che, nell'invio in conservazione secondo le linee guida Agid, identifica la data del documento da conservare. Il valore di default è DataDocumento.	String
DocumentTimeField	Testo che indica il nome del campo che, nell'invio in conservazione secondo le linee guida Agid, identifica l'ora del documento da conservare. Il valore di default è OraDocumento.	String
Caratteristiche del documento
ProductionModeField	Testo che indica il nome del campo che, nell'invio in conservazione secondo le linee guida Agid, identifica la modalità di formazione del documento da conservare. Il valore di default è ModalitaDiFormazione.	String
ReservedStatusField	Testo che indica il nome del campo che, nell'invio in conservazione secondo le linee guida Agid, identifica se il documento da conservare è riservato. Il valore di default è Riservato.	String
SignedField	FirmaDigitale	String
CertifiedCopyField	CopiaConforme	String
SealedField	Sigillo	String
TimestampField	MarcaturaTemporale	String
RetentionTimeField	TempoConservazione	String
NotesField	Note	String
Prodotto Software per la realizzazione del documento
ProductNameField	Testo che indica il nome del campo che, nell'invio in conservazione secondo le linee guida Agid, identifica il nome del prodotto software per la realizzazione del documento da conservare. Il valore di default è NomeSoftware.	String
ProductVersionField	Testo che indica il nome del campo che, nell'invio in conservazione secondo le linee guida Agid, identifica la versione del prodotto software per la realizzazione del documento da conservare. Il valore di default è VersioneSoftware.	String
SoftwareManufacterField	Testo che indica il nome del campo che, nell'invio in conservazione secondo le linee guida Agid, identifica il produttore del software per la realizzazione del documento da conservare. Il valore di default è ProduttoreSoftware.	String
Descrizione e classificazione del documento
SubjectField	Oggetto	String
KeywordsListField	ParoleChiave	String
ClassificationIndexField	IndiceDiClassificazione	String
ClassificationDescriptionField	DescrizioneClassificazione	String
ClassificationPlanField	PianoDiClassificazione	String
AggregationTypeField	TipoAggregazione	String
AggregationIdField	IdAggregazione	String
Versionamento del documento e tracciature modifiche al documento
DocumentVersionField	Testo che indica il nome del campo che, nell'invio in conservazione secondo le linee guida Agid, identifica la versione del documento da conservare.	String
ModificationTypeField	Testo che indica il nome del campo che, nell'invio in conservazione secondo le linee guida Agid, identifica il tipo di modifica effettuata sul documento da conservare. Il valore di default è TipoModifica.	String
ModificationAuthorField	Testo che indica il nome del campo che, nell'invio in conservazione secondo le linee guida Agid, identifica l'autore della modifica effettuata sul documento da conservare. Il valore di default è AutoreModifica.	String
ModificationDateField	Testo che indica il nome del campo che, nell'invio in conservazione secondo le linee guida Agid, identifica la data di modifica del documento da conservare.	String
ModificationTimeField	Testo che indica il nome del campo che, nell'invio in conservazione secondo le linee guida Agid, identifica l'ora di modifica del documento da conservare.	String
PreviousVersionField	Testo che indica il nome del campo che, nell'invio in conservazione secondo le linee guida Agid, identifica la versione precedente del documento da conservare.	String
PreviousVersionPrimaryFileField	Testo che indica il nome del campo che nell'invio in conservazione, secondo le linee guida Agid, identifica la versione precedente del file principale da conservare.	String
PreviousVersionSignatureField	Testo che indica il nome del campo che, nell'invio in conservazione secondo le linee guida Agid, identifica la firma della versione precedente del documento da conservare.	String
Riferimenti ulteriori per il documento e soggetti
SourceField	RefOrigine	String
SourcePrimaryFileField	RefFilePrimario	String
SourceSignatureField	RefFileSegnatura	String
AuthorField	RefAutore	String
SenderField		String
CorrespondentField	RefListaDestinatari	String
CCCorrespondentField	RefListaDestinatariCC	String
OperatorField	RefOperatori	String
ProducerField	RefProduttore	String
RegistrantField		String
RegistrantAdministrationField		String
HDMField	RGD	String
HPSField	RSP	String
SPMField	RUP	String
AssigneeField	RefAssegnatario	String
OthersField		String

Il mapping dei metadati previsti per i soggetti non è obbligatorio, ma, se specificato, consente di poter verificare se la struttura dati che contiene le informazioni del particolare soggetto ha dei campi che consentono di classificare il soggetto come richiesto da normativa AGID.

Mapping che individua la struttura di un soggetto in Jamio DocumentConservation
Nome	Descrizione	Tipo
Descrizione della natura del soggetto
ContactTypeField	Testo che indica il nome del campo che, nell'invio in conservazione secondo le linee guida Agid, identifica la tipologia di anagrafica. Il valore di default è TipologiaAnagrafica.	String
FirstNameContactField	Testo che indica il nome del campo che, nell'invio in conservazione secondo le linee guida Agid, identifica il nome di una persona fisica. Il valore di default è Nome.	String
NameContactField	Testo che indica il nome del campo che, nell'invio in conservazione secondo le linee guida Agid, identifica la denominazione di un Ente (italiano o estero) o di una Persona Giuridica. Il valore di default è Denominazione.	String
LastNameContactField	Testo che indica il nome del campo che, nell'invio in conservazione secondo le linee guida Agid, identifica il cognome di una persona fisica. Il valore di default è Cognome.	String
FiscalCodeOrVATContactField	Testo che indica il nome del campo che, nell'invio in conservazione secondo le linee guida Agid, identifica il codice univoco del contatto (Codice Fiscale o P. IVA). Il valore di default è PIVAoCF.	String
Codici IPA
AdministrationCodeContactField	Testo che indica il nome del campo che, nell'invio in conservazione secondo le linee guida Agid, identifica il codice dell’amministrazione. Il valore di default è CodiceAmministrazione.	String
UONameContactField	Testo che indica il nome del campo che, nell'invio in conservazione secondo le linee guida Agid, identifica la denominazione di una UO italiana o estera. Il valore di default è DenominazioneUO.	String
UOCodeContactField	Testo che indica il nome del campo che, nell'invio in conservazione secondo le linee guida Agid, identifica il codice dell'UO. Il valore di default è CodiceUO.	String
AOONameContactField	Testo che indica il nome del campo che, nell'invio in conservazione secondo le linee guida Agid, identifica il nome dell'AOO dell’amministrazione Il valore di default è DenominazioneAOO.	String
AOOCodeContactField	Testo che indica il nome del campo che, nell'invio in conservazione secondo le linee guida Agid, identifica il codice AOO. Il valore di default è CodiceAOO.	String
Dati di trasporto
NominativeContactField	Testo che indica il nome del campo che, nell'invio in conservazione secondo le linee guida Agid, identifica il corrispondente Il valore di default è Nominativo.	String
TransportContactField	Testo che indica il nome del campo che, nell'invio in conservazione secondo le linee guida Agid, identifica la tipologia di trasporto. Il valore di default è TipoRecapito.	String
TransportDescriptionContactField	Testo che indica il nome del campo che, nell'invio in conservazione secondo le linee guida Agid, identifica il tipo di trasporto. Il valore di default è DescrRecapito.	String
TrackProcessingContactField	Testo che indica il nome del campo che, nell'invio in conservazione secondo le linee guida Agid, identifica se è richiesta l'interoperabilità per quel contatto. Il valore di default è ConfermaRicezione.	String
AddressContactField	Testo che indica il nome del campo che, nell'invio in conservazione secondo le linee guida Agid, identifica l'indirizzo di una persona fisica. Il valore di default è Indirizzo.
PostalAddressContactField	Testo che indica il nome del campo che, nell'invio in conservazione secondo le linee guida Agid, identifica il collegamento esteso all'indirizzo di una persona fisica. Il valore di default è IndirizzoPostale.
UpdateContactResourceField	Testo che indica il nome del campo booleano utile per richiedere l'aggiornamento dell'anagrafica. Il valore di default è AggiornaAnagrafica.	String
AddContactResorceField	Testo che indica il nome del campo booleano utile per richiedere l'inserimento in anagrafica. Il valore di default è InserisciAnagrafica.	String

E' consigliabile definire un dizionario per i valori statici per la conservazione (ad esempio il tempo di conservazione), mediante l'utilizzo di un Dato Strutturato i cui campi sono richiamabili tramite con un'espressione che utilizza la chiave riservata #configuration, ad esempio #configuration.Fields["nome_campo"].

Configurare DocumentConservation

Configurare DocumentConservation