Strutture dei messaggi degli eventi

  • Articolo

In questo articolo vengono fornite informazioni sulle strutture dei messaggi degli eventi, sugli elementi obbligatori e non richiesti e sugli esempi di payload dei messaggi di eventi.

Importante

Gli eventi supportano attualmente le operazioni seguenti:

  • FhirResourceCreated : evento generato dopo la creazione di una risorsa FHIR.

  • FhirResourceUpdated : evento generato dopo che una risorsa FHIR viene aggiornata correttamente.

  • FhirResourceDeleted : l'evento generato dopo che una risorsa FHIR viene eliminato softmente.

  • DicomImageCreated : evento generato dopo la creazione di un'immagine DICOM completata.

  • DicomImageDeleted : evento generato dopo l'eliminazione di un'immagine DICOM.

  • DicomImageUpdated : l'evento generato dopo che un'immagine DICOM viene aggiornata correttamente.

Per altre informazioni sui tipi di eliminazione del servizio FHIR, vedere Funzionalità dell'API REST FHIR per il servizio FHIR di Servizi dati di integrità di Azure

Struttura dei messaggi degli eventi FHIR

Nome Tipo Obbligatoria Descrizione
topic string Sì L'argomento è l'ID risorsa di Azure dell'area di lavoro servizi dati di Integrità di Azure.
subject string Sì URI (Uniform Resource Identifier) della risorsa FHIR modificata. Il cliente può accedere alla risorsa con lo schema di https://. Il cliente deve usare dataVersion o data.resourceVersionId per visitare una versione dei dati specifica relativa a questo evento.
eventType string(enum) Sì Tipo di modifica nella risorsa FHIR.
eventTime string(datetime) Sì Ora UTC in cui viene eseguito il commit della modifica della risorsa FHIR.
id string Sì Identificatore univoco dell'evento.
data object Sì Dettagli dell'evento di modifica della risorsa FHIR.
data.resourceType string(enum) Sì Tipo di risorsa FHIR.
data.resourceFhirAccount string Sì Nome del servizio dell'account FHIR nell'area di lavoro Servizi dati di integrità di Azure.
data.resourceFhirId string Sì ID risorsa dell'account FHIR. Il servizio FHIR genera in modo casuale l'ID quando un cliente crea la risorsa. Il cliente può anche usare l'ID personalizzato nella creazione di risorse FHIR; tuttavia l'ID non deve includere o dedurre informazioni PHI/PII. Deve trattarsi di metadati di sistema, non specifici per i contenuti dei dati personali.
data.resourceVersionId string(number) Sì Versione dei dati della risorsa FHIR.
dataVersion string No Uguale a data.resourceVersionId.
metadataVersion string No Versione dello schema dei metadati dell'evento. Questo valore è definito da Griglia di eventi di Azure e deve essere costante per la maggior parte del tempo.

Esempi di messaggi di eventi FHIR

Evento FhirResourceCreated

{
  "id": "e4c7f556-d72c-e7f7-1069-1e82ac76ab41",
  "topic": "/subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft.HealthcareApis/workspaces/{workspace-name}",
  "subject": "{fhir-account}.fhir.azurehealthcareapis.com/Patient/e0a1f743-1a70-451f-830e-e96477163902",
  "data": {
    "resourceType": "Patient",
    "resourceFhirAccount": "{fhir-account}.fhir.azurehealthcareapis.com",
    "resourceFhirId": "e0a1f743-1a70-451f-830e-e96477163902",
    "resourceVersionId": 1
  },
  "eventType": "Microsoft.HealthcareApis.FhirResourceCreated",
  "dataVersion": "1",
  "metadataVersion": "1",
  "eventTime": "2021-09-08T01:14:04.5613214Z"
}

Evento FhirResourceUpdated

{
  "id": "634bd421-8467-f23c-b8cb-f6a31e41c32a",
  "topic": "/subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft.HealthcareApis/workspaces/{workspace-name}",
  "subject": "{fhir-account}.fhir.azurehealthcareapis.com/Patient/e0a1f743-1a70-451f-830e-e96477163902",
  "data": {
    "resourceType": "Patient",
    "resourceFhirAccount": "{fhir-account}.fhir.azurehealthcareapis.com",
    "resourceFhirId": "e0a1f743-1a70-451f-830e-e96477163902",
    "resourceVersionId": 2
  },
  "eventType": "Microsoft.HealthcareApis.FhirResourceUpdated",
  "dataVersion": "2",
  "metadataVersion": "1",
  "eventTime": "2021-09-08T01:29:12.0618739Z"
}

Evento FhirResourceDeleted

{
  "id": "ef289b93-3159-b833-3a44-dc6b86ed1a8a",
  "topic": "/subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft.HealthcareApis/workspaces/{workspace-name}",
  "subject": "{fhir-account}.fhir.azurehealthcareapis.com/Patient/e0a1f743-1a70-451f-830e-e96477163902",
  "data": {
    "resourceType": "Patient",
    "resourceFhirAccount": "{fhir-account}.fhir.azurehealthcareapis.com",
    "resourceFhirId": "e0a1f743-1a70-451f-830e-e96477163902",
    "resourceVersionId": 3
  },
  "eventType": "Microsoft.HealthcareApis.FhirResourceDeleted",
  "dataVersion": "3",
  "metadataVersion": "1",
  "eventTime": "2021-09-08T01:31:58.5175837Z"
}

Struttura dei messaggi degli eventi DICOM

