Configuração do Addon do Business Central para RapidStart CRM
Passos para instalar e configurar o Addon do Business Central para RapidStart CRM. Ao contrário das nossas aplicações, este addon requer vários passos tanto do lado do RapidStart CRM como do lado do Business Central.
⚠️ Parceiro Recomendado
Devido à complexidade, sugerimos utilizar um dos nossos Parceiros Certificados RapidStart para isto. No entanto, se o seu parceiro do Business Central também for habilidoso na Power Platform, ele pode realizar estes passos para 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.
- Configurar a Integração a partir do Business Central.
- Atualizar o Papel de Utilizador da Aplicação
- Configurar Mapeamento de Registos
- Instalar o Addon do Business Central para RapidStart CRM do AppSource no ambiente com Dataverse ativado.
- Atualizar Variáveis de Ambiente
- Atribuir papéis de segurança do RapidStart CRM
- Ligar Ambientes (Opcional)
- Fluxos do Power Automate
Já criámos um documento que cobre os passos 1 & 2 aqui. Uma vez que esses passos estejam completos, 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.
Passo 3: Configurar a Integração a partir do Business Central
Inicie sessão no Ambiente do Business Central ao qual deseja conectar-se.

Tome nota de algumas informações na barra de endereço.

Copie e cole numa página do Bloco de Notas tanto o ID do Ambiente (em amarelo) quanto o Nome da Empresa (em verde). Precisaremos disso mais tarde.

1. Clique na engrenagem
2. Selecione “Configuração Assistida”

Desça até a seção “Conectar com outros sistemas” e clique em “Configurar uma conexão com o Dataverse”.

1. Selecione para Habilitar sincronização de dados
2. Selecione para habilitar tabelas virtuais e eventos
3. Clique “Próximo”

Aceite os Termos e clique “Próximo”

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 “Próximo”

Selecione a propriedade de Equipa recomendada, alterne para Completar sem sincronização (faremos isso mais tarde) e clique “Próximo”

1. Clique no Link para Instalar a aplicação de Tabela Virtual do Business Central
2. Clique “Próximo” (Uma nova aba será aberta para o AppSource)

Clique no botão “Obter agora” (Este addon é gratuito), e a seguinte página 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 para 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 selecionando 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 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 4: Atualizar o Papel de Utilizador da Aplicação
Clique neste link para abrir o Centro de Administração da Power Platform e confirme que está conectado com a sua conta empresarial.

Selecione “Gerir” na barra lateral e depois clique no link do ambiente alvo

Selecione “Ver todos” para Utilizadores

Selecione o link da lista de utilizadores da aplicação

Selecione o utilizador da aplicação Business Central.

Clique no ícone “editar” para “Papéis de Segurança”

1. Role para baixo e selecione “Administrador do Sistema”
2. depois clique em Guardar
Passo 5: Configurar Mapeamento e Acoplamento de Registos
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”

1. Selecione VENDEDORES
2. Eliminar
3. Desmarcar Acoplamento para todos os itens

1. Selecione CONTACTO
2. Selecione Acoplamento
3. Depois clique em “Acoplamento Baseado em Correspondência”.
4. Corresponda ao acima e clique OK

1. Selecione MOEDA
2. Selecione Acoplamento
3. Depois clique em “Acoplamento Baseado em Correspondência”.
4. Corresponda ao acima e clique OK

Para CLIENTE Selecione Mapeamento/Campos
1. Selecione “Editar Lista”
2. e “ativar” Número de conta.

Ainda para CLIENTE, selecione Acoplamento/Acoplamento Baseado em Correspondência e corresponda ao acima

Para TERMOS DE PAGAMENTO, selecione Acoplamento/Acoplamento Baseado em Correspondência e corresponda ao acima.

Para MÉTODO DE ENVIO, selecione Acoplamento/Acoplamento Baseado em Correspondência e corresponda ao acima.

Para AGENTE DE ENVIO, selecione Acoplamento/Acoplamento Baseado em Correspondência e corresponda ao acima.

Para FORNECEDOR Selecione Mapeamento/Campos
1. Selecione “Editar Lista”
2. e “ativar” Número de conta.

Ainda para FORNECEDOR, selecione Acoplamento/Acoplamento Baseado em Correspondência e corresponda ao acima
Passo 6: Instalar o Addon do Business Central para RapidStart CRM do AppSource
⚠️ Este Passo falhará se algum dos passos anteriores não tiver sido concluído.
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 para completar. Ocasionalmente clique “atualizar” até ver que está “Instalado”.
Passo 7: Atualizar Variáveis de Ambiente
Vá para o portal do Maker

1. Selecione o ambiente onde a solução foi instalada.
2. Clique em Soluções na barra lateral.
3. Clique para abrir a Solução Padrão

1. Selecione Objetos.
2. Role para baixo e selecione “Variáveis de Ambiente”
3. Clique em ID da Empresa BC.

1. Cole o ID da Empresa que copiou anteriormente aqui.
2. Clique Guardar.
3. Repita isto para a variável “Nome do Ambiente BC”, usando o outro valor que copiou anteriormente.
Quando terminar, clique “Voltar para Soluções” na barra lateral.

Clique para Publicar todas as personalizações.
Passo 8: Atribuir Papéis de Segurança ao Utilizador
Enquanto ainda estiver no portal do maker:

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 maker. A partir do portal do maker:
1. Selecione Aplicações na barra lateral.
2. Clique no ícone de Executar.

1. Selecione “Utilizadores” na barra lateral.
2. Clique no nome de um Utilizador.
3. Se não houver utilizadores listados, então selecione o menu suspenso para mostrar “Utilizadores Disponíveis”.

1. Além de quaisquer papéis do RapidStart CRM (no mínimo, o “Utilizador Básico do RapidStart”), selecione o papel RapidStart Business Central User “CRUD” ou “Apenas Leitura”.
CRUD permite que o utilizador crie Cotações de Vendas a partir do RapidStart CRM.
Apenas leitura restringe o utilizador a solicitar que uma Cotação de Vendas seja criada por um utilizador do BC.
Passo 9: Ligar Ambientes (Opcional)
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 10: Fluxos do Power Automate
O nosso Addon inclui vários Fluxos do Power Automate. Dois estão desligados por padrão. Pode ligá-los ou editá-los para atender às suas necessidades. Os que estão desligados são:
Sincronizar Nova Conta para BC
Este fluxo é acionado sempre que adiciona uma nova Conta no RapidStart CRM que não tem um Número de Conta BC. Cria um novo Cliente BC e depois atualiza a Conta com o número de conta BC para garantir que os registos estão sincronizados. Esteja ciente de que, conforme projetado, este fluxo criará registos no BC sempre que registos forem criados no RapidStart. Pode ou não querer isto.
Sincronizar Novo Contacto para BC
Este fluxo é acionado sempre que adiciona um novo Contacto no RapidStart CRM que não tem um Número de Contacto BC. Cria um novo Contacto BC e depois atualiza o Contacto com o número de contacto BC para garantir que os registos estão sincronizados. Esteja ciente de que, conforme projetado, este fluxo criará registos no BC sempre que registos forem criados no RapidStart. Pode ou não querer isto.
🎉 Implementação Completa!
Se houver problemas com esta documentação, por favor informe-nos.