Yhdistä Microsoft Dataverse:hin

Huomautus

Azure Active Directory on nyt Microsoft Entra ID. Lisätietoja

Tässä artikkelissa käsitellään Business Centralin ja Dataversen välisen yhteyden määrittämistä. Yleensä yritykset luovat yhteyden integroidakseen ja synkronoidakseen tietoja toisen Dynamics 365 -liiketoimintasovelluksen kanssa. Sovellus voi olla esimerkiksi Dynamics 365 Sales.

Ennen kuin aloitat

Ennen yhteyden luomista tarvitaan seuraavat tiedot:

• Sen Dataverse -ympäristön URL-osoite, johon haluat muodostaa yhteyden. Jos luot yhteyden avusteisen Dataverse -yhteyden määritys -asennusoppaan avulla, löydät ympäristösi. Voit myös syöttää vuokralaisen toisen ympäristön URL-osoitteen.
• Sen tilin käyttäjätili ja salasana, jolla on järjestelmänvalvojan oikeudet Business Centralissa ja Dataversessa.
• Jos käytössäsi on vuoden 2020 1. julkaisuaallon Business Central on-premises -versio 16.5, lue Joitakin tunnettuja ongelmia -artikkeli. Sinun on toteutettava kuvattu kiertotapa, ennen kuin voit luoda yhteyden Dataverseen.
• Kunkin yrityksen käyttämät paikalliset valuutat. Business Central -yritykset voidaan yhdistää Dataverse-ympäristöön, jonka perusvaluutta on jokin muu kuin paikallinen valuutta. Jos haluat lisätietoja usean valuutan asetusten käsittelemisestä, siirry kohtaan Eri valuuttojen salliminen.

Tärkeää

Dataverse -ympäristösi ei saa olla järjestelmänvalvojan tilassa. Järjestelmänvalvojan tila aiheuttaa yhteyden epäonnistumisen, koska yhteyden integrointikäyttäjätilillä ei ole järjestelmänvalvojan käyttöoikeuksia. Lisätietoja on kohdassa Järjestelmänvalvojan tila.

Huomautus

Seuraavat vaiheet koskevat Business Central Online -versiota. Jos käytössä on paikallinen Business Central eikä Microsoft Entra -tiliä käytetä muodostamaan yhteyttä Dataverseen, integrointia varten on määritettävä käyttäjätilin käyttäjänimi ja salasana. Tätä tiliä kutsutaan integroinnin käyttäjän tiliksi. Microsoft Entra -tiliä käytettäessä integroinnin käyttäjän tiliä ei tarvita eikä sitä näytetä. Integroinnin käyttäjä määritetään automaattisesti, eikä sitä varten tarvita käyttöoikeutta.

Business Central- ja Dataverse-ympäristöjen linkittäminen

Yritykset haluavat pitää tietonsa turvallisesti suojattuina tietosuojarajan sisällä etenkin silloin, kun liiketoiminnan hallintasovellus integroituu muihin sovelluksiin. Business Central- ja Dataverse-ympäristöjen linkittäminen ei ota huomioon ainoastaan näitä seikkoja vaan helpottaa järjestelmänvalvojien työtä, kun he luovat ja ylläpitävät muiden Dynamics 365 -sovellusten kanssa tehtyjä integrointeja.

Business Central -ympäristö voidaan linkittää Dataverse-ympäristöön Business Centralin hallintakeskuksessa. Business Central voi käyttää linkkien tietoja helpottamaan muiden Dynamics 365 -sovellusten, kuten Salesin ja Field Servicen, kanssa tehtäviä turvallisia integrointeja. Esimerkiksi linkitetyn Dataverse-ympäristön URL-osoite on saatavana oletusarvoisesti Dataverse-yhteyden asetukset -sivulla ja suoritettaessa ohjattua Dataverse-yhteyden asetukset -määritystä.

Eri valuuttojen salliminen

Business Central -yritykset voidaan yhdistää Dataverse-ympäristöön, jonka perusvaluutta on jokin muu kuin paikallinen valuutta.

Huomautus

Useiden valuuttojen synkronointi edellyttää, että käytetään yksisuuntaista synkronointia Business Centralista Dataverseen.

Jos haluat lisätietoja perusvaluutasta kohteessa Dataverse, siirry kohtaan Tapahtuman valuutta (valuutta) -entiteetti.

