Compartilhar via

Criar e usar funções no Microsoft Dataverse (versão preliminar)

  • Artigo

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

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

Importante

  • Este é um recurso em versão preliminar.
  • Os recursos de versão preliminar não foram criados para uso em ambientes de produção e podem ter funcionalidade restrita. Esses recursos são disponibilizados antes de um lançamento oficial para que os clientes possam ter acesso antecipado e forneçam comentários.

Pré-requisitos

A associação do direito de acesso do personalizador do sistema no ambiente do Power Platform.

Criar uma função em uma solução

  1. Acesse Power Apps, e selecione Soluções no painel de navegação. Se o item não estiver no painel lateral, selecione …Mais e selecione o item desejado.
  2. Abra a solução desejada na qual você deseja criar uma função.
  3. Na barra de comandos, selecione Nova>Automação>Função.
  4. Insira as seguintes informações no painel lateral Nova função que é exibido.
    • Forneça um Nome de exibição e uma Descrição para sua função.
    • Selecione Novo parâmetro de entrada e/ou Novo parâmetro de saída e, em seguida, forneça um nome e um tipo de dados para o parâmetro. Adicione mais parâmetros de entrada e de saída conforme necessário.
    • Na lista Referências de tabela, você pode selecionar tabelas, como opção. Você pode fazer referência às tabelas do Dataverse escolhidas usando funções de coleta de dados, como Filter() e LookUp().
    • Insira a expressão do Power Fx na caixa Fórmula.
  5. Selecione Salvar.
  6. Testar a função.

Faça referência aos parâmetros de entrada na fórmula por seus nomes.

Os parâmetros de saída devem ser referenciados entre chaves, como { Out: "Return value" }.

Dica

  • Observe o intellisense na caixa Fórmula. Vermelho sublinhado é inválido. Amarelo rabiscado significa que sua lógica pode ser afetada por limitações de delegação. Evite problemas de delegação usando funções delegáveis.
  • Expanda Opções avançadas para revisar o nome do esquema.

Funções de exemplo

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

Calcular a soma de dois números inteiros

  1. Insira um Nome de exibição, como new_calculateSum, e uma Descrição.

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

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

    Função que multiplica dois números.

  4. Testar a função.

Adicione um novo título à tabela do artigo

  1. Crie dois parâmetros de entrada título e url (ambos com tipos de dados string) e uma variável de saída, message (tipo de dados string).
  2. Selecione a tabela Artigos Federados de Conhecimento na lista suspensa Referências da tabela.
  3. Na caixa Fórmula, insira a fórmula:
Collect('Knowledge Federated Articles',  
   { 
    Title: title, 
    URL: url 
    } 
    ); 
{ 
    message: "New Article title added: " & title 
}

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

  1. Crie um parâmetro de entrada DocumentTextInput (com tipo de dados de cadeia de caracteres) e uma variável de saída, chamada result (tipo de dados cadeia de caracteres).
  2. Na caixa Fórmula, insira 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 de uma estadia no hotel

  1. Crie seis parâmetros de entrada: noites, quartos, impostos, desconto, serviço de quarto, taxa por noite (todos com tipo de dados de cadeia de caracteres) e uma variável de saída, preço (tipo de dados flutuante).
  2. Na caixa Fórmula, insira 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, vá para Funções de exemplo (versão preliminar).

Editar, testar ou excluir uma função

Editar uma função

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

Teste uma função

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

Um teste bem-sucedido retorna 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.

Teste uma função

Dica

Use parâmetros de saída para ajudar a validar o comportamento e os resultados esperados. Caso contrário, você só observará sucesso ou falha ao testar.

Excluir uma função

Importante

Durante a visualização, não exclua suas funções da área Soluções, pois isso pode resultar em componentes órfãos. As funções devem ser excluídas acessando o Power App (make.powerapps.com) >Funções no painel de navegação esquerdo.

  1. Selecione Funções no painel de navegação esquerdo e escolha sua função. Se o item não estiver no painel lateral, selecione …Mais e selecione o item desejado.
  2. Selecione Excluir na barra de comandos.

Funções no Microsoft Dataverse (versão preliminar)