To do list per la preparazione della prima versione della HL7 IT base IG.


Typos

Marco Devanna, Segnalo alcune lievi imperfezioni:

  • In "Caveat":   in questa guida hanno come loro principalmente scopo quello  
  • 3.2. MustSupport 3.2.1 Descrizione generale musSupport è una proprietà....
  • .... Il lettore non deve confondere inoltre mustSupport e cardinalità di un elemento: è infatti del tutto lecvito  

Value Set & Code Systems

  1. clean-up titoli e descrizioni (armonizzare)
  2. http://hl7.it/fhir/ValueSet/istat-stati: filtrare solo per stati (il filtro su code o su SoT sembra non funzionare)
  3. http://hl7.it/fhir/ValueSet/istat-comuni: filtrare solo per stati (il filtro su code sembra non funzionare)
  4. ValueSet tipoEntità: http://www.hl7.it/fhir/sandbox/site/CodeSystem-tipoEntita.html - Nel summary, la definizione fa riferimento al valueset tipo di certificatore  http://www.hl7.it/fhir/sandbox/site/ValueSet-tipoCertificatore.html : (“I codici delle diverse entità che possono certificare i record Paziente, l'indirizzo di Residenza ed il Codice Fiscale”) ma in realtà questo valueset è usato anche per l'organization.type, per es. per l'azienda sanitaria 

Esempi

  1. creare set di esempi per ogni tipo di risorsa estensione

Modelli Logici

  1. rivedere gli elementi mustSupport
  2. valutare se introdurre l'organizzazione o persona rilasciante nell'Esenzione ? (postponed)

Profili

