Virtuele entiteitanalyse met de OData v4-gegevensprovider
Stel u voor dat u persoonlijke informatie over een contactpersoon van een externe gegevensbron in uw aangepaste zakelijke app wilt openen, maken, bijwerken en verwijderen. Aangezien de gegevensbron die voor dit overzicht wordt gebruikt een OData v4-webservice heeft, kunt u gebruikmaken van de OData 4-gegevensprovider die wordt meegeleverd met uw versie van Dynamics 365 Customer Engagement. Meer informatie: Virtueel tabeloverzicht met de OData v4-gegevensprovider
Dit onderwerp is van toepassing op Dynamics 365 Customer Engagement (on-premises). Voor de Power Apps-versie van dit onderwerp, zie: Virtuele tabelanalyse
Over deze virtuele entiteitanalyse
Stel dat u toegang wilt krijgen tot informatie over toegangstickets vanuit een externe gegevensbron binnen uw aangepaste zakelijke app of het gebied Service van Customer Engagement. In deze eenvoudige analyse modelleert u een virtuele entiteit met velden die zijn toegewezen aan het externe schema dat ticketgegevens ophaalt tijdens uitvoeringstijd van een OData-webservice.
Details van gegevensbron
Aangezien de gegevensbron die voor dit overzicht wordt gebruikt een van OData v4-webservice heeft, kunnen we gebruikmaken van de OData 4-gegevensprovider die wordt meegeleverd met uw omgeving.
URL van webservice: https://contosowebservice.azurewebsites.net/odata/
Belangrijk
De URL van de webservice voor dit overzicht is geen werkende webservice.
Voor dit overzicht is een enkele virtuele entiteit nodig die de volgende drie velden bevat.
| Naam van extern veld | Type externe gegevens | Gegevens voor virtuele entiteit | Doeleinde |
|---|---|---|---|
| TicketID | Edm.Guid | Primaire sleutel | Primaire sleutel voor de entiteit |
| Titel | Edm.String | Eén tekstregel | Titel van het ticket |
| Ernst | Edm.Int32 | Geheel getal | Getalwaarde van 0-4 die de ernst van het ticket aangeeft |
De OData-metagegevens van de entiteit Ticket voor de externe gegevensbron zoals weergegeven vanuit een webbrowser.
De gegevensbron maken
Maak de gegevensbron voor de OData v4-serviceprovider die gebruikmaakt van de OData-voorbeeldwebservice (OASIS Open Data Protocol).
Ga naar Instellingen>Beheer>Bronnen voor virtuele entiteitsgegevens
Selecteer NIEUW, selecteer OData v4-gegevensprovider en selecteer vervolgens OK.
Voer de volgende informatie in of selecteer deze.
- Naam: Contoso-voorbeeldgegevensbron
- URL:
https://contosowebservice.azurewebsites.net/odata - Time-out: 30
- Inline telling retourneren: Waar
Laat de andere velden ongewijzigd en selecteer OPSLAAN EN SLUITEN.
Fooi
Controleer bij gebruik van uw eigen webservice of de URL geldig is door deze in uw webbrowser plakken.
De virtuele entiteit maken
Ga naar Instellingen>Aanpassingen>Het systeem aanpassen.
Selecteer in het linkernavigatiedeelvenster de optie Entiteiten en selecteer vervolgens Nieuw in het hoofdvenster.
Selecteer in het formulier Entiteit: Nieuw de optie Virtuele entiteit en voer de volgende gegevens in:
- Gegevensbron: Contoso-voorbeeldgegevensbron
- Weergavenaam: Ticket
- Meervoudsnaam: Tickets
- Naam: new_ticket
- Externe naam: Ticket
- Naam van externe verzameling: Tickets
- Selecteer om de volgende opties voor communicatie en samenwerking in te schakelen:
- Notities (inclusief bijlagen)
- Activiteiten
Selecteer naast Gebieden waarin deze entiteit wordt weergegeven de optie Service en selecteer vervolgens Opslaan (maar sluit het entiteitenformulier niet).
De velden voor de virtuele entiteit maken
Selecteer in het linkernavigatiedeelvenster van de pagina Entiteit: Ticket de optie Velden. Als onderdeel van dit overzicht gaat u twee bestaande velden bewerken en een derde veld toevoegen.
Belangrijk
Externe namen zijn hoofdlettergevoelig. Raadpleeg de metagegevens van de webservice om te controleren of u de juiste naam gebruikt.
Een Nullable-waarde Onwaar geeft aan dat het kenmerk is vereist. Houd er rekening mee dat primaire sleutelvelden altijd door het systeem zijn vereist.
Open het veld new_ticketid en wijzig het volgende kenmerk met de hier weergegeven waarde:
Externe naam: TicketID
Selecteer Opslaan en sluiten.
Open het veld new_name en wijzig het volgende kenmerken met de hier weergegeven waarden:
- Weergavenaam: Titel
- Externe naam: Titel
Selecteer Opslaan en sluiten.
Selecteer Nieuw en klik voer op de pagina Veld: Nieuw voor Ticket de volgende gegevens in:
- Weergavenaam: Ernst
- Naam: new_severity
- Externe naam: Ernst
- Veldvereiste: Vereist voor onderneming
- Gegevenstype: Geheel getal
- Minimumwaarde: 0
- Maximumwaarde: 4
Selecteer Opslaan en sluiten.
Het veld toevoegen aan het hoofdformulier
Selecteer in het venster van de entiteit Ticket de optie Formulieren.
Open het hoofdformulier, sleep het veld Ernst van het rechterdeelvenster naar het formulier in de sectie Algemeen onder het veld Titel.
Selecteer in het venster van de entiteit Ticket de optie Opslaan en sluiten.
De standaardweergave configureren
Klik in het linkerdeelvenster van de Oplossingsverkenner, onder Ticketentiteit de optie Weergaven.
Open de weergave Alle tickets.
Selecteer in het deelvenster Algemene taken de optie Kolommen toevoegen.
Selecteer Ernst en selecteer vervolgens OK.
Selecteer in het venster Weergave: Alle tickets de optie Opslaan en sluiten.
Selecteer in het venster van Solution Explorer de optie Alle aanpassingen publiceren.
Sluit het venster van Solution Explorer nadat alle aanpassingen zijn gepubliceerd.
De virtuele entiteit in actie bekijken met Dynamics 365 Customer Engagement (on-premises)
Ga naar Service>Extensies>Tickets.
De weergave Alle tickets wordt geopend. Denk eraan dat u uw browser mogelijk moet vernieuwen om de entiteit weer te geven in het gebied Service.
Open een record Ticket om het formulier te bekijken dat de velden Titel en Ernst bevat voor de desbetreffende record.
Zie ook
De configuratie, vereisten en aanbevolen methoden van de OData v4-gegevensprovider
Virtuele entiteiten maken en bewerken die gegevens uit een externe gegevensbron bevatten