Implementar un compoñente de API web dun portal de exemplo

Nota

A partir do 12 de outubro de 2022, Portais de Power Apps é Power Pages. Máis información: Microsoft Power Pages xa está dispoñible de forma xeral (blog)
Proximamente migraremos e uniremos a documentación de Portais de Power Apps coa documentación de Power Pages.

O seguinte é un exemplo de implementación dun compoñente de código que usa a API web do portal para realizar accións de creación, recuperación, actualización e eliminación. O compoñente mostra catro botóns, nos que se pode facer clic para invocar diferentes accións da API web. O resultado da chamada á API web inxéctase nun elemento div de HTML na parte inferior do compoñente de código.

Requisitos previos

• A súa versión do portal debe ser 9.3.10.x ou superior.
• O seu paquete do portal de inicio debe ser 9.2.2103.x ou superior.
• Debe activar a configuración do sitio para activar a API web dos portais do seu portal. Configuración do sitio para a API web
• Configurar a seguridade da táboa usando os permisos da táboa. Permisos de táboa mediante Studio

Código

Pode descargar o compoñente de mostra completo desde aquí.

De forma predeterminada, na mostra, o compoñente está configurado para realizar a creación, recuperación e definición dos campos de nome e ingresos nos exemplos da API web.

Para cambiar a configuración predeterminada a calquera táboa ou columna, actualice os seguintes valores de configuración como se mostra

private static \_entityName = "account";

private static \_requiredAttributeName = "name";

private static \_requiredAttributeValue = "Web API Custom Control (Sample)";

private static \_currencyAttributeName = "revenue";

private static \_currencyAttributeNameFriendlyName = "annual revenue";

O método createRecord mostra tres botóns, o que lle permite crear un rexistro de conta co campo de ingresos configurado en diferentes valores (100, 200, 300).

Cando selecciona un dos botóns de creación, o controlador de eventos de onClick do botón comproba o valor do botón seleccionado e usa a acción da API web para crear un rexistro de conta co campo de ingresos definido co valor do botón. O campo de nome do rexistro da conta establecerase como Compoñente de código da API web (mostra) cun int aleatorio engadido ao final da cadea. O método de devolución de chamada da API web inxecta o resultado da chamada (éxito ou fallo) no div resultante do control personalizado.

O método deleteRecord representa un botón que elimina o rexistro seleccionado no menú despregable. O control despregable permítelle seleccionar o rexistro da conta que quere eliminar. Unha vez que se selecciona un rexistro de conta no menú despregable e selecciona o botón Eliminar rexistro, o rexistro elimínase. O método de devolución de chamada da API web inxecta o resultado da chamada (éxito ou fallo) no div resultante do control personalizado.

O método FetchXML retrieveMultiple representa un botón no compoñente de código. Cando se chama ao método onClick deste botón, xérase un FetchXML e pásase á función retrieveMultiple para calcular o valor medio do campo de ingresos para todos os rexistros de contas. O método de devolución de chamada da API web inxecta o resultado da chamada (éxito ou fallo) no div resultante do control personalizado.

O método OData retrieveMultiple representa un botón no compoñente de código. Cando se chama o método onClick deste botón, xérase unha cadea OData e pásase á función retrieveMultiple para recuperar todos os rexistros de conta cun campo de nome que é como API web de compoñente de código (mostra), que é certo para todos os rexistros de conta creados por este compoñente de código.

Cando se recuperan correctamente os rexistros, o compoñente de código ten a lóxica de contar cantos rexistros de conta teñen o campo de ingresos establecido en 100, 200 ou 300 e mostra este reconto nun div de contenedor de estado de OData no compoñente de código. O método de devolución de chamada da API web inxecta o resultado da chamada (éxito ou fallo) no div resultante do control personalizado.

Consulte tamén

Visión xeral de Power Apps component framework
Descargar compoñentes de exemplo
Como usar os compoñentes de mostra
Crear o seu primeiro compoñente
Engadir compoñentes de código a un campo ou táboa das aplicacións baseadas en modelos
Etiqueta de modelo Liquid de compoñentes de código
API web dos portais

Nota

Pode indicarnos as súas preferencias para o idioma da documentación? Realice unha enquisa breve. (teña en conta que esa enquisa está en inglés)

Esta enquisa durará sete minutos aproximadamente. Non se recompilarán datos persoais (declaración de privacidade).