Box Scope

UiPath.Box.Activities.BoxScope

Die Box-Aktivitäten verwenden die JWT-Authentifizierung , um eine Verbindung zwischen UiPath und Ihrer benutzerdefinierten Box-App herzustellen. Diese Verbindung autorisiert einen Roboter, die Box-APIs aufzurufen und in Ihrem Namen auf Ressourcen zuzugreifen.

Um die Authentifizierung zu aktivieren, können Sie eine benutzerdefinierte Box-App mit JWT-Authentifizierung erstellen. Nach dem Erstellen Ihrer Anwendung generiert Box eine Konfigurationsdatei, die die erforderlichen Informationen zum Aufbau einer authentifizierten Verbindung enthält. Sie können auch eine benutzerdefinierte Box-App mit OAuth-Authentifizierung erstellen. Weitere Informationen und bevor Sie Ihr erstes Automatisierungsprojekt erstellen finden Sie in der Einrichtungsanleitung .

After creating your Custom App, you select the type of authentication that you want to use (Authentication Type) and enter the location of your configuration file (Config File Path) or the contents of the file (Config File Content) into the Box Scope activity if you are using JWT authentication or enter the (Client ID) and (Client Secret) if you are using OAuth Authentication.

After establishing a connection, a parent Box Scope activity can output a record of the connection in a BoxClient object (Box Connection) that you can use in subsequent child scope activities.

Wie es funktioniert

Die folgenden Schritte und das folgende Nachrichtensequenzdiagramm sind ein Beispiel dafür, wie die Aktivität von der Entwurfszeit (d. h. den Aktivitätsabhängigkeiten und Eingabe-/Ausgabeeigenschaften) bis zur Laufzeit funktioniert.

1. Schließen Sie die Einrichtungsschritte ab.
2. Add the Box Scope activity to your project.
3. Geben Sie Werte für die Eigenschaften Eingabe und JWT-Authentifizierung ein (wenn Sie JWT verwenden).
4. Erstellen und geben Sie eine BoxClient -Variable für die Output- Eigenschaft ein.

   • You can use this variable in subsequent uses of the Box Scope activity.

     

Eigenschaften

Allgemein

• ContinueOnError - Specifies if you want the activity to continue running when an error is thrown. This field supports only Boolean values.
• AnzeigeName (DisplayName) - Der Anzeigename der Aktivität. Dieses Feld unterstützt nur Strings oder String-Variablen.

Bestehende Verbindung (Existing Connection)

• Box Connection - A connection record from a parent Box Scope activity that you can use instead of establishing a new connection. This field supports only BoxClient variables.
  • The BoxClient variable must be from a previously run Box Scope activity (parent) that still has an active connection.
  • If you're unable to establish a connection using this property, try re-running your parent Box Scope activity.

Eingabe

• AuthenticationType - The type of authentication that you want to use to connect to your Custom App. Select one of the three items from the drop-down list:
  • JWT - To specify JWT Authentication. Required for the first run of the Box Scope activity (i.e., parent scope).
  • OAuth - To specify OAuth authentication. Required for the first run of the Box Scope activity (i.e., parent scope).
  • BoxConnection - Optional for subsequent runs of the Box Scope activity within the same automation project that includes a parent scope.

JWT-Authentifizierung

• Konfigurationsdateiinhalt – Der Inhalt der JSON-Konfigurationsdatei in einem String -Objekt. Dieses Feld unterstützt nur Strings oder String -Variablen. Weitere Informationen zur Konfigurationsdatei finden Sie in der Anleitung für das Box -Setup .
• Konfigurationsdateipfad – Der Speicherort der heruntergeladenen Konfigurationsdatei. Dieses Feld unterstützt nur Strings oder String -Variablen. Weitere Informationen zur Konfigurationsdatei finden Sie in der Anleitung für das Box -Setup .
• User ID - The ID of the user account that you want to use for authentication. This field supports only Strings or String variables. If left empty, authentication is done for the service account.

Sonstiges

• Private - If this checkbox is selected, the values of variables and arguments are no longer logged at Verbose level.

OAuth 2-Authentifizierung

• ClientID – ClientID der Box-Anwendung. Dieses Feld unterstützt nur Strings oder String -Variablen. Weitere Informationen zur Konfigurationsdatei finden Sie in der Anleitung für das Box -Setup .
• ClientGeheimnis – Der geheime Clientschlüssel der Box-Anwendung. Geben Sie eine Variable SecureString oder SecureString ein. Weitere Informationen zur Konfigurationsdatei finden Sie in der Anleitung für das Box -Setup .

Ausgabe

• Box Connection - A record of your established connection that you can use in other Box Scope activities that are included in this scope activity. This field supports only BoxClient variables.

  Hinweis:

  Sie können diese Variable an eine Scope-Aktivität in einem Workflow übergeben, der sich innerhalb der übergeordneten Scope-Aktivität befindet. Zum Beispiel können Sie 3 Workflows haben. Die erste enthält die übergeordnete Scope-Aktivität, die die Verbindung zu Ihrer registrierten Anwendung (d. h. übergeordneter Workflow) herstellt. Der zweite Workflow erstellt einen neuen Kontaktdatensatz und der dritte erstellt einen neuen Kontodatensatz; Beide sind in der übergeordneten Scope-Aktivität enthalten. Wenn die Workflows ausgeführt werden, übergibt die übergeordnete Scope-Aktivität die Variable BoxClient an die vorhandene Verbindungseigenschaft BoxConnection im zweiten und dritten Workflow (siehe Abbildung unten).