Crear parches para simplificar actualizacións de solucións

Se engades unha táboa a unha solución e a exportas, a táboa e todos os seus recursos relacionados expórtanse nesa solución. Estes recursos inclúen columnas (atributos), formularios, vistas, relacións e visualizacións, así como calquera outro recurso que estea empaquetado coa táboa. Exportar todos os obxectos significa que pode modificar involuntariamente obxectos no despregamento de destino ou transportar dependencias non desexadas.

Para abordar as dependencias, pode crear e publicar parches de solucións que conteñan subcompoñentes de táboas en lugar de publicar a táboa completa e todos os seus recursos. A solución orixinal e un ou varios parches relacionados pódense combinar (fusionar) máis tarde nunha versión actualizada da solución, que logo pode substituír a solución orixinal na organización de Microsoft Dataverse de destino.

Parches

Podes aplicar parches a solucións xestionadas ou non xestionadas e incluír só os cambios nas táboas e nos recursos de táboa relacionados. Os parches non conteñen ningún compoñente do sistema non personalizado nin relacións das que dependan porque estes compoñentes xa existen na organización na que se despregaron. Nalgún momento do seu ciclo de desenvolvemento, pode combinar todos os parches nunha nova versión da solución para substituír a solución orixinal da que se crearon os parches.

Os parches almacénanse na base de datos como rexistros de táboa. Dataverse Solution Un atributo de ParentSolutionId que non sexa nulo indica que a solución é un parche. Os parches pódense crear e xestionar a través do SDK para .NET ou das API web, que son útiles para desenvolver automatización como un script de instalación de produtos. Non obstante, a aplicación web de Dataverse fornece varios formularios web que permiten crear e xestionar parches de forma interactiva.

• Os parches só se poden crear a partir dunha solución principal usando CloneAsPatchRequest ou Acción CloneAsPatch.
• O elemento pai do parche non pode ser un parche.
• Os parches só poden ter unha solución primaria.
• Un parche crea unha dependencia, a nivel de solución, na súa solución principal.
• Só pode instalar un parche se a solución primaria está presente.
• Non podes instalar un parche a menos que o nome único e o número de versión principal ou secundaria da solución principal, tal como se identifica mediante ParentSolutionId, non coincidan cos da solución principal instalada na organización de destino.
• Unha versión de parche debe ter o mesmo número maior e menor, pero un número de compilación e versión superior ao número de versión de solución principal. O nome para mostrar pode ser diferente.
• Se unha solución ten parches, os parches posteriores deberán ter un número de versión numericamente superior ao dos parches existentes para esa solución.
• Os parches admiten as mesmas operacións que as solucións, como a actualización sumadas, pero non a eliminación. Non podes eliminar compoñentes dunha solución usando un parche. Para eliminar os compoñentes dunha solución, realice unha actualización.
• Os parches exportados como xestionados deben importarse sobre unha solución primaria xestionada. A regra é que a protección contra parches (xestionada ou non xestionada) debe coincidir coa súa primaria.
• Non empregues parches non xestionados para fins de produción.

As ferramentas SolutionPackager e PackageDeployer admiten parches de solucións. Consulte a axuda en liña da ferramenta para ver as opcións da liña de comandos relacionadas cos parches.

Crear un parche

Crea un parche a partir dunha solución non xestionada nun ambiente usando a mensaxe CloneAsPatchRequest ou a acción CloneAsPatch, ou usando a aplicación web. Unha vez que cree o parche, a solución orixinal queda bloqueada e non poderá cambiala nin exportala mentres existan parches dependentes no ambiente que identifiquen a solución como a solución principal. A versión do parche é similar á versión de solucións e especifícase no seguinte formato: major.minor.build.release. Non podes facer cambios nas versións principais ou secundarias da solución existentes ao crear un parche.

Importar e exportar un parche

Usa o SDK para .NET ou as API web, a aplicación web ou a ferramenta Package Deployer para exportar e importar un parche. Os SDK relevantes para as clases de solicitude .NET son ImportSolutionRequest e ExportSolutionRequest. As accións relevantes para a API web son ImportSolution Action e ExportSolution Action.

Exemplos de parches

