Tabella dei contenuti
Esportazione e importazione
La funzionalità di esportazione e importazione consente di trasferire una versione di e-service da un ambiente di PDND a un altro, così da facilitarne la messa in produzione, il riuso e la distribuzione tra enti che collaborano.
Questa funzionalità è utile per:
- promuovere in produzione un e-service che ha superato il collaudo;
- trasferire e-service tra ambienti gestiti dallo stesso ente;
- replicare un e-service presso più enti (ad esempio nel caso di Partner Tecnologici).
Caveat all'importazione
Durante l’importazione, il sistema fornisce indicazioni utili al debugging in caso di problemi di coerenza. In particolare:
- Attributi – gli attributi non vengono trasferiti da un ambiente all’altro; vanno riassegnati manualmente nel nuovo ambiente.
- Duplicazione dell’e-service – se nell’ambiente di destinazione esiste già un e-service con stesso nome e stesso ente, l’importazione non viene eseguita. È possibile rinominare l’e-service nel pacchetto .zip prima di riprovare.
- Struttura dell’archivio – il pacchetto .zip deve essere coerente con il file di configurazione (campi presenti e formattati correttamente; file indicati esistenti; assenza di file estranei non mappati).
- Interfaccia API – le URL dei server presenti nel file di interfaccia possono variare tra ambienti, secondo le scelte infrastrutturali dell’ente.
Struttura del pacchetto .zip
Il pacchetto di importazione contiene tutto il necessario per descrivere versione e documentazione dell’e-service.
- configuration.json – descrive il contenuto dell’e-service e la posizione degli altri file nello .zip. Il nome del file non deve essere modificato. Se non è presente, l’importazione non può proseguire.
- nome_file.[yaml|json|wsdl] – file di interfaccia (OpenAPI per REST o WSDL per SOAP). Il nome può essere cambiato, aggiornando il riferimento nel configuration.json.
- Altri file – documentazione tecnica allegata alla versione (manuali, esempi, ecc.); i percorsi devono corrispondere a quanto indicato in configurazione.
Tutti i campi del configuration.json sono obbligatori. Anche se non utilizzati, devono essere presenti con il valore di default.
E-service
| Nome campo | Tipo | Descrizione |
|---|---|---|
| name | String | Nome dell’e-service (5–60 caratteri, spazi inclusi). Deve essere univoco per ente. |
| description | String | Descrizione dell’e-service (10–250 caratteri, spazi inclusi). |
| technology | REST | SOAP | Tecnologia dell’API erogata. L’estensione del file di interfaccia deve essere coerente. |
| mode | DELIVER | RECEIVE | Modalità dell’e-service (erogazione diretta o inversa). In RECEIVE è obbligatoria almeno una voce in riskAnalysis; in DELIVER non devono essercene. [correzione: corretto REICEVE in RECEIVE] |
| descriptor | Descriptor | Contenuto della versione dell’e-service (vedi tabella Descriptor). |
| riskAnalysis | Array<RiskAnalysis> | Analisi del rischio richieste per gli e-service in modalità RECEIVE (default: []). |
Descriptor
| Nome campo | Tipo | Descrizione |
|---|---|---|
| description | String | Descrizione della versione (10–250 caratteri, spazi inclusi). |
| interface | Document | Documento che descrive l’interfaccia API erogata. |
| docs | Array<Document> | Documenti allegati alla versione (es. documentazione tecnica). Default: []. |
| audience | Array<String> | Audience della risorsa. In genere è inserita una sola stringa. |
| voucherLifespan | Number | Durata del voucher in secondi (valori consentiti: 60–86_400, cioè 1 minuto–24 ore). |
| dailyCallsPerConsumer | Number | Soglia chiamate per fruitore (chiamate API/giorno). Valori ≥ 1. |
| dailyCallsTotal | Number | Soglia chiamate totali (API/giorno) ≥ dailyCallsPerConsumer. |
| agreementApprovalPolicy | AUTOMATIC | MANUAL | Politica di approvazione delle richieste di fruizione. |
Document
| Nome campo | Tipo | Descrizione |
|---|---|---|
| prettyName | String | Nome “parlante” mostrato agli utenti (5–60 caratteri, spazi inclusi). |
| path | String | Percorso del file a partire dal configuration.json. |
RiskAnalysis
| Nome campo | Tipo | Descrizione |
|---|---|---|
| name | String | Nome assegnato all’analisi del rischio (5–60 caratteri). |
| riskAnalysisForm | RiskAnalysisForm | Contenuto strutturato dell’analisi del rischio. |
RiskAnalysisForm
| Nome campo | Tipo | Descrizione |
|---|---|---|
| version | String | Versione del modello di analisi (es. 3.0 per le PA). |
| singleAnswers | Array<RiskAnalysisSingleAnswer> | Risposte a scelta singola. |
| multiAnswers | Array<RiskAnalysisMultiAnswer> | Risposte a scelta multipla. |
RiskAnalysisSingleAnswer
| Nome campo | Tipo | Descrizione |
|---|---|---|
| key | String | Chiave che identifica la domanda nel template (es. institutionalPurpose per la finalità istituzionale). |
| value | String | Risposta alla domanda identificata dalla chiave. |
RiskAnalysisMultiAnswer
| Nome campo | Tipo | Descrizione |
|---|---|---|
| key | String | Chiave che identifica la domanda nel template (es. institutionalPurpose). |
| values | Array<String> | Elenco delle risposte selezionate. |
Pagina successiva → Soglie e approvazioni
Hai bisogno di aiuto?
Apri un ticket utilizzando l’apposita funzione all’interno della tua Area Riservata
