Utilitzar connectors de codi baix a Dataverse (visualització prèvia)

[Aquest tema forma part de la documentació preliminar i està subjecte a canvis.]

Microsoft Dataverse ofereix una solució potent per aconseguir una arquitectura de dades més eficient i reduir la càrrega de treball del costat del client mitjançant complements de codi baix. Aquests connectors són fluxos de treball reutilitzables en temps real que executen un conjunt específic d'ordres, que s'executen al costat del servidor i s'activen mitjançant controladors d'esdeveniments Dataverse personalitzats.

Tradicionalment, els connectors es creaven com a classes personalitzades compilades en un assemblatge de .NET Framework, que després es carregaven i registraven Dataverse. Tanmateix, amb la introducció de connectors de codi baix, els usuaris poden crear aquests controladors d'esdeveniments amb una codificació mínima o sense necessitat i sense necessitat de registre manual.

Els connectors de codi baix s'emmagatzemen dins d'una Dataverse base de dades i es poden integrar perfectament a Power Apps i Power Automate. El comportament del flux de treball es defineix mitjançant el llenguatge d'expressió Power Fx i es pot connectar directament amb Dataverse dades empresarials i fonts de dades externes mitjançant Power Platform connectors. Amb els connectors de codi baix, els creadors poden construir ràpidament fluxos de treball complexos amb una experiència mínima en codificació, donant lloc a una arquitectura de dades més racionalitzada i eficient.

Avantatges de la lògica del servidor

La definició de la lògica de negoci del servidor ofereix diversos avantatges, com ara:

• Augment de la seguretat. Com que la lògica del servidor s'executa al servidor, pot ajudar a evitar l'accés no autoritzat a dades o processos sensibles.
• Millora del rendiment. En executar-se al servidor, la lògica de negoci pot reduir la quantitat de dades que s'han de transferir entre el client i el servidor, donant lloc a temps de processament més ràpids.
• Coherència i fiabilitat. La lògica del servidor garanteix que les regles de negoci s'apliquin de manera coherent a tots els clients, reduint el risc d'errors o incoherències.
• Manteniment i actualitzacions més fàcils. En centralitzar la lògica de negoci al servidor, es fa més fàcil de mantenir i actualitzar, ja que els canvis es poden fer en un sol lloc en lloc d'haver d'actualitzar diversos clients.
• Escalabilitat. La lògica del servidor es pot escalar més fàcilment que la lògica del client, cosa que permet un millor rendiment i gestió de càrregues de treball més grans.

Connectors de codi baix

Hi ha dos tipus de connectors de codi baix admesos a Dataverse:

Tots els connectors de codi baix tenen les següents propietats comunes:

Permisos de complements

Requisits previs per crear un connector de codi baix

Actualitzar l'accelerador Dataverse

1. Seguiu les instruccions per veure les aplicacions amb llicència al vostre entorn.
2. Si l'accelerador Dataverse ja està instal·lat i hi ha una actualització disponible, s'indica a la taula que hi ha al costat de l'element.
3. Seleccioneu Dataverse Accelerador i, a continuació, seleccioneu Actualitza a la barra d'ordres.

Crear un connector de codi baix a l'instant

1. Juga a l'aplicació de l'accelerador Dataverse .
2. Seleccioneu la targeta Crea un complement instantani.
3. Proporcioneu un nom de visualització.
4. Opcionalment, definiu els paràmetres:
   • Seleccioneu Paràmetre d'entrada nou o Paràmetre de sortida nou i introduïu l'etiqueta i el tipus de dades.
   • Afegiu més paràmetres d'entrada i sortida segons sigui necessari.
5. Introduïu l'expressió Power Fx a l'editor d'expressions .
   • Feu referència als paràmetres d'entrada a la fórmula pel nom de l'etiqueta.
   • Els paràmetres de sortida s'han de referenciar dins de claudàtors, com ara { Out: "Return value" }.
   • Taules de referència Dataverse mitjançant funcions de recollida de dades, com ara Filter() i LookUp().
   • Si l'àmbit està definit com a entitat, utilitzeu-lo ThisRecord per accedir als valors de columna de la fila de la taula associada amb l'execució del complement, com ara ThisRecord.'Account Name'.

   Propina

   Tingueu en compte l'intel·lectual al quadre Expressió . El vermell subratllat no és vàlid. El groc ondulat significa que la vostra lògica es pot veure afectada per les limitacions de delegació. Eviteu problemes de delegació mitjançant funcions delegables.

6. Opcionalment, expandiu Opcions avançades per modificar la solució , l'abast ola descripció.
7. Seleccioneu Desa.
8. Proveu el vostre connector de codi baix a l'instant.

Exemple: calcula la suma de dos enters.

• Creeu dos paràmetres d'entrada, X i Y (tots dos de tipus enter) i un paràmetre de sortida, Z (tipus cadena).
• Utilitzeu la fórmula següent: {Z: X + Y }

Crear un connector de codi baix automatitzat

