Usa complementos de código baixo en Dataverse (vista previa)

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

Microsoft Dataverse ofrece unha solución poderosa para lograr unha arquitectura de datos máis eficiente e reducir a carga de traballo do cliente mediante complementos de código baixo. Estes complementos son fluxos de traballo reutilizables en tempo real que executan un conxunto específico de comandos dentro de Dataverse, executándose no servidor e desencadeados por controladores de eventos personalizados.

Importante

  • Os complementos instantáneos de código baixo teñen prioridade e non se entregan como función. Os complementos instantáneos de código baixo substitúense por funcións. Máis información: Funcións en Microsoft Dataverse (vista previa)
  • 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.

Tradicionalmente, os complementos creáronse como clases personalizadas compiladas nun conxunto .NET Framework, que logo se cargaban e rexistraban dentro Dataverse. Non obstante, coa introdución de complementos de código baixo, os usuarios poden crear estes controladores de eventos sen necesidade de codificación mínima ou sen necesidade de rexistrarse manualmente.

Os complementos de código baixo gárdanse nunha Dataverse base de datos e pódense integrar perfectamente en Power Apps e Power Automate. O comportamento do fluxo de traballo defínese mediante a Power Fx linguaxe de expresión e pódese conectar directamente con Dataverse datos da empresa e fontes de datos externas a través de Power Platform conectores. Con complementos de código baixo, os creadores poden construír rapidamente fluxos de traballo complexos cunha experiencia mínima en codificación, o que resulta nunha arquitectura de datos máis simplificada e eficiente.

Beneficios da lóxica do servidor

Definir a lóxica empresarial do servidor ofrece varias vantaxes, entre elas:

  • Aumento da seguridade. Dado que a lóxica do servidor execútase no servidor, pode axudar a evitar o acceso non autorizado a datos ou procesos sensibles.
  • Rendemento mellorado. Ao executar no servidor, a lóxica empresarial pode reducir a cantidade de datos que se deben transferir entre o cliente e o servidor, o que resulta en tempos de procesamento máis rápidos.
  • Consistencia e fiabilidade. A lóxica do servidor garante que as regras comerciais se apliquen de forma consistente en todos os clientes, reducindo o risco de erros ou inconsistencias.
  • Mantemento e actualizacións máis fáciles. Ao centralizar a lóxica empresarial no servidor, faise máis fácil manter e actualizar, xa que os cambios pódense facer nun só lugar en lugar de ter que actualizar varios clientes.
  • Escalabilidade. A lóxica do servidor pódese escalar máis facilmente que a lóxica do cliente, o que permite un mellor rendemento e manexo de cargas de traballo maiores.

Complementos de código baixo

Hai dous tipos de complementos de código baixo admitidos en Dataverse:

Tipo Desencadeador Admite parámetros Ámbito compatible
Instantáneo Executar manualmente Si Global e de táboa
Automatizado Dataverse evento de mesa No Table

Todos os complementos de código baixo teñen as seguintes propiedades comúns:

Propiedade Descripción
Nome para mostrar O nome lexible por humanos do complemento. Non se pode cambiar unha vez creado.
Nome O nome interno do complemento. É usado pola plataforma para identificar o compoñente en operacións de código e base de datos. Non se pode cambiar unha vez creado.
Descripción Utilízase para proporcionar contexto adicional sobre o complemento (propósito, comportamento ou outros detalles importantes).
Solución Úsase para agrupar compoñentes e exportar a outros ambientes. Obtén máis información sobre solucións.
Expression Esta é a función personalizada que se pode usar para realizar accións ou cálculos, definida mediante a linguaxe de expresión Power Fx . Power Fx é unha linguaxe de fórmulas que se usa nas Power Apps aplicacións de lenzo e estendeuse para usarse en complementos de código baixo. Consulta as funcións admitidas para obter máis detalles.

Un complemento instantáneo de código baixo é unha lóxica de código personalizado que un usuario activa manualmente. Pódense usar parámetros de entrada e saída personalizados.

Propiedades únicas:

Propiedade Descripción
Scope Utilízase para asociar un complemento a unha táboa específica. Pódese establecer en táboa (mostrada como entidade) ou global, onde o ámbito da táboa (entidade) significa que o complemento se activa co contexto dun rexistro de táboa específico e o ámbito global significa que a operación non está asociada a unha táboa (máis información).
Parámetros Os parámetros permítenche pasar información entre o complemento e o contexto que o executa, facilitando o deseño da lóxica empresarial que se pode reutilizar en diferentes situacións.

Os parámetros de entrada utilízanse para proporcionar datos ao complemento e permítenche controlar o comportamento da función pasando os diferentes valores que especifique na fórmula Power Fx .

