Ārēja datu avota datus saturošas virtuālas entītijas Izveide vai rediģēšana

Šī tēma attiecas uz Dynamics 365 Customer Engagement (on-premises). Lai lasītu šo tēmu attiecībā uz Power Apps versiju, skatiet: Tādu virtuālo entītiju izveide un rediģēšana, kurās ir dati no ārējas datu avots

Virtuāla entītija sistēmā Dynamics 365 Customer Engagement (on-premises) ir pielāgota entītija ar laukiem, kuros ir dati no ārēja datu avota. Virtuālās entītijas jūsu programmā lietotājiem ir redzami kā parasti entītiju ieraksti, taču tajos ir ietverti dati, kuru avots ir ārēja datu bāze, piemēram, Azure SQL datu bāze. Ieraksti, kuru pamatā ir virtuālās entītijas, ir pieejami visos klientos, tostarp pielāgotajos klientos, kas izstrādāti, izmantojot Dynamics 365 Customer Engagement tīmekļa pakalpojumus.

Iepriekš, lai integrētu atšķirīgus datu avotus, bija jāizveido savienotājs, lai pārvietotu datus, vai jāizstrādā pielāgots spraudnis klienta vai servera pusē. Taču, izmantojot virtuālās entītijas, varat izveidot tiešu savienojumu ar ārēju datu avotu izpildlaikā tā, lai noteikti dati no ārējā datu avota būtu pieejami vidē bez nepieciešamības veikt datu replicēšanu.

Virtuālās entītijas sastāv no trim galvenajiem komponentiem — a datu sniedzējs, a datu avots ieraksta un virtuālās entītijas. Datu nodrošinātājs sastāv no spraudņiem un datu avota entītijas. Datu avots ir entītijas ieraksts programmā Dynamics 365 Customer Engagement (on-premises), kas ietver metadatus, kuri norāda savienojuma parametru shēmu. Katra virtuālā entītija attiecas uz datu avotu entītijas definīcijā.

Dynamics 365 Customer Engagement (on-premises) ietver OData datu nodrošinātāju, kuru var izmantot, lai izveidotu savienojumu ar OData v4 tīmekļa pakalpojumu, kas piekļūst ārējiem datiem.

Vai arī izstrādātāji var veidot savus datu nodrošinātājus. Datu nodrošinātāji ir instalēti vidē kā risinājums. PapildinformācijaDarba sākšana ar virtuālajām entītijām

Virtuālo entītiju priekšrocības

• Izstrādātāji var ieviest spraudņus ārējo datu lasīšanai, izmantojot Dynamics 365 Customer Engagement tīmekļa pakalpojumus un Customer Engagement spraudņu reģistrācijas rīku.

• Sistēmas pielāgotāji izmanto Dynamics 365 Customer Engagement (on-premises), lai konfigurētu datu avota ierakstu un izveidotu virtuālās entītijas, kuras tiek izmantotas, lai piekļūtu ārējiem datiem bez koda rakstīšanas.

• Lietotāji strādā ar virtuālas entītijas izveidotajiem ierakstiem, lai skatītu datus laukos, režģos, meklēšanas rezultātos un uz ieneses XML balstītos pārskatos un informācijas paneļos.

Datu avota pievienošana izmantošanai virtuālajām entītijām

Izstrādātāji var izveidot pielāgotu spraudni, lai izmantotu kā datu nodrošinātāju virtuālai entītijai. Vai arī varat izmantot nodrošināto OData v4 datu nodrošinātāju. Papildinformācija: OData v4 datu sniedzējs konfigurācija, prasības un paraugprakse

1. Dodieties uz Iestatījumu administrēšana>, virtuālās entītijas datu avoti>.

2. Darbību rīkjoslā atlasiet Jauns.

3. Dialoglodziņā Select datu sniedzējs atlasiet kādu no tālāk norādītajiem datu avotiem un pēc tam atlasiet Labi.

   • Pielāgota datu sniedzējs. Ja esat importējis datu nodrošinātāja spraudni, datu nodrošinātājs parādīsies šeit. PapildinformācijaDarba sākšana ar virtuālajām entītijām

   • OData v4 datu sniedzējs. Dynamics 365 Customer Engagement (on-premises) ietver OData datu nodrošinātāju, ko var izmantot ar OData v4 tīmekļa pakalpojumiem. Papildinformācija: OData v4 datu sniedzējs konfigurācija, prasības un paraugprakse