Patient

  1.   patient citizenship http://hl7.org/fhir/R4/extension-patient-citizenship.html forse si può fare un binding preferred oppure example su istat?  
    1. Aggiunto,da compilare..
  2.   recordCertification (http://www.hl7.it/fhir/build/it-base/site/StructureDefinition-recordCertification.html)
    1. i tre elementi dell'estensione complessa nello snapshot mostrano a loro volta delle estensioni, questo forse non è necessario? 
      1. .. forse non saranno mai usate ma non vedo ragioni per escludere questa possibilità...
    2. Errore ortografico della descrizione: (Estensione usata per indicare che l’informazione associata è stata certificata (od autocertificata) da una certa entità (persona, organizzazione). L’estensione è carattrizzata da:\ * una data di certificazione o da una periodo di validità\ * un codice or un riferimento al certificatore.) 
      1. un tag di markdown non processato corettamente dal publisher; tolto a capo ed indentazione

Address

  1. http://www.hl7.it/fhir/build/it-base/site/StructureDefinition-Address-it-base.html - mi sembra che non sia espressa la codifica dei comuni, provincie, stati etc.
    1. il binding c'è ma non viene visualizzato...
  2. testare i constraint
  3. Un chiarimento: nell'address non sono evidenziati campi strutturati per interno o scala etc. Questo è perché è stato deciso di rimandare queste ulteriori specifiche a possibili estensioni regionali, giusto? Per esempio:
    1. questa estensione permette di gestire i civici con numero barrato: http://hl7.org/fhir/R4/extension-iso21090-adxp-buildingnumbersuffix.html
    2. Queste due estensioni permettono di gestire gli interni http://hl7.org/fhir/R4/extension-iso21090-adxp-unitid.html+ http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-unitType  (scala, appartamento, piano, …)   

Practictioner

  1. In aggiunta al commento di Regione Veneto su Practitioner: anche in FVG per i MMG/PLS si utilizza il CRM (codice regionale del medico) per identificarlo ad esempio nelle prassi amministrative di assegnazione di un medico. Viene assegnato dall'azienda sanitaria che gli affida l'incarico e vale per la durata dell'incarico. Se possibile aggiungerei questo tra i business identifier del Practitioner italiano. Lo identifica come medico operante in una data azienda (possono operare in più aziende). Il CF lo identifica come persona per es. come autore di una prescrizione.

PractictionerRole

  1. http://www.hl7.it/fhir/build/it-base/site/StructureDefinition-PractitionerRole-it-mmg.html  
    1. - esiste una codifica italiana per la specializzazione? qui è riportata la codifica internazionale. non è certo il nucleo minimo, però forse è da considerare per future versioni.
    2. - se si volesse riportare gli orari degli ambulatori, non mi sembra ci sia spazio per riportare l'orario di uno specifico ambulatorio. Anche questo si potrebbe considerare per futura versione
    3. - noi riportiamo anche il periodo di validita rapporto MMG-paziente, ed eventualmente il motivo. Il dato andrebbe nel Patient, però lo standard non lascia spazio. Noi l'avevamo inserito nel contract, se puo essere un suggerimento.


Tessera TEAM

(Elena Vio)

Ho visto che c'è il modello logico della TEAM, ma poi non è riportato nelle risorse. Se si è scelto di non definirlo per ora, ok. Altrimenti, se serve noi abbiamo una proposta

id persona team estera inserito all'interno dell'elemento identifier: Id Persona TEAM deve essere sempre accompagnato anche con l’id Persona TEAM. Valorizzazione con sigla di identificazione dello stato che rilascia la tessera secondo il codice ISO 3166-1 a 3 caratteri (ad es. FRA) + "." + numero di identificazione personale estero

            <identifier>

               <type>

                  <text value="ID_TEAM_ESTERO" />

               </type>

               <system value="urn:oid:2.16.840.1.113883.2.9.4.3.3" />

               <value value="FRA.012345789AA" />

            </identifier>    


Per id tessera team inserito all'interno dell'elemento identifier: Id tessera TEAM deve essere sempre accompagnato anche con l’id Persona TEAM. valorizzazione con sigla di identificazione dello stato che rilascia la tessera secondo il codice ISO 3166-1 a 3 caratteri (ad es. FRA) + "." + numero seriale tessera estero

<identifier>

               <type>

                  <text value="TESSERA_TEAM_ESTERO" />

               </type>

               <system value="urn:oid:2.16.840.1.113883.2.9.4.3.7" />

               <value value="FRA.80300000502388282182" />

               <period>

                  <start value="2015-09-18" />

                  <end value="2023-10-18" />

               </period>

               <assigner>

                  <identifier>

                     <value value="FRANCE- 4000XX" />

                  </identifier>

               </assigner>

            </identifier>



Per tema italiano:

<identifier>

      <!-- tessera TEAM -->

      <type>

         <text value="TesseraTEAM" />

      </type>

      <system value="urn:oid:2.16.840.1.113883.2.9.4.1.4" />

      <value value="500000987654321" />

      <period>

         <start value="1970-01-01" />

      </period>

      <assigner>

         <identifier>

            <value value="SSN-MIN SALUTE - 500001" />

         </identifier>

      </assigner>

   </identifier>

Processati

  1. tutti i code system italiani: concordare una naming convention per le terminlogie italiane (e.g. http://terminology.hl7.it/CodeSystem/it-identifier-type).
    1. tutti i code system generali sotto http://terminology.hl7.it/CodeSystem/it-identifier-type
    2. se pubblicato da altri e per vari motivi non inseribile in terminology.hl7.it ==> hl7.it/sid
  2. uniformare i nomi per le estensioni; decidere se mantenere una dizione in Italiano of in inglese
    1. uniformati tutti in inglese
  3. verificare stato official-address (inviata richiesta su chat.fhir.org)
    1. nessuna risposta almeno fino a fine giungo. Aggiunta una nota alla pagina. 

  4. http://www.hl7.it/fhir/build/it-base/site/CodeSystem-it-tipoEntita.html- si potrebbe aggiungere anche il tipo di organizzazione "distretto"? Nel nostro contesto lo utilizziamo

    1. aggiunto distretto e sottoorganizzazioni di azienda sanitaria.

  5. http://www.hl7.it/fhir/build/it-base/site/StructureDefinition-Coverage-it-base.html - converage.status: va specificato meglio la descrizione dei valori della codifica in italiano, visto che il campo è obbligatorio.

  6. http://www.hl7.it/fhir/build/it-base/site/ValueSet-StatoEsenzione-V3ActStatus.html - anche qui, servirebbe una spiegazione in italiano. 

    1. aggiunta spiegazione in Italiano

  7. http://www.hl7.it/fhir/build/it-base/site/CodeSystem-AE-codiciCatastali.html - credo ci sia un errorre perchè la descrizione parla di codici ISTAT, mentre la tabella contiene codici catastali

  8. http://www.hl7.it/fhir/build/it-base/site/StructureDefinition-Address-it-base.html - nello snapshot table, in particolare nel type, non è stato riportato il significato dei codici address use

  9. http://www.hl7.it/fhir/build/it-base/site/StructureDefinition-Address-it-base.html - in iso21090-ADXP-houseNumber c'è un errore credo nell'esempio: c'è scritto "Corta" come esempio di numero civico

    1. 'corta' si riferisce a streetNameBase

  10. http://www.hl7.it/fhir/build/it-base/site/StructureDefinition-Address-it-base.html - nello snapshot table, in particolare nel type, non è stato riportato il significato dei codici address use

    1. aggiunto spiegazione nell pagina address

  11. http://www.hl7.it/fhir/build/it-base/site/StructureDefinition-Organization-it-ausl.html  - type.coding.code: in veneto si chiamano ulss e non ausl. Capire se si può utilizzare un termine comune o estendere?

    1. il code è in prinicipio asemantico, identifica un concetto non lo rappresenta. Aggiunta descrizione, il codice asl copre anche ulss.

  12. http://www.hl7.it/fhir/build/it-base/site/StructureDefinition-Organization-it-base.html - nella risorsa Organization per Aziende sanitarie, hai riportato di utilizzare la codifica Tipo Entità per il type. Però nelle organizzazioni generiche non l'hai riportato. E' voluto? 

    1. Si, ma ora è stato aggiunto un binding di esempio

  13. http://www.hl7.it/fhir/build/it-base/site/StructureDefinition-Practitioner-it-base.html - nei nostri servizi anagrafici, noi riportiamo il codice regionale del medico e non sempre il codice fiscale. 

    1. lo slice è di tipo open. lo slice CF non è neanche mustSupport. se abbiamo una serie ragionevole di uri possiamo aggiungere una slice per i codici regionali.
  14. http://www.hl7.it/fhir/ValueSet/ValueSet-statoCivile e http://www.hl7.it/fhir/ValueSet/UriIdRegionali non funzionano
  15. http://www.hl7.it/fhir/build/it-base/site/StructureDefinition-Organization-it-ausl.html  - identifier.value: la codifica penso sia FLS11, ma non è riportato in questo elemento.
    1. aggiunto voc binding per il value
  16. nella descrizione e nei reference degli slice generalPractitioner ci sono gli URI errati nei Reference: (a) generalPractitioner:mmgPlsRole ha un reference a http://hl7.it/fhir//StructureDefinition/PractitionerRole-mmg-it(no profile found) anziché  http://hl7.it/fhir/StructureDefinition/PractitionerRole-it-mmg ; (b) generalPractitioner:mmgPls ha un reference a http://hl7.it/fhir//StructureDefinition/Practitioner-mmg-it(no profile found) anziché  http://hl7.it/fhir/StructureDefinition/Practitioner-it-base   (c) generalPractitioner:mmgPlsAzienda: http://hl7.it/fhir//StructureDefinition/Organization-AziendaSanitaria-it(no profile found) anziché http://hl7.it/fhir/StructureDefinition/Organization-it-ausl  
    1. i link sembrano funzionare... forse è stata guardata la vecchia pubblicazione ? (http://www.hl7.it/fhir/sandbox/site/StructureDefinition-Patient-it-base.html)


To do list per la preparazione della prima versione della HL7 IT base IG.


Value Set & Code Systems

  1. clean-up titoli e descrizioni (armonizzare)
  2. http://hl7.it/fhir/ValueSet/istat-stati: filtrare solo per stati (il filtro su code o su SoT sembra non funzionare)
  3. http://hl7.it/fhir/ValueSet/istat-comuni: filtrare solo per stati (il filtro su code sembra non funzionare)
  4. fls11, STS, HSP,..quale URL sid o code system od entrambi ?
  5. ValueSet tipoEntità: http://www.hl7.it/fhir/sandbox/site/CodeSystem-tipoEntita.html - Nel summary, la definizione fa riferimento al valueset tipo di certificatore  http://www.hl7.it/fhir/sandbox/site/ValueSet-tipoCertificatore.html : (“I codici delle diverse entità che possono certificare i record Paziente, l'indirizzo di Residenza ed il Codice Fiscale”) ma in realtà questo valueset è usato anche per l'organization.type, per es. per l'azienda sanitaria 

Esempi

  1. creare set di esempi per ogni tipo di risorsa estensione

Modelli Logici

  1. rivedere gli elementi mustSupport
  2. valutare se introdurre l'organizzazione o persona rilasciante nell'Esenzione ? (postponed)

Profili

Patient

  1.   patient citizenship http://hl7.org/fhir/R4/extension-patient-citizenship.html forse si può fare un binding preferred oppure example su istat?  
    1. Aggiunto,da compilare..
  2.   recordCertification (http://www.hl7.it/fhir/build/it-base/site/StructureDefinition-recordCertification.html)
    1. i tre elementi dell'estensione complessa nello snapshot mostrano a loro volta delle estensioni, questo forse non è necessario? 
      1. .. forse non saranno mai usate ma non vedo ragioni per escludere questa possibilità...
    2. Errore ortografico della descrizione: (Estensione usata per indicare che l’informazione associata è stata certificata (od autocertificata) da una certa entità (persona, organizzazione). L’estensione è carattrizzata da:\ * una data di certificazione o da una periodo di validità\ * un codice or un riferimento al certificatore.) 
      1. un tag di markdown non processato corettamente dal publisher; tolto a capo ed indentazione

Address

  1. http://www.hl7.it/fhir/build/it-base/site/StructureDefinition-Address-it-base.html - mi sembra che non sia espressa la codifica dei comuni, provincie, stati etc.
    1. il binding c'è ma non viene visualizzato...
  2. testare i constraint
  3. Un chiarimento: nell'address non sono evidenziati campi strutturati per interno o scala etc. Questo è perché è stato deciso di rimandare queste ulteriori specifiche a possibili estensioni regionali, giusto? Per esempio:
    1. questa estensione permette di gestire i civici con numero barrato: http://hl7.org/fhir/R4/extension-iso21090-adxp-buildingnumbersuffix.html
    2. Queste due estensioni permettono di gestire gli interni http://hl7.org/fhir/R4/extension-iso21090-adxp-unitid.html+ http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-unitType  (scala, appartamento, piano, …)   

Practictioner

  1. In aggiunta al commento di Regione Veneto su Practitioner: anche in FVG per i MMG/PLS si utilizza il CRM (codice regionale del medico) per identificarlo ad esempio nelle prassi amministrative di assegnazione di un medico. Viene assegnato dall'azienda sanitaria che gli affida l'incarico e vale per la durata dell'incarico. Se possibile aggiungerei questo tra i business identifier del Practitioner italiano. Lo identifica come medico operante in una data azienda (possono operare in più aziende). Il CF lo identifica come persona per es. come autore di una prescrizione.

PractictionerRole

  1. http://www.hl7.it/fhir/build/it-base/site/StructureDefinition-PractitionerRole-it-mmg.html  
    1. - esiste una codifica italiana per la specializzazione? qui è riportata la codifica internazionale. non è certo il nucleo minimo, però forse è da considerare per future versioni.
    2. - se si volesse riportare gli orari degli ambulatori, non mi sembra ci sia spazio per riportare l'orario di uno specifico ambulatorio. Anche questo si potrebbe considerare per futura versione
    3. - noi riportiamo anche il periodo di validita rapporto MMG-paziente, ed eventualmente il motivo. Il dato andrebbe nel Patient, però lo standard non lascia spazio. Noi l'avevamo inserito nel contract, se puo essere un suggerimento.


Tessera TEAM

(Elena Vio)

Ho visto che c'è il modello logico della TEAM, ma poi non è riportato nelle risorse. Se si è scelto di non definirlo per ora, ok. Altrimenti, se serve noi abbiamo una proposta

id persona team estera inserito all'interno dell'elemento identifier: Id Persona TEAM deve essere sempre accompagnato anche con l’id Persona TEAM. Valorizzazione con sigla di identificazione dello stato che rilascia la tessera secondo il codice ISO 3166-1 a 3 caratteri (ad es. FRA) + "." + numero di identificazione personale estero

            <identifier>

               <type>

                  <text value="ID_TEAM_ESTERO" />

               </type>

               <system value="urn:oid:2.16.840.1.113883.2.9.4.3.3" />

               <value value="FRA.012345789AA" />

            </identifier>    


Per id tessera team inserito all'interno dell'elemento identifier: Id tessera TEAM deve essere sempre accompagnato anche con l’id Persona TEAM. valorizzazione con sigla di identificazione dello stato che rilascia la tessera secondo il codice ISO 3166-1 a 3 caratteri (ad es. FRA) + "." + numero seriale tessera estero

<identifier>

               <type>

                  <text value="TESSERA_TEAM_ESTERO" />

               </type>

               <system value="urn:oid:2.16.840.1.113883.2.9.4.3.7" />

               <value value="FRA.80300000502388282182" />

               <period>

                  <start value="2015-09-18" />

                  <end value="2023-10-18" />

               </period>

               <assigner>

                  <identifier>

                     <value value="FRANCE- 4000XX" />

                  </identifier>

               </assigner>

            </identifier>



Per tema italiano:

<identifier>

      <!-- tessera TEAM -->

      <type>

         <text value="TesseraTEAM" />

      </type>

      <system value="urn:oid:2.16.840.1.113883.2.9.4.1.4" />

      <value value="500000987654321" />

      <period>

         <start value="1970-01-01" />

      </period>

      <assigner>

         <identifier>

            <value value="SSN-MIN SALUTE - 500001" />

         </identifier>

      </assigner>

   </identifier>

Processati

  1. tutti i code system italiani: concordare una naming convention per le terminlogie italiane (e.g. http://terminology.hl7.it/CodeSystem/it-identifier-type).
    1. tutti i code system generali sotto http://terminology.hl7.it/CodeSystem/it-identifier-type
    2. se pubblicato da altri e per vari motivi non inseribile in terminology.hl7.it ==> hl7.it/sid
  2. uniformare i nomi per le estensioni; decidere se mantenere una dizione in Italiano of in inglese
    1. uniformati tutti in inglese
  3. verificare stato official-address (inviata richiesta su chat.fhir.org)
    1. nessuna risposta almeno fino a fine giungo. Aggiunta una nota alla pagina. 

  4. http://www.hl7.it/fhir/build/it-base/site/CodeSystem-it-tipoEntita.html- si potrebbe aggiungere anche il tipo di organizzazione "distretto"? Nel nostro contesto lo utilizziamo

    1. aggiunto distretto e sottoorganizzazioni di azienda sanitaria.

  5. http://www.hl7.it/fhir/build/it-base/site/StructureDefinition-Coverage-it-base.html - converage.status: va specificato meglio la descrizione dei valori della codifica in italiano, visto che il campo è obbligatorio.

  6. http://www.hl7.it/fhir/build/it-base/site/ValueSet-StatoEsenzione-V3ActStatus.html - anche qui, servirebbe una spiegazione in italiano. 

    1. aggiunta spiegazione in Italiano

  7. http://www.hl7.it/fhir/build/it-base/site/CodeSystem-AE-codiciCatastali.html - credo ci sia un errorre perchè la descrizione parla di codici ISTAT, mentre la tabella contiene codici catastali

  8. http://www.hl7.it/fhir/build/it-base/site/StructureDefinition-Address-it-base.html - nello snapshot table, in particolare nel type, non è stato riportato il significato dei codici address use

  9. http://www.hl7.it/fhir/build/it-base/site/StructureDefinition-Address-it-base.html - in iso21090-ADXP-houseNumber c'è un errore credo nell'esempio: c'è scritto "Corta" come esempio di numero civico

    1. 'corta' si riferisce a streetNameBase

  10. http://www.hl7.it/fhir/build/it-base/site/StructureDefinition-Address-it-base.html - nello snapshot table, in particolare nel type, non è stato riportato il significato dei codici address use

    1. aggiunto spiegazione nell pagina address

  11. http://www.hl7.it/fhir/build/it-base/site/StructureDefinition-Organization-it-ausl.html  - type.coding.code: in veneto si chiamano ulss e non ausl. Capire se si può utilizzare un termine comune o estendere?

    1. il code è in prinicipio asemantico, identifica un concetto non lo rappresenta. Aggiunta descrizione, il codice asl copre anche ulss.

  12. http://www.hl7.it/fhir/build/it-base/site/StructureDefinition-Organization-it-base.html - nella risorsa Organization per Aziende sanitarie, hai riportato di utilizzare la codifica Tipo Entità per il type. Però nelle organizzazioni generiche non l'hai riportato. E' voluto? 

    1. Si, ma ora è stato aggiunto un binding di esempio

  13. http://www.hl7.it/fhir/build/it-base/site/StructureDefinition-Practitioner-it-base.html - nei nostri servizi anagrafici, noi riportiamo il codice regionale del medico e non sempre il codice fiscale. 

    1. lo slice è di tipo open. lo slice CF non è neanche mustSupport. se abbiamo una serie ragionevole di uri possiamo aggiungere una slice per i codici regionali.
  14. http://www.hl7.it/fhir/ValueSet/ValueSet-statoCivile e http://www.hl7.it/fhir/ValueSet/UriIdRegionali non funzionano
  15. http://www.hl7.it/fhir/build/it-base/site/StructureDefinition-Organization-it-ausl.html  - identifier.value: la codifica penso sia FLS11, ma non è riportato in questo elemento.
    1. aggiunto voc binding per il value
  16. nella descrizione e nei reference degli slice generalPractitioner ci sono gli URI errati nei Reference: (a) generalPractitioner:mmgPlsRole ha un reference a http://hl7.it/fhir//StructureDefinition/PractitionerRole-mmg-it(no profile found) anziché  http://hl7.it/fhir/StructureDefinition/PractitionerRole-it-mmg ; (b) generalPractitioner:mmgPls ha un reference a http://hl7.it/fhir//StructureDefinition/Practitioner-mmg-it(no profile found) anziché  http://hl7.it/fhir/StructureDefinition/Practitioner-it-base   (c) generalPractitioner:mmgPlsAzienda: http://hl7.it/fhir//StructureDefinition/Organization-AziendaSanitaria-it(no profile found) anziché http://hl7.it/fhir/StructureDefinition/Organization-it-ausl  
    1. i link sembrano funzionare... forse è stata guardata la vecchia pubblicazione ? (http://www.hl7.it/fhir/sandbox/site/StructureDefinition-Patient-it-base.html)


  • No labels

4 Comments

  1. Luca DelCol

    salve a tutti,

    in merito a quanto declinato per le Pagine IG, suggerisco quanto segue, sperando di non dire cose già ovvie.

    Gli elementi di una risorsa definiti come “mustSupport = true" potrebbero far parte di un doc di Affinity Domain (quale allegato alla IG) condiviso ed adottato da tutti gli attori che implementano le specifiche FHIR all’interno dei propri sistemi, al fine di garantirne interoperabilità nell’interscambio dati. In tale documemto si indicherà, per ogni attributo/elemento indicato come mustSupport:

    • codifica da usare nel Type (code+codingScheme+display)
    • tipo di operazione ammessa (CRUD)
    • obbligatorietà di valorizzazione all’interno delle transazioni in interoperabilità previste dal profilo di comunicazione adottata tra attori producer/consumer
    • esempio di valorizzazione (XML, Jason, RDF)
    • ............

    Nel doc di AD potrebbe essere definita anche una sezione destinata ai vocabolari utilizzati per il binding e alle codifiche stabilite per i Type codable_concept e code.

    luca

  2. Luca DelCol

    salve, l'IG mi pare ad un buon livello di consolidamento.

    Offro un mio contributo, se può essere utile.

    In "HL7 V3 RoleCode (Estensione)" sono riportate le codifiche per MmgPlsRole. Poichè codifiche simili sono definite ed adottate nell'Affinty Domain nazionale del FSE (FascicoloSanitario Elettronico), suggerirei di inserire una proposta di mapping tra queste codifiche speciche dell'IG e quelle dell'AD nazionale (nella sezione 9.0.7 Concept Maps), in ottica di supportare interoperabilità anche nell'ampio contesto del FSE.

    1. Giorgio Cangioli

      Ciao Luca, i codici sono quelli usati in uno dei documenti CDA pubblicati; se puoi condividere il documento a cui ti riferisci ne possiamo parlare nella call di oggi ? 

  3. Luca DelCol

    Allego il PDF del doc di AD nazionale a cui mi riferisco