Invoque uma função a partir da aplicação, fluxo, código ou de outra função (pré-visualização)

[Este tópico é documentação de pré-lançamento e está sujeito a alterações.]

Pode invocar funções no Dataverse a partir de um aplicação de tela, de uma página personalizada numa aplicação condicionada por modelo, de um fluxo, de um código ou de outra função.

Invocar uma função a partir de uma aplicação de tela ou página personalizada

1. Na área Funções no Power Apps (make.powerapps.com), selecione a função que deseja invocar a partir de uma aplicação de tela ou página personalizada.
2. Selecione Copiar fragmento de código na barra de comandos.
3. Cole e guarde a fórmula copiada para um editor de texto, bloco de notas ou em algum lugar que possa consultar facilmente.
4. No Power Apps Studio:
   1. Crie ou edite uma aplicação de tela ou página personalizada no Power Apps Studio.
   2. No painel de navegação esquerdo, no separador Fontes de Dados, selecione Adicionar dados e procure a opção Ambiente no conector do Dataverse e selecione-a.
   3. Insira os seguintes componentes na tela:
      • Adicione controlos de entrada que correspondam ao tipo de dados de cada parâmetro, como entrada numérica.
      • Adicione um botão para chamar a função.
      • Adicione um controlo de saída que corresponda ao seu tipo de dados de parâmetro, como entrada numérica.
5. Selecione o botão quecriou e, na propriedade OnSelect, introduza a sua função, como Environment.new_calculatesum.
6. Mapeie cada Value do parâmetro de entrada para referenciar os controlos de entrada correspondentes:
   • Se a sua função for Environment.new_CalculateSum({ X: Value, Y: Value });, pode ser reescrita como: Environment.new_CalculateSum({ X: NumberInput1.value, Y: NumberInput2.value });.
   • Para definir a saída 'result' da sua função, atualize a fórmula para 'Set(result, Environment.new_CalculateSum({ X: NumberInput1.value, Y: NumberInput2.value }))'.
7. Selecione o controlo de saída e defina a propriedade 'Value' com uma fórmula de 'result.z'.

Pré-visualize a sua aplicação, introduza os valores de entrada 1 e 2 e selecione o botão. O resultado deve aparecer no campo de saída.

Invocar funções a partir de um fluxo de cloud do Power Automate

1. Num fluxo de cloud, adicione uma nova ação a partir do conector do Microsoft Dataverse .
2. Selecione a ação chamada Efetuar uma ação não dependente
3. Selecione a sua função. A função tem um nome exclusivo com um prefixo.
4. Forneça valores para todos os parâmetros de entrada (se houver).

Invocar funções da API Web do Dataverse

Siga as etapas para as secções de ação não vinculada no artigo Invocar APIs personalizadas da API Web (dependendo do âmbito apropriado do plug-in).

Invocar funções existentes a partir de novas funções

Para invocar uma função existente dentro de uma nova função, use a sintaxe: Environment.ExistingFunction({inputParam1: value1, inputParam2: value2, ... inputParamN: valueN})

Como a saída é sempre um registo, use a notação de ponto para aceder aos parâmetros de saída. Por exemplo, se a função "ExistingFunction" tiver dois parâmetros de saída definidos como out1 e out2, poderá aceder-lhes de uma destas duas maneiras:

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

Limitações com funções no Dataverse

• O objeto de linguagem de ambiente tem de ser readicionado para aceder a novas funções dentro de aplicações de tela existentes. Para todas as funções criadas depois de adicionar a origem de dados da tabela de ambiente a uma aplicação de tela existente, deve remover e adicionar novamente o objeto de linguagem do ambiente do Power Fx. Em seguida, verá a lista atualizada de funções como ações.
• Suporte aninhado. As funções só podem chamar ações Microsoft publicadas pela Microsoft a partir de expressões do Power Fx.
• Alguns cenários Collect exigem Patch. Existem alguns cenários onde Collect() não funciona. A solução é usar Patch() conforme mostrado no exemplo de preenchimento referente ao exemplo da coluna aqui.

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

Depurar e obter ajuda com as suas funções

Se encontrar problemas ao criar ou executar a sua função, use a função trace() para depuração ou vá para Limitações com funções no Dataverse problemas comuns que podem ocorrer.

Depuração usando a função trace()

1. Para depurar usando a função de rastreio, certifique-se de que ativa o plug-in e a monitorização de atividades de fluxo de trabalho personalizadas.
2. Vá para Power Apps (make.powerapps.com), selecione o ícone de engrenagem Configurações no canto superior direito e selecione Definições avançadas.
3. Selecione Definições > Auditoria > Definições de auditoria globais.
4. No separador Personalização, certifique-se de que Ativar o registo de rastreio de plug-ins está ativado para Todos.

Depois de ativar o rastreio, pode começar a usar as funções trace() para depurar fórmulas do Power Fx. Saiba mais sobre como usar a função trace() dentro de uma expressão do Power Fx: Função Trace - Power Platform.

Contactar a Ajuda + suporte

Para problemas com funções não abordadas nas sugestões e problemas conhecidos de plug-ins de low-code do Microsoft Dataverse, como erros não documentados recebidos, use a experiência Ajuda + suporte e inclua as seguintes informações:

• Tipo de Problema - API Web e SDK do Dataverse.
• Subtipo do problema.

Artigos relacionados

Funções de exemplo

Criar e utilizar funções no Microsoft Dataverse