Descubrimiento de la base de datos lógica y sus objetos
Dynamics 365 Business Central se ha creado, como muchas otras aplicaciones en la nube, sobre una base de datos. Esta base de datos no solo contiene los datos (como clientes, proveedores, productos, etc.), sino que también contiene todos los objetos que se utilizan en la aplicación. Cuando solicita datos de los clientes, estos datos se muestran con una página en la pantalla con una determinada estructura.
La base de datos de Business Central también almacena la estructura de esta página, lo que permite a los desarrolladores agregar y modificar los objetos existentes e implementar nuevas soluciones con rapidez. Cuando desee cambiar la posición de ciertos campos de entrada en la pantalla, no necesitará crear una nueva versión del producto.
Cada solución se basa en uno o más objetos. Necesitará tablas para almacenar sus datos, páginas para presentar sus datos, capacidad para permitir la interacción del usuario, informes para la presentación y capacidad para imprimir datos en diseños específicos.
Con las codeunits, puede agrupar funciones para reutilizarlas en diferentes lugares. Puede usar el objeto Consulta para consultar la base de datos y, si necesita importar o exportar capacidades en su solución, podrá utilizar el objeto XMLPort.
Entre los tipos de objetos utilizados habitualmente se incluyen:
Tabla: describe cómo se almacenan los datos y cómo se recuperan.
Página: permite a los usuarios ver, agregar, modificar o eliminar registros en una tabla.
Informe: permite imprimir, procesar u obtener una vista previa de los datos.
Codeunit: contenedor de código de programación. Las codeunits se invocan desde otros objetos para completar una tarea específica.
Consulta: un modelo de datos relacional para realizar consultas directas y eficientes en la base de datos subyacente.
XMLPort: importa o exporta datos en formato XML o de texto.
Business Central cuenta con numerosos objetos funcionales incorporados. No puede cambiar el código de origen de los objetos, pero puede modificar el comportamiento extendiendo los objetos integrados.
Otros dos tipos de objetos que puede utilizar son:
Extensión de tabla: extiende la funcionalidad de las tablas existentes.
Extensión de página: extiende la funcionalidad de las páginas existentes.
Extensión de informe: extiende la funcionalidad de los informes existentes.
Base de datos lógica
En la base de datos de Business Central, puede configurar diferentes empresas. Los datos de una empresa se almacenan como registros en diferentes tablas y cada registro está compuesto por múltiples campos.
Las empresas son la estructura lógica más grande en una base de datos y los datos son, y deberían ser, principalmente específicos de la empresa. Mientras que los datos son en la mayoría de los casos específicos de la empresa, los objetos no lo son. Como desarrollador, creará y cambiará/ampliará los objetos. Los objetos serán aplicables a todas las empresas de la misma base de datos.
Administrar objetos
Antes de comenzar a crear nuevos objetos para sus soluciones personalizadas, tenga en cuenta las convenciones de numeración de objetos. Cada objeto de su solución Business Central se identifica mediante un número exclusivo. Las convenciones de numeración le ayudan a organizar la gestión de versiones, la localización y la personalización, además de ayudarle a garantizar que las actualizaciones se realicen correctamente.
Los números de objeto del 0 al 49 999 son objetos que usa Microsoft y se utilizan en las versiones de todo el mundo. El intervalo de números de 100 000 a 999 999 contiene los objetos localizados. Estos objetos generalmente están diseñados para diferentes países y regiones del mundo. Estos objetos específicos de áreas también los crea Microsoft.
Cuando se desarrolla una aplicación para Business Central online, se debe solicitar un rango de objetos para las licencias. El desarrollo para Business Central se lleva a cabo con Visual Studio Code y con la extensión del lenguaje AL para Microsoft Dynamics 365 Business Central.
Actualmente, hay dos rangos disponibles que puede solicitar. Ambos tienen algunas características que debe tener en cuenta:
Rango de objetos RSP (Rango de ID: 1 000 000-69 999 999): este rango de objetos está vinculado al programa RSP. Debe iniciar sesión para ver esta información con una cuenta profesional o educativa. Actualmente, aconsejamos a los nuevos editores que no soliciten un rango de objetos RSP.
Rango de objetos de aplicación (Rango de id: 70 000 000-74 999 999): este rango de objetos se diseñó originalmente solo para aplicaciones del Marketplace comercial de Microsoft para su uso en Business Central Online. Actualmente, aconsejamos a los nuevos editores que soliciten un rango de objetos de aplicación.
Actualmente, puede implementar aplicaciones desarrolladas tanto en el rango RSP como en el rango de objetos de aplicación en Business Central Online y localmente, así como hospedadas por partners.
Para obtener más información, consulte Solicitud de un rango de objetos.
En las secciones siguientes, se describen los distintos rangos de objetos que puede encontrar en la aplicación base y las extensiones.
0-49 999
Este rango se asigna a la funcionalidad de la aplicación básica de Business Central, y no debe usarse en extensiones ni personalizaciones.
50 000-99 999
Este rango se usa para personalizaciones y pruebas. Para Business Central Online, un partner puede desarrollar una extensión que se adapte al inquilino individual para satisfacer sus necesidades. El partner desarrolla la extensión utilizando un inquilino de espacio aislado u obteniendo una imagen de Docker. Una vez que se completa el desarrollo, la extensión se puede implementar en el inquilino individual.
Además, puede usar este rango como parte de actividades de formación o similares; por ejemplo, si utiliza un inquilino de espacio aislado o una compilación de Business Central en Docker.
100 000-999 999
Los objetos de este rango se diseñan cuando el equipo de Microsoft localiza Business Central para un país o una región específicos. Estos objetos no pueden ser utilizados por partners.
1 000 000-69 999 999
Este rango de objetos está destinado al Programa de solución registrada (RSP). El partner puede elegir entre usar este rango para desarrollar extensiones que se puedan usar en Business Central Online o local. Cuando se usan en Business Central Online, estas extensiones se obtienen como aplicaciones de Appsource.
70 000 000-74 999 999
Los partners pueden obtener id. en este rango para extensiones para Business Central Online. Estas extensiones también se obtienen como aplicaciones de Appsource. Para obtener más información, consulte Introducción a la creación de aplicaciones.
Consulte las guías de licencias para descargar la guía de licencias de Business Central.
Prefijo y sufijo
En su extensión, el nombre de cada nuevo objeto de aplicación (tabla, página, codeunit) debe contener un prefijo o un sufijo. Esta regla se aplica a todos los objetos. Puede usar los valores de subtítulo para lo que decida mostrarle al usuario. Cuando modifica un objeto principal de Dynamics 365 con una extensión de tabla o una extensión de página, el prefijo/sufijo debe definirse en el nivel de control/campo/acción/grupo.
Ventajas
El uso de un prefijo/sufijo reduce las colisiones de nombres con objetos definidos en otras extensiones. Los entornos que tienen extensiones con colisiones de nombres pueden experimentar problemas al implementar nuevas extensiones, al actualizar el entorno o al crear un espacio aislado como copia del entorno actual (para entornos de producción).
Reglas generales
Estas son algunas reglas generales que hay que seguir:
El prefijo/sufijo debe tener al menos tres caracteres
El nombre del objeto/campo debe comenzar o terminar con el prefijo/sufijo
Si surge un conflicto, siempre prevalece el que registró el prefijo o sufijo
Para sus propios objetos, debe establecer el prefijo/sufijo en el nivel de objeto superior
Para páginas/tablas/enumeraciones/informes/conjuntos de permisos en la aplicación base u otras aplicaciones que amplíe, debe establecer el prefijo/sufijo en el nivel de objeto superior y también en el nivel de control/campo/acción/procedimiento/valores/elemento de dato/columna.
Utilice la herramienta AppSourceCop para encontrar todos los prefijos o sufijos que falten. Las opciones de configuración para esta herramienta, junto con una sección de reglas, se pueden encontrar en Reglas del analizador AppSourceCop. La sección Reglas explica las diferentes comprobaciones que realizará el analizador. Para la detección de prefijos/sufijos, consulte la sección Configuración. Explica cómo configurar su prefijo/sufijo en el archivo AppSourceCop.json.
Requisitos de prefijo y sufijo para extensiones
Hay algunos requisitos para AppSource y las extensiones de inquilino.
Para las extensiones de AppSource
Se requiere el uso de un prefijo/sufijo para los nombres de objeto para los envíos de AppSource como parte de la lista de verificación Validación técnica.
Para cumplir con los requisitos de la validación técnica de AppSource, debe tener un prefijo/sufijo de tres letras registrado para el editor de su extensión y debe usarlo en su extensión.
Si aún no tiene ningún prefijo o sufijo registrado, póngase en contacto con Microsoft en d365val@microsoft.com y proporcione la siguiente información para reservar el prefijo o sufijo de su elección.
Su id. de MPN
El nombre del editor que usa en sus extensiones (en el archivo app.json)
Debe proporcionar al menos cinco sugerencias de prefijo/sufijo. Cada uno debe tener exactamente tres caracteres.
Los prefijos/sufijos no distinguen entre mayúsculas y minúsculas; es decir, "ABC", "abc" y "AbC" se tratan de la misma manera. Si opta por "ABC" y "abc", se tratará como una sola sugerencia.
Tenga en cuenta que no es necesario que cambie ningún prefijo o sufijo ya registrado; puede seguir usándolos. Las directrices solo se aplican a los nuevos registros.
Para las extensiones por inquilino
No es obligatorio que las extensiones por inquilino utilicen un prefijo o sufijo, pero sí que es muy recomendable. Puede utilizar pte como prefijo o sufijo para evitar conflictos con aplicaciones de AppSource u objetos base.
Si su extensión por inquilino provoca un conflicto con un nuevo objeto en la aplicación base o una aplicación de AppSource actualizada, la extensión por inquilino debe realizar el cambio.
Para obtener más información sobre el uso de prefijos o sufijos, consulte Ventajas y directrices sobre el uso de un prefijo o sufijo.