Ulkoisen lähteen tietoja sisältävän virtuaalisen entiteetin luominen tai muokkaaminen

Tässä ohjeaiheessa käsitellään Dynamics 365 Customer Engagement (on-premises) -sovellusta. Ohjeaiheen Power Apps -versio on täällä: Virtuaalisten entiteettien, jotka sisältävät ulkoisen tietolähteen tietoja, luominen ja muokkaaminen

Virtuaalinen entiteetti on Dynamics 365 Customer Engagement (on-premises):n mukautettu entiteetti, jonka kentät sisältävät tietoja ulkoisesta tietolähteestä. Virtuaaliset entiteetit näkyvät sovelluksen käyttäjille tavallisina entiteettitietueina, mutta ne sisältävät tietoja, jotka on noudettu ulkoisesta tietokannasta (esimerkiksi Azure SQL Databasesta). Virtuaalisiin entiteetteihin perustuvat tietueet ovat käytettävissä kaikissa asiakasohjelmissa, mukaan lukien mukautetut asiakasohjelmat, jota on kehitetty käyttämällä Dynamics 365 Customer Engagement -verkkopalveluita.

Menneisyydessä voidakseen integroida eri tietolähteitä niitä varten piti kehittää yhdysohjelma tietojen liikuttamiseen tai luoda mukautettu laajennus joko asiakas- tai palvelinpuolelle. Kuitenkin virtuaalientiteetteihin voi yhdistää suoraan ulkoisen tietolähteen suorituksen yhteydessä niin, että ulkoisesta lähteestä vaaditut tiedot ovat käytettävissä ympäristössä ilman tarvetta tietojen replikointiin.

Virtuaalientiteetit koostuvat kolmesta tärkeimästä osasta tietopalvelu, tietolähde tietue ja näennäisentiteetti. Tietojen toimittaja koostuu laajennuksista ja tietojen lähde-entiteetistä. Tietojen lähde on entiteettitietue Dynamics 365 Customer Engagement (on-premises):ssa, joka sisältää metatiedot, joka vastaa yhteyden parametrien rakennetta. Kukin näennäisentiteetti viittaa tietolähteeseen kohdemäärityksessä.

Dynamics 365 Customer Engagement (on-premises) sisältää OData-tietojen toimittajan, jonka avulla voi yhteyden muodostaa OData v4 -verkkopalveluun, joka käyttää ulkoisia tietoja.

Sovelluskehittäjät voivat myös muodostaa omat tietopalvelut. Tietopalvelut asennetaan ympäristöön ratkaisuna. Lisätietoja: Virtuaalientiteettien käytön aloittaminen

Näennäisentiteettiin edut

• Kehittäjät voivat toteuttaa laajennuksia ulkoisten tietojen lukemista varten Dynamics 365 Customer Engagement -verkkopalveluiden ja Customer Engagement -laajennuksen rekisteröintityökalun avulla.

• Järjestelmän mukauttajat valitsevat Dynamics 365 Customer Engagement (on-premises) tietolähdetietueen määrittää ja virtuaalientiteettien luomisen, joita voidaan käyttää ulkoisten tietojen näkemiseen kirjoittamatta yhtään koodia.

• Loppukäyttäjät tarkastelevat kenttien, ruudukkojen, hakutulosten sekä Fetch XML -pohjaisten raporttien ja koontinäyttöjen tietoja virtuaalisen entiteetin luomissa tietueissa.

Lisää tietolähde käyttämään virtuaalientiteettiä

Kehittäjät voivat luoda mukautettuja laajennuksia, jota käytetään virtuaalisen entiteetin tietolähteenä. Vaihtoehtoisesti voit käyttää annettua OData v4 -tietojen tarjoajaa. Lisätietoja: OData v4 -tietojen tarjoajan määritys, vaatimukset ja parhaat käytännöt

1. Siirry kohtaan Asetukset>Administration>Virtuaalisten entiteettien tietolähteet.

2. Valitse Toiminnot-työkalurivillä Uusi.

3. Valitse seuraavista tietolähteistä Valitse tietopalvelu-valintaikkunassa ja valitse sitten OK.

   • Mukautettujen tietojen tarjoaja. Jos olet tuonut tietopalvelulaajennuksen, tietopalvelu tulee näkyviin tähän. Lisätietoja: Virtuaalientiteettien käytön aloittaminen

   • OData v4 -tietojen tarjoaja. Dynamics 365 Customer Engagement (on-premises) sisältää OData -tietojen tarjoajan, jota voi käyttää OData v4 -verkkopalveluissa. Lisätietoja: OData v4 -tietojen tarjoajan määritys, vaatimukset ja parhaat käytännöt

