ANVEDI POP3
Esta unidade de código de comunicação permite ler mensagens de correio eletrónico utilizando o protocolo POP3 através do serviço de troca de ficheiros.
Para utilizar este serviço, é necessária a versão 5.3.0.4 do Anvaigo EDI Connect e o File Exchange Service deve estar acessível.
Configuração
Para configurar o canal de comunicação, localize-o na EDI Communication Channel List e clique em “Configure”. Se acabou de criar o canal, poderá ter de atualizar a página primeiro.
General
Selecione ou crie uma nova instância do File Exchange Service. É necessário configurar o URL (pode ser copiado da configuração e é mostrado no arranque se o serviço for iniciado diretamente). O valor predefinido é http://localhost:7098 e é necessário definir a chave da API correspondente ao ficheiro de configuração. Pode utilizar o servidor para vários parceiros de comunicação.
Especifica como o File Exchange Server deve tratar os ficheiros duplicados. As duas opções são:
Os ficheiros com um nome que tenham sido importados anteriormente não serão importados novamente.
Os ficheiros com um nome que tenham sido importados anteriormente serão importados novamente.
Especifica o que fazer com os ficheiros após a importação para o Dynamics. As opções são:
Os ficheiros são deixados no caminho remoto tal como estão.
Os ficheiros são eliminados do caminho remoto.
Os ficheiros são movidos para o caminho do arquivo remoto.
Server
Especifica o endereço do servidor de correio eletrónico.
Especifica a porta do servidor de correio eletrónico.
Especifica o método de encriptação a utilizar. As opções disponíveis são:
A encriptação é negociada automaticamente entre o Serviço de Intercâmbio de Ficheiros e o anfitrião remoto. Esta é a definição por defeito.
Não é utilizada qualquer encriptação.
É estabelecida uma ligação encriptada.
É iniciada uma ligação não encriptada e é pedido ao servidor que continue a comunicação com encriptação.
Especifica a forma de autenticação no anfitrião remoto. As opções disponíveis são:
É utilizado um início de sessão anónimo.
É utilizada uma combinação de Nome de utilizador e Palavra-passe. Esta é a definição por defeito.
Utiliza o método Exchange OAuth2 para autenticação. Para mais pormenores, ver abaixo.
OAuth2
Caso pretenda utilizar o OAuth2 com o Exchange 365, terá de criar um novo “Registo de aplicações” no portal do Azure.
Aceda ao Portal do Azure, procure “Registo de aplicações” e crie uma nova. Chame-lhe, por exemplo, Anvaigo File Exchange Service. Pode deixar todas as outras definições com os valores predefinidos e clicar em “Registar”. (Pode saber mais sobre as regsitrações de aplicações aqui: https://learn.microsoft.com/en-us/azure/active-diretory/develop/quickstart-register-app)
Em seguida, tome nota do “ID da aplicação (cliente)” e do “ID do diretório (inquilino)”. Terá de introduzir estes valores nas definições de configuração do canal de comunicação.
Há uma definição que tem de ser alterada para os novos registos de aplicações: Selecione “Authentication” (Autenticação) no painel esquerdo e procure “Allow public client flows” (Permitir fluxos de clientes públicos). Esta opção tem de ser activada para permitir o início de sessão através do ID do dispositivo.
No Dynamics, certifique-se de que seleciona “Exchange OAuth2” como método de autorização. Selecione “DeviceCode” como o método OAuth e introduza o ID do inquilino e o ID do cliente do portal (pode ser diferente do ID do inquilino do Dynamics!).
Para iniciar sessão, clique em “Autenticar” na página de definições POP3. Obterá um URL e um DeviceID, que lhe permite iniciar sessão. Um token encriptado é armazenado no File Exchange Server e pode ser utilizado para obter os emails, até que o tempo de vida do token expire. Neste caso, a obtenção das mensagens falhará e terá de iniciar sessão novamente.