Lisätietoja Business Centralin valuutoista on kohdassa Business Centralin valuutat.

Jos haluat sallia eri valuutat ennen yhteyden muodostamista, varmista, että olet määrittänyt seuraavat asetukset:

• Dataversen perustapahtumavaluutta-asetuksen valuuttakoodi on määritetty Business Centralin Valuutat-sivulla.
• Valuutan vaihtokurssit -sivulla on vähintään yksi Business Centralin valuutan vaihtokurssi määritettynä.

Kun yhteys Dataverseen otetaan käyttöön, Business Central lisää paikallisen valuutan Valuutta-entiteettiin Dataversessa. Paikallinen valuutta käyttää Valuutan vaihtokurssit -sivun Valuuttakerroin-kentän vaihtokurssia.

Koska valuutan synkronointi on yksisuuntaista Business Centralista Dataversessa, rahamääräiset summat muunnetaan ja synkronoidaan seuraavasti:

• Jos Dataversessa perusvaluutta, summat muunnetaan Business Centralin paikalliseksi valuutaksi Business Centralista synkronoidun uusimman vaihtokurssin perusteella.
• Jos Business Centralin paikallinen valuutta, summat synkronoidaan Business Centralin paikallisen valuutan kanssa jonakin muuna, ei perusvaluuttana Dataversessa.

Määritä yhteys tuotteeseen Dataverse

Microsoft 365 -todennustyyppiä lukuun ottamatta Dataverse -yhteys määritetään kaikissa todennustyypeissä Dataverse -yhteyden määritys -sivulla. Microsoft 365 -todennuksessa on suositeltavaa käyttää Dataverse-yhteyden määrityksen asetusten ohjattua määritysopasta. Opas auttaa määrittämään nopeasti yhteyden ja lisäominaisuudet, kuten omistajamallin ja ensimmäisen synkronoinnin.

Tärkeää

Dataverse-yhteyttä määritettäessä järjestelmänvalvojaa pyydetään antamaan seuraavat käyttöoikeudet rekisteröidylle Azuren Business Central Integration to Dataverse -sovellukselle:

• Dataversen käyttö sinuna -käyttöoikeus tarvitaan, jotta Business Central voi luoda järjestelmänvalvojan puolesta automaattisesti Business Centralin integrointisovelluksen käyttäjän, jolla ei ole käyttö- eikä vuorovaikutusoikeutta, sekä määrittää käyttöoikeusroolit kyseiselle käyttäjälle ja ottaa käyttöön Business Central -integrointiratkaisun Dataverseen. Tätä käyttöoikeutta käytetään vain kerran määritettäessä yhteyttä Dataverseen.
• Täydet Dynamics 365 Business Central -käyttöoikeudet tarvitaan, jotta automaattisesti luotu Business Central -integrointisovelluksen käyttäjä voi käyttää synkronoitavia Business Centralin tietoja.
• Kirjautuminen ja profiilin lukeminen -käyttöoikeus tarvitaan varmistamaan, että kirjautuvalle käyttäjälle on määritetty järjestelmänvalvojan käyttöoikeusrooli Dataversessa.

Antamalla suostumuksen organisaation puolesta järjestelmänvalvoja antaa Business Central Integration to Dataverse -nimiselle Azure-sovelluksen oikeuden synkronoida tietoja käyttämällä automaattisesti luodun Business Central Integration -sovelluskäyttäjän tunnistetietoja.

Dataverse -yhteyden määrityksen asetusten ohjatun määritysoppaan käyttäminen

Dataverse -yhteyden asetusopas helpottaa sovellusten yhdistämistä, ja se voi auttaa sinua myös suorittamaan ensimmäisen synkronoinnin. Jos päätät käynnistää ensimmäisen synkronoinnin, Business Central tarkistaa molempien sovellusten tiedot ja antaa suosituksia ensimmäisen synkronoinnin toteutusta varten. Seuraavassa taulukossa kuvaillaan näitä suosituksia.