Drošināta lauka pievienošana datu avotam

Datu avota lauki tiek izveidoti tādā pašā veidā kā jebkura cita entītija. Datiem, kas ir šifrēti vai sensitīvi, datu avota pielāgojatā laukā iespējojiet datu avota noslēpuma atribūtu. Piemēram, lai nodrošinātu lauku, kas satur datu bāzes savienojuma virkni.

Piezīmes

Datu avota noslēpuma atribūts ir pieejams tikai ar datu avota veidlapai pievienotiem laukiem.

Virtuālās entītijas izveide

Jūs izveidojat virtuālu entītiju tāpat kā jebkuru citu entītiju programmā Customer Engagement, pievienojot dažus šeit aprakstītos papildu atribūtus.

Piezīmes

Lai gan virtuālo entītiju var izveidot, kā datu avots atlasot Nav , lai iegūtu datus, virtuālajai entītijai ir nepieciešama datu avots. Papildinformācija datu avots pievienošana virtuālajām entītijām

1. Atveriet sadaļu Iestatījumi>Pielāgojumi>Sistēmas pielāgošana.

2. Risinājumu pārlūkā izveidojiet jaunu entītiju. Lai to izdarītu, kreisajā navigācijas rūtī atlasiet Entītijas un pēc tam atlasiet Jauns.

3. Entītijas definīcijas cilnē Vispārīgi atlasietVirtuālā entītija un pēc tam nolaižamajā sarakstā datu avots atlasiet vajadzīgo datu avots.

   

4. Sadaļā Entītijas definīcija aizpildiet šādus obligātos laukus.

   • Ārējais nosaukums. Tabulas nosaukumu ievadiet ārējo datu avotā, kam kartēta šī entītija.

   • Ārējās kolekcijas nosaukums. Daudzskaitļa nosaukumu ievadiet ārējo datu avotā, kam kartēta šī entītija.

     Tālāk ir sniegts virtuālās entītijas ar nosaukumu Filma piemērs, kas izmanto Azure Cosmos DB datu sniedzējs, lai piekļūtu dokumentu failiem.

   

   Svarīgi

   Vairākas opcijas, piemēram, Access Teams, Rindas un Ātrā izveide, nav pieejamas virtuālajām entītijām. Papildinformācija: Apsvērumi, izmantojot virtuālās entītijas

   Aizpildiet papildu obligātos un neobligātos rekvizītus, piemēram, parādāmo un daudzskaitļa nosaukumu, ja nepieciešams. Papildinformāciju par šiem rekvizītiem skatiet rakstā Entītiju izveide un rediģēšana.

5. Izveidojiet un pievienojiet vienu vai vairākus laukus virtuālajai entītijai. Papildus standarta lauka rekvizītiem, kas nepieciešami, lai izveidotu pielāgotu lauku, šie neobligātie rekvizīti ir pieejami katram pielāgotajam laukam, kuru izveidojat virtuālajai entītijai.

   • Ārējais nosaukums. Parasti tas ir unikāls nosaukums, lai identificētu datus, kurus vēlaties parādīt laukā.

   Piezīmes

   Ja izveidotais lauka tips ir OptionSet, tālāk minētie papildu lauki nav pieejami.

   • Ārējā tipa nosaukums. Šis rekvizīts veic kartēšanu uz ārējā pakalpojuma vērtību kopas ārējo nosaukumu opciju kopai. Parasti tas var būt uzskaitījums vai virknes vērtību klases nosaukums. Ārējā veida nosaukumu var izmantot, ja pilnais nosaukums ir obligāts. Piemēram, kā tipa nosaukums ar OData, kur parametriem vaicājumā ir nepieciešams pilnais nosaukums, piemēram, [Type Name].[Vērtība].
   • Ārējā vērtība. Šis rekvizīts veic kartēšanu uz atbilstošo vērtību ārējā datu avotā opciju kopas elementam. Šī ievadītā vērtība tiek izmantota, lai noteiktu, kuru opciju kopas elementu rādīt programmā.

   Ja nepieciešams, aizpildiet papildu rekvizītus. Papildinformāciju par šiem rekvizītiem skatiet rakstā Lauku izveide un rediģēšana.

