uip ah

Gestione las ideas de automatización, el proceso, la taxonomía, el mercado y los usuarios de Automation Hub utilizando la herramienta `uip ah`.

uip ah es la herramienta Automation Hub (prefijo de comando ah, paquete @uipath/automation-hub-tool): gestiona el proceso de ideas de automatización: ideas enviadas a través de una evaluación, movidas a través de fases configurables, puntuadas y rastreadas hasta la entrega, más la taxonomía , colaboración y superficies de mercado a su alrededor. Instálalo con uip tools install ah, o invoca uip ah … y deja que se ejecute la instalación automática. Consulta Herramientas (complementos) para el modelo de instalación.

Conceptos

• Cada escritura es una sustitución de registro completo, no un parche. automations update, categories update, users update y tags set envían la forma de registro completa de Automation Hub: los campos que no pasas se transfieren de lo que ya está almacenado (o, para categories update/tags set, el toda la colección se reemplaza directamente). Compruebe las notas propias de cada verbo para ver exactamente qué se conserva y qué se sobrescribe.
• --all-fields en cada comando de lectura. Un registro sin procesar de Automation Hub contiene aproximadamente 300 claves, incluido un __display gemelo preformateado para la mayoría de ellas. Cada comando list/get se proyecta en un campo manejable establecido de forma predeterminada; pasar --all-fields para la carga útil intacta.
• Puntos finales paginados frente a no paginados. La mayoría de los comandos list llegan a un punto final de Automation Hub paginado y aceptan --limit/--offset normalmente. Algunos puntos finales (roles, idea-flows, questionnaires list, audit-logs list, collaborators list) devuelven toda su colección en una sola llamada sin paginación del lado del servidor: --limit/--offset se aplican del lado del cliente en estos, después de obtener el conjunto completo.
• Los ID provienen de otros comandos list , no de la IU. La interfaz de usuario web de Automation Hub no expone la mayoría de los ID numéricos que toma esta CLI (ID de categoría, ID de estado de fase, ID de rol): encuéntralos con el comando list --all-fields correspondiente, como señalan los propios mensajes de error de cada verbo.
• Errores específicos de esta herramienta: un 403 significa "no visible para tu rol de Automation Hub", nunca "no encontrado": Automation Hub no utiliza 404 para registros fuera de ámbito. Un "Automation Hub no está aprovisionado en este tenant" de clase 500; o "todavía no hay ningún registro de tenant propio" la respuesta aparece como Result: "ConfigError" con instrucciones de incorporación de tenant, distinta de un fallo de autenticación.

Recursos

Cada recurso tiene su propia página de referencia. El verbo establecido en cada página coincide con los comandos registrados por uip ah — ejecuta uip ah --help para confirmar la superficie completa en tu instalación.

Recurso	Propósito
automatizaciones, flujos de ideas, casos empresariales, fases, cuestionarios, procesos	El ciclo de vida de la idea central hasta la entrega: enviar y leer ideas de automatización, descubrir transiciones de fase/estado, leer análisis de coste-beneficio, mover ideas a través de fases, leer el catálogo de preguntas de evaluación y leer la vista del proceso clasificada por beneficios.
aplicaciones, componentes, documentos, archivos multimedia, listados de Store, reseñas de Store	Las automatizaciones de inventario de aplicaciones se etiquetan con componentes reutilizables, documentos y medios adjuntos, y el mercado de Automation Store (listados publicados y sus reseñas).
categorías, etiquetas, colaboradores, roles, usuarios	La taxonomía de categorías, las etiquetas de texto libre, los colaboradores por automatización y sus roles, el catálogo de roles asignables y las cuentas de usuario de Automation Hub.
audit-logs, auth-info	A continuación, en esta página, se tratan pequeños recursos de servicios públicos transversales.

registros de auditoría de UIP ah

Lee el seguimiento de auditoría de Automation Hub. Automation Hub agrupa el seguimiento en paquetes CSV semanales en lugar de un registro plano.

lista de registros de auditoría de uip ah

Enumerar paquetes de registros de auditoría para un intervalo de fechas.

Opciones

Largo	Valor	Descripción
--start-date <date>	YYYY-MM-DD	Inicio del rango.
--end-date <date>	YYYY-MM-DD	Fin del rango.
--limit <n>	Entero	Número máximo de paquetes que se devolverán. Predeterminado 20.
--offset <n>	Entero	Número de paquetes que se van a omitir. Predeterminado 0.
--all-fields	Marca	Devuelve la carga útil sin procesar en lugar de los campos Name/EntryCount proyectados.

Punto final no paginado: se obtiene toda la colección para el intervalo de fechas y luego se abre en ventana del lado del cliente. Un seguimiento vacío (un 404 "No se encontró el registro de auditoría") se pliega en una matriz Data vacía en lugar de aparecer como un error.

Ejemplo

uip ah audit-logs list --start-date 2026-07-01 --end-date 2026-08-04

Forma de datos (--json de salida)

{
  "Code": "AhAuditLogsList",
  "Data": [
    { "Name": "tenant-service-audit-log-(2026-08-02)-to-(2026-08-08).csv", "EntryCount": 12 }
  ]
}

Un paquete respaldado por un blob de referencia a objetos en lugar de entradas en línea devuelve Uri (el valor que toma download --uri) en lugar de EntryCount.

Descarga de registros de auditoría de UIP Ah

Guarda un paquete de registros de auditoría como archivo CSV local.

Opciones

Largo	Valor	Obligatorio	Descripción
--uri <name>	String	Sí	Nombre del paquete, exactamente como el campo Name de audit-logs list.
--destination <path>	Ruta	Sí	Ruta local en la que escribir el CSV.

Ejemplo

uip ah audit-logs download --uri <name> --destination ./audit.csv

Forma de datos (--json de salida)

{ "Code": "AhAuditLogsDownload", "Data": { "Destination": "./audit.csv", "Bytes": 4096, "Rows": 20 } }

información de autenticación de UIP ah

Recurso singular de nombre masivo: hay exactamente una identidad por sesión, por lo que no hay nada que enumerar.

uip ah auth-info get

Muestra el tenant de Automation Hub y tu identidad en él: la comprobación más rápida de que Automation Hub está habilitado e integrado para el tenant activo.

Opciones

Largo	Descripción
--all-fields	Devuelve la carga útil sin procesar en lugar de los campos Type/Tenant/User resumidos.

Ejemplo

uip ah auth-info get

Forma de datos (--json de salida)

{
  "Code": "AhAuthInfoGet",
  "Data": {
    "Type": "automation-cloud",
    "Tenant": { "Uuid": "...", "CompanyName": "acme - finance", "Url": "..." },
    "User": {
      "Id": 3, "Email": "[e-mail]", "FirstName": "Jane", "LastName": "Doe",
      "JobTitle": "Analyst", "Department": "Finance", "BusinessUnit": "EMEA",
      "IsAdmin": 1, "IsActive": 1, "Roles": ["ah-system-admin"]
    }
  }
}

Sinopsis

uip ah audit-logs list [--start-date <date>] [--end-date <date>] [--limit <n>] [--offset <n>] [--all-fields]
uip ah audit-logs download --uri <name> --destination <path>
uip ah auth-info get [--all-fields]

Consulta automatizaciones, flujos de ideas, casos empresariales, fases, cuestionarios, procesos, aplicaciones, componentes, documentos, medios, listados de Store, reseñas de Store y categorías, etiquetas, colaboradores, roles y usuarios para el resto de la superficie de comandos .

Ver también

• Herramientas (complementos)
• Herramientas de UIP
• Opciones globales
• Códigos de salida