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. Si se muestran mensajes de registro detallados depende de los niveles de permiso y acceso y de si el registro en la nube está habilitado. Cuando se genera un registro de depurar de operación (para agentes en la nube o para agentes privados) está habilitado para una operación individual, cada registro de operación también contiene datos de entrada y salida para la operación.

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

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

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

Acceder a los registros de operación

Se puede acceder a los registros de operaciones en Integration Studio en el nivel de flujo de trabajo, operación o proyecto. Según dónde se acceda a ellos, la pantalla de registro de operación incluye un máximo de 1000 registros para un período de tiempo determinado para operaciones que se han ejecutado en un flujo de trabajo en particular, para una operación en particular o en un proyecto, respectivamente. Si las operaciones están vinculadas con acciones de operación o el RunOperation Función, también se incluyen registros de operaciones abajo en la cadena.

Por flujo de trabajo

Se puede acceder a la opción Ver registros de un flujo de trabajo, que muestra los registros de las operaciones que se han ejecutado dentro de un flujo de trabajo en particular, desde la pestaña Flujos de trabajo del panel del proyecto (consulte menú de acciones del Flujo de trabajo en la pestaña Flujos de trabajo del panel Proyecto).

Por operación

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

• La pestaña Flujos de trabajo del panel del proyecto (vea menú de acciones del componente en la pestaña Flujos de trabajo del panel Proyecto).
• La pestaña Componentes del panel del proyecto (vea menú de acciones de componentes en la pestañaComponentes del panel Proyecto).
• El tela de diseño (vea menú de acciones del componente en Lienzo de diseño).

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

Por proyecto

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

Se puede acceder a la opción Ver registros de un proyecto desde estas ubicaciones:

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

Cajón de registro de operaciones

Al visualizar registros por flujo de trabajo u operación, se abre un cajón de registro de operación en la parte inferior del tela de diseño para mantener su contexto en el proyecto:

• Pestañas: Las pestañas en la parte superior del cajón de registro de operación están etiquetadas con Registro seguido del nombre de la operación o flujo de trabajo (según desde dónde se accedió a los registros). Cuando accede a registros adicionales, se agregan nuevas pestañas. Para reordenar las pestañas, arrastre y suelte una pestaña. Para cerrar una pestaña, haga clic en su icono de cerrar. Cerrar la última pestaña o usar el icono más a la derecha el icono de cerrar cierra el cajón de registro.
• Cambiar tamaño: La barra en la parte superior del cajón de registro se puede utilizar para cambiar el tamaño del cajón de registro. Pase el cursor sobre la barra y arrastre el icono cambie el tamaño del ícono hacia arriba o hacia abajo para cambiar el tamaño del cajón de registro.
• Contraer: Contrae el cajón de registros para que todos los registros queden ocultos. Una vez contraído, haga clic en el botón icono de retorno para volver a la vista anterior.
• Expandir: Expande el cajón de registros a pantalla completa para que se muestren los registros adicionales. Una vez expandido, haga clic en el ícono de retorno para volver a la vista anterior.
• Abrir en una nueva pestaña: Abre la vista del registro de operación en pantalla completa en una nueva pestaña.
• Cerrar: Cierra el cajón de registro.

Controles de la tabla de registro de operaciones

El registro de operación vista de cajón incluye filtros para período de tiempo y consultas, y la tabla actualizar.

Periodo de tiempo

Todos los períodos de tiempo se muestran como la hora local del navegador. De manera predeterminada, el período de tiempo se establece en las Últimas 24 horas de registros desde la última vez que se ejecutó una operación. Como alternativa, use el menú para seleccionar Últimas 48 horas, Últimas 72 horas o Hora personalizada:

Para un período de tiempo determinado, se incluyen un máximo de 1000 registros en la tabla de registro de operación.

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

