Visión general

a3ERP permite personalizar buena parte de su comportamiento sin escribir ni una línea de código de aplicación: basta con escribir SQL en las pantallas de configuración que la propia herramienta ofrece. A eso lo llamamos parametrización, y es importante no confundirlo con los addons — DLLs y desarrollos a medida que sí son programación y están documentados en su propia categoría, Addons a3ERP. La frontera práctica es esta: si la personalización consiste en pegar una consulta SQL en una pantalla de a3ERP, es parametrización; si hay que compilar, instalar o registrar algo, es un addon.

Los cuatro artefactos#

a3ERP tiene cuatro sitios distintos donde se puede inyectar SQL, cada uno con su propósito:

Cada uno tiene su propio artículo en esta categoría con el detalle de parámetros, trampas y patrones recomendados. Este artículo cuenta lo que necesitas saber antes de tocar cualquiera de ellos.

La idea clave: tu SQL pasa por el intérprete de a3ERP#

Aunque los cuatro artefactos acaban ejecutando T-SQL contra SQL Server, ninguno le pasa tu consulta directamente. Los listados de impresión, las parrillas de búsqueda y las vistas SQL viven dentro de a3ERP y comparten su intérprete: un analizador que recorre el texto SQL antes de enviarlo, sustituyendo los marcadores de parámetros y reaccionando a caracteres especiales como : o [...] — incluso cuando aparecen dentro de un comentario. Los cubos de BI son la excepción: a3ERP BI es una aplicación aparte, con su propio motor, que no interpreta marcadores y ejecuta la consulta tal cual.

Esto tiene una consecuencia que conviene interiorizar desde el primer día: una consulta puede funcionar perfectamente en SSMS y aun así petar dentro de a3ERP. El error no está en el SQL — está en cómo el intérprete ha leído el texto. El síntoma típico es el error Sentencia incorrecta: Objeto Parameter mal definido. Se proporcionó información incompleta o incoherente. cuando el intérprete encuentra un : o un [...] donde no esperaba. Por eso SSMS sirve para validar la sintaxis y probar la lógica, pero la prueba real siempre es dentro de a3ERP. Los listados, además, pasan por un segundo motor — el de informes, que mapea los datasets del diseño — con sus propias trampas, detalladas en su artículo.

El intérprete es común, pero cada pantalla activa unos parámetros u otros. Esta tabla resume lo que significa cada sintaxis según dónde estés:

Lo que sí comparten todos#

• Dialecto: T-SQL para SQL Server.
• WITH (NOLOCK) por defecto en todos los joins. Estas consultas se ejecutan en bases de datos de producción mientras hay transacciones en curso — alguien está facturando o modificando documentos en ese mismo momento. Sin el hint, la consulta puede bloquear esos documentos o quedarse bloqueada ella. No lo quites salvo que tengas un motivo claro, y en ese caso déjalo documentado.
• Los códigos están "cuadrados". Es el término de a3ERP para cómo guarda los códigos en la base de datos: completados con espacios por la izquierda hasta una longitud fija, normalmente 8 caracteres (CODFAMEST = ' 1' son ocho). Un WHERE CODFAMEST = '1' sin los espacios no encuentra nada, así que en los literales hay que respetar el espaciado exacto.

Las longitudes de cuadrado que se salen de la norma de 8: