Box Scope

UiPath.Box.Activities.BoxScope

As atividades Box usam a autenticação JWT para estabelecer uma conexão entre a UiPath e seu Box Custom App. Essa conexão autoriza um Robot a chamar as APIs Box e acessar recursos em seu nome.

Para habilitar a autenticação, você pode criar um aplicativo Box Custom com autenticação JWT. Após criar seu aplicativo, o Box gera um arquivo de configuração que contém as informações necessárias para estabelecer uma conexão autenticada. Você também pode optar por criar um aplicativo Box personalizado com autenticação OAuth. Para obter mais informações e antes de criar seu primeiro projeto de automação, consulte o guia de Configuração .

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.

Como funciona

As etapas a seguir e o diagrama de sequência de mensagens são um exemplo de como a atividade funciona desde o tempo de design (ou seja, as dependências da atividade e as propriedades de entrada/saída) até o tempo de execução.

1. Conclua as etapas de Configuração .
2. Add the Box Scope activity to your project.
3. Insira valores para as propriedades Entrada e Autenticação JWT (se estiver usando JWT).
4. Crie e insira BoxClient variável para a propriedade Saída .

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

     

Propriedades

Comum

• ContinueOnError - Specifies if you want the activity to continue running when an error is thrown. This field supports only Boolean values.
• DisplayName - The display name of the activity. This field supports only Strings or String variables.

Conexão Existente

• 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.

Entrada

• 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.

Autenticação JWT

• Conteúdo do arquivo de configuração - O conteúdo do arquivo de configuração JSON em um objeto String . Este campo é compatível apenas com variáveis Strings ou String . Para obter mais informações sobre o arquivo de configuração, consulte o guia Box Setup .
• Caminho do arquivo de configuração - O local do arquivo de configuração baixado. Este campo é compatível apenas com variáveis Strings ou String . Para obter mais informações sobre o arquivo de configuração, consulte o guia 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.

Diversos

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

Autenticação OAuth 2

• ID do Cliente - IDDoCliente do aplicativo Box. Este campo é compatível apenas com variáveis Strings ou String . Para obter mais informações sobre o arquivo de configuração, consulte o guia Box Setup .
• Segredo do cliente - O segredo do cliente do aplicativo Box. Insira uma variável SecureString ou SecureString . Para obter mais informações sobre o arquivo de configuração, consulte o guia Box Setup .

Saída

• 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.

  Observação:

  Você pode passar essa variável para uma atividade de escopo em um fluxo de trabalho que seja de dentro da atividade do escopo pai. Por exemplo, você pode ter três fluxos de trabalho. A primeira inclui a atividade de escopo pai que estabelece a conexão com seu aplicativo registrado (ou seja, fluxo de trabalho pai). O segundo fluxo de trabalho cria um novo registro de contato e o terceiro cria um novo registro de conta; ambos estão incluídos na atividade do escopo pai. Quando os fluxos de trabalho são executados, a atividade de escopo pai passa a variável BoxClient para a propriedade BoxConnection da conexão existente no segundo e terceiro fluxos de trabalho (veja a imagem abaixo).