Os parámetros de saída permítenche recuperar os resultados dunha función ou método para o seu uso posterior no programa.

Tipos de datos admitidos:
  • booleano
  • String
  • Float
  • Decimal
  • DataHora
  • Número enteiro

Máis información sobre como integrar desde unha aplicación de lenzo ou nun Power Automate fluxo na nube: Integra un complemento de código baixo

Permisos de complementos

Tempo de deseño

Os creadores que teñan pertenza á función de seguranza de administrador do sistema ou de personalizador do sistema no Power Platform entorno poden acceder a todos os complementos dese ambiente. Os roles de seguranza personalizados pódense usar para restrinxir o acceso a complementos de código baixo.

Tempo de execución

Cando se invoca un complemento, accede aos datos da táboa implicados na definición do complemento (as táboas que forman parte da fórmula ou se a táboa está asociada coa configuración dun complemento automatizado) no contexto do usuario que o invocou.

Conexións

Usando os roles de seguranza, o acceso aos conectores dentro dos complementos pódese restrinxir a un conxunto específico de usuarios da túa organización. Especifique que roles teñen privilexios de creación, lectura, actualización ou eliminación.

Requisitos previos para crear un complemento de código baixo

  • Pertenza á función de seguranza do administrador do sistema ou do personalizador do sistema no Power Platform entorno.
  • Acceso á aplicación Dataverse acelerador.

Suxestión

Todos os contornos novos teñen a aplicación aceleradora Dataverse instalada automaticamente a partir do 1 de outubro de 2023. Se xa tiñas o Dataverse acelerador instalado, podes actualizar o Dataverse acelerador manualmente.

Actualiza o Dataverse acelerador

  1. Sigue as instrucións para ver aplicacións con licenza no teu contorno.
  2. Se o Dataverse Accelerator xa está instalado e hai unha actualización dispoñible, indícase na táboa situada xunto ao elemento.
  3. Seleccione Dataverse Acelerador e, a continuación, seleccione Actualizar na barra de comandos.

Suxestión

Activa as actualizacións automáticas das aplicacións para o editor de Microsoft - Power CAT para que reciba automaticamente actualizacións cando estean dispoñibles (non é necesario para os novos contornos creados despois do 1 de outubro de 2023).

Nota

Se instalaches previamente a solución opcional Complementos de baixo código para conectores , eliminarase automaticamente cando a actualices despois do 29 de xuño de 2023. As capacidades estarán dispoñibles na solución principal.

Crea un complemento instantáneo de código baixo

  1. Xoga a aplicación Dataverse acelerador.
  2. Seleccione a tarxeta Crear complemento instantáneo . Crea unha tarxeta de plug-in instantánea
  3. Fornece un Nome para mostrar.
  4. Opcionalmente, defina parámetros:
    • Seleccione Novo parámetro de entrada ou Novo parámetro de saída e, a continuación, introduza a etiqueta e o tipo de datos.
    • Engade máis parámetros de entrada e saída segundo sexa necesario.
  5. Introduza a Power Fx expresión no editor de Expresión .
    • Fai referencia aos parámetros de entrada na fórmula polo nome da etiqueta.
    • Os parámetros de saída deben estar referenciados entre corchetes, como { Out: "Return value" }.
    • Consulta Dataverse táboas mediante funcións de recollida de datos, como Filter() e LookUp().
    • Se o ámbito está definido como entidade, use ThisRecord para acceder aos valores das columnas na fila da táboa asociada á execución do complemento, por exemplo ThisRecord.'Account Name'.

    Suxestión

    Teña en conta o intelisense na caixa Expresión . O vermello subliñado non é válido. O amarelo ondulado significa que a túa lóxica pode verse afectada polas limitacións de delegación. Evite problemas de delegación utilizando funcións delegables.

  6. Opcionalmente, expanda Opcións avanzadas para modificar a solución, ámbito ou descrición.
  7. Seleccione Gardar.
  8. Proba o teu complemento instantáneo de código baixo.

Exemplo: calcula a suma de dous números enteiros.

  • Crea dous parámetros de entrada, X e Y (ambos de tipo enteiro) e un parámetro de saída, Z (tipo cadea).
  • Use a seguinte fórmula: {Z: X + Y }

Exemplo de complemento instantáneo na Dataverse aplicación Acelerador

