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