Comparteix via

Invocar una funció des d'una aplicació, un flux, un codi o una altra funció (versió preliminar)

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

Podeu invocar funcions des Dataverse d'una aplicació de llenç, una pàgina personalitzada d'una aplicació basada en models, un flux, un codi o des d'una altra funció.

Important

  • Aquesta és una característica de visualització prèvia.
  • Les característiques de visualització prèvia no estan dissenyades per a un entorn de producció i poden tenir una funcionalitat restringida. Aquestes característiques estan disponibles abans d’un llançament oficial de producte per tal que els clients el puguin utilitzar abans i enviar-nos els seus comentaris.

Invocar una funció des d'una aplicació de llenç o d'una pàgina personalitzada

  1. A l'àrea Funcions a Power Apps (make.powerapps.com), seleccioneu la funció que voleu invocar des d'una aplicació de llenç o una pàgina personalitzada.
  2. Seleccioneu Copia el fragment de codi a la barra d'ordres.
  3. Enganxa i desa la fórmula copiada en un editor de text, Bloc de notes o en algun lloc al qual puguis fer referència fàcilment.
  4. A Power Apps Studio:
    1. Creeu o editeu una aplicació de llenç o una pàgina personalitzada a Power Apps Studio.
    2. A la subfinestra de navegació esquerra, a la pestanya Fonts de dades, seleccioneu Afegeix dades i cerqueu l'opció Entorn al Dataverse connector i seleccioneu-la.
    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 l'entrada de números.
      • Afegiu un botó per cridar la funció.
      • Afegiu un control de sortida que es correspongui amb el tipus de dades del paràmetre, com ara l'entrada de números.
  5. Seleccioneu el botó que heu creat i, a la propietat OnSelect , introduïu la funció, com ara Environment.new_calculatesum.
  6. Assigneu cada paràmetre Value d'entrada per fer referència als controls d'entrada corresponents:
    • Si la vostra funció ho és Environment.new_CalculateSum({ X: Value, Y: Value });, es podria reescriure com: Environment.new_CalculateSum({ X: NumberInput1.value, Y: NumberInput2.value });.
    • Per definir la sortida "resultat" de la funció, actualitzeu la fórmula a "Set(result, Environment.new_CalculateSum({ X: NumberInput1.value, Y: NumberInput2.value }))".
  7. Seleccioneu el control de sortida i definiu la propietat 'Value' amb una fórmula de 'result.z'.

Previsualitzeu l'aplicació, introduïu els valors d'entrada 1 i 2 i seleccioneu el botó. El resultat s'ha de mostrar al camp de sortida.

Invocar funcions 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 enllaçada
  3. Seleccioneu la vostra funció. La funció té un nom únic amb un prefix.
  4. Proporcioneu valors per a tots els paràmetres d'entrada (si n'hi ha).

Invocar funcions des de l'API Dataverse web

Seguiu els passos de les seccions d'acció no enllaçada de l'article Invocació d'API personalitzades des de l'API web (en funció de l'abast adequat del complement).

Invocar funcions existents des de funcions noves

Per invocar una funció existent dins d'una funció nova, utilitzeu la sintaxi: Environment.ExistingFunction({inputParam1: value1, inputParam2: value2, ... inputParamN: valueN})

Com que la sortida sempre és un registre, utilitzeu la notació de punts per accedir als paràmetres de sortida. Per exemple, si la funció "ExistingFunction" té dos paràmetres de sortida definits com a out1 i out2, podeu accedir-hi de qualsevol d'aquestes dues maneres:

  • Environment.ExistingFunction({inputParam1: value1, inputParam2: value2, ... inputParamN: valueN}).out1
  • Environment.ExistingFunction({inputParam1: value1, inputParam2: value2, ... inputParamN: valueN}).out2

Limitacions amb funcions a Dataverse

  • L'objecte de llenguatge d'entorn s'ha de tornar a afegir per accedir a noves funcions dins de les aplicacions de llenç existents. Per a les funcions creades després d'afegir 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 funcions com a accions.
  • Suport imbricat. Només poden cridar accions de Microsoft 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() com es mostra a l'exemple de columna d'emplenament referent aquí.
Patch(Faxes,
       Collect(Faxes, {  Subject : "Sub1" } ),
       { Regarding : First(Accounts) }
    )

Depurar i obtenir ajuda amb les funcions

Si trobeu problemes per crear o executar la vostra funció, utilitzeu-la trace() per depurar o aneu a Limitacions amb funcions per Dataverse a problemes comuns que es poden produir.

Depuració mitjançant la funció trace()

  1. Per depurar mitjançant la funció de traça, assegureu-vos d'habilitar el seguiment de l'activitat del connector i del flux de treball personalitzat.
  2. Aneu a Power Apps (make.powerapps.com), seleccioneu la icona d'engranatge Configuració a la part superior dreta i, a continuació, seleccioneu Configuració avançada.
  3. Seleccioneu Configuració > d'auditoria Configuració d'auditoria > global.
  4. A la pestanya Personalització, assegureu-vos que Habilita el registre al registre de seguiment del complement estigui habilitat per a tots.

Un cop hàgiu habilitat el seguiment, podeu començar a utilitzar les funcions trace() per depurar Power Fx fórmules. Obteniu més informació sobre com utilitzar la funció trace() dins d'una Power Fx expressió: Trace function - Power Platform.

Contactar amb l'ajuda + el suport tècnic

Per a problemes amb funcions no cobertes 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.

Funcions d'exemple

Crear i utilitzar funcions a Microsoft Dataverse

  • Last updated on