Componenti aggiuntivi di Business Central per la configurazione di RapidStart CRM
Passaggi per installare, configurare e convalidare il componente aggiuntivo Business Central per RapidStart CRM. Questo componente aggiuntivo utilizza sia i flussi cloud di RapidStart che la sincronizzazione nativa Business Central-Dataverse di Microsoft, quindi gli amministratori dovrebbero convalidare entrambi i lati prima di testare scenari di clienti o preventivi.
⚠️ Partner Consigliato
A causa della complessità, suggeriamo di utilizzare uno dei nostri Partner Certificati RapidStart per questo. Tuttavia, se il tuo partner Business Central è anche esperto nella Power Platform, può eseguire questi passaggi per te. Non raccomandiamo che un utente finale tenti questo processo.
Passaggi di Alto Livello
- Crea o utilizza un ambiente esistente abilitato per Dataverse.
- Installa RapidStart CRM da AppSource sull'ambiente abilitato per Dataverse.
- Ottieni l'ID del Sistema Aziendale di Business Central.
- Configura l'Integrazione all'interno di Business Central.
- Verifica il ruolo utente dell'applicazione di integrazione di Business Central
- Configura la Mappatura dei Record
- Collega gli Ambienti (Opzionale)
- Installa l'Addon di Business Central per RapidStart CRM da AppSource sull'ambiente abilitato per Dataverse.
- Completa nell'app Impostazioni RapidStart
Abbiamo già creato un documento che copre i passaggi 1 & 2 qui. Una volta completati quei passaggi, torna qui per continuare con il Passo 3.
Assicurati che i tipi di ambiente Dataverse e BC corrispondano: Produzione a Produzione, o Sandbox a Sandbox.
Prima di Iniziare
Conferma questi requisiti prima di iniziare la configurazione dell'Addon di Business Central:
- Business Central e Dataverse devono essere nello stesso tenant Microsoft Entra per le tabelle virtuali di Business Central.
- Utilizza un amministratore di configurazione umano con i permessi richiesti di Business Central e l'accesso come Amministratore di Sistema di Dataverse durante la configurazione.
- Conferma che RapidStart CRM sia installato nell'ambiente Dataverse che intendi connettere.
Passo 3: Ottieni l'ID Aziendale
Per ottenere il tuo ID aziendale, cerca Aziende in Business Central. Seleziona l'azienda di destinazione e premi Ctrl+Alt+F1 per aprire Ispezione Pagina. Copia l'ID mostrato e salvalo per dopo.
Usa il GUID dell'ID del Sistema Aziendale
L'ID aziendale di cui hai bisogno per la variabile d'ambiente RapidStart è il GUID dell'ID del Sistema Aziendale di Business Central. Non utilizzare il nome visualizzato dell'azienda modificabile dalla barra degli indirizzi. Se non puoi aprire l'Ispezione Pagina, chiedi al tuo amministratore o partner di Business Central di fornire l'ID aziendale.
Passo 4: Configura l'Integrazione all'interno di Business Central
Accedi all'Ambiente di Business Central che desideri connettere.
Prendi nota del nome dell'ambiente di Business Central nella barra degli indirizzi. L'URL potrebbe anche mostrare il nome visualizzato dell'azienda, ma hai già catturato il GUID dell'ID del Sistema Aziendale nel passaggio precedente.
Copia il nome dell'ambiente di Business Central negli stessi appunti dove hai salvato il GUID dell'ID del Sistema Aziendale.
ID aziendale già catturato
Usa il GUID dell'ID del Sistema Aziendale dal Passo 3 quando la configurazione richiede l'ID Aziendale BC. Il nome visualizzato dell'azienda nell'URL è solo un fallback compatibile con le versioni precedenti per le implementazioni più vecchie.
1. Clicca sull'ingranaggio
2. Seleziona “Configurazione Assistita”
Scorri fino alla sezione “Connetti con altri sistemi” e clicca su “Configura una connessione a Dataverse”.
1. Seleziona per Abilitare la sincronizzazione dei dati
2. Seleziona per abilitare tabelle virtuali ed eventi
3. Clicca “Avanti”
Accetta i Termini e clicca “Avanti”
Accetta la connessione a Dataverse “Consenti Sempre”, e clicca OK
Seleziona l'ambiente abilitato per Dataverse di destinazione, e clicca “Ok”
Conferma che l'ambiente sia corretto, quindi clicca sul link per Accedere all'ambiente Dataverse. Dopo aver effettuato l'accesso clicca “Avanti”
Seleziona la proprietà del Team consigliata, attiva per Completare senza sincronizzazione (lo faremo più tardi) e clicca “Avanti”
1. Clicca sul Link per Installare l'app Tabella Virtuale di Business Central
2. Clicca “Avanti” (Si aprirà una nuova scheda su AppSource)
Clicca sul pulsante “Ottienilo ora” (Questo addon è gratuito), e la pagina seguente si aprirà:
1. Seleziona l'ambiente di destinazione (dove hai installato RapidStart CRM).
2. Accetta i termini.
3. Clicca “Installa”.
Vedrai che la soluzione è “In installazione”. Questo potrebbe richiedere diversi minuti per completarsi. Occasionalmente clicca “aggiorna” fino a quando non vedi che è “Installata”, quindi torna alla scheda del browser di Business Central per continuare.
Clicca “Aggiorna”
Vedrai che l'app Tabelle Virtuali è stata installata con successo. Clicca “Fine”
Dopo alcuni minuti questa pagina apparirà. Seleziona la Scheda Tabelle Virtuali e poi “Tabelle Virtuali Disponibili”
1. Inizia selezionando la riga “articolo”
2. Clicca “Abilita” (Questo creerà la tabella virtuale in Dataverse per gli articoli)
3. Attendi fino a quando non vedi la casella “Visibile” selezionata. Potrebbe essere necessario aggiornare alcune volte.
Ripeti questi passaggi per: salesInvoice, salesInvoiceLine, salesOrder, salesOrderLine, salesQuote, salesQuoteLine, salesShipment, e salesShipmentLine. Questo richiederà diversi minuti per ciascuno per essere abilitato.
Cambia per ordinare per Visibile/decrescente, e conferma di vedere tutte queste tabelle. Non aggiungere altre Tabelle Virtuali in questo momento. Puoi lasciare lo schermo così com'è (ci torneremo) e aprire una nuova scheda.
Passo 5: Verifica l'Utente dell'Applicazione di Integrazione di Business Central
Non assegnare Amministratore di Sistema all'utente dell'applicazione
L'amministratore di configurazione umano necessita dei permessi di Amministratore di Sistema di Dataverse durante la configurazione. L'utente dell'applicazione di integrazione di Business Central creato automaticamente dovrebbe utilizzare il ruolo Integrazione Dataverse di Business Central di Microsoft, non Amministratore di Sistema.
Se i permessi di sincronizzazione Business Central-Dataverse sembrano danneggiati, apri Configurazione Connessione Dataverse in Business Central e utilizza Ridispiega Soluzione di Integrazione. Questo ripristina la soluzione di integrazione di Microsoft e distribuisce il ruolo di sicurezza di integrazione di Business Central.
Continua solo dopo che il test di connessione ha successo e l'utente dell'applicazione di integrazione di Business Central ha il ruolo di Integrazione Dataverse di Business Central di Microsoft.
Passo 6: Configura la Mappatura e l'Accoppiamento dei Record
I flussi RapidStart e la sincronizzazione Microsoft sono separati
I flussi cloud RapidStart supportano azioni addon come richieste di preventivo e aggiornamenti selezionati di clienti/contatti. Le mappature delle tabelle di integrazione native di Microsoft gestiscono la sincronizzazione, l'accoppiamento, i dati di riferimento e la sincronizzazione programmata tra Business Central e Dataverse. Configura entrambi contro lo stesso ambiente Dataverse e azienda Business Central.
Configura le mappature di riferimento prima della sincronizzazione dei clienti
Esegui e convalida le mappature di riferimento prima di testare il CLIENTE. La sincronizzazione dei clienti spesso fallisce quando i valori di valuta, termini di pagamento, metodo di spedizione o agente di spedizione non esistono o non hanno ID opzione corrispondenti sul lato Dataverse.
Mappature di riferimento da configurare prima del CLIENTE
- VALUTA: Valuta di Business Central → Valuta di Transazione di Dataverse. La direzione deve essere Business Central a Dataverse. Conferma queste mappature di campo abilitate: Codice → Codice Valuta, Simbolo → Simbolo Valuta, e Descrizione → Nome Valuta.
- Conferma che la mappatura CLIENTE contenga Codice Valuta → Valuta. Sincronizza le valute prima dei clienti. La valuta base di Dataverse e la valuta locale di Business Central devono concordare, e devono esistere i tassi di cambio richiesti.
- Termini di Pagamento: sincronizza con i Termini di Pagamento dell'Account prima del test del cliente.
- Metodo di Spedizione: sincronizza con i Termini di Trasporto dell'Account prima del test del cliente.
- Agente di Spedizione: sincronizza con il Metodo di Spedizione dell'Account prima del test del cliente.
Politica di creazione del cliente
Imposta CLIENTE su Bidirezionale se gli account/aziende possono essere creati su entrambi i lati. Quindi scegli la politica Sincronizza Solo Record Accoppiati come decisione di distribuzione del cliente:
| Impostazione | Comportamento |
|---|---|
| Sincronizza Solo Record Accoppiati = On | Sincronizza solo i record che un amministratore ha già accoppiato. Questo evita la creazione ampia di nuovi record non accoppiati. |
| Sincronizza Solo Record Accoppiati = Off | La sincronizzazione iniziale e programmata può creare clienti/account non accoppiati sull'altro lato. Usa questo solo quando quel comportamento di creazione è inteso. |
Accoppiamento richiesto quando Sincronizza Solo Record Accoppiati è On
Quando Sincronizza Solo Record Accoppiati è On, la sincronizzazione Microsoft aggiorna solo i record già accoppiati. Un flusso RapidStart può creare un cliente Business Central e memorizzare il suo numero cliente sull'account Dataverse, ma ciò non stabilisce l'accoppiamento nativo di Microsoft. Dopo aver utilizzato il flusso, accoppia manualmente il cliente e l'account in Business Central se è richiesta una sincronizzazione nativa continua. Un numero cliente di Business Central da solo non è prova di accoppiamento.
Validazione dei valori delle opzioni
Gli ID dei valori enum di Business Central utilizzati per Termini di Pagamento, Metodo di Spedizione e Agente di Spedizione devono corrispondere agli ID opzione corrispondenti di Dataverse. Il testo visualizzato o l'etichetta del codice da soli non sono sufficienti. Una sincronizzazione completa non ripara una discrepanza di ID quando Business Central contiene valori enum personalizzati che non esistono in Dataverse.
- Esegui Sincronizza Record Modificati per TERMINI DI PAGAMENTO, METODO DI SPEDIZIONE e AGENTE DI SPEDIZIONE.
- Ispeziona Mappatura Opzioni Dataverse e il registro degli errori di sincronizzazione prima di testare il CLIENTE.
- Se gli ID non sono allineati, usa il valore predefinito sicuro sulla mappatura dei campi CLIENTE: Codice Termini di Pagamento → Termini di Pagamento = FromIntegrationTable; Codice Metodo di Spedizione → Indirizzo 1: Termini di Trasporto = FromIntegrationTable; Codice Agente di Spedizione → Indirizzo 1: Metodo di Spedizione = FromIntegrationTable.
- Cambia quei tre campi in Bidirezionale solo dopo che uno sviluppatore ha aggiunto ID opzione corrispondenti su entrambi i lati.
- Non inventare o rinumerare gli ID opzione durante la configurazione. I valori personalizzati di Dataverse e le estensioni enum di Business Central devono utilizzare esattamente gli stessi ID.
Torna alla scheda di Business Central nel tuo browser che abbiamo lasciato aperta.
1. Clicca sulla scheda “Integrazione”
2. poi “Mappature Tabelle di Integrazione”
Decisione del cliente: mantieni VENDITORI se il cliente desidera la sincronizzazione standard utente-Dataverse-venditore di Microsoft. Elimina o disabilita questa mappatura solo quando quella sincronizzazione standard non è intenzionalmente utilizzata.
1. Seleziona CONTATTO
2. Seleziona Accoppiamento
3. Poi clicca “Accoppiamento Basato su Corrispondenza”.
4. Corrispondi quanto sopra e clicca OK
1. Seleziona VALUTA
2. Seleziona Accoppiamento
3. Poi clicca “Accoppiamento Basato su Corrispondenza”.
4. Corrispondi quanto sopra e clicca OK
Per CLIENTE Seleziona Mappatura/Campi
1. Seleziona “Modifica Elenco”
2. e “abilita” Numero di account.
Ancora per CLIENTE, seleziona Accoppiamento/Accoppiamento Basato su Corrispondenza. Corrispondi utilizzando i campi identificatori cliente/account mostrati nello screenshot, e conferma che i campi corrispondenti identificano univocamente lo stesso cliente su entrambi i lati.
Per TERMINI DI PAGAMENTO, seleziona Accoppiamento/Accoppiamento Basato su Corrispondenza. Corrispondi i record dei termini di pagamento di Business Central ai valori opzione dei termini di pagamento corrispondenti di Dataverse tramite gli ID configurati.
Per METODO DI SPEDIZIONE, seleziona Accoppiamento/Accoppiamento Basato su Corrispondenza. Corrispondi i metodi di spedizione di Business Central ai valori opzione dei termini di trasporto corrispondenti di Dataverse tramite gli ID configurati.
Per AGENTE DI SPEDIZIONE, seleziona Accoppiamento/Accoppiamento Basato su Corrispondenza. Corrispondi gli agenti di spedizione di Business Central ai valori opzione del metodo di spedizione corrispondenti di Dataverse tramite gli ID configurati.
Per FORNITORE Seleziona Mappatura/Campi
1. Seleziona “Modifica Elenco”
2. e “abilita” Numero di account.
Ancora per FORNITORE, seleziona Accoppiamento/Accoppiamento Basato su Corrispondenza. Corrispondi utilizzando i campi identificatori fornitore/account mostrati nello screenshot, e conferma che i campi corrispondenti identificano univocamente lo stesso fornitore su entrambi i lati.
Passo 7: Collega gli Ambienti (Opzionale)
Requisito opzionale di collegamento degli ambienti
Collega gli ambienti solo quando l'ambiente Business Central e l'ambiente Power Platform sono dello stesso tipo di ambiente, come produzione-a-produzione o sandbox-a-sandbox, e si trovano nella stessa geografia di Azure.
Per evitare che qualcuno elimini accidentalmente gli ambienti, puoi collegarli. Inizia di nuovo in Business Central.
1. Seleziona l'icona Ingranaggio
2. Poi seleziona Centro Amministrativo
Seleziona il link dell'ambiente di destinazione
Clicca su “Collega” e seleziona il tuo ambiente Dataverse
Passo 8: Installa l'Addon di Business Central per RapidStart CRM da AppSource
Conferma la fondazione richiesta prima di installare l'addon
RapidStart CRM e il supporto per le Tabelle Virtuali di Microsoft Business Central devono essere installati prima. Verifica le tabelle virtuali di Business Central richieste e i valori di connessione prima di continuare. Il collegamento opzionale degli ambienti non deve essere completato per questa installazione da AppSource.
Clicca questo link per aprire AppSource di Microsoft e conferma di essere connesso con il tuo account aziendale.
Seleziona “Ottienilo ora” per avviare l'installazione.
1. Seleziona l'ambiente in cui hai installato la soluzione Tabelle Virtuali.
2. Accetta i termini.
3. Clicca Installa. Nota che l'installazione potrebbe richiedere diversi minuti.
Vedrai che la soluzione è “In installazione”. Questo potrebbe richiedere diversi minuti per completarsi. Occasionalmente clicca “aggiorna” fino a quando non vedi che è “Installata”.
Passo 9: Completa nell'app Impostazioni RapidStart
Vai a RapidStart CRM e seleziona l'App Impostazioni RapidStart.
Puoi aprire l'app Impostazioni RapidStart dal Selettore App in RapidStart CRM, o dal portale del creatore:
1. Seleziona App nella barra laterale.
2. Clicca sull'icona Esegui per l'app Impostazioni RapidStart.
1. Conferma di essere nell'App Impostazioni RapidStart.
2. Seleziona “App e Addon” nella barra laterale.
3. Clicca “Configura” per l'Addon di Business Central.
Usa questo wizard per completare eventuali elementi mancanti e gestire il connettore.
Risoluzione dei Problemi
ID di connessione mancanti
Se un flusso segnala un ID di connessione mancante, ripara i riferimenti di connessione Dataverse e Business Central nell'app Impostazioni RapidStart o in Power Automate, quindi riattiva il flusso. Ricreare una connessione da solo non è sufficiente se il riferimento di connessione è ancora legato alla vecchia connessione.
Errori di mappatura della valuta
Se la sincronizzazione del CLIENTE fallisce sulla valuta, ripristina o verifica la mappatura VALUTA, conferma che Codice → Codice Valuta sia abilitato, sincronizza le valute e conferma che la valuta del cliente esista in Dataverse prima di riprovare il CLIENTE.
Discrepanze delle opzioni
Se la sincronizzazione fallisce perché un valore di Termini di Pagamento, Metodo di Spedizione o Agente di Spedizione è al di fuori dell'intervallo valido di Dataverse, l'ID del valore enum di Business Central non corrisponde a un ID opzione di Dataverse. Usa FromIntegrationTable per la mappatura del campo CLIENTE interessato fino a quando gli ID corrispondenti non sono distribuiti.
Accoppiamenti che puntano a record eliminati
Se un record appare accoppiato ma la sincronizzazione punta a un record eliminato o mancante, rimuovi l'accoppiamento obsoleto in Business Central e crea un nuovo accoppiamento con l'account o il contatto Dataverse corretto prima di eseguire nuovamente la sincronizzazione.
Distribuzione Completa
Se ci sono problemi con questa documentazione, per favore faccelo sapere.