Condividi tramite

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 degli eventi.

Importante

Gli eventi supportano attualmente queste operazioni:

  • FhirResourceCreated : evento generato dopo che una risorsa FHIR viene creata correttamente.

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

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

  • DicomImageCreated : evento generato dopo che un'immagine DICOM viene creata correttamente.

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

  • DicomImageUpdated : 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 nel servizio FHIR in Servizi dati di integrità di Azure

Struttura dei messaggi degli eventi FHIR

Nome Digita Obbligatorio Descrizione
topic string Sì L'argomento è l'ID risorsa di Azure dell'area di lavoro di Servizi dati di Integrità di Azure.
subject string Sì URI (Uniform Resource Identifier) della risorsa FHIR modificata. Il cliente può accedere alla risorsa 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 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 per l'evento.
data oggetto 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 Di Azure Health Data Services.
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 di alcun contenuto di 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 Digita Obbligatorio Descrizione
topic string Sì L'argomento è l'ID risorsa di Azure dell'area di lavoro di 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 per l'evento.
data oggetto 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 della 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 ed 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 che ha creato questo evento.
dataVersion string No Versione dei dati dell'immagine DICOM.
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 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 il portale di Azure, vedere

Distribuire eventi usando il portale di Azure

FHIR® è un marchio registrato di Health Level Seven International, registrato nell'ufficio dei marchi statunitensi e viene utilizzato con la loro autorizzazione.