proceso de flujo maestro de uip y procesos de flujo maestro de uip

Sintaxis y opciones para `proceso de flujo maestro de uip` y `procesos de flujo maestro de uip`, que cubren las operaciones de proceso de flujo publicadas por carpeta y en todo el tenant.

Una vez que se publica un paquete de flujo en Orchestrator, se convierte en un proceso. Esta página cubre dos grupos de comandos relacionados:

• uip maestro flow process — operaciones por carpeta en una sola definición de proceso (lista en una carpeta, obtener su esquema, ejecutarlo).
• uip maestro flow processes plural) : resúmenes de todo el tenant y búsqueda de incidentes por proceso.

Sinopsis

# Singular — per-folder, operational
uip maestro flow process list -f <folder-key> [--filter <odata>] [--login-validity <minutes>]
uip maestro flow process get  <process-key> <feed-id> -f <folder-key> [--login-validity <minutes>]
uip maestro flow process run  <process-key> <folder-key>
                       [-i, --inputs <json>]
                       [--release-key <key>] [--feed-id <id>] [--robot-ids <ids>]
                       [--attachment <name=path>]...
                       [--wait [--timeout <seconds>] [--poll-interval <seconds>]]
                       [--validate] [--login-validity <minutes>]
uip maestro flow process settings get       <process-key> -f <folder-key>
uip maestro flow process settings set       <process-key> -f <folder-key> [--inputs <json|@file>]
uip maestro flow process variable-tags get  <process-key> -f <folder-key>
uip maestro flow process variable-tags set  <process-key> -f <folder-key> [--variable <name>]... [--all] [--searchable <bool>] [--tags <csv>] [--add-tags <csv>] [--remove-tags <csv>] [--inputs <json|@file>]

# Plural — tenant-wide summary and incident surface
uip maestro flow processes list
uip maestro flow processes incidents    <process-key> --folder-key <key>
uip maestro flow processes diagnose     <process-key> --folder-key <key>
uip maestro flow processes error-codes  <process-key> --folder-key <key>

Todos los subcomandos requieren uip login y respetan las opciones globales. Los códigos de salida siguen el contrato estándar.

---

lista de procesos de flujo maestro de uip

Enumera los procesos de flujo disponibles (versiones) en una carpeta específica.

Opciones

Opción	Obligatorio	Descripción
-f, --folder-key <key>	Sí	Clave de carpeta (GUID).
--filter <odata>	No	Filtro OData adicional aplicado en el lado del servidor.
--login-validity <minutes>	No	Umbral de actualización del token (predeterminado 10).

Forma de datos (--output json)

{
  "Code": "FlowProjectList",
  "Data": [
    {
      "name":       "InvoiceFlow",
      "processKey": "a1b2c3d4-0000-0000-0000-000000000001:1.0.0",
      "releaseKey": "e5f6a7b8-0000-0000-0000-000000000001",
      "folderKey":  "c3d4e5f6-0000-0000-0000-000000000001",
      "feedId":     "default",
      "folderId":   42,
      "active":     "Yes",
      "latest":     "Yes"
    }
  ]
}

---

obtención del proceso de flujo maestro de uip

Obtener el esquema de punto de entrada (esquemas JSON de entrada/salida) para un proceso de flujo. Utilice el resultado para crear una carga útil --inputs válida para process run.

Argumentos

• <process-key> (obligatorio) : clave de proceso, p. ej. MyFlow.flow.Flow:1.0.0 o <package-id>:<version>.
• <feed-id> (obligatorio) : ID de fuente (de la salida list ).

Opciones

• -f, --folder-key <key> (obligatorio)
• --login-validity

Forma de datos

{
  "Code": "FlowProjectGet",
  "Data": [
    {
      "Path":         "/content/main.flow",
      "DisplayName":  "Main",
      "Type":         "Flow",
      "InputSchema":  "{\"type\":\"object\",\"properties\":{}}",
      "OutputSchema": "{\"type\":\"object\",\"properties\":{}}"
    }
  ]
}

InputSchema y OutputSchema son JSON restringidas; analizarlos como esquema JSON para impulsar la construcción de entrada.

---

ejecución del proceso de flujo maestro de uip

Inicia un trabajo de flujo para un proceso publicado.

