Traces para conectores

<< Click to Display Table of Contents >>

Navigation:  Bizagi Studio > Interfaz de Bizagi Studio en detalle > Ajustes avanzados > Configuración de Traces >

Traces para conectores

Introducción

Cuando configure conectores en Bizagi, puede utilizar varias funcionalidades para control de errores y diagnóstico.

Una de estas funcionalidades es el uso de Traces cuando detecte que hay un problema con la ejecución del conector y desee traer información adicional.

 

Traces para Conectores

Cuando esté depurando la ejecución de un conector (en ambientes de desarrollo) o cuando quiera traer detalles adicionales sobre la ejecución fallida de los mismos, usted puede prender los traces de Conectores externos.

 

Connectors_trace_all

 

note_pin

Tenga en cuenta que los traces para conectores pueden ser habilitados en cualquier momento. pero es altamente recomendado habilitarlos temporalmente solo cuando se necesite (y por supuesto, deshabilitarlos).

Los cambios en esta configuración pueden requerir reiniciar los servicios Bizagi de su servidor.

 

Habilitar estos traces es útil para rastrear, después de un error, el punto exacto donde sucedió dicho error. Hay 5 puntos donde se registra el detalle y usted puede diagnosticar si hay un problema en la ejecución de su conector o cuándo se aplicaron las transformaciones de la información.

 

Tipos de traces

Los siguientes traces son registrados como se detalla en la siguiente tabla.

 

Orden cronológico

Tipo de trace

Descripción

1

Entradas

Deja un archivo JSON con las entradas enviadas al conector antes de la ejecución de su lógica.

Su nombre tiene la siguiente convención:

[Fecha_y_Hora]_[identificador_caso]_IN0_[Nombre_Conector]_[Nombre_acción].json

Tenga en cuenta que la fecha y hora es yyyyMMddHHmmss.

2

Entradas transformadas

Deja un archivo JSON con las entradas enviadas al conector después de la ejecución de su lógica.

Su nombre tiene la siguiente convención:

[Fecha_y_Hora]_[identificador_caso]_IN1_[Nombre_Conector]_[Nombre_acción].json

Tenga en cuenta que la fecha y hora es yyyyMMddHHmmss.

3

Salidas

Deja un archivo JSON con las salidas recibidas desde el sistema externo antes de cualquier transformación hecha por Bizagi.

Su nombre tiene la siguiente convención:

[Fecha_y_Hora]_[identificador_caso]_OU0_[Nombre_Conector]_[Nombre_acción].json

Tenga en cuenta que la fecha y hora es yyyyMMddHHmmss.

4

Salidas transformadas

Deja un archivo JSON con las salidas recibidas desde el sistema externo después de todas las transformaciones hechas por Bizagi.

Su nombre tiene la siguiente convención:

[Fecha_y_Hora]_[identificador_caso]_OU1_[Nombre_Conector]_[Nombre_acción].json

Tenga en cuenta que la fecha y hora es yyyyMMddHHmmss.

5

Lógica del conector

Deja un archivo .log que almacena los comandos LOG encontrados durante la ejecución de la lógica del conector. Encuentre más información sobre estos comandos en este artículo.

Su nombre tiene la siguiente convención:

[nombre projecto]-bz-ctrl.log

Tenga en cuenta que la fecha y hora es yyyyMMddHHmm.

 

Medida adicional orientada al control de errores

Es altamente recomendado que también defina el tiempo esperado del servicio, de tal forma que pueda asignar: un tiempo de espera para el servicio y  un umbral para el registro.

Estas propiedades pueden ser configuradas en las propiedades de la interfaz específica:

Le parámetro del umbral para el registro de las interfaces deja un registro para alertarlo sobre aquellas interfaces cuya invocación está tardando más de lo esperado (más de lo usual). De esta forma, usted puede realizar diagnósticos tempranos en su servicio web y en cualquier variable adicional que afecte el desempeño.

El timeout lanzado en la invocación de un servicio es debido a que éste se está demorando más tiempo del tiempo de espera definido.

Para un servicio invocado desde una actividad asíncrona, la definición del tiempo de espera se toma del menor tiempo entre la propiedad de tiempo de espera configurada en la tarea asíncrona y la de la interfaz especifica (a través de administración de interfaces en el módulo de sistemas).

 

 

¿Cómo rastrear su conector?

Con los siguientes pasos, vamos a ilustrar cómo utilizar el rastreo de invocación de interfaces para detectar y diagnosticar problemas en invocaciones de conectores.

 

1. Detecte el error

Como práctica más común, usted puede encontrar que su conector es invocado desde una actividad asíncrona.

Si la invocación falla, se pueden ver errores adicionales desde el menú Admin, en la opción Consola de actividades asíncronas.

 

WSTrace_console

 

 

2. Prepare la configuración de traces

A través de las opciones de traces, habilite todos los traces de Interfaces.

 

3. Vuelva a ejecutar la invocación de la interfaz (para obetener el detalle del error)

Reintente la invocación de la interfaz para tener un registro detallado.

 

Después, navegue en su servidor Bizagi y en la carpeta de traces de los Conectores (en este ejemplo de .NET, la ubicación sería C:\Bizagi\Projects\[nombre_proyecto]\Temporary\Connectors).

 

Es importante destacar que no en todos los casos podría tener todos los archivos guardados.

Por ejemplo. si ocurre un error en la transformación de las entradas desde Bizagi, solamente aparecerá el primer archivo (entradas) debido a que el error ocurre antes de realizar la transformación.

 

4. Valide los traces para identificar el error (uno a uno)

Valide la información contenida en estas traces.