Recibir un paquete desplegable preparado para Lifecycle Services no implica que deba volver a compilarse únicamente para cambiar su formato. Microsoft documenta una conversión mediante ModelUtil.exe para obtener un paquete compatible con la experiencia unificada. Esta guía aborda ese paso y propone controles para probar el resultado antes de liberarlo.
Cuándo utilizar la conversión
El escenario es concreto: disponer de un paquete LCS existente y necesitar adaptarlo al formato de la experiencia unificada. Antes de empezar, identifique el tipo de ambiente y su mecanismo de despliegue. La presencia de un ambiente en PPAC no debe utilizarse como único criterio para elegir el procedimiento.
Preparar y ejecutar
Microsoft indica localizar ModelUtil.exe en la carpeta bin y ejecutarlo sin argumentos para consultar su ayuda. Compruebe que la herramienta instalada ofrece -convertToUnifiedPackage. Conserve una copia del ZIP original y utilice una carpeta de salida separada.
El siguiente ejemplo emplea rutas ilustrativas. Confirme los parámetros en la ayuda de su herramienta antes de ejecutarlo:
ModelUtil.exe -convertToUnifiedPackage -file="C:PaquetesPaqueteLCS.zip" -outputpath="C:PaquetesSalidaUnified"Revise el mensaje de finalización y los archivos generados. Convertir el formato no sustituye una prueba del paquete en el ambiente de destino.
Si aparece el error de archivo existente
Microsoft documenta que la conversión puede fallar cuando el paquete original contiene varias versiones del mismo modelo. La corrección consiste en revisar o recrear el paquete para incluir una sola versión de cada modelo en AOSService/Packages/files/<model.version>. No elimine componentes al azar para forzar la conversión.
Controles propuestos para el primer despliegue
Los siguientes son controles editoriales recomendados; no representan pruebas ejecutadas por Enoiax sobre un ambiente:
- Registrar origen, versión y hash del paquete recibido y del artefacto convertido.
- Confirmar con el proveedor las dependencias, compatibilidad y licencias requeridas.
- Utilizar un ambiente de pruebas y una identidad autorizada para el mecanismo de despliegue elegido.
- Revisar registros de operación, modelos instalados y resultado de sincronización cuando corresponda.
- Ejecutar casos funcionales representativos y conservar evidencia antes de aprobar el paso a producción.
Evite incluir credenciales o archivos de licencia en repositorios públicos. Para paquetes de terceros, preserve las condiciones de distribución y soporte del proveedor.
Para releases recurrentes: generar el formato desde el pipeline
Microsoft también documenta la creación directa mediante Azure Pipelines: la tarea Create Deployable Package, versión 3, permite seleccionar Create Power Platform Unified Package e indicar las versiones de aplicación y plataforma usadas en la compilación.
Cuando se necesitan licencias, la documentación describe Add Licenses to Deployable Package, versión 1, seleccionando el formato unificado y el modelo correspondiente. Una ruta de entrada incorrecta puede producir el error fnomoduledefinition.json file not found.
Para un proceso recurrente, recomendamos evaluar esta generación directa: facilita identificar qué compilación produjo cada artefacto. La conversión sigue siendo útil al recibir paquetes existentes.
Fuentes y alcance
La publicación de Ravikant Motla del 18 de septiembre de 2026 motivó esta guía. El procedimiento y el error de modelos duplicados se contrastaron con Microsoft Learn. No se afirma compatibilidad universal ni se presenta la conversión como una validación funcional.