Integración de partners para el soporte de datos del dispositivo en la gestión de la atención (versión preliminar)
[Este artículo es documentación preliminar y está sujeto a modificaciones].
La capacidad de soporte de datos del dispositivo en la gestión de atención (versión preliminar) define API personalizadas entrantes y salientes para que los clientes y socios integren sus servicios de gestión de dispositivos. Las API habilitan las siguientes funcionalidades:
- Cree una solución de Power Automate eficiente en torno a su conector HTTPS y consuma las API personalizadas para tarjeta sus flujos de Power Automate e ingiera datos para Dataverse.
- Consuma las API personalizadas entrantes para procesar respuestas de flujo de Power Automate en Dataverse.
- Consuma las API personalizadas de salida para desencadenadores de Dataverse.
- Configure un flujo de Power Automate para realizar todas las operaciones relevantes en un sistema asociado utilizando conectores de Power Automate. Para activar el flujo de Power Automate, utilice el activador de acción de Dataverse. Para obtener más información, consulte Flujos desencadenadores con acciones.
Nota
Para filtrar las API personalizadas mientras usa un activador de acción, seleccione Administración de dispositivos para Catálogo e Integración de socio de gestión de dispositivos saliente para Categoría.
Las siguientes API de salida definen el disparador para cada proceso:
| Nombre de proceso | Desencadenador de Dataverse | API personalizada de salida | Descripción de API |
|---|---|---|---|
| Inscribir a un paciente | Seleccione Inscribir ahora | Crear salida de inscripción de dispositivos | Activa el flujo de Power Automate para crear un perfil de paciente en el sistema asociado. |
| Finalizar la inscripción de un paciente | Seleccione Finalizar inscripción | Eliminar salida de inscripción de dispositivos | Activa el flujo de Power Automate para eliminar un perfil de paciente en el sistema asociado. |
| Sincronizar dispositivos con el sistema de un proveedor de dispositivos | Seleccione Sincronizar dispositivos | Salida de dispositivos de sincronización | Activa el flujo de Power Automate para obtener los datos del dispositivo en el sistema asociado. |
| Asignar un dispositivo a un paciente | Seleccione Asignar dispositivo | Asignar salida de dispositivo | Activa el flujo de Power Automate para asignar un dispositivo a un paciente. |
| Desasignar un dispositivo de un paciente | Seleccione Desasignar dispositivo | Anular asignación de la salida de dispositivo | Activa el flujo de Power Automate para desasociar un dispositivo de un paciente. |
Una vez que el flujo de Power Automate completa todas las operaciones necesarias, envía un respuesta a una API personalizada entrante a través de la acción no vinculada del conector de Dataverse. La API personalizada entrante procesa la respuesta dentro de Dataverse.
El siguiente diagrama ilustra cómo el flujo envía la respuesta a una acción independiente en un escenario exitoso.
La siguiente tabla define la API de entrada para cada proceso:
| Nombre de proceso | API personalizada de entrada | Descripción de API | API personalizada de salida correspondiente |
|---|---|---|---|
| Inscribir a un paciente | Crear entrada de inscripción de dispositivos | Procesa la respuesta generada cuando se crea un perfil de paciente en el sistema asociado. | Crear salida de inscripción de dispositivos |
| Finalizar la inscripción de un paciente | Eliminar entrada de inscripción de dispositivos | Procesa la respuesta generada cuando se elimina un perfil de paciente en el sistema asociado. | Eliminar salida de inscripción de dispositivos |
| Sincronizar dispositivos con el sistema de un proveedor de dispositivos | Entrada de dispositivos de sincronización | Procesa la respuesta generada al sincronizar dispositivos del sistema asociado a Dataverse. | Salida de dispositivos de sincronización |
| Asignar un dispositivo a un paciente | Asignar entrada de dispositivo | Procesa la respuesta generada cuando se asigna un dispositivo a un paciente en el sistema asociado. | Asignar salida de dispositivo |
| Desasignar un dispositivo de un paciente | Anular la asignación de entrada de dispositivo | Procesa la respuesta generada cuando se desasigna un dispositivo de un paciente en el sistema asociado. | Anular asignación de la salida de dispositivo |
Los siguientes parámetros de API especifican el contrato de datos genérico para todos los proveedores de dispositivos:
| Parámetro | Tipo | Descripción |
|---|---|---|
| Código de estado | Número entero | Estado de la operación |
| Mensaje de error | Cadena | Mensajes de error de una operación fallida |
| Solicitud saliente | Cadena | Solicitud de salida enviada al flujo Power Automate (para el parámetro de solicitud de API de salida correspondiente) |
| URL de flujo | Cadena | URL del historial de ejecución del flujo de Power Automate |
El flujo Obtener dispositivos necesita un parámetro de Contenido más junto con los cuatro parámetros enumerados.
| Parámetro | Tipo | Descripción |
|---|---|---|
| Contenido | Cadena | Lista de dispositivos especificados en el siguiente formato JSON |
Formato:
{
"ResponseFormat": "<Format in which the responses are bundled>",
"Devices": [
{
"Name": "<Device name>",
"Model": "<Device model>",
"SerialNumber": "<Device's unique serial number>"
}
]
}
Ejemplo:
{
"ResponseFormat": "default",
"Devices": [
{
"Name": "Device 1",
"Model": "Thermometer",
"SerialNumber": "AutomatedTIP1"
},
{
"Name": "Device 2",
"Model": "Weighing machine",
"SerialNumber": "AutomatedTIP2"
}
]
}
El siguiente diagrama ilustra cómo el flujo envía la respuesta a una acción independiente en un escenario no exitoso.
Para todos los procesos enumerados en este artículo, el disparador del usuario inicia la cadena de acciones desde Dataverse hasta el proveedor del dispositivo y viceversa. Puede ver notificaciones de éxito o fracaso dentro de la aplicación. Después de actualizar la página, también puede ver la interfaz de usuario actualizada para una operación exitosa.
Requisitos previos para la integración sin socios de Microsoft
Para los usuarios que integran la capacidad sin socios de Microsoft, debe tener la siguiente configuración:
Dos puntos finales privados para establecer una conexión con su arrendatario de Azure. Un punto de conexión es para Azure Key Vault y el otro es para el servicio Azure Event Hubs. Le recomendamos que implemente los puntos finales privados en una red virtual para mejorar la seguridad.
Una aplicación multiinquilino para enviar los datos del dispositivo emitidos a su inquilino Azure. Debe proporcionar el identificador de aplicación correspondiente en su inquilino de Azure. El registro de esta aplicación también autentica el acceso a la bóveda de claves desde el privado punto de conexión.
Los flujos de Power Automate especificados en la sección Integración de partner que utilizan los desencadenadores mencionados. Use las API personalizadas entrantes especificadas para procesar las respuestas en Dataverse.
Nota
Si está probando sin un proveedor de dispositivos, configure los flujos de Power Automate sin los pasos de integración de socios.
Información relacionada
- Configurar la compatibilidad de datos de dispositivo (versión preliminar)
- Generar datos de muestra para la compatibilidad de datos del dispositivo (versión preliminar)
- Solución de problemas de datos de dispositivo (versión preliminar)
- Usar compatibilidad con datos de dispositivos (versión preliminar)