Suojatun kentän lisääminen tietolähteeseen

Voit luoda tietolähteelle kenttiä samalla tavalla kuin mille tahansa entiteetille. Ota salatuille tai arkaluontoisille tiedoille käyttöön tietolähteen salainen määrite tietolähteen mukautetun kentässä. Voit esimerkiksi suojata kentän, joka sisältää tietokannan yhteysmerkkijonon.

Muistiinpano

Tietolähteen salainen määrite on käytettävissä vain tietolähdelomakkeeseen lisätyissä kentissä.

Virtuaalikohteen luominen

Voit luoda virtuaalisen entiteetin samalla tavalla kuin minkä tahansa muun entiteetin Customer Engagementissa. Voit luoda myös joitakin ylimääräisiä määritteitä, jotka on kuvattu alla.

Muistiinpano

Vaikka voit luoda virtuaalisen entiteetin valitsemalla tietolähteeksi Ei mitään, virtuaalisen entiteetin hankkiminen edellyttää, että tietolähde määritetään. Lisätietoja: Tietolähteen lisääminen virtuaalisissa entiteeteissä käyttämistä varten

1. Siirry kohtaan Asetukset>Mukauttamiset>Mukauta järjestelmää.

2. Luo uusi entiteetti ratkaisunhallinnassa. Valitse vasemmasta siirtymisruudusta Entiteetit ja valitse Uusi.

3. Yleiset -välilehdessä entiteetin määritykset valitse näennäisentiteetti ja valitse sitten Tietolähde -pudotusvalikosta tietolähde, jonka haluat.

   

4. Entiteetin määrityksessä täytä seuraavat pakolliset kentät.

   • Ulkoinen nimi. Anna sen ulkoisen tietolähteen taulukon nimi, johon tämä entiteetti on yhdistetty.

   • Ulkoinen kokoelman nimi. Anna sen ulkoisen tietolähteen taulukon monikkonimi, johon tämä entiteetti on yhdistetty.

     Seuraavassa on esimerkki Elokuva-nimisestä virtuaalientiteetistä, joka käyttää Azure Cosmos DB -tietokannan tietojen tarjoajaa tiedostoihin pääsemiseksi.

   

   Tärkeä

   Virtuaalientiteettien kanssa ei voi käyttää useita vaihtoehtoja, kuten ryhmien käyttöoikeuksia, työjonoja ja pikaluontia. Lisätietoja: Huomioon otettavia seikkoja virtuaalisten entiteettien käyttämisen yhteydessä

   Täytä pakollisista ja valinnaisista lisäominaisuudet, kuten näyttäminen ja monikkomuotoinen nimi, tarpeen mukaan. Lisätietoja näistä ominaisuuksista on artikkelissa Entiteettien luominen ja muokkaaminen.

5. Luo ja Lisää yksi tai useampi kenttä virtuaalientiteettiin. Standardikenttäominaisuuksien lisäksi, joita tarvitsee voidakseen luoda mukautetun kentän, voi näitä valinnaisia ominaisuuksia käyttää kaikille mukautetuille kentille, joita luodaan virtuaalista entiteettieä varten.

   • Ulkoinen nimi. Tämä on yleensä yksilöllinen nimi, jolla tunnistetaan kentässä näytettävät tiedot.

   Muistiinpano

   Jos luomasi kenttätyyppi on asetusjoukko, seuraavat muut kentät ovat käytettävissä.

   • Ulkoisen tyypin nimi. Tämä ominaisuus on liitetty Asetusjoukon ulkoisen palvelun arvojen ulkoiseen nimeen. Yleensä tämä voi olla luettelointi tai merkkijonon arvoluokan nimi. Ulkoista tyyppinimi voidaan käyttää, kun täydellinen nimi on pakollinen. Esimerkiksi tyyppinimi ja OData, jolla on kyselyn parametreja, edellyttävät täydellistä nimeä, kuten [Tyyppinimi].[Arvo].
   • Ulkoinen arvo. Tämä ominaisuus on liitetty asetusjoukon kohteen ulkoisen tietolähteen vastaavaan arvoon. Tämä annettu arvo käytetään määrittämään, mikä asetusjoukkokohde näytetään sovelluksessa.

   Täytä lisäominaisuudet tarpeen mukaan. Lisätietoja näistä ominaisuuksista on artikkelissa Kenttien luominen ja muokkaaminen.