Suositus	Kuvaus
Täysi synkronointi	Tietoja on vain Business Centralissa tai vain Dataversessa. Suositus on synkronoida toiseen palveluun kaikki tiedot palvelusta, jossa tiedot ovat.
Ei synkronointia	Molemmissa sovelluksissa on tietoja, ja täyden synkronoinnin suorittaminen loisi tietojen kaksoiskappaleita. Suositus on yhdistää tietueet.
Riippuvuus ei täyty	Molemmissa sovelluksissa on tietoja, mutta riviä tai taulukkoa ei voi synkronoida, koska se riippuu rivistä tai taulukosta, jossa on Ei synkronointia -suositus. Jos esimerkiksi asiakkaita ei voi synkronoida, asiakastiedoista riippuvien kontaktien tietoja ei voi myöskään synkronoida.

Tärkeää

Yleensä täysi synkronointi on käytössä vain, kun sovellukset integroidaan ensimmäistä kertaa ja vain yksi sovellus sisältää tietoja. Täydellisestä synkronoinnista voi olla hyötyä demoympäristössä, koska se luo ja yhdistää tietueet automaattisesti kummassakin sovelluksessa, minkä ansiosta synkronoitujen tietojen käsittelemisen aloittaminen nopeutuu. Suorita täysi synkronointi kuitenkin vain, jos haluat taulukon yhdistämismäärityksille yhden rivin Business Centralissa kutakin Dataversen riviä kohden. Muussa tapauksessa tuloksena voi olla tietueiden kaksoiskappaleita.

1. Valitse -kuvake, kirjoita Avustettu asetusten määritys ja valitse liittyvä linkki.
2. Käynnistä asetusten ohjattu määritys valitsemalla Microsoft Dataverse -yhteyden määritys.
3. Täytä tarvittavat kentät.

Huomautus

Jos sinua ei pyydetä käyttämään kirjautumiseen järjestelmänvalvojan tiliä, syynä on luultavasti estetyt ponnahdusikkunat. Kirjautumista varten on sallittava ponnahdusikkunat osoitteesta https://login.microsoftonline.com.

Yhteyden luominen tai ylläpitäminen manuaalisesti

Seuraavassa kerrotaan, miten yhteys määritetään manuaalisesti Dataverse -yhteyden määritys -sivulla. Dataverse-yhteyden määritys -sivulla hallitaan integroinnin asetuksia.

1. Valitse -kuvake, kirjoita Dataverse-yhteysasetukset ja valitse liittyvä linkki.

2. Anna seuraavat tiedot yhteyden muodostamiseen Business Centralista Dataverseen.

   Kenttä	Kuvaus
   Ympäristön URL-osoite	Jos Dataverse:ssä on omia ympäristöjä, ne löytyvät ohjatun määrityksen suorittamisen yhteydessä. Jos haluat muodostaa yhteyden toiseen ympäristöön eri vuokraajassa, voit syöttää ympäristön järjestelmänvalvojan tunnistetiedot. Ympäristö löytyy niiden avulla.
   Käytössä	Aloita integroinnin käyttäminen. Jos et ota yhteyttä käyttöön nyt, yhteysasetukset tallennetaan. Käyttäjät eivät kuitenkaan voi käyttää Dataversen tietoja Business Centralista. Voit palata tälle sivulle myöhemmin ottamaan yhteyden käyttöön.

3. Valitse Omistusmalli-kentässä, haluatko Dataverse:n tiimitaulukon vai jonkin tietyn käyttäjän omistavan uudet tietueet. Jos valitset Henkilö-kohdan, sinun täytyy määrittää jokainen käyttäjä. Jos valitset Tiimi-kohdan oletusliiketoimintayksikkö näkyy Yhdistetty liiketoimintayksikkö -kentässä.

4. Jos haluat testata yhteysasetukset, valitse Yhteys ja valitse sitten Testaa yhteys.

   Huomautus

   Jos tietojen salaus ei ole käytössä Business Centralissa, sinulta kysytään, haluatko ottaa sen käyttöön. Ota tietojen salaus käyttöön valitsemalla Kyllä ja määritä tarvittavat tiedot. Valitse muussa tapauksessa Ei. Voit ottaa tietojen salauksen käyttöön myöhemmin. Lisätietoja on kehittäjän ja järjestelmänvalvojan ohjeen kohdassa Tietojen salaus Dynamics 365 Business Centralissa.

