Nodo de flujo maestro de uip y borde de flujo maestro de uip

Sintaxis y opciones para `nodo de flujo maestro de uip` y `borde de flujo maestro de uip`, que añaden, configuran, enumeran y eliminan nodos y bordes en un archivo `.flow`.

Un flujo es un gráfico. Los nodos son los vértices (desencadenadores, actividades, conectores, agentes); los bordes son las conexiones dirigidas entre ellos. Los comandos uip maestro flow node y uip maestro flow edge editan un archivo .flow in situ: añadir, configurar, enumerar y eliminar ambos.

Esta página también cubre dos grupos de comandos complementarios que editan el archivo .flow de la misma manera: variable y binding.

Sinopsis

uip maestro flow node add       <file> <node-type> [-i <json>] [--position <x,y>] [--label <label>] [--source <uuid>]
uip maestro flow node configure <file> <node-id> --detail <json>
uip maestro flow node list      <file>
uip maestro flow node remove    <file> <node-id>

uip maestro flow edge add    <file> <source-id> <target-id> [--source-port <port>] [--target-port <port>]
uip maestro flow edge list   <file>
uip maestro flow edge remove <file> <edge-id>

Prevalece las opciones globales. Los códigos de salida siguen el contrato estándar.

---

adición de nodo de flujo maestro de uip

Añade un nodo a un archivo .flow . El tipo de nodo debe existir en el registro: utiliza uip maestro flow registry search para descubrir valores <node-type> válidos.

Argumentos

• <file> (obligatorio) : ruta al archivo .flow .
• <node-type> (obligatorio) : identificador de tipo de nodo (p. ej. core.trigger.manual, uipath.connector.slack.send-message).

Opciones

Opción	Descripción
-i, --input <json>	Objeto JSON de valores de entrada para establecer en el nodo (por ejemplo '{"script":"…"}'). Debe ser un objeto JSON, no una matriz o escalar. Para los nodos de conector (tipo uipath.connector.*), no pase --input aquí; ejecute node configure después.
--position <x,y>	Posición del lienzo, p. ej. 250,150. Tanto x como y son números obligatorios.
--label <label>	Mostrar etiqueta para el nodo.
--source <uuid>	Identificador de origen para nodos de agente en línea ( model.source).
--parent <node-id>	ID del nodo existente que debe contener este nodo: se establece al crear un cuerpo de bucle cuya contención no se puede inferir solo de los bordes (normalmente el ID de un nodo core.logic.loop).

Ejemplo

uip maestro flow node add invoice-flow.flow uipath.connector.slack.send-message --label "Notify team"

Forma de datos (--output json)

{
  "Code": "NodeAddSuccess",
  "Data": {
    "Node": { "id": "node_a1b2c3d4", "type": "uipath.connector.slack.send-message" },
    "DefinitionAdded": true,
    "BindingsCreated": 0,
    "VariableCount": 0
  }
}

DefinitionAdded es true en la primera inserción de un node-type dado: se crea la entrada correspondiente en la matriz .flow definitions[] .

---

configuración del nodo de flujo maestro de uip

Rellene inputs.detail en un nodo ya añadido y cree los enlaces de flujo de trabajo que necesita. Ejecuta esto después de node add para los nodos de conector y HTTP gestionados.

Argumentos

• <file> (obligatorio) : ruta al archivo .flow .
• (obligatorio) <node-id> ID del nodo a configurar (encuéntralo con node list).

Opciones

• --detail <json> (obligatorio) : JSON de configuración. La forma depende del tipo de nodo:

Nodos de conector (uipath.connector.*)

Obtener method y endpoint de connectorMethodInfo en la salida registry get .

• Requerido: connectionId, folderKey, method, endpoint
• Opcional: bodyParameters, queryParameters, pathParameters