6. Atlasiet Saglabāt un aizvērt laukā rekvizītu lapā.

7. Risinājumu pārlūka rīkjoslā atlasiet Saglabāt.

8. Risinājumu pārlūka rīkjoslā atlasiet Publicēt.

9. Aizveriet risinājumu pārlūku.

Apsvērumi, izmantojot virtuālās entītijas

Virtuālajām entītijām ir šādi ierobežojumi.

• Visas virtuālās entītijas ir tikai lasāmas.

• Esošās entītijas nevar konvertēt par virtuālajām entītijām.

• Pēc noklusējuma virtuālajās entītijās ir ietverti tikai lauki Nosaukums un ID. Netiek atbalstīti nekādi citi sistēmas pārvaldītie lauki, piemēram, Statuss vai Izveides laiks/Izmainīšanas laiks.

• Virtuālās entītijas neatbalsta pielāgotus laukus ar datu tipu Valūta, Attēls vai Klients.  

• Virtuālās entītijas neatbalsta auditēšanu.

• Virtuālās entītijas laukus nevar izmantot apkopojumos vai aprēķinātos laukos.  

• Virtuālā entītija nevar būt entītijas darbības tips.

• Daudzas funkcijas, kas ietekmē entītijas tabulas rindas, nevar iespējot ar virtuālajām entītijām. Tas attiecas, piemēram, uz rindām, zināšanu pārvaldību, līgumiem SLA, dublikātu noteikšanu, izmaiņu izsekošanu, Mobile Offline lietošanas iespēju, lauka drošību, atbilstības meklēšanu, Dynamics 365 Customer Engagement (on-premises) tīmekļa portāla risinājumiem paredzētajiem portāliem, kā arī relācijām N:N starp virtuālajām entītijām.

• Virtuālās entītijas pieder organizācijai un neatbalsta rindas līmeņa Common Data Service for Apps drošības koncepcijas. Ieteicams ieviest savu drošības modeli ārējam datu avotam.

• Ieteicams kā mērķi izvēlēties vienu datu avotu, izmantojot virtuālās entītijas detalizētajā atrašanā. Netiek atbalstīta, piemēram, tādas detalizētās atrašanas darbības izveide, kas galu galā izveido Dataverse vietējo datu un virtuālās entītijas ārējo datu savienojumu.

• Lauka metadatu rekvizītus,kas tiek pārbaudīti atjaunināšanas laikā, nelietojiet virtuālajām entītijām. Piemēram, vesela skaitļa lauka minimālo vertību virtuālās entītijas laukā var iestatīt uz nulli. Tomēr tā kā vērtība tiek iegūta no ārējo datu avota, vaicājums atgriezīs vērtības, kas mazākas par nulli, ja tās tiks izgūtas no vituālās entītijas. Minimālās vērtības rekvizīts nav nozīmēts vaicājumā. Jums joprojām būs jāfiltrē vērtības, kas lielākas par 0, ja to vēlēsities.

• Virtuālās entītijas neatbalsta izmaiņu izsekošanu, un tās nevar sinhronizēt, izmantojot Customer Engagement līdzekli, piemēram, pakalpojumu datu eksportēšana.

• Biznesa procesa plūsmas netiek atbalstītas ar virtuālajām entītijām. PapildinformācijaNeparedzēta kļūda, kas saņemta, lietotājam aktivizējot biznesa procesa plūsma

Neparedzēta kļūda, kas saņemta, lietotājam aktivizējot biznesa procesa plūsmu

Kad lietotājs mēģina aktivizēt datu biznesa procesa plūsmu, viņš var saņemt ziņojumu par "neparedzētu kļūdu". Žurnālfaila skatīšanai tiek parādīts šāds žurnāla ieraksts.

ErrorCode: radās 0x80040216 ziņojums: System.Web.HttpUnhandledException: Tika parādīts 'System.Web.HttpUnhandledException' tipa izņēmums. ---> Microsoft.Crm.CrmException: virtuālajai entītijai nevar iespējot biznesa procesa plūsma

Šī problēma rodas, jo virtuālās entītijas neatbalsta biznesa procesa plūsmas.

Skatiet arī:

OData v4 datu sniedzējs prasības un paraugprakse
Entītiju
izveide un rediģēšana Lauku izveide un rediģēšana