Customer Insights - Data ‑ohjelmointirajapintojen käyttäminen

Dynamics 365 Customer Insights - Data määrittää ohjelmointirajapinnat, jotta voit luoda omia sovelluksia Customer Insights -sovelluksen tietojen perusteella. Kyseisten ohjelmointirajapintojen tiedot ovat ohjelmointirajapinnan viitteessä. Niissä on lisätietoja toiminnoista, parametreista ja vastauksista.

Muistiinpano

Customer Insights - Data -taulukkoja voi käyttää myös Dataversen ohjelmointirajapintojen avulla. Suosittelemme Dataversen ohjelmointirajapintojen käyttämistä Customer Insights -tietojen kyselemiseen, koska ne tarjoavat laajempaa suodatusta, nopeampaa käsittelyä ja pienempää viivettä. Lisätietoja on kohdassa Dataversen ohjelmointirajapinnat Customer Insightsia varten

Ohjelmistorajapintojen käytön kokeilemisen aloittaminen

Järjestelmänvalvojan on ehkä otettava käyttöön tietojen käyttäminen ohjelmointirajapintojen avulla. Kun käyttöoikeus on otettu käyttöön, kuka tahansa käyttäjä voi käyttää ohjelmointirajapintaa tilausavaimen kanssa.

1. Kirjaudu Customer Insights - Dataan tai rekisteröidy Customer Insightsin kokeiluversioon.

2. Siirry kohtaan Asetukset>Käyttöoikeudet ja valitse Ohjelmointirajapinnat-välilehti.

3. Jos ympäristön ohjelmointirajapintaa ei ole määritetty, valitse Ota käyttöön.

   Ohjelmointirajapintojen ottaminen käyttöön luo sen ympäristön ensisijaisen ja toissijaisen tilausavaimen, jota käytetään ohjelmointirajapintapyynnöissä. Voit luoda avaimet uudelleen valitsemalla Luo uudelleen ensisijainen tai Luo uudelleen toissijainen Ohjelmointirajapinnat-välilehdessä.

4. Kokeile ohjelmointirajapintoja valitsemalla Tutustu ohjelmointirajapintoihin.

5. Hae ja valitse ohjelmointirajapintatoiminto ja valitse Kokeile sitä.

   

6. Määritä sivupaneelissa avattava Valtuutus-valikon arvoksi Implisiittinen. Otsikko Authorization lisätään haltijatunnukseen. Tilausavain täytetään automaattisesti.

7. Vaihtoehtoisesti voit lisätä kaikki tarvittavat kyselyparametrit.

8. Vieritä sivuruudun alareunaan ja valitse Lähetä.

   HTTP-vastaus näkyy ruudun alareunassa.

Uuden sovellusrekisteröinnin luominen Azure-portaalissa

Luo uusi sovellusrekisteröinti käyttämään ohjelmointirajapintoja Azure-sovelluksessa delegoitujen käyttöoikeuksien avulla.

1. Suorita Aloittaminen-osa.

2. Käytä Azure-portaaliin kirjautumiseen tiliä, jolla voi käyttää Customer Insightsin tietoja.

3. Etsi ja valitse sitten Sovellusrekisteröinnit.

4. Valitse Uusi rekisteröinti, anna sovelluksen nimi ja valitse tilityyppi.

   Voit lisätä myös uudelleenohjauksen URL-osoitteen (valinnainen). http://localhost on riittävä sovelluksen kehittämiseen paikallisessa tietokoneessa.

5. Valitse Rekisteröi.

6. Valitse uudessa sovellusrekisteröinnissä Ohjelmointirajapinnan oikeudet.

7. Valitse sivuruudusta Lisää oikeus ja valitse sitten Dynamics 365 AI for Customer Insights .

8. Valitse Oikeustyyppi-kohdassa Delegoidut oikeudet. Valitse lopuksi user_impersonation-oikeus.

9. Valitse Lisää käyttöoikeudet.

10. Viimeistele sovelluksen rekisteröinti valitsemalla Myönnä järjestelmänvalvojan hyväksyntä kohteelle....

11. Jos tarvitset ohjelmointirajapinnan käyttöoikeuden ilman käyttäjän kirjautumista, lisätietoja on osiossa Palvelinten välisten sovelluksen käyttöoikeuksien määrittäminen.

Voit käyttää tämän sovelluksen rekisteröinnin sovellus- tai asiakastunnusta MSAL (Microsoft Authentication Library) -kirjastossa. Tällä tavoin saadaan pyynnön kanssa ohjelmointirajapintaan lähetettävä haltijatunnus.

Lisätietoja ohjelmointirajapintojen käyttämisestä asiakasohjelmakirjastoissa on kohdassa Customer Insightsin asiakasohjelmakirjastot.

