Guía – Entendiendo Sintaxis Dinámica. A través de B1 Usability Package encontrará el uso de sintaxis dinámica. Esto es inspirado en la manera en que SAP utiliza su sintaxis de búsquedas formateadas que le permite ejecutar sentencias de SQL y otros argumentos que le permitirá a través de esta sintaxis específica sustituirla por valores de la ventana actual de SAP Business One en la que se encuentre trabajando.

La sintaxis. Hay básicamente dos tipos de sintaxis, la sintaxis de campo y la sintaxis de tabla. La sintaxis de campo. Es la sintaxis más común que le permitirá colocar un valor de la ventana de SAP a una sentencia de SQL. La sintaxis es como se menciona a continuación:

$[$..] Donde , y son los tres valores que necesitamos indicar. Vamos a ver un ejemplo:

Aquí tenemos una Orden de Venta y hemos señalado 6 de los campos. Ellos son representados por diferentes tipos de datos que encontraremos en SAP Business One. 1. 2. 3. 4. 5.

Valores de cadena (Nombre del cliente). Valores enteros (Número de documento). Fechas (Fecha de contabilización). Datos a nivel línea (Precio después del descuento). Valores decimales (Descuento).

6. Valores decimales mezclados con códigos de moneda (Total de documento). Ahora vamos a ver cada uno de ellos y los trasladaremos a su sintaxis dinámica. Valores cadena (Nombre del cliente). Es el campo con Uid 54 y el tipo es cadena. No está a nivel línea por lo tanto no enviaremos el Uid de la columna (dejaremos el valor en 0). El tipo de datos de cadena de caracteres puede ser representado con la palabra STRING o con el mayormente popular 0 (ya que es más rápido de escribir). Con esta información nuestro valor dinámico sería:

$[$54.0.STRING] $[$54.0.0]

Si la ocupamos en una sentencia de SQL: SELECT $[$54.0.0] = SELECT ‘Norm Thomson’ Valores enteros (Número de documento). El Uid de este campo es el 8 y es de tipo entero. No está a nivel línea por lo tanto no enviaremos el Uid de la columna (dejaremos el valor en 0). El tipo entero en la sintaxis es representado por la palabra NUMBER. Con esta información nuestro valor dinámico sería:

$[$8.0.NUMBER] Si la ocupamos en una sentencia de SQL: SELECT $[$8.0.NUMBER] = SELECT 356 Fechas (Fecha de contabilización). El Uid de este campo es el 10 y es de tipo fecha. No está a nivel línea por lo tanto no enviaremos el Uid de la columna (dejaremos el valor en 0). El tipo entero en la sintaxis es representado por la palabra DATE. Con esta información nuestro valor dinámico sería:

$[$10.0.DATE] Si la ocupamos en una sentencia de SQL: SELECT $[$10.0.DATE] = SELECT ‘2013-11-01’ (2013-11-01) es variable, por lo cual si desea hacer comparativas tomar en cuenta el formato que tiene. Datos a nivel línea (Precio después del descuento). El Uid de este campo es el 38 y es una mezcla de decimales con monedas. Este campo se encuentra a nivel línea por lo que necesitamos el Uid de la columna que es el 17. El tipo de datos decimal/moneda en la sintaxis puede mostrarse tanto ingresando el tipo NUMBER o CURRENCY1. Con esta información el valor dinámico sería:

$[$38.17.NUMBER] $[$38.17.CURRENCY] Si lo usamos en una sentencia de SQL: SELECT $[38.17.NUMBER] = SELECT 600.00 Valores decimales (Descuento). El Uid de este campo es el 24 y es de tipo decimal. No está a nivel línea por lo tanto no enviaremos el Uid de la columna (dejaremos el valor en 0). El tipo de datos decimales en la sintaxis es mostrado con las palabras NUMBER o CURRENCY. Con esta información nuestro valor dinámico sería:

$[$24.0.NUMBER] $[$24.0.CURRENCY] Si utilizamos esto en una sentencia de SQL: SELECT $[$24.0.NUMBER] = SELECT 10.50 Valores decimales mezclados con códigos de moneda (Total de documento). El Uid del campo es el 29 y el tipo es una mezcla de decimales y monedas.

No está a nivel línea por lo tanto no enviaremos el Uid de la columna (dejaremos el valor en 0). El tipo de datos decimales en la sintaxis es mostrado con las palabras NUMBER o CURRENCY. Con esta información nuestro valor dinámico sería:

$[$29.0.NUMBER] $[$29.0.CURRENCY] Si utilizamos esto en una sentencia de SQL: SELECT $[$29.0.NUMBER] = SELECT 954.00

La sintaxis de tabla En algunos casos los campos definidos por el usuario tienen una ventana que hace que internamente tengan un valor pero no sean mostrados al usuario. Si ese es el caso utilizamos la tabla de sintaxis en su lugar.