Crea un complemento automatizado de código baixo

  1. Xoga a aplicación Dataverse acelerador.
  2. Seleccione a tarxeta Crear complemento automático . Crea unha tarxeta de complemento automatizada
  3. Proporcione os seguintes valores:
    • Nome: introduce un nome para o complemento, como Validación de entrada.
    • Táboa: escolle unha táboa á que asociar o complemento, como Conta.
    • Execute esta regra de complementos cando a fila sexa . Especifique o evento de datos que invoca o complemento.
  4. Introduza a Power Fx expresión no editor de Expresión .
    • Consulta Dataverse táboas mediante funcións de recollida de datos, como Filter() e LookUp().
    • Use ThisRecord para acceder aos valores das columnas da fila da táboa asociada á execución do complemento, como ThisRecord.'Account Name'.
  5. Opcionalmente, expande Opcións avanzadas para modificar a etapa (cando debería executarse) e a solución onde se garda o complemento.
  6. Seleccione Gardar.
  7. Proba o teu complemento automatizado de código baixo.

Usa conectores Power Platform en complementos de código baixo

Power Platform os conectores pódense usar en complementos de código baixo para integrar facilmente datos e funcionalidades de sistemas fóra de Dataverse, como SQL Server, Salesforce e SharePoint, sen necesidade de codificación complexa ou desenvolvemento personalizado.

Requisitos previos para usar conectores en complementos de código baixo

Usando accións do conector en complementos de código baixo

Podes usar facilmente conectores e conectores personalizados desde un complemento de código baixo a Power Fx fórmula.

  1. Crea unha conexión co conector que queres usar.
  2. Engade unha referencia de conexión á conexión no Dataverse entorno.
  3. No editor de expresións do complemento de código baixo Power Fx escriba o nome da referencia de conexión (o nome interno cun prefixo e guión baixo, como new_connectorName, non o nome para mostrar).
  4. Intellisense móstrache as accións dispoñibles. Seleccione a acción que desexe e introduza os parámetros necesarios.

Antes de usar un conector nun complemento de código baixo, revisa a documentación do conector para asegurarte de que estás pasando os parámetros de entrada e saída correctamente.

Máis información: exemplo

Nota

Proba un complemento de código baixo

Proba os complementos instantáneos

  1. Na Pantalla de inicio, selecciona un complemento instantáneo da lista e, a continuación, selecciona Proba na barra de comandos. Tamén podes acceder a esta pantalla desde o editor de complementos instantáneos na barra de comandos despois de gardala. Seleccione Probar para o complemento de código baixo

  2. Proporcione valores para calquera parámetro de entrada definido no complemento de código baixo e, a continuación, seleccione Executar. Seleccione Executar para probar o complemento de código baixo

Observa a resposta.

Suxestión

Use parámetros de saída para axudar a validar o comportamento e os resultados esperados. En caso contrario, só verás un éxito ou un fracaso ao realizar a proba.

Proba os complementos automatizados

Proba os complementos automatizados invocando o evento de datos. Observe se o complemento funcionou correctamente validando os cambios esperados que se definiron na fórmula.

Suxestión

Durante a vista previa, pode invocar o evento de datos asociado usando o editor de táboas en Power Apps:

  1. Inicia sesión en Power Apps, vai a Táboas e selecciona a táboa Plug-in .
  2. Na barra de comandos, seleccione Editar.
  3. Crea, actualiza ou elimina filas directamente desde esta vista. Tamén pode abrir unha fila no formulario predeterminado seleccionando unha fila e, a continuación, seleccione Editar fila mediante o formulario na barra de comandos.

Integrar un complemento de código baixo

Invoca un complemento instantáneo desde unha aplicación de lenzo ou unha páxina personalizada

  1. Na aplicación Dataverse Accelerator :
    1. Seleccione o complemento instantáneo na lista.
    2. Seleccione Copiar fragmento de código na barra de comandos. Invocar un complemento de código baixo de instancia
    3. Pega e garda a fórmula copiada nun editor de texto ou nun bloc de notas (nalgún lugar ao que poidas consultar facilmente).
  2. En Power Apps:
    1. Crea ou edita unha aplicación de lenzo (ou páxina personalizada) no Power Apps estudio.
    2. Na navegación esquerda, na pestana Fontes de datos , seleccione + Nova fonte de datos e busque a opción Contorno no conector Dataverse .
    3. Insira os seguintes compoñentes no lenzo:
    • Engade controis de entrada que se correspondan co tipo de datos de cada parámetro, como Entrada de texto para texto ou números, alternar para booleano.
    • Se o ámbito do complemento está ligado a unha táboa, engade unha caixa combinada que estea asociada á mesma táboa para que poidas escoller a entrada.
    • Engade un botón para chamar ao complemento.
  3. Pega a fórmula do complemento que copiaches na propiedade OnSelect do botón.
  4. Asigne cada parámetro de entrada Value para facer referencia aos controis de entrada correspondentes:
    • Se a fórmula fose Environment.new_CalculateSum({ X: Value, Y: Value });, poderíase reescribir como: Environment.new_CalculateSum({ X: TextInput1.Text, Y: TextInput2.Text });
    • Se a fórmula estaba vinculada, substitúe Environment polo nome de visualización da táboa para acceder ao complemento.
  5. Se se define un parámetro de saída para o complemento de código baixo:
    1. Captura a resposta nunha fórmula Set() ou UpdateContext() : Set( ActionResult, Environments.CalculateSum({ X: TextInput1.Text, Y: TextInput2.Text }) );. Mostrar a variable nunha etiqueta. Tamén pode usar a fórmula Notify() para mostrar datos nunha notificación.
  6. Xoga a aplicación e selecciona o comando na barra de comandos para executar o complemento de código baixo.