1. Juga a l'aplicació de l'accelerador Dataverse .
2. Seleccioneu la targeta Crea un complement automàtic.
3. Proporcioneu els valors següents:
   • Nom: introduïu un nom per al connector, com ara Validació d'entrada.
   • Taula: trieu una taula a la qual associar el connector, com ara Compte.
   • Executeu aquesta regla de complement quan la fila sigui. Especifiqueu l'esdeveniment de dades que invoca el complement.
4. Introduïu l'expressió Power Fx a l'editor d'expressions .
   • Taules de referència Dataverse mitjançant funcions de recollida de dades, com ara Filter() i LookUp().
   • Utilitzeu-lo ThisRecord per accedir als valors de columna de la fila de la taula associada amb l'execució del connector, com ara ThisRecord.'Account Name'.
5. Opcionalment, expandiu Opcions avançades per modificar la fase (quan s'hauria d'executar) i la solució on es desa el complement.
6. Seleccioneu Desa.
7. Proveu el vostre connector automatitzat de codi baix.

Utilitzar Power Platform connectors en connectors de codi baix

Power Platform Els connectors es poden utilitzar en connectors de codi baix per integrar fàcilment dades i funcionalitats de sistemes externs Dataverse, com ara SQL Server, Salesforce i SharePoint sense necessitat de codificació complexa o desenvolupament personalitzat.

Requisits previs per utilitzar connectors en connectors de codi baix

Ús d'accions de connector en connectors de codi baix

Podeu utilitzar fàcilment connectors i connectors personalitzats des d'un connector de codi baix i una Power Fx fórmula.

1. Creeu una connexió amb el connector que voleu utilitzar.
2. Afegiu una referència de connexió a la connexió a l'entorn Dataverse .
3. A l'editor d'expressions de Power Fx connector de codi baix, escriviu el nom de la referència de connexió (el nom intern amb un prefix i un guió baix, com ara new_connectorName, no el nom de visualització).
4. L'Intellisense us mostra les accions disponibles. Seleccioneu l'acció que vulgueu i introduïu els paràmetres necessaris.

Abans d'utilitzar un connector en un connector de codi baix, reviseu la documentació del connector per assegurar-vos que esteu passant els paràmetres d'entrada i sortida correctament.

Més informació: exemple

Provar un connector de codi baix

Provar connectors instantanis

1. A la pantalla d'inici , seleccioneu un connector instantani de la llista i, a continuació, seleccioneuProva a la barra d'ordres. També podeu accedir a aquesta pantalla des de l'editor de connectors instantanis a la barra d'ordres després d'haver-la desat.

2. Proporcioneu valors per als paràmetres d'entrada definits al connector de codi baix i, a continuació, seleccioneu Executa.

Observeu la resposta.

Prova de connectors automatitzats

Proveu els connectors automatitzats invocant l'esdeveniment de dades. Observeu si el connector s'ha executat correctament validant els canvis esperats definits a la fórmula.

Integrar un connector de codi baix

Invocar un complement instantani des d'una aplicació de llenç o d'una pàgina personalitzada

1. A l'aplicació Dataverse Accelerador :
   1. Seleccioneu el connector instantani a la llista.
   2. Seleccioneu Copia el fragment de codi a la barra d'ordres.
   3. Enganxeu i deseu la fórmula copiada en un editor de text o bloc de notes (en un lloc on pugueu consultar-vos fàcilment).
2. A Power Apps:
   1. Creeu o editeu una aplicació de llenç (o una pàgina personalitzada) a l'estudi Power Apps .
   2. A la navegació esquerra, a la pestanya Fonts de dades, seleccioneu + Font de dades nova i cerqueu l'opció Entorn des del Dataverse connector.
   3. Inseriu els components següents al llenç:
   • Afegiu controls d'entrada que es corresponguin amb el tipus de dades de cada paràmetre, com ara Entrada de text per a text o números, commuta per booleà.
   • Si l'àmbit del connector està vinculat a una taula, afegiu un quadre combinat associat a la mateixa taula per poder triar l'entrada.
   • Afegiu un botó per trucar al connector.
3. Enganxeu la fórmula del connector que heu copiat a la propietat del OnSelect botó.
4. Assigneu cada paràmetre Value d'entrada per fer referència als controls d'entrada corresponents:
   • Si la fórmula ho fos Environment.new_CalculateSum({ X: Value, Y: Value });, es podria reescriure com: Environment.new_CalculateSum({ X: TextInput1.Text, Y: TextInput2.Text });
   • Si la fórmula estava enlligada, substituïu-la Environment pel nom de visualització de la taula per accedir al connector.
5. Si es defineix un paràmetre de sortida per al connector de codi baix:
   1. Captura la resposta en una Set() fórmula o UpdateContext() : Set( ActionResult, Environments.CalculateSum({ X: TextInput1.Text, Y: TextInput2.Text }) );. Mostra la variable en una etiqueta. També podeu utilitzar la Notify() fórmula per mostrar dades en una notificació.
6. Reprodueix l'aplicació i selecciona l'ordre a la barra d'ordres per executar el connector de codi baix.

Obteniu més informació sobre com podeu trucar Dataverse accions directament des de Power Fx les aplicacions de llenç.

Invocar un complement instantani des d'un Power Automate flux de núvol

