Преглед Web API-ја за портале
Web API за портале омогућава изградњу богатијег корисничког искуства унутар Power Pages локација. Web API можете користити за извршавање операција креирања, читања, ажурирања и брисања у свим Microsoft Dataverse табелама са веб-страница. На пример, можете да креирате нови налог, ажурирате контакт без коришћења обрасца или обрасца са више корака помоћу Web API-ја.
Важно
- Верзија вашег Power Pages сајта мора бити 9.3.3.к или новија да би ова функција радила.
- Web API за портале је изграђен за креирање богатог корисничког искуства унутар страница портала. Он није оптимизован за услуге независних произвођача или за интеграцију апликација. Коришћење Web API портала за интегрисање са другим Power Pages локацијама такође није подржано.
- Web API операције за портале су ограничене на табеле повезане са подацима – на пример, контакти, пословни контакти или прилагођене табеле. Конфигурисање метаподатака табеле или података табеле конфигурације портала – на пример, конфигурисање табела портала као што су adx_contentsnippet, adx_entityform или adx_entitylist – није подржано Web API-јем за портале. За комплетну листу, идите на неподржане табеле конфигурације касније у овом чланку.
- Web API за портале има користи од кеширања на страни сервера, па према томе, наредни позиви Web API-ја су бржи од почетних позива. Брисање кеша на страни сервера портала узрокује привремену деградацију перформанси.
- Операције Web API-ја захтевају лиценцу за Power Pages. На пример, позиви Web API-ја које упућују анонимни корисници рачунају се у капацитету анонимних корисника. Позиви Веб АПИ-ја направљени од стране аутентификованих корисника (интерних или екстерних) не рачунају се према приказима страница, али захтевају важеће аутентификоване лиценце за капацитет корисника. Још информација: Најчешћа питања о лиценцирању услуге Power Pages
Операције Web API-ја
Web API за портале нуди подскуп могућности за радње портала Dataverse које можете извршити користећи API за Dataverse. Задржали смо АПИ формат што је могуће сличнији како бисмо смањили кривуљу учења.
Напомена
Web API операције су осетљиве на мала и велика слова.
Web API операције доступне у услузи Power Pages
- Читање записа из табеле
- Креирајте запис у табели
- Ажурирајте и избришите записе у табели
- Табеле сарадника и раздвајања
Поставке локације за Web API
Морате омогућити подешавање локације да бисте омогућили Web API за портале за свој портал. Такође, можете да конфигуришете Web API на нивоу поља, који одређује поља табеле која се могу или не могу мењати помоћу Web API-ја за портале.
Напомена
Користите логичко име табеле за ове поставке (на пример пословни контакт).
| Назив поставки локације | Опис |
|---|---|
| Wебапи / < име > табеле/омогућено | Омогућава или онемогућава Web API за <назив табеле>. Подразумевани: False Важеће вредности: True, False |
| Wебапи / < име > табеле/поља | Дефинише листу атрибута одвојених зарезом који се могу изменити помоћу Web API-ја. Могуће вредности: - Сви атрибути: * - Специфични атрибути: attr1,attr2,attr3 белешке : Вредност мора бити или звездица ( *) или листа имена поља раздвојена зарезом. Важно : Ова поставка је обавезно подешавање сајта. Када ова поставка недостаје, видећете грешку "Нема поља дефинисана за овај ентитет." |
| Вебапи / грешка / иннереррор | Омогућује или онемогућује InnerError. Подразумевани: False Важеће вредности: True, False |
| Wебапи / < табле наме >/дисаблеодатафилтер | Омогућава или онемогућава OData филтер. Подразумевани: False Важеће вредности: True, False Погледајте познате проблеме за више информација. Поставка локације је доступна на порталу верзије 9.4.10.74 или новијем. |
Напомена
Поставке локације морају бити постављена на Активно да би промене ступиле на снагу.
На пример, да бисте изложили Web API за табелу Предмета где је овлашћеним корисницима дозвољено да обављају операције креирања, ажурирања и брисања овог ентитета, поставке локације су приказане у следећој табели.
| Назив поставки локације | Вредност подешавања локације |
|---|---|
| Вебапи / инцидент / омогућено | true |
| Wебапи/инцидент/поља | attr1, attr2, attr3 |
Безбедност помоћу Web API-ја за портале
Можете да конфигуришете заштиту засновану на записима за појединачне записе на порталима користећи дозволе за табеле. Web API за портале приступа записима табеле (ентитета) и прати дозволе за табеле дате корисницима путем придружених веб-улога.
Можете да конфигуришете дозволе за колоне тако да додатно дефинишу привилегије појединачним колонама унутар табеле док користите Web API за портале.
Захтеви за потврду идентитета за Web API за портале
Не морате да укључите код за аутентификацију јер сесија апликације управља аутентификацијом и ауторизацијом. Сви позиви Web API-ја морају да садрже токен фалсификовања унакрсних захтева између локација (CSRF).
Коришћење функције EntitySetName
Када се позивате на Dataverse табеле које користе Веб АПИ портала у вашем коду, потребно је да користите ЕнтитyСетНаме , на пример, да бисте приступили табели рачуна , синтакса кода користи ЕнтитyСетНаме налога ; /_api/accounts()
Белешка
Користите логичко име табеле за поставке локације (на пример пословни контакт).
можете одредити EntitySetName одређених табела тако што ћете пратити ове кораке:
Изаберите картицу Dataverse са бочне табле и изаберите табелу.
Изаберите ... (опција Команде) и одаберите Напредно, Алатке и Копирај име скупа да бисте копирали EntitySetName табеле у оставу.
Закони и прописи о приватности
Сва заглавља захтева користе ИД контакта који је прослеђен у сврху ревизије. За анонимног корисника, ова вредност се прослеђује као null.
Ако је евидентирање ревизије омогућено, корисник може видети све догађаје ревизије у 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
Познати проблеми
Корисници добијају грешку ЦДС-а ако позову захтев за GET Веб АПИ за табеле које имају више нивоа од КСНУМКС до многих или многих до многих дозвола за табеле када обједлози родитељских , ** контактних или налога додају више услова упиту.
Да бисте решили овај проблем, препоручено решење је да се користи FetchXML у ОДата упиту.
Друга могућност је да подесите поставку локације Webapi/<назив табеле>/disableodatafilter на True.
Важно
Промена подешавања сајта Вебапи / < табле наме > / дисаблеодатафилтер може True довести до споријих перформанси за Веб АПИ GET позиве.
Поставка локације је доступна на порталу верзије 9.4.10.74 или новијем.
Следећи корак
Упитајте податке користећи портале Веб АПИ