introducción abap querys

Manual de Usuario

Documento: LAN01-MUS-AB01 ABAP - Querys

Autor: Marcelo Martínez T. Fecha: 30/11/2004

Manual de ABAP Querys ActualiSap Consultores PÁGINA: 1/28

CCAAPPIITTUULLOO 11

IINNTTRROODDUUCCCCIIOONN AABBAAPP QQUUEERRYY

1.1 Aprendizaje de Aspectos Básicos de ABAP Query En este Capítulo aprenderá sobre ABAP Query, una herramienta que le permite presentar información desde tablas de base de datos, en listas de informes. Antes de saltar a cómo puede usar ABAP Query para crear informes, es importante comprender sus características y organización básica.

1.2 ¿Qué es ABAP Query? ABAP Query es una herramienta para informes fácil de usar que le permite consultar datos de una o mas tablas de base de datos y distribuirlas en una lista. Con esta herramienta, usted puede extraer datos desde virtualmente cualquier módulo o tabla de base de datos en el Sistema R/3. ABAP Query lo faculta para crear listas moviéndose por los menús.

El producto de ABAP Query puede ser:

• Mostrado en pantalla en un formato de tabla • Mostrado en pantalla usando gráficos SAP • Bajado a una planilla Excel • Bajado a un archivo plano • Guardado como un extracto que puede ser visto mas tarde. Tome nota que una consulta

pierde algunas de sus capacidades en un extracto. Por ejemplo, la asignación de informe que se usa para informes de ejercicios no está disponible de un extracto.

1.3 ¿Quien Usa ABAP Query? ABAP Query es usada por dos grupos diferentes de personas. Cada uno de estos grupos trabaja con componentes distintos de ABAP Query .

• Usuarios departamentales: Estos son usuarios finales que crean nuevas consultas y generan listas. Los usuarios no técnicos encuentran a ABAP Query particularmente útil debido a que no necesita ningún conocimiento de programación.

• Administradores de sistemas: Los administradores de sistemas fijan los ambientes

necesarios para los usuarios finales y para transportes de salida.

Una de las fortalezas de ABAP Query es que puede usarse para acceder a casi cualquier información de la base de datos, esta particularidad hace que ABAP Query sea una herramienta muy útil para usuarios en muchas áreas de un negocio. Varias áreas de aplicaciones R/3 proporcionan bases de datos lógicas predefinidas para una recuperación mas fácil de información.

Manual de Usuario




1.4 ¿Cómo está Organizado ABAP Query? ABAP Query tiene los siguientes tres componentes principales:

• Áreas Funcionales (InfoSet) • Consultas, y • Grupos de Usuarios

Ahora se describirán estos tres componentes:

< Áreas Funcionales / Info Sets Necesita áreas funcionales para ofrecer un juego preseleccionado de datos al usuario, dependiendo de la tarea a efectuar. Un área funcional define las tablas - y los campos dentro de esas tablas - que pueden ser consultadas. Las áreas funcionales usan una base de datos lógica, una lectura directa de una tabla o una unión de serie de tablas para determinar las tablas y campos disponibles.

< Grupos de Usuarios Los grupos de usuarios se usan para relacionar los usuarios a las áreas funcionales y a las consultas (Querys). Los grupos de usuarios controlan las áreas funcionales y las consultas a las que puede acceder un usuario. Cada área funcional es asignada a uno o mas grupos de usuarios. Los usuarios que necesitan acceso a ABAP Query deben ser miembros de por lo menos un grupo de usuarios. Todos los miembros de un grupo de usuarios pueden acceder a los mismos datos, así como a los mismos programas (consultas) para crear listas.

< Consultas / Querys Cuando usted crea listas diferentes usando ABAP Query, puede ahorrarse la presentación para cada lista. El elemento así creado se llama una consulta (Query). Una consulta es específica para un grupo de usuarios y un área funcional. Cuando crea una consulta, es posible sólo seleccionar un área funcional. Dentro de una consulta también debe especificar los grupos funcionales en el área funcional seleccionada. Esto significa que el área seleccionada (y los grupos) deben contener todos los campos que usted desea incluir en la consulta.

Las consultas tienen tres tipos diferentes de informes o listas:

