Empaquete un componente de código

Obtenga información sobre cómo empaquetar un componente de código en un archivo de solución e importarlo en Microsoft Dataverse para que esté disponible en tiempo de ejecución. También aprenderá a conectarse a un entorno, implementar actualizaciones con Microsoft Power Platform CLI y quitar componentes de una solución.

Process

Para crear e importar un archivo de solución:

  1. Cree una nueva carpeta dentro de la carpeta de componentes de ejemplo y asígnele el nombre Solutions (o cualquier nombre que elija) mediante el comando mkdir Solutions. Vaya al directorio mediante el comando cd Solutions.

  2. Cree un proyecto de soluciones mediante el comando pac solution init . Use el proyecto de solución para agrupar el componente de código en un archivo ZIP de solución que importe en Dataverse.

    pac solution init --publisher-name developer --publisher-prefix dev

    Nota

    Los valores publisher-name y publisher-prefix deben ser únicos a su entorno.

  3. Después de crear el nuevo proyecto de solución, establezca la carpeta Soluciones como la ubicación del componente de ejemplo creado. Agregue la referencia mediante el comando pac solution add-reference . Esta referencia informa al proyecto de solución sobre qué componentes de código se van a agregar durante la compilación. Puede agregar referencias a varios componentes en un solo proyecto de solución.

     pac solution add-reference --path c:\downloads\mysamplecomponent

  4. Para generar un archivo ZIP desde el proyecto de solución, vaya al directorio del proyecto de solución y compile el proyecto mediante el comando siguiente. Este comando usa MSBuild para crear el proyecto de solución extrayendo dependencias NuGet como parte de la restauración. Use la /restore marca solo la primera vez que compile el proyecto de solución. Para cada compilación después de eso, ejecute el comando msbuild.

    msbuild /t:restore

    msbuild

    O bien, si ha instalado el SDK de .NET, versión 6 o posterior:

    dotnet build

    Propina

    • Si msbuild 15.9.* no está en PATH, abra el Símbolo del sistema para desarrolladores de VS 2017 para ejecutar los comandos msbuild.
    • Compilar la solución en la configuración debug genera un paquete de solución no administrada. La compilación de la solución en la configuración de versión genera un paquete de solución administrado. Puede invalidar esta configuración especificando la SolutionPackageType propiedad en el cdsproj archivo.
    • Establezca la configuración de msbuild en Release para emitir una compilación de producción. Ejemplo: msbuild /p:configuration=Release
    • Si se produce un error que indica Nombre de proyecto ambiguo al ejecutar el comando en la msbuild solución, asegúrese de que el nombre de la solución y el nombre del proyecto no sean los mismos.

  5. Después de que la compilación se realice correctamente, busque los archivos de solución generados dentro de la \bin\debug\ carpeta .

  6. Importe la solución en Dataverse manualmente mediante el portal web o automáticamente mediante las herramientas de compilación de Microsoft Power Platform.

Conexión a su entorno

Puede implementar los componentes de código directamente desde Microsoft Power Platform CLI conectándose al entorno de Dataverse y luego empujar los componentes actualizados.

Siga los pasos de la lista siguiente para crear el perfil de autenticación, conectarse a Dataverse e insertar los componentes actualizados.

  1. Cree el perfil de autenticación mediante el comando pac auth create .

    pac auth create --url https://xyz.crm.dynamics.com

  2. Si creó previamente un perfil de autenticación, vea todos los perfiles existentes mediante el comando pac auth list .

     pac auth list

  3. Cambie entre los perfiles de autenticación creados anteriormente mediante el comando pac auth select .

     pac auth select --index <index of the active profile>

  4. Obtenga información básica sobre el entorno mediante el comando pac org who . La conexión usa el perfil de autenticación predeterminado.

    pac org who

  5. Elimine un perfil de autenticación determinado mediante el comando pac auth delete con la pac auth delete --index <index of the profile> sintaxis .

  6. Borre todos los perfiles de autenticación de la máquina local mediante el comando pac auth clear . Esta acción es irreversible porque elimina por completo el archivo authprofile.json y el archivo de caché de tokens de su equipo.

Implementación de componentes de código

Después de crear un perfil de autenticación, empiece a insertar los componentes de código en la instancia de Dataverse con todos los cambios más recientes.

La push funcionalidad acelera el desarrollo del ciclo interno del desarrollador porque omite los requisitos de control de versiones de componentes de código y no requiere que compile la solución (cdsproj) para importar el componente de código.

Para usar la push funcionalidad, siga estos pasos:

  1. Asegúrese de que tiene un perfil de autenticación válido.

  2. Vaya al directorio donde se encuentra el archivo de componente de ejemplo.

  3. Ejecute el comando pac pcf push.

    pac pcf push --publisher-prefix <your publisher prefix>

    Nota

    El prefijo del publicador que se usa con el push comando debe coincidir con el prefijo del publicador de la solución donde se incluyen los componentes.

Quitar componentes de una solución

Si desea quitar un componente de código de un archivo de la solución:

  1. Edite el archivo cdsproj en el directorio del proyecto de la solución y quite las referencias al componente. Este es un ejemplo de una referencia de componente:

    <ItemGroup>
    <Projectreference Include="..\pcf_component\pcf_component.pcfproj">
      <Project>0481bd83-ffb0-4b70-b526-e0b3dd63e7ef</Project>
      <Name>pcf_component</Name>
      <Targets>Build</Targets>
      <referenceOutputAssembly>false</referenceOutputAssembly>
      <OutputItemType>Content</OutputItemType>
      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
    </Projectreference>
</ItemGroup>

  2. Realice una recompilación (o limpieza) mediante el comando siguiente:

    msbuild /t:rebuild

Consultar también

Agregue componentes de código a una columna o tabla en aplicaciones basadas en modelos
Agregar componentes a una aplicación de lienzo
Referencia de la API de Power Apps component framework
Información general sobre Power Apps component framework
Grupos de comandos de Microsoft Power Platform CLI

  • Last updated on