Crear parches para simplificar las actualizaciones de la solución

Si agrega una tabla a una solución y exporta la solución, exporta la tabla y todos los recursos relacionados de esa solución. Estos recursos incluyen columnas (atributos), formularios, vistas, relaciones y visualizaciones, junto con cualquier otro recurso que se empaqueta con la tabla. Exportar todos los objetos significa que puede modificar accidentalmente objetos en la implementación de destino o transferir dependencias no deseadas.

Para abordar las dependencias, cree y publique parches de solución que contengan subcomponentes de tablas en lugar de publicar toda la tabla y todos sus recursos. Puede acumular (combinar) la solución original y uno o varios parches relacionados más adelante en una versión actualizada de la solución, que luego puede reemplazar la solución original en la organización de destino Microsoft Dataverse.

Parches

Puede aplicar revisiones a soluciones administradas o no administradas e incluir solo cambios en las tablas y los activos relacionados. Las revisiones no contienen componentes del sistema no personalizados ni relaciones de las que dependen porque estos componentes ya existen en la organización en la que se ha realizado la implementación. En algún momento de tu ciclo de desarrollo, puedes consolidar todos los parches en una nueva versión de la solución para reemplazar la solución original a partir de la cual se crearon los parches.

La base de datos de Dataverse almacena parches como Solution registros de tabla. Un atributo ParentSolutionId no nulo indica que la solución es un parche. Puede crear y administrar parches a través del SDK para .NET o las API web, que resultan útiles para desarrollar procesos automatizados, como un script de instalación de un producto. Sin embargo, la aplicación web de Dataverse proporciona varios formularios web que le permiten crear y administrar parches interactivamente.

  • Solo puede crear parches desde una solución principal mediante CloneAsPatchRequest o CloneAsPatch Action.
  • El parche principal no puede ser un parche.
  • Las revisiones sólo pueden tener una solución primaria.
  • Una revisión crea una dependencia en el nivel de soluciones de su solución primaria.
  • Puede instalar sólo una revisión si la solución primaria está presente.
  • No puede instalar una revisión a menos que el nombre único y el número de versión principal o secundaria de la solución primaria, identificada por ParentSolutionId, no coincidan con los de la solución primaria instalada en la organización de destino.
  • Una versión de revisión debe tener el mismo número de versión principal o secundaria, pero un número de compilación y versión superior, que el número de versión de la solución primaria. El nombre para mostrar puede ser distinto.
  • Si una solución tiene parches, los parches posteriores deben tener un número de versión numéricamente más alto que cualquier parche existente para esa solución.
  • Los parches admiten las mismas operaciones que las soluciones, como la actualización aditiva, pero no la eliminación. No se pueden quitar componentes de una solución mediante un parche. Para quitar componentes de una solución, realice una actualización.
  • Debe importar parches exportados como administrados sobre una solución principal administrada. La regla es que la protección de revisiones (administradas o no administradas) debe coincidir con la primaria.
  • No utilice parches no administrados con fines de producción.

Las herramientas SolutionPackager y PackageDeployer admiten parches de solución. Consulte la ayuda en línea de la herramienta para conocer las opciones de línea de comandos que estén relacionadas con parches.

Crear un parche

Cree un parche desde una solución no administrada en un entorno con el mensaje CloneAsPatchRequest o el CloneAsPatch Action, o utilizando la aplicación web. Cuando crea la revisión, bloquea la solución original pasa y no es posible cambiarla o exportarla mientras haya revisiones dependientes que existan en el entorno que identifica la solución como solución primaria. El control de versiones de parche es similar al control de versiones de la solución y se especifica en el siguiente formato: major.minor.build.release. No se pueden cambiar las versiones principales o secundarias de la solución existentes al crear un parche.

Exportar e importar una revisión

Utilice el SDK para .NET o las API web, la aplicación web o la herramienta Package Deployer para exportar e importar un parche. El SDK relevante para las clases de solicitud .NET son ImportSolutionRequest y ExportSolutionRequest. Las acciones pertinentes para la API web son ImportSolution Action y ExportSolution Action.

Ejemplos de revisión

La siguiente tabla muestra los detalles de un ejemplo de aplicación de parches. En este ejemplo, usted importa la solución y las revisiones en orden numérico y son aditivas, lo que es coherente con la importación de la solución en general.

