> 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/sito-web/modello-asl/configurare-le-schede-informative-dei-servizi-forniti-dalla-asl.md).
# Configurare le schede informative dei servizi forniti dalla ASL
Servizio sanitario e prestazione sanitaria
`Servizio sanitario e prestazione sanitaria` descrive i servizi e le prestazioni erogati da un'azienda sanitaria. Per servizio si intende qualsiasi atto, obbligatorio o discrezionale, svolto dall'ente, o per suo conto, verso cittadini, imprese e professionisti.
**Identificatore:** `public_service`
| Attributo | Descrizione | Tipo di dato | Obbligatorio | Ricercabile |
| -------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------- | :----------: | :---------: |
| Tipologia del servizio (`type`) | Esprime la struttura di navigazione della sezione servizi | Tags (`eztags`) | ✓ | ✓ |
| Titolo del servizio (`name`) | Nome del servizio, facilmente comprensibile dai cittadini. Massimo 255 caratteri spazi inclusi | Linea di testo (`ezstring`) | ✓ | ✓ |
| Stato del servizio (`has_service_status`) | Indica l'effettiva fruibilità del servizio | Tags (`eztags`) | ✓ | ✓ |
| Descrizione dello stato del servizio (`status_note`) | Descrizione testuale dello stato del servizio (es. servizio momentaneamente disattivato, servizio attivo dal…) | Blocco di testo (`eztext`) | | ✓ |
| Sottotitolo (`alternative_name`) | Eventuale sottotitolo o nome che identifica informalmente il servizio. Massimo 125 caratteri spazi inclusi | Linea di testo (`ezstring`) | | ✓ |
| Descrizione breve (`abstract`) | Descrizione sintetica, con linguaggio semplice, che aiuti qualsiasi utente a capire di che servizio si tratta. Massimo 160 caratteri | Linea di testo (`ezstring`) | ✓ | ✓ |
| Immagine (`image`) | Immagine che rappresenta il servizio | Relazioni oggetti (`ezobjectrelationlist`) | | ✓ |
| Cosa serve (`has_input`) | Elenco delle cose necessarie per attivare e usufruire del servizio, documenti o altro, con le relative istruzioni | Blocco XML (`ezxmltext`) | ✓ | ✓ |
| Modulistica (`has_module_input`) | Documentazione da presentare per attivare il servizio: documenti, dichiarazioni e moduli che il cittadino può scaricare, compilare e trasmettere all'ente | Relazioni oggetti (`ezobjectrelationlist`) | | ✓ |
| Procedura (`how_to`) | Eventuale collegamento a una pagina "Come fare per" | Relazioni oggetti (`ezobjectrelationlist`) | | ✓ |
| Accedi al servizio (`service_access`) | Indicazioni per accedere al servizio o alla prestazione. Se è disponibile la prenotazione online, inserire un pulsante con il link al flusso di prenotazione | Blocco di testo (`eztext`) | ✓ | ✓ |
| Canali digitali (`has_channel`) | Canale o canali per l'attivazione del servizio, sito web, e-mail, telefono… | Relazioni oggetti (`ezobjectrelationlist`) | | ✓ |
| Tempi di attesa (`waiting_time`) | Indicazioni sulle tempistiche per usufruire del servizio secondo urgenze e organizzazione delle strutture | Blocco XML (`ezxmltext`) | ✓ | ✓ |
| Descrizione dei costi (`has_cost_description`) | Descrizione testuale dei costi del servizio | Blocco XML (`ezxmltext`) | ✓ | ✓ |
| Costi (`has_cost`) | Condizioni e termini economici per completare la procedura di richiesta del servizio | Matrice (`ezmatrix`) | | ✓ |
| Dove (`is_physically_available_at`) | Strutture presso le quali il servizio viene erogato. Indicare sia sportelli fisici sia totem | Relazioni oggetti (`ezobjectrelationlist`) | ✓ | ✓ |
| Copertura geografica (`has_spatial_coverage`) | Area geografica a cui è esteso il servizio | Comuni italiani (`openpacomuniitaliani`) | | ✓ |
| Descrizione orari del servizio (`has_temporal_coverage_description`) | Descrizione testuale degli orari del servizio | Blocco XML (`ezxmltext`) | | ✓ |
| Orari del servizio (`has_temporal_coverage`) | Orario in cui è possibile usufruire del servizio o della prestazione | Relazioni oggetti (`ezobjectrelationlist`) | ✓ | ✓ |
| Contatti (`has_online_contact_point`) | Contatti per il servizio, telefono, e-mail. In assenza di contatti specifici si possono indicare URP, CUP o la struttura che eroga il servizio | Relazioni oggetti (`ezobjectrelationlist`) | ✓ | ✓ |
| Cos'è (`description`) | Descrizione estesa e completa del servizio. Per un percorso di cura, specificare l'elenco delle prestazioni afferenti | Blocco XML (`ezxmltext`) | | ✓ |
| A chi è rivolto (`audience`) | Descrizione testuale degli utenti a cui è rivolto il servizio o la prestazione | Blocco XML (`ezxmltext`) | ✓ | ✓ |
| Utenti (`user_types`) | Voci della tassonomia Utenti associabili al servizio. Da non usare se il servizio è rivolto a tutti | Relazioni oggetti (`ezobjectrelationlist`) | | ✓ |
| Procedure collegate all'esito (`output_notes`) | Cosa fare per conoscere l'esito della procedura e dove ritirarlo, ufficio, orari, numero sportello | Blocco XML (`ezxmltext`) | | ✓ |
| Cosa si ottiene (`produces_output`) | Pagina dedicata alla descrizione dell'output, es. carta d'identità, carta dei servizi | Relazioni oggetti (`ezobjectrelationlist`) | | ✓ |
| Unità organizzativa responsabile (`holds_role_in_time`) | Ufficio responsabile dell'erogazione del servizio | Relazioni oggetti (`ezobjectrelationlist`) | ✓ | ✓ |
| Responsabile del servizio (`service_manager`) | Persona responsabile del servizio | Relazioni oggetti (`ezobjectrelationlist`) | | ✓ |
| Documenti (`has_document`) | Link alle schede documento non necessarie al completamento del servizio, ma di supporto | Relazioni oggetti (`ezobjectrelationlist`) | | ✓ |
| Servizi e prestazioni correlati (`relation_service`) | Servizi o prestazioni simili o collegati, con link alle relative pagine | Relazioni oggetti (`ezobjectrelationlist`) | | ✓ |
| Ulteriori informazioni (`more_info`) | Informazioni aggiuntive non contemplate dai campi precedenti | Blocco XML (`ezxmltext`) | | ✓ |
| Parliamo di (`topics`) | Argomenti che caratterizzano il servizio; accompagnano il cittadino nella navigazione del sito | Relazioni oggetti (`ezobjectrelationlist`) | ✓ | ✓ |
| Condizioni di servizio (`terms_of_service`) | Documenti relativi alle condizioni di servizio | File multipli (`ocmultibinary`) | | ✓ |
| Identificativo unico (`identifier`) | Codice identificativo del servizio; deve essere univoco all'interno dell'ente | Linea di testo (`ezstring`) | | ✓ |
| Parole chiave (`service_keyword`) | Parola chiave o etichetta che descrive il servizio | Tags (`eztags`) | | ✓ |
| Avvisi e notizie (`news_and_updates`) | Lista degli avvisi o notizie che riguardano il servizio, con link alle pagine di riferimento | Relazioni inverse (`openpareverserelationlist`) | | |
## Vai alla sezione "Servizi e prestazioni"
Collocati nella sezione "Servizi e prestazioni" (1) e procedi alla [creazione del contenuto](/sito-web/la-piattaforma/funzioni-generali-di-gestione-dei-contenuti/creare-un-nuovo-contenuto.md) (2).
Per prima cosa, indica la tipologia di servizio che stai creando.
Successivamente, indica il titolo del servizio (max. 255 caratteri)
## Indica lo stato del servizio
Devi specificare se il servizio è attivo, disattivato o in fase di sviluppo.
Nel caso in cui il servizio non sia disponibile per i cittadini ("In fase di sviluppo" o "Servizio non attivo"), devi indicarne il motivo ("Motivo dello stato")
## Descrivi il contenuto
Inserisci una descrizione **sintetica** che spieghi con chiarezza il tipo di servizio che stai creando.
## Indica che cosa serve
Elenca le cose necessarie per l'attivazione del servizio. Puoi anche [creare una relazione](/sito-web/la-piattaforma/funzioni-generali-di-gestione-dei-contenuti/creare-relazioni-tra-contenuti.md) tra il Servizio pubblico e un [Documento](/sito-web/modello-asl/pubblicare-la-documentazione-della-asl.md) nel campo "Modulistica"
Nel campo "Cos'è" della pagina omonima, puoi inserire una descrizione completa del servizio.
## Esponi la procedura
[Crea una relazione](/sito-web/la-piattaforma/funzioni-generali-di-gestione-dei-contenuti/creare-relazioni-tra-contenuti.md) con il *content type* "[Come fare per](/sito-web/modello-asl/amministrare-le-procedure-della-asl-come-fare-per.md)" per spiegare la procedura che gli utenti devono seguire.
## Spiega come accedere al servizio
Inserisci le indicazioni che gli utenti devono seguire per accedere al servizio. Se si tratta di un servizio digitale o attivabile su canali esterni, [crea una relazione](/sito-web/la-piattaforma/funzioni-generali-di-gestione-dei-contenuti/creare-relazioni-tra-contenuti.md) tra il contenuto e un [Canale digitale](#creare-un-canale-di-attivazione).
### Creare un canale di attivazione
Canale di erogazione del servizio
**Canale di erogazione del servizio** è una classe di supporto che descrive le modalità attraverso cui il cittadino può accedere e attivare un servizio pubblico, sia in presenza che online.
Identificatore > channel
| Attributo | Descrizione | Tipo di dato | Obbligatorio | Ricercabile |
| ------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------- | ------------ | ----------- |
| Funzione del canale (object) | Ad esempio (download App Android, download App iOS, prenotazione appuntamento, pagamento online, contatto telefonico, ...) | Linea di testo (ezstring) | X | X |
| Tipo di canale di erogazione (has\_channel\_type) | | Tags (eztags) | | X |
| Descrizione breve (abstract) | Indicare una sintetica descrizione del canale di erogazione (max 160 caratteri) utilizzando un linguaggio semplice che possa aiutare l'utente. Non utilizzare un linguaggio ricco di riferimenti normativi. | Blocco XML (ezxmltext) | X | X |
| Descrizione (description) | Descrizione generica del canale ed eventuali condizioni particolari di pagamento | Blocco XML (ezxmltext) | | X |
| Valore del canale (url) (channel\_url) | Nel caso si tratti di un indirizzo web | URL (ezurl) | X | |
| Valore del canale (channel) | Ad esempio indirizzo email, numero di telefono | Linea di testo (ezstring) | | X |
| Costo (has\_cost) | | Matrice (ezmatrix) | | X |
| Condizioni di accesso (has\_access\_condition) | | Relazioni oggetti (ezobjectrelationlist) | | X |
| Immagini (image) | Immagini rappresentative del canale | Relazioni oggetti (ezobjectrelationlist) | | X |
| Files (files) | Files rappresentative del canale (fac-simile) | File multipli (ocmultibinary) | | X |
Clicca su "Crea canale di erogazione del servizio" per creare un canale digitale da associare al contenuto.
Per creare un canale di attivazione, devi indicare:
* la funzione del canale (1);
* una descrizione breve del canale (2);
* la URL di attivazione (3).
## Specifica i tempi di attesa
Indica le tempistiche necessarie per usufruire del servizio.
## Indica gli importi da pagare
Aggiungi una descrizione dei costi previsti dal servizio e elenca tutti quelli previsti cliccando su "Aggiungi righe".
## Indica la struttura in cui viene erogato il servizio
Crea una relazione tra il contenuto e un'[Unità organizzativa-Struttura](/sito-web/modello-asl/organizzare-le-strutture-della-asl.md) per indicare le strutture, sportelli fisici o totem in cui servizio viene erogato.
## Specifica gli orari
Inserisci l'orario in cui è possibile usufruire del servizio [creando una relazione](/sito-web/la-piattaforma/funzioni-generali-di-gestione-dei-contenuti/creare-relazioni-tra-contenuti.md) tra il contenuto e un intervallo di tempo (1) oppure [creandone uno](#creare-un-orario) (2)
### Creare un orario
Orario / Intervallo di tempo
**Orario / Intervallo di tempo** è una classe di supporto che rappresenta le fasce orarie di apertura di un luogo, di uno sportello o di un servizio, riutilizzabile su più contenuti del sito.
Identificatore > opening\_hours\_specification
| Attributo | Descrizione | Tipo di dato | Obbligatorio | Ricercabile |
| ---------------------------------- | -------------------------------------------------------------------- | --------------------------------------------------------------------------- | ------------ | ----------- |
| Nome (name) | automatico: prende quello di Punto di Contatto da cui viene generato | Linea di testo (ezstring) | X | X |
| Valido dal (valid\_from) | | Data (ezdate) | X | X |
| Valido al (valid\_through) | | Data (ezdate) | | X |
| Orario d'apertura (opening\_hours) | Descrivere gli orari di apertura e chiusura | Matrice (ezmatrix) | | X |
| Note (note) | | Blocco XML (ezxmltext) | | X |
| Stagionalità (stagionalita) | | Selezione (ezselection) | X | X |
| Periodo di chiusura (closure) | Indicare i singoli giorni di chiusura, uno per riga | Matrice (ezmatrix) | | X |
| Luoghi e punti di contatto (place) | | Visualizzazione degli oggetti correlati inversi (openpareverserelationlist) | | |
| Utilizzato in (used\_by) | | Visualizzazione degli oggetti correlati inversi (openpareverserelationlist) | | |
Quando crei un nuovo orari devi indicare:
* titolo (in modo tale che sia distinguibile dagli altri);
* date di inizio e fine validità;
* gli orari di apertura;
* la stagionalità;
* eventuali periodi di chiusura.
Una volta indicate queste informazioni, clicca su "Salva" in basso a destra.
## Indica i punti di contatto
Punto di contatto
**Punto di contatto** è una classe di supporto che raccoglie le informazioni di contatto di un ufficio o di una persona, riutilizzabile su più contenuti del sito. Raggruppa un insieme di tipi di canali digitali, come email, social network, siti web, ecc.
Identificatore > online\_contact\_point
| Attributo | Descrizione | Tipo di dato | Obbligatorio | Ricercabile |
| ------------------------------------------------------------- | ----------------------------------------------------------------------- | --------------------------------------------------------------------------- | ------------ | ----------- |
| Nome del punto di contatto (name) | Es.: "Contatti Ufficio Anagrafe" | Linea di testo (ezstring) | X | X |
| Contatti (contact) | Specificare tutti i contatti | Matrice (ezmatrix) | X | X |
| Note (note) | | Blocco di testo (eztext) | | X |
| Orari di disponibilità telefonica (phone\_availability\_time) | | Relazioni oggetti (ezobjectrelationlist) | | X |
| Strutture collegate (is\_contact\_point\_of\_organizations) | Strutture (uffici, aree, organizzazioni) collegate al Punto di contatto | Visualizzazione degli oggetti correlati inversi (openpareverserelationlist) | | |
| Persone (is\_contact\_point\_of\_people) | Persone collegate al Punto di contatto | Visualizzazione degli oggetti correlati inversi (openpareverserelationlist) | | |
[Crea una relazione](/sito-web/la-piattaforma/funzioni-generali-di-gestione-dei-contenuti/creare-relazioni-tra-contenuti.md) tra il contenuto e un Punto di contatto per indicare i contatti del servizio.
## Descrivi i destinatari
Descrivi a chi è rivolto il servizio e, se utile, classifica il contenuto tramite le [pagine Utente](/sito-web/modello-asl/il-modello-di-sito-per-asl.md#le-pagine-utente).
## Indica l'ufficio responsabile
[Crea una relazione](/sito-web/la-piattaforma/funzioni-generali-di-gestione-dei-contenuti/creare-relazioni-tra-contenuti.md) tra il contenuto e un'[Unità organizzativa-Struttura](/sito-web/modello-asl/organizzare-le-strutture-della-asl.md) per indicare l'ufficio responsabile del servizio.
## Pubblica il contenuto
Una volta compilati i campi obbligatori, [pubblica il contenuto sul sito web](/sito-web/la-piattaforma/funzioni-generali-di-gestione-dei-contenuti/pubblicare-un-contenuto.md).
---
# 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 dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.opencityitalia.it/sito-web/modello-asl/configurare-le-schede-informative-dei-servizi-forniti-dalla-asl.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.