Registros de operaciones en Jitterbit Integration Studio

Introducción

Cuando se ejecuta una operación, se genera un registro de operación. Un registro de operación contiene información sobre cuándo y dónde se ejecutó una operación, el estado de la operación y cualquier mensaje de registro. La visualización de mensajes de registro detallados depende de los niveles de permiso y acceso, así como de si el registro en la nube está habilitado. Cuando se habilita el registro de depuración de operaciones (para agentes en la nube o para agentes privados) para una operación individual, cada registro de operación también contiene datos de entrada y salida para la operación.

Los registros de operaciones, incluidos los mensajes de registro detallados de agentes en la nube y agentes privados, así como los datos de entrada y salida de componentes dentro de los registros de operación, se conservan durante 30 días por Harmony.

Los registros de operaciones también se pueden ver en la página Operaciones en tiempo de ejecución de la Consola de Administración.

Para obtener información sobre cómo resolver ciertos errores que pueden ocurrir al ejecutar una operación, consulte Solución de problemas de operaciones.

Acceso a los registros de operaciones

Los registros de operaciones se pueden acceder en Integration Studio a nivel de flujo de trabajo, operación o proyecto. Dependiendo de dónde se accedan, la pantalla de registros de operaciones incluye un máximo de 1,000 registros para un período de tiempo determinado para las operaciones que se han ejecutado en un flujo de trabajo particular, para una operación particular o en un proyecto, respectivamente. Si las operaciones están vinculadas con acciones de operación o la función RunOperation, también se incluyen los registros de las operaciones posteriores.

Por flujo de trabajo

La opción Ver registros para un flujo de trabajo, que muestra los registros de las operaciones que se han ejecutado dentro de un flujo de trabajo particular, se puede acceder desde la pestaña Flujos de trabajo del panel del proyecto (ver Menú de acciones del flujo de trabajo en Pestaña de flujos de trabajo del panel del proyecto).

Por operación

La opción Ver registros para una operación es accesible desde estas ubicaciones:

• La pestaña Flujos de trabajo del panel del proyecto (ver Menú de acciones del componente en Pestaña de flujos de trabajo del panel del proyecto).
• La pestaña Componentes del panel del proyecto (ver Menú de acciones del componente en Pestaña de componentes del panel del proyecto).
• El lienzo de diseño (ver Menú de acciones del componente en Lienzo de diseño).

Además, después de ejecutar una operación manualmente, puedes hacer clic en el estado de la operación en el lienzo de diseño para mostrar los registros (ver Estado de la operación en Despliegue y ejecución de la operación).

Por proyecto

Al utilizar la opción Ver registros de un proyecto, se abre la página de Operaciones en tiempo de ejecución de la Consola de Administración en una nueva pestaña del navegador y se filtra para mostrar los registros de las operaciones que se han ejecutado dentro del proyecto.

La opción Ver registros para un proyecto se puede acceder desde estas ubicaciones:

• La página de Proyectos (ver Vista de tarjeta o Vista de lista en Proyectos).
• La barra de herramientas del proyecto (ver Menú de acciones del proyecto en Barra de herramientas del proyecto).

Pestaña de registro de operaciones del panel del proyecto

Al ver registros por flujo de trabajo u operación, el panel del proyecto se abre en la parte inferior del lienzo de diseño para mantener tu contexto en el proyecto:

• Pestañas: Las pestañas en la parte superior del panel están etiquetadas con Registro seguido del nombre de la operación o flujo de trabajo (dependiendo de dónde se accedieron los registros). Cuando accedes a registros adicionales o variables del proyecto, se añaden nuevas pestañas. Para reordenar pestañas, arrastra y suelta una pestaña. Para cerrar una pestaña, haz clic en su ícono de cerrar . Cerrar la última pestaña o usar el ícono de cerrar más a la derecha cierra el panel.
• Redimensionar: La barra en la parte superior del panel se puede usar para redimensionar el panel. Pasa el cursor sobre la barra y arrastra el ícono de redimensionar hacia arriba o hacia abajo para redimensionar el panel.
• Colapsar: Colapsa el panel para que todos los registros estén ocultos. Una vez colapsado, haz clic en el ícono de retorno para volver a la vista anterior.
• Expandir: Expande el panel a pantalla completa para que se muestren los registros adicionales. Una vez expandido, haz clic en el ícono de retorno para volver a la vista anterior.
• Abrir en Operaciones en tiempo de ejecución: Abre la pestaña de registro de operaciones actualmente accedida con cualquier consulta aplicada en la página de Operaciones en tiempo de ejecución de la Consola de Administración. Los filtros de tiempo no se retienen y deben ser reaplicados en la página de Operaciones en tiempo de ejecución.
• Cerrar: Cierra el panel.