1. En un flux de núvol, afegiu una acció nova des del Microsoft Dataverse connector.
2. Seleccioneu l'acció anomenada Realitza una acció no enlligada o Realitza una acció lligada.
3. Seleccioneu el vostre connector (té el nom únic amb un prefix).
4. Proporcioneu valors per a tots els paràmetres d'entrada (si n'hi ha).

Invocar un complement instantani des de l'API Dataverse web

Seguiu els passos de les seccions Acció no enllaçada o Funció vinculada a la taula a la documentació Invocació d'API personalitzades des de l'API web (en funció de l'abast adequat del complement).

Obtenir ajuda amb els connectors de codi baix

Si teniu problemes per crear o executar el connector de codi baix, aneu a aquests consells per obtenir problemes habituals que es poden produir: Microsoft Dataverse Consells per a connectors de codi baix i problemes coneguts

Contactar amb Ajuda + assistència

Per a problemes amb la instal·lació de la Dataverse solució Accelerator o complements de codi baix no coberts als Microsoft Dataverse consells de connectors de codi baix i problemes coneguts, com ara errors no documentats rebuts, utilitzeu l'experiència Ajuda + suport tècnic i incloeu la informació següent:

• Tipus de problema: Dataverse API web i SDK
• Subtipus de problema: kit d'acceleració per a Dataverse

Exemples de connectors de codi baix que podeu crear

Per obtenir alguns exemples de com crear un connector de codi baix, aneu a Exemples Dataverse de complements de codi baix (versió preliminar)

Limitacions

• L'objecte de llenguatge de l'entorn s'ha de tornar a afegir per accedir als connectors nous dins de les aplicacions de llenç existents. Per als complements creats després d'haver afegit la font de dades de la taula d'entorn a una aplicació de llenç existent, heu de suprimir i tornar a afegir l'objecte de llenguatge de l'entorn Power Fx . A continuació, veureu la llista actualitzada de connectors com a accions.

• L'Intellisense requereix notació explícita en complements automàtics si voleu fer referència a qualsevol taula de la fórmula. Utilitzeu la següent sintaxi de desambiguació, com ara [@Accounts] utilitzar claudàtors i el @ símbol (no Accounts).

• Suport imbricat. Els complements només poden cridar accions pròpies publicades per Microsoft des d'expressions Power Fx .

• Alguns Collect escenaris requereixen Patch. Hi ha alguns escenaris en què Collect() no funciona. La solució alternativa s'ha d'utilitzar Patch() tal com es mostra a l'exemple de columna d'emplenament referent a continuació. Si esteu creant un complement automàtic, antepenseu @ a cada taula a la qual es fa referència a la Power Fx fórmula.

  Patch(Faxes,
      Collect(Faxes, { Subject : "Sub1" } ),
      { Regarding : First(Accounts) }
  )
  

• Quan els connectors de codi baix interactuen amb connectors i s'utilitza DLP, l'administrador pot bloquejar la creació de connexions mitjançant DLP. No obstant això, les referències de connexió existents a l'entorn Dataverse continuen funcionant. En cas que l'administrador hagi de bloquejar totes les interaccions de connectors de codi baix amb qualsevol connector, pot inhabilitar la configuració Allowconnectorsonpowerfxactions de l'organització. Aquesta configuració està habilitada per defecte i es pot inhabilitar mitjançant els mètodes habituals de l'SDK (WebAPI, SDK, PowerShell, etc.). Podeu desactivar-ho mitjançant un connector instantani de codi baix de la següent manera:

  Patch(Organizations, First(Organizations), { 'Enable connectors on power fx actions.': 'Enable connectors on power fx actions. (Organizations)'.No })
  

• Els connectors que utilitzen connectors només poden generar resultats de camps específics. A causa d'això, heu d'assignar valors primitius específics de la resposta del connector als valors de sortida.

Connectors de codi baix que tenen limitació de connectors personalitzats

Si teniu connectors de codi baix amb connectors personalitzats, els connectors personalitzats s'han d'importar primer, abans que les referències o fluxos de connexió.

Si el vostre entorn no conté el connector personalitzat en una solució, importeu una solució independent que només inclogui el connector personalitzat. Feu aquesta importació abans d'importar la solució real. Primer heu de fer-ho perquè l'Azure ha de registrar el connector personalitzat abans que es puguin importar els altres components de la solució.

Si importeu una solució que conté connectors i fluxos personalitzats, l'Azure no pot registrar el connector personalitzat mentre registra les referències o els fluxos de connexió. Això també s'aplica a les referències de connexió per al connector personalitzat que no s'han importat anteriorment en una solució independent. Si l'Azure no ha registrat el connector personalitzat, la importació falla o no podeu iniciar la importació.

Més informació: Crear connectors personalitzats en solucions: limitacions conegudes

Consulteu també

Connectors Power Fx de codi baix (visualització prèvia)

Utilitzar un missatge predefinit en un Dataverse connector de codi baix Power Apps

Crear un connector automatitzat de codi baix amb Power Apps (vídeo)

Crear un connector de codi baix a l'instant amb Power Apps (vídeo)