Делите путем


Преглед Web API-ја за портале

Напомена

Од 12. октобра 2022. Power Apps портали постају Power Pages. Више информација: Услуга Microsoft Power Pages је сада општедоступна (блог)
Ускоро ћемо мигрирати и објединити документацију о Power Apps порталима са документацијом о услузи Power Pages.

Web API за портале омогућава изградњу богатијег корисничког искуства унутар Power Apps страница портала. Web API можете користити за извршавање операција креирања,читања, ажурирања и брисања у свим Microsoft Dataverse табелама са страница портала. На пример, можете да направите нови налог, ажурирате контакт или промените дозволе за табелу за производ коришћењем Web API-ја портала уместо апликације Portal Management.

Напомена

Web API за портале можете да користите и у услузи Power Pages. Још информација: Шта је то Power Pages

Важно

  • Верзија вашег портала мора бити 9.3.3.x или новија да би ова функција могла да функционише.
  • Web API за портале је изграђен за креирање богатог корисничког искуства унутар страница портала. Он није оптимизован за услуге независних произвођача или за интеграцију апликација. Коришћење Web API за портале за интегрисање са другим Power Apps порталима такође није подржано.
  • Web API операције за портале су ограничене на табеле повезане са подацима – на пример, контакти, пословни контакти или прилагођене табеле. Конфигурисање метаподатака табеле или података табеле конфигурације портала – на пример, конфигурисање табела портала као што су adx_contentsnippet, adx_entityform или adx_entitylist – није подржано Web API-јем за портале. За комплетну листу идите на одељак о неподржаним табелама конфигурације касније у овој теми.
  • Web API за портале има користи од кеширања на страни сервера, па према томе, наредни позиви Web API-ја су бржи од почетних позива. Имајте на уму да брисање кеша на страни сервера портала узрокује привремену деградацију перформанси.
  • Операције Web API-ја за портале захтевају лиценцу за Power Apps портале. На пример, позиви Web API-ја које упућују анонимни корисници рачунају се у капацитету приказа странице. Позиви Web API-ја које су упутили корисници са потврђеним идентитетом (интерни или екстерни) не рачунају се у приказе страница, али захтевају одговарајуће лиценце. Још информација: Најчешћа питања о лиценцирању Power Apps портала

Операције Web API-ја

Web API за портале нуди подскуп могућности за радње портала Dataverse које можете извршити користећи API за Dataverse. Одржали смо формат API-ја што је могуће сличнијим, како бисмо ублажили криву учења.

Напомена

Web API операције су осетљиве на мала и велика слова.

Операције Web API-ја доступне на порталима

Напомена

Позивање радњи и функција помоћу Web API-ја за портале није подржано.

Подешавања локације за Web API

Морате омогућити подешавање локације да бисте омогућили Web API за портале за свој портал. Такође, можете да конфигуришете Web API на нивоу поља, који одређује поља табеле која се могу или не могу мењати помоћу Web API-ја за портале.

Напомена

Користите логичко име табеле за ове поставке (на пример пословни контакт).

Назив подешавања локације Опис
Webapi/<table name>/enabled Омогућава или онемогућава Web API за <table name>.
Подразумевано: False
Важеће вредности: True, False
Webapi/<table name>/fields Дефинише листу атрибута одвојених зарезом који се могу изменити помоћу Web API-ја.
Могуће вредности:
- Сви атрибути: *
- Специфични атрибути: attr1,attr2,attr3
Напомена: Вредност мора бити или звездица (*) или списак назива поља одвојених зарезом.
Важно: Ово је обавезно подешавање локације. Када ово подешавање недостаје, видећете грешку „За овај ентитет нису дефинисана поља“.
Webapi/error/innererror Омогућује или онемогућује InnerError.
Подразумевано: False
Важеће вредности: True, False
Webapi/<table name>/disableodatafilter Омогућава или онемогућава OData филтер.
Подразумевано: False
Важеће вредности: True, FalseВише информација потражите у одељку Познати проблеми. Поставка локације је доступна на порталу верзије 9.4.10.74 или новијем.

Напомена

Подешавања локације морају бити постављена на Активно да би промене ступиле на снагу.

На пример, да бисте изложили Web API за табелу Предмета где је овлашћеним корисницима дозвољено да обављају операције креирања, ажурирања и брисања овог ентитета, подешавања локације су приказана у следећој табели.

Назив подешавања локације Вредност подешавања локације
Webapi/incident/enabled true
Webapi/incident/fields attr1, attr2, attr3

