Compartir a través de

Realizar seguimiento del origen y crear metadatos en extensiones

  • Artículo

Importante

Este contenido está archivado y no se actualiza. Para obtener la documentación más reciente, vaya a Novedades o cambios en Business Central. Para conocer los últimos planes de lanzamiento, vaya a los planes de lanzamiento de Dynamics 365, Power Platform y Cloud for Industry.

Habilitada para Versión preliminar pública Disponibilidad general
Administradores, creadores, vendedores o analistas, automáticamente 16 de agosto de 2023 2 de oct. de 2023

Valor empresarial

Para ayudar a realizar un seguimiento de las extensiones que se crean como parte de las canalizaciones de DevOps, presentamos las propiedades Source y Build en el manifiesto de extensiones app.json. Esto permite encontrar con facilidad el repositorio de origen relevante, el id. de confirmación y el sistema de compilación usado para crear la extensión.

Detalles de características

El manifiesto de extensiones app.json ahora contiene dos nuevas propiedades: Source y Build. Estos se pueden utilizar para realizar un seguimiento de la ubicación de origen y el contexto de compilación.

Para el origen, admitimos:

  • repositoryUrl, que es la URL del repositorio donde se puede encontrar el código fuente del proyecto.
  • commit, que es un id. del código fuente de la versión actual del proyecto, lo cual permite volver a la confirmación que desencadenó la creación de la extensión.

Para la compilación, admitimos:

  • by, que es útil para realizar un seguimiento del sistema/agente de compilación que orquestó la compilación; por ejemplo, AL-Go for GitHub.
  • url, que se puede utilizar para la URL de la invocación del sistema de compilación donde se puede encontrar la compilación.

Puede definir estos valores directamente en app.json, pero dada la naturaleza dinámica, el escenario habitual sería configurarlos como parte de las canalizaciones de compilación mediante parámetros de línea de comandos para el ejecutable del compilador alc.exe usado. Los valores pasados aquí sobrescribirán cualquier valor del archivo de origen app.json.

Si usa BcContainerHelper, las funciones Compile-AppInBcContainer y Compile-AppWithCompilerFolder ahora toman los parámetros para "SourceRepositoryUrl", "SourceCommit", "BuildBy" y "BuildUrl". Ahora se están configurando si usa AL:Go para que GitHub cree sus extensiones.

En esta versión, ninguno de estos valores ha aparecido todavía en la página Administración de extensiones, en TAC o mediante comandos de PowerShell como NAV-AppInfo. Si desea leer los valores, la opción actualmente es utilizar el BcContainerHelper "Extract-AppFileToFolder", que permitirá obtener el archivo app.json con la configuración.

A continuación se muestra un ejemplo de metadatos de compilación y origen en app.json. Normalmente, esto se establece mediante el proceso de compilación y no manualmente.

Ejemplo de metadatos de compilación y origen en app.json

Qué piensa

Ayúdenos a mejorar Dynamics 365 Business Central con ideas, sugerencias y comentarios. Use el foro de https://aka.ms/bcideas.

Consulte también

Archivos JSON (documentación)