Partilhar via

Utilizar plug-ins de low-code no Dataverse (pré-visualização)

  • Artigo

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

O Microsoft Dataverse oferece uma solução avançada para alcançar uma arquitetura de dados mais eficiente e reduzir a carga de trabalho do lado do cliente através de plug-ins de low-code. Estes plug-ins são fluxos de trabalho reutilizáveis em tempo real que executam um conjunto específico de comandos no Dataverse, executados no lado do servidor e acionados por processadores de eventos personalizados.

Importante

  • Esta é uma funcionalidade de pré-visualização.
  • As caraterísticas de pré-visualização não se destinam à produção e poderão ter caraterísticas restritas. Estas caraterísticas estão disponíveis antes do lançamento oficial, para que os clientes possam ter acesso antecipadamente e enviar comentários.

Tradicionalmente, os plug-ins eram criados como classes personalizadas compiladas numa assemblagem do .NET Framework, que era depois carregada e registada no Dataverse. No entanto, com a introdução de plug-ins de low-code, os utilizadores podem criar estes processadores de eventos com a mínima ou nenhuma programação obrigatória, sem a necessidade de registo manual.

Os plug-ins de low-code são armazenados numa base de dados do Dataverse e podem ser totalmente integrados no Power Apps e no Power Automate. O comportamento do fluxo de trabalho é definido utilizando a linguagem de expressões do Power Fx e pode ligar-se diretamente aos dados de negócio do Dataverse e origens de dados externas através de conectores do Power Platform. Com plug-ins de low-code, os criadores podem criar rapidamente fluxos de trabalho complexos com conhecimentos mínimos de codificação, resultando numa arquitetura de dados mais eficiente e simplificada.

Vantagens da lógica do lado do servidor

A definição da lógica de negócio do lado do servidor oferece várias vantagens, incluindo:

  • Maior segurança. Uma vez que a lógica do lado do servidor é executada no servidor, pode ajudar a impedir o acesso não autorizado a dados ou processos confidenciais.
  • Melhor desempenho. Através da execução no servidor, a lógica de negócio pode reduzir a quantidade de dados que tem de ser transferida entre o cliente e o servidor, resultando em tempos de processamento mais rápidos.
  • Consistência e fiabilidade. A lógica do lado do servidor assegura que as regras de negócio são aplicadas consistentemente em todos os clientes, reduzindo o risco de erros ou inconsistências.
  • Manutenção e atualizações mais fáceis. A centralização da lógica de negócio no servidor torna-se mais fácil de manter e atualizar, uma vez que é possível efetuar alterações num só local em vez de ter de atualizar vários clientes.
  • Escalabilidade. A lógica do lado do servidor pode ser escalada mais facilmente do que a lógica do lado do cliente, permitindo um melhor desempenho e tratamento de cargas de trabalho maiores.

Plug-ins low-code do

Existem dois tipos de plug-ins de low-code suportados no Dataverse:

Type Acionador Suporta parâmetros Âmbito suportado
Instantâneo Executado manualmente Sim Gobal e tabela
Automatizado Evento de tabela do Dataverse Não Table

Todos os plug-ins de low-code têm as seguintes propriedades comuns:

Property Descrição
Display name O nome legível por humanos do plug-in. Não pode ser alterado depois de criado.
Nome O nome interno do plug-in. É utilizado pela plataforma para identificar o componente em operações de código e base de dados. Não pode ser alterado depois de criado.
Descrição Utilizado para fornecer contexto adicional sobre o plug-in (finalidade, comportamento ou outros detalhes importantes).
Solução Utilizado para agrupar componentes e exportar para outros ambientes. Saiba mais sobre soluções.
Expression Esta é a função personalizada que pode ser utilizada para e execução de ações ou cálculos, definida utilizando a linguagem de expressões do Power Fx. Power Fx é uma linguagem de fórmula usada em Power Apps aplicativos de tela e foi estendida para ser usada em plug-ins low-code. Consulte as funções suportadas para obter mais detalhes.