Controles de la tabla de registro de operaciones

La vista de registro de operaciones drawer view incluye filtros para rango de tiempo y consultas, y actualización de la tabla.

Rango de tiempo

Todos los rangos de tiempo se muestran como la hora local del navegador. Por defecto, el rango de tiempo está configurado en las Últimas 24 Horas de registros desde la última ejecución de una operación. Alternativamente, utiliza el menú para seleccionar Últimas 48 Horas, Últimas 72 Horas o Tiempo personalizado:

Para un rango de tiempo dado, se incluyen un máximo de 1,000 registros en la tabla de registro de operaciones.

Cuando se selecciona Tiempo personalizado, se abre un cuadro de diálogo de configuración:

• Finalizado: Para filtrar por la fecha y hora en que la operación o el paso de la operación dejó de ejecutarse, haz clic en el icono de calendario para abrir el selector de fecha. Para limpiar este campo, haz clic en el icono de limpiar filtro .
• Iniciado: Para filtrar por la fecha y hora en que la operación o el paso de la operación comenzó a ejecutarse, haz clic en el icono de calendario para abrir el selector de fecha. Para limpiar este campo, haz clic en el icono de limpiar filtro .
• Aplicar: (Habilitado cuando se configuran los campos Finalizado o Iniciado.) Aplica todos los filtros de fecha y hora a la tabla de registros de operaciones.
• Limpiar: (Habilitado cuando se configuran los campos Finalizado o Iniciado.) Limpia ambos filtros Finalizado e Iniciado.

Una vez que se hace clic en el icono de calendario , se abre el selector de fecha/hora para ese campo:

• Fecha Desde/Hasta: Utiliza el calendario debajo de uno o ambos de estos campos para seleccionar una fecha dentro de los últimos 30 días.

  • Mes: El mes actual se utiliza por defecto. Utiliza las flechas para navegar a un mes diferente.

• Día: Selecciona el día deseado del calendario.

• Hora: Escribe la hora, el minuto y el período de tiempo (AM o PM).

Actualizar

Los registros se actualizan automáticamente cada cinco segundos si alguna operación sigue en estado de ejecución (estado de Recibido, Enviado, Pendiente o Ejecutándose).

También puedes actualizar manualmente los registros en cualquier momento para mostrar información actualizada. Para actualizar manualmente los registros, haz clic en el ícono de Actualizar en la parte superior derecha.

Consultas

Una consulta es uno o más términos clave/valor. Los términos múltiples se separan por punto y coma. Un término tiene la forma <clave><operador><valor>. Para la clave operation, el valor puede incluir un carácter comodín, %, que coincide con cualquier cadena.

Para usar una consulta, ingresa una especificación de consulta válida en la barra de búsqueda y luego presiona enter:

La siguiente tabla muestra los componentes de términos de consulta disponibles:

Estados de operación

Los siguientes son los estados que se pueden consultar al usar la clave status:

• Error: Si el agente completa la ejecución de una operación, pero hubo un error fatal al escribir en el sistema de destino, o hubo un error de validación fatal en la transformación, o la lógica de transformación activó la función RaiseError, entonces el estado de la operación se establece en Error y la ejecución de la operación termina.

• SOAP Fault: Si el agente completa la ejecución de una operación, y el resultado fue un error SOAP, entonces el estado se establece en SOAP Fault. Este estado es aplicable solo para operaciones que utilizan Salesforce, Salesforce Service Cloud, ServiceMax, SOAP, o Workday actividades.

• Submitted: Cuando las operaciones se envían a la cola de Harmony, pero aún no han sido recogidas por un agente para su ejecución, tienen un estado de Submitted. Las operaciones se pueden enviar por varios medios:

  • Servicio de programación de Jitterbit o servicio de programación externo
  • Ejecución manual de la operación en Integration Studio
  • Una función RunOperation desde un script o transformación
  • Cualquier herramienta, incluyendo JitterbitUtils, que llame a una API del API Manager

• Received: Una vez que se selecciona un agente y el agente ha reconocido que ha recibido la solicitud para ejecutar una operación, el estado cambia a Received.

• Pending: Una vez que una operación está programada para ejecutarse en el motor de operaciones de un agente, el estado cambia a Pending. Las operaciones no deberían estar en estado Pending durante largos períodos, ya que los agentes deberían recoger la solicitud y comenzar a ejecutar las operaciones en un corto período de tiempo.