Obtén máis información sobre como podes chamar Dataverse accións directamente desde Power Fx nas aplicacións de lenzo.

Invoca un complemento instantáneo desde un Power Automate fluxo na nube

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

Invoca un complemento instantáneo desde a Dataverse API web

Siga os pasos para Acción desvinculada ou Función vinculada á táboa seccións da Invocación de API personalizadas desde a documentación da API web (dependendo do ámbito do complemento apropiado).

Obtendo axuda cos complementos de código baixo

Se atopas problemas ao crear ou executar o teu complemento de código baixo, consulta estas suxestións para coñecer os problemas comúns que poden ocorrer: Microsoft Dataverse consellos de complementos de código baixo e problemas coñecidos

Contactando con Axuda + Soporte

Para problemas coa Dataverse instalación da solución do acelerador ou os complementos de código baixo que non se tratan en Microsoft Dataverse suxestións sobre complementos de código baixo e problemas coñecidos, como erros non documentados recibidos, utiliza a experiencia de Axuda e asistencia e inclúe a seguinte información:

  • Tipo de problema: Dataverse API web e SDK
  • Subtipo de problema: kit de acelerador para Dataverse

Exemplos de complementos de código baixo que podes crear

Para ver algúns exemplos de como crear un complemento de código baixo, vai a Exemplo Dataverse complementos de código baixo (vista previa)

Limitacións

  • O obxecto da linguaxe do contorno debe ler para acceder a novos complementos dentro das aplicacións de lenzo existentes. Para calquera complemento creado 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 complementos como accións.

  • Intellisense require notación explícita nos complementos automatizados se quere referir táboas na fórmula. Use a seguinte sintaxe de desambiguación, como [@Accounts], utilizando corchetes e o símbolo @ (non Accounts).

  • Soporte anidado. Os complementos só poden chamar a accións propias 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 alternativa é usar Patch() como se mostra no exemplo de enchemento da columna a continuación. Se está a crear un complemento automático, anteponga @ a cada táboa á que se fai referencia na fórmula Power Fx .

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

  • Cando os complementos de código baixo interactúan cos conectores e se emprega DLP, o administrador pode bloquear a creación de conexións mediante DLP. Non obstante, as referencias de conexión existentes no Dataverse entorno seguen funcionando. No caso de que o administrador necesite bloquear todas as interaccións de complementos de código baixo con algún conector, pode desactivar a configuración da organización Allowconnectorsonpowerfxactions. Esta configuración está activada de forma predeterminada e pódese desactivar cos métodos habituais do SDK (WebAPI, SDK, PowerShell, etc.). Podes desactivalo usando un complemento instantáneo de código baixo do seguinte xeito:

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

  • Os complementos que usan conectores só poden emitir resultados de campos específicos. Debido a isto, cómpre mapear valores primitivos específicos da resposta do conector aos valores de saída.

Complementos de código baixo que teñen unha limitación de conectores personalizados

Se tes complementos de código baixo con conectores personalizados, os conectores personalizados deben importarse primeiro, antes das referencias ou fluxos de conexión.

Se o teu ambiente non contén o conector personalizado nunha solución, importa unha solución separada que só inclúa o conector personalizado. Fai esta importación antes de importar a solución real. Debe facelo primeiro porque Azure debe rexistrar o conector personalizado antes de que se poidan importar os outros compoñentes da solución.

Se importa unha solución que contén conectores e fluxos personalizados, Azure non poderá rexistrar o conector personalizado mentres rexistra as referencias ou fluxos de conexión. Isto tamén se aplica ás referencias de conexión para o conector personalizado que non se importou anteriormente nunha solución separada. Se Azure non rexistrou o seu conector personalizado, a importación falla ou non pode iniciar a importación.

Máis información: Crear conectores personalizados en solucións: limitacións coñecidas

Consulte tamén

Complementos de código baixo Power Fx (vista previa)

Use unha solicitude predefinida nun Dataverse plug-in de código baixo Power Apps

Crea un complemento automatizado de código baixo con Power Apps (vídeo)

Crea un complemento instantáneo de código baixo con Power Apps (vídeo)

  • Last updated on