Um plug-in de low-code é a lógica de código personalizado que é acionada manualmente por um utilizador. É possível utilizar parâmetros de entrada e saída personalizados.

Propriedades exclusivas:

Property Descrição
Scope Utilizado para associar um plug-in a uma tabela específica. Ele pode ser definido como tabela (mostrada como entidade) ou global, onde o escopo da tabela (entidade) significa que o plug-in é acionado com o contexto de um registro de tabela específico e o escopo global significa que a operação não está associada a uma tabela (saiba mais).
Parâmetros Os parâmetros permitem-lhe transmitir informações entre o plug-in e o contexto que o executa, facilitando a conceção da lógica de negócio que pode ser reutilizada em várias situações.

Os parâmetros de entrada são usados para fornecer dados ao plug-in e permitem controlar como a função se comporta passando valores diferentes especificados na Power Fx fórmula.

Os parâmetros de saída permitem que você recupere os resultados de uma função ou método para uso posterior em seu programa.

Tipos de dados suportados:
  • Boolean
  • Cadeia (de carateres)
  • Float
  • Decimal
  • DateTime
  • Número inteiro

Mais informações sobre como integrar a partir de um aplicativo de tela ou em um Power Automate fluxo de cloud: Integrar um plug-in de low-code

Permissões de plug-in

Tempo de conceção

Os criadores que possuam o direito de acesso personalizador de sistema ou administrador de sistema no ambiente Power Platform podem aceder a todos os plug-ins nesse ambiente. É possível utilizar direitos de acesso personalizados para restringir o acesso a plug-ins de low-code.

Tempo de execução

Quando um plug-in é invocado, acede aos dados de tabela envolvidos na definição do plug-in (as tabelas que fazem parte da fórmula ou se a tabela está associada às definições de um plug-in automatizado) no contexto do utilizador que o invocou.

Conexões

Usando funções de segurança, o acesso do conector dentro de plug-ins pode ser restrito a um conjunto específico de usuários em sua organização. Especifique quais as funções que têm privilégios de criação, leitura, atualização ou eliminação.

Pré-requisitos para criar um plug-in low-code

  • A associação ao direito de acesso de administrador de sistema ou de personalizador de sistemas no ambiente Power Platform.
  • Acesso à aplicação de acelerador do Dataverse.

Sugestão

Todos os novos ambientes têm a aplicação de acelerador do Dataverse instalada automaticamente a partir de 1 de outubro de 2023. Se já tiver o acelerador do Dataverse instalado, pode atualizar manualmente o acelerador do Dataverse.

Atualizar o Dataverse acelerador

  1. Siga as instruções para visualizar aplicações licenciadas no seu ambiente.
  2. Se o Dataverse Acelerador já estiver instalado e uma atualização estiver disponível, ela será indicada na tabela ao lado do item.
  3. Selecione Dataverse Acelerador e, em seguida, selecioneAtualizar na barra de comandos.

Sugestão

Habilite as atualizações automáticas de aplicativos para que o editor Microsoft - Power CAT receba atualizações automaticamente quando disponíveis (não é necessário para novos ambientes criados após 1º de outubro de 2023).

Nota

Se você instalou anteriormente a solução opcional low-code Plug-ins for Connectors , ela será excluída automaticamente quando você atualizar após 29 de junho de 2023. As capacidades estarão disponíveis na solução principal.