• Running: Una vez que el agente comienza a ejecutar una operación, el estado debe cambiar a Running. Las operaciones permanecen en este estado hasta que se completan o encuentran un error. El agente comienza a registrar los mensajes generados por la operación a medida que se ejecuta para que los usuarios puedan rastrear qué parte de la operación se está ejecutando actualmente.

• Cancel Requested: Indica que se ha enviado una solicitud para detener la operación. Si un usuario desea detener una operación que está en estado Submitted, Received, Pending o Running, puede hacerlo desde estas ubicaciones:

  • La operación (ver runtime status en Design canvas).
  • La operation log table.
  • La página de Runtime Operations de la Management Console (ver Canceling runtime operations).

  Alternativamente, pueden habilitar otra operación para cancelar una operación utilizando una combinación de las funciones GetOperationQueue y CancelOperation. Una vez que se solicita la cancelación, el estado de la operación cambia a Cancel Requested. Una operación no debería permanecer en este estado por mucho tiempo, ya que el agente debería cancelar la operación en un período de tiempo relativamente corto.

• Canceled: Una vez que un agente cancela una operación, establece el estado en Canceled y la operación se termina. Toda la información del registro hasta el momento de la cancelación está disponible para revisión en los mensajes de registro, por lo que se sabe en qué momento se canceló la operación.

• Success: Una vez que un agente completa la ejecución de una operación, si el resultado fue un éxito sin advertencias del sistema objetivo, o advertencias escritas en la transformación utilizando la función WriteToOperationLog, entonces el estado se establece en Success.

• Success with Info: Si el agente completa la ejecución de una operación, pero hubo problemas no fatales en la transformación o en la publicación al sistema objetivo o se utilizó la función WriteToOperationLog para escribir mensajes en el registro, entonces el estado se establece en Success with Info. Esto alerta al usuario para que verifique la información en los mensajes de registro.

• Success with Warning: Si el agente completa la ejecución de una operación, pero hubo problemas no fatales en la transformación o en la publicación al sistema objetivo, y hubo una advertencia, entonces el estado se establece en Success with Warning. Esto alerta al usuario para que verifique las advertencias en los mensajes de registro.

• Éxito con Error en Hijo: Si el agente completa la ejecución exitosa de una operación, pero dentro de una o más operaciones hijas, hubo un error fatal al escribir en el sistema de destino, o hubo un error de validación fatal en la transformación, o la lógica de transformación activó la función RaiseError, entonces el estado de la operación se establece en Éxito con Error en Hijo. Este estado no se aplica a operaciones asincrónicas.

• Estado Retrasado: Si el agente no devuelve un registro de operación por cualquier motivo, se muestra Estado Retrasado. Harmony intentará obtener registros seis veces, con un tiempo de espera de 10 segundos entre cada llamada. Actualiza o verifica los registros más tarde. No puedes filtrar por operaciones con Estado Retrasado, pero puedes verlas en los registros de operación.

Estado de paso de operación

Los pasos de operación aparecen solo cuando esa operación tiene habilitado el registro de depuración de operación a nivel de operación (para agentes en la nube o para agentes privados) y la operación se ejecutó en un agente 10.48 o posterior.

Los pasos de operación pueden tener estos posibles estados:

• Completo: El paso de operación se ejecutó y completó sin errores.
• Error: El paso de operación se ejecutó pero no pudo completarse debido a un error.
• Incompleto: El paso de operación no se ejecutó ni completó. Las posibles razones para este estado incluyen que el paso de operación está esperando ser ejecutado o que hubo un error en un paso de operación anterior que impide que el siguiente paso se ejecute.

Tabla de registros de operación

La tabla de registros de operación muestra los registros de operación utilizando los controles de tabla seleccionados. Si las operaciones están vinculadas con acciones de operación o la función RunOperation, los registros de las operaciones descendentes también se incluyen.

Las operaciones principales (y cualquier operación hija debajo de ellas) se ordenan en orden ascendente por Iniciado. La tabla se puede ordenar (solo para operaciones de nivel superior) por Nombre, Iniciado, Finalizado, Duración o Estado haciendo clic en la fila de encabezado respectiva.

Se muestran un máximo de 1000 registros de operaciones. Para ver registros de operaciones adicionales, ajusta los filtros en consecuencia.