uip maestro flow node configure invoice-flow.flow node_a1b2c3d4 --detail '{
  "connectionId": "b2c3d4e5-0000-0000-0000-000000000001",
  "folderKey":    "c3d4e5f6-0000-0000-0000-000000000001",
  "method":       "POST",
  "endpoint":     "/issues",
  "bodyParameters": { "summary": "Bug" }
}'

Nodos HTTP gestionados (core.action.http.v2)

Dos modos de autenticación:

Modo de conector (authentication: "connector"): utiliza una conexión de Integration Service para la autenticación:

• Requerido: authentication, method, connectionId, folderKey, targetConnector
• method ∈ GET, POST, PUT, PATCH, DELETE, OPTIONS, HEAD
• Opcional: url (ruta adjunta a la URL base del conector), headers, query, body

uip maestro flow node configure invoice-flow.flow node_abc --detail '{
  "authentication":  "connector",
  "targetConnector": "uipath-microsoft-outlook365",
  "connectionId":    "…",
  "folderKey":       "…",
  "method":          "GET",
  "url":             "/me"
}'

Modo manual (authentication: "manual"): sin autenticación de conector, proporciona tú mismo la URL completa y cualquier encabezado de autenticación:

• Obligatorio: authentication, method, url (URL completa)
• Opcional: headers, query, body (cadena; puede ser una expresión, por ejemplo =js:({…}))

uip maestro flow node configure invoice-flow.flow node_abc --detail '{
  "authentication": "manual",
  "method":         "GET",
  "url":            "https://api.example.com/data",
  "headers":        { "Authorization": "Bearer <token>" }
}'

Forma de datos (--output json)

{
  "Code": "NodeConfigureSuccess",
  "Data": {
    "NodeId": "node_a1b2c3d4",
    "BindingsCreated": 2,
    "DetailPopulated": true
  }
}

---

lista de nodos de flujo maestro de uip

Enumera todos los nodos en un archivo .flow .

Argumentos

• <file> (obligatorio) : ruta al archivo .flow .

Forma de datos (--output json)

{
  "Code": "NodeListSuccess",
  "Data": {
    "Nodes": [
      { "id": "start",          "type": "core.trigger.manual" },
      { "id": "node_a1b2c3d4",  "type": "core.action.http.v2" }
    ],
    "Count": 2
  }
}

Cada entrada incluye como mínimo id y type; el servicio también adjunta metadatos de visualización de la matriz .flow definitions[] .

---

Eliminar nodo de flujo maestro de uip

delete es un alias registrado para remove: ambos eliminan un nodo del archivo.

Elimina un nodo y todo lo que posee. Elimina:

• Bordes conectados
• Vinculaciones huérfanas
• Definiciones huérfanas
• Variables de nodo propiedad del nodo eliminado
• Actualizaciones de variables propiedad del nodo eliminado

Argumentos

• <file> (obligatorio) : ruta al archivo .flow .
• <node-id> obligatorio) : ID del nodo a eliminar.

Forma de datos (--output json)

{
  "Code": "NodeDeleteSuccess",
  "Data": {
    "DeletedNode":           { "id": "node_a1b2c3d4", "type": "core.action.http.v2" },
    "EdgesRemoved":          1,
    "BindingsRemoved":       0,
    "DefinitionsRemoved":    0,
    "VariablesRemoved":      0,
    "VariableUpdatesRemoved": 0
  }
}

---

adición de borde de flujo maestro de uip

Añade un borde entre dos nodos. delete es un alias registrado para edge remove.

Argumentos

• <file> (obligatorio) : ruta al archivo .flow .
• <source-id> obligatorio) : ID del nodo de origen.
• <target-id> obligatorio) : ID del nodo de destino.

Opciones

• --source-port <port> — nombre del puerto de origen (predeterminado: output).
• --target-port <port> : nombre del puerto de destino (predeterminado: input).

Forma de datos (--output json)

{
  "Code": "EdgeAddSuccess",
  "Data": {
    "Edge": {
      "id":         "edge_a1b2c3d4",
      "source":     "Node_1",
      "target":     "Node_2",
      "sourcePort": "output",
      "targetPort": "input"
    }
  }
}