Palvelinten välisten sovelluksen käyttöoikeuksien määrittäminen

Luo sovelluksen rekisteröinti, joka ei tarvitse käyttäjän vuorovaikutusta ja joka voidaan suorittaa palvelimessa.

1. Valitse Azure-portaalin sovelluksen rekisteröinnissä Ohjelmointirajapinnan käyttöoikeudet.

2. Valitse Lisää oikeus.

3. Valitse API-rajapinnat, joita organisaationi käyttää -välilehti, ja valitse luettelosta Dynamics 365 AI for Customer Insights.

4. Valitse Oikeustyyppi-osiosta Sovelluksen oikeudet ja valitse sitten api.access-oikeus.

5. Valitse Lisää käyttöoikeudet.

6. Palaa sovellusrekisteröinnin Ohjelmointirajapinnan oikeuksiin.

7. Viimeistele sovelluksen rekisteröinti valitsemalla Myönnä järjestelmänvalvojan hyväksyntä kohteelle....

8. Lisää sovelluksen rekisteröinnin nimi käyttäjänä Customer Insights - Dataan.

   1. Avaa Customer Insights - Data sekä valitse ensin Asetukset>Oikeudet ja sitten Lisää käyttäjiä.

   2. Hae sovellusrekisteröinnin nimi, valitse se hakutuloksissa ja valitse Tallenna.

Näytekyselyt

Lyhyt OData-näytekyselyiden luettelo ohjelmointirajapinnan kanssa toimimiseksi: OData-kyselyesimerkit.

Customer Insightsin asiakaskirjastot

Aloita Customer Insights - Data -ohjelmointirajapintoihin saatavilla olevien asiakasohjelmakirjastojen käyttäminen. Kaikki kirjaston lähdekoodit ja näytesovellukset löytyvät GitHub-säilöstä.

C# NuGet

Käytä C#-asiakaskirjastoja osoitteesta NuGet.org. Tällä hetkellä nämä paketit on tarkoitettu netstandard 2.0- ja netcoreapp 2.0-kehyksiin. Lisätietoja NuGet-paketista on kohdassa Microsoft.Dynamics.CustomerInsights.Api.

C#-asiakaskirjaston lisääminen C#-projektiin

1. Avaa Visual Studiossa projektin NuGet Package Manager.

2. Tee hakua hakuehdolla Microsoft.Dynamics.CustomerInsights.Api.

3. Lisää paketti projektiin valitsemalla Asenna.

   Vaihtoehtoisesti voit suorittaa seuraavan komennon NuGet Package Manager Consolessa: Install-Package -Id Microsoft.Dynamics.CustomerInsights.Api -Source nuget.org -ProjectName <project name> [-Version <version>]

C#-asiakaskirjaston käyttäminen

1. Hae AccessToken MSAL (Microsoft Authentication Library) -kirjaston avulla käyttämällä aiemmin luotua Azure-sovelluksen rekisteröintiä.

2. Kun todennus on tehty ja tunnus hankittu, muodosta uusi tai käytä aiemmin luotua HttpClient-asiakasta, jonka DefaultRequestHeaders Authorization -arvoksi on määritetty Bearer-käyttöoikeustietue ja Ocp-Apim-Subscription-Key-määrityksenä on Customer Insights - Data -ympäristön tilausavain.

   Palauta Valtuutus-otsikko tarvittaessa. Esimerkki: tunnus on vanhentunut.

3. Välitä tämä HttpClient CustomerInsights-asiakkaan muodostukseen.

4. Tee asiakasohjelmasta kutsuja laajennusmenetelmiin, kuten GetAllInstancesAsync. Jos taustalla oleva Microsoft.Rest.HttpOperationResponse on ensisijainen vaihtoehto, käytä http-sanomamenetelmiä, esimerkiksi GetAllInstancesWithHttpMessagesAsync.

5. Vastauksen tyyppi on todennäköisesti object, koska menetelmä voi palauttaa useita tyyppejä (kuten IList<InstanceInfo> ja ApiErrorResult). Voit tarkistaa palautustyypin käyttämällä objekteja toiminnon ohjelmointirajapinnan tietosivulla määritetyissä vastaustyypeissä.

   Jos pyynnössä tarvitaan enemmän tietoja, käytä raakavastausobjektia http-sanomamenetelmillä.

NodeJS-paketti

Käytä NodeJS-asiakaskirjastoja, jotka ovat käytettävissä NPM:n kautta: https://www.npmjs.com/package/@microsoft/customerinsights

Python-paketti

Käytä Python-asiakaskirjastoja, jotka ovat käytettävissä PyPi:n kautta: https://pypi.org/project/customerinsights/