Conectarea la Microsoft Dataverse

Notă

Începând cu noiembrie 2020:

  • Common Data Service a fost redenumit în Microsoft Dataverse. Aflați mai multe
  • Unele terminologii din Microsoft Dataverse au fost actualizate. De exemplu, entitatea este acum tabel și câmpul este acum coloană. Aflați mai multe

Acest subiect descrie se confiție o conexiune între Business Central și Dataverse. De obicei, firmele creează conexiunea pentru a integra și sincroniza datele cu o altă aplicație de business Dynamics 365, ar fi Dynamics 365 Sales.

Înainte de a începe

Există câteva informații de pregătit înainte de a crea conexiunea:

  • URL-ul pentru mediul Dataverse la care doriți să vă conectați. Dacă utilizați ghidul de configurare asistată de configurare dataverse Connection Setup pentru a crea conexiunea, vom descoperi mediile dvs., dar puteți introduce, de asemenea, URL-ul altui mediu din entitatea găzduită.
  • Numele de utilizator și parola unui cont care are permisiuni de administrator în Business Central și Dataverse.
  • Dacă aveți un val de lansare Business Central 2020 local, versiunea 16.5, citiți articolul Unele probleme cunoscute. Va trebui să finalizați soluția descrisă înainte de a crea conexiunea la Dataverse.
Important

Mediul Dataverse nu trebuie să fie în modul Administrare. Modul de administrare va provoca conexiunea să nu reușească, deoarece contul de utilizator de integrare pentru conexiune nu are permisiuni de administrator. Pentru mai multe informații, consultați Modul administrare.

Notă

Acești pași descriu procedura pentru Business Central online. Dacă utilizați Business Central local și nu utilizați contul Azure Active Directory pentru a vă conecta la Dataverse, trebuie să specificați, de asemenea, un nume de utilizator și o parolă a unui cont de utilizator pentru integrare. Acest cont este denumit cont "utilizator de integrare". Dacă utilizați un cont Azure Active Directory, contul de utilizator de integrare nu este necesar sau afișat. Utilizatorul de integrare va fi configurat automat și nu necesită o licență.

Configurarea unei conexiuni la Dataverse

Pentru toate tipurile de autentificare, altele decât autentificarea Microsoft 365, configurați conexiunea la Dataverse în pagina Inițializare conexiune Dataverse. Pentru autentificarea Microsoft 365, vă recomandăm să utilizați ghidul de instalare asistată de dataverse Connection Setup. Ghidul facilitează configurarea conexiunii și specificarea caracteristicilor complexe, ar fi modelul de proprietate și sincronizarea inițială.

Important

În timpul configurării conexiunii la Dataverse, administratorului i se va solicita să acorde următoarele permisiuni unei aplicații Azure înregistrate numită Business Central Integration la Dataverse:

  • Access Dataverse pe măsură ce este necesară permisiunea, astfel încât Business Central să poată, în numele administratorului, să creeze automat utilizator de aplicație Business Central Integration neinteractiv neinter licențiat, să atribuie roluri de securitate acestui utilizator și să implementeze Business Central Integration Solution către Dataverse. Această permisiune se utilizează o singură dată în timpul setării conexiunii la Dataverse.
  • Aveți acces complet la permisiunea Dynamics 365 Business Central este necesară, astfel încât utilizatorul aplicației Business Central Integration creată automat să poată accesa datele Business Central care vor fi sincronizate.
  • Conectați-vă și citiți permisiunea de profil este necesară pentru a verifica dacă conectarea utilizatorului are de fapt rolul de securitate administrator de sistem atribuit în Dataverse.

Prin acordarea consimțământului în numele organizației, administratorul conferă aplicației Azure înregistrate, denumită Integrare centrală de afaceri, dataverse pentru a sincroniza datele utilizând acreditările utilizatorului aplicației Business Central Integration creată automat.

Pentru a utiliza ghidul de configurare asistată de configurare a instalării conexiunii Dataverse

Ghidul de instalare a conexiunii Dataverse poate facilita conectarea aplicațiilor și vă poate ajuta chiar să executați o sincronizare inițială. Dacă alegeți să executați sincronizarea inițială, Business Central va revizui datele din ambele aplicații și va furniza recomandări pentru abordarea sincronizării inițiale. Următorul tabel descrie recomandările.

