Introducción
Bizagi soporta la integración de servicios REST a través de dos alternativas, como se describe en Invocar servicios REST.
La primera alternativa, y la recomendada, es mediante el uso de Conectores de Bizagi.
Al considerar la segunda alternativa, que implica el uso del Conector de servicios Web de Bizagi, revise las opciones de configuración avanzada disponibles a través de la vista Experto en los Sistemas Externos listados.
Notas de configuración RESTful
Las siguientes notas afectan la forma en que los servicios REST externos son invocados desde Bizagi.
1. Uso de autenticación básica HTTP
Puede incluir credenciales de usuario si el servicio REST requiere autenticación.
Estas credenciales incluyen un nombre de usuario, una contraseña y un dominio opcional para la autenticación básica HTTP.
Recuerde que esta información se ingresa en la configuración de la interfaz disponible en el módulo Sistemas.
2. Valores de interfaz por ambiente
Puede actualizar la configuración de la interfaz de su servicio REST en cualquier momento si el servicio cambia de servidor.
Las opciones de administración de la interfaz le permiten editar el dominio de la URL base o las credenciales utilizadas para la autenticación (dominio, nombre de usuario y contraseña).
Esto también puede hacerse directamente desde la Management Console para cada ambiente de su proyecto (Pruebas o Producción).
3. Administración de URL
Siempre que la URL base de una invocación a un servicio REST se edite mediante el asistente de Interfaces (ambiente de Desarrollo), Bizagi gestiona el cambio de la siguiente manera:
•Si se edita la parte correspondiente al dominio de la URL base, Bizagi la trata como un cambio menor relacionado con el servidor que proporciona el servicio, y no como una nueva interfaz. Esto significa que no se requiere una configuración de mapeo diferente.
•Si se edita la parte de la URL base que sigue al dominio, Bizagi la trata como una nueva configuración de interfaz, diferente de la anterior. Esto requiere revisar el mapeo para garantizar que los parámetros correspondientes estén correctamente configurados.
•Cualquier modificación a la URL del servicio se trata como una nueva configuración de interfaz, diferente de la anterior. Este comportamiento sigue la regla de validación del módulo Sistemas, donde la URL del servicio para una interfaz de servicio REST no puede editarse. De manera similar al escenario anterior, requiere revisar la configuración de mapeo.
4. Envío de encabezados (content-type)
Siempre que Bizagi envía información a un servicio RESTful, incluye información en el encabezado HTTP content-type que especifica el formato de los datos que se están enviando.
De forma predeterminada, Bizagi envía el content-type como text/xml (para los métodos HTTP POST y PUT). Sin embargo, puede modificar esta configuración.
Puede especificar un content-type diferente entre los disponibles en la lista desplegable.
Recuerde que, para hacerlo, debe configurar o editar la interfaz, o editarla desde la vista Experto haciendo clic derecho sobre la interfaz y seleccionando Propiedades.
Las personalizaciones adicionales de encabezados no son compatibles con el Conector de servicios Web. Para administrar encabezados más allá del encabezado content-type, debe utilizar Conectores de Bizagi.
5. Máxima longitud de URL
Las solicitudes a servicios REST suelen estar sujetas a los límites de longitud de URL admitidos por los navegadores. La mayoría de los navegadores modernos soportan URLs de hasta aproximadamente 2,000 caracteres de longitud. Por lo tanto, es una buena práctica mantener las URL cortas y concisas para garantizar la compatibilidad entre diferentes sistemas.
Last Updated 9/1/2026 2:30:55 PM