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 utilización del AddIn Querys, funcionalidad agregada en el AddOn Best Practices para SAP Business One.

Utilidad del add-on El AddIn Querys permite la modificación de parámetros 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 parámetros 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 Creación o modificación de nuevos parámetros. - 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 Inglés Querys) almacenadas en el Query Manager de SAP Business One tienen parámetros de entrada para que se puedan ejecutar correctamente, en algunos casos la introducción de la información solicitada puede ser suministrada fácilmente, tal es el caso del año de generación del reporte o el nombre del empleado de ventas, pero existen casos en los que la información solicitada no es fácil de obtener, como el código interno de una factura o el código interno de un empleado. El AddIn Querys permite la modificación de los parámetros de la consultas, obteniendo información, de acuerdo a lo requerido por el cliente, por ejemplo se puede buscar por el nombre del empleado y con este introducir el código de este en los parámetros, con esto la información se obtiene de forma fácil y rápida, reduciendo el tiempo de generación de los reportes.

Utilizando el AddIn Querys La modificación de los parámetros de consulta se realiza a través de un archivo XML, este debe llevar el mismo nombre de la consulta a la que quiere modificar los parámetros, ejemplo: Si la consulta se llama “ReporteAnual1”, el archivo debe llamarse de la siguiente forma: “ReporteAnual1.xml” Este archivo (con extensión .xml) debe ser guardado en la siguiente ruta dependiendo de la versión de Windows que posea: Windows 32Bits Inglés C:\Program Files\SAP\SAP Business One\AddOns\OK1\addInQuerys\Resources\Querys Español C:\Archivos de Programa\SAP\SAP Business One\AddOns\OK1\addInQuerys\Resources\Querys

Windows 64Bits Inglés C:\Program Files (x86)\SAP\SAP Business One\AddOns\OK1\BestPractices\addInQuerys\Resources\Querys Español 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

Modificación de parámetros La modificación de los parámetros se realiza a través de un archivo XML, este debe ser creado siguiendo la estructura y/o sintaxis del estándar XML, aunque no se necesita poseer conocimientos avanzados, sólo debe seguir los siguientes pasos: NOTA1: Debe recordar que cada deber ser debidamente cerrada con o abierta y cerrada en la misma línea: NOTA2: La edición del archivo la puede realizar a través 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 programación como Microsoft VisualStudio o notepad++, este último es gratuito y muy liviano.

Encabezado del archivo //Indica que el archivo es un Archivo XML y va a contener la codificación de caracteres estándar UTF-8 Contenido del Archivo //Etiqueta que indica bloque de varias consultas. //Etiqueta que indica contenido en una consulta específica. //Etiqueta que indica el contenido de los objetos que están contenidos dentro del formulario de parámetros, esta es el área que se modificará. //Dentro de la etiqueta Form se incluirá cada número de Item que se desee modificar y su contenido. //Indica el cierre de la etiqueta “Items”. //Indica el cierre de la etiqueta “Query”. //Indica el cierre de la etiqueta ”Queries”. Como se ha dicho en anteriormente dentro de la etiqueta “Items” se modificarán los parámetros de consulta, estas modificaciones se podrán hacer de tres formas: 1. Cambiando el texto del parámetro de entrada con el propósito de hacer entendible al usuario cual es el parámetro que se solicita: Textos o Labels 2. Adicionando o modificando la consulta del campo donde se introduce el parámetro con el objetivo de filtrar la información a introducir o mostrar valores

que son válidos para el reporte: Consultas 3. Adicionando o modificando valores fijos con el ánimo de mostrar valores válidos a introducir evitando que el usuario digite valores erróneos: Valores Fijos

La siguiente imagen presenta un ejemplo de cómo deber ser el diseño del XML con los 3 ejemplos para la modificar parámetros los cuales serán 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 parámetros de consulta, siga los siguentes pasos: Paso 1 Encontrar el UID del label que se modificará Para ello debemos activar la visualización de información del sistema, para ello se debe hacer lo siguiente: Opción 1                Oprimir las teclas Ctrl + Shft + I, con esta combinación se activará la visualización de información del sistema Opición 2                Ir a: Visualizar -> Información del Sistema:

Una vez activada la información del sistema, coloque el puntero de mouse sobre el label; en la parte de inferior de SAP Business One, aparecerá la información interna del Label, tal y como se muestra en la imágen.

Paso 2 Modificar Archivo En el archivo XML crear una etiqueta de la siguiente manera: Dato

Descripción

UID

Es el código interno del label.

String

Valor generalmente vacío 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 parámetros.

Ejemplo:

Paso 3 Revisar cambios Una vez se guarde el archivo en la ruta del AddIn Querys (Ver Funcionalidad), los parámetros de entrada se mostrarán de la siguiente forma:

Repita el mismo proceso para los demás 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 podrán filtrar datos y mostrarlos como datos válidos de entrada, al igual que podrá buscar más fácilmente los datos requeridos, generalmente las consultas alojadas en el Query Manager tienen algún filtro cuando se necesitan datos específicos pero estos no son útiles o presentan un gran cantidad de información que hace difícil la tarea de encontrar el dato deseado.

En la imagen anterior se muestra un lista de selección para artículos el cual muestra sólo el número de artículo y el número de registros en que aparece, esto aparte de no ser muy coherente es muy difícil buscar en listas como esta. Para adicionar una consulta al parámetro 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 visualización de información del sistema, para ello se debe hacer lo siguiente: Opción 1                Oprimir las teclas Ctrl + Shft + I, con esta combinación se activará la visualización de información del sistema Opción 2                Ir a: Visualizar -> Información del Sistema:

Una vez activada la información del sistema, coloque el puntero de mouse sobre el cuadro de texto; en la parte de inferior de SAP Business One, aparecerá la información 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:         Dato

Descripción

UID

Es el código interno del cuadro de texto.

String

Se escribirá la consulta que mostrará los datos válidos a mostrar.

Caption

Valor generalmente vacío 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 código del artículo porque este es el parámetro 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 parámetros de entrada se mostrarán 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 visualización de información del sistema, para esto se debe hacer lo siguiente: Opción 1                Oprimir las teclas Ctrl + Shft + I, con esta combinación se activará la visualización de información del sistema Opción 2                Ir a: Visualizar -> Información del Sistema:

Una vez activada la información del sistema, coloque el puntero de mouse sobre el cuadro de texto; en la parte de inferior de SAP Business One, aparecerá la información 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:                                                         Dato

Descripción

UID

Es el código interno del cuadro de texto.

String

Valor generalmente vacío en caso de agregar valores fijos.

Caption

Valor generalmente vacío para los cuadro de texto.

value

Es el código a insertar en el cuadro de texto

description

Texto que describa el código 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 parámetros de entrada se mostrarán 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