Descriere recomandare
Sincronizare completă Datele există numai în Business Central sau numai în Dataverse. Recomandarea este de a sincroniza toate datele de la serviciul care le are la celălalt serviciu.
Fără sincronizare Datele există în ambele aplicații, iar executarea sincronizării complete ar duplica datele. Recomandarea este de a cuplu înregistrări.
Dependență nefiind satisfăcută Datele există în ambele aplicații, dar rândul sau tabelul nu se poate sincroniza, deoarece depinde de un rând sau tabel care are recomandarea Fără sincronizare. De exemplu, dacă clienții nu pot fi sincronizați, atunci nici datele pentru persoanele de contact care depind de datele clientului nu pot fi sincronizate.
Important

De obicei, utilizați sincronizarea completă numai atunci când integrați aplicațiile pentru prima dată și o singură aplicație conține date. Sincronizarea completă poate fi utilă într-un mediu demonstrativ, deoarece creează și grupează automat înregistrări în fiecare aplicație, ceea ce face mai rapidă începerea lucrului cu date sincronizate. Cu toate acestea, ar trebui să executați sincronizarea completă numai dacă doriți un rând în Business Central pentru fiecare rând din Dataverse pentru mapările de tabel. În caz contrar, rezultatul poate fi înregistrări dublate.

  1. Selectați Lightbulb that opens the Tell Me feature pictograma, introduceți Parametrizare asistată, apoi alegeți linkul corelat.
  2. Selectați Configurarea unei conexiuni la Microsoft Dataverse pentru a porni ghidul de configurare asistată.
  3. Completați câmpurile după este necesar.
Notă

Dacă nu vi se solicită să vă conectați cu contul de administrator, probabil că ferestrele pop-up sunt blocate. Pentru a vă conecta, permiteți ferestrelor pop-up din https://login.microsoftonline.com .

Pentru a crea sau întreține manual conexiunea

Următoarea procedură descrie modul de configurare manuală a conexiunii în pagina Parametrizare conexiune Dataverse. Aceasta este, de asemenea, pagina în care gestionați setările pentru integrare.

  1. Alegeți Lightbulb that opens the Tell Me feature pictograma, introduceți Configurare conexiune Dataverse, apoi alegeți linkul corelat.

  2. Introduceți următoarele informații pentru conexiunea de la Business Central la Dataverse.

    câmp
    Descriere
    URL mediu Dacă dețineți medii în Dataverse, le vom găsi atunci când executați ghidul de configurare. Dacă doriți să vă conectați la un alt mediu dintr-o altă entitate găzduită, puteți introduce acreditările de administrator pentru mediu și le vom descoperi.
    Activat Începeți să utilizați integrarea. Dacă nu activați conexiunea acum, setările de conexiune vor fi salvate, dar utilizatorii nu vor avea posibilitatea să acceseze datele Dataverse din Business Central. Aveți posibilitatea să reveniți la această pagină și să activați conexiunea mai târziu.

  3. În câmpul Model proprietate, alegeți dacă doriți ca un tabel de echipă din Dataverse să dețină înregistrări noi sau unul sau mai mulți utilizatori specifici. Dacă alegeți Persoană, trebuie să specificați fiecare utilizator. Dacă selectați Echipă, unitatea de business implicită se va afișa în câmpul Unitate de business cuplată.

    |

  4. Pentru a testa setările de conexiune, selectați Conexiune, apoi Testare conexiune.

    Notă

    Dacă criptarea datelor nu este activată în Business Central, veți fi întrebat dacă doriți să o activați. Pentru a activa criptarea datelor, alegeți Da și furnizați informațiile necesare. În caz contrar, selectați Nu. Aveți posibilitatea să activați criptarea datelor mai târziu. Pentru mai multe informații, consultați Criptarea datelor în Dynamics 365 Business Central în ajutorul pentru dezvoltatori și administrare.

  5. Dacă sincronizarea Dataverse nu este deja parametrizată, veți fi întrebat dacă doriți să utilizați parametrizarea implicită a sincronizării. În funcție de faptul dacă doriți să păstrați înregistrările aliniate în Dataverse și Business Central, selectați Da sau Nu.

Conectarea versiunilor locale

Pentru a conecta localul Business Central la Dataverse, trebuie să specificați unele informații în pagina Inițializare conexiune Dataverse.

Dacă doriți să vă conectați utilizând un cont Azure Active Directory (Azure AD), trebuie să înregistrați o aplicație în Azure AD și să furnizați ID-ul aplicației, secretul seifului cheii și URL-ul de redirecționare de utilizat. URL-ul de redirecționare este prepopulat și ar trebui să funcționeze pentru majoritatea instalărilor. Trebuie să configurați instalarea pentru a utiliza HTTPS. Pentru mai multe informații, consultați Configurarea SSL pentru a securiza conexiunea clientului Web Central business. Dacă configurați serverul să aibă o altă pagină de pornire, puteți oricând să modificați URL-ul. Secretul clientului va fi salvat ca șir criptat în baza de date.

