QUERYS

Page 1 of 9

QUERYS

QUERYS

Manual de Usuario
AddIn Querys

Created with the Personal Edition of HelpNDoc: Free EPub producer

Created with the Personal Edition of HelpNDoc: Produce electronic books easily
Copyright 2015 by OK ONE SAS. All Rights Reserved.

Alcance
QUERYS

Alcance
QUERYS

El siguiente documento presenta paso a paso el proceso de utilizacin del AddIn Querys, funcionalidad agregada en el AddOn Best Practices para SAP Business
One.

Utilidad del add-on

El AddIn Querys permite la modificacin de parmetros de las consultas de usuario alojadas en el Query Manager de SAP Business One con sus respectivos textos o
Labels, facilitando al usuario el ingreso de datos y/o parmetros de entrada.

file:///C:/Users/caran_000/AppData/Local/Temp/~hh4353.htm

05/02/2016

QUERYS

Page 2 of 9

Actividades
Funcionalidad del AddIn Querys
Creacin o modificacin de nuevos parmetros.
- Textos o Labels.
- Consultas.
- Valores fijos.

Rutas del proceso

Windows 32Bits
C:\Program Files\SAP\SAP Business One\AddOns\OK1\addInQuerys\Resources\Querys

Windows 64Bits
C:\Program Files (x86)\SAP\SAP Business One\AddOns\OK1\BestPractices\addInQuerys\Resources\Querys

Created with the Personal Edition of HelpNDoc: Easy CHM and documentation editor
Created with the Personal Edition of HelpNDoc: Easily create PDF Help documents
Copyright 2015 by OK ONE SAS. All Rights Reserved.

Funcionalidad
QUERYS

Funcionalidad
QUERYS

Las consultas (en Ingls Querys) almacenadas en el Query Manager de SAP Business One tienen parmetros de entrada para que se puedan ejecutar
correctamente, en algunos casos la introduccin de la informacin solicitada puede ser suministrada fcilmente, tal es el caso del ao de generacin del reporte o el
nombre del empleado de ventas, pero existen casos en los que la informacin solicitada no es fcil de obtener, como el cdigo interno de una factura o el cdigo
interno de un empleado.
El AddIn Querys permite la modificacin de los parmetros de la consultas, obteniendo informacin, de acuerdo a lo requerido por el cliente, por ejemplo se puede
buscar por el nombre del empleado y con este introducir el cdigo de este en los parmetros, con esto la informacin se obtiene de forma fcil y rpida,
reduciendo el tiempo de generacin de los reportes.

Utilizando el AddIn Querys

La modificacin de los parmetros de consulta se realiza a travs de un archivo XML, este debe llevar el mismo nombre de la consulta a la que quiere modificar los
parmetros, ejemplo:
Si la consulta se llama ReporteAnual1, el archivo debe llamarse de la siguiente forma: ReporteAnual1.xml
Este archivo (con extensin .xml) debe ser guardado en la siguiente ruta dependiendo de la versin de Windows que posea:
Windows 32Bits
Ingls
C:\Program Files\SAP\SAP Business One\AddOns\OK1\addInQuerys\Resources\Querys
Espaol
C:\Archivos de Programa\SAP\SAP Business One\AddOns\OK1\addInQuerys\Resources\Querys

Windows 64Bits
Ingls
C:\Program Files (x86)\SAP\SAP Business One\AddOns\OK1\BestPractices\addInQuerys\Resources\Querys
Espaol
C:\Archivos de Programa(x86)\SAP\SAP Business One\AddOns\OK1\addInQuerys\Resources\Querys

file:///C:/Users/caran_000/AppData/Local/Temp/~hh4353.htm

05/02/2016

QUERYS

Page 3 of 9

Modificacin de parmetros
La modificacin de los parmetros se realiza a travs de un archivo XML, este debe ser creado siguiendo la estructura y/o sintaxis del estndar XML, aunque no se
necesita poseer conocimientos avanzados, slo debe seguir los siguientes pasos:
NOTA1: Debe recordar que cada <Etiqueta> deber ser debidamente cerrada con </Etiqueta> o abierta y cerrada en la misma lnea: <Etiqueta texto1 />
NOTA2: La edicin del archivo la puede realizar a travs de cualquier editor de texto como Bloc de Notas o Wordpad, en caso que desee un programa dedicado o
especializado lo puede realizar con cualquier software de programacin como Microsoft VisualStudio o notepad++, este ltimo es gratuito y muy liviano.

Encabezado del archivo