< Lista Básica: Un informe de lista básica es una lista de campos seleccionados, ordenados y totalizados según lo especificado por el usuario en la consulta. Este es el tipo de informe mas común.

< Lista Estadística: Un informe estadístico totalizará, calculará promedios y asignará porcentajes basados en los campos de la consulta.

< Lista de Rankings: Una lista por rangos pondrá rangos a los campos basada en campos numéricos, incluyendo moneda o cantidad. Una sola consulta puede tener múltiples listas estadísticas y de rangos pero solamente una lista básica.

Manual de Usuario




1.5 Terminología Relacionada < Base de datos lógica: Una base de datos lógica es una serie de tablas que están ligadas entre si mediante un programa de base de datos lógico.

< Grupos funcionales: Los grupos funcionales son parte de un área funcional o InfoSet. Usted crea grupos funcionales dentro del InfoSet y luego asigna los campos que se requiere consultar a un grupo funcional.

1.6 ¿Cómo Acceder a los Componentes de ABAP Query? Para acceder a los componentes de ABAP Query, use el paso de menú que se muestra en la tabla siguiente:

Componente ABAP Query

Paso de Menú

Mantener Consultas Use uno de los pasos siguientes:

Menú SAP → Herramientas → Workbench ABAP →

Utilidades → Query ABAP → Queries (SQ01)

Mantener Áreas Funcionales / InfoSet Menú SAP → Herramientas → Workbench ABAP →

Utilidades → Query ABAP → Area Funcional (SQ02)

Mantener Grupos de Usuarios Menú SAP → Herramientas → Workbench ABAP →

Utilidades → Query ABAP → Grupos de Usuarios (SQ03)

1.7 ¿Cómo Difiere ABAP Query de Otras Herramientas de Informes? Existen varias diferencias entre ABAP Query y otras herramientas de informes:

• ABAP Query puede acceder a los datos desde cualquier tabla dentro de SAP. La mayoría de otras herramientas de informes (por ejemplo report painter) están limitadas sólo a algunas tablas.

• ABAP Query es ideal para hacer lista de datos desde cualquier aplicación en el sistema. Puede calcular campos adicionales tales como variaciones de precios, promedios, porcentajes, etc. además se puede agregar totales, subtotales y ordenamiento sobre cualquier campo.

• Los informes de ABAP Query son informes típicamente de listados simples y de totales, diferente a una hoja de balances o un estado de ingresos que requieren agrupamientos complejos (por ejemplo, una línea de caja o retornos compuesta de varias cuentas en un estado financiero). Tales agrupamientos complejos necesitarían la consulta para leer tablas una multiplicidad de veces a totales apropiados y para ordenar las cuentas. Otras herramientas (tales como Report Painter o Report Writer que usan juegos para estos agrupamientos) están mejor equipadas para informes con agrupamientos complejos.

Manual de Usuario




1.8 ¿Cuales son los Pre-requisitos? • Una comprensión del diccionario de datos y quizás alguna programación básica: En tanto

que no es crítica una programación del fondo de ABAP para usar la herramienta, es útil el conocimiento del diccionario de datos y alguna programación básica. Si usted no está familiarizado con el diccionario de datos o posee habilidades de programación básica, pudiera querer contratar la ayuda de un experto en bases/herramientas en algún momento. Estas habilidades serán de utilidad cuando el área funcional que está construyendo necesite tablas adicionales, campos adicionales o uniones de tablas.

• Conocer las tablas y campos de base de datos requeridas: Antes de comenzar una consulta,

usted debería conocer las tablas y campos requeridos. Para ejecutar una consulta, deben estar presentes los datos en las tablas a las que está accediendo. Una comprensión general de los campos y de como son almacenados en la base de datos también ayuda. Por ejemplo, la cantidad en dólares colocada en un documento FI es almacenada como un número absoluto. El sistema usa la clave de contabilización para determinar si el valor real es positivo o negativo. Para mostrar la cantidad correcta en su consulta, necesitará crear un campo adicional en el área funcional que verifica la clave de contabilización para determinar la cantidad correcta. La cantidad correcta es entonces almacenada en el campo adicional para sus consultas.

• Ajustes del sistema: Un administrador debe primero efectuar los ajustes requeridos para permitir al usuario trabajar con ABAP Query.

• Autorizaciones: Los usuarios finales, los administradores de sistemas y los traductores deben