Tenemos un campo definido por el usuario llamado Número de Kit, pero ya que forma parte de la barra lateral y no de la ventana principal necesitamos utilizar la siguiente sintaxis. $[..] Trabaja de la misma manera que la sintaxis de campos y requerimos enviar tres parámetros. El campo se encuentra en la tabla ORDR y el nombre del campo es U_KitNo. El tipo de dato es cadena (STRING o 0). Por lo tanto la sintaxis quedaría de la siguiente manera:

$[ORDR.U_KitNo.STRING] $[ORDR.U_KitNo.0] Si lo utilizamos en una sentencia de SQL: SELECT $[ORDR.U_KitNo.0] = SELECT ‘A1234’ Sintaxis de palabras especiales. NOTA: Este tipo de sintaxis es soportada en B1UP 2.910 o superior.

Otro tipo de sintaxis además de las dos mencionadas con anterioridad, es la utilizada por SAP para búsquedas formateadas y son dos palabras adicionales que pueden ser utilizadas en B1UP también. Palabras de búsquedas formateadas. Palabra Descripción $[USER] Devuelve el Id único del usuario conectado. NOTA: Revisar que el valor devuelto no es el nombre del usuario, si no el Id interno. Puede utilizar una unión a la tabla OUSR para obtenerlo o usar la palabra reservada de B1UP $[USERNAME].

$[PERIOD]

Devuelve el periodo contable actual.

Palabras de B1UP. Para extender la funcionalidad de la sintaxis dinámica, B1UP acepta las siguientes palabras reservadas. Palabra $[USERNAME] $[DATABASENAME] $[LOCALIZATION] $[COMPANYNAME] $[SERVERNAME] $[SERVERDATE] $[SERVERTIME] $[SYSTEMID] $[INSTALLATIONID] $[CURRENT_PANE] $[CURRENT_LANGUAGE]

Descripción El nombre del usuario actualmente conectado. El nombre de la base de datos a la cual se está conectado. El país de la base de datos. El nombre de la compañía. El nombre del servidor. La fecha del servidor mostrado en el formato del cliente. La hora del servidor mostrada en el formato del cliente. El Id del sistema de la compañía. El Id de instalación de la compañía. El panel actual del formulario. El idioma actual del cliente de B1UP en su forma numérica. 1 = Hebreo, 2 = Español (Argentina), 3 = Inglés (Estados Unidos), 5 = Polaco, 6 = Inglés (Singapur), 7 = Español (Panamá), 8 = English (Reino Unido), 9 = German, 10 = Serbio, 11 = Danés, 12 = Noruego, 13 = Italiano, 14 = Húngaro, 15 = Chino, 16 = Holandés, 17 = Finlandés, 18 = Griego, 19 = Portugués, 20 = Sueco, 22 = Francés, 23 = Español, 24 = Ruso, 25 = Español (América Latina), 26 = Checo, 27 = Eslovaco, 28 = Coreano, 29 = Portugués (Brasil), 30 = Japonés, 31 = Turco, 35 = Chino tradicional (Hong Kong)

$[NEWID]

El ID del objeto que se ha agregado (por ejemplo, el DocEntry de una factura recién creada). ADVERTENCIA: ESTA PALABRA RESERVADA SOLO SERÁ REMPLAZADA SI EL EVENTO ES DATA ADD O DATA UPDATE EN EL SISTEMA DE VALIDACIÓN (LA PALABRA NO SERÁ REMPLAZADA CON OTRO TIPO DE EVENTOS).

$[ROW] $[ATTACHMENT_FOLDER] $[BITMAP_FOLDER] $[WORD_FOLDER] $[EXTENSION_FOLDER] $[EXCEL_FOLDER]

La fila del evento. La ruta de la carpeta de adjuntos de SAP. La ruta de la carpeta de imágenes de SAP. La ruta de la carpeta de Word de SAP. La ruta de la carpeta de extensiones de SAP. La ruta de la carpeta de Excel de SAP.

$[XML_FOLDER]

La ruta de los archivos XML de SAP.

Sintaxis adicional B1UP ha extendido la sintaxis dinámica de SAP la cual normalmente involucra al campo, la columna y el tipo, con B1UP podemos considerar la sintaxis extendida tomando en cuenta el número de fila o la cabecera. Funcionalidad Descripción $[$...] Con esta sintaxis extendida se puede definir la fila específica con la que se estará trabajando. Las opciones de fila pueden ser:  1, 2, 3,… n.  .FIRST  .LAST  .LAS-1  .SELECTED  .FOCUSED Puede encontrar más información en el siguiente video: http://youtu.be/SdCUS9IZF7Q ROWSHEADER Si requiere tomar la cabecera de una fila de una matriz lo puede hacer de la siguiente manera: $[$.ROWSHEADER.0]