<?xml version="1.0" encoding="utf-8" ?> //Indica que el archivo es un Archivo XML y va a contener la codificacin de caracteres estndar UTF-8
Contenido del Archivo
<Queries> //Etiqueta que indica bloque de varias consultas.
<Query>//Etiqueta que indica contenido en una consulta especfica.
<Items>//Etiqueta que indica el contenido de los objetos que estn contenidos dentro del formulario de parmetros, esta es el rea que se modificar.
<Form UID="1000001" String="" Caption="Parmetro1"/>//Dentro de la etiqueta Form se incluir cada nmero de Item que se desee modificar y su
contenido.
<Form UID="1000005" String="" Caption="Parmetro2"/>
<Form UID="1000009" String="" Caption="Parmetro3"/>
</Items>//Indica el cierre de la etiqueta Items.
</Query>//Indica el cierre de la etiqueta Query.
</Queries>//Indica el cierre de la etiqueta Queries.
Como se ha dicho en anteriormente dentro de la etiqueta Items se modificarn los parmetros de consulta, estas modificaciones se podrn hacer de tres formas:
1. Cambiando el texto del parmetro de entrada con el propsito de hacer entendible al usuario cual es el parmetro que se solicita: Textos o Labels
2. Adicionando o modificando la consulta del campo donde se introduce el parmetro con el objetivo de filtrar la informacin a introducir o mostrar valores

que son vlidos para el reporte: Consultas

3. Adicionando o modificando valores fijos con el nimo de mostrar valores vlidos a introducir evitando que el usuario digite valores errneos: Valores Fijos

La siguiente imagen presenta un ejemplo de cmo deber ser el diseo del XML con los 3 ejemplos para la modificar parmetros los cuales sern explicados de
forma detallada:

Created with the Personal Edition of HelpNDoc: Free Web Help generator
Created with the Personal Edition of HelpNDoc: Free PDF documentation generator
Copyright 2015 by OK ONE SAS. All Rights Reserved.

Textos o Labels
QUERYS Funcionalidad

Textos o Labels
QUERYS Funcionalidad

file:///C:/Users/caran_000/AppData/Local/Temp/~hh4353.htm

05/02/2016

QUERYS

Page 4 of 9

Los textos o Labels son los textos que aparecen en junto a los cuadros de texto que reciben los datos de entrada para consulta, estos labels indican o dan indicio del
dato que se espera que el usuario digite en el cuadro de texto.

En la imagen anterior se presenta una consulta la cual no es muy clara respecto a los datos que solicita, as que con el AddIn Querys se podr cambiar tal texto sin
tener que modificar la consulta real del Query Manager.
Para modificar los textos de los parmetros de consulta, siga los siguentes pasos:
Paso 1
Encontrar el UID del label que se modificar
Para ello debemos activar la visualizacin de informacin del sistema, para ello se debe hacer lo siguiente:
Opcin 1
Oprimir las teclas Ctrl + Shft + I, con esta combinacin se activar la visualizacin de informacin del sistema
Opicin 2
Ir a: Visualizar -> Informacin del Sistema:

Una vez activada la informacin del sistema, coloque el puntero de mouse sobre el label; en la parte de inferior de SAP Business One, aparecer la
informacin interna del Label, tal y como se muestra en la imgen.

Paso 2
Modificar Archivo
En el archivo XML crear una etiqueta de la siguiente manera:
<Form UID="1000001" String = "" Caption = "Nuevo Texto o Label"/>
Dato

Descripcin

UID

Es el cdigo interno del label.

String

Valor generalmente vaco para los labels.

file:///C:/Users/caran_000/AppData/Local/Temp/~hh4353.htm

05/02/2016

QUERYS

Page 5 of 9

Caption

Escriba el nuevo texto aparecer en los parmetros.

Ejemplo:

Paso 3
Revisar cambios
Una vez se guarde el archivo en la ruta del AddIn Querys (Ver Funcionalidad), los parmetros de entrada se mostrarn de la siguiente forma:

Repita el mismo proceso para los dems labels.

Created with the Personal Edition of HelpNDoc: Create HTML Help, DOC, PDF and print manuals from 1 single source
Created with the Personal Edition of HelpNDoc: Create HTML Help, DOC, PDF and print manuals from 1 single source
Copyright 2015 by OK ONE SAS. All Rights Reserved.

Consultas
QUERYS Funcionalidad

Consultas
QUERYS Funcionalidad

Con una consulta se podrn filtrar datos y mostrarlos como datos vlidos de entrada, al igual que podr buscar ms fcilmente los datos requeridos, generalmente
las consultas alojadas en el Query Manager tienen algn filtro cuando se necesitan datos especficos pero estos no son tiles o presentan un gran cantidad de
informacin que hace difcil la tarea de encontrar el dato deseado.