Na seguinte táboa enuméranse os detalles dun exemplo de parche. Neste exemplo, a solución e os parches impórtanse en orde numérica e son aditivos, o que é coherente coa importación de solucións en xeral.

Nome do parche	Descripción
SolutionA, versión 1.0 (non xestionada)	Contén entityA seis campos.
SolutionA, versión 1.0.1.0 (non xestionada)	Contén entityA seis campos (tres actualizados) e engádese entityB con 10 campos.
SolutionA, versión 1.0.2.0 (non xestionada)	Contén entityC con 10 campos.

O proceso de importación é o seguinte.

1. O desenvolvedor ou personalizador importa primeiro a solución base (SolutionA 1.0) ao ambiente. O resultado é entityA con seis campos no ambiente.
2. A continuación, impórtase o parche 1.0.1.0. SolutionA O entorno agora contén entityA seis campos (tres foron actualizados), ademais entityB de 10 campos.
3. Finalmente, impórtase o parche 1.0.2.0. SolutionA O ambiente agora contén entityA seis campos (tres actualizados), entityB 10 campos e entityC 10 campos.

Outro exemplo de parches

Vexamos outro exemplo de parches, cos detalles que figuran na seguinte táboa.

Nome do parche	Descripción
SolutionA, versión 1.0 (non xestionada, solución básica)	Contén a táboa Account onde se axusta a lonxitude da columna do número de conta de 20 a 30 caracteres.
SolutionB, versión 2.0 (non xestionada, provedor diferente)	Contén a táboa Account onde a lonxitude da columna do número de conta se axusta a 50 caracteres.
SolutionA, versión 1.0.1.0 (non xestionada, parche)	Contén unha actualización da táboa Account onde a lonxitude da columna do número de conta se axusta a 35 caracteres.

O proceso de importación é o seguinte:

1. O desenvolvedor ou personalizador importa primeiro a solución base (SolutionA 1.0) ao ambiente. O resultado é unha táboa cunha columna de número de conta de 30 caracteres. Account
2. SolutionB é importado. O ambiente agora contén unha táboa cunha columna de número de conta de 50 caracteres. Account
3. SolutionA Importouse o parche 1.0.1.0. O ambiente aínda contén unha táboa cunha columna de número de conta de 50 caracteres, tal e como se aplicou en. AccountSolutionB
4. SolutionB está desinstalado. O ambiente agora contén unha táboa cunha columna de número de conta de 35 caracteres, tal e como se aplicou no parche 1.0.1.0. AccountSolutionA

Eliminar un parche

Pode eliminar un parche ou solución base (principal) usando DeleteRequest ou, para a API web, usar o método HTTP DELETE. O proceso de eliminación é diferente para unha solución xestionada ou non xestionada que teña un ou máis parches existentes no ambiente.

Para unha solución non xestionada, primeiro debe desinstalar todos os parches na solución base, en orde inversa á que foron creados, antes de desinstalar a solución base.

Para unha solución administrada, simplemente desinstale a solución base. O sistema Dataverse desinstala automaticamente os parches en orde inversa de versión antes de desinstalar a solución base. Tamén pode desinstalar un só parche.

Actualizar unha solución

Actualizar unha solución implica combinar (fusionar) todos os parches desa solución nunha nova versión da solución. Despois, esa solución desbloquéase e pódese modificar de novo (só a solución sen xestionar) ou exportar. Para obter unha solución administrada, non se permiten máis modificacións da solución agás para crear parches a partir da solución actualizada. Para combinar parches nunha solución non xestionada, use CloneAsSolutionRequest ou CloneAsSolution Action. A clonación dunha solución crea unha nova versión da solución non xestionada, incorporando todos os seus parches, cun número de versión de major.minor superior, o mesmo nome único e un nome para mostrar.

Para unha solución xestionada, as cousas manéxanse de forma lixeiramente diferente. Primeiro clone a solución non xestionada (A), incorporando todos os seus parches e logo exportándoa como solución administrada (B). Na organización de destino que contén a versión xestionada da solución (A) e os seus parches, importe a solución administrada (B) e logo execute DeleteAndPromoteRequest ou DeleteAndPromote Action para substituír a solución administrada (A) e os seus parches pola solución administrada (B) actualizada que ten un número de versión superior.

Consulte tamén

Usar solucións segmentadas