• Terminado: Para filtrar por la fecha y hora en que la operación o el etapa de operación dejó de ejecutarse, haga clic en el botón icono de calendario para abrir el selector de fechas. Para borrar este campo, haga clic en el Icono de filtro claro.
• Iniciado: Para filtrar por la fecha y hora en que comenzó a ejecutarse la operación o el etapa de operación, haga clic en el icono de calendario para abrir el selector de fechas. Para borrar este campo, haga clic en el Icono de filtro claro.
• Aplicar: (Habilitado cuando se configuran los campos Terminado o Iniciado). Aplica todos los filtros de fecha y hora a la tabla de registros de operación.
• Borrar: (Habilitado cuando se configuran los campos Terminado o Iniciado). Borra los filtros Terminado y Iniciado.

Una vez que se configura un Al hacer clic en el icono del calendario, se abre el selector de fecha y hora para ese campo:

• Fecha de inicio/finalización: Use el calendario debajo de uno o ambos de estos campos para seleccionar una fecha dentro de los últimos 30 días.

  • Mes: Se usa el mes actual de manera predeterminada. Use el calendario debajo de uno o ambos de estos campos para seleccionar una fecha dentro de los últimos 30 días.

  • Mes: Se usa el mes actual de manera predeterminada. flechas para navegar a un mes diferente.

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

• Hora: Escriba la hora, los minutos y el período de tiempo (AM o PM).

Actualizar

Los registros se actualizan automáticamente cada cinco segundos si alguna operación aún está en estado de ejecución (estado Recibido, Enviado, Pendiente o En ejecución).

También puede actualizar manualmente los registros en cualquier momento para mostrar información actualizada. Para actualizar manualmente los registros, haga clic en el botón Icono de actualización en la parte superior derecha.

Consultas

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

Para utilizar una consultar, ingrese una especificación de consultar válida en la barra de búsqueda y luego presione Enter:

La siguiente tabla muestra los componentes del término de consultar disponibles:

Estados de operación

Los siguientes son estados que se pueden consultar al utilizar el status llave:

• 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 fatal de validación en la transformación, o la lógica de transformación activó el RaiseError función, entonces el estado de la operación se establece en Error y la ejecución de la operación finaliza.

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

• Enviado: 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 el estado Enviado. Las operaciones se pueden enviar por varios medios:

  • Servicio de programación Jitterbit o servicio de programación externo
  • Ejecución manual de la operación en Integration Studio
  • A RunOperation función de un secuencia de comandos o transformación
  • Cualquier herramienta, incluyendo JitterbitUtils, que llama a una API de API Manager

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

• Pendiente: Una vez que se programa la ejecución de una operación en el motor de operación de un agente, el estado cambia a Pendiente. Las operaciones no deben estar en estado Pendiente durante períodos prolongados, ya que los agentes deben atender la solicitud y comenzar a ejecutar operaciones en un breve período de tiempo.

• En ejecución: Una vez que el agente comienza a ejecutar una operación, el estado debe cambiar a En ejecución. Las operaciones permanecen en este estado hasta que se completan o hasta que se produce un error. El agente comienza a registrar los mensajes generados por la operación a medida que se ejecuta, de modo que los usuarios puedan realizar un seguimiento de qué parte de la operación se está ejecutando en ese momento.

• Cancelación solicitada: Indica que se ha enviado una solicitud para detener la operación. Si un usuario desea detener una operación que se encuentra en estado Enviada, Recibida, Pendiente o En ejecución, puede hacerlo desde estas ubicaciones:

  • La operación (vea estado de la operación en Lienzo de diseño).
  • La tabla de registro de operación.
  • Las Operaciones en tiempo de ejecución página de la Management Console (vea Cancelación de operaciones en tiempo de ejecución).

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

• Cancelado: Una vez que un agente cancela una operación, establece el estado en Cancelado y la operación finaliza. Toda la información de registro hasta el momento de la cancelación está disponible para su revisión en los mensajes de registro, de modo que sepa en qué momento se canceló la operación.

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

