Compartilhar via


Exact Online Premium [PRETERIDO]

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

As entidades com suporte atualmente são Pedidos de Vendas, Projetos, Contas e Oportunidades.

Mais entidades e eventos serão adicionados no futuro.

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

Service Class Regions
Copilot Studio Premium Todas as regiões do Power Automate , exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Aplicativos Lógicos Standard Todas as regiões dos Aplicativos Lógicos , exceto as seguintes:
     – Regiões do Azure Governamental
     - Regiões do Azure China
     - Departamento de Defesa dos EUA (DoD)
Power Apps Premium Todas as regiões do Power Apps , exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Power Automate Premium Todas as regiões do Power Automate , exceto as seguintes:
     – Governo dos EUA (GCC)
     – Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Contato
Nome Exacto
URL https://www.exact.com
Metadados do conector
Publicador BV de software MKB exato
Site https://www.exact.com
Política de privacidade https://www.exact.com/trust/privacy/privacy-statement
Categorias Colaboração; Financiar

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

Pré-requisitos

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

Como obter credenciais

Esse conector usa a autorização OAuth na plataforma Exact Online. Faça logon com sua conta pessoal do Exact Online Premium.

Introdução ao conector

O conector fornece vários gatilhos para registros de entidade de negócios modificados ou recém-criados – neste momento para contas, oportunidades, projetos e pedidos de vendas. Inicie seu fluxo com um desses gatilhos.

  • Criar um novo fluxo no Power Automate e selecionar 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 somente para esta empresa
  • Os eventos também precisam ser habilitados no Exact Online, caso contrário, você não receberá nada no Power Automate
    • Vá paraa Visão Geral doFluxo> de Dados> Mestre: Flui 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 esse Conteúdo para suas necessidades.

  • Como o Tipo de Entidade, selecione a mesma entidade que o gatilho
  • Como o Tipo de Valor, selecione o seguinte:
    • Novos Valores se você quiser poder selecionar campos específicos do novo estado (alterado) em outras ações
    • Valores antigos se você quiser poder 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.
  • Parâmetros adicionais Content-Type e Accept são definidos por padrão como application/json. Você não deve precisar mudar isso.

Exemplos

Exemplo 1: processar somente pedidos de vendas avaliados em mais de 10.000 euros

  • Usar gatilho quando um pedido de vendas for criado ou alterado
  • Adicionar uma ação Obter Valores com a Entidade definida como Ordem de Vendas e Tipo de Valor definido como Novos valores
  • Usar um bloco de condição (ação interna de controle )
    • Defina a condição como AmountDC | menor que | 10000
      • Observação: AmountDC é uma saída de Obter valores
  • No branch verdadeiro do bloco de condição, adicione uma ação Encerrar (ação de controle interno)

Exemplo 2: gerar os campos alterados para um email

  • Usar 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
  • Adicione uma ação Filtrar (ação interna da Operação de Dados ) com a saída de Obter valores como sua entrada e como um conjunto de condições oldValue | Não é igual a | newValue
  • Adicionar uma ação Criar Tabela HTML (ação interna da Operação de Dados ) e usar 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 e limitações conhecidos

Mensagem vazia para teste de conectividade

Ao configurar um novo fluxo ou ao ativar um fluxo existente, uma mensagem é enviada ao 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 em seu fluxo, o fluxo poderá terminar em erro ou enviar notificações com conteúdo incompleto. Como geralmente é um comportamento único, você pode optar por aceitá-lo, mas pode receber avisos sobre fluxos com 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 a | true é uma boa maneira de fazer isso. No branch verdadeiro , 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é agora, nenhum erro foi encontrado.

perguntas frequentes

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

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

  • Ele usa o Payload campo do gatilho e converte seu texto em um objeto JSON. Isso é equivalente à json(...) função;
  • Ele carrega um esquema para esse objeto JSON para que suas propriedades possam ser referenciadas em outras ações. Você poderia fazer isso com a ação de Análise JSON , mas precisaria fornecer todo o esquema por conta própria;
  • Ele pode converter o conteúdo 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 do Payload na ação Obter Valores?

