Déclarer une liaison de ressource

Déclarez une ressource Orchestrator ou Integration Service dans Bindings.json, vérifiez qu’il se résout lors d’une exécution locale et rendez-le remappable entre les locataires.

bindings.json est géré par la main: uipath init crée le fichier avec la structure requise lorsqu'il est absent et laisse un fichier existant inchangé. Déclarez une liaison pour chaque ressource de plate-forme que votre fonction atteint, afin que la ressource puisse être remappée lorsque le package s'exécute dans un autre locataire. Pour connaître le mécanisme de résolution sous-jacent, consultez Liaisons de ressources.

Prérequis

• Un projet de fonction Python créé avec uipath new.
• Une session authentifiée, établie avec uipath auth.
• La ressource existe déjà dans le locataire pour lequel vous développez.
• La UiPath CLI (uip) est installée pour la recherche de la connexion à l'étape 1.

Déclarer une liaison de connexion

1. Récupérez l'ID de connexion depuis Integration Service:

   uip is connections list uipath-microsoft-outlook365
   

2. Ouvrez bindings.json à la racine du projet.

3. Ajoutez une entrée au tableau resources en utilisant l'ID de connexion pour key et ConnectionId.defaultValue:

   {
     "resource": "connection",
     "key": "<connection-id>",
     "value": {
       "ConnectionId": {
         "defaultValue": "<connection-id>",
         "isExpression": false,
         "displayName": "Microsoft Outlook 365 Connection"
       },
       "Connector": {
         "defaultValue": "uipath-microsoft-outlook365",
         "isExpression": false,
         "displayName": "Connector"
       }
     },
     "metadata": {
       "Connector": "uipath-microsoft-outlook365",
       "UseConnectionService": "True",
       "BindingsVersion": "2.2"
     }
   }
   

4. Déclarez le même ID qu'une constante au niveau du module dans votre fonction et transmettez-le à l'appel SDK:

   OUTLOOK_CONNECTION_KEY = "<connection-id>"
   
   conn = sdk.connections.retrieve(OUTLOOK_CONNECTION_KEY)
   

5. Exécutez la fonction localement:

   uipath run main -f input.json
   

Résultat

Le journal d'exécution contient une ligne par liaison déclarée:

No resource overwrite matched for connection key='connection.<connection-id>' on retrieve

Cette ligne confirme que la recherche de remplacement a été exécutée et revient à l'ID de phase de conception, ce qui est le résultat attendu localement car aucun mappage de locataire n'existe. Si la ligne nomme un ID différent de celui de bindings.json, la constante du code et la liaison ne concordent pas.

Remarque :

La déclaration de liaisons pour les autres types de ressources suit le même modèle avec une forme value différente. Les ressources, les compartiments, les files d'attente, les processus, les applications et les index utilisent name et folderPath au lieu de ConnectionId, et leur key rejoint les deux avec un point.

Rendre la liaison remappable entre les locataires

1. Enregistrez le projet de fonction dans une solution:

   uip solution project add ./my-solution/my-function
   

2. Synchronisez la liste des ressources de la solution à partir des liaisons déclarées du projet:

   uip solution resource refresh
   

3. Examinez la liste des ressources obtenue:

   uip solution resource list --source local
   

Résultat

Chaque liaison déclarée apparaît dans la liste des ressources locales de la solution. Le déploiement mappe chaque entrée à une ressource dans le locataire cible, de sorte que le même package s'exécute sur la propre connexion de ce locataire. Pour compresser et publier la solution, voir uip solution pack.

Avertissement :

Une liaison qui n'est pas mappée dans le locataire cible n'échoue pas la tâche. L'appel revient à l'identifiant au moment de la conception; vérifiez donc que chaque liaison apparaît dans le mappage des ressources du locataire cible avant de promouvoir une solution.

Prochaines étapes

• Appeler une activité Integration Service - utilisez une connexion déclarée pour accéder à une opération de connecteur.
• Empaquetage et publication : déployez la fonction dans Orchestrator.