6. Valitse Tallenna ja sulje - kentän ominaisuudet -sivulla.

7. Valitse ratkaisunhallintatyökaluriviltä Tallenna.

8. Valitse ratkaisunhallintatyökaluriviltä Julkaise.

9. Sulje ratkaisunhallinta.

Kun käyttää virtuaalientiteettejä, huomioon otettavia seikkoja

Virtuaalientiteeteillä on rajoitukset.

• Kaikki virtuaaliset entiteetit ovat vain luku -tilassa.

• Aiemmin luotuja entiteettejä ei voi muuntaa virtuaalisiksi entiteeteiksi.

• Virtuaalientiteeteissä on oletusarvoisesti vain Nimi- ja Tunnus-kenttä. Mitään muita järjestelmän hallitsemia kenttiä, Tila tai Luotu/Muokattu, ei tueta.

• Virtuaalientiteetit eivät tue mukautettuja kenttiä, joiden tietotyyppi on valuutta, kuva tai asiakas.  

• Virtuaalientiteetit eivät tue seurannan.

• Päivityskokoelmissa tai laskettujen kentissä virtuaalientiteettien kenttiä ei voi käyttää.  

• Virtuaalientiteetti ei voi olla entiteetin aktiviteetin tyyppi.

• Virtuaalisissa entiteeteissä ei voi ottaa käyttöön useita entiteettitaulukon riveihin vaikuttavia ominaisuuksia. Esimerkkejä ovat jonot, tietämyksenhallinta, SLA-sopimukset, kaksoiskappaleiden tunnistus, muutosten seuranta, Mobile Offline -ominaisuus, kenttien suojaus, osuvuushaku, Dynamics 365 Customer Engagement (on-premises) -verkkoportaalin ratkaisujen portaalit ja virtuaalientiteettien väliset N:N-suhteet.

• Organisaatiot omistavat virtuaaliset entiteetit. Niissä ei tueta rivitason Commond Data Service for Apps -suojaukseen liittyviä käsitteitä. Suosittelemme, että ulkoisen tietolähde oma suojausmalli otetaan käyttöön.

• On suositeltavaa käyttää kohteena yksi tietolähde Erikoishaussa kun käyttää virtuaalientiteettejä. Esimerkiksi sellaisen Erikoishaku-toiminnon luontia, joka luo lopulta liitoksen Dataverse alkuperäisiä tiedot ja virtuaalientiteetin ulkoisia tietoja välille, ei suositella.

• Päivityksen yhteydessä tarkistettavat kentän metatietojen ominaisuudet eivät koske virtuaalisia entiteettejä. Esimerkiksi virtuaalisen entiteetin Kokonaisluku-kenttä voidaan määrittää niin, että pienin mahdollinen arvo on nolla. Koska arvo saadaan ulkopuolisesta tietolähteestä, kysely kuitenkin palauttaa nollaa pienemmät arvot, kun arvot haetaan virtuaalisesta entiteetistä. Vähimmäisarvon ominaisuutta ei oteta huomioon kyselyssä. Arvot on kuitenkin suodatettava, jotta saadaan haluttu nollaa suurempi arvo.

• Virtuaaliset entiteetit eivät tue muutosten seurantaa, eikä niitä voi synkronoida käyttämällä Customer Engagement -ominaisuutta, kuten tietojen vientipalvelua.

• Virtuaalientiteeteissä ei tueta liiketoimintaprosesseja. Lisätietoja: Vastaanotettu odottamaton virhe, kun käyttäjä aktivoi liiketoimintaprosessin

Vastaanotettu odottamaton virhe, kun käyttäjä aktivoi liiketoimintaprosessin

Kun käyttäjä yrittää aktivoida liiketoimintaprosessin, näyttöön voi tulla "odottamaton virhe" -sanoma. Kun tarkastelet lokitiedostoa, näkyviin tulee seuraava lokimerkintä.

ErrorCode: 0x80040216 Message: System.Web.HttpUnhandledException: Exception of type 'System.Web.HttpUnhandledException' was thrown. ---> Microsoft.Crm.CrmException: Liiketoimintaprosessia ei voida ottaa käyttöön virtuaalientiteetille

Tämä ongelma ilmenee, koska virtuaalientiteetit eivät tue liiketoimintaprosessia.

Katso myös

OData v4 -tietojen tarjoajan vaatimukset ja parhaat käytännöt
Entiteettien luominen ja mukauttaminen
Kenttien luominen ja muokkaaminen