Nota
O acceso a esta páxina require autorización. Pode tentar iniciar sesión ou modificar os directorios.
O acceso a esta páxina require autorización. Pode tentar modificar os directorios.
A API web dos portais permite unha experiencia de usuario máis rica dentro das páxinas dos sitios de Power Pages. Pode usar a API web para realizar operacións de creación, lectura, actualización e eliminación en todas as táboas de Microsoft Dataverse das páxinas das súas páxinas web. Por exemplo, pode crear unha conta nova, actualizar un contacto sen utilizar un formulario ou formulario con varios pasos utilizando a API web de portais.
Importante
- A súa Power Pages versión do sitio debe ser 9.3.3.x ou posterior para que esta función funcione.
- A API web de portais construíuse para crear unha experiencia de usuario rica dentro de páxinas de portais. Non está optimizado para servizos de terceiros nin a integración de aplicacións. Tampouco se admite o uso da API web de portais para integrarse con outros sitios de Power Pages.
- As operacións da API web de portais están limitadas a táboas relacionadas cos datos; por exemplo, contas, contactos ou as súas táboas personalizadas. A configuración dos metadatos da táboa ou os datos da táboa de configuración do portal (por exemplo, configurar táboas de portais como adx_contentsnippet, adx_entityform ou adx_entitylist) non se admite coa API web de portais. Para obter unha lista completa, vai a táboas de configuración non compatibles máis adiante neste artigo.
- A API web dos portais benefíciase do almacenamento na caché do lado do servidor, de xeito que as chamadas posteriores á API web son máis rápidas que as chamadas iniciais. Limpar a caché do servidor do portal provoca unha degradación temporal do rendemento.
- As operacións da API web dos portais requiren unha licenza de Power Pages. Por exemplo, as chamadas da API web realizadas por usuarios anónimos descóntanse da capacidade de usuario anónimo. As chamadas á API web realizadas por usuarios autenticados (internos ou externos) non se contan para as visualizacións de páxinas, pero requiren as licenzas de capacidade de usuarios autenticados aplicables. Máis información: Preguntas frecuentes sobre licenzas de Power Pages.
Operacións da API web
A API web de portais ofrece un subconxunto de capacidades para operacións de Dataverse que pode facer usando a API de Dataverse. Mantivemos o formato da API o máis semellante posible para reducir a curva de aprendizaxe.
Nota
As operacións da API web distinguen entre maiúsculas e minúsculas.
Operacións da API web dispoñibles en Power Pages
- Ler rexistros dunha táboa
- Crear un rexistro nunha táboa
- Actualizar e eliminar rexistros nunha táboa
- Asociar e separar táboas
Configuración do sitio para a API web
Debe activar a configuración do sitio para activar a API web dos portais do seu portal. Tamén pode configurar a API web de nivel de campo que determine os campos da táboa que se poden modificar ou non coa API web dos portais.
Nota
Use o nome lóxico da táboa para esta configuración (por exemplo conta).
| Nome da configuración do sitio | Descripción |
|---|---|
| Webapi/<nome da táboa>/activado | Activa ou desactiva a API web para <nome da táboa>. Por defecto: False Valores válidos: True, False |
| Webapi/<nome da táboa>/fields | Define a lista de atributos separados por comas que se poden modificar coa API web. Valores posibles: - Todos os atributos: * - Atributos específicos: attr1,attr2,attr3 Nota: o valor debe ser un asterisco (*) ou unha lista de nomes de campo separada por comas. Importante: esta configuración é unha configuración obrigatoria do sitio. Cando falta esta configuración, ves o erro "Non se definiu ningún campo para esta entidade". |
| Webapi/error/innererror | Activa ou desactiva InnerError. Por defecto: False Valores válidos: True, False |
| Webapi/<nome da táboa>/disableodatafilter | Activa ou desactiva o filtro de OData. Por defecto: False Valores válidos: True, False Consulte problemas coñecidos para obter máis información. A configuración do sitio está dispoñible na versión do portal 9.4.10.74 ou posteriores. |
Nota
Debe configurarse a configuración do sitio en Activo para que os cambios teñan efecto.
Por exemplo, para expoñer a API web da táboa de caso onde os usuarios autenticados poden realizar operacións de creación, actualización e eliminación desta entidade, a configuración do sitio móstrase na seguinte táboa.
| Nome da configuración do sitio | Valor de configuración do sitio |
|---|---|
| Webapi/incidente/activado | verdadeiro |
| Webapi/incidente/campos | attr1, attr2, attr3 |
Seguridade coa API web de portais
Pode configurar a seguridade baseada en rexistros para rexistros individuais en portais usando permisos de táboa. A API web dos portais accede aos rexistros de táboas (entidades) e segue os permisos de táboa dados aos usuarios a través da función web asociada.
Pode configurar permisos de columna para definir aínda máis os privilexios para as columnas individuais dentro dunha táboa mentres utiliza a API web dos portais.
Autenticación das solicitudes da API web dos portais
Non é necesario incluír un código de autenticación porque a sesión da aplicación xestiona a autenticación e a autorización. Todas as chamadas da API web deben incluír un token Cross-Site Request Forgery (CSRF).
Usar EntitySetName
Cando se refire a Dataverse táboas mediante a API web de portais no seu código, cómpre utilizar o EntitySetName, por exemplo, para acceder ao account táboa, a sintaxe do código usa o EntitySetName de contas; /_api/accounts().
Nota
Use o nome lóxico da táboa para a configuración do sitio (por exemplo, conta).
Pode determinar o valor de EntitySetName de táboas específicas seguindo estes pasos:
Vaia a https://make.powerapps.com
Seleccione o separador de Dataverse desde o panel lateral e seleccione a táboa.
Seleccione ... (opción Comandos) e despois escolla Avanzado, Ferramentas e Copiar nome do conxunto para copiar o valor de EntitySetName da táboa ao portapapeis.
Leis e normativas de privacidade
Todas as cabeceiras das solicitudes usan un ID de contacto pasado para fins de auditoría. Para un usuario anónimo, este valor pásase como null.
Se o rexistro de auditoría está activado, un usuario pode ver todos os eventos de auditoría no Rexistro de auditoría de Office 365.
Máis información:
Activa e utiliza o rexistro de actividade
Exportar, configurar e ver rexistros de rexistro de auditoría
Táboas de configuración non compatibles
A API web dos portais non se pode usar para as seguintes táboas de configuración:
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
Problemas coñecidos
Os usuarios reciben un erro CDS se invocan unha GET solicitude de API web para táboas que teñen varios niveis de 1 a moitos ou moitos a moitospermisos de táboas cando Pais, **Contacto, ou Os ámbitos da conta engaden máis condicións á consulta.
Para resolver este problema, a solución recomendada é utilizar FetchXML na consulta OData.
Tamén pode configurar a configuración do sitio Webapi/<nome da táboa>/disableodatafilter en True.
Importante
Cambiar a configuración do sitio Webapi/<nome da táboa>/disableodatafilter a True pode resultar máis lento rendemento das chamadas á API web GET .
A configuración do sitio está dispoñible na versión do portal 9.4.10.74 ou posteriores.
Seguinte paso
Consulta datos mediante a API web de portais