Exportar cuadrícula en segundo plano

Información general

Los objetos de Orchestrator se muestran en su página dedicada, en una cuadrícula con varias columnas que son útiles para describir el estado de ese objeto.

Puede exportar estas cuadrícula para obtener un lote de datos que luego podrá utilizar para crear paneles o informes. La operación de exportación tiene lugar en segundo plano, lo que significa que puedes continuar interactuando con Orchestrator sin tener que esperar a que finalice la exportación, ya que una notificación te informa cuando la descarga está lista.

El formato de descarga es .csv, lo que lo hace compatible con el análisis de datos, y puede acceder a él desde la página Mis informes .

Objetos de Orchestrator disponibles para exportar

Puede exportar las cuadrícula de los siguientes objetos de Orchestrator:

• A nivel de tenant
  • Registros de auditoría
  • Registros de auditoría de prueba de automatización
• A nivel de carpeta
  • Poner en cola las transacciones
  • Registros
  • Trabajos

El informe exportado

Al hacer clic en el botón Exportar se crea una copia de la cuadrícula en la página Mis informes. Una ventana emergente te informa cuando la exportación se inicia y cuándo o si se completa.

Una vez finalizada la exportación, recibirás una alerta para informarte de que los datos se han exportado. El informe se descarga automáticamente en segundo plano, en la ubicación de descarga predeterminada de tu navegador, si tienes el permiso Ver en Alertas. Sin embargo, también puedes visitar la página Mis informes y descargar el informe cuando lo necesites.

La página Mis informes solo muestra las exportaciones que creó en las últimas 168 horas (7 días x 24 horas). Las exportaciones anteriores a 168 horas se eliminan de forma permanente. Por ejemplo, una exportación creada el 1 a las 00:00 estará disponible hasta el día 7 a las 23:59.

Para ver sus exportaciones, haga clic en el icono Mis informes en la barra de navegación superior.

Puedes ver las siguientes propiedades de una exportación:

• Tipo de exportación : se refiere al objeto de Orchestrator.
• Creado el : la marca de tiempo relativa a la que creaste la exportación
• Creado el (absoluto): la marca de tiempo exacta de creación de la exportación. Las marcas de tiempo absoluto se representan en la zona horaria del tenant. Para desencadenadores, el siguiente tiempo de ejecución se representa en la zona horaria del desencadenador, que puede ser distinta de la zona horaria del tenant.
• Disponible hasta : la fecha en que la exportación se eliminará de la lista. Los informes se eliminan a las 00:00 de la fecha especificada.

  Esto solo se muestra una vez que se ha exportado el informe.

• Tamaño : el tamaño de la exportación. Esto solo se muestra una vez que se ha exportado el informe.

• Estado : el estado de la operación de exportación:

  • Nuevo : la exportación está en curso.
  • Completada : la exportación ha finalizado.

  • Erróneo : la exportación ha fallado. Esto puede ser generado por el tiempo de espera de SQL o por poco almacenamiento. Debe volver a intentar la exportación manualmente.

    El tiempo informático para resolver la exportación es de un máximo de 15 minutos. Pasado este tiempo, la exportación falla. Antes de volver a intentar la exportación, aplique filtros adicionales a sus datos.

    Importante:

    Para evitar fallos en las exportaciones con una gran cantidad de datos:

    • Debe usar los puntos finales de la API para el objeto de Orchestrator correspondiente. Por ejemplo, usa /odata/AuditLogs/UiPath.Server.Configuration.OData.Export para exportar los registros de auditoría.

    • El volumen de exportaciones generadas, tanto en términos de frecuencia como de cantidad de datos recuperados, puede afectar al rendimiento de tu tenant. Si el rendimiento se ve afectado, podemos acelerar o bloquear dichas solicitudes para asegurarnos de que tus automatizaciones no se ven afectadas por este comportamiento.

    • Aplique filtros para reducir la cantidad de datos exportados.

Para descargar los datos a tu dispositivo, haz clic en el botón Descargar del informe deseado. Esta operación utiliza la ubicación de descarga predeterminada en su dispositivo. El informe se descarga como un archivo, que contiene el archivo .csv de los datos filtrados de la cuadrícula.

Nota:

Para descargar las exportaciones a tu dispositivo, debes añadir los dominios de almacenamiento a tu lista de permitidos. Más información aquí.

Los archivos .zip y .csv se nombran utilizando las siguientes convenciones de nomenclatura:

