Criar e utilizar funções no Microsoft Dataverse (pré-visualização)

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

Criar e utilizar funções reutilizáveis no Microsoft Dataverse. As funções usam o Power Fx para executar um conjunto específico de comandos dentro do Dataverse que são executados do lado do servidor.

Pré-requisitos

Associação ao direito de acesso de personalizador de sistema no ambiente do Power Platform.

Criar uma função numa solução

1. Aceda a Power Apps e, em seguida, selecione Soluções no painel de navegação esquerdo. Se o item não estiver no painel lateral, selecione ...Mais e, em seguida, selecione o item pretendido.
2. Abra a solução onde pretende criar uma função.
3. Na barra de comando, selecione Nova>Automatização>Função.
4. Introduza as seguintes informações no painel lateral Nova função que aparece.
   • Forneça um Nome a apresentar e uma Descrição para a sua função.
   • Selecione Novo parâmetro de entrada e/ou Novo parâmetro de saída e forneça um nome e um tipo de dados para o parâmetro. Adicione mais parâmetros de entrada e saída conforme necessário.
   • Na lista Referências de tabela pode, opcionalmente, selecionar tabelas. Pode referenciar as tabelas do Dataverse escolhidas usando funções de recolha de dados, como Filter() e LookUp().
   • Introduza a expressão do Power Fx na caixa Fórmula.
5. Selecione Guardar.
6. Testar a função.

Referencie parâmetros de entrada na fórmula pelos nomes respetivos.

Os parâmetros de saída têm de ser referenciados dentro de chavetas, como { Out: "Return value" }.

Funções de exemplo

Esta secção fornece alguns exemplos de funções.

Calcular a soma de dois números inteiros

1. Introduza um Nome a apresentar, como new_calculateSum e uma Descrição.

2. Adicione dois parâmetros de entrada, x e y (ambos do tipo de dados de número inteiro) e um parâmetro de saída, z (tipo de dados de número inteiro).

3. Na caixa Fórmula, introduza a fórmula:
   { z:x+y }

   

4. Testar a função.

Adicionar um novo título à tabela de artigos

1. Crie dois parâmetros de entrada, título e URL (ambos com tipos de dados de cadeia) e uma variável de saída, mensagem (tipo de dados de cadeia).
2. Selecione a tabela Artigos Federados de Conhecimento na lista pendente Referências de tabela.
3. Na caixa Fórmula, introduza a fórmula:

Collect('Knowledge Federated Articles',  
   { 
    Title: title, 
    URL: url 
    } 
    ); 
{ 
    message: "New Article title added: " & title 
}

Valide se uma cadeia de entrada contém as cadeias de sua escolha

1. Crie um parâmetro de entrada DocumentTextInput (com tipo de dados de cadeia) e uma variável de saída, chamada result (tipo de dados de cadeia).
2. Na caixa Fórmula, introduza a fórmula:

{
    result: If("Confidentiality" in DocumentTextInput && "Dispute Resolution" in DocumentTextInput && "Governing Law" in DocumentTextInput && "Termination" in DocumentTextInput, 

    "Document is compliant.", 
    "Document is missing one or more compliance clauses." 
    ) 
}

Calcular o preço da estadia num hotel

1. Crie seis parâmetros de entrada: noites, quartos, impostos, desconto, serviço de quarto, preço por noite (todos com tipo de dados de cadeia) e uma variável de saída, preço (tipo de dados flutuante).
2. Na caixa Fórmula, introduza a fórmula:

{ 
   price: ((nights*rooms*ratepernight)*(1+(tax/100))*(1-(discount/100)))+roomservice 

}

Mais exemplos de funções

Para obter mais funções de exemplo, aceda a Funções de exemplo (pré-visualização).

Editar, testar ou eliminar uma função

Editar uma função

1. Selecione a sua função na área Funções.
2. Selecione Editar na barra de comandos.
3. Modifique a fórmula e, em seguida, Guarde-a.

Testar uma função

1. Selecione a função na área Funções.
2. Selecione Testar na barra de comando.
3. Forneça valores para os parâmetros de entrada definidos na função e, em seguida, selecione Reproduzir.

Um teste bem-sucedido devolve uma resposta OData que inclui informações como o URI da organização, o nome da função e os parâmetros e valores de saída.

Eliminar uma função

1. Selecione Funções no painel de navegação à esquerda e, em seguida, selecione a sua função. Se o item não estiver no painel lateral, selecione ...Mais e, em seguida, selecione o item pretendido.
2. Selecione Eliminar na barra de comandos.

Artigos relacionados

Funções no Microsoft Dataverse (pré-visualização)