Trabajar con archivos de configuración JSON
JSON significa JavaScript Object Notation (notación de objetos JavaScript), que es un formato ligero de intercambio de datos que suele utilizarse para almacenar y transportar datos. Una extensión AL contiene dos archivos JSON: app.json y launch.json. Estos archivos se crean automáticamente cuando inicia una nueva extensión AL y se utilizan para almacenar datos de configuración.
Archivo Launch.json
Launch.json es un archivo de configuración que contiene información sobre el servidor en el que se implementará la extensión para probarla y depurarla. Se pueden utilizar dos configuraciones, dependiendo de si la extensión se publica en un servidor local o en la nube.
La siguiente tabla describe propiedades importantes y obligatorias del archivo launch.json. Sin embargo, es importante aprender primero sobre las propiedades startupObjectId y startupObjectType en este archivo launch.json.
Cada vez que inicie su extensión desde Visual Studio Code, buscará este archivo launch.json para determinar con qué objeto tiene que comenzar. La imagen anterior muestra que comenzará en la página 22, que es la página Lista de clientes. Si desarrolla sus propias páginas y desea empezar con ellas, sustituya la propiedad startupObjectId por su propio número de página.
Aquí hay un vínculo donde puede encontrar más información sobre toda la configuración del archivo Launch.json: archivo launch.json.
Archivo app.json
El archivo app.json contiene información sobre la extensión que está creando, como información del editor, el nombre y la versión compatible mínima. A menudo, el archivo app.json se conoce como manifiesto.
Aquí hay un vínculo donde puede encontrar más información sobre toda la configuración del archivo App.json: archivo app.json.
Identidad de la aplicación
Las aplicaciones creadas con AL amplían la funcionalidad de Business Central. El archivo app.json, junto con el archivo launch.json, se genera automáticamente cuando crea un nuevo proyecto de AL. El archivo app.json contiene información sobre la aplicación que está creando, como información del editor, y especifica la versión mínima de los objetos de la aplicación base sobre la que se crea la extensión. A menudo, el archivo app.json se conoce como manifiesto. El archivo app.json contiene numerosas configuraciones del proyecto, pero algunas de ellas constituyen la identidad real de la aplicación que está creando.
Desde el segundo lanzamiento de versiones de Business Central 2021, nombre y editor ya no se consideran parte de la identidad de la aplicación y, por lo tanto, se pueden cambiar para reflejar la marca o la adquisición, por ejemplo. Si se cambia la información de nombre o editor, la versión también debe incrementarse. Si utiliza espacios de trabajo con varios proyectos y cambia el nombre o el editor de una extensión en el espacio de trabajo, las dependencias en el archivo app.json deben actualizarse con el nuevonombre y editor; de lo contrario, podría tener problemas con la resolución de referencias.
La extensión del lenguaje AL genera automáticamente el Id. de una aplicación cuando crea una nueva aplicación o si usa el comando AL: Generar manifiesto.
Si ha copiado la aplicación o el manifiesto de otra aplicación, debe cambiar el Id. antes de publicarlo en el servicio en línea como una extensión por inquilino o aplicación AppSource.
Después de que se haya publicado la aplicación, solo debe cambiar el Id. si tiene la intención de utilizar el código base para desarrollar una nueva aplicación. No podrá pasar de la aplicación con el Id. antiguo a la aplicación con el nuevo Id. porque el sistema no tiene conocimiento sobre la correspondencia.
Si ha publicado su aplicación como una extensión por inquilino, pero ahora está considerando publicarla en AppSource, debe asignar un nuevo Id. en la aplicación AppSource, así como asegurarse de que sigue todos los requisitos técnicos para publicar en AppSource.
Se recomienda usar un Id. diferente para la aplicación que publique desde Visual Studio Code o en un contenedor. Una vez que esté satisfecho con la calidad de su aplicación y esté listo para publicarla en AppSource, se recomienda utilizar un Id. diferente. Si no lo hace, la aplicación que ha publicado desde Visual Studio Code en un espacio aislado de desarrollador se anulará automáticamente si otro usuario intenta instalar la aplicación AppSource.
Si se dirige solo al segundo lanzamiento de versiones de Business Central 2021 o posterior, el nombre y el editor de la aplicación se pueden cambiar en cualquier momento, incluso después de que se haya publicado. Si se cambia el nombre, la versión también se debe incrementar.
Si se dirige a versiones de Business Central previas al segundo lanzamiento de versiones de 2021, el nombre y el editor de la aplicación no podrán cambiarse tras la publicación.
La versión debe incrementarse cada vez que se cargue una nueva versión de su aplicación en AppSource o como una extensión por inquilino. Mientras lo desarrolla en Visual Studio Code, puede seguir usando la misma versión e iterar en su código.