Configuração do Addon do Business Central para RapidStart CRM
Passos para instalar, configurar e validar o Addon do Business Central para o RapidStart CRM. Este addon utiliza tanto os fluxos na cloud do RapidStart como a sincronização nativa do Business Central-Dataverse da Microsoft, pelo que os administradores devem validar ambos os lados antes de testar cenários de cliente ou de orçamento.
⚠️ Recomendado por Parceiros
Devido à complexidade, sugerimos utilizar um dos nossos Parceiros Certificados RapidStart para isto. No entanto, se o seu parceiro Business Central também for habilidoso na Power Platform, ele pode realizar estes passos por si. Não recomendamos que um utilizador final tente este processo.
Passos de Alto Nível
- Criar ou usar um ambiente existente com Dataverse ativado.
- Instalar RapidStart CRM do AppSource no ambiente com Dataverse ativado.
- Obter o ID do Sistema da Empresa do Business Central.
- Configurar a Integração a partir do Business Central.
- Verificar o papel do utilizador da aplicação de integração do Business Central
- Configurar Mapeamento de Registos
- Ligar Ambientes (Opcional)
- Instalar o Addon do Business Central para RapidStart CRM do AppSource no ambiente com Dataverse ativado.
- Concluir na aplicação de Configurações do RapidStart
Já criámos um documento que cobre os passos 1 & 2 aqui. Uma vez que esses passos estejam concluídos, volte aqui para continuar com o Passo 3.
Certifique-se de que os tipos de ambiente do Dataverse e BC correspondem: Produção para Produção, ou Sandbox para Sandbox.
Antes de Começar
Confirme estes requisitos antes de iniciar a configuração do Addon do Business Central:
- Business Central e Dataverse devem estar no mesmo inquilino Microsoft Entra para tabelas virtuais do Business Central.
- Utilize um administrador de configuração humano com as permissões necessárias do Business Central e acesso de Administrador do Sistema do Dataverse durante a configuração.
- Confirme que o RapidStart CRM está instalado no ambiente Dataverse que planeia conectar.
Passo 3: Obter ID da Empresa
Para obter o ID da sua empresa, procure Empresas no Business Central. Selecione a empresa alvo e pressione Ctrl+Alt+F1 para abrir a Inspeção de Página. Copie o ID mostrado e guarde-o para mais tarde.
Use o GUID do ID do Sistema da Empresa
O ID da empresa que precisa para a variável de ambiente do RapidStart é o GUID do ID do Sistema da Empresa do Business Central. Não use o nome de exibição da empresa editável da barra de endereços. Se não conseguir abrir a Inspeção de Página, peça ao seu administrador ou parceiro do Business Central para fornecer o ID da empresa.
Passo 4: Configurar a Integração a partir do Business Central
Inicie sessão no Ambiente do Business Central que deseja conectar.
Tome nota do nome do ambiente do Business Central na barra de endereços. O URL pode também mostrar o nome de exibição da empresa, mas já capturou o GUID do ID do Sistema da Empresa no passo anterior.
Copie o nome do ambiente do Business Central para as mesmas notas onde guardou o GUID do ID do Sistema da Empresa.
ID da Empresa já capturado
Use o GUID do ID do Sistema da Empresa do Passo 3 quando a configuração pedir o ID da Empresa BC. O nome de exibição da empresa no URL é apenas uma alternativa compatível com versões anteriores para implementações mais antigas.
1. Clique na engrenagem
2. Selecione “Configuração Assistida”
Desça até à secção “Conectar com outros sistemas” e clique em “Configurar uma conexão com o Dataverse”.
1. Selecione para Ativar sincronização de dados
2. Selecione para ativar tabelas virtuais e eventos
3. Clique “Seguinte”
Aceite os Termos e clique “Seguinte”
Aceite a conexão com o Dataverse “Permitir Sempre”, e clique OK
Selecione o ambiente alvo com Dataverse ativado, e clique “Ok”
Confirme que o ambiente está correto, depois clique no link para Iniciar sessão no ambiente do Dataverse. Após iniciar sessão clique “Seguinte”
Selecione a propriedade de Equipa recomendada, alterne para Completar sem sincronização (faremos isso mais tarde) e clique “Seguinte”
1. Clique no Link para Instalar a aplicação de Tabela Virtual do Business Central
2. Clique “Seguinte” (Uma nova aba será aberta para o AppSource)
Clique no botão “Obter agora” (Este addon é gratuito), e a página seguinte será aberta:
1. Selecione o ambiente alvo (onde instalou o RapidStart CRM).
2. Concorde com os termos.
3. Clique “Instalar”.
Verá que a solução está “A Instalar”. Isto pode demorar vários minutos a completar. Ocasionalmente clique “atualizar” até ver que está “Instalado”, depois volte à aba do navegador do Business Central para continuar.
Clique “Atualizar”
Verá que a aplicação de Tabelas Virtuais foi instalada com sucesso. Clique “Concluir”
Após alguns minutos esta página aparecerá. Selecione a Aba de Tabelas Virtuais e depois “Tabelas Virtuais Disponíveis”
1. Comece por selecionar a linha “item”
2. Clique “Ativar” (Isto criará a tabela virtual no Dataverse para itens)
3. Espere até ver a caixa “Visível” marcada. Pode precisar de atualizar algumas vezes.
Repita estes passos para: salesInvoice, salesInvoiceLine, salesOrder, salesOrderLine, salesQuote, salesQuoteLine, salesShipment, e salesShipmentLine. Isto levará vários minutos para cada um ser ativado.
Altere para ordenar por Visível/descendente, e confirme que vê todas estas tabelas. Não adicione mais Tabelas Virtuais neste momento. Pode deixar a tela como está (voltaremos a ela) e abrir uma nova aba.
Passo 5: Verificar o Utilizador da Aplicação de Integração do Business Central
Não atribua Administrador do Sistema ao utilizador da aplicação
O administrador de configuração humano precisa de permissões de Administrador do Sistema do Dataverse durante a configuração. O utilizador da aplicação de integração do Business Central criado automaticamente deve usar o papel Business Central Dataverse Integration da Microsoft, não Administrador do Sistema.
Se as permissões de sincronização Business Central-Dataverse parecerem danificadas, abra Configuração de Conexão do Dataverse no Business Central e use Reimplantar Solução de Integração. Isto restaura a solução de integração da Microsoft e implementa o papel de segurança de integração do Business Central.
Continue apenas após o teste de conexão ter sucesso e o utilizador da aplicação de integração do Business Central ter o papel de Integração do Dataverse do Business Central da Microsoft.
Passo 6: Configurar Mapeamento e Acoplamento de Registos
Os fluxos RapidStart e a sincronização da Microsoft são separados
Os fluxos na nuvem RapidStart suportam ações de addon como pedidos de cotação e atualizações selecionadas de cliente/contato. Os mapeamentos de tabelas de integração nativa do Business Central da Microsoft lidam com sincronização, acoplamento, dados de referência e sincronização agendada entre Business Central e Dataverse. Configure ambos contra o mesmo ambiente Dataverse e empresa do Business Central.
Configure mapeamentos de referência antes da sincronização de clientes
Execute e valide mapeamentos de referência antes de testar CLIENTE. A sincronização de clientes frequentemente falha quando valores de moeda, termos de pagamento, método de envio ou agente de envio não existem ou não têm IDs de opção correspondentes no lado do Dataverse.
Mapeamentos de referência a configurar antes de CLIENTE
- MOEDA: Moeda do Business Central → Moeda de Transação do Dataverse. A direção deve ser Business Central para Dataverse. Confirme estes mapeamentos de campo ativados: Código → Código da Moeda, Símbolo → Símbolo da Moeda, e Descrição → Nome da Moeda.
- Confirme que o mapeamento de CLIENTE contém Código da Moeda → Moeda. Sincronize moedas antes de clientes. A moeda base do Dataverse e a moeda local do Business Central devem concordar, e taxas de câmbio necessárias devem existir.
- Termos de Pagamento: sincronize para Termos de Pagamento da Conta antes de testar clientes.
- Método de Envio: sincronize para Termos de Frete da Conta antes de testar clientes.
- Agente de Envio: sincronize para Método de Envio da Conta antes de testar clientes.
Política de criação de clientes
Defina CLIENTE para Bidirecional se contas/empresas puderem ser criadas em ambos os lados. Depois escolha a política Sincronizar Apenas Registos Acoplados como uma decisão de implementação de cliente:
| Configuração | Comportamento |
|---|---|
| Sincronizar Apenas Registos Acoplados = Ligado | Sincroniza apenas registos que um administrador já acoplou. Isto evita a criação ampla de novos registos não acoplados. |
| Sincronizar Apenas Registos Acoplados = Desligado | A sincronização inicial e agendada pode criar clientes/contas não acoplados do outro lado. Use isto apenas quando esse comportamento de criação for pretendido. |
Acoplamento necessário quando Sincronizar Apenas Registos Acoplados está Ligado
Quando Sincronizar Apenas Registos Acoplados está Ligado, a sincronização da Microsoft atualiza apenas registos já acoplados. Um fluxo RapidStart pode criar um cliente do Business Central e armazenar o seu número de cliente na conta do Dataverse, mas isso não estabelece o acoplamento nativo da Microsoft. Após usar o fluxo, acople manualmente o cliente e a conta no Business Central se a sincronização nativa contínua for necessária. Um número de cliente do Business Central por si só não é prova de acoplamento.
Validação de valores de opção
Os IDs de valor de enumeração do Business Central usados para Termos de Pagamento, Método de Envio e Agente de Envio devem corresponder aos IDs de opção correspondentes do Dataverse. O texto de exibição ou rótulo de código sozinho não é suficiente. Uma sincronização completa não repara uma incompatibilidade de ID quando o Business Central contém valores de enumeração personalizados que não existem no Dataverse.
- Execute Sincronizar Registos Modificados para TERMOS DE PAGAMENTO, MÉTODO DE ENVIO, e AGENTE DE ENVIO.
- Inspecione Mapeamento de Opções do Dataverse e o log de erros de sincronização antes de testar CLIENTE.
- Se os IDs não estiverem alinhados, use o padrão seguro no mapeamento de campos CLIENTE: Código de Termos de Pagamento → Termos de Pagamento = FromIntegrationTable; Código de Método de Envio → Endereço 1: Termos de Frete = FromIntegrationTable; Código de Agente de Envio → Endereço 1: Método de Envio = FromIntegrationTable.
- Altere esses três campos para Bidirecional apenas depois que um desenvolvedor tiver adicionado IDs de opção correspondentes em ambos os lados.
- Não invente ou renumere IDs de opção durante a configuração. Valores personalizados do Dataverse e extensões de enumeração do Business Central devem usar exatamente os mesmos IDs.
Volte para a aba do Business Central no seu navegador que deixámos aberta.
1. Clique na aba “Integração”
2. depois “Mapeamentos de Tabela de Integração”
Decisão do cliente: manter VENDEDORES se o cliente quiser a sincronização padrão de utilizador do Dataverse para vendedor do Business Central da Microsoft. Exclua ou desative este mapeamento apenas quando essa sincronização padrão não for intencionalmente usada.
1. Selecione CONTATO
2. Selecione Acoplamento
3. Depois clique “Acoplamento Baseado em Correspondência”.
4. Corresponda o acima e clique OK
1. Selecione MOEDA
2. Selecione Acoplamento
3. Depois clique “Acoplamento Baseado em Correspondência”.
4. Corresponda o acima e clique OK
Para CLIENTE Selecione Mapeamento/Campos
1. Selecione “Editar Lista”
2. e “ativar” Número da conta.
Ainda para CLIENTE, selecione Acoplamento/Acoplamento Baseado em Correspondência. Corresponda usando os campos identificadores de cliente/conta mostrados na captura de ecrã, e confirme que os campos correspondentes identificam unicamente o mesmo cliente em ambos os lados.
Para TERMOS DE PAGAMENTO, selecione Acoplamento/Acoplamento Baseado em Correspondência. Corresponda os registos de termos de pagamento do Business Central aos valores de opção de termos de pagamento correspondentes do Dataverse pelos IDs configurados.
Para MÉTODO DE ENVIO, selecione Acoplamento/Acoplamento Baseado em Correspondência. Corresponda os métodos de envio do Business Central aos valores de opção de termos de frete correspondentes do Dataverse pelos IDs configurados.
Para AGENTE DE ENVIO, selecione Acoplamento/Acoplamento Baseado em Correspondência. Corresponda os agentes de envio do Business Central aos valores de opção de método de envio correspondentes do Dataverse pelos IDs configurados.
Para FORNECEDOR Selecione Mapeamento/Campos
1. Selecione “Editar Lista”
2. e “ativar” Número da conta.
Ainda para FORNECEDOR, selecione Acoplamento/Acoplamento Baseado em Correspondência. Corresponda usando os campos identificadores de fornecedor/conta mostrados na captura de ecrã, e confirme que os campos correspondentes identificam unicamente o mesmo fornecedor em ambos os lados.
Passo 7: Ligar Ambientes (Opcional)
Requisito opcional de ligação de ambientes
Apenas ligue ambientes quando o ambiente do Business Central e o ambiente da Power Platform forem do mesmo tipo de ambiente, como produção-para-produção ou sandbox-para-sandbox, e estiverem na mesma geografia do Azure.
Para evitar que alguém apague acidentalmente ambientes, pode ligá-los. Comece de volta no Business Central.
1. Selecione o ícone de Engrenagem
2. Depois selecione Centro de Administração
Selecione o link do ambiente alvo
Clique em “Ligar” e selecione o seu ambiente do Dataverse
Passo 8: Instalar o Addon do Business Central para RapidStart CRM do AppSource
Confirme a fundação necessária antes de instalar o addon
RapidStart CRM e o suporte de Tabela Virtual do Microsoft Business Central devem ser instalados primeiro. Verifique as tabelas virtuais do Business Central necessárias e os valores de conexão antes de continuar. A ligação opcional de ambientes não precisa ser concluída para esta instalação do AppSource.
Clique neste link para abrir o AppSource da Microsoft e confirme que está conectado com a sua conta empresarial.
Selecione “Obter agora” para iniciar a instalação.
1. Selecione o ambiente onde instalou a solução de Tabelas Virtuais.
2. Concorde com os termos.
3. Clique Instalar. Note que a instalação pode demorar vários minutos.
Verá que a solução está “A Instalar”. Isto pode demorar vários minutos a completar. Ocasionalmente clique “atualizar” até ver que está “Instalado”.
Passo 9: Concluir na aplicação de Configurações do RapidStart
Vá para RapidStart CRM e selecione a Aplicação de Configurações do RapidStart.
Pode abrir a aplicação de Configurações do RapidStart a partir do Seletor de Aplicações no RapidStart CRM, ou a partir do portal do criador:
1. Selecione Aplicações na barra lateral.
2. Clique no ícone Executar para a aplicação de Configurações do RapidStart.
1. Confirme que está na Aplicação de Configurações do RapidStart.
2. Selecione “Aplicações e Addons” na barra lateral.
3. Clique “Configurar” para o Addon do Business Central.
Use este assistente para completar quaisquer itens em falta e gerir o conector.
Resolução de Problemas
IDs de conexão em falta
Se um fluxo relatar um ID de conexão em falta, repare as referências de conexão do Dataverse e do Business Central na aplicação de Configurações do RapidStart ou no Power Automate, depois ligue o fluxo novamente. Recriar uma conexão sozinho não é suficiente se a referência de conexão ainda estiver vinculada à conexão antiga.
Erros de mapeamento de moeda
Se a sincronização de CLIENTE falhar na moeda, restaure ou verifique o mapeamento de MOEDA, confirme que Código → Código da Moeda está ativado, sincronize moedas, e confirme que a moeda do cliente existe no Dataverse antes de tentar novamente CLIENTE.
Incompatibilidades de opções
Se a sincronização falhar porque um valor de Termos de Pagamento, Método de Envio ou Agente de Envio está fora do intervalo válido do Dataverse, o ID de valor de enumeração do Business Central não corresponde a um ID de opção do Dataverse. Use FromIntegrationTable para o mapeamento de campo CLIENTE afetado até que IDs correspondentes sejam implantados.
Acoplamentos apontando para registos excluídos
Se um registo parecer acoplado mas a sincronização apontar para um registo excluído ou em falta, remova o acoplamento obsoleto no Business Central e crie um novo acoplamento para a conta ou contato correto do Dataverse antes de executar novamente a sincronização.
Implementação Completa
Se houver problemas com esta documentação, por favor informe-nos.