Безбедност помоћу Web API-ја за портале

Можете да конфигуришете заштиту засновану на записима за појединачне записе на порталима користећи дозволе за табеле. Web API за портале приступа записима табеле (ентитета) и прати дозволе за табеле дате корисницима путем придружених веб-улога.

Можете да конфигуришете дозволе за колоне тако да додатно дефинишу привилегије појединачним колонама унутар табеле док користите Web API за портале.

Безбедност помоћу Web API-ја за портале.

Захтеви за потврду идентитета за Web API за портале

Не морате да укључујете кôд за потврду идентитета, јер потврдом идентитета и ауторизацијом управља сесија апликације. Сви позиви Web API-ја морају да садрже токен фалсификовања унакрсних захтева између локација (CSRF).

Коришћење функције EntitySetName

Када се позивате на Dataverse табеле које користе Web API за портале у коду, потребно је да користите EntitySetName, на пример, за приступ табели пословног контакта, синтакса кода ће користити EntitySetName за пословне контакте, /_api/accounts().

Напомена

Користите логичко име табеле за поставке локације (на пример пословни контакт).

можете одредити EntitySetName одређених табела тако што ћете пратити ове кораке:

  1. Иди у https://make.powerapps.com

  2. Изаберите картицу Dataverse са бочне табле и изаберите табелу.

  3. Изаберите ... (опција Команде) и одаберите Напредно, Алатке и Копирај име скупа да бисте копирали EntitySetName табеле у оставу.

    Како да пронађете EntitySetName Dataverse табеле.

Општа уредба о заштити података (GDPR)

Сва заглавља захтева ће имати ID контакта прослеђен у сврхе надгледања. За анонимног корисника ово ће се проследити као null.

Ако је евидентирање ревизије омогућено, корисник може видети све догађаје ревизије у Office 365 евиденцији ревизије.

Office 365 евиденција надгледања.

Више информација:
Омогућавање и коришћење евидентирања активности
Извоз, конфигурисање и приказ записа евиденције надгледања

Неподржане табеле конфигурације

Web API за портале се не може користити за следеће табеле конфигурације:

adx_contentaccesslevel

adx_contentsnippet

adx_entityform

adx_entityformmetadata

adx_entitylist

adx_entitypermission

adx_entitypermission_webrole

adx_externalidentity

adx_pagealert

adx_pagenotification

adx_pagetag

adx_pagetag_webpage

adx_pagetemplate

adx_portallanguage

adx_publishingstate

adx_publishingstatetransitionrule

adx_publishingstatetransitionrule_webrole

adx_redirect

adx_setting

adx_shortcut

adx_sitemarker

adx_sitesetting

adx_urlhistory

adx_webfile

adx_webfilelog

adx_webform

adx_webformmetadata

adx_webformsession

adx_webformstep

adx_weblink

adx_weblinkset

adx_webnotificationentity

adx_webnotificationurl

adx_webpage

adx_webpage_tag

adx_webpageaccesscontrolrule

adx_webpageaccesscontrolrule_webrole

adx_webpagehistory

adx_webpagelog

adx_webrole_systemuser

adx_website

adx_website_list

adx_website_sponsor

adx_websiteaccess

adx_websiteaccess_webrole

adx_websitebinding

adx_websitelanguage

adx_webtemplate

Познати проблеми

Корисници ће добити CDS грешку ако позову Web API захтев GET за табеле које имају више 1 према више или више према више дозвола за табелу са дефинисаним надређеним опсегом.

Да бисте решили овај проблем, препоручено решење је коришћење језика FetchXML у OData упиту.

Друга могућност је да подесите поставку локације Webapi/<table name>/disableodatafilter на True.

Важно

Промена поставке локације Webapi/<table name>/disableodatafilter на True довести до споријих перформанси за Web API GET позиве.

Поставка локације је доступна на порталу верзије 9.4.10.74 или новијем.

Следећи корак

Подаци упита помоћу Web API-ја за портале

Погледајте и

Састављање HTTP захтева и обрада грешака
Операције писања, ажурирања и брисања на порталима помоћу Web API-ја
Водич: Коришћење Web API-ја за портале

Напомена

Можете ли нам рећи о својим жељеним поставкама језика у документацији? Испуните кратку анкету. (имајте на уму да је ова анкета на енглеском језику)

Анкета ће трајати око седам минута. Не прикупљају се лични подаци (изјава о приватности).