Vinculaciones y recursos de runtime

Vinculaciones en aplicaciones codificadas, que cubren cómo se declaran los recursos de UiPath en vinculantes_v2.json y cómo Studio Web los registra al enviarlos.

Una aplicación codificada rara vez es autónoma: normalmente llama a recursos de Orchestrator como activos, depósitos de almacenamiento, colas, conexiones u otros proyectos de automatización. Studio Web utiliza un archivo bindings_v2.json, enviado con el origen de tu aplicación, para declarar, resolver y anular esas referencias en el momento de la implementación.

Qué son las vinculaciones

Una vinculación es una referencia lógica de tu aplicación codificada a un recurso de UiPath. Tiene dos partes:

• Una declaración dentro de bindings_v2.json, en la raíz de lo que insertas. Cada entrada nombra un recurso, su tipo y un valor predeterminado.
• Una resolución concreta para una entidad de Orchestrator (carpeta, activo, depósito, cola, conexión o proceso) que se decide en el momento de la implementación por la configuración del entorno de la solución.

Debido a que las declaraciones en bindings_v2.json son estables, la misma aplicación codificada puede implementarse en desarrollo, preparación y producción sin cambios de código.

Declarar vinculaciones en bindings_v2.json

Un archivo bindings_v2.json en la raíz de lo que insertas declara las vinculaciones. Sigue un esquema versionado con una matriz resources de nivel superior; cada entrada describe una vinculación.

Ejemplo:

{
  "version": "2.0",
  "resources": [
    {
      "activityDisplayName": "Get Asset",
      "activityId": "GetRobotAsset_1",
      "resource": "asset",
      "key": "Asset",
      "id": "assetAssetAssetFalse",
      "value": {
        "name": {
          "defaultValue": "Asset",
          "isExpression": false
        }
      },
      "metadata": {
        "BindingsVersion": "2.2"
      }
    },
    {
      "activityDisplayName": "Invoke Process",
      "activityId": "InvokeProcess_1",
      "resource": "process",
      "key": "Arghya-Queue-Query",
      "id": "processArghya-Queue-QueryArghya-Queue-QueryFalse",
      "value": {
        "name": {
          "defaultValue": "Arghya-Queue-Query",
          "isExpression": false,
          "displayName": "Process name"
        }
      },
      "metadata": {
        "BindingsVersion": "2.2"
      }
    },
    {
      "activityDisplayName": "Add Queue Item",
      "activityId": "AddQueueItem_1",
      "resource": "queue",
      "key": "Arghya_query_queue",
      "id": "queueArghya_query_queueArghya_query_queueFalse",
      "value": {
        "name": {
          "defaultValue": "Arghya_query_queue",
          "isExpression": false
        }
      },
      "metadata": {
        "BindingsVersion": "2.2"
      }
    }
  ]
}

Campos por recurso

Campo	Propósito
activityDisplayName	Etiqueta legible por humanos que se muestra en el panel Recursos de Studio Web.
activityId	Identificador estable que el SDK utiliza para buscar la vinculación en runtime.
resource	Tipo de recurso: asset, bucket, queue, connection, process, etc.
key	La clave del recurso o el nombre lógico dentro de la aplicación.
id	Un identificador compuesto utilizado por Studio Web para persistir y diferenciar vinculaciones entre inserciones.
value.name.defaultValue	El nombre de entidad predeterminado de Orchestrator que se resolverá antes de que se apliquen las anulaciones de entorno.
value.name.isExpression	true si defaultValue es una expresión a evaluar, false para un literal.
metadata.BindingsVersion	Versión del esquema por recurso.

Registrar vinculaciones al enviar

Cada uip codedapp push vuelve a leer bindings_v2.json. Studio Web carga el archivo del contenido enviado y registra cada entrada de la matriz resources en el panel Recursos del proyecto. Los enlaces existentes cuyo id no se modifica conservan sus asignaciones de entorno; las nuevas entradas aparecen sin asignar hasta que las asignas.

Si bindings_v2.json está ausente de lo que envías, el proyecto no tiene vinculaciones y el panel Recursos está vacío.

Una vez que se completa la inserción, la vista del proyecto en Studio Web confirma la sincronización y enumera cada tipo de recurso registrado:

Asignación de vinculaciones a recursos de Orchestrator

Para cada enlace registrado, tú (o la configuración del entorno de la solución) seleccionas un recurso de Orchestrator coincidente; por ejemplo, asignar un enlace Get Asset a un activo de credenciales específico en una carpeta elegida.

La asignación se almacena como parte de la configuración del entorno de la solución, no dentro del origen enviado. Así es como un único paquete de aplicación codificado se promueve de forma segura en el desarrollo, la preparación y la producción: cada entorno proporciona sus propias resoluciones.

Para gestionar entornos, consulta Acerca de las soluciones.

Mejores prácticas

• Un activityDisplayName debe revelar la intención (Get Payment API Key, no Get Asset): aparece en el panel Recursos y en cada asignación de entorno.
• Un activityId debe permanecer estable en todas las inserciones. Studio Web se basa en él (combinado con id) para diferenciar y conservar las asignaciones de entorno entre inserciones.
• Un bindings_v2.json mínimo es más fácil de mantener: cada entrada se convierte en un requisito de resolución en cada entorno en el que se implementa la aplicación.
• bindings_v2.json es código fuente y debe vivir en Git junto con el resto de la aplicación.