Integraciones personalizadas

Es posible añadir un prefijo personalizado al valor del parámetro especificando el nombre del parámetro de forma diferente. Normalmente, si se especifica el nombre del parámetro como 'id', se obtendría una solicitud como https://example.com/?id=1. Sin embargo, si se requiere un prefijo personalizado delante del valor de ID real, el nombre del parámetro podría definirse, por ejemplo, como 'id=cliente_", lo que enviaría una solicitud https://example.com/?id=client_1.

A las peticiones en segundo plano ("Enviar petición HTTP") también se les pueden asignar valores arbitrarios y estáticos que se añadirán a las peticiones cada vez que se envíen. Esto puede utilizarse, por ejemplo, para incluir cabeceras de autorización en las solicitudes.

Esta función no está implementada para las solicitudes en primer plano ("Abrir en una ventana nueva", "Abrir en un panel lateral"). Tampoco se registran las cabeceras enviadas.

La vista de configuración mostrará una lista de claves y valores de carga útil que se enviarán con la solicitud, ya sea como parámetros de cadena de consulta (GET) o datos de formulario (POST). Esta lista se actualizará a medida que se modifiquen los ajustes.

Si una integración personalizada se define como una acción 'Enviar solicitud HTTP', al hacer clic en el botón de integración personalizada se programará una solicitud que se enviará en segundo plano utilizando los servidores de trabajo de Provet Cloud. El envío se producirá de forma asíncrona, y aunque por lo general la solicitud se realiza casi de inmediato, puede haber un retraso en función de la cantidad de trabajo actualmente en los servidores. La solicitud se originará desde las direcciones IP salientes de Provet Cloud.

Cuando se esté programando la solicitud, el usuario verá una notificación informativa en la parte superior de la página.

Si la solicitud se gestiona y se completa sin que el usuario salga de la página, se le puede mostrar una notificación adicional al completar la tarea.

Se muestra una notificación de éxito si la solicitud se envía correctamente y la integración responde con un código de estado HTTP correcto (entre 200 y 299 inclusive).

Sin embargo, si la solicitud falla por cualquier motivo, se mostrará una notificación de error en rojo que dirá "Solicitud de integración fallida", con un mensaje de error más específico entre paréntesis.

Los posibles mensajes de error en este momento son:

Si una integración personalizada se define como una acción 'Abrir en una nueva ventana', al hacer clic en el botón de integración personalizada se abrirá la URL de destino en una nueva ventana, o más comúnmente con los navegadores modernos, en una nueva pestaña. La página original de Provet Cloud permanecerá abierta en su ventana/pestaña original.

Si se utiliza un método de solicitud GET, los usuarios pueden ver la información de la carga útil en la barra de direcciones del navegador. Si los usuarios no deben ver fácilmente la información de la carga útil transmitida, considere la posibilidad de utilizar una solicitud POST en su lugar.

Si una integración personalizada se define como una acción "Abrir en panel lateral", al hacer clic en el botón de integración personalizada se obtiene la URL de destino dentro del navegador y se muestra dentro de un elemento iframe dentro de un panel lateral que se abre en la parte superior de la página actual.

La URL de destino debe admitir la incrustación a través de su cabecera X-Frame-Options.

Las integraciones personalizadas de cliente se mostrarán en la página de cliente, en la parte derecha, encima de la sección de Notas, al navegar por cualquiera de las pestañas de cliente ('Detalles de cliente', 'Facturación', 'Tratamientos', etc.). No se mostrará en las pestañas de los pacientes. El ID del cliente se enviará como parámetro.

Del mismo modo, las integraciones personalizadas de los pacientes se mostrarán en la página del paciente, en la parte derecha, encima de la sección Notas, al navegar por las pestañas de los pacientes ("Detalles del paciente", "Historial", "Medidas", etc.). No se mostrará en las pestañas del cliente. El ID del paciente se enviará como parámetro.

Las integraciones personalizadas de facturas se mostrarán en las páginas de facturas (incluida la contraventa) en la barra de herramientas inferior. El ID de la factura (no confundir con el número de factura) se enviará como parámetro.

Las integraciones personalizadas de consultas se mostrarán en la página de la consulta, encima de la sección de información general, tanto para las consultas en curso como para las finalizadas. El ID de la consulta se enviará como parámetro.

Las integraciones personalizadas del calendario de citas se mostrarán encima del calendario de citas. El ID de ubicación de la clínica activa se enviará como parámetro.

Del mismo modo, las integraciones personalizadas del calendario de turnos se mostrarán encima del calendario de turnos, debajo del tipo de turno y la selección de plantilla de turno. El ID de ubicación de la clínica activa se enviará como parámetro.

Las integraciones personalizadas de diagnóstico por imagen se mostrarán en la página de remisión de diagnóstico por imagen en las barras de herramientas superior e inferior. El ID de derivación de diagnóstico por imagen se enviará como parámetro.

Las integraciones personalizadas de recordatorios se mostrarán en la barra de herramientas de selección de la página de recordatorios cuando se seleccionen uno o varios recordatorios en la tabla. Se pueden seleccionar y enviar varios recordatorios al mismo tiempo. El ID de recordatorio de cada recordatorio seleccionado se enviará como parámetros.