La configuración de la interfaz se refiere al uso del conector de servicios web de Bizagi, para integrarse con los servicios SOAP o REST.
El Management Console le permite administrar los parámetros utilizados por los puntos de integración de sus procesos en un ambiente de prueba o producción.
Editar una interfaz existente
Una vez que se ha definido y configurado una interfaz en un Proceso, puede editar su información.
Para editar una interfaz existente, selecciónela en la lista Sistema externo:
Seleccione la interfaz requerida en el panel izquierdo.
En la pestaña Propiedades, puede encontrar los siguientes campos según el tipo de servicio (REST o SOAP)
Propiedad |
Descripción |
|---|---|
URL Servicio Web |
La URL de acceso al servicio. Para servicios REST, este campo tendrá la URL Base |
Nombre de usuario |
Cuando el servicio requiere autenticación HTTP básico, este nombre de usuario se requiere para el acceso al servicio. |
Contraseña |
Cuando el servicio requiera la autenticación básica HTTP, esta contraseña se requiere para el acceso al servicio. |
Dominio |
Cuando el servicio requiera autenticación HTTP básica, este campo es opcional para complementar el nombre de usuario, para el acceso al servicio. |
Umbral para registro (en seg) |
El tiempo en segundos que define un umbral de servicio esperado para la interfaz. Si la invocación supera esta definición en ejecución, entonces se registra una línea de trace en el registro .csv log en .\Temporary\SOA\Log\ de su proyecto (por defecto, queda una archivo por cada servicio web, creado como C:\Bizagi\Projects\[su_proyecto]\Temporary\SOA\Log\[su_interface]Log_1.csv). Este log es especialmente útil para el monitoreo dado que cada invocación que exceda o produzca un timeout dejará registro con el siguiente detalle: Fecha (DateTime), Descripción (ErrorDescription), idCase, Tarea (Task_Name), URL, Método (Method_Name), y Registro de tiempo (InterfaceTime) en formato MM:ss:mmm.
El valor predeterminado se establece en 30 segundos, por lo que siempre se registra si la invocación tarda más que este tiempo. |
Tiempo de espera (en seg) |
El tiempo en segundos que define el tiempo de espera para cualquier intento de invocación de una interfaz. Si la invocación supera esta definición en ejecución, se genera un error y se registra en una línea de trace en el registro. csv en .\Temporary\SOA\Log\ de su proyecto (por defecto, queda una archivo por cada servicio web, creado como C:\Bizagi\Projects\[su_proyecto]\Temporary\SOA\Log\[su_interface]Log_1.csv). Este log es especialmente útil para el monitoreo dado que cada invocación que exceda o produzca un timeout dejará registro con el siguiente detalle: Fecha (DateTime), Descripción (ErrorDescription), idCase, Tarea (Task_Name), URL, Método (Method_Name), y Registro de tiempo (InterfaceTime) en formato MM:ss:mmm.
Por defecto esta opción no se utiliza (su valor inicial es -1). La invocación hará timeout de acuerdo a esta propiedad, o la propiedad en la actividad si la invocación se realiza en una actividad asíncrona (se disparará cualquier timeout de los 2, el cual tenga el menor valor). |
Nombre del puerto |
Cuando el usuario necesita ejecutar una interfaz SOAP en la cuál, el servicio tiene diferentes puertos (p.ej, SOAP 1.1, SOAP 2.0, etc.), este campo permite al usuario escribir el nombre específico del puerto por donde se conectará el servicio. Este nombre del puerto puede ser configurado de acuerdo al ambiente en donde se ejecuta la interfaz. Los nombres de los puertos se especifican al final del WSDL del servicio:
|
Máximo de bytes del búfer |
Edite su valor (por incrementar) en caso de que necesite enviar información muy extensa a su servicio Web (p.e un adjunto de gran tamaño). Útil cuando se excede el límite por defecto de la cantidad de información que se permite en el envío. Corresponde al atributo maxBufferSize del elemento bindings del archivo de configuración del Windows Communication Foundation (WCF). Establece el tamaño máximo de los encabezados SOAP. |
Máximo de memoria en el pool del búfer |
Edite su valor (por incrementar) en caso de que necesite enviar información muy extensa a su servicio Web (p.e un adjunto de gran tamaño). Útil cuando se excede el límite por defecto de la cantidad de información que se permite en el envío. Corresponde al atributo maxBufferPoolSize del elemento bindings del archivo de configuración del Windows Communication Foundation (WCF). Establece la máxima cantidad permitida de memoria (en bytes). |
Máximo de caracteres permitidos en el XML |
Edite su valor (por incrementar) en caso de que necesite enviar información muy extensa a su servicio Web (p.e un adjunto de gran tamaño). Útil cuando se excede el límite por defecto de la cantidad de información que se permite en el envío. Corresponde al atributo maxStringContentLength del elemento readerQuotas del archivo de configuración del Windows Communication Foundation (WCF). Establece la longitud máxima de la cadena de respuesta. |
Máximo de longitud de matriz en los datos recibidos |
Edite su valor (por incrementar) en caso de que necesite enviar información muy extensa a su servicio Web (p.e un adjunto de gran tamaño). Útil cuando se excede el límite por defecto de la cantidad de información que se permite en el envío. Corresponde al atributo maxArrayLength del elemento readerQuotas del archivo de configuración del Windows Communication Foundation (WCF). Establece la longitud máxima permitida del arreglo de datos. |
Máximo de bytes permitidos por lectura |
Edite su valor (por incrementar) en caso de que necesite enviar información muy extensa a su servicio Web (p.e un adjunto de gran tamaño). Útil cuando se excede el límite por defecto de la cantidad de información que se permite en el envío. Corresponde al atributo maxBytesPerRead del elemento readerQuotas del archivo de configuración del Windows Communication Foundation (WCF). Establece el máximo de bytes permitido que se retorna en cada lectura. |
Máximo de caracteres en el nombre de tabla |
Edite su valor (por incrementar) en caso de que necesite enviar información muy extensa a su servicio Web (p.e un adjunto de gran tamaño). Útil cuando se excede el límite por defecto de la cantidad de información que se permite en el envío. Corresponde al atributo maxNameTableCharCout del elemento readerQuotas del archivo de configuración del Windows Communication Foundation (WCF). Establece el numero máximo de caracteres en el nombre de una tabla. |
En la pestaña Opciones avanzadas, puede configurar el tipo de seguridad que desea usar para autenticar e invocar su servicio web.
Esta definición difiere de las credenciales de autenticación básicas especificadas en las propiedades anteriores (nombre de usuario, contraseña, dominio) que permiten a Bizagi acceder al WSDL y los recursos físicos utilizados por la definición del servicio web, mientras que la definición en esta configuración determina la seguridad involucrada en el tiempo de ejecución para el servicio web en sí.
Las posibles definiciones que puede editar y administrar para una interfaz ya configurada en su entorno son:
Opción |
Descripción |
Especificación |
|---|---|---|
Plain Header Token |
Envía el token de usuario (usernameToken) en el encabezado del mensaje SOAP de acuerdo a la especificación de WS-Security. |
Según la definición en: https://www.oasis-open.org/committees/download.php/16782/wss-v1.1-spec-os-UsernameTokenProfile.pdf |
Secure Conversation Header Token |
Envía el token de usuario de acuerdo a la especificación, teniendo un certificado adecuado instalado en el cliente. |
Según la definición en: http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512 |
Basic HTTP Authentication |
Envía las credenciales que aplican cuando el end-point especificado del servicio está protegido (a nivel de autenticación básica).
Por defecto, Bizagi intentará usar este tipo de seguridad si no se especifica alguno, y se cuenta con autenticación básica a nivel del recurso (usando las credenciales definidas en las propiedades de usuario, contraseña y dominio). |
Según la definición en: |
Last Updated 7/15/2022 4:33:15 PM