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).
Comentarios
https://aka.ms/ContentUserFeedback.
Proximamente: Ao longo de 2024, retiraremos gradualmente GitHub Issues como mecanismo de comentarios sobre o contido e substituirémolo por un novo sistema de comentarios. Para obter máis información, consulte:Enviar e ver os comentarios