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
- Defina a condição como
- 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
Payloadcampo 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
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
- Corpo
- EntityChangedEvent
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
- Corpo
- EntityChangedEvent
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
- Corpo
- EntityChangedEvent
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
- Corpo
- EntityChangedEvent
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 |