Titorial: usar compoñentes de código de conxuntos de datos

Neste titorial, creará un compoñente de mostra usando Power Apps component framework. Power Apps component framework permite aos programadores profesionais e aos creadores de aplicacións crear compoñentes de código para aplicacións de lenzo e controladas por modelos. Estes compoñentes de código poden proporcionar unha experiencia mellorada aos usuarios que traballan con datos en formularios, vistas e paneis. Máis información: Usar compoñentes de código en Power Pages

Nota

  • Este titorial baséase no titorial existente de Power Apps component framework que lle presenta o compoñente de control de grade de Power Apps (versión preliminar) nunha lista e subgrade nunha páxina en branco. Tamén pode empregar calquera compoñente existente ou novo e engadilo a calquera outra páxina web para este titorial. Neste caso, asegúrese de usar o seu compoñente e a súa páxina web ao seguir os pasos deste titorial. Para coñecer os compoñentes de código admitidos nos portais, consulte Usar compoñentes de código en portais. 

Neste titorial aprenderá a:

  • Crear un compoñente de mostra usando Power Apps component framework
  • Empaquetar o compoñente nun ambiente de Microsoft Dataverse
  • Configurar Power Pages para engadir o compoñente a unha páxina web
  • Visitar a súa páxina web de Power Pages para interactuar co compoñente

Requisitos previos

  • Versión do portal 9.4.9.xx ou superior. 
  • Paquete do portal base de Dataverse 9.3.2209.x ou superior. 

Paso 1: Crear o seu primeiro compoñente

Complete o titorial Crear o seu primeiro compoñente.

Nota

Ao final de Crear o seu primeiro compoñente, terá un compoñente chamado TSLinearInputComponent empaquetado e cargado no seu ambiente de Dataverse.

Paso 2: Engadir o compoñente de código a visualizacións ou subgrades nunha aplicación controlada por modelos

Para engadir o seu compoñente ás subgrades, ás visualizacións e á táboa Conta, siga os pasos que se describen en Converter visualizacións e subgrades en grades editables (versión preliminar) 

Paso 3: Engadir o compoñente de código a unha lista e subgrade no portal

Neste paso, creará unha nova lista na aplicación Xestión de portais e despois engadirá o compoñente á lista creada. Tamén pode usar unha lista existente no seu lugar. 

Paso 3.1: Engadir o compoñente de código ás listas

Os seguintes pasos describen como engadir o control a un compoñente de lista.

  1. Abra a aplicación Xestión de portais.

  2. No panel esquerdo, en Contido, seleccione lista. 

  3. Seleccione Nova. 

  4. Escriba o Nome. Por exemplo, Lista de contas con compoñente de código. 

  5. Para Nome da táboa, seleccione a táboa á que engadiu o compoñente de código anteriormente neste titorial. 

  6. Seleccione o sitio web do seu portal. 

  7. Engada visualizacións na grade de configuración avanzada. 

    Engada visualizacións na grade de configuración avanzada.

  8. Seleccione Usar un compoñente de código configurado como Si. 

    Use o compoñente de código.

Agora pode engadir o compoñente da lista a unha páxina. Consulte Engadir unha lista para obter máis información sobre como engadir unha lista a unha páxina web.

Paso 3.2: Engadir o compoñente de código á subgrade

O control tamén se pode activar nunha subgrade.

  1. Abra a aplicación Xestión de portais.

  2. No panel esquerdo, en Contido, seleccione Formularios básicos. 

  3. Seleccione o formulario básico que creou no paso anterior. 

  4. Seleccione Relacionado. 

  5. Seleccione Metadatos do formulario básico. 

  6. Seleccione Novos Metadatos de Formulario básico. 

  7. Seleccione Tipo como Subgrade. 

  8. Seleccione Nome da subgrade. 

    Engadir un compoñente de código á subgrade

  9. Para o Estilo de control, seleccione Compoñente de código. 

    Seleccione un estilo de control.

O formulario deberá engadirse a unha páxina web. Consulte Engadir formulario para obter máis información sobre como engadir un compoñente de formulario a unha páxina web.

Engadir un compoñente de código baseado en conxuntos de datos mediante a etiqueta Liquid

Os compoñentes de código baseados en conxuntos de datos pódense engadir usando a etiqueta de modelo Liquid codecomponent. A clave para indicar o compoñente de código que se debe cargar pásase usando o atributo de nome. A clave pode ser o GUID (que é o ID do compoñente de código) ou o nome do compoñente de código importado en Microsoft Dataverse. 

Consulte Visión xeral de Liquid para obter detalles sobre o uso de Liquid con Power Pages.

Os valores das propiedades que espera o compoñente de código deben pasarse como un par clave/valor separados por ":" (signo de dous puntos), onde a clave é o nome da propiedade e o valor é o valor da cadea JSON. 

{% codecomponent name: <ID or name> <property1:value> <property2:value> %}

Por exemplo, para engadir un compoñente de código que espere un parámetro de entrada denominado controlValue, use a seguinte etiqueta de modelo Liquid:

{% codecomponent name:abc_SampleNamespace.MapControl controlValue:'Space Needle' controlApiKey:<API Key Value>%}

Para obter máis información, consulte Etiqueta de modelo Liquid para compoñentes de código.

Limitacións

As accións e a configuración dos filtros de metadatos en listas e subgrades non son compatibles co control de grade de Power Apps.

Consulte tamén

Usar compoñentes de código en Power Pages

  • Last updated on