Jaa


Virtuaalisen entiteetin tietojen tarjoajan luominen

Virtuaalientiteetin tietojen SDK-kokoonpanojen avulla voidaan luoda kaksi yleistä tietopalveluluokkaa: yleinen tai kohdennettu.

Luokka Kuvaus
Yleinen Nämä palveluntarjoajat ymmärtävät, miten Dynamics 365 Customer Engagement:n metatietoja ja ulkoisten tietojen palveluasiakirjoja käytetään Dynamics 365 Customer Engagement -kyselyjen muuntamiseen näiden palveluiden asianmukaiseksi kyselyksi. Tällaisella tiedontarjoajalla integrointi voidaan saavuttaa ilman koodin kirjoittamista, mutta nämä ovat monimutkaisimpia tiedontarjoajia luoda. Dynamics 365 Customer Engagement:n tarjoamat Odata v4- ja Azure DocumentDB -tietopalvelut ovat uudelleenkäytettäviä yleisiä palveluntarjoajia.
Kohdistettu Sen sijaan, että yrittäisit luoda yleisen tietopalvelun, voit käyttää Dynamics 365 Customer Engagementin toimialuetietämystä ja ulkoisia tietoja luodaksesi tietopalvelun, joka yrittää tarjota ratkaisun vain tämän ratkaisun rajoitettuun laajuuteen.

Koska tämän julkaisun virtuaalitentiteetit ovat vain luku -tilassa, kirjoitat laajennuksen muodossa tietopalvelun, joka on rekisteröity Retrieve- ja RetrieveMultiple-tapahtumiin. Kukin tapahtuma sisältää suorituskontekstissa tietoja, jotka kuvaavat palautettavien tietojen tyyppiä.

Tapahtuma Toteutuksen konteksti
Noutaa Kuvaa noudettavan entiteetin sekä sisällytettävät määritteet ja niihin liittyvät entiteetit.
RetrieveMultiple Kyselyn määrittävä QueryExpression-objekti

Molemmissa tapahtumissa sinun on :

  1. Muunna vastaavat tiedot suorituskontekstissa kyselyksi, joka toimii ulkoisessa tietolähteessäsi.
  2. Hae tiedot ulkoisesta järjestelmästä.
  3. Muunna tiedot joko entiteetiksi tai entiteettikokoelmaksi , joka palautetaan Dynamics 365 Customer Engagement -ympäristön kautta kyselyn suorittavalle käyttäjälle.
    Jos koodisi ei jostain syystä saavuta odotettua tulosta, sinun on annettava asianmukainen virhe. Virtuaalientiteetin tietojen SDK sisältää joukon tiettyjä virheitä, joita voit antaa.

Virtuaalientiteetin tietojen SDK tarjoaa kehyksen, jonka avulla voit yhdistää Dynamics 365 Customer Engagement -kyselyn tiedot suorituskontekstista kyselyyn ulkoisen tietolähteen mukaisessa muodossa. Sama kehys auttaa sinua muuntamaan palautetut tiedot asianmukaisiksi Entity - tai EntityCollection-tyypeiksi , joita Dynamics 365 Customer Engagement -ympäristö odottaa.

Toisin kuin tavallisessa laajennuksessa, käytät vain Plugin Registration Tool (PRT) -työkalua kokoonpanon ja laajennusten rekisteröimiseen kullekin tapahtumalle. Et rekisteröi tiettyjä vaiheita. Laajennus suoritetaan vaiheessa 30, joka on toiminnon päätapahtumavaihe, joka ei ole käytettävissä tavallisissa laajennusvaiheissa. Vaiheiden rekisteröinnin sijaan määrität tietopalvelun käyttämällä EntityDataProvideria ja EntityDataSource entiteettiä.

Kokonaisuus Kuvaus
EntityDataProvider Määrittää kussakin tapahtumassa käytettävät laajennukset ja tietolähteen loogisen nimen.
EntityDataSource Tarjoaa entiteetin ja kaikki ulkoisen tietolähteen edellyttämät yhteystiedot, mukaan lukien todennukseen tarvittavat salaisuudet.

Kun virtuaalientiteetin metatiedot on määritetty, laajennukset rekisteröidään PRT:n avulla ja oikeat määritystiedot on määritetty EntityDataProvider - ja EntityDataSource-entiteeteissä , virtuaalientiteetti alkaa vastata pyyntöihin.