Invocar unha función desde unha aplicación, un fluxo, un código ou outra función (vista previa)

[Este tema é a documentación de pre-lanzamento e está suxeito a cambios.]

Podes invocar funcións en Dataverse desde unha aplicación de lenzo, unha páxina personalizada nunha aplicación baseada en modelos, un fluxo, código ou desde outra función.

Importante

  • Esta é unha funcionalidade de vista previa.
  • As funcionalidades de vista previa non se deseñaron para uso de produción e poden ter funcionalidade restrinxida. Estas funcionalidades están dispoñibles antes da versión oficial para que os clientes poidan obter acceso a elas rápido e fornecer comentarios.

Invocar unha función desde unha aplicación de lenzo ou unha páxina personalizada

  1. Na área Funcións de Power Apps (make.powerapps.com), seleccione a función que quere invocar desde unha aplicación de lenzo ou páxina personalizada.
  2. Seleccione Copiar fragmento de código na barra de comandos.
  3. Pega e garda a fórmula copiada nun editor de texto, no Bloc de notas ou nalgún lugar ao que poidas consultar facilmente.
  4. En Power Apps Studio:

    1. Crea ou edita unha aplicación de lenzo ou unha páxina personalizada en Power Apps Studio.

    2. No panel de navegación da esquerda, na pestana de Fontes de Datos , selecciona Engadir datos, busca a táboa de Ambiente desde o conector Dataverse e escóllea.

      Nota

      Se a mesa de Ambiente non está dispoñible para selección, crea unha nova aplicación no mesmo entorno para activar a súa creación.

    3. Insire os seguintes compoñentes no lenzo:

      • Engade controis de entrada que se correspondan co tipo de datos de cada parámetro, como a entrada de números.
      • Engade un botón para chamar a función.
      • Engade un control de saída que se corresponda co tipo de datos do teu parámetro, como a entrada de números.
  5. Seleccione o botón que creou e, na propiedade OnSelect , introduza a súa función, como Environment.new_calculatesum.
  6. Asigne cada parámetro de entrada Value para facer referencia aos controis de entrada correspondentes:
    • Se a túa función é Environment.new_CalculateSum({ X: Value, Y: Value });, pódese reescribir como: Environment.new_CalculateSum({ X: NumberInput1.value, Y: NumberInput2.value });.
    • Para configurar a saída de "resultado" da función, actualice a fórmula a "Set(result, Environment.new_CalculateSum({ X: NumberInput1.value, Y: NumberInput2.value }))".
  7. Seleccione o control de saída e configure a propiedade "Valor" cunha fórmula de "resultado.z".

Previsualiza a túa aplicación, introduce os valores de entrada 1 e 2 e selecciona o botón. O resultado debería mostrarse no campo de saída.

Invoca funcións desde un Power Automate fluxo de nube

  1. Nun fluxo de nube, engade unha nova acción desde o Microsoft Dataverse conector.
  2. Seleccione a acción chamada Realiza unha acción sen vincular
  3. Seleccione a súa función. A función ten un nome único cun prefixo.
  4. Proporcione valores para todos os parámetros de entrada (se os houbese).

Invoca funcións desde a Dataverse API web

Siga os pasos para as seccións de accións sen vincular no artigo Invocación de API personalizadas desde a API web (dependendo do alcance axeitado do complemento).

Invoca funcións existentes desde novas funcións

Para invocar unha función existente dentro dunha función nova, use a sintaxe: Environment.ExistingFunction({inputParam1: value1, inputParam2: value2, ... inputParamN: valueN})

Dado que a saída é sempre un rexistro, use a notación de puntos para acceder aos parámetros de saída. Por exemplo, se a función "ExistingFunction" ten dous parámetros de saída definidos como out1 e out2, pode acceder a eles de calquera destas dúas formas:

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

Limitacións coas funcións en Dataverse

  • O obxecto da linguaxe do contorno debe ler para acceder a novas funcións dentro das aplicacións de lenzo existentes. Para calquera función creada despois de engadir a fonte de datos da táboa de ambiente a unha aplicación de lenzo existente, debes eliminar e ler o Power Fx obxecto de linguaxe de ambiente. Despois ves a lista actualizada de funcións como accións.
  • Soporte anidado. As funcións só poden chamar accións de Microsoft publicadas por Microsoft desde Power Fx expresións.
  • Algúns Collect escenarios requiren Patch. Hai algúns escenarios nos que Collect() non funciona. A solución é usar Patch() como se mostra no exemplo de enchemento da columna aquí.
Patch(Faxes,
       Collect(Faxes, {  Subject : "Sub1" } ),
       { Regarding : First(Accounts) }
    )

Depura e obtén axuda coas túas funcións

Se atopas problemas ao crear ou executar a túa función, utiliza a trace() función para depurar ou vai a Limitacións con funcións en Dataverse para os problemas comúns que poidan ocorrer.

Depuración mediante a función trace().

  1. Para depurar mediante a función de rastrexo, asegúrese de activar o complemento e o seguimento da actividade do fluxo de traballo personalizado.
  2. Vaia a Power Apps (make.powerapps.com), seleccione a Configuración icona da engrenaxe na parte superior dereita e, a continuación, seleccione Configuración avanzada.
  3. Seleccione Configuración > Auditoría > Configuración de auditoría global.
  4. Na pestana Personalización , asegúrate de que Activar o rexistro no rexistro de rastrexo do complemento estea activado para Todo.

Unha vez que habilites o seguimento, podes comezar a usar as funcións trace() para depurar Power Fx fórmulas. Obtén máis información sobre como usar a función trace() dentro dunha Power Fx expresión: Función de rastrexo - Power Platform.

Contactando con axuda + soporte

Para problemas con funcións non contempladas en Microsoft Dataverse suxestións de complementos de código baixo e problemas coñecidos, como erros non documentados recibidos, utiliza a experiencia de Axuda + asistencia e inclúe a seguinte información:

  • Tipo de problema: Dataverse API web e SDK.
  • Subtipo de problema.

Funcións de exemplo

Crea e utiliza funcións en Microsoft Dataverse

  • Última actualización o