5. Jos Dataversen synkronointia ei ole määritetty, sinulta kysytään, haluatko käyttää oletussynkronointiasetuksia. Valitse Kyllä tai Ei sen mukaan, haluatko pitää Dataversen ja Business Centralin tietueet kohdistettuina.

Vastaavuuteen perustuvan yhdistämisen mukauttaminen

Alkaen vuoden 2021 2. julkaisuaallosta voit yhdistää tietueita ylläpitäjän määrittelemien vastaavuuskriteerien perusteella. Tietueiden vastaavuuden algoritmi voidaan aloittaa seuraavista paikoista Business Centralissa:

• Luettelosivut, jotka näyttävät Dataversen kanssa synkronoitavia tietueita , kuten Asiakkaat- ja Nimikkeet-sivut.

  Valitse monta tietuetta ja valitse sitten Liittyvä-toiminto, valitse Dataverse, valitse Yhdistäminen ja valitse sitten Vastaavuuspohjainen yhdistäminen.

  Kun vastaavuuspohjainen yhdistämisprosessi aloitetaan päätietoluettelosta, yhdistämistyö ajoitetaan sen jälkeen, kun olet määrittänyt yhdistämiskriteerit.

• Täyden Dataverse-synkr. tarkistus -sivu.

  Kun täyden synkronoinnin prosessi havaitsee, että ei-sidottuja tietueita on sekä Business Centralissa että Dataversessa, Valitse yhdistämisehdot -linkki näkyy integrointitaulukon kohdalla.

  Voit käynnistää Suorita täysi synkronointi -toiminnon Dataverse-yhteyden määritys- ja Dynamics 365 -yhteyden määritys -sivuilta. Voit käynnistää sen myös Määritä yhteys Dataverseen -avustetussa asennusoppaassa, kun suoritat asetukset.

  Kun vastaavuuspohjainen yhdistämisprosessi aloitetaan Täyden Dataverse-synkr. tarkistus -sivulta, yhdistämistyö ajoitetaan sen jälkeen, kun määritys on valmis.

• Integrointitaulukon yhdistämismääritysluettelo.

  Valitse yhdistämismääritys, sitten Yhdistäminen-toiminto ja valitse sitten Vastaavuuspohjainen yhdistäminen.

  Kun vastaavuuspohjainen yhdistämisprosessi aloitetaan integrointitaulukon yhdistämismäärityksestä, kaikki kyseisen yhdistämismäärityksen yhdistelemättömien tietueiden yhdistämistyöt suoritetaan. Voit myös valita ei-sidotut tietueet luettelosta, jos haluat suorittaa työn vain kyseisille tietueille.

Kaikissa kolmessa tapauksessa Valitse yhdistämisehdot -sivu avautuu, jotta voit määrittää asianmukaiset kytkentäkriteerit. Mukauta tällä sivulla kytkentä seuraavien tehtävien avulla:

• Valitse kentät, joiden avulla Business Central -tietueet täsmäytetään Dataverse-entiteettien kanssa. Voit määrittää, onko vastaavuushaussa isot ja pienet kirjaimet merkityksellisiä.

• Määrittää, synkronoidaanko sen jälkeen, kun tietueet on yhdistetty. Jos tietueet käyttävät kaksisuuntaista yhdistämistä, voit myös määrittää, mitä tapahtuu, jos ristiriidat on luetteloitu Ratkaise päivitysristiriidat -sivulla.

• Priorisoi tietueiden hakujärjestystä määrittämällä asianmukaisten yhdistettävien kenttien vastaavuusprioriteetti. Business Central etsii vastaavuutta nousevassa järjestyksessä Vastaavuuden prioriteetti -kentän arvon perusteella. Vastaavuuden prioriteetti -kentässä on tyhjä arvo on sama kuin prioriteetti 0, joka on korkein prioriteetti. Kentät, joiden prioriteetti on 0, otetaan ensin huomioon.

• Määrittää, luodaanko uusi entiteettiesiintymä Dataverseissa siinä tapauksessa, että hakuehdoilla ei löydy yksilöllistä yhdistämättä olevaa vastaavuutta. Voit aktivoida tämän ominaisuuden valitsemalla Luo uusi, jos ei löydy vastaavuutta -toiminto.

Yhdistämistyön tulosten tarkasteleminen

