Uso de variáveis no Construtor do Conector

Muitos aplicativos de terceiros aos quais o UiPath® pode se conectar exigem algum tipo de configuração dinâmica, especificamente ao criar o conector para um público mais amplo. A URL base pode exigir um parâmetro da organização, cada chamada de API pode exigir uma entrada que foi retornada na autenticação etc.

Como há várias maneiras de resolver esse problema, a mais fácil é usar variáveis como {organizationId} ou responseKey para esses tipos de processos.

Esta página descreve as áreas do Connector Builder onde você pode adicionar essas variáveis e como fazer isso.

Observação: a notação de variáveis usada no Connector Builder são apenas strings usando chaves, ou seja, {myVariable}.

URL base

A URL Base é a URL usada por padrão para qualquer solicitação HTTP. Em muitos casos, essa URL é estática em relação ao aplicativo de terceiros e, dessa forma, o uso de variáveis fica fora do escopo. Alguns fornecedores exigem que enderece todas as chamadas de API para sua instância específica de seu aplicativo ou adicione algum tipo de identificador no caminho base identificando sua identidade.

Vamos usar o exemplo de conexão com sua instância do UiPath Orchestrator, que requer detalhes de organização e tenant na URL base. Ele será usado posteriormente como o caminho básico para qualquer solicitação futura. Quando os usuários importam esse conector para seu tenant e criam uma conexão, você pode solicitar essa informação adicionando esses parâmetros como variáveis e solicitando-os na tela de autenticação.

Para fazer isso, comece adicionando as variáveis no URL base com a notação {organization} e {tenant} .

Autenticação

Na configuração da autenticação, os detalhes estão localizados dentro da tabela que lista todos os parâmetros, desconsiderando o tipo de autenticação. A tabela fornece uma Edição rápida em linha ou uma tela mais avançada usando o menu Mais opções .

No exemplo da API do Orchestrator, queremos adicionar dois parâmetros extras à tabela, porque exigimos que o usuário que está criando uma conexão forneça a entrada para {organization} e {tenant}.

Ao adicionar um novo parâmetro de autenticação, você deve definir o Nome (como você deseja que o campo específico seja exibido na tela de conexão), seu Valor (que você pode deixar em branco) e o campo Perguntar ao usuário , se você quiser que o seja exigido durante a autenticação.

Para definir uma variável para um parâmetro, selecione o menu Mais opções .

Neste exemplo, o parâmetro Nome da organização , que é solicitado ao usuário (Perguntar ao usuário está definido como Sim), é enviado ao provedor como organização (nome) e caminho (tipo).

A mesma coisa é feita para o tenant. Então, na tela de autenticação, os campos Nome da organização e Nome do tenant são obrigatórios, e a organização e o tenant fazem parte da URL base.

Envio de solicitações

O uso de variáveis em seus recursos funciona de maneira muito semelhante. E após importar arquivos swagger, isso já pode estar visível em recursos que são GETBYID , que levam em um {id} , que também é representado na seção de parâmetros.

Para o Orchestrator, o exemplo a seguir usa essa variável para {key}.