todos tener las autorizaciones adecuadas para usar ABAP Query.

Manual de Usuario




CCAAPPIITTUULLOO 22

CCRREEAACCIIÓÓNN DDEE UUNN IINNFFOORRMMEE CCOONN AABBAAPP QQUUEERRYY

En esta sección, usted tendrá un tour con guía sobre cómo crear un informe usando ABAP Query. Este sistema de paso a paso está construido sobre una muestra de informe (ver el gráfico siguiente). Sugerimos que se tome algunos minutos para familiarizarse con el escenario y el informe deseado.

Ejemplo: La Corporación ACME requiere ver el resumen de la información de préstamos cargados en el sistema TR-TM.

Para esta consulta, crearemos un área funcional usando una Lectura Directa sobre la tabla VDBEPP (Datos variables - Posición plan). Esta es una manera fácil y efectiva para comenzar a crear consultas.

Los pasos principales al crear una consulta se muestran en el gráfico a la derecha. Seguiremos estos pasos mientras ilustramos un ejemplo para la creación de un informe según ABAP Query .

1) Crear un InfoSet

2) Agregar campos requeridos a grupos

funcionales

3) Generar el InfoSet (Área Funcional)

5) Asignar los Usuarios y el InfoSet al

Grupo de Usuarios

4) Crear un Grupo de Usuarios

6) Crear la Consulta

Manual de Usuario




TOUR CON GUÍA

Paso 1: Crear un InfoSet (SQ02)

1. En InfoSet Acceso, ingrese un nombre para el InfoSet que quiere crear. En este ejemplo, el área funcional ingresada es ZTM01_VALORES_PTMO.

2. Elija Crear.

1 2

Manual de Usuario




3. En el campo Denominación, ingrese una descripción para el área funcional.

4. Deje seleccionado Cálculo de coma fija para asegurarse que sus lugares decimales estén correctos para los cálculos.

5. Los InfoSet se pueden crear a partir de una unión de tablas (JOIN), una base de datos lógica, una estructura de datos ABAP o la lectura directa sobre una tabla transparente. Para este ejemplo utilizaremos la lectura directa sobre la tabla VDBEPP (Datos de variables de posición de un préstamo).

6. En el caso de elegir una Base de Datos Lógica, se puede desplegar las tablas y campos disponibles en ella haciendo clic en el botón “Visualizar BD Lógica”.

7. En el caso de requerir una unión de tablas se puede especificar en este campo el nombre de la primera tabla de la unión.

8. Elija Aceptar (Enter).

3

4

5 6

7

8

9.- Se recomienda elegir la opción “Crear grupos de campos vacíos” y luego continuar (Enter).

9

Manual de Usuario




10. En la definición del InfoSet se despliegan los campos que pueden ser agreagados a los grupos Funcioales, éstos podrán ser utilizados posteriormente en la definción de las consultas (Querys).

11. Se pueden crear distintos grupos de campos (grupos funcionales) los cuales sirven para organizar los datos que serán reporteados en las consultas. Se requiere al menos un

12. Para crear o eliminar grupos de campos se utilizan los botones de herramienta:

en la pantalla siguiente se visualiza la pantalla para crear grupos de campos.

13. Se puede alternar entre mantenimiento de grupos de campos / o detalles haciendo clic en los botones:

10 11

12

13

Manual de Usuario




154

14

14. Cree los siguientes dos grupos funcionales, 02 y 03 en la ventana Crear Grupos de Campos:

• 01 Datos de Importe

• 02 Datos de Fecha

15. Una vez hechos los cambios haga clic en continuar.

16

17

Manual de Usuario




Paso 2: Asigne Campos Requeridos a Grupos de Campo 16. Seleccione los campos desde “Campos de Datos”, para hacer selección múltiple se debe hacer clic sobre los campos

presionando simúltanemente la tecla CTRL (Control) o SHFT (Shift).

17. Una vez seleccionados los campos requeridos se deben “arrastrar” hasta la parte derecha de la pantalla y soltarlos sobre el grupo de campos requerido.

18. Continúe agregando campos al grupo de campos repitiendo los pasos 1 y 2, para cada tabla que contenga campos necesarios para sus consultas.

