Conexões

Esta seção ajuda você a configurar conexões necessárias para acessar APIs de automação codificadas a partir de serviços que usam conexões.

Para configurar essa conexão, você começa criando uma conexão no Integration Service. As conexões que você cria no Integration Service são acessíveis dentro da mesma organização e tenant que sua automação codificada onde você está trabalhando. Você pode usar o objeto connections para acessar as conexões que você criou anteriormente no Integration Service e, em seguida, acessar as APIs de automação codificadas correspondentes.

Depois de concluir a automação e publicá-la no Orchestrator, você tem a opção de substituir as configurações de conexão iniciais que você realizou no código.

Pré-requisitos

Crie uma conexão no Integration Service:

1. Vá para Integration Service e navegue até Conexões.
2. Selecione Adicionar conexão e crie uma conexão para um dos seguintes aplicativos:
   • Google Drive
   • Gmail
   • Google Sheets

Etapas

1. Abra uma automação codificada existente da mesma organização e tenant onde você criou inicialmente sua conexão.

2. Dentro do corpo Execute() , digite connections e pressione Ctrl + Espaço para ver as conexões disponíveis.

   Dependendo do aplicativo para o qual você criou anteriormente o connection, você pode escolher entre os seguintes tipos de conexão:

   • Drive
   • Gmail
   • GoogleSheets

3. Configure sua conexão ainda mais adicionando a pasta e o nome da subpasta do Orchestrator e o endereço de conexão específico que você deseja. Use sublinhados para separar essas informações.

   Por exemplo, uma conexão do Gmail para a pasta My Workspace e subpasta My Gmail Worskapce no Orchestrator e para o endereço [e-mail] seriam escritos em código como: connections.Gmail.My_Workspace_My_Gmail_Workspace_john_doe_gmail_com.

Recomendação

É recomendável criar suas conexões em uma etapa para evitar possíveis erros. Também é recomendável criar uma variável para a conexão. Dessa forma, se ocorrerem alterações no Integration Service, você evitará atualizar todas as instâncias da conexão ao longo da sua automação. Use a seguinte abordagem:

var myGmailConnection = connections.Gmail.My_Workspace_My_Gmail_Workspace_john_doe_gmail_com;

Evite criar suas conexões em duas etapas separadas, como:

var myGmailConnection = connections.Gmail;
myGmailConnection.My_Workspace_My_Gmail_Workspace_john_doe_gmail_com;

4. Depois de ter estabelecido o connection, você pode acessar as APIs de automação codificadas relevantes específicas para um serviço por meio desse connection.

   Por exemplo, se você tiver configurado uma conexão do Gmail da seguinte forma: var myGmailConnection = connections.Gmail.My_Workspace_john_doe_gmail.com, você pode usar a API de automação codificada do serviço usando myGmailConnection.

Substituição da conexão no Orchestrator

1. Publique seu projeto no Orchestrator.
2. Acesse o feed do Orchestrator onde você publicou o projeto.
3. Acesse o processo publicado e selecione Editar.
4. Na Configuração do processo, escolha a automação codificada que contém sua conexão configurada como o ponto de entrada.
5. Em Requisitos de pacote, encontre e selecione o tipo de conexão correspondente para sua automação codificada. Tenha cuidado ao selecionar o tipo de conexão para sua automação codificada, pois as conexões para arquivos XAML dentro do seu projeto também aparecem na lista.
6. Identifique e selecione o endereço da conta que você planeja associar à conexão quando ela for executada.