Criar um plug-in low-code instantâneo

  1. Reproduza a aplicação de acelerador do Dataverse.
  2. Selecione Criar plug-in instantâneo cartão. Crie cartão de plug-in instantâneo
  3. Forneça um nome a apresentar.
  4. Opcionalmente, defina parâmetros:
    • Selecione Novo parâmetro de entrada ou Novo parâmetro de saída e insira o rótulo e o tipo de dados.
    • Adicione mais parâmetros de entrada e saída conforme necessário.
  5. Insira a Power Fx expressão no Editor de expressões .
    • Parâmetros de entrada de referência na fórmula pelo nome de etiqueta.
    • Os parâmetros de saída devem ser referenciados dentro de colchetes, como { Out: "Return value" }.
    • Tabelas de referência Dataverse usando funções de coleta de dados, como Filter() e LookUp().
    • Se o escopo estiver definido como entidade, use ThisRecord para acessar valores de coluna na linha da tabela associada à execução do plug-in, como ThisRecord.'Account Name'.

    Sugestão

    Observe o intellisense na caixa Expressão . Vermelho sublinhado é inválido. Amarelo embaralhado significa que a sua lógica pode ser afetada por limitações de delegação. Evite problemas de delegação usando funções delegáveis.

  6. Opcionalmente, expanda Opções avançadas para modificar a solução , o escopo oua descrição.
  7. Selecione Guardar.
  8. Teste o seu plug-in de low-code instantâneo.

Exemplo: Calcule a soma de dois inteiros.

  • Crie dois parâmetros X de entrada e Y (ambos do tipo inteiro) e um parâmetro de saída, Z (tipo string).
  • Use a seguinte fórmula: {Z: X + Y }

Exemplo de plug-in instantâneo no Dataverse aplicativo Accelerator

Criar um plug-in low-code automatizado

  1. Reproduza a aplicação de acelerador do Dataverse.
  2. Selecione Criar plug-in automatizado cartão. Criar cartão de plug-in automatizado
  3. Forneça os seguintes valores:
    • Nome: insira um nome para o plug-in, como Validação de entrada.
    • Tabela: escolha uma tabela à qual associar o plug-in, como Conta.
    • Execute esta regra de plug-in quando a linha estiver. Especifique o evento de dados que invoca o plug-in.
  4. Insira a Power Fx expressão no Editor de expressões .
    • Tabelas de referência Dataverse usando funções de coleta de dados, como Filter() e LookUp().
    • Use ThisRecord para acessar valores de coluna na linha da tabela associada à execução do plug-in, como ThisRecord.'Account Name'.
  5. Opcionalmente, expanda Opções avançadas para modificar o estágio (quando isso deve ser executado) e a solução onde o plug-in é salvo.
  6. Selecione Guardar.
  7. Teste seu plug-in de low-code automatizado.

Utilizar conectores do Power Platform em plug-ins de low-code

Os conectores do Power Platform podem ser utilizados em plug-ins de low-code para integrar facilmente dados e funcionalidades de sistemas externos ao Dataverse, como o SQL Server, o Salesforce e o SharePoint, sem necessidade de codificação complexa ou desenvolvimento personalizado.

Pré-requisitos para utilizar conectores em plug-ins de low-code

Utilizar ações de conector em plug-ins de low-code

Você pode facilmente usar conectores e conectores personalizados de dentro de um plug-in low-code uma Power Fx fórmula.

  1. Crie uma ligação ao conector que pretende utilizar.
  2. Adicione um referência de ligação à conexão no Dataverse ambiente.
  3. No editor de expressões de plug-in Power Fx low-code, digite o nome do referência de ligação (o nome interno com um prefixo e sublinhado, como new_connectorName, não o nome a apresentar).
  4. A IntelliSense mostra-lhe as ações disponíveis. Selecione a a ação que pretende e, em seguida, introduza os parâmetros necessários.

Antes de usar um conector em um plug-in de low-code, revise a documentação do conector para garantir que você está a passar os parâmetros de entrada e saída corretamente.

Mais informações: exemplo

Nota

  • Nem todas as ações de conector são atualmente suportadas.
  • Não utilize o conector do Dataverse para ligar a tabelas do Dataverse a partir de uma expressão de plug-in. Em vez disso, use as funções nativas Power Fx para interagir com coleções: Filter, Search, LookUp, Patch, Collect e set, onde as colunas são tratadas como variáveis globais.

Testar um plug-in low-code

