Liaisons et ressources de runtime

Liaisons dans les applications codées, couvrant la façon dont les ressources UiPath sont déclarées dans Bins_v2.json et enregistrées par Studio Web sur push.

Une application codée est rarement autonome - elle fait généralement appel à des ressources Orchestrator telles que les ressources, les compartiments de stockage, les files d'attente, les connexions ou d'autres projets d'automatisation. Studio Web utilise un fichier bindings_v2.json, fourni avec la source de votre application, pour déclarer, résoudre et remplacer ces références au moment du déploiement.

Quelles sont les liaisons

Une liaison est une référence logique de votre application codée à une ressource UiPath. Il comporte deux parties:

• Une déclaration à l'intérieur de bindings_v2.json, à la racine de ce que vous donnez. Chaque entrée nomme une ressource, son type et une valeur par défaut.
• Une solution concrète à une entité Orchestrator — dossier, ressource, compartiment, file d'attente, connexion ou processus — décidée au moment du déploiement par la configuration de l'environnement de la solution.

Étant donné que les déclarations dans bindings_v2.json sont stables, la même application codée peut être déployée au niveau du développement, de l'organisation et de la production sans modifications de code.

Déclaration des liaisons dans bindings_v2.json

Un fichier bindings_v2.json à la racine de ce que vous transmettez déclare les liaisons. Il suit un schéma versionné avec un tableau resources de niveau supérieur; chaque entrée décrit une liaison.

Exemple :

{
  "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"
      }
    }
  ]
}

Champs par ressource

Champ	Objectif
activityDisplayName	Libellé lisible par un humain affiché dans le panneau Ressources de Studio Web.
activityId	Identificateur stable que le SDK utilise pour rechercher la liaison au moment du runtime.
resource	Type de ressource: asset, bucket, queue, connection, process, etc.
key	La clé ou le nom logique de la ressource dans l'application.
id	Un identifiant composé utilisé par Studio Web pour conserver et différencier les liaisons entre les « push ».
value.name.defaultValue	Le nom de l’entité Orchestrator par défaut vers lequel résoudre avant que les remplacements d’environnement ne soient appliqués.
value.name.isExpression	true si defaultValue est une expression à évaluer, false pour un littéral.
metadata.BindingsVersion	Version du schéma par ressource.

Enregistrement des liaisons en mode push

Tous les uip codedapp push lit bindings_v2.json. Studio Web charge le fichier à partir du contenu transmis et enregistre chaque entrée du tableau resources sous le panneau Ressources du projet. Les liaisons existantes dont le paramètre id est inchangé conservent leurs mappages d'environnement; les nouvelles entrées apparaissent non mappées jusqu'à ce que vous les mappiez.

Si bindings_v2.json est absent de ce que vous appuyez, le projet n'a pas de liaison et le panneau Ressources est vide.

Une fois la transmission terminée, la vue du projet dans Studio Web confirme la synchronisation et répertorie chaque type de ressource enregistré:

Mappage des liaisons aux ressources Orchestrator

Pour chaque liaison enregistrée, vous (ou la configuration de l'environnement de la solution) sélectionnez une ressource Orchestrator correspondante — par exemple, mapper une liaison Get Asset à une ressource d'informations d'identification spécifique dans un dossier choisi.

Le mappage est stocké dans le cadre de la configuration de l’environnement de la solution, et non à l’intérieur de la source transmise. C'est ainsi qu'un package d'application codée est promu en toute sécurité à travers le développement, l'organisation et la production - chaque environnement fournit ses propres résolutions.

Pour la gestion des environnements, consultez À propos des solutions.

Meilleures pratiques

• Un activityDisplayName doit révéler l'intention (Get Payment API Key, non Get Asset) et apparaît dans le panneau Ressources et dans chaque mappage d'environnement.
• Une activityId devrait rester stable entre les push. Studio Web s'appuie sur ce paramètre (combiné à id) pour différencier et conserver les mappages d'environnement entre les push.
• Il est facile de maintenir un bindings_v2.json minimum: chaque entrée devient une exigence de résolution dans tous les environnements dans lesquels l'application est déployée.
• bindings_v2.json est le code source et doit exister dans Git avec le reste de l'application.