Por padrão, isso é definido como triggerOutputs()?['body/Content/Payload'] qual é a referência ao campo De conteúdo recebido 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 outras ações. Esse é um recurso 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, as propriedades do projeto em um pedido de vendas. Isso significa que algumas propriedades que fazem parte da entidade não são mostradas e algumas propriedades mostradas não fazem parte da entidade.

Você ainda poderá acessar as propriedades se elas existirem na entidade, mas você precisará inserir a referência manualmente.

Escolher uma propriedade inexistente em outra ação simplesmente resultará em um valor vazio; as consequências disso dependerão da ação.

Limitações

Nome Chamadas Período de renovação
Chamadas à API por conexão 100 60 segundos

Ações

Obter valores [PRETERIDO]

Isso carrega os valores do campo Payload do gatilho em um formato de escolha.

Obter valores [PRETERIDO]

Isso carrega os valores do campo Payload do gatilho em um formato de escolha.

Parâmetros

Nome Chave Obrigatório Tipo Description
cabeçalho Content-Type
Content-Type string

Especifique o tipo de conteúdo do conteúdo.

Aceitar cabeçalho
Accept string

Especifique o formato de resposta aceito.

Tipo de entidade
EntityType True string

Selecione o tipo de entidade de negócios para esta operação.

Tipo de valor
ValueType True string

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

Conteúdo
body string

Adicionar referência ao campo Conteúdo aqui

Retornos

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

Gatilhos

Quando um pedido de vendas é criado ou alterado [PRETERIDO]

Isso se inscreve para criar ou alterar eventos para pedidos de vendas.

Quando um projeto é criado ou alterado [PRETERIDO]

Isso se inscreve para criar ou alterar eventos para projetos.

Quando uma conta é criada ou alterada [PRETERIDA]

Isso se inscreve para criar ou alterar eventos para contas.

Quando uma oportunidade é criada ou alterada [PRETERIDA]

Isso se inscreve para criar ou alterar eventos para oportunidades.

Quando um pedido de vendas é criado ou alterado [PRETERIDO]

Isso se inscreve para criar ou alterar eventos para pedidos de vendas.

Parâmetros

Nome Chave Obrigatório Tipo Description
Empresa
Company True string

Selecione a empresa para a qual você deseja receber os eventos.

Retornos

Quando um projeto é criado ou alterado [PRETERIDO]

Isso se inscreve para criar ou alterar eventos para projetos.

Parâmetros

Nome Chave Obrigatório Tipo Description
Empresa
Company True string

Selecione a empresa para a qual você deseja receber os eventos.

Retornos

Quando uma conta é criada ou alterada [PRETERIDA]

Isso se inscreve para criar ou alterar eventos para contas.

Parâmetros

Nome Chave Obrigatório Tipo Description
Empresa
Company True string

Selecione a empresa para a qual você deseja receber os eventos.

Retornos

Quando uma oportunidade é criada ou alterada [PRETERIDA]

Isso se inscreve para criar ou alterar eventos para oportunidades.

Parâmetros

Nome Chave Obrigatório Tipo Description
Empresa
Company True string

Selecione a empresa para a qual você deseja receber os eventos.

Retornos

Definições

guidText

EntityChangedEvent

Nome Caminho Tipo Description
Content
Content ChangeEventContent
HashCode
HashCode string

ChangeEventContent

Nome Caminho Tipo Description
Tópico
Topic string
ClientId
ClientId guidText
Empresa
Division integer

Empresa

Ação
Action string
Key
Key guidText
ExactOnlineEndpoint
ExactOnlineEndpoint string
EventCreatedOn
EventCreatedOn string
Conteúdo
Payload string