Nombre del parche Descripción
SolutionA, versión 1.0 (no administrada) Contiene entityA con 6 campos.
SolutionA, versión 1.0.1.0 (no administrada) Contiene entityA con 6 campos (3 actualizados) y agrega entityB con 10 campos.
SolutionA, versión 1.0.2.0 (no administrada) Contiene entityC con 10 campos.

El proceso de importación es el siguiente.

  1. El desarrollador o personalizador primero importa la solución base (SolutionA 1.0) en el entorno. El resultado es entityA con 6 campos en el entorno.
  2. A continuación, importe la SolutionA revisión 1.0.1.0. El entorno ahora contiene entityA con seis campos (tres actualizados), además de entityB con 10 campos.
  3. Por último, importe la SolutionA revisión 1.0.2.0. La organización contiene ahora entityA con 6 campos (3 se han actualizado), más entityB con 10 campos más entityC con 10 campos.

Otro ejemplo de revisión

Echemos un vistazo a otro ejemplo de aplicación de revisión. En la tabla siguiente se enumeran los detalles.

Nombre de la revisión Descripción
SolutionA, versión 1.0 (solución base no administrada) Contiene la tabla Account donde la longitud de la columna número de cuenta está ajustada entre 20 y 30 caracteres.
SolutionB, versión 2.0 (no administrada, diferente proveedor) Contiene la tabla Account donde la longitud de la columna de número de cuenta está ajustada a 50 caracteres.
SolutionA, versión 1.0.1.0 (no administrada, revisión) Contiene una actualización de la tabla Account donde la longitud de la columna de número de cuenta está ajustada a 35 caracteres.

El proceso de importación es el siguiente:

  1. El desarrollador o personalizador primero importa la solución base (SolutionA 1.0) al entorno. El resultado es una tabla Account con una columna de número de cuenta de 30 caracteres.
  2. Importar SolutionB. El entorno contiene ahora una tabla Account con una columna de número de cuenta de 50 caracteres.
  3. Importar SolutionA revisión 1.0.1.0. El entorno contiene todavía una tabla Account con una columna de número de cuenta de 50 caracteres, aplicado por SolutionB.
  4. Desinstalar SolutionB. El entorno contiene ahora una tabla Account con una columna de número de cuenta de 35 caracteres, aplicado por la revisión SolutionA 1.0.1.0.

Eliminar un parche

Puede eliminar una solución de revisión o base (primaria) mediante DeleteRequest o, para API web, usar el método HTTP DELETE. El proceso de eliminación es diferente para una solución administrada o no administrada que tenga una o más revisiones existentes en el entorno.

Para una solución no administrada, debe desinstalar todas las revisiones de la solución base en primer lugar, en el orden inverso de versión al que se crearon, antes de desinstalar la solución base.

Para una solución administrada, simplemente desinstale la solución base. El sistema Dataverse automáticamente desinstala las revisiones en orden inverso de versión antes de desinstalar la solución base. También puede simplemente desinstalar un solo parche.

Actualizar una solución

La actualización de una solución implica combinar todos los parches de esa solución en una nueva versión de la solución. Posteriormente, la solución se desbloquea y se puede editar (solo solución no administrada) o exportar de nuevo. Para una solución administrada, no se permiten más modificaciones de la solución salvo para crear revisiones desde la solución recién actualizada. Para consolidar revisiones en una solución no administrada, use CloneAsSolutionRequest o la acción CloneAsSolution. La clonación de una solución crea una nueva versión de la solución no administrada, incorporando todas sus revisiones, con un número de versiónmajor.minor más alto, el mismo nombre único y un nombre para mostrar.

En el caso de una solución administrada, las cosas se controlan de forma ligeramente diferente. Primero se clona la solución no administrada (A), se incorporan todas sus revisiones y, a continuación, se exporta como una solución administrada (B). En la organización de destino que contiene la versión administrada de la solución (A) y sus revisiones, importe la solución administrada (B) y después ejecute DeleteAndPromoteRequest o la acción DeleteAndPromote para reemplazar la solución administrada (A) y sus revisiones con la solución administrada actualizada (B) que tenga un número de versión más alto.

Vea también

Usar soluciones segmentadas