Tutorial: Ús de components de codi de conjunt de dades

En aquest tutorial, creareu un component d'exemple mitjançant el Power Apps component framework. El Power Apps component framework capacita els desenvolupadors professionals i els desenvolupadors d'aplicacions per crear components de codi per a les aplicacions basades en model i de llenç. Aquests components de codi poden proporcionar una experiència millorada per als usuaris que treballen amb dades de formularis, visualitzacions i escriptoris digitals. Més informació: Utilitzar components de codi al Power Pages

Nota

  • Aquest tutorial es basa en el tutorial existent de Power Apps component framework, que us guia pel component del control de quadrícula del Power Apps (versió preliminar) per a llista i subquadrícula en pàgines en blanc. També podeu utilitzar qualsevol component existent o nou, i afegir-lo a qualsevol altra pàgina web per a aquest tutorial. En aquest cas, assegureu-vos d'utilitzar el component i la pàgina web quan seguiu els passos d'aquest tutorial. Per conèixer els components de codi compatibles als portals, vegeu Utilitzar components de codi als portals

En aquest tutorial, aprendreu com:

  • Crear un component d'exemple mitjançant el Power Apps component framework
  • Crear un paquet amb el component en un entorn del Microsoft Dataverse
  • Configurar el Power Pages per el component a una pàgina web
  • Visitar la pàgina web del Power Pages per interactuar amb el component

Requisits previs

  • Portal versió9.4.9.xx o superior. 
  • Paquet de portal base del Dataverse 9.3.2209.x o superior. 

Pas 1: crear el vostre primer component

Completeu el tutorial Crear el primer component.

Nota

Al final del tutorial Crear el primer component, tindreu un component anomenat TSLinearInputComponent empaquetat i carregat al vostre entorn del Dataverse.

Pas 2: afegir el component de codi a visualitzacions o subquadrícules en una aplicació basada en model

Per afegir el component a la taula Compte, visualitzacions i subquadrícules, seguiu els passos de Convertir les visualitzacions i subquadrícules en quadrícules editables (versió preliminar) 

Pas 3: afegir un component de codi a una llista i subquadrícula al portal

En aquest pas, creareu una nova llista a l'aplicació administració de portals i, a continuació, afegireu el component a la llista creada. En lloc d'això, també podeu utilitzar una llista existent. 

Pas 3.1: afegir el component de codi a llistes

Els passos següents detallen com afegir el control a un component de llista.

  1. Obriu l'aplicació Administració de portals.

  2. A la subfinestra esquerra, a Contingut, seleccioneu Llista

  3. Seleccioneu Crea

  4. Introduïu el nom. Per exemple, Llista de comptes amb component de codi

  5. Per al Nom de la taula, seleccioneu la taula a la qual heu afegit el component de codi anteriorment en aquest tutorial. 

  6. Seleccioneu el lloc web del vostre portal. 

  7. Afegiu visualitzacions sota la quadrícula de configuració avançada. 

    Afegir visualitzacions a la quadrícula de configuració avançada.

  8. Seleccioneu Utilitza un component de codi configurat com a  

    Utilitzar components de codi

Afegireu el component de llista a una pàgina. Vegeu Afegir una llista per veure els detalls sobre com afegir una llista a una pàgina web.

Pas 3.2: afegir el component de codi a la subquadrícula

El control també es pot habilitar en una subquadrícula.

  1. Obriu l'aplicació Administració de portals.

  2. A la subfinestra esquerra, a Contingut, seleccioneu Formularis bàsics

  3. Seleccioneu el formulari bàsic que heu creat al pas anterior. 

  4. Seleccioneu Relacionada

  5. Seleccioneu Metadades de formulari bàsic. 

  6. Seleccioneu Metadades de formulari bàsic noves

  7. Seleccioneu Tipus com a Subquadrícula

  8. Seleccioneu Nom de la subquadrícula

    Afegir un component de codi a la subquadrícula.

  9. Per a Estil de control, seleccioneu Component de codi

    Seleccionar l'estil del control.

Cal afegir el formulari a una pàgina web. Vegeu Afegir formulari per veure els detalls sobre com afegir un component de formulari a una pàgina web.

Afegir un component de codi basat en un conjunt de dades amb l'etiqueta de Liquid

Els components de codi basats en un conjunt de dades es poden afegir amb l'etiqueta de plantilla de Liquid codecomponent. La clau per denotar el component de codi que s'ha de carregar es passa amb l'atribut de nom. La clau pot ser el GUID (que és l'ID del component de codi) o el nom del component de codi importat al Microsoft Dataverse. 

Vegeu la informació general de Liquid per obtenir més informació sobre l'ús de Liquid amb Power Pages

Els valors de les propietats que espera el component de codi s'han de passar com a parell clau/valor separat per ":" (signe de dos punts), on la clau és el nom de la propietat i el valor és el valor de cadena JSON. 

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

Per exemple, per afegir un component de codi que esperi un paràmetre d'entrada anomenat controlValue, feu servir el amb l'etiqueta de plantilla Liquid següent:

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

Per obtenir més informació, vegeu Etiqueta de plantilla de Liquid per a components del codi.

Limitacions

La configuració d'accions i de filtre de metadades a les llistes i a la subquadrícula no està admesa amb el control de quadrícula del Power Apps.

Consulteu també

Utilitzar components de codi al Power Pages