En la imagen anterior se muestra un lista de seleccin para artculos el cual muestra slo el nmero de artculo y el nmero de registros en que aparece, esto aparte
de no ser muy coherente es muy difcil buscar en listas como esta.
Para adicionar una consulta al parmetro siga los siguientes pasos:

Paso 1
Encontrar el UID del cuadro de texto al que se le adicionar o modificar la consulta.

file:///C:/Users/caran_000/AppData/Local/Temp/~hh4353.htm

05/02/2016

QUERYS

Page 6 of 9

Para ello debemos activar la visualizacin de informacin del sistema, para ello se debe hacer lo siguiente:
Opcin 1
Oprimir las teclas Ctrl + Shft + I, con esta combinacin se activar la visualizacin de informacin del sistema
Opcin 2
Ir a: Visualizar -> Informacin del Sistema:

Una vez activada la informacin del sistema, coloque el puntero de mouse sobre el cuadro de texto; en la parte de inferior de SAP Business One, aparecer la
informacin interna del cuadro de texto, tal y como se muestra en la imagen.

Paso 2
Modificar Archivo
En el archivo XML crear una etiqueta de la siguiente manera:
<Form UID="1000001" String = "QUERY" Caption = ""/>
Dato

Descripcin

UID

Es el cdigo interno del cuadro de texto.

String

Se escribir la consulta que mostrar los datos vlidos a mostrar.

Caption

Valor generalmente vaco para los cuadro de texto..

Ejemplo:

Tenga en cuenta que el primer dato que se seleccione en la consulta debe ser el dato que se requiere en la consulta, en el primer ejemplo se
selecciona el cdigo del artculo porque este es el parmetro que debe ser ingresado.

Paso 3
Revisar cambios

file:///C:/Users/caran_000/AppData/Local/Temp/~hh4353.htm

05/02/2016

QUERYS

Page 7 of 9

Una vez se guarde el archivo en la ruta del AddIn Querys (Ver Funcionalidad), los parmetros de entrada se mostrarn de la siguiente forma:

Created with the Personal Edition of HelpNDoc: Free HTML Help documentation generator
Created with the Personal Edition of HelpNDoc: Write eBooks for the Kindle
Copyright 2015 by OK ONE SAS. All Rights Reserved.

Valores Fijos
QUERYS Funcionalidad

Valores Fijos
QUERYS Funcionalidad

En algunas consultas hay valores nicos que deben ser ingresados, o se desea que sea ingresado el dato de manera correcta sin que el usuario deba digitar el dato
o seleccionar datos que no corresponden a lo que se quiere.

En la imagen anterior se desea adicionar una lista de valores fijos al cuadro de texto "Code", para ello siga los siguientes pasos:
Paso 1

Encontrar el UID del cuadro de texto al que se le adicionar o modificar sus valores fijos.
Para ello debemos activar la visualizacin de informacin del sistema, para esto se debe hacer lo siguiente:
Opcin 1
Oprimir las teclas Ctrl + Shft + I, con esta combinacin se activar la visualizacin de informacin del sistema
Opcin 2
Ir a: Visualizar -> Informacin del Sistema:

Una vez activada la informacin del sistema, coloque el puntero de mouse sobre el cuadro de texto; en la parte de inferior de SAP Business One, aparecer
la informacin interna del cuadro de texto, tal y como se muestra en la imagen.

file:///C:/Users/caran_000/AppData/Local/Temp/~hh4353.htm

05/02/2016

QUERYS

Page 8 of 9

Paso 2
Modificar Archivo
En el archivo XML crear una etiqueta de la siguiente manera:
<Form UID="1000001" String = "" Caption = "">
<Validvalues>
<Validvalue value = "1" description = "Texto"/>
</Validvalues>
<Form>
Dato

Descripcin

UID

Es el cdigo interno del cuadro de texto.

String

Valor generalmente vaco en caso de agregar valores fijos.

Caption

Valor generalmente vaco para los cuadro de texto.

<Validvalues>
value

Es el cdigo a insertar en el cuadro de texto

description

Texto que describa el cdigo a ingresar

Ejemplo:

Tenga en cuenta que el dato que se debe ingresar debe estar dada en el valor "value".

Paso 3
Revisar cambios
Una vez se guarde el archivo en la ruta del AddIn Querys (Ver Funcionalidad), los parmetros de entrada se mostrarn de la siguiente forma:

Created with the Personal Edition of HelpNDoc: Full-featured multi-format Help generator

file:///C:/Users/caran_000/AppData/Local/Temp/~hh4353.htm

05/02/2016

QUERYS

Page 9 of 9

Created with the Personal Edition of HelpNDoc: Produce electronic books easily
Copyright 2015 by OK ONE SAS. All Rights Reserved.

file:///C:/Users/caran_000/AppData/Local/Temp/~hh4353.htm

05/02/2016