Argumentos

• <process-key> (obligatorio) : clave de proceso (p. ej. MyFlow.flow.Flow:1.0.0).
• <folder-key> (obligatorio) : clave de carpeta (GUID).

Opciones

Opción	Descripción
-i, --inputs <json>	Entradas como una cadena JSON o @path/to/file.json. Si se omite y se canaliza la entrada estándar, la entrada estándar se analiza como entradas.
--release-key <key>	Clave de versión (GUID): desde process list.
--feed-id <id>	ID de fuente para la búsqueda de paquetes (opcional).
--robot-ids <ids>	ID de robot separados por comas (entero). Los valores no válidos fallan rápidamente.
--attachment <name=path>	Carga un archivo local en Orchestrator y vincúlalo como una variable de entrada de tipo de archivo. Repetible, por ejemplo --attachment file1=./resume.pdf. Anula el mismo nombre de variable si también está presente en --inputs.
--wait	Bloquea hasta que el trabajo alcance un estado terminal en lugar de volver inmediatamente con Pending.
--timeout <seconds>	Máximo de segundos de espera. 0 = sin tiempo de espera. Requiere --wait.
--poll-interval <seconds>	Segundos entre comprobaciones de estado mientras se espera. Requiere --wait.
--validate	Valida las entradas con el esquema del proceso antes de ejecutar. Solo realiza comprobaciones básicas: los campos obligatorios presentes y los tipos primitivos coinciden. Este pase no aplica restricciones complejas (enumeraciones, patrones, referencias).
--login-validity <minutes>	Umbral de actualización del token (predeterminado 10).

Precedencia de entrada: --inputs <json> / --inputs @file.json > stdin > objeto vacío {}.

Ejemplos

# Run with inline JSON
uip maestro flow process run "InvoiceFlow.flow.Flow:1.0.0" "c3d4e5f6-0000-0000-0000-000000000001" \
  --release-key "e5f6a7b8-…" --inputs '{"amount":100}'

# Run with inputs from a file
uip maestro flow process run "InvoiceFlow.flow.Flow:1.0.0" "c3d4e5f6-…" --inputs @inputs.json

# Run with inputs piped from stdin
echo '{"amount":100}' | uip maestro flow process run "InvoiceFlow.flow.Flow:1.0.0" "c3d4e5f6-…"

# Validate before running
uip maestro flow process run "InvoiceFlow.flow.Flow:1.0.0" "c3d4e5f6-…" \
  --inputs '{"amount":100}' --validate

Forma de datos

{
  "Code": "FlowJobStarted",
  "Data": {
    "jobKey":  "b2c3d4e5-0000-0000-0000-000000000001",
    "state":   "Pending",
    "traceId": "d4e5f6a7-0000-0000-0000-000000000001"
  }
}

Siguiente paso: uip maestro flow job traces <jobKey> a la ejecución de la transmisión o uip maestro flow job status <jobKey> al sondeo.

---

configuración del proceso de flujo maestro de uip

Obtener o actualizar la configuración de runtime de un proceso.

configuración del proceso de flujo maestro de uip get

Argumentos

• <process-key> (obligatorio) : clave de definición del proceso.

Opciones

• -f, --folder-key <key> (obligatorio)

Forma de datos

Code: "ProcessSettingsGet", Data es el objeto de configuración del proceso.

configuración del proceso de flujo maestro de uip establecida

Argumentos

• <process-key> (obligatorio)

Opciones

Opción	Descripción
-f, --folder-key <key>	(obligatorio) Clave de carpeta (GUID).
--inputs <value>	Configuración de la carga útil como una cadena JSON, una ruta @file o canalizada a través de la entrada estándar.

Forma de datos

Code: "ProcessSettingsSet".

Etiquetas-variables del proceso de flujo maestro de uip

Obtener o actualizar las etiquetas de capacidad de búsqueda en las variables de salida de un proceso: qué variables se pueden utilizar para filtrar instancias.

obtener etiquetas variables del proceso de flujo maestro de uip

Argumentos

• <process-key> (obligatorio)

Opciones

• -f, --folder-key <key> (obligatorio)

Forma de datos

Code: "ProcessVariableTagsGet", Data es el mapa variableTags del proceso ({} si no se establece ninguno).