Paso 3: Agregue una tabla al infoSet El paso siguiente es agregar una tabla adicional que tenga datos necesarios y pueda ser accedida con los datos de la tabla VDBEPP. En este ejemplo el nombre del interlocutor financiero se encuentra en la tabla BUT000 y puede ser obtenido con el campo RPARTNR de la tabla VDBEPP.

19. Para agregar la tabla a la consulta que será accesada a través de los datos de la tabla principal, primero se debe posicionar

sobre esta última y hacer clic sobre .

20. En la pantalla Actualizar Info Set, haga clic sobre y seleccione la tabla que desea adicionar.

21. El sistema por defecto SELECCIONA los valores de las sentencias para llamar a la tabla que se desea anexar, usted debe completar las entradas que faltan, si las hay.

22. Nótese que se ha agregado la tabla BUT000.

19

Manual de Usuario




22

21

20

Manual de Usuario




23. Asegúrese agregar los campos de la tabla adicional al grupo funcional. Los campos de las tablas adicionales estarán al pié de la lista de campos de la tabla a que se adjuntó. En este caso, adjuntamos la tabla BUT000.

Paso 4: Agregue una campo adicional al InfoSet

Los datos de importe de la tabla VDBEPP se encuentran en valores absolutos, para poder expresarlos con el signo correcto se deberá consultar el valor del campo SSOLHAB (Indicador Debe / Haber). Mediante el siguiente procedimiento agregaremos un campo calculado el cual refleja el signo correcto de la operación.

24. Para agregar el campo de valor, haga clic sobre y luego sobre .

25. En la pantalla que se desplaza marque la opción Campo Adicional y agregue el nombre del campo a agregar.

26. Enter.

27. Complete los texto explicativo con la descripción del campo.

28. En el campo referencia indique el nombre técnico del campo que se está agregando.

29. La secuencia permite llevar un orden lógico de tablas y/p campos que se pueden ir agregando.

30. Una vez agregado el campo adicional, haga clic sobre para ingresar el código ABAP para el campo adicional. En este ejemplo, estamos revisando el indicador débito/crédito (VDBEPP-SSOLHAB). Si encontramos una 'H' para crédito, entonces la cantidad correcta es igual a la cantidad en moneda local (VDBEPP-BNWHR) multiplicada por -1. Si no es un crédito, entonces es un débito y la cantidad correcta es igual a la cantidad en moneda local (VDBEPP-BNWHR).

31. Agregue el campo adicional (Importe nominal c/signo) al grupo de campo para que pueda ser usado en consultas. Expanda la tabla VDBEPP para mostrar todos los campos. Baje a la parte inferior y seleccione el (Importe nominal c/signo).

23

Manual de Usuario




25

27

28

29

Manual de Usuario




30

Manual de Usuario




Paso 5: Generar el Info Set.

32. Haga Click en el ícono para generar el Info Set. Este es el paso final para crear el Info Set.

Pasos 6 y 7: Crear Grupo de Usuarios y Asignar el Info Set al Grupo de Usuarios.

33. El Info Set debe ser asignado a un grupo de usuarios antes que pueda ser usada en una consulta. Para hacer esto, vaya a la pantalla inicial ABAP Query y elija Entorno → Grupos de Usuarios ó acceda a través de la transacción SQ03.

34. En el Grupo de Usuarios, ingrese X1, el nombre del grupo de usuarios. 35. Si éste no existe, haga click en Crear (como verá en este ejemplo). Si va a usarse un grupo de usuarios existente, haga click

Asignar Usuarios y Áreas Funcionales. 36. Asigne una Descripción al Grupo de Usuarios. 37. Elija aceptar (Enter) para grabar el grupo de usuarios. 38. Asignar un usuario al grupo de usuario de manera de permite hacer consulta en la Query haciendo clic en

39. Seleccionar el grupo de usuario al que asocia el usuario y grabar haciendo clic .

40. Para asiganar a varios usuarios a un mismo Query, haga clic sobre y asigne a todos los usuarios asociados que deberían tener acceso a los Info Set y a las consultas de este grupo de usuarios.

41. Para asignar un Info Set al grupo de usuario ir a Pasar a/Asignar Info Set. Seleccione el o los info set que desea asociar al

grupo de usuario.

42. Ahora que el área funcional y grupos de usuarios han sido establecidos, usted está listo para construir la consulta.