• Nombre: El nombre de la operación o paso de operación. Los triángulos de divulgación que se pueden usar para expandir o colapsar filas adicionales se muestran en las operaciones principales y en las operaciones para las cuales hay datos de entrada y salida de componentes disponibles:

  • Operaciones principales: Cuando se expande una operación principal, aparecen filas adicionales para sus operaciones secundarias en el orden en que se ejecutaron. Por defecto, todas las operaciones principales están expandidas. Usa los íconos colapsar lista o expandir lista junto a la barra de búsqueda para colapsar o expandir todas las operaciones principales.

  • Operación con datos de entrada y salida: Cuando se expande una operación con datos de entrada y salida, aparecen filas adicionales para cada paso de operación en el orden en que se ejecutaron. Se proporciona más información en Datos de entrada y salida de componentes.

• Entrada/Salida: Esta columna se muestra solo cuando la tabla contiene una operación que tiene habilitado el registro de depuración de operaciones a nivel de operación (para agentes en la nube o para agentes privados) y la operación se ejecutó en un agente 10.48 o posterior. Los datos de entrada y salida accesibles a través de esta parte de la tabla de registros se describen en Datos de entrada y salida de componentes.

• Iniciado: La fecha y hora en que la operación o paso de operación comenzó a ejecutarse, mostrada como la hora local del navegador.

• Finalizado: La fecha y hora en que la operación o el paso de la operación dejó de ejecutarse, mostrada como la hora local del navegador.

• Duración: El tiempo transcurrido entre Iniciado y Finalizado, reportado en segundos para operaciones y en milisegundos para pasos de operación.

• Estado: El estado de la operación o del paso de la operación. Para una lista completa de posibles estados, consulta Estados de operación más arriba en esta página.

• Acciones: Esta acción está disponible:

  • Cancelar operación: Habilitado para operaciones que están en estado Enviado, Recibido, Pendiente o Ejecutándose.

    Cancelar operación envía una solicitud al agente para detener la operación. Una vez clicado, se muestra el estado Cancelación Solicitada junto al estado de operación en tiempo real.

    Nota

    Las operaciones que tienen un estado Cancelación Solicitada pueden seguir ejecutándose.

• Registro de operación: Para mostrar u ocultar un registro de una operación individual, haz clic en cualquier parte de una fila de operación, excepto en los íconos mostrados en la columna Entrada/Salida (si está presente):

  

  • Registros de origen: Al usar una actividad de FTP o Base de datos como fuente, se muestra el conteo de registros que han sido leídos del sistema fuente. Para otros conectores, el conteo muestra 0 independientemente del número de registros de origen.

  • Registros de destino: Al usar una actividad de FTP o Base de datos como destino, se muestra el conteo de registros que han sido publicados en el sistema de destino. Para otros conectores, el conteo muestra 0 independientemente del número de registros de destino.

  • Mensajes de registro: Los mensajes de registro incluyen los detalles del registro para la operación seleccionada. Si se muestran mensajes de registro depende de los permisos y niveles de acceso del usuario actual y de si el registro en la nube está habilitado. Para más información, consulta la pestaña Mensajes en la documentación de la página Operaciones en tiempo de ejecución de la Consola de Administración.

    Nota

    Las fechas y horas mostradas dentro de los mensajes de registro no se convierten a la hora local del navegador, sino que se informan en su formato original desde la fuente del mensaje de registro.

  • Copiar: Copia los datos del registro en tu portapapeles.

  • Descargar: Descarga los mensajes de registro como un archivo de texto.

  • Mostrar / ocultar: Muestra u oculta los mensajes de registro.

Datos de entrada y salida del componente

Los datos de entrada y salida del componente se generan cuando una operación tiene habilitado el registro de depuración de operaciones a nivel de operación (para agentes en la nube o para agentes privados) y la operación se ejecutó en un agente 10.48 o posterior.

Cuando están presentes los datos de entrada y salida del componente, se muestra una columna Entrada/Salida que muestra una representación gráfica de la operación o paso de operación en la tabla de registros de operaciones.

En la columna Entrada/Salida, se pueden hacer clic en los íconos de actividades y transformaciones utilizadas como pasos de operación para mostrar u ocultar los datos de entrada y salida del componente para ese paso de operación individual. Cada entrada de registro de entrada y salida está limitada a 100MB. Si los datos de una entrada de registro de entrada o salida individual superan los 100MB, no se mostrará ningún dato.

• Buscar: Busca los datos del texto ingresado.

• Copiar: Copia los datos del registro en tu portapapeles.

• Descargar: Descarga los datos de entrada o salida como un archivo en el formato de datos apropiado. El archivo se nombra con el nombre del paso de operación seguido de _input o _output según corresponda.