Testar plug-ins instantâneos

  1. Na tela inicial, selecione um plug-in instantâneo na lista e, em seguida, selecione Testar na barra de comandos. Também pode obter este ecrã a partir do editor de plug-in instantâneo na barra de comandos depois de a mesma ter sido guardada. Selecione Testar para o plug-in low-code

  2. Forneça valores para quaisquer parâmetros de entrada definidos no plug-in low-code e selecione Executar. Selecione Executar para testar low-code plug-in

Observe a resposta.

Sugestão

Utilize parâmetros de saída para ajudar a validar o comportamento e os resultados esperados. Caso contrário, só verá um êxito ou uma falha no momento do teste.

Testar plug-ins automatizados

Teste os plug-ins automatizados invocando o evento de dados. Observe se o plug-in foi executado com sucesso validando as alterações esperadas que estavam definidas na fórmula.

Sugestão

Durante a pré-visualização, pode invocar o evento de dados associado utilizando o editor de tabelas no Power Apps:

  1. Faça login Power Apps, vá para Tabelas e selecione a tabela Plug-in .
  2. Na barra de comando, selecione Editar.
  3. Crie, atualize ou elimine linhas diretamente a partir desta vista. Como alternativa, abra uma linha no formulário padrão selecionando uma linha e, em seguida, selecione Editar linha usando o formulário na barra de comandos.

Integrar um plug-in low-code

Invocar um plug-in instantâneo a partir de uma aplicação de tela ou de uma página personalizada

  1. Dataverse No aplicativo Acelerador :
    1. Selecione o plug-in instantâneo na lista.
    2. Selecione Copiar código fragmento na barra de comandos. Invocar uma instância low-code plug-in
    3. Cole e guarde a fórmula copiada num editor de texto ou bloco de notas (poderá voltar facilmente a essa fórmula).
  2. Em Power Apps:
    1. Crie ou edite uma aplicação de tela (ou página personalizada) no Power Apps studio.
    2. Na navegação à esquerda, na guia Fontes de Dados , selecione + Novo origem de dados e procure a opção Ambiente no Dataverse conector.
    3. Introduza os seguintes componentes na tela :
    • Adicione controles de entrada que correspondam ao tipo de dados de cada parâmetro, como Entrada de texto para texto ou números, alterne para booleano.
    • Se o âmbito do plug-in estiver dependente de uma tabela, adicione uma caixa de combinação associada à mesma tabela para que possa escolher a entrada.
    • Adicione um botão para chamar o plug-in.
  3. Cole a fórmula de plug-in copiada na propriedade do OnSelect botão.
  4. Mapeie cada parâmetro Value de entrada para fazer referência aos controles de entrada correspondentes:
    • Se a fórmula fosse Environment.new_CalculateSum({ X: Value, Y: Value });, poderia ser reescrita como: Environment.new_CalculateSum({ X: TextInput1.Text, Y: TextInput2.Text });
    • Se a fórmula estiver vinculada, substitua Environment pela tabela nome a apresentar para acessar o plug-in.
  5. Se um parâmetro de saída for definido para o plug-in low-code:
    1. Capture o resposta em uma Set() ou UpdateContext() fórmula: Set( ActionResult, Environments.CalculateSum({ X: TextInput1.Text, Y: TextInput2.Text }) );. Apresente a variável numa etiqueta. Como alternativa, use a Notify() fórmula para exibir dados em uma notificação.
  6. Reproduza a aplicação e selecione o comando na barra de comandos para executar o plug-in de low-code.

Saiba mais sobre como você pode chamar Dataverse ações diretamente de aplicativos Power Fx detela.

Invocar um plug-in instantâneo 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 Executar uma ação não acoplada ou Executar uma ação acoplada.
  3. Selecione o plug-in (tem o nome exclusivo com um prefixo).
  4. Forneça valores para todos os parâmetros de entrada (se for o caso).

Invocar um plug-in instantâneo a partir da API Web do Dataverse

Siga as etapas para Ação não acoplada ou Função vinculada à tabela nas seções Invocando APIs personalizadas da documentação da API da Web (dependendo do escopo apropriado do plug-in).

