Crear revisiones para simplificar las actualizaciones de la solución
Publicado: enero de 2017
Se aplica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
Si se agrega una entidad a una solución y se exporta esa solución, la entidad y todos sus activos relacionados se exportan en esa solución. Estos activos incluyen atributos, formularios, vistas, relaciones, visualizaciones y cualquier otro activo que se empaquete con la entidad. Exportar todos los objetos significa que puede editar involuntariamente objetos en la implementación de destino, o transferir dependencias involuntarias.
Para evitarlo, puede crear y publicar revisiones de la solución que contengan subcomponentes de entidades, en lugar de publicar la entidad completa y todos sus activos. La solución original y una o varias revisiones relacionadas se pueden consolidar (combinar) en un momento posterior en una versión actualizada de la solución, que a continuación puede reemplazar la solución original en la organización de Microsoft Dynamics 365 de destino.
Revisiones
Puede aplicar revisiones a soluciones administradas o no administradas e incluir solo cambios en las entidades y los activos relacionados. Las revisiones no contienen componentes del sistema no personalizados ni relaciones de las que dependa porque estos componentes ya existen en la organización en la que se ha realizado la implementación. En algún momento del ciclo de desarrollo, puede consolidar todas las revisiones en una nueva versión de la solución para reemplazar la solución original desde la que se crearon las revisiones.
Las revisiones se almacenan en la base de datos de Dynamics 365 como registros de entidad de Solution. Un atributo de ParentSolutionId no nulo indica que la solución es una revisión. Las revisiones se pueden crear y administrar a través del Servicio de organización o las API web, que son útiles para desarrollar automatización como un script de instalación del producto. Sin embargo, la aplicación web de Dynamics 365 proporciona varios formularios web que le permiten crear y administrar revisiones interactivamente.
Las revisiones solo se pueden crear desde una solución primaria mediante CloneAsPatchRequest o CloneAsPatch Action.
El elemento primario no puede ser una revisión.
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 revisiones, las revisiones posteriores deben tener un número de versión numérico más alto que cualquier revisión existente para esa solución.
Las revisiones admiten las mismas operaciones que las soluciones, como actualización aditiva, pero no eliminación. No puede quitar componentes de una solución con una revisión. Para quitar componentes de una solución, realice una actualización.
Las revisiones exportadas como administradas se deben importar sobre una solución primaria administrada. La regla es que la protección de revisiones (administradas o no administradas) debe coincidir con la primaria.
No use revisiones no administradas con fines de producción.
Las revisiones se admiten solo en las organizaciones de Dynamics 365 versión de 8.0 o superior.
Las herramientas SolutionPackager y PackageDeployer de esta versión admiten revisiones de la 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 revisiones.
Crear una revisión
Cree una revisión desde una solución no administrada en una organización con el mensaje CloneAsPatchRequest o CloneAsPatch Action, o mediante la aplicación web. Una vez creada la revisión, la solución original pasa a estar bloqueada y no es posible cambiarla o exportarla mientras haya revisiones dependientes que existan en la organización que identifica la solución como solución primaria. La versión de revisión es similar a la versión de la solución y se especifica en el siguiente formato: major.minor.build.release. No puede realizar cambios a las versiones principal o de menor importancia existentes de la solución cuando crea una revisión.
Exportar e importar una revisión
Puede utilizar el Servicio de organización o las API web, la aplicación web o la Herramienta de implementador de paquetes para exportar e importar una revisión. La solicitudes relevantes de mensajes del Servicio de organización son ImportSolutionRequest y ExportSolutionRequest. Las acciones correspondientes para API web son ImportSolution Action y ExportSolution Action.
Ejemplos de revisión
La siguiente tabla muestra los detalles de un ejemplo de revisión. Tenga en cuenta que en este ejemplo, la solución y revisiones se importan en orden numérico y son aditivas, lo que es coherente con la importación de la solución en general.
Nombre de la revisión |
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.
El desarrollador o personalizador primero importa la solución base (SolutionA 1.0) en la organización. El resultado es entityA con 6 campos en la organización.
A continuación, se importa la revisión de la SolutionA 1.0.1.0. La organización contiene ahora entityA con 6 campos (3 se han actualizado), más entityB con 10 campos.
Finalmente, se importa la revisión SolutionA 1.0.2.0. La organización contiene ahora entityA con 6 campos (3 actualizados), entityB con 10 campos, más entityC con 10 campos.
Otro ejemplo de revisión
Veamos otro ejemplo de revisión, con los detalles que se muestran en la tabla siguiente.
Nombre de la revisión |
Descripción |
|---|---|
SolutionA, versión 1.0 (solución base no administrada) |
Contiene la entidad Account donde la longitud del campo de número de cuenta está ajustada entre 20 y 30 caracteres. |
SolutionB, versión 2.0 (no administrada, diferente proveedor) |
Contiene la entidad Account donde la longitud del campo 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 entidad Account donde la longitud del campo de número de cuenta está ajustada a 35 caracteres. |
El proceso de importación es el siguiente:
El desarrollador o personalizador primero importa la solución base (SolutionA 1.0) en la organización. El resultado es una entidad de Account con un campo de número de cuenta de 30 caracteres.
SolutionB es importa. La organización contiene ahora una entidad de Account con un campo de número de cuenta de 50 caracteres.
Se importa la revisión SolutionA 1.0.1.0. La organización contiene todavía una entidad de Account con un campo de número de cuenta de 50 caracteres, aplicado por SolutionB.
SolutionB se desinstala. La organización contiene ahora una entidad de Account con un campo de número de cuenta de 35 caracteres, aplicado por la revisión SolutionA 1.0.1.0.
Eliminar una revisión
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 la organización.
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 Dynamics 365 automáticamente desinstala las revisiones en orden inverso de versión antes de desinstalar la solución base. También puede simplemente desinstalar una sola revisión.
Actualizar una solución
Actualizar una solución implica consolidar (combinar) todas las revisiones a esa solución en una nueva versión de la solución. Posteriormente, la solución se desbloquea y se pueden 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 CloneAsSolution Action. 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.
Una solución administrada se gestiona de una forma un poco diferente. Primero se clona la solución no administrada (A), incorporando todas sus revisiones y después se exporta como 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 DeleteAndPromote Action 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.
Ver también
TechNet: Use soluciones y revisiones divididas en segmentos para simplificar las actualizaciones de la solución
Planear el desarrollo de la solución
Empaquetar y distribuir las extensiones con soluciones
Mensajes y métodos de la entidad de solución
Mantener soluciones administradas
Registrar su aplicación con AppSource
Microsoft Dynamics 365
© 2017 Microsoft. Todos los derechos reservados. Copyright