Nota
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Este tema se aplica a Dynamics 365 Customer Engagement (local). Para obtener la versión Power Apps de este tema, consulte: Cree parches para simplificar las actualizaciones de soluciones.
Si agrega una entidad a una solución y exporta la solución, la entidad y todos sus activos relacionados se exportan en esa solución. Estos activos incluyen atributos, formularios, vistas, relaciones y 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 solucionar este problema, puede crear y publicar revisiones de soluciones que contengan subcomponentes de entidades en lugar de publicar toda la entidad y todos sus activos. La solución original y una o varias revisiones relacionadas pueden agruparse más adelante en una versión actualizada de la solución, que luego puede reemplazar a la solución original en la organización de destino Dynamics 365 Customer Engagement (local, en las instalaciones).
Revisiones
Puede aplicar parches a soluciones administradas o no administradas e incluir solo cambios en las entidades y los activos de entidad relacionados. Los parches no contienen ningún componente del sistema no personalizado ni relaciones de las que dependan porque estos componentes ya existen en la organización en la que se implementó. 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 Customer Engagement como registros de entidad de Solution. Un atributo de ParentSolutionId no nulo indica que la solución es una revisión. Los parches 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 de productos. Sin embargo, la aplicación web Customer Engagement proporciona varios formularios web que le permiten crear y administrar parches de forma interactiva.
Las revisiones solo se pueden crear desde una solución primaria mediante CloneAsPatchRequest o la acción CloneAsPatch.
El elemento primario no puede ser una revisión.
Las revisiones sólo pueden tener una solución primaria.
Un parche crea una dependencia (en el nivel de solución) de su solución principal.
Puede instalar sólo una revisión si la solución primaria está presente.
No se 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 principal, identificados por
ParentSolutionId, coincidan con los de la solución principal 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 soluciónes, como actualización aditiva, pero no eliminación. No se pueden eliminar componentes de una solución mediante un parche. 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.
Los parches solo se admiten en la organización de Customer Engagement de la versión 8.0 o posterior.
Cuando se instala un parche, se instala justo encima de la solución base que está parcheando y debajo de cualquier solución en la parte superior. Esto significa que cualquier solución en la parte superior anulará la configuración del parche para el mismo tipo de componente.
Las herramientas SolutionPackager y PackageDeployer de esta versión admiten revisiones de soluciones. 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 un parche a partir de una solución no administrada de una organización mediante el mensaje CloneAsPatchRequest o la acción CloneAsPatch, o mediante la aplicación web. Una vez creada la revisión, la solución original se bloquea y no se puede cambiar ni exportar mientras haya revisiones dependientes que existan en la organización que identifiquen la solución como la solución principal. 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 Package Deployer para exportar e importar un parche. Las solicitudes de mensajes del Servicio de organización relevantes son ImportSolutionRequest y ExportSolutionRequest. Las acciones relevantes para la API web son la acción ImportSolution y la acción ExportSolution.
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 los parches se importan en orden numérico y son aditivos, lo que es coherente con la importación de soluciones en general.
| Nombre de la revisión | Descripción |
|---|---|
| SolutionA, versión 1.0 (sin administrar) | Contiene entityA con 6 campos. |
| SolutionA, versión 1.0.1.0 (no administrada) | Contiene la entidadA con 6 campos (3 actualizados) y agrega la entidadB con 10 campos. |
| SolutionA, versión 1.0.2.0 (no administrada) | Contiene la "entidad C" con 10 campos. |
El proceso de importación es el siguiente.
El desarrollador o personalizador importa primero 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 el parche SolutionA 1.0.1.0. La organización ahora contiene la entidad A con 6 campos (se han actualizado 3), además de la entidad B con 10 campos.
Por último, se importa el parche SolutionA 1.0.2.0. La organización ahora contiene la entidad A con 6 campos (3 actualizados), la entidad B con 10 campos y la entidad C 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 en la cual se ajusta la longitud del campo de número de cuenta de 20 a 30 caracteres. |
| SolutionB, versión 2.0 (no administrado, proveedor diferente) | Contiene la entidad Account, donde la longitud del campo del número de cuenta se ajusta a 50 caracteres. |
| SolutionA, versión 1.0.1.0 (no administrado, revisión) | Contiene una actualización de la entidad Account donde se ajusta la longitud del campo del número de cuenta a 35 caracteres. |
El proceso de importación es el siguiente:
El desarrollador o personalizador importa primero la solución base (SolutionA 1.0) en la organización. El resultado es una
Accountentidad con un campo de número de cuenta de 30 caracteres.Se importa la solución B. La organización ahora contiene una
Accountentidad con un campo de número de cuenta de 50 caracteres.SoluciónSe importa un parche 1.0.1.0. La organización todavía contiene una
Accountentidad con un campo de número de cuenta de 50 caracteres, tal como lo aplica SolutionB.La solución B está desinstalada. La organización ahora contiene una
Accountentidad con un campo de número de cuenta de 35 caracteres, tal como se aplica en el parche 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 sin administrar que tiene uno o más parches 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 Customer Engagement desinstala automáticamente los parches en orden inverso a la 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 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 manejan de forma ligeramente 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 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.
Consulte también
Utilice soluciones y parches segmentados para simplificar las actualizaciones de soluciones
Planificar el desarrollo de soluciones
Empaquetar y distribuir extensiones mediante soluciones
Entidad de solución
Mantenimiento de soluciones gestionadas
Publicación de la aplicación en Marketplace