OData v4 деректер жеткізушісінің конфигурациясы және үздік тәжірибелері

Бұл тақырып Dynamics 365 Customer Engagement (on-premises) жүйесіне қолданылады. Осы тақырыптың Power Apps нұсқасына арналған: мынаны қараңыз: OData v4 деректер провайдерінің конфигурациясы

Бұл тақырыпта OData v4 деректер жеткізушісін конфигурациялау әдісі, сонымен бірге OData v4 деректер жеткізушісін OData v4 қызметіне қосылу үшін пайдаланудың талаптары және ұсынылған үздік тәжірибелері сипатталған.

OData v4 деректер жеткізушісінің үздік тәжірибелері

  • Сіздегі нұсқа барлық нысандарда идентификатор төлсипатының болуын талап етеді. Бұл идентификатор бірегей идентификатор ретінде белгілі және оның мәні GUID болуы керек. ID өрістерін тек EDM.Guid деректер түрі бар сыртқы өрістермен салыстыруға болады. EDM.Int32 деректер түрін uniqueidentifer деректер түрі өрісімен салыстыру мүмкін емес.

  • Нөлденетін сипаттары бар OData нысандарын виртуалды нысандағы салыстырылған өріске сәйкес болатындай орнату керек. Мысалы, Nullable=False бар OData мәнінің сипатында Бизнеске қажетті өріс талабы атрибуты бар картаға түсірілген өріс болуы тиіс.

  • Бірнеше сұрауды шығарып алу үшін (мысалы деректерді торға жүктегенде) select және filter параметрлерін пайдалана отырып сыртқы деректер көзінен қайтарылатын деректер жиынының өлшемін басқарыңыз.

  • Қосылып қойылмаған болса, жүйе әкімшілері қосылатын модульді трассирлеуді қосулары керек. Қосқаннан кейін қосылатын модульді трассирлеу журналында OData соңғы нүктесінен алынған барлық қателер жазылады. Қосымша ақпарат: Жүйе параметрлері диалогтық терезесі - Реттеу қойындысы

Деректер түрін салыстыру

Келесі кестеде тиісті деректер түрлерімен OData Entity Data Model (EDM) деректер түрін салыстыру нәтижелері тізілген.

OData деректер түрі Деректер түрі
Edm.Boolean Екі параметр
Edm.DateTime Күн және уақыт
Edm.DateTimeOffset Күн және уақыт
Edm.Decimal Ондық сан немесе валюта
Edm.Double Өзгермелі нүктелі сан
Edm.Guid Бір мәнді идентификатор
Edm.Int32 Бүтін
Edm.Int64 Бүтін
Edm.String Мәтіннің бір жолы немесе мәтіннің бірнеше жолы

Виртуалды нысандармен салыстыруға қолдау көрсетілмейтін OData EDM деректер түрлері

  • Edm.Binary

  • Edm.Time

  • Edm.Float

  • Edm.Single

  • Edm.Int16

  • Edm.Byte

  • Edm.SByte

OData v4 деректер жеткізушісін пайдаланып деректер көзін қосу

Бұл іс рәсімі кірістірілген OData деректер жеткізушісін виртуалды нысанның деректер көзі ретінде пайдалану жолын көрсетеді.

  1. Параметрлер әкімшілігі виртуалды заңдылық деректер көздері бөліміне өтіңіз.>>

  2. Әрекеттер құралдар тақтасында Жаңа тармағын таңдаңыз.

  3. Деректер провайдерін таңдау диалогтық терезесінде келесі деректер көздерінен таңдап, OK түймешігін таңдаңыз .

    • OData v4 деректер провайдері. Ортаңыз OData v4 ашық стандартын қолдайтын деректер көзіне қосылу үшін пайдалануға болатын Odata v4 деректер жеткізушісін қамтиды.

    • Реттелетін деректер провайдері. Сіз деректер жеткізушісі қосылатын модулін импорттасаңыз, осы жерде деректер жеткізушісі көрінеді. Қосымша ақпарат: Виртуалды субъектілермен жұмысты бастау

  4. «Жаңа деректер көзі» сипаттар бетінде келесі өрістерді толтырыңыз, содан кейін жазбаны сақтаңыз.

    • Аты. Деректер көзін сипаттайтын атауды теріңіз.

    • Ури. OData деректер жеткізушісін пайдаланып жатсаңыз, OData веб-қызметінің URI мекенжайын енгізіңіз. Мысалы, Azure қызметінде орналасқан веб-қызметке қосылу үшін OData провайдері пайдаланылса, URI ұқсас болып көрінуі мүмкін https://contosodataservice.azurewebsites.net/odata/

    • Тайм-тайм секундпен. Деректерді сұрауды күту уақыты бітуі алдында веб-қызметтер жауапты күтудің секундтар санын енгізіңіз. Мысалы, күту уақыты бітуі орын алуы алдында ең көбі отыз секунд күту үшін 30 санын енгізіңіз.

    • Пагинация режимі. Сұрау нәтижелері қалай реттелетінін басқару үшін клиент тарапында немесе сервер тарапында беттеуді пайдалануды таңдаңыз. Әдепкі мән — клиент тарапында беттеу. Сервер тарапыда беттеуде сервер нәтижелер қалай беттелетінін сұрау жолына қосылатын $skiptoken параметрін пайдалана отырып басқарады. Қосымша ақпарат: Token System сұрау параметрін өткізіп жіберу ($skiptoken)

      • Кірістіру санын қайтару. Сұрау нәтижесінде жазбалардың жалпы санын қайтарады. Бұл параметр торға деректерді қайтарғанда келесі бет функциясын қосу үшін пайдаланылады. OData соңғы нүктесі OData $inclinecount параметрін қолдамаса, false мәнін пайдаланыңыз. Әдепкі мән — false.
    • Параметрлерді сұрау. Таңдау бойынша, сыртқы қызметтегі түпнұсқалық растамасының параметрлері сияқты OData веб-қызметіне қосылу үшін пайдаланылатын теңшелетін тақырып немесе сұрау жолының параметрлерін қосуға болады. Тақырып пен сұрау жолының параметрі мен мәні арасында қайыру үшін Сұрау жолы тармағын таңдаңыз . 10-ға дейін тақырып немесе сұрау жолын қосуға болады.

    Виртуалды нысан деректерінің көзі жазбасы.

Келесіні де қараңыз:

Сыртқы деректер көзі деректері бар виртуалды субъектілерді жасау және өңдеу
TechNet блогы: Жаңа виртуалды субъектілерді пайдалана отырып, сыртқы жүйелерден алынған деректермен өзара әрекеттесу