Obter ajuda com os seus plug-ins de low-code

Se você encontrar problemas ao criar ou executar seu plug-in low-code, vá para estas dicas para problemas comuns que podem ocorrer: Microsoft Dataverse low-code dicas de plug-ins e problemas conhecidos

Contactar a Ajuda + suporte

Para problemas com a instalação da Dataverse solução Accelerator ou low-code plug-ins não cobertos Microsoft Dataverse low-code dicas de plug-ins e problemas conhecidos, 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 de Problema - kit Accelerator para Dataverse

Exemplo de plug-ins low-code que pode criar

Para obter alguns exemplos de como criar um plug-in low-code, vá para Exemplo Dataverse low-code plug-ins (pré-visualização)

Limitações

  • O objeto de linguagem do ambiente tem de ser readicionado para aceder a novos plug-ins dentro de aplicações de tela. Para quaisquer plug-ins criados depois de ter adicionado a origem de dados da tabela de ambiente a uma aplicação de tela existente, terá de remover e voltar a adicionar o objeto de linguagem de ambiente do Power Fx. Em seguida, irá ver a lista atualizada de plug-ins como ações.

  • A IntelliSense necessita de notação explícita em plug-ins automatizados se se quiser referir a quaisquer tabelas na fórmula. Use a seguinte sintaxe de desambiguação, como [@Accounts] usar colchetes e o @ símbolo (não Accounts).

  • Suporte aninhado. Os plug-ins só podem chamar as ações de primeiros publicadas pela Microsoft a partir de expressões do Power Fx.

  • Alguns Collect cenários exigem Patch. Existem alguns cenários em que Collect() não funciona. A solução alternativa deve ser usada Patch() conforme mostrado no exemplo de coluna de preenchimento referente abaixo. Se estiver a criar um plug-in automatizado, prepare @ para cada tabela referenciada na fórmula do Power Fx.

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

  • Quando os plug-ins de low-code interagem com conectores e o DLP é utilizado, o administrador pode bloquear a criação de ligações utilizando o DLP. No entanto, as referências de ligação existentes no ambiente Dataverse continuam a funcionar. Caso o administrador precise bloquear todas as low-code interações de plug-in com quaisquer conectores, ele pode desativar a configuração da organização Allowconnectorsonpowerfxactions. Esta definição está ativada por predefinição e pode ser desativada por métodos SDK habituais (WebAPI, SDK, PowerShell, etc.). Pode desativá-la utilizando um plug-in instantâneo de low-code do seguinte modo:

    Patch(Organizations, First(Organizations), { 'Enable connectors on power fx actions.': 'Enable connectors on power fx actions. (Organizations)'.No })

  • Os plug-ins que utilizam conectores só podem ter resultados de campos específicos. Devido a este resultado, tem de mapear valores primitivos específicos a partir da resposta do conector para valores de saída.

Plug-ins de low-code que possuem limitação de conectores personalizados

Se tiver plug-ins de low-code com conectores personalizados, os conectores personalizados deverão ser importados primeiro, antes das referências de ligações ou fluxos.

Se o seu ambiente não contiver o conector personalizado numa solução, importe uma solução separada que inclua apenas o conector personalizado. Realize esta importação antes de importar a solução real. Precisa de fazê-la primeiro porque o Azure tem de registar o conector personalizado antes de outros componentes de solução poderem ser importados.

Se importar uma solução que contenha conectores personalizados e fluxos, o Azure não consegue registar o conector personalizado enquanto estiver a registar as suas referências ou fluxos de ligação. Isto também se aplica a referências de ligação para o conector personalizado que não foi previamente importado numa solução separada. Se o Azure não registou o seu conector personalizado, a importação falha e não poderá iniciar a importação.

Para obter mais informações: Criar conectores personalizados em soluções: Limitações conhecidas

Consulte também

low-code plug-ins Power Fx (pré-visualização)

Usar um prompt pré-criado em um Dataverse plug-in low-code Power Apps