Jos haluat tarkastella yhdistämistyön tuloksia, avaa Integrointitaulukon yhdistämismääritykset -sivu, valitse haluamasi linkitys, valitse Yhdistäminen-toiminto ja valitse sitten Integroinnin yhdistämistyön loki -toiminto.

Jos tietueiden yhdistäminen ei onnistunut, voit valita Epäonnistunut-sarakkeen arvon, jolloin näyttöön tulee virheluettelo, joka kuvaa tapahtunutta.

Yleensä yhdistäminen epäonnistuu seuraavista syistä:

• Vastaavuuskriteerejä ei ole määritetty

  Suorita vastaavuuspohjainen yhdistäminen uudelleen, mutta muista määrittää yhdistämiskriteerit.

• Vastaavuusehdoissa määritetyille kentille ei löytynyt vastaavuutta

  Toista yhdistäminen käyttäen eri kenttiä.

• Useista tietueista löytyi useita vastaavuuksia vastaavuusehdoissa määriteltyjen kenttien perusteella

  Toista yhdistäminen käyttäen eri kenttiä.

• Löytyi vastine, mutta tietue on jo liitetty toiseen tietueeseen Business Centralissa

  Toista kytkentä jollakin muulla kentällä tai tutki, miksi kyseinen Dataverse-entiteetti on liitetty kyseiseen tietueeseen Business Centralissa.

Vinkki

Jotta saat yleiskuvan yhdistämisen edistymisestä, Yhdistetty Dataverseen -kentässä näkyy, onko tietue liitetty Dataverse -kohteeseen. Yhdistetty Dataverseen -kentän avulla voit suodattaa synkronoitavien tietueiden luettelon.

Päivitä yhteydet Business Central Onlinesta käyttääksesi varmennepohjaista todennusta

Huomautus

Tämä osa on merkityksellinen vain Microsoftin isännöimille Business Central online -vuokraajille. Tämä ei vaikuta ISV-isännöityihin online-vuokralaisiin tai paikan päällä tehtyihin asennuksiin.

Huhtikuussa 2022 Dataverseissa vanhentuu Office365-todennustyyppi (käyttäjänimi/salasana). Lisätietoja on kohdassa Office365-todennustyypin vanheneminen. Lisäksi maaliskuussa 2022 Business Centralissa vanhentuu asiakasohjelmien salaisuuteen perustuva palveluiden välinen todennus online-vuokralaisille. Sinun on käytettävä varmennepohjaista palveluiden väliselle todennukselle Dataverse -yhteyksille. ISV-toimittajien isännöimät Business Central Online -vuokralaiset ja paikalliset asennukset voivat edelleen käyttää asiakkaan salaisuuksia todennukseen.

Jotta integraatiot eivät häiriinny, yhteys on päivitettävä käyttämään varmennepohjaista todennusta. Vaikka muutos ajoittuu maaliskuulle 2022, suosittelemme, että päivität mahdollisimman pian. Seuraavissa vaiheissa kuvataan, miten varmennepohjaiseen todennukseen päivitetään.

Business Central online -yhteyden päivittäminen käyttämään varmennepohjaista todennusta

1. Tee jokin seuraavista toimista sen mukaan, integroitko Dynamics 365 Salesiin:
   • Jos kyllä, avaa Microsoft Dynamics 365 -yhteysasetukset -sivu.
   • Jos ei, avaa Dataverse-yhteysasetukset-sivu.
2. Valitse Yhteys ja sitten Käytä varmennetodennusta päivittääksesi yhteyden käyttämään varmennepohjaista todennusta.
3. Kirjaudu sisään Dataverse-järjestelmänvalvojan tunnistetiedoilla. Sisäänkirjautumisen pitäisi kestää alle minuutin.

Huomautus

Nämä vaiheet on toistettava jokaisessa Business Central -ympäristössä, mukaan lukien tuotanto- ja eristysympäristöt ja jokaisessa yrityksessä, jolla on yhteys Dataverseen.

Paikallisten versioiden yhdistäminen

Business Central on-premises -version yhdistäminen Dataverseen edellyttää, että Dataverse -yhteyden määritys -sivulla määritetään joitakin tietoja.

