Criação de conexões para serviços em automações codificadas

Esta seção ajuda você a criar conexões necessárias para acessar APIs de serviços que usam conexões, como GSuite.Activities e Excel.Activities dentro de automações codificadas.

Comece criando uma conexão no Integration Service. As conexões podem ser acessadas dentro da mesma organização e do tenant de seu projeto de automação codificado. Dentro da automação codificada, use o objeto connections para acessar as conexões criadas anteriormente no Integration Service e, em seguida, acessar as APIs correspondentes.

Depois de concluir a automação e publicá-la no Orchestrator, você pode substituir as configurações de conexão originais configuradas no código, se necessário.

Pré-requisitos

Crie uma conexão no Integration Service:

1. Acesse o Integration Service e selecione o tenant ao qual seu Studio está conectado.
2. Navegue até Conexões.
3. Selecione Adicionar conexão e crie uma conexão para um dos seguintes aplicativos:
   • Google Drive
   • Gmail
   • Planilhas Google
   • Microsoft Office 365

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 + Space 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:

   • G Drive
   • Gmail
   • Planilhas Google
   • Excel
   • OneDrive
   • O365Mail
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

   Recomendamos que você crie suas conexões em uma etapa para evitar possíveis erros. Recomendamos também que você crie 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 de 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. Após estabelecer o connection, você pode acessar as APIs relevantes, específicas de um serviço por meio desse connection.
   Por exemplo, se você tiver configurado uma conexão do Gmail da seguinte maneira: var myGmailConnection = connections.Gmail.My_Workspace_john_doe_gmail.com, você pode usar a API do serviço usando myGmailConnection.

Substituição da conexão no Orchestrator

1. Publique seu projeto no Orchestrator.
2. Acesse o feed do Orchestrator no qual 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 do pacote, localize e selecione o tipo de conexão correspondente para sua automação codificada.

   Tenha o cuidado de 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.

Limitação conhecida

A conexão padrão de uma biblioteca exportada funcionará em outros projetos, apenas se o projeto importado estiver no mesmo tenant que o projeto da biblioteca de origem.