Conexões

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

Para configurar essa conexão, comece 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ê estiver 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 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 o Integration Service e navegue até Conexões.
2. Selecione Adicionar conexão e crie uma conexão para um dos seguintes aplicativos:
   • Microsoft OneDrive & SharePoint
   • Microsoft Outlook 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 + 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:
   • Office365
3. Configure sua conexão ainda mais adicionando o nome da pasta do Orchestrator e o endereço de conexão desejado, separados por sublinhados.
   Por exemplo, uma conexão do OneDrive para a pasta My Workspace no Orchestrator, e para o endereço [e-mail] seria escrita em código como: connections.OneDrive.My_Workspace_john_doe_company_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 myOneDriveConnection = connections.OneDrive.My_Workspace_john_doe_company_com;

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

   var myOneDriveConnection = connections.OneDrive;
   conn.My_Workspace_john_doe_company_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 OneDrive da seguinte maneira: var myOneDriveConnection = connections.OneDrive.My_Workspace_john_doe_company.com, você pode usar a API do serviço usando myOneDriveConnection.

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.