> For the complete documentation index, see [llms.txt](https://docs.opencityitalia.it/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.opencityitalia.it/stanza-del-cittadino/sviluppatori-e-partner-tecnologici/integrazioni/integrazione-con-protocollo-informatico/workflow-sistema-di-protocollazione/configurazione-tenant-e-servizi.md). # Configurazione tenant e servizi ## Panoramica La configurazione di tenant e servizi avviene interrogando delle API apposite fornite dal Protocol Proxy di riferimento. Quest'ultimo fornisce inoltre un form come json schema sviluppato con form.io mediante il quale l'utente inserisce tali configurazioni. Per creare un form utilizzare il seguente builder: ## Configurazione Servizio L'admin, dall'interfaccia di configurazione dei protocolli della piattaforma compila la configurazione mediante una form, il cui json schema è servito dall'API `/v1/schema` del Protocol Proxy

Esempio interfaccia configurazione protocollo

Lo schema della form sopra riportata è il seguente: ```json { "display": "form", "settings": null, "components": [ { "label": "UUID dell'ente", "placeholder": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX", "applyMaskOn": "change", "hidden": true, "tableView": true, "validate": { "required": true }, "key": "tenant_id", "type": "textfield", "input": true }, { "label": "UUID del Servizio", "placeholder": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX", "applyMaskOn": "change", "hidden": true, "tableView": true, "validate": { "required": true }, "key": "id", "type": "textfield", "input": true }, { "label": "Descrizione del servizio", "placeholder": "Comune di Bugliano", "applyMaskOn": "change", "hidden": true, "tableView": true, "validate": { "required": true }, "key": "description", "type": "textfield", "input": true, "defaultValue": "test" }, { "label": "Impostazioni specifiche del protocollo", "tableView": false, "validate": { "required": false }, "key": "registry", "type": "container", "input": true, "components": [ { "label": "URL Protocollazione", "placeholder": "http://www.example.com/", "tableView": true, "validate": { "required": true }, "key": "url", "type": "textfield", "input": true }, { "label": "Gerarchia di Classificazione", "placeholder": "1.2.3", "tableView": true, "validate": { "required": false }, "key": "classification_hierarchy", "type": "textfield", "input": true }, { "label": "Numero Fascicolo", "placeholder": "1", "tableView": true, "validate": { "required": false }, "key": "folder_number", "type": "textfield", "input": true }, { "label": "Anno Fascicolo", "placeholder": "2022", "tableView": true, "validate": { "required": false }, "key": "folder_year", "type": "textfield", "input": true } ] }, { "label": "Attivo", "tableView": false, "validate": { "required": false }, "key": "is_active", "type": "checkbox", "input": true, "defaultValue": false }, { "label": "Salva", "tableView": false, "validate": { "required": false }, "key": "submit", "type": "button", "input": true, "disableOnInvalid": true } ] } ``` Premendo poi il bottone Salva, viene eseguita una `POST /services` servita dal Protocol Proxy, con payload ```json { "data": { "tenant_id": "", "id": "", "description": " ", "registry": { "url": "url.protocollo.it", "classification_hierarchy": "1.2.3", "folder_number": "1", "folder_year": "2023" }, "is_active": true, "submit": false }, "metadata": {} } ``` Per modificare una configurazione esistente, il proxy serve l'API `PUT /services/{service_id}` e `PATCH /services/{service_id}` Per eliminare una configurazione esistente, il proxy serve l'API `DELETE /services/{service_id}` . In questo caso l'eliminazione è una *soft-delete*, ovvero la configurazione viene semplicemente disattivata settando il parametro `active` a `false`. ## Configurazione del tenant la configurazione del tenant avviene in maniera nascosta durante la configurazione del servizio. Sarà la piattaforma a chiamare le API del Protocol Proxy. La loro implementazione è descritta nella [sezione seguente](/stanza-del-cittadino/sviluppatori-e-partner-tecnologici/integrazioni/integrazione-con-protocollo-informatico/protocol-proxy-specifiche-implementative.md#documentazione-api-swagger) ## Alberatura configurazioni sullo storage Le configurazioni di tenant e servizi vengono salvate con la seguente alberatura `root`\ `|____tenants`\ `| |____tenantid1.json`\ `| |____tenantid2.json`\ `| |____tenantid3.json`\ `| |____.....`\ `| |____tenantidn.json`\ `|____services`\ `| |____serviced1.json`\ `| |____serviced2.json`\ `| |____serviced3.json`\ `| |____.....`\ `| |____servicedn.json` --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.opencityitalia.it/stanza-del-cittadino/sviluppatori-e-partner-tecnologici/integrazioni/integrazione-con-protocollo-informatico/workflow-sistema-di-protocollazione/configurazione-tenant-e-servizi.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.