Crear y registrar un paquete de complemento usando Visual Studio
En este artículo, aprenderá cómo crear un paquete de complemento, cargarlo y registrarlo en el servidor Dataverse. Estará usando Visual Studio con la extensión Power Platform Tools de herramientas para crear el paquete de complemento, cargar y registrar el paquete y realizar otras tareas de administración de paquetes.
Este artículo le ayuda a:
- Crear un proyecto de complemento de Visual Studio
- Agregar un ensamblaje dependiente al proyecto y compilación
- Usar Visual Studio para cargar y registrar su paquete
- Usar Visual Studio para actualizar y eliminar un paquete
Más información: Compilar y empaquetar código de complemento.
Requisitos previos
- Acceder a un entorno de Dataverse
- Una cuenta de usuario del sistema, con el rol Administrador del sistema o personalizador del sistema, en el entorno de destino
- Visual Studio 2019 con la extensión Power Platform Tools instalada
Revise estos artículos relacionados con la instalación y el uso de Power Platform Tools para Visual Studio.
- ¿Para qué sirve Power Platform Tools? Visual Studio
- Crear un proyecto de Power Platform Herramientas
- Crear un complemento usando Power Platform Herramientas
Habilitar paquetes de complementos para Power Platform Tools
Power Platform Tools para Visual Studio proporciona varias opciones de configuración como se describe en Opciones de Power Platform Tools.
En Visual Studio, vaya a Herramientas>Opciones y busque Power Platform Tools.
Seleccione Usar paquete NuGet para implementar complementos en Dataverse.
Nota
Cuando se selecciona esta opción, todos sus proyectos de complementos se implementarán como paquetes de complementos.
Agregar un ensamblaje dependiente a su proyecto
Puede agregar un paquete NuGet para satisfacer las referencias requeridas a su proyecto de Visual Studio como lo hace normalmente. Después de construir el proyecto, debería encontrar el ensamblaje del complemento en el paquete NuGet generado ubicado en la carpeta bin\outputPackages.
Puede usar Explorador de paquetes NuGet para examinar el paquete NuGet generado.
Agregar un ensamblado dependiente sin usar NuGet
Si tiene un ensamblaje que no se distribuye como un paquete NuGet, puede agregarlo a su proyecto como lo hace normalmente. En el Explorador de soluciones, haga clic con el botón derecho sobre Dependencias y elija Agregar referencia de ensamblado.... Seleccione el ensamblado que desea agregar.
Implementar paquetes de complementos
Para implementar (cargar y registrar) su paquete de complemento, en el Explorador de soluciones haga clic derecho en el proyecto del complemento y seleccione Implementar desde el menú contextual.
Cuando implemente por primera vez, debería ver un mensaje en la ventana de salida que le informa que se creó el paquete del complemento:
6/22/2022 3:03:17 PM : registration of Plugin Package sample_PowerPlatformVSSolution.ExamplePlugins,
at E:\projects\PowerPlatformVSSolution\ExamplePlugins\bin\outputPackages\PowerPlatformVSSolution.ExamplePlugins.1.0.0.nupkg was successful.
ID allotted was 06a20e15-77f2-ec11-bb3c-000d3a892245.
Cada vez que implemente después de eso, verá un mensaje en la ventana de salida que le informa que el paquete del complemento se actualizó.
6/22/2022 3:20:14 PM : update of Plugin Package sample_PowerPlatformVSSolution.ExamplePlugins, at
E:\projects\PowerPlatformVSSolution\ExamplePlugins\bin\outputPackages\PowerPlatformVSSolution.ExamplePlugins.1.0.0.nupkg was successful.
Importante
Si su actualización elimina los conjuntos de complementos o los tipos que se utilizan en los registros de pasos de complementos, se rechazará la actualización. Debe eliminar manualmente cualquier registro de pasos que utilice conjuntos de complementos o tipos de complementos que desee eliminar con la actualización.
La versión del paquete del complemento o del ensamblaje del complemento no es un factor en ningún comportamiento de actualización. Puede actualizar las versiones de estos elementos según lo necesite.
Complemento de administración de paquetes
Dentro de Visual Studio, puede realizar operaciones adicionales en paquetes de complementos como se describe en las siguientes secciones.
Ver paquetes de complementos con Power Platform Tools
Dentro de Power Platform Explorer, puede ver los paquetes de complementos disponibles.
Crear un paquete de complemento, método alternativo
Como se menciona en Implementar paquetes de complementos, normalmente no tendrá que crear un paquete de complementos en el flujo habitual de creación de un complemento. Se creará automáticamente la primera vez que implemente el complemento mientras la opción Usar NuGet paquete para implementar complementos en Dataverse está configurada en Visual Studio. Sin embargo, puede crear un nuevo paquete de complementos a partir de un paquete NuGet mediante los siguientes pasos.
Dentro del Power Platform Explorer, seleccione un Paquetes de complementos y seleccione Crear del menú contextual.
Este comando abre el cuadro de diálogo Importar nuevo paquete de complementos.
Seleccione el paquete NuGet y elija a qué solución se debe agregar, o cree una nueva solución.
Eliminar un paquete de complemento
Dentro del Power Platform Explorer, seleccione un paquete de complemento y seleccione Eliminar en el menú contextual.
Importante
Eliminar un paquete, se eliminará el paquete, todos los ensamblajes dentro de él, todos los complementos dentro del ensamblaje y cualquier registro de paso de complemento para los complementos.
Actualizar un paquete de complemento, método alternativo
Como se menciona en Implementar paquetes de complementos, normalmente no tendrá que actualizar un paquete de complementos en el flujo habitual de creación de un complemento. Se actualizará automáticamente cada vez que implemente el complemento mientras la opción Usar paquete nuget para implementar complementos en Dataverse está configurada en Visual Studio. Sin embargo, puede actualizar un nuevo paquete de complementos a partir de un paquete Nuget siguiendo los pasos a continuación.
Dentro del Power Platform Explorer, seleccione un paquete de complementos y seleccione Actualizar del menú contextual.
Este comando abre un cuadro de diálogo para que pueda seleccionar un paquete NuGet para actualizar el paquete del complemento.