Empaquete un componente de código

  • Artículo

Este artículo describe cómo importar componentes de código en Microsoft Dataverse. Después de implementar los componentes del código usando Microsoft Power Platform CLI, el siguiente paso es agrupar todos los elementos del componente de código en un archivo de solución e importar el archivo de solución en Dataverse para que pueda ver los componentes del código en tiempo de ejecución.

Para crear e importar un archivo de solución:

  1. Cree una nueva carpeta dentro de la carpeta del componente de muestra y asígnele el nombre Soluciones (o cualquier nombre de su elección) usando el comando mkdir Solutions. Navegue al directorio utilizando el comando cd Solutions.

  2. Cree nuevos proyectos de soluciones con el comando pac solution init. El proyecto de solución se usa para agrupar el componente de código de un archivo zip de la solución que se usa para importar a 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. Cuando se crea el nuevo proyecto de solución, haga referencia a la carpeta Soluciones para la ubicación donde se ubica el componente de muestra creado. Puede agregar la referencia usando el comando pac solution add-reference. Esta referencia informa al proyecto de la solución sobre qué componentes de código se deben agregar durante la generació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 a partir del proyecto de la solución, vaya al directorio del proyecto de la solución y compile el proyecto usando el siguiente comando. Este comando usa MSBuild para crear el proyecto de solución extrayendo dependencias NuGet como parte de la restauración. Use /restore solo por primera vez que se compila el proyecto de solución. Para cada compilación posterior puede ejecutar el comando msbuild.

    msbuild /t:build /restore

    Sugerencia

    • Si msbuild 15.9.* no está en la ruta, abra Developer Command Prompt for VS 2017 para ejecutar los comandos msbuild.
    • Al compilar la solución en la configuración de depuración, se genera un paquete de la solución no administrada. Un paquete de la solución administrada se genera compilando la solución en la configuración de versión. Estos valores pueden ser reemplazados especificando la propiedad SolutionPackageType en el archivo cdsproj.
    • Puede establecer 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 msbuild en la solución, asegúrese de que el nombre de la solución y el nombre del proyecto no son iguales.

  5. Los archivos de solución generados se encuentran en la carpeta \bin\debug\ después de la generación correcta.

  6. Manualmente importe la solución a Dataverse usando el portal web o automáticamente usando las Microsoft Power Platform Build Tools

Conexión al 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 a continuación para crear el perfil de autenticación, conectarse a Dataverse y enviar los componentes actualizados.

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

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

  2. Si ha creado antes una perfil de autenticación, puede ver todos los perfiles existentes mediante el comando pac auth list:

     pac auth list

  3. Para cambiar entre perfiles de autenticación creados previamente, use el comando pac auth select:

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

  4. Para obtener la información básica sobre el entorno, use el comando pac org who. La conexión se establecerá mediante el perfil predeterminado de autenticación.

    pac org who

  5. Para eliminar un perfil de autenticación determinado, use el comando pac auth delete pac auth delete --index <index of the profile>.

  6. Si desea borrar todos los perfiles de autenticación del equipo local, use el comando pac auth clear. Esta acción es irreversible porque elimina completamente el archivo authprofile.json y el archivo caché del símbolo del equipo local.

Implementar componentes de código

Una vez que haya creado correctamente un perfil de autenticación, puede comenzar a enviar los componentes del código a la instancia de Dataverse con todos los cambios más recientes.

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

Para utilizar la capacidad push, haga lo siguiente:

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

  2. Navegue hasta el directorio donde se encuentra el archivo de componente de muestra.

  3. Ejecute el comando pac pcf push.

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

    Nota

    El prefijo del editor que usa con el comando push debe coincidir con el prefijo del editor de la solución en la que se incluirán 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. A continuación se proporciona 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 nueva compilación (o limpieza) ejecutando 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

Nota

¿Puede indicarnos sus preferencias de idioma de documentación? Realice una breve encuesta. (tenga en cuenta que esta encuesta está en inglés)

La encuesta durará unos siete minutos. No se recopilan datos personales (declaración de privacidad).