Bindungen und Runtime-Ressourcen

Bindungen in codierten Apps, die abdecken, wie UiPath-Ressourcen inBindings_v2.json deklariert und von Studio Web bei Push registriert werden.

Eine codierte App ist selten eigenständig – sie ruft in der Regel Orchestrator-Ressourcen wie Assets, Speicher-Buckets, Warteschlangen, Verbindungen oder andere Automatisierungsprojekte auf. Studio Web verwendet eine bindings_v2.json -Datei, die mit der Quelle Ihrer App ausgeliefert wird, um diese Verweise zum Zeitpunkt der Bereitstellung zu deklarieren, aufzulösen und zu überschreiben.

Welche Bindungen sind

Eine Bindung ist ein logischer Verweis von Ihrer codierten App auf eine UiPath-Ressource. Er besteht aus zwei Teilen:

• Eine Deklaration in bindings_v2.json, am Stammort dessen, was Sie pushen. Jeder Eintrag benennt eine Ressource, deren Typ und einen Standardwert.
• Eine konkrete Lösung für eine Orchestrator-Entität – Ordner, Asset, Bucket, Warteschlange, Verbindung oder Prozess – die zum Zeitpunkt der Bereitstellung durch die Umgebungskonfiguration der Lösung festgelegt wurde.

Da die Deklarationen in bindings_v2.json stabil sind, kann dieselbe codierte App ohne Codeänderungen für die Entwicklung, das Staging und die Produktion bereitgestellt werden.

Bindungen in werden deklariert bindings_v2.json

Eine bindings_v2.json -Datei im Stammverzeichnis dessen, was Sie pushen, deklariert die Bindungen. Es folgt einem versionierten Schema mit einem resources -Array der obersten Ebene; Jeder Eintrag beschreibt eine Bindung.

Beispiel:

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

Felder pro Ressource

Feld	Zweck
activityDisplayName	Für Menschen lesbare Bezeichnung, die im Bereich „Ressourcen “ von Studio Web angezeigt wird.
activityId	Stabiler Bezeichner, den das SDK verwendet, um die Bindung zur Runtime nachzuschlagen.
resource	Ressourcentyp: asset, bucket, queue, connection, process usw.
key	Der Schlüssel oder logische Name der Ressource innerhalb der App.
id	Ein zusammengesetzter Bezeichner, der von Studio Web verwendet wird, um Bindungen zwischen Pushs beizubehalten und zu unterscheiden.
value.name.defaultValue	Der Standardname der Orchestrator-Entität, in den aufgelöst werden soll, bevor Umgebungsüberschreibungen angewendet werden.
value.name.isExpression	true Wenn defaultValue ein auszuwertender Ausdruck ist, false für einen Literal.
metadata.BindingsVersion	Schemaversion pro Ressource.

Registrieren von Bindungen beim Pushen

Jedes uip codedapp push liest bindings_v2.json erneut. Studio Web lädt die Datei aus dem verschobenen Inhalt und registriert jeden Eintrag aus dem resources -Array im Bereich Ressourcen des Projekts. Vorhandene Bindungen, deren id unverändert ist, behalten ihre Umgebungszuordnungen bei; werden neue Einträge ohne Zuordnung angezeigt, bis Sie sie zuordnen.

Wenn bindings_v2.json in dem, was Sie pushen, fehlt, hat das Projekt keine Bindungen und der Panel Ressourcen ist leer.

Sobald der Push abgeschlossen ist, bestätigt die Projektansicht in Studio Web die Synchronisierung und listet jeden registrierten Ressourcentyp auf:

Zuordnung von Bindungen zu Orchestrator-Ressourcen

Für jede registrierte Bindung wählen Sie (oder die Umgebungskonfiguration der Lösung) eine passende Orchestrator-Ressource aus – z. B. die Zuordnung einer Get Asset -Bindung zu einem bestimmten Anmeldeinformations-Asset in einem ausgewählten Ordner.

Die Zuordnung wird als Teil der Umgebungskonfiguration der Lösung gespeichert, nicht innerhalb der gepushten Quelle. So wird ein einzelnes codiertes App-Paket sicher über Entwicklung, Staging und Produktion hinweg ermöglicht – jede Umgebung bietet ihre eigenen Lösungen.

Informationen zum Verwalten von Umgebungen finden Sie unter Über Lösungen.

Best Practices

• Ein activityDisplayName sollte die Absicht offenlegen (Get Payment API Key, nicht Get Asset) – es erscheint im Bereich Ressourcen und in jeder Umgebungszuordnung.
• Ein activityId muss über Pushs hinweg stabil bleiben. Studio Web stützt sich darauf (in Kombination mit id), um Umgebungszuordnungen zwischen Pushs zu unterscheiden und beizubehalten.
• Ein minimaler bindings_v2.json ist einfacher beizubehalten: Jeder Eintrag wird zu einer Lösungsanforderung in jeder Umgebung, in der die App bereitgestellt wird.
• bindings_v2.json ist Quellcode und sollte neben dem Rest der App in Git verfügbar sein.