Tipo de objeto exportado	Descargar convención de nomenclatura
Poner en cola las transacciones	{queue-name} - elementos - {export-date} - {export-timetamp} - {export-id} Si el nombre de la cola contiene caracteres no válidos (\ / : * ? " < > |), se reemplazan por _.
Registros de auditoría	registros-de-auditoría - {export-date} - {export-timetamp} - {export-id}
Registros	robot-logs-{export-date}-{export-timestamp}-{export-id}
Trabajos	trabajos - {job_folder_key} - {export-date} - {export-timetamp} - {export-id}

Donde:

• {queue_name}: el nombre de la cola que contiene los elementos exportados

• {job_folder_key}: el ID de la carpeta desde la que se exportó la cuadrícula del trabajo

• {export_date}: la fecha en que se creó la exportación, en formato yyyy-MM-dd
• {export_timestamp}: la hora de creación de la exportación en formato HH-mm-ss-fff
• {export-id}: el ID de la exportación

Por ejemplo, un archivo de descarga de exportación para una cuadrícula de registros de auditoría podría llamarse audit-logs-2023-01-27-12-29-40-843-24.zip.

Importante:

Las columnas de tiempo de los informes exportados se expresan en la zona horaria del tenant.

Consideraciones importantes sobre las exportaciones de API

• Las palabras clave $select, $top, $skip, $orderBy, and $count en nuestra API de exportación no son compatibles y te recomendamos encarecidamente que evites utilizarlas. Utiliza los filtros adecuados en su lugar.
• Las entradas del informe solo están ordenadas por Id, es decir, $orderBy=Id. Se ignora cualquier otro parámetro utilizado para la palabra clave $orderBy.
• Filtrar a través de una estructura $filter= solo permite los campos marcados como disponibles en la tabla.

• Utilizar cualquiera de los campos no compatibles, como se describe en las siguientes tablas, devuelve un error 400.

Campos compatibles para las exportaciones de API de transacciones en cola

La siguiente tabla enumera los campos disponibles en el informe generado al exportar transacciones en cola a través de la API e indica si estos campos están permitidos para filtrar.

Campo API	Columna correspondiente en el informe exportado	Permite filtrar
QueueDefinitionId	N/D
Status	Estado
ReviewStatus	Revisión
Reference	Referencia
ProcessingExceptionType	Excepción
DueDate	N/D
DueDateAbs	Fecha límite (absoluta)
Priority	Prioridad
RobotName	Robot
DeferDate	N/D
DeferDateAbs	Posponer (absoluto)
StartProcessing	N/D
StartProcessingAbs	Iniciado (absoluto)
EndProcessing	N/D
EndProcessingAbs	Terminado (absoluto)
SecondsInPreviousAttempts	Tiempo de ejecución de transacción
AncestorId	AncestorId
AncestorUniqueKey	AncestorUniqueKey
RetryNumber	N.º de reintentos
ManualAncestorId	ID de antecesor manual
ManualAncestorUniqueKey	AntecesorClaveÚnica manual
ManualRetryNumber	N.° de reintento manual
UniqueKey	UniqueKey
SpecificData	Datos específicos
Key	Clave
ReviewerName	Nombre del revisor
ProcessingExceptionReason	Razón de excepción
Output	Salida
RobotId	N/D
ReviewerUserId	N/D
Analytics	Datos de análisis
CreationTime	N/D
CreationTimeAbs	Creado (absoluto)

Campos compatibles para las exportaciones de API de registros de auditoría

La siguiente tabla enumera los campos disponibles en el informe generado al exportar registros de auditorías a través de la API e indica si estos campos están permitidos para filtrar.

Campo API	Columna correspondiente en el informe exportado	Permite filtrar
Parameter	N/D
DisplayName	N/D
Action	Acción
Component	Componente
UserId	N/D
ExecutionTime	N/D
OperationText	Operación
ExecutionTimeAbs	Tiempo (absoluto)
ServiceName	N/D
MethodName	N/D
EntityId	N/D
UserType	N/D
UserIsDeleted	N/D
ExternalClientId	N/D
UserName	Usuario

Fields supported for robot logs API exports

The following table lists the fields that are available in the report generated by exporting robot logs via API, and indicates whether these fields are allowed for filtering.

Campo API	Columna correspondiente en el informe exportado	Permite filtrar
JobKey	N/D
TimeStamp	Tiempo (absoluto)
Level	Nivel
ProcessName	Proceso
HostMachineName	NombreDelHost
WindowsIdentity	Host Identity
Message	Mensaje
RawMessage	N/D
RobotName	Nombre del robot
MachineId	N/D
MachineKey	N/D
RuntimeType	N/D

Fields supported for jobs API exports

Campo API	Columna correspondiente en el informe exportado	Permite filtrar
CreationTime	N/D
SourceType	N/D
State	Estado
SpecificPriorityValue	Prioridad
HostMachineName	NombreDelHost
LocalSystemAccount	Host Identity
MachineName	Máquina
Key	Clave
JobPriority	N/D
ReleaseName	Proceso
RobotName	Robot
MachineScope	N/D
EnvironmentName	Entorno
Type	Tipo de trabajo
RuntimeType	Runtime type/license
StartTime	N/D
StartTimeAbs	Iniciado (absoluto)
EndTime	N/D
EndTimeAbs	Terminado (absoluto)
ProcessType	N/D
Source	Origen
CreationTimeAbs	Creado (absoluto)
ServerlessJobType	N/D
StartingScheduleId	N/D
Release	N/D
Machine	N/D
Robot	N/D

Exportar alertas

Todas las exportaciones que cree se registran en la página Alertas , siempre que tenga los permisos adecuados. Las exportaciones completadas se registran con la gravedad Info , mientras que las exportaciones fallidas se registran con la gravedad Error .

De forma predeterminada, recibe correos electrónicos de alerta sobre exportaciones completadas o fallidas. Puedes cancelar la suscripción de estas alertas entrando en la página Preferencias de alertas y desmarcando la opción Exportar .

Más información sobre Alertas.