Box Scope

UiPath.Box.Activities.BoxScope

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

Para habilitar a autenticação, você pode criar um aplicativo Box personalizado 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 a autenticação OAuth. Para obter mais informações e antes de criar seu primeiro projeto de automação, consulte o Guia de configuração .

Depois de criar seu aplicativo personalizado, selecione o tipo de autenticação que deseja usar (Tipo de autenticação) e insira o local do seu arquivo de configuração (Config File Path) ou o conteúdo do arquivo (Config File Content) na atividade Box Scope se você estiver usando a autenticação JWT ou insira o (ID do cliente) e (Segredo do cliente) se estiver usando a autenticação OAuth.

Depois de estabelecer uma conexão, uma atividade de escopo de caixa pai pode gerar um registro da conexão em um objeto BoxClient (Box Connection) que você pode usar em atividades de escopo filho subsequentes.

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. Adicione a atividade Box Scope ao seu projeto.
3. Insira valores para as propriedades de Entrada e Autenticação JWT (se estiver usando JWT).
4. Crie e insira uma variável BoxClient para a propriedade Saída .

   • Você pode usar essa variável em usos subsequentes da atividade Box Scope .

     
     

     

     
     

Propriedades

Comum

• ContinueOnError - Especifica se você deseja que a atividade continue em execução quando um erro for lançado. Este campo suporta apenas valores Boolean .
• NomeDeExibição — o nome de exibição da atividade. Este campo é compatível apenas com variáveis Strings ou String.

Conexão Existente

• Box Connection - Um registro de conexão de uma atividade de Box Scope pai que você pode usar em vez de estabelecer uma nova conexão. Este campo suporta apenas BoxClient variáveis.
  • A variável BoxClient deve ser de uma atividade de escopo de caixa executada anteriormente (pai) que ainda tenha uma conexão ativa.
  • Se você não conseguir estabelecer uma conexão usando esta propriedade, tente executar novamente sua atividade principal do Box Scope .

Entrada

• AuthenticationType - O tipo de autenticação que você deseja usar para se conectar ao seu aplicativo personalizado. Selecione um dos três itens na lista suspensa:

  • JWT - Para especificar a autenticação JWT. Necessário para a primeira execução da atividade Box Scope (ou seja, escopo pai).
  • OAuth - Para especificar a autenticação OAuth. Necessário para a primeira execução da atividade Box Scope (ou seja, escopo pai).
  • BoxConnection - Opcional para execuções subsequentes da atividade Box Scope dentro do mesmo projeto de automação que inclui um escopo pai.

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 de configuração do Box.
• 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 de configuração do Box.
• User ID - O ID da conta de usuário que você deseja usar para autenticação. Este campo suporta apenas variáveis Strings ou String . Se deixado em branco, a autenticação é feita para a conta de serviço.

Diversos

• Privado - Se esta caixa de seleção estiver selecionada, os valores de variáveis e argumentos não são mais registrados no nível Verbose.

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 de configuração do Box.
• 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 de configuração do Box.

Saída

• Box Connection - Um registro de sua conexão estabelecida que você pode usar em outras atividades de Box Scope incluídas nesta atividade de escopo. Este campo suporta apenas BoxClient variáveis.
  Observação:

  Você pode passar essa variável para uma atividade de escopo em um fluxo de trabalho que esteja dentro da atividade de escopo pai.

  Por exemplo, você pode ter 3 fluxos de trabalho. A primeira inclui a atividade do 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 do escopo pai passa a variável BoxClient para a propriedade BoxConnection da conexão existente no segundo e terceiro fluxos de trabalho (consulte a imagem abaixo).