Manual de Usuario




36

35

34 35

38

Manual de Usuario




40

39

Manual de Usuario




41

Manual de Usuario




Paso 8: Crear la Consulta / Query

Para crear consultas debe acceder a la transacción SQ01

1. Asegúrese que está trabajando en el grupo de usuarios adecuado

1. 2. Si no lo está, elija el botón de Otro Grupo de Usuarios y cambie al grupo de usuarios correcto.

2. En el campo Query, ingrese un nombre para la nueva consulta. En este ejemplo, ingrese Consulta Test en Query.

3. Haga clic en Crear.

4. Ingrese el título de la consulta y cualquiera nota relevante. Las notas son sólo para referencia y no aparecen en la consulta.

5. Se podrá desplazar haciendo clic sobre . Encontrará un listado con los grupos campo creados, campos asociados y parámetros de selección. Seleccione los que necesita para crear la consulta. Los parámetros de selección corresponden a los parámetros con los cuales puede limitar la consulta.

6. Para comenzar a diseñar el Quero y la estructura como se mostraran los datos de la consulta haga clic sobre

.

7. En la siguiente pantalla puede comenzar a crear la consulta marcando los campos que desea incluir en la consulta. Nótese que el orden de los campos que se visualizará al ejecutar el reporte se va dando a medida que usted va marcando los campos que quiere que aparezcan en él.

8. En la vista formato de salida se puede selecciona la forma en que se desea ver la consulta.

Manual de Usuario




3

4

Manual de Usuario




5

6

Manual de Usuario




7

8

Manual de Usuario




Paso 9: Ejecutando la Consulta

Para ejecutar una consulta, seleccione la transacción SQ01.

1. Seleccione la consulta de la lista. En ejemplo, el grupo de usuarios X1 tiene solamente una consulta Consulta Test.

2. Elija Ejecutar haciendo clic en .

3. Seleccione los parámetros de selección con los cuales desea realizar la consulta. Estos campos fueron seleccionados en el punto nº 5 del paso nº 8.

4. Ejecute la consulta presionando .

5. Entrega información consulta.

2

1

3

Manual de Usuario




5

Manual de Usuario




CCAAPPIITTUULLOO 33

33..11 CCOONNSSEEJJOOSS YY TTRRUUCCOOSS EENN AABBAAPP QQUUEERRYY

3.1.1 Asignación de Informes con Funcionalidad “Llamado de Informes en una Consulta” (Navegabilidad).

Cada consulta tiene funcionalidad para Llamado de Informes para abrir hacia otros informes. Estos informes pueden ser cualquiera de los siguientes:

• Grupos de informes creados en el Report Painter o Report Writer • Informes ejecutables creados en la herramienta de informes PA/EIS • Programas ABAP • Otras ABAP Query • Códigos de transacciones SAP.

A muchos clientes les gusta efectuar una apertura para mostrar códigos de transacción para registros maestros y detallar transacciones desde consultas. Para agregar la funcionalidad Llamado de Informe a una consulta:

1. Debe estar en el modo Crear o Cambiar dentro de la consulta (SQ01).

Manual de Usuario




2. Elija Pasar a → Asignar informe

3. Asigne a la consulta cualquiera de los tipos de informes mencionados anteriormente,

haciendo clic sobre y grabe.

4. Para poder navegar a los informes asignados a su consulta principal (Query), debe acceder haciendo un doble clic sobre cualquier parte de la fila de la información que entrega la query consultada.

Manual de Usuario




3.1.2 Agregar parámetros para delimitar la consulta del Query. Esta funcionalidad permite agregar parámetros para delimitar el Query al momento de realizar la consulta.

1. Acceda a la transacción modificación de Info Set (SQ02), presione .

2. Presione .

Manual de Usuario




3. Complete los campos:

• Significado • Texto selección • For: corresponde a la tabla y nombre de campo a utilizar • Detall: código para hacer obligatorio la utilización del matchcode en el parámetro de filtro en

la consulta. Sino es completado en la consulta solo se verá el campo sin ser obligatorio.

introducción abap querys

Documents

producto de abap query

fortalezas de abap query

ab01 abap

grupos de usuarios

cmo est organizado abap

usuarios finales

usuarios departamentales

tablas de base