• Éxito con información: Si el agente completa la ejecución de una operación, pero hubo problemas no fatales en la transformación o publicación en el sistema de destino o en el WriteToOperationLog Se utilizó la función para escribir mensajes en el registro, luego el estado se establece en Éxito con información. Esto alerta al usuario para que verifique la información en los mensajes del registro.

• Éxito con advertencia: Si el agente completa la ejecución de una operación, pero hubo problemas no fatales en la transformación o la publicación en el sistema de destino y hubo una advertencia, el estado se establece en Éxito con advertencia. Esto alerta al usuario para que verifique si hay advertencias en los mensajes de registro.

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

• Estado retrasado: Si el agente no devuelve un registro de operación por algún motivo, se muestra Estado retrasado. Harmony intentará obtener los registros seis veces, con un tiempo de espera de 10 segundos entre cada llamada. Actualice o vuelva a verificar los registros más tarde. No puede filtrar las operaciones con Estado retrasado, pero puede verlas en los registros de operación.

Estado del paso de operación

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

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

• Completado: El etapa de operación se ejecutó y se completó sin ningún error.
• Error: El etapa de operación se ejecutó pero no se pudo completar debido a un error.
• Incompleto: El etapa de operación no se ejecutó o no se completó. Entre las posibles razones de este estado se incluyen que el etapa de operación está esperando a ser ejecutado o que hubo un error en un etapa de operación anterior que impidió la ejecución del siguiente paso.

Tabla de registro de operaciones

La tabla de registro de operación muestra los registros de operación utilizando los controles de tabla#controls). Si las operaciones están vinculadas con acciones de operación o el RunOperation Función, también se incluyen registros de operaciones abajo en la cadena.

Las operaciones principales (y cualquier operación secundaria que esté debajo de ellas) se ordenan en orden ascendente por Iniciada. La tabla se puede ordenar (solo para operaciones de nivel superior) por Nombre, Iniciada, Terminada, Duración o Estado haciendo clic en la fila de encabezado correspondiente.

Se muestran un máximo de 1000 registros de operación. Para ver los registros de operaciones adicionales, ajuste los filtros según corresponda.

• Nombre: El nombre de la operación o del etapa de operación. Los triángulos de divulgación, que se pueden usar para expandir o contraer filas adicionales, se muestran en las operaciones principales y en las operaciones para las que 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. De manera predeterminada, se expanden todas las operaciones principales. Utilice el comando colapsar lista o Expandir los íconos de lista en el encabezado de la columna para contraer 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 etapa de operación en el orden en que se ejecutaron. Se proporciona más información en Datos de entrada y salida del componente.

• Entrada/Salida: Esta columna se muestra solo cuando la tabla contiene una operación que tiene habilitado el registro de depurar de operación en el nivel de operación (para agentes de 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 a los que se accede a través de esta parte de la tabla de registro se describen en Datos de entrada y salida del componente.

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

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

• Duración: El tiempo transcurrido entre Inicio y Finalización, informado en segundos para las operaciones y en milisegundos para los pasos de la operación.

• Estado: El estado de la operación o del etapa de operación. Para obtener una lista completa de los estados posibles, consulte Estados de la operación anteriormente 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 En ejecución.

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

    Nota

    Las operaciones que tienen un estado Cancelación solicitada aún pueden ejecutarse.

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

  

  • Mensajes de registro: Los mensajes de registro incluyen los detalles de registro de la operación seleccionada. La visualización de los 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 obtener más información, consulte pestaña Mensajes en la Management Console Operaciones en tiempo de ejecución documentación de la página.

    Nota

    Las fechas y horas que se muestran en 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 de registro en el 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 de componentes

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

Cuando hay 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 el etapa de operación en la tabla de registro de operación.

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

• Buscar: Busca los datos del texto ingresado.

• Copiar: Copia los datos de registro al 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 etapa de operación seguido de _input o _output según corresponda.