---

lista de bordes de flujo maestro de uip

{
  "Code": "EdgeListSuccess",
  "Data": {
    "Edges": [
      { "id": "edge_a1b2c3d4", "source": "Node_1", "target": "Node_2" }
    ],
    "Count": 1
  }
}

---

Eliminar borde de flujo maestro de uip

Elimina un solo borde por ID. Usa edge list para encontrar el ID.

{
  "Code": "EdgeDeleteSuccess",
  "Data": {
    "DeletedEdge": { "id": "edge_a1b2c3d4", "source": "Node_1", "target": "Node_2" }
  }
}

---

Variables

Un grupo de comandos complementario (aún no en la barra lateral) edita el subárbol variables de un archivo .flow.

Corrección: una versión anterior de esta página también documentaba un grupo de comandos variable-update (añadir/enumerar/eliminar, adjuntar una expresión JS a un nodo). Ese grupo no existe en ningún lugar del repositorio: nunca se registró y no existe ningún archivo de implementación. Se ha eliminado de esta página.

variable de flujo maestro de uip

uip maestro flow variable add    <file> <variable-id> -d, --direction <direction> [-t, --type <type>] [--default-value <val>] [--description <text>] [--schema <json>] [--sub-type <type>] [--trigger-node-id <nodeId>]
uip maestro flow variable list   <file>
uip maestro flow variable remove <file> <variable-id>

• direction ∈ in, out, inout (obligatorio).
• type ∈ string, number, boolean, object, array, file (predeterminado string).
• --default-value se analiza por --type : los valores object/array deben ser JSON válidos de la forma coincidente.
• --schema debe ser un objeto JSON (por ejemplo '{"type":"string"}').
• --trigger-node-id <nodeId> : el nodo desencadenador al que pertenece una variable de entrada . El valor predeterminado es el único nodo desencadenador del flujo; requerido cuando el flujo tiene más de un punto de entrada.

Formas de datos: VariableAddSuccess (Data.Variable), VariableListSuccess (Data.Variables[], Count), VariableRemoveSuccess (Data.DeletedVariable).

---

Bindings

Las vinculaciones declaran los recursos externos que necesita un flujo en el momento de la publicación/implementación (un proceso de destino, un agente, una conexión, una cola, etc.) y a qué propiedad de nodo se conectan.

uip maestro flow binding add    <file> <name> <resource> <default-value> [--resource-key <key>] [--property-attribute <attr>] [--resource-sub-type <type>]
uip maestro flow binding list   <file>
uip maestro flow binding remove <file> <resource-key>

• <resource> debe ser uno de los VALID_RESOURCE_TYPES del servicio (que se muestra en el mensaje de error del comando add si se pasa un valor no válido).
• --property-attribute es la propiedad del nodo de destino que rellena la vinculación (p. ej. name, folderPath, connection).
• --resource-sub-type proporciona subclasificación (p. ej. Agent, Process).
• binding remove (el único verbo registrado; no hay alias binding delete , a diferencia de node/edge) elimina todas las vinculaciones con la clave de recurso dada, ni una sola entrada por ID.

Formas de datos: BindingAddSuccess (Data.Binding), BindingListSuccess (Data.Bindings[], Count), BindingRemoveSuccess (Data.DeletedBindings[], Count).

---

formato de flujo maestro de uip

Diseño automático: reposiciona los nodos en un archivo .flow para eliminar las superposiciones y organizar el gráfico de forma limpia.

uip maestro flow format <file>

Forma de datos: Code: "FlowFormat", Data: { File, NodesTotal, EdgesTotal, NodesRepositioned, NodesResized, SubflowsTidied, VariableCount }.

Ver también

• uip maestro flow registry : descubrir tipos de nodos
• uip maestro flow validate — validar el .floweditado
• uip maestro flow init
• Descripción general del flujo