Perguntas frequentes sobre eventos

Os eventos permitem que você assine alterações de dados no serviço FHIR® ou DICOM® e seja notificado por meio da Grade de Eventos do Azure. Você pode usar eventos para acionar fluxos de trabalho, automatizar tarefas, enviar alertas e muito mais. Neste FAQ, você encontrará respostas para algumas perguntas comuns sobre eventos.

Posso usar eventos com um serviço FHIR ou DICOM que não seja da Microsoft?

Não. O recurso Eventos oferece suporte apenas aos serviços FHIR e DICOM dos Serviços de Dados de Saúde do Azure.

Quais alterações de recursos FHIR são suportadas por eventos?

Os eventos são gerados a partir destes tipos de serviço FHIR:

• FhirResourceCreated. O evento emitido após a criação de um recurso FHIR.

• FhirResourceUpdated. O evento emitido após a atualização de um recurso FHIR.

• FhirResourceDeleted. O evento emitido após um recurso FHIR ser excluído suavemente.

Para obter mais informações sobre tipos de exclusão no serviço FHIR, consulte Recursos da API REST no serviço FHIR no Azure Health Data Services.

Os eventos suportam pacotes FHIR?

Sim. O recurso de eventos emite notificações de alterações de dados no nível de recurso FHIR.

Os eventos oferecem suporte a estes tipos de pacote FHIR:

• Lote. Um evento é emitido para cada operação de alteração de dados bem-sucedida em um pacote. Se uma das operações gerar um erro, nenhum evento será emitido para essa operação. Por exemplo: o pacote de lotes contém cinco operações, no entanto, há um erro com uma das operações. Os eventos são emitidos para as quatro operações bem-sucedidas sem nenhum evento emitido para a operação que gerou um erro.

• Transação. Um evento é emitido para cada operação de pacote bem-sucedida, desde que não haja erros. Se houver erros em um pacote de transações, nenhum evento será emitido. Por exemplo: o pacote de transações contém cinco operações, no entanto, há um erro com uma das operações. Nenhum evento é emitido para esse pacote.

Observação

Os eventos não são enviados na sequência das operações de dados no pacote FHIR.

Quais alterações de imagem DICOM os eventos suportam?

Os eventos são gerados a partir dos seguintes tipos de serviço DICOM:

• DicomImageCreated. O evento emitido após a criação de uma imagem DICOM.

• DicomImageDeleted. O evento emitido após uma imagem DICOM ser excluída.

• DicomImageUpdated. O evento emitido após a atualização de uma imagem DICOM. Para obter mais informações, consulte Atualizar arquivos DICOM.

Qual é a carga útil de uma mensagem de eventos?

Para obter uma descrição da estrutura de mensagens de eventos e dos elementos necessários e não necessários, consulte Estruturas de mensagens de eventos.

Qual é a taxa de transferência para mensagens de eventos?

A taxa de transferência do serviço FHIR ou DICOM e da Grade de Eventos governa a taxa de transferência de eventos FHIR e DICOM. Quando uma solicitação feita ao serviço FHIR é bem-sucedida, ela retorna um código de status HTTP 2xx. Ele também gera um recurso FHIR ou evento de alteração de imagem DICOM. A limitação atual é de 5.000 eventos/segundo por espaço de trabalho para todas as instâncias de serviço FHIR ou DICOM no espaço de trabalho.

Como sou cobrado pelo uso de eventos?

Não há cobranças extras para usar eventos do Azure Health Data Services. No entanto, os encargos aplicáveis para a Grade de Eventos são avaliados em relação à sua assinatura do Azure.

Como faço para assinar separadamente vários serviços FHIR ou DICOM no mesmo espaço de trabalho?

Use o recurso de filtragem de Grade de Eventos. Há identificadores exclusivos na carga da mensagem de evento para diferenciar contas e espaços de trabalho. Você pode encontrar um identificador exclusivo global para espaço source de trabalho no campo, que é a ID de Recursos do Azure. Você pode localizar o nome exclusivo da conta FHIR nesse espaço de trabalho no data.resourceFhirAccount campo. Você pode localizar o nome exclusivo da conta DICOM no espaço de trabalho no data.serviceHostName campo. Ao criar uma assinatura, use os operadores de filtragem para selecionar os eventos que deseja incluir na assinatura.

Posso usar o mesmo assinante para vários espaços de trabalho, contas FHIR ou contas DICOM?

Sim. Recomendamos que você use assinantes diferentes para cada serviço FHIR ou DICOM para habilitar o processamento em escopos isolados.

A Grade de Eventos é compatível com os requisitos de conformidade da HIPAA e da HITRUST?

Sim. A Grade de Eventos oferece suporte às obrigações da Lei de Portabilidade e Responsabilidade de Seguros de Saúde (HIPAA) e da HITRUST Alliance (Health Information Trust Alliance). Para obter mais informações, consulte Ofertas de conformidade do Microsoft Azure.

Quanto tempo leva para receber uma mensagem de eventos?

Em média, você deve receber sua mensagem de evento dentro de um segundo após uma solicitação HTTP bem-sucedida. 99,99% das mensagens de evento devem ser entregues dentro de cinco segundos, a menos que a limitação do serviço FHIR, serviço DICOM ou Grade de Eventos seja atingida.

É possível receber mensagens de eventos duplicados?

Sim. A Grade de Eventos garante pelo menos uma entrega de mensagem de eventos com seu modo push. Pode haver casos em que a solicitação de entrega de evento retorna com um código de status de falha transitória por motivos aleatórios. Nessa situação, a grade de eventos considera uma falha de entrega e reenvia a mensagem de eventos. Para obter mais informações, consulte Entrega e repetição da Grade de Eventos do Azure.

Geralmente, recomendamos que os desenvolvedores garantam idempotência para o assinante do evento. A ID do evento ou a combinação de todos os campos na data propriedade do conteúdo da mensagem são exclusivas para cada evento. Você pode confiar neles para eliminar a duplicação.

Observação

FHIR® é uma marca registrada da HL7 e é usado com a permissão da HL7.

DICOM® é a marca registrada da National Electrical Manufacturers Association para suas publicações de padrões relacionados às comunicações digitais de informações médicas.