Nome Tipo Obbligatoria Descrizione
topic string Sì L'argomento è l'ID risorsa di Azure dell'area di lavoro servizi dati di Integrità di Azure.
subject string Sì URI (Uniform Resource Identifier) dell'immagine DICOM modificata. Il cliente può accedere all'immagine con l'oggetto con https:// schema. Il cliente deve usare dataVersion o data.resourceVersionId per visitare una versione dei dati specifica relativa a questo evento.
eventType string(enum) Sì Tipo di modifica nell'immagine DICOM.
eventTime string(datetime) Sì Ora UTC in cui è stato eseguito il commit della modifica dell'immagine DICOM.
id string Sì Identificatore univoco dell'evento.
data object Sì Dettagli dell'evento di modifica dell'immagine DICOM.
data.partitionName string No Nome partizione dati.
data.imageStudyInstanceUid string Sì UID dell'istanza di studio dell'immagine.
data.imageSeriesInstanceUid string Sì UID dell'istanza di serie dell'immagine.
data.imageSopInstanceUid string Sì UID dell'istanza SOP dell'immagine.
data.serviceHostName string Sì Nome host del servizio DICOM in cui si è verificata la modifica.
data.sequenceNumber INT Sì Numero di sequenza della modifica nel servizio DICOM. Ogni creazione e eliminazione di immagini ha una sequenza univoca all'interno del servizio. Questo numero è correlato al numero di sequenza del feed di modifiche del servizio DICOM. L'esecuzione di query sul feed di modifiche del servizio DICOM con questo numero di sequenza fornisce la modifica creata dall'evento.
dataVersion string No Versione dei dati dell'immagine DICOM.
metadataVersion string No Versione dello schema dei metadati dell'evento. Ciò è definito da Griglia di eventi di Azure e deve essere costante la maggior parte del tempo.

Esempi di messaggi di eventi DICOM

DicomImageCreated

{
  "id": "d621839d-958b-4142-a638-bb966b4f7dfd",
  "topic": "/subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft.HealthcareApis/workspaces/{workspace-name}",
  "subject": "{dicom-account}.dicom.azurehealthcareapis.com/v1/partitions/Microsoft.Default/studies/1.2.3.4.3/series/1.2.3.4.3.9423673/instances/1.3.6.1.4.1.45096.2.296485376.2210.1633373143.864442",
  "data": {
    "partitionName": "Microsoft.Default",
    "imageStudyInstanceUid": "1.2.3.4.3",
    "imageSeriesInstanceUid": "1.2.3.4.3.9423673",
    "imageSopInstanceUid": "1.3.6.1.4.1.45096.2.296485376.2210.1633373143.864442",
    "serviceHostName": "{dicom-account}.dicom.azurehealthcareapis.com",
    "sequenceNumber": 1
  },
  "eventType": "Microsoft.HealthcareApis.DicomImageCreated",
  "dataVersion": "1",
  "metadataVersion": "1",
  "eventTime": "2022-09-15T01:14:04.5613214Z"
}

DicomImageDeleted

{
  "id": "eac1c1a0-ffa8-4b28-97cc-1d8b9a0a6021",
  "topic": "/subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft.HealthcareApis/workspaces/{workspace-name}",
  "subject": "{dicom-account}.dicom.azurehealthcareapis.com/v1/partitions/Microsoft.Default/studies/1.2.3.4.3/series/1.2.3.4.3.9423673/instances/1.3.6.1.4.1.45096.2.296485376.2210.1633373143.864442",
  "data": {
    "partitionName": "Microsoft.Default",
    "imageStudyInstanceUid": "1.2.3.4.3",
    "imageSeriesInstanceUid": "1.2.3.4.3.9423673",
    "imageSopInstanceUid": "1.3.6.1.4.1.45096.2.296485376.2210.1633373143.864442",
    "serviceHostName": "{dicom-account}.dicom.azurehealthcareapis.com",
    "sequenceNumber": 2
  },
  "eventType": "Microsoft.HealthcareApis.DicomImageDeleted",
  "dataVersion": "1",
  "metadataVersion": "1",
  "eventTime": "2022-09-15T01:16:07.5692209Z"
}

DicomImageUpdated

{
  "id": "83cb0f51-af41-e58c-3c6c-46344b349bc5",
  "topic": "/subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft.HealthcareApis/workspaces/{workspace-name}",
  "subject": "{dicom-account}.dicom.azurehealthcareapis.com/v1/partitions/Microsoft.Default/studies/1.2.3.4.3/series/1.2.3.4.3.9423673/instances/1.3.6.1.4.1.45096.2.296485376.2210.1633373143.864442",
  "data": {
    "partitionName": "Microsoft.Default",
    "imageStudyInstanceUid": "1.2.3.4.3",
    "imageSeriesInstanceUid": "1.2.3.4.3.9423673",
    "imageSopInstanceUid": "1.3.6.1.4.1.45096.2.296485376.2210.1633373143.864442",
    "serviceHostName": "{dicom-account}.dicom.azurehealthcareapis.com",
    "sequenceNumber": 2
  },
  "eventType": "Microsoft.HealthcareApis.DicomImageUpdated",
  "dataVersion": "1",
  "metadataVersion": "1",
  "eventTime": "2023-06-09T16:55:44.7197137Z"
}

Passaggi successivi

In questo articolo sono state illustrate le strutture dei messaggi degli eventi.

Per informazioni su come distribuire gli eventi usando la portale di Azure, vedere

Distribuire eventi usando l'portale di Azure

FHIR® è un marchio registrato di Health Level Seven International, registrato in U.S. Trademark Office e viene usato con l'autorizzazione.