Cerințe preliminare

Dataverse trebuie să utilizeze unul dintre următoarele tipuri de autentificare:

Pentru a înregistra o aplicație în Azure AD pentru conectarea de la Business Central la Dataverse

Următorii pași presupun că utilizați Azure AD pentru a gestiona identitățile și accesul. Pentru mai multe informații despre înregistrarea unei aplicații în Azure AD, consultați Quickstart: Înregistrarea unei aplicații cu platforma de identitate Microsoft. Dacă nu utilizați Azure AD, consultați Utilizarea altui serviciu de gestionare a identității și a accesului.

  1. În portalul Azure, sub Gestionare în Panoul de navigare, alegeți Autentificare.

  2. Sub Url-uri de redirecționare, adăugați URL-ul de redirecționare sugerat în pagina Inițializare conexiune Dataverse din Business Central.

  3. Sub Gestionare, alegeți permisiuni API.

  4. Sub Permisiuni configurate, alegeți Adăugare permisiune, apoi adăugați permisiuni delegate pe fila API-uri Microsoft, după urmează:

    • Pentru Business Central, adăugați permisiunile Financials.ReadWrite.All.
    • Pentru Dynamics CRM, adăugați permisiunile user_impersonation.
    Notă

    Este posibil ca numele API-ului Dynamics CRM să se modifice.

  5. Sub Gestionare, alegeți Certificate & Secrets, apoi creați un nou secret pentru aplicația dvs. Veți utiliza secretul fie în Business Central, în câmpul Secret client de pe pagina Inițializare conexiune Dataverse, fie îl stocați într-un spațiu de stocare securizat și îl furnizați într-un abonat de eveniment, așa este descris mai sus în acest subiect.

  6. Selectați Prezentare generală, apoi găsiți valoarea ID-ul aplicației (client). Acesta este ID-ul clientului aplicației dvs. Trebuie să îl introduceți fie în pagina Parametrizare conexiune Dataverse din câmpul ID client, fie să îl stocați într-un spațiu de stocare securizat și să îl furnizați într-un abonat de eveniment.

  7. În Business Central, în pagina Parametrizare conexiune Dataverse, în câmpul URL Mediu, introduceți URL-ul pentru mediul Dataverse.

  8. Pentru a activa conexiunea la Dataverse, activați comutatorul Activat.

  9. Conectați-vă cu contul de administrator pentru Azure Active Directory (acest cont trebuie să aibă o licență validă pentru Dataverse și să fie administrator în mediul Dataverse). După ce vă conectați, vi se va solicita să permiteți aplicației înregistrate să se conecteze la Dataverse în numele organizației. Trebuie să vă dați consimțământul pentru a finaliza configurarea.

    Notă

    Dacă nu vi se solicită să vă conectați cu contul de administrator, probabil că ferestrele pop-up sunt blocate. Pentru a vă conecta, permiteți ferestrelor pop-up din https://login.microsoftonline.com .

Utilizarea unui alt serviciu de gestionare a identității și accesului

Dacă nu utilizați Azure Active Directory pentru a gestiona identitățile și accesul, veți avea nevoie de ajutor de la un dezvoltator. Dacă preferați să stocați ID-ul aplicației și secretul într-o locație diferită, puteți lăsa necompletate câmpurile ID client și Client Secret și puteți scrie o extensie pentru a prelua ID-ul și secretul din locație. Puteți furniza secretul la runtime prin abonarea la evenimentele OnGetCDSConnectionClientId și OnGetCDSConnectionClientSecret în codeunit 7201 "CDS Integration Impl."

Pentru a vă deconecta de la Dataverse

  1. Alegeți Lightbulb that opens the Tell Me feature pictograma, introduceți Configurare conexiune Dataverse, apoi alegeți linkul corelat.
  2. Pe pagina Inițializare conexiune Dataverse, dezactivați comutarea activată.

A se vedea, de asemenea,

Vizualizarea stării unei sincronizări

Notă

Ne puteți spune despre preferințele dumneavoastră lingvistice de documentare? Fă un scurt sondaj.

Sondajul va dura aproximativ șapte minute. Nu sunt colectate date cu caracter personal(declarație de confidențialitate).