Jotta voisit muodostaa yhteyden Microsoft Entra -tilin avulla, sinun täytyy rekisteröidä sovellus Microsoft Entra ID:ssä. Anna sovelluksen tunnus, avainsäilön salaisuus ja uudelleenohjauksen URL-osoite. Uudelleenohjauksen URL-osoite täytetään valmiiksi, ja sen pitäisi toimia useimmissa asennuksissa. Asennus on määritettävä käyttämään HTTPS-yhteyttä. Lisätietoja on kohdassa SSL:n määrittäminen suojaamaan Business Centralin verkkoasiakasohjelman yhteyttä. Jos palvelimelle määritetään jokin muu aloitussivu, URL-osoitteen voi vaihtaa. Asiakasohjelman salaisuus tallennetaan tietokantaan salattuna merkkijonona.

Sovelluksen rekisteröiminen Microsoft Entra ID:ssä muodostamaan yhteys Business Centralista Dataverseen

Seuraavissa vaiheissa oletetaan, käyttäjätietojen ja käyttöoikeuksien hallintaan käytetään Microsoft Entra ID:tä. Lisätietoja sovelluksen rekisteröimisestä Microsoft Entra ID:ssä on kohdassa Pika-aloitus: sovelluksen rekisteröinti Microsoftin käyttäjätietoympäristössä.

1. Valitse Azure-portaalin Hallinta-kohdan siirtymisruudussa Todennus.

2. Lisää Uudelleenohjauksen URL-osoite -kohdassa Business Centralin Dataverse -yhteyden määritys -sivulla ehdotettu uudelleenohjauksen URL-osoite.

3. Valitse Hallinta-kohdassa API-käyttöoikeudet.

4. Valitse Määritetyt käyttöoikeudet -kohdassa Lisää käyttöoikeus ja lisää sitten delegoidut käyttöoikeudet Microsoftin API:t -välilehdessä seuraavasti:

   • Business Central: lisää Financials.ReadWrite.All-käyttöoikeudet.
   • Dynamics CRM: lisää user_impersonation-käyttöoikeudet.

   Huomautus

   Dynamics CRM -API:n nimi voi muuttua.

5. Valitse Hallinta-kohdassa Varmenteet ja salaiset avaimet ja lue sitten sovellukselle uusi salaisuus. Salaista avainta joko käytetään Business Centralin Dataverse -yhteyden määritys -sivun Asiakasohjelman salainen avain -kentässä tai se tallennetaan suojattuun tallennustilaan, josta se annetaan tapahtumaan tilaajassa aiemmin tässä aiheessa kuvatulla tavalla.

6. Valitse Yleiskuvaus ja etsi sitten Sovelluksen (asiakasohjelman) tunnus -arvo. Tämä tunnus on sovelluksen asiakasohjelman tunnus. Se on joko annettava Dataverse -yhteyden määritys -sivun Asiakasohjelman tunnus -kentässä tai tallennettava suojattuun tallennustilaan tapahtuman tilaajassa annettavaksi.

7. Anna Business Centralin Dataverse -yhteyden määritys -sivun Ympäristön URL-osoite -kentässä Dataverse-ympäristön URL-osoite.

8. Dataverse -yhteys otetaan käyttöön Käytössä-valitsimella.

9. Käytä kirjautumiseen Microsoft Entra ID:n järjestelmänvalvojan tiliä. (Tämä tili tarvitsee voimassaolevan Dataversen käyttöoikeuden, ja sen on oltava Dataverse -ympäristön järjestelmänvalvoja.) Kirjautumisen jälkeen sinua pyydetään antamaan rekisteröidylle sovellukselle lupa kirjautua Dataverseen organisaation puolesta. Määrityksen valmistumisen edellyttää tämän luvan antamista.

   Huomautus

   Jos sinua ei pyydetä käyttämään kirjautumiseen järjestelmänvalvojan tiliä, syynä on luultavasti estetyt ponnahdusikkunat. Kirjautumista varten on sallittava ponnahdusikkunat osoitteesta https://login.microsoftonline.com.

Dataverse -yhteyden katkaiseminen

1. Valitse -kuvake, kirjoita Dataverse-yhteysasetukset ja valitse liittyvä linkki.
2. Poista käytöstä Dataverse -yhteyden määritys -sivulla Käytössä-valitsin.

Katso myös

Synkronoinnin tilan näyttäminen

Business Centralin maksuttoman verkko-oppimissisällön etsiminen