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.

The download format is .csv, which makes it data-analysis compliant, and you can access it from the My Reports page.

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

Nota:

Los registros de auditoría, transacciones de cola, registros y trabajos están limitados a 100 exportaciones por día por inquilino. Una vez que se supere ese límite, se mostrará un error #4502, indicando que se ha alcanzado el límite diario por tenant. El límite se restablece a las 00:00 UTC.

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 creaste 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 está disponible hasta el 7 a las 23:59.

Para ver tus exportaciones, selecciona el botón de elipsis vertical (⋮) que está junto a Tenant y elige Mis informes de la lista.

Figura 1. Mis informes

Puedes ver las siguientes propiedades de una exportación:

• Export type - refers to the Orchestrator object
• Created on - the relative timestamp of when you created the export
• Creado el (absoluto) : la marca de tiempo exacta de cuando creaste la exportación. Las marcas de tiempo absolutas se representan en la zona horaria del tenant. Para los desencadenadores, el siguiente tiempo de ejecución se representa en la zona horaria del desencadenador, que puede diferir de la zona horaria del tenant.
• Disponible hasta: la fecha en que se eliminará la exportación 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.
• Status - the status of the export operation:
  • New - the export is in progress.
  • Completed - the export finished.
  • Falló: la exportación falló. Esto puede ser generado por el tiempo de espera de SQL o por almacenamiento bajo. Debes reintentar manualmente la exportación. El periodo de cómputo para resolver la exportación es de un máximo de 15 minutos. Después de este período, la exportación falla. Antes de volver a intentar la exportación, aplica filtros adicionales a tus datos.
    Importante:

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

    • You must use the API endpoints for the corresponding Orchestrator object. For example, use /odata/AuditLogs/UiPath.Server.Configuration.OData.Export to export Audit logs.
    • 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.

To download the data to your device, click the Download button for the desired report. This operation uses the default download location on your device. The report is downloaded as an archive, which contains the .csv file of the grid filtered data.

Nota:

To download exports to your device, you need to add the storage domains to your allowlist. More info here.

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}-items-{export-date}-{export-timestamp}-{export-id} Si el nombre de cola contiene caracteres no válidos (`\ / : * ? " < >
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)	❌
Progress	Progreso	❌
Id	ID	✅

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	❌

Campos compatibles para las exportaciones de API de registros de robots

La siguiente tabla enumera los campos disponibles en el informe generado al exportar los registros de los robots 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
JobKey	N/D	✅
TimeStamp	Tiempo (absoluto)	✅
Level	Nivel	✅
ProcessName	Proceso	✅
HostMachineName	NombreDelHost	✅
WindowsIdentity	Identidad de host	✅
Message	Mensaje	✅
RawMessage	N/D	❌
RobotName	Nombre del robot	✅
MachineId	N/D	❌
MachineKey	N/D	✅
RuntimeType	N/D	❌

Campos compatibles para las exportaciones de API de trabajos

Campo API	Columna correspondiente en el informe exportado	Permite filtrar
CreationTime	N/D	✅
SourceType	N/D	✅
State	Estado	✅
SpecificPriorityValue	Prioridad	✅
HostMachineName	NombreDelHost	✅
LocalSystemAccount	Identidad de host	✅
MachineName	Máquina	❌
Key	Clave	❌
JobPriority	N/D	❌
ReleaseName	Proceso	❌
RobotName	Robot	❌
MachineScope	N/D	❌
EnvironmentName	Entorno	❌
Type	Tipo de trabajo	❌
RuntimeType	Tipo de Runtime/licencia	❌
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	❌