Integração do parceiro para o suporte de dados do dispositivo no gerenciamento de cuidados (versão preliminar)
[Este artigo faz parte da documentação de pré-lançamento e está sujeito a alterações.]
O suporte de dados do dispositivo no recurso de gerenciamento de cuidados (versão preliminar) define APIs personalizadas de entrada e saída para clientes e parceiros integrarem seus serviços de gerenciamento de dispositivo. As APIs habilitam os seguintes recursos:
- Crie uma solução enxuta do Power Automate em torno de seu conector HTTPS e consuma as APIs personalizadas para desencadear seus fluxos do Power Automate e ingerir dados no Dataverse.
- Consuma as APIs personalizadas de entrada para processar respostas de fluxo do Power Automate no Dataverse.
- Consuma as APIs personalizadas de saída para gatilhos do Dataverse.
- Configure um fluxo do Power Automate para executar todas as operações relevantes em um sistema parceiro usando conectores do Power Automate. Para desencadear o fluxo do Power Automate, use o gatilho de ação do Dataverse. Para obter mais informações, acesse Desencadear fluxos com ações.
Observação
Para filtrar as APIs personalizadas ao usar um gatilho de ação, selecione Gerenciamento de Dispositivo para Catálogo e Saída da Integração de Parceiro do Gerenciamento de Dispositivos para Categoria.
As seguintes APIs de saída definem o gatilho para cada processo:
| Nome do processo | Gatilho do Dataverse | API personalizada de saída | Descrição da API |
|---|---|---|---|
| Inscrever um paciente | Selecionar Inscrever-se agora | Saída da Criação de Inscrição de Dispositivo | Desencadeia o fluxo do Power Automate para criar um perfil de paciente no sistema parceiro. |
| Encerrar a inscrição de um paciente | Selecione Encerrar a inscrição | Saída da Exclusão de Inscrição de Dispositivo | Desencadeia o fluxo do Power Automate para excluir um perfil de paciente no sistema parceiro. |
| Sincronizar dispositivos com o sistema de um fornecedor de dispositivos | Selecione Sincronizar dispositivos | Sincronização de Dispositivos de Saída | Desencadeia o fluxo do Power Automate para buscar os dados do dispositivo no sistema parceiro. |
| Atribuir um dispositivo a um paciente | Selecione Atribuir dispositivo | Saída da Atribuição de Dispositivo | Desencadeia o fluxo do Power Automate para atribuir um dispositivo a um paciente. |
| Cancelar a atribuição de um dispositivo de um paciente | Selecione Cancelar a atribuição do dispositivo | Saída do Cancelamento de Atribuição de Dispositivo | Desencadeia o fluxo do Power Automate para desassociar um dispositivo de um paciente. |
Depois que o fluxo do Power Automate conclui todas as operações necessárias, ele envia um resposta para uma API personalizada de entrada por meio da ação não associada do conector do Dataverse. A API personalizada de entrada processa a resposta no Dataverse.
O diagrama a seguir ilustra como o fluxo envia a resposta a uma ação não vinculada em um cenário bem-sucedido.
A tabela a seguir define a API de entrada para cada processo:
| Nome do processo | API personalizada de entrada | Descrição da API | API personalizada de saída correspondente |
|---|---|---|---|
| Inscrever um paciente | Entrada da Criação de Inscrição de Dispositivo | Processa a resposta gerada quando um perfil de paciente é criado no sistema parceiro. | Saída da Criação de Inscrição de Dispositivo |
| Encerrar a inscrição de um paciente | Entrada da Exclusão de Inscrição de Dispositivo | Processa a resposta gerada quando um perfil de paciente é excluído no sistema parceiro. | Saída da Exclusão de Inscrição de Dispositivo |
| Sincronizar dispositivos com o sistema de um fornecedor de dispositivos | Sincronização de Dispositivos de Entrada | Processa a resposta gerada ao sincronizar dispositivos do sistema parceiro com o Dataverse. | Sincronização de Dispositivos de Saída |
| Atribuir um dispositivo a um paciente | Atribuição de Entrada de Dispositivo | Processa a resposta gerada quando um dispositivo é atribuído a um paciente no sistema parceiro. | Saída da Atribuição de Dispositivo |
| Cancelar a atribuição de um dispositivo de um paciente | Cancelar Atribuição de Entrada de Dispositivo | Processa a resposta gerada quando um há o cancelamento da atribuição de um dispositivo de um paciente no sistema parceiro. | Saída do Cancelamento de Atribuição de Dispositivo |
Os seguintes parâmetros de API especificam o contrato de dados genérico para todos os fornecedores de dispositivos:
| Parâmetro | Tipo | Descrição |
|---|---|---|
| Código de status | Inteiro | Status da operação |
| Mensagem de erro | Cadeia de caracteres | Mensagens de erro para uma operação com falha |
| Solicitação de saída | Cadeia de caracteres | Solicitação de saída enviada para o fluxo do Power Automate (para o parâmetro de solicitação de API de saída correspondente) |
| URL de fluxo | Cadeia de caracteres | URL do histórico de execuções de fluxo do Power Automate |
O fluxo Obter Dispositivos precisa de mais um parâmetro Conteúdo junto com os quatro parâmetros listados.
| Parâmetro | Tipo | Descrição |
|---|---|---|
| Conteúdo | Cadeia de caracteres | Lista de dispositivos especificados no seguinte formato JSON |
Formato:
{
"ResponseFormat": "<Format in which the responses are bundled>",
"Devices": [
{
"Name": "<Device name>",
"Model": "<Device model>",
"SerialNumber": "<Device's unique serial number>"
}
]
}
Exemplo:
{
"ResponseFormat": "default",
"Devices": [
{
"Name": "Device 1",
"Model": "Thermometer",
"SerialNumber": "AutomatedTIP1"
},
{
"Name": "Device 2",
"Model": "Weighing machine",
"SerialNumber": "AutomatedTIP2"
}
]
}
O diagrama a seguir ilustra como o fluxo envia a resposta a uma ação não vinculada em um cenário que não foi bem-sucedido.
Para todos os processos listados neste artigo, o gatilho do usuário inicia a cadeia de ações do Dataverse para o fornecedor do dispositivo e vice-versa. Você pode ver notificações de êxito ou falha no aplicativo. Depois de atualizar a página, você também poderá ver a interface do usuário atualizada para uma operação com êxito.
Pré-requisitos para integração sem parceiros da Microsoft
Para usuários que integram o recurso sem parceiros da Microsoft, você deve ter a seguinte configuração:
Dois pontos de extremidade privados para estabelecer uma conexão com seu locatário do Azure. Um ponto de extremidade é para o Azure Key Vault e o outro é para o serviço Hubs de Eventos do Azure. Recomendamos que você implemente os pontos finais privados numa rede virtual para ter maior segurança.
Um aplicativo multilocatário para enviar os dados emitidos do dispositivo para seu locatário do Azure. Você deve fornecer a ID do aplicativo correspondente no seu locatário do Azure. Esse registro de aplicativo também autentica o acesso ao cofre de chaves do ponto de extremidade privado.
Os fluxos do Power Automate especificados na seção Integração do parceiro que usam os acionadores mencionados. Use as APIs personalizadas de entrada especificadas para processar as respostas no Dataverse.
Observação
Se você estiver testando sem um fornecedor de dispositivo, configure os fluxos do Power Automate sem as etapas de integração de parceiro.