conjunto de etiquetas de variables de proceso de flujo maestro de uip

Dos estilos de entrada mutuamente excluyentes: pasar --inputs con una carga útil JSON completa, o utilizar los marcadores amigables --variable/--all/--searchable/--tags/--add-tags/--remove-tags — combinar ambos falla con un error.

Argumentos

• <process-key> (obligatorio)

Opciones

Opción	Descripción
-f, --folder-key <key>	(obligatorio) Clave de carpeta (GUID).
--variable <name>	Nombre de una variable (salida) para etiquetar. Repetible, para etiquetar varios en una llamada.
--element-id <id>	Elemento al que pertenece la variable: elimina la ambigüedad cuando el mismo nombre aparece en varios elementos. Solo es válido con un único --variable.
--all	Aplica el cambio a cada variable etiquetable.
--searchable <bool>	Marque la(s) variable(s) como buscable(s) para el filtrado de instancias (true/false).
--tags <csv>	Avanzado: reemplaza las etiquetas actuales de la variable directamente. El valor vacío los borra.
--add-tags <csv>	Añade etiquetas a las etiquetas actuales de la variable.
--remove-tags <csv>	Eliminar etiquetas de las etiquetas actuales de la variable.
--inputs <value>	Carga útil completa de etiquetas variables como una cadena JSON, una ruta @file o canalizada a través de la entrada estándar: una alternativa a los marcadores anteriores.

Forma de datos

Code: "ProcessVariableTagsSet".

---

lista de procesos de flujo maestro de uip

Resumen de todo el tenant de los procesos de flujo (/processes/summary?processType=Flow). Sin argumentos, sin opciones más allá de las globales.

Forma de datos

{
  "Code": "ProcessList",
  "Data": [
    {
      "processKey":     "…",
      "name":           "…",
      "folderKey":      "…",
      "latestVersion":  "…"
    }
  ]
}

Nota:

El tiempo de ejecución de Maestro especifica el conjunto de campos exacto de cada resumen de proceso y puede evolucionar; ejecuta el comando una vez con --output json en un tenant con datos para ver los campos que consumirás y ancla @uipath/cli en CI si analizas campos específicos.

---

Incidentes de procesos de flujo de UIP Maestro

Obtener todos los incidentes para una definición de proceso de flujo específica (no una sola instancia).

Argumentos

• <process-key> (obligatorio) : clave de definición del proceso.

Opciones

• --folder-key <key> obligatorio) : clave de carpeta para el ámbito de la búsqueda.

Forma de datos

{
  "Code": "ProcessIncidents",
  "Data": [ /* array of process incidents */ ]
}

Consulta uip maestro flow incident para ver la forma por incidente.

diagnóstico de procesos de flujo maestro de uip

Correlaciona el resumen, las incidencias y los códigos de error de un proceso en una llamada: un comando de triaje rápido.

Argumentos

• <process-key> (obligatorio) : clave de definición del proceso.

Opciones

• --folder-key <key> (obligatorio)

Forma de datos

{
  "Code": "ProcessDiagnostics",
  "Data": {
    "ProcessKey": "…",
    "FolderKey": "…",
    "Summary": { /* this process's entry from processes/summary, or null if not found */ },
    "FaultedCount": 0,
    "RunningCount": 0,
    "Incidents": [ /* array of incidents */ ],
    "IncidentCount": 0,
    "ErrorCodes": [ /* array of error code strings */ ],
    "ErrorCodeCount": 0
  }
}

Códigos de error de procesos de flujo maestro de uip

Obtén el conjunto único de códigos de error vistos en los incidentes de un proceso.

Argumentos

• <process-key> (obligatorio)

Opciones

• --folder-key <key> (obligatorio)

Forma de datos

{
  "Code": "ProcessIncidentErrorCodes",
  "Data": ["Process.UnhandledException"]
}

Ver también

• uip maestro flow instance : inspeccionar y dirigir las ejecuciones en ejecución
• uip maestro flow job : seguimientos y estado de un solo trabajo
• uip maestro flow incident — resúmenes y detalles de incidentes
• Trabajos de Orchestrator, procesos de Orchestrator
• Descripción general del flujo