Partilhar via


Exact Online Premium [DEPRECATED]

Conecte-se à sua conta Exact Online Premium e seja notificado quando entidades comerciais forem criadas ou atualizadas.

Atualmente, as entidades suportadas são Ordens de Venda, Projetos, Contas e Oportunidades.

Mais entidades e eventos serão adicionados no futuro.

Este conector está disponível nos seguintes produtos e regiões:

Serviço Class Regiões
Estúdio Copiloto Premium Todas as regiões do Power Automatic , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Aplicações Lógicas Standard Todas as regiões do Logic Apps , exceto as seguintes:
     - Regiões do Azure Government
     - Regiões do Azure China
     - Departamento de Defesa dos EUA (DoD)
Aplicações Power Premium Todas as regiões do Power Apps , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Automatize o poder Premium Todas as regiões do Power Automatic , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Contato
Nome Exato
URL https://www.exact.com
Metadados do conector
Editora Exata MKB Software BV
Sítio Web https://www.exact.com
Política de privacidade https://www.exact.com/trust/privacy/privacy-statement
Categorias Colaboração; Finanças

O conector Exact Online Premium para Power Automate permite receber notificações do Exact Online quando um registro de entidade comercial é alterado. Para determinadas entidades, pode ser criado um gatilho que responde a registros recém-criados ou modificados. Além disso, o conector pode executar algumas formatações personalizadas, reduzindo a complexidade para o usuário.

Pré-requisitos

Para usar o conector, é necessária uma assinatura Exact Online Premium.

Como obter credenciais

Este conector usa autorização OAuth na plataforma Exact Online. Inicie sessão com a sua conta pessoal Exact Online Premium.

Introdução ao conector

O conector fornece vários gatilhos para registros de entidades comerciais modificados ou recém-criados - neste momento para contas, oportunidades, projetos e ordens de venda. Inicie seu fluxo com um desses gatilhos.

  • Crie um novo fluxo no Power Automate e selecione um dos gatilhos como ponto de partida
    • Quando uma [entidade] é criada ou alterada
    • Você precisa escolher uma das empresas disponíveis no controle suspenso - o gatilho será criado apenas para esta empresa
  • Os eventos precisam ser ativados no Exact Online também, caso contrário, você não receberá nada no Power Automate
    • Vá para Visão Geral doFluxo de Dados>Mestres>: Fluxos e crie um novo fluxo ou modifique um existente
    • Selecione a Entidade e o Evento apropriados, por exemplo, Conta / Quando uma conta é modificada
    • Talvez seja necessário criar vários fluxos se quiser receber registros criados e modificados

Uma mensagem proveniente do Exact Online contém um campo chamado Payload com os dados do registro criado ou modificado. O conector tem uma ação Obter Valores que prepara esta carga para as suas necessidades.

  • Como o Tipo de Entidade, selecione a mesma entidade que o gatilho
  • Como Tipo de Valor, selecione o seguinte:
    • Novos Valores se você quiser selecionar campos específicos do novo estado (alterado) em outras ações
    • Valores antigos se você quiser ser capaz de selecionar campos específicos do estado antigo (inalterado) em outras ações
    • Tabela se você quiser obter o conteúdo como uma coleção inteira para uso em outras ações
    • Consulte a seção Exemplos abaixo para obter mais detalhes
  • O parâmetro Payload , por padrão, tem uma referência à propriedade Payload da mensagem de gatilho. Você não deve precisar mudar isso.
  • Os parâmetros adicionais Content-Type e Accept são, por padrão, definidos como application/json. Você não deve precisar mudar isso.

Examples

Exemplo 1: processar apenas ordens de venda de valor superior a 10.000 euros

  • Usar gatilho Quando uma ordem de venda é criada ou alterada
  • Adicionar uma ação Obter Valores com Entidade definida como Ordem de venda e Tipo de Valor definida como Novos valores
  • Usar um bloco de condição (ação interna de controle )
    • Defina a condição como AmountDC | inferior a | 10000
      • Nota, AmountDC é uma saída de valores Get
  • Na ramificação verdadeira do bloco de condições, adicione uma ação Encerrar (ação interna Control )

Exemplo 2: saída dos campos alterados para um e-mail

  • Use qualquer um dos gatilhos criados/alterados disponíveis
  • Adicionar uma ação Obter Valores com a mesma Entidade que o gatilho e Tipo de Valor definido como Tabela
  • Adicionar uma ação Filtro (ação interna Operação de Dados ) com a saída de Obter valores como entrada e como um conjunto de condições oldValue | Não igual a | novoValor
  • Adicione uma ação Criar Tabela HTML (ação interna Operação de Dados ) e use a saída da ação Filtrar
  • Criar uma ação do Outlook Enviar email e incluir a saída da ação Criar tabela HTML como parte da mensagem

Problemas conhecidos e limitações

Mensagem vazia para teste de conectividade

Ao configurar um novo fluxo, ou ao ativar um fluxo existente, uma mensagem é enviada para o Exact Online para registrar o fluxo. O Exact Online, por sua vez, envia uma mensagem de teste (sem conteúdo) para confirmar a conexão.

Se você não lidar com essa mensagem dentro do seu fluxo, o fluxo pode acabar em erro ou enviar notificações com conteúdo incompleto. Como geralmente é um comportamento pontual, você pode optar por aceitá-lo, mas pode receber avisos sobre fluxos de falha.

Uma maneira mais elegante de lidar com isso é testar se a mensagem está vazia em uma ação Condição . O teste empty(triggerOutputs()?['body']) | igual | é uma boa maneira de true fazer isso. Na ramificação verdadeira , adicione uma ação Encerrar com o resultado Bem-sucedido. Em seguida, continue o fluxo real após a ação Condição.

Erros e soluções comuns

Até à data, não foram detetados erros.

FAQ

O que faz exatamente a ação Obter Valores?

Obter Valores executa algumas ações que, de outra forma, exigiriam várias ações mais complexas em seu fluxo. Pela ordem, são eles:

  • Ele pega o Payload campo do gatilho e converte seu texto em um objeto JSON. Isto é equivalente à json(...) função;
  • Ele carrega um esquema para esse objeto JSON para que suas propriedades possam ser referenciadas em ações futuras. Você poderia fazer isso com a ação Parse JSON , mas você mesmo precisaria fornecer todo o esquema;
  • Ele pode converter a carga de entrada em uma tabela completa com todos os dados ou em um objeto mostrando o estado antigo ou novo da entidade. Este último é relativamente complexo de alcançar em um fluxo.

Qual deve ser o valor da carga útil na ação Obter valores?

Por padrão, isso é definido como triggerOutputs()?['body/Content/Payload'] a referência ao campo Carga recebida no gatilho. Você não deve precisar mudar isso.

Por que preciso fornecer o tipo de entidade para Obter valores?

A ação Obter Valores usa uma técnica chamada geração de esquema dinâmico, que nos permite selecionar as propriedades da entidade escolhida em ações futuras. Esta é uma característica do designer de fluxo. Infelizmente, em tempo de design, o gatilho não pode passar o tipo de entidade selecionado para outras ações. Portanto, o tipo de entidade precisa ser selecionado novamente.

O que acontece se eu selecionar o tipo de entidade errado para Obter valores?

O designer de fluxo mostrará as propriedades erradas para a entidade recebida, por exemplo, propriedades do projeto em uma ordem de venda. Isso significa que algumas propriedades que fazem parte da entidade não são mostradas e algumas propriedades que são mostradas não são realmente parte da entidade.

Você ainda pode acessar as propriedades se elas existirem na entidade, mas terá que inserir a referência manualmente.

Escolher um imóvel inexistente em outra ação resultará simplesmente em um valor vazio; As consequências disso dependerão da ação.

Limites de Limitação

Name Chamadas Período de Renovação
Chamadas de API por conexão 100 60 segundos

Ações

Obter valores [DEPRECATED]

Isso carrega os valores do campo Carga útil do gatilho em um formato de escolha.

Obter valores [DEPRECATED]

Isso carrega os valores do campo Carga útil do gatilho em um formato de escolha.

Parâmetros

Name Chave Necessário Tipo Description
Cabeçalho Content-Type
Content-Type string

Especifique o tipo de conteúdo da carga útil.

Aceitar cabeçalho
Accept string

Especifique o formato de resposta aceito.

Tipo de Entidade
EntityType True string

Selecione o tipo de entidade comercial para esta operação.

Tipo de valor
ValueType True string

Selecione o tipo de valor para esta operação.

Carga útil
body string

Adicionar referência ao campo Carga útil aqui

Devoluções

As saídas desta operação são dinâmicas.

Acionadores

Quando um projeto é criado ou alterado [DEPRECATED]

Isso se inscreve para criar ou alterar eventos para projetos.

Quando uma conta é criada ou alterada [DEPRECATED]

Isso se inscreve para criar ou alterar eventos para contas.

Quando uma oportunidade é criada ou alterada [DEPRECATED]

Isso se inscreve para criar ou alterar eventos para oportunidades.

Quando uma ordem de venda é criada ou alterada [DEPRECATED]

Isso se inscreve para criar ou alterar eventos para ordens de venda.

Quando um projeto é criado ou alterado [DEPRECATED]

Isso se inscreve para criar ou alterar eventos para projetos.

Parâmetros

Name Chave Necessário Tipo Description
Empresa
Company True string

Selecione a empresa para a qual deseja receber os eventos.

Devoluções

Quando uma conta é criada ou alterada [DEPRECATED]

Isso se inscreve para criar ou alterar eventos para contas.

Parâmetros

Name Chave Necessário Tipo Description
Empresa
Company True string

Selecione a empresa para a qual deseja receber os eventos.

Devoluções

Quando uma oportunidade é criada ou alterada [DEPRECATED]

Isso se inscreve para criar ou alterar eventos para oportunidades.

Parâmetros

Name Chave Necessário Tipo Description
Empresa
Company True string

Selecione a empresa para a qual deseja receber os eventos.

Devoluções

Quando uma ordem de venda é criada ou alterada [DEPRECATED]

Isso se inscreve para criar ou alterar eventos para ordens de venda.

Parâmetros

Name Chave Necessário Tipo Description
Empresa
Company True string

Selecione a empresa para a qual deseja receber os eventos.

Devoluções

Definições

guidText

EntityChangedEvent

Name Caminho Tipo Description
Content
Content ChangeEventContent
HashCode
HashCode string

ChangeEventContent

Name Caminho Tipo Description
Tópico
Topic string
ID do Cliente
ClientId guidText
Empresa
Division integer

Empresa

Ação
Action string
Key
Key guidText
ExactOnlineEndpoint
ExactOnlineEndpoint string
EventCreatedOn
EventCreatedOn string
Carga útil
Payload string