SAP Netweaver / ABAP                  Notas técnicas / Tips / Tutorials

Cómo usar el Nuevo editor y debugger ABAP

Aprenda las características fundamentales del nuevo editor y debugger ABAP en SAP Netweaver 7.0

Inspeccionar el código fuente es probablemente una de las tareas más delicadas en el desarrollo de una aplicación. Las herramientas con las que contamos para llevarla a cabo cumplen un rol fundamental y si están bien diseñadas seguramente se verá reflejado en una mejora de nuestra productividad.

 

El nuevo editor y debugger ABAP, con sus numerosas funciones de formateo de código, junto con otras destacadas características, se presentan como un instrumento potente con una interfaz amigable para el programador.

Esta nueva funcionalidad e interfaz está disponible en la versión de SAP Netweaver 2004s (SAP Netweaver 7.0), y es accesible desde SAPGUI 6.20 con patch level 10.

En el presente tip describiremos algunas características fundamentales a tener en cuenta en el uso de esta herramienta.

Cómo activar el editor

Antes de comenzar a trabajar con el nuevo editor, será necesaria su activación.

Desde la transacción SE80, ir a Utilities → Settings. La ventana que se despliega, debe quedar seteada de la siguiente manera:

ABAP-editor

Notar en la imagen anterior que se está indicando que se va a utilizar en nuevo front end editor. Una vez establecida esta especificación, cada vez que se utilice el editor se presentará la nueva interfaz y se explotarán las características asociadas con el nuevo editor.

 

Características del nuevo editor

  • Lo que se detalla a continuación son las nuevas particularidades del editor ABAP:
  • Coloración de la sintaxis automática y configurable.
  • Predicción de palabras claves del lenguaje (Select, Stop, etc.) en tiempo real.
  • Señaladores de código (marcadores).
  • Posibilidad de contraer y expandir bloques lógicos de código.
  • Codigos prediseñados (Templates) configurables para estructuras de código, con la posibilidad de utilizar campos dinámicos.
  • Auto-corrección del código a través de diccionario de errores conocidos totalmente configurable.
  • Separación del editor en dos ventanas en la misma pantalla, permitiendo la comparación de sectores de código sin necesidad de abrir otra sesión.
  • Seteo de breakpoints al margen del código, similar a la vista tradicional del debugger.
  • Enumeración de líneas de código.
  • Indicador de nuevas líneas y líneas modificadas.
  • Exportación de trozos de código o programas completos con múltiples formatos (HTML, PDF, etc.).

Una vista simplificada de la interfaz del editor

La siguiente imagen corresponde al nuevo editor ABAP. Como puede observarse existen notables diferencias con las versiones anteriores, de las cuales se destacan las siguientes:

ABAP-nuevo-editor

La ventana correspondiente al menú de opciones, posibilita la configuración de numerosas características del editor, incluyendo la creación de patrones de bloques de código:

ABAP-nuevo-editor-menu-opciones

En la subventana donde figura el código, el texto encerrado entre signos de porcentaje (%) corresponde a variables dinámicas que tomarán su valor según la necesidad del programador al momento de utilizar el template.

Para utilizarlo a la hora de programar: Al escribir la palabra “select” se activará el símbolo que figura en la descripción (§), y presionando CTRL+ ENTER aparecerá automáticamente el bloque de código correspondiente.

Las funciones agregadas resultan ser de gran utilidad y la posibilidad de que gran parte de ellas puedan ser configuradas por el usuario no es un dato menor. Esto, sumado a las características ya conocidas del tradicional editor (búsqueda global, navegación hacia otras herramientas, activación, etc.), convierte al nuevo editor Abap en un producto amigable, potente y fundamental para el desarrollo de aplicaciones.

Cómo activar el debugger

Antes de comenzar a trabajar con el nuevo debugger, será necesaria su activación. Desde la transacción SE80, ir a Utilities → Settings. La ventana que se despliega debe quedar seteada de la siguiente manera:

ABAP-nuevo-editor-seteos-usuario

 

Características del nuevo debugger

A partir de la versión del SAP Netweaver Application Server 6.40 para Netweaver 2004 (sin necesidad de estar en SAP Netweaver 2004s - SAP Netweaver 7.0), ya existe una versión del debugger con funciones extra comparándolo con el debugger clásico.

Sin embargo, la versión nueva del debugger para Netweaver 2004s (SAP Netweaver 7.0) mantiene esas características distintivas y agrega otras tantas que aumentan la potencialidad del producto, a saber:

  • Mismas características que el editor a la hora de visualizar el código, con los distintos formatos presentes y una interfaz similar en este sentido
  • Comparación exhaustiva entre variables
  • Análisis de la memoria
  • Análisis de las pantallas (screens)
  • Información sobre programas cargados
  • Información sobre áreas del sistema

VII. Una vista simplificada de la interfaz del debugger

ABAP-nuevo-editor-control-sesion

  • La posibilidad de configurar 3 escritorios de prueba (Desktop 1, 2 y 3), permite crear diferentes entornos para realizar depuraciones específicas. Las herramientas que se permiten incluir en cada escritorio figuran listadas a continuación:

ABAP-nuevo-editor-new-tool

Una vez que se obtiene el entorno de prueba deseado, se puede guardar para ser utilizado en futuras sesiones de debugging. Para ello “salvar el layout”, desde el menú Debugger Debugger Session → Save Layout. De esta forma, la próxima vez que se ingrese al debugger, figurarán en el escritorio, las herramientas anteriormente elegidas.

  • La visualización de estructuras y tablas es un agregado importante, ya que permite observar en una misma ventana el contenido de 2 estructuras de datos, facilitando notablemente el trabajo de comparación.
  • De la misma manera, la comparación entre variables viene integrada en una solapa estándar (Diff) que permite seleccionar dos variables sin restricción e ir comparando su contenido paso a paso en la ejecución del programa, permitiendo la modificación de su valor.

Ambas herramientas tienen un log histórico de los objetos seleccionados, de manera que si se quiere volver a enfrentar dos variables o estructuras, simplemente deben elegirse desde dicho log.

La nueva versión del debugger presenta una serie de características que facilita notablemente el trabajo del programador, presentando a su vez una interfaz amigable similar a la del nuevo editor, lo cual impacta en el usuario dando una idea de herramientas que trabajan en conjunto.


Copyright 2007 Teknoda S.A.

IMPORTANTE:
“Notas técnicas de SAP ABAP" se envía con frecuencia variable y sin cargo como servicio a nuestros clientes SAP. Contiene notas/tutoriales/artículos técnicos desarrollados en forma totalmente objetiva e independiente. Teknoda es una organización de servicios de tecnología informática y NO comercializa hardware, software ni otros productos.
Si desea suscribir otra dirección de e-mail para que comience a recibir las Notas Técnicas SAP, envíe un mensaje desde esa direcciónsapping@teknoda.com, aclarando nombre, empresa, cargo y país del suscriptor.

SAP, Netweaver, R/3, Fiori,S4/HANA y ABAP son marcas registradas de SAP AG. SAP no es el editor de esta publicación y no es responsable de la misma en ningún aspecto. La información contenida en esta publicación ha sido generada por nuestros especialistas a partir de fuentes consideradas confiables y del ejercicio profesional cotidiano. No obstante, por la posibilidad de error humano, mecánico, cambio de versión u otro, Teknoda no garantiza la exactitud o completud de la misma.
COPYRIGHT TEKNODA S.A. PROHIBIDA SU REPRODUCCION TOTAL O PARCIAL SIN CONSENTIMIENTO DE TEKNODA

 


FICHA TECNICA: Notas técnicas – Tips de SAP Netweaver ABAP ”Cómo usar el Nuevo editor y debugger ABAP"

Tema: Programación ABAP  Descripción: Aprenda las características fundamentales del nuevo editor y debugger ABAP en SAP Netweaver 7.0

 

Generación de un archivo Excel con varias hojas

Aprenda a generar un archivo Excel con varias hojas, desde un programa ABAP.

Mediante la implementación del método GUI_DOWNLOAD de la clase CL_GUI_FRONTEND_SERVICES (Ver Tip  -  Nueva técnica para el manejo de archivos en el Presentation Server” ) es posible generar, entre otros, un archivo en formato Excel. En ese caso, se utiliza  una única tabla interna con los datos a mostrar  en una única hoja del libro Excel.


El presente tip  describe cómo generar un archivo Excel  con varias hojas, desde un programa ABAP, mediante la tecnología OLE2.

Desde la programación  ABAP, se puede utilizar  la funcionalidad provista por Microsoft Excel para crear filas,  libros, hojas, rangos de celdas, gráficos, etc., y poder modificar sus propiedades llamando a sus métodos: insertar, copiar, dar formato a las celdas, etc.

Consideraciones técnicas

El lenguaje ABAP, así como otros softwares de aplicación, soportan la técnica de automatización de objetos OLE2. Cuando se llama a un programa ABAP, el SAPGUI actúa como cliente OLE y, en este caso, el programa Excel como servidor OLE.

Típicamente las aplicaciones que ofrecen automatización de objetos son productos Microsoft Office tal como  Excel y Word,  y cuentan con clases públicas y métodos que pueden verse desde el menú:

Tools → Macro → Visual Basic Editor → Object Browser.

Las aplicaciones controladas por ABAP deben estar contenidas en la tabla transparente TOLE, la cual es mantenida desde la transacción SOLE. Esta tabla contiene el nombre de las clases y componentes soportados  por el ambiente de ejecución ABAP .

Las sentencias ABAP  de automatización son:

  • CREATE OBJECT
  • SET PROPERTY
  • GET PROPERTY
  • CALL METHOD
  • FREE OBJECT

Importante:

NO confundir  CREATE OBJECT y  CALL METHOD  con sentencias de ABAP  Object.

Todos los programas que utilicen tecnología OLE2 deberán hacer referencia al include OLE2INCL

 

Ejemplo práctico

En el siguiente ejemplo, se genera un archivo en formato Excel con tres hojas. Se cargan tres tablas internas, una para cada hoja y se crean los objetos necesarios con las llamadas a sus métodos.

************************************************************************

* START-OF-SELECTION

************************************************************************

START-OF-SELECTION.

************************************************************************

* Recolección de datos en tres tablas internas *

************************************************************************

PERFORM f_querys USING p_conn

CHANGING it_sflig

it_spfli

it_sbook.

************************************************************************

* END-OF-SELECTION

************************************************************************

END-OF-SELECTION.

************************************************************************

* Generación del Libro Excel con tres hojas *

************************************************************************

PERFORM f_hojas_excel USING p_file

it_sflig

it_spfli

it_sbook.

*&---------------------------------------------------------------------*

*& Include Z_EXCEL_TOP                         Report Z_EXCEL

*&

*&---------------------------------------------------------------------*

REPORT Z_EXCEL LINE-SIZE 150.

************************************************************************

* TYPE-POOLS

************************************************************************

* INCLUDE NECESARIO

INCLUDE ole2incl.

************************************************************************

* TYPES

************************************************************************

TYPES: ty_sflig TYPE sflight,

ty_spfli TYPE spfli,

ty_sbook TYPE sbook,

ty_t_sflig TYPE STANDARD TABLE OF ty_sflig,

ty_t_spfli TYPE STANDARD TABLE OF ty_spfli,

ty_t_sbook TYPE STANDARD TABLE OF ty_sbook.

 

************************************************************************
* DATA
************************************************************************

* TABLAS INTERNAS PARA CADA HOJA

DATA: it_sflig TYPE ty_t_sflig,

it_spfli TYPE ty_t_spfli,

it_sbook TYPE ty_t_sbook.

 

* VARIABLES PARA CREAR EL ARCHIVO EXCEL

DATA: application TYPE ole2_object,

workbook TYPE ole2_object,

sheet          TYPE ole2_object,

cells             TYPE ole2_object,

int                 TYPE ole2_object,

font               TYPE ole2_object,

we               TYPE ole2_object,

borders       TYPE ole2_object.

 

DATA: index TYPE i,

lineas TYPE i.

 

* CONSTANTS

CONSTANTS: row_max TYPE i VALUE 256.

 

************************************************************************

* SELECTION-SCREEN

************************************************************************

PARAMETERS: p_conn TYPE s_conn_id DEFAULT '0017' OBLIGATORY,

p_file     TYPE rlgrap-filename

DEFAULT 'C: /TABLAS.XLS' OBLIGATORY.

 

*&---------------------------------------------------------------------*

*& Include                           Z_EXCEL_F01

*&---------------------------------------------------------------------*

*&---------------------------------------------------------------------*

*& Form f_querys

*&---------------------------------------------------------------------*

FORM f_querys USING p_conn TYPE s_conn_id

CHANGING pt_sflig TYPE ty_t_sflig

pt_spfli TYPE ty_t_spfli

pt_sbook TYPE ty_t_sbook.

SELECT *

INTO TABLE pt_sflig

FROM sflight

WHERE connid EQ p_conn

.

IF sy-subrc <> 0.

MESSAGE e888(sabapdocu) WITH 'error 1'.

ENDIF.

 

SELECT *

INTO TABLE pt_spfli

FROM spfli

WHERE connid EQ p_conn

.

IF sy-subrc <> 0.

MESSAGE e888(sabapdocu) WITH 'error 2'.

ENDIF.

 

SELECT *

INTO TABLE pt_sbook

FROM sbook UP TO 50 ROWS

WHERE connid EQ p_conn

.

IF sy-subrc <> 0.

MESSAGE e888(sabapdocu) WITH 'error 3'.

ENDIF.

 

ENDFORM. " f_querys

*&---------------------------------------------------------------------*

*&             Form f_hojas_excel

*&---------------------------------------------------------------------*

FORM f_hojas_excel USING pv_file TYPE rlgrap-filename

pt_sflig TYPE ty_t_sflig

pt_spfli TYPE ty_t_spfli

pt_sbook TYPE ty_t_sbook.

 

DATA: pw_sflig TYPE ty_sflig,

pw_spfli TYPE ty_spfli,

pw_sbook TYPE ty_sbook.

 

* CREA EL OBJETO EXCEL

CREATE OBJECT application 'excel.application'.

 

* HACE VISIBLE LA APLICACION

SET PROPERTY OF application 'visible' = 1.

 

* LLAMA AL METODO WORKSBOOKS PARA CREAR EL LIBRO

CALL METHOD OF application 'Workbooks' = workbook.

CALL METHOD OF workbook 'Add'.

 

* AGREGA UNA HOJA

CALL METHOD OF application 'Worksheets' = sheet.

CALL METHOD OF sheet 'Add'.

CLEAR lineas.

DESCRIBE TABLE pt_sflig LINES lineas.

 

IF lineas <> 0.

* CREA LA PRIMER HOJA

CALL METHOD OF application 'Worksheets' = sheet

EXPORTING

#1 = 1.

 

* SETEA NOMBRE DE LA HOJA

SET PROPERTY OF sheet 'Name' = 'Sflight'.

CALL METHOD OF sheet 'Activate'.

 

* RECORRE LA TABLA INTERNA

LOOP AT pt_sflig INTO pw_sflig.

 

* POR CADA CAMPO DE LA TABLA INTERNA MUESTRA 4

index = row_max * ( sy-tabix - 1 ) + 1.

CALL METHOD OF sheet 'Cells' = cells

EXPORTING

#1 = index.

SET PROPERTY OF cells 'Value' = pw_sflig-connid.

***** FORMATO DE CELDA

CALL METHOD OF cells 'FONT' = font.

SET PROPERTY OF font 'BOLD' = 2.

SET PROPERTY OF font 'SIZE' = '12'.

FREE OBJECT font.

***** COLOR DE FONDO

CALL METHOD OF cells 'INTERIOR' = int.

SET PROPERTY OF int 'ColorIndex' = '34'.

SET PROPERTY OF int 'Pattern' = 1.

FREE OBJECT int.

***** BORDES

* izquierdo

CALL METHOD OF cellS 'BORDERS' = borders

EXPORTING

#1 = '1'.

SET PROPERTY OF borders 'LineStyle' = '1'.

SET PROPERTY OF borders 'WEIGHT' = we.

FREE OBJECT borders.

* derecho

CALL METHOD OF cellS 'BORDERS' = borders

EXPORTING

#1 = '2'.

SET PROPERTY OF borders 'LineStyle' = '2'.

SET PROPERTY OF borders 'WEIGHT' = we.

FREE OBJECT borders.

* arriba

CALL METHOD OF cellS 'BORDERS' = borders

EXPORTING

#1 = '3'.

SET PROPERTY OF borders 'LineStyle' = '3'.

SET PROPERTY OF borders 'WEIGHT' = we.

FREE OBJECT borders.

* abajo

CALL METHOD OF cellS 'BORDERS' = borders

EXPORTING

#1 = '4'.

SET PROPERTY OF borders 'LineStyle' = '4'.

SET PROPERTY OF borders 'WEIGHT' = we.

FREE OBJECT borders.

 

****************************************************************

ADD 1 TO index.

CALL METHOD OF sheet 'Cells' = cells

EXPORTING

#1 = index.

SET PROPERTY OF cells 'Value' = pw_sflig-fldate.

***** FORMATO DE CELDA

CALL METHOD OF cells 'FONT' = font.

SET PROPERTY OF font 'BOLD' = 1.

SET PROPERTY OF font 'SIZE' = '10'.

FREE OBJECT font.

***** COLOR DE FONDO

CALL METHOD OF cells 'INTERIOR' = int.

SET PROPERTY OF int 'ColorIndex' = '35'.

SET PROPERTY OF int 'Pattern' = 1.

FREE OBJECT int.

 

ADD 1 TO index.

CALL METHOD OF sheet 'Cells' = cells

EXPORTING

#1 = index.

SET PROPERTY OF cells 'Value' = pw_sflig-price.

***** FORMATO DE CELDA

CALL METHOD OF cells 'FONT' = font.

SET PROPERTY OF font 'BOLD' = 1.

SET PROPERTY OF font 'SIZE' = '8'.

FREE OBJECT font.

***** COLOR DE FONDO

CALL METHOD OF cells 'INTERIOR' = int.

SET PROPERTY OF int 'ColorIndex' = '36'.

SET PROPERTY OF int 'Pattern' = 1.

FREE OBJECT int.

 

ADD 1 TO index.

CALL METHOD OF sheet 'Cells' = cells

EXPORTING

#1 = index.

SET PROPERTY OF cells 'Value' = pw_sflig-currency.

***** FORMATO DE CELDA

CALL METHOD OF cells 'FONT' = font.

SET PROPERTY OF font 'BOLD' = 2.

SET PROPERTY OF font 'SIZE' = '10'.

FREE OBJECT font.

***** COLOR DE FONDO

CALL METHOD OF cells 'INTERIOR' = int.

SET PROPERTY OF int 'ColorIndex' = '37'.

SET PROPERTY OF int 'Pattern' = 1.

FREE OBJECT int.

 

ENDLOOP.

ENDIF.

CLEAR lineas.

DESCRIBE TABLE pt_spfli LINES lineas.

IF lineas <> 0.

* CREA LA SEGUNDA HOJA, SPFLI

CALL METHOD OF application 'Worksheets' = sheet

EXPORTING

#1 = 2.

SET PROPERTY OF sheet 'Name' = 'Spfli'.

CALL METHOD OF sheet 'Activate'.

LOOP AT pt_spfli INTO pw_spfli.

index = row_max * ( sy-tabix - 1 ) + 1.

CALL METHOD OF sheet 'Cells' = cells

EXPORTING

#1 = index.

SET PROPERTY OF cells 'Value' = pw_spfli-connid.

ADD 1 TO index.

CALL METHOD OF sheet 'Cells' = cells

EXPORTING

#1 = index.

SET PROPERTY OF cells 'Value' = pw_spfli-countryfr.

ADD 1 TO index.

CALL METHOD OF sheet 'Cells' = cells

EXPORTING

#1 = index.

SET PROPERTY OF cells 'Value' = pw_spfli-cityfrom.

ADD 1 TO index.

CALL METHOD OF sheet 'Cells' = cells

EXPORTING

#1 = index.

SET PROPERTY OF cells 'Value' = pw_spfli-airpfrom.

 

ENDLOOP.

ENDIF.

 

* CREA LA TERCER HOJA, SBOOK

CLEAR lineas.

DESCRIBE TABLE pt_sbook LINES lineas.

IF lineas <> 0.

CALL METHOD OF application 'Worksheets' = sheet

EXPORTING

#1 = 3.

SET PROPERTY OF sheet 'Name' = 'Sbook'.

CALL METHOD OF sheet 'Activate'.

 

LOOP AT pt_sbook INTO pw_sbook.

 

index = row_max * ( sy-tabix - 1 ) + 1.

CALL METHOD OF sheet 'Cells' = cells

EXPORTING

#1 = index.

SET PROPERTY OF cells 'Value' = pw_sbook-connid.

ADD 1 TO index.

CALL METHOD OF sheet 'Cells' = cells

EXPORTING

#1 = index.

SET PROPERTY OF cells 'Value' = pw_sbook-fldate.

ADD 1 TO index.

CALL METHOD OF sheet 'Cells' = cells

EXPORTING

#1 = index.

SET PROPERTY OF cells 'Value' = pw_sbook-bookid.

ADD 1 TO index.

CALL METHOD OF sheet 'Cells' = cells

EXPORTING

#1 = index.

SET PROPERTY OF cells 'Value' = pw_sbook-customid.

 

ENDLOOP.

 

ENDIF.

 

* GUARDA EN EL EXCEL

CALL METHOD OF sheet 'SaveAs'

EXPORTING

#1 = pv_file "PATH A DONDE VA A SER GUARDADO

#2 = 1.

 

* CIERRA LA VENTANA

SET PROPERTY OF application 'visible' = 0.

 

* LIBERA EL OBJETO

FREE OBJECT application.

 

ENDFORM. " f_hojas_excel

* FIN


Para tener en cuenta…

 

  • Tablas relacionadas

TOLE                      Aplicaciones OLE disponibles

OLELOAD               Carga de información de tipo OLE

SWOTOLE              Tipos objeto workflow: Aplicaciones OLE

TOLET                     Tipos objeto Workflow: Textos aplic. OLE

 

  • Transacciones

OLE                        Ejemplos

SOLE                     Mantenimiento de las aplicaciones

 

En la transacción SOLE se muestran las aplicaciones que soportan comunicación OLE2 con sus infotipos. Los infotipos guardan la relación de propiedades y métodos en una aplicación. Todos los infotipos soportados se pueden ver en la tabla OLELOAD.

 

  • Con el objeto de conocer la sintaxis exacta, los atributos y métodos a utilizar, la mejor solución es grabar todas las acciones en una macro de Excel, donde se podrá consultar la sintaxis de las diferentes instrucciones que se han ejecutado y luego, trasladar esas acciones al código ABAP.

Otra opción es, desde el Excel acceder a Microsoft Visual Basic, a través de la ayuda con Alt + F11. En la ventana de la derecha Members of ‘Application’, se verán los métodos de la clase Excel.application.

 

ABAP-generacion-Excel

 


Copyright Teknoda S.A.

IMPORTANTE:
“Notas técnicas de SAP ABAP" se envía con frecuencia variable y sin cargo como servicio a nuestros clientes SAP. Contiene notas/tutoriales/artículos técnicos desarrollados en forma totalmente objetiva e independiente. Teknoda es una organización de servicios de tecnología informática y NO comercializa hardware, software ni otros productos.
Si desea suscribir otra dirección de e-mail para que comience a recibir las Notas Técnicas SAP, envíe un mensaje desde esa direcciónsapping@teknoda.com, aclarando nombre, empresa, cargo y país del suscriptor.

SAP, Netweaver, R/3, Fiori,S4/HANA y ABAP son marcas registradas de SAP AG. SAP no es el editor de esta publicación y no es responsable de la misma en ningún aspecto. La información contenida en esta publicación ha sido generada por nuestros especialistas a partir de fuentes consideradas confiables y del ejercicio profesional cotidiano. No obstante, por la posibilidad de error humano, mecánico, cambio de versión u otro, Teknoda no garantiza la exactitud o completud de la misma.
COPYRIGHT TEKNODA S.A. PROHIBIDA SU REPRODUCCION TOTAL O PARCIAL SIN CONSENTIMIENTO DE TEKNODA

 

 


Ficha técnica: Tema: Programación ABAP, archivos

Descripción: Aprenda a generar un archivo Excel con varias hojas, desde un programa ABAP.

Cómo crear formularios de impresión basados en PDF e imprimirlos desde un programa ABAP

PDF (Portable Document Format) es un estándar sólido y universalmente aceptado para visualización e intercambio de información multiformato.

¿Qué posibilidades ofrece SAP para generar archivos en formato PDF? Existen varias opciones, sobre todo en las versiones más nuevas, para producir salida en formato PDF desde un sistema SAP. 

Es interesante conocerlas dado que difieren en su ámbito de aplicación y limitaciones.


El  tip Generación de archivos PDF desde SPOOL en SAP, le mostrará las diferentes opciones de generación de PDFs y un ejemplo con el uso de una de las alternativas.

La tecnología más reciente para la creación de formularios en SAP, es la solución SAP Interactive Forms by Adobe. Esto permite crear formularios interactivos y formularios de impresión basados en Adobe PDF para optimizar los procesos de impresión de las aplicaciones.

El punto interesante en el uso de esta tecnología es su compatibilidad con las personalidades ABAP y JAVA del SAP Netweaver Application Server. Actualmente, el uso de los formularios de impresión basados en PDF, puede reemplazar a los SmartForms, del lado ABAP, y además, potenciar a las Web Dynpro, del lado de Java, así como a las Web Dynpro for ABAP en la personalidad ABAP, usando formularios interactivos.

Para tal efecto esta nueva solución SAP Interactive Forms by Adobe (disponible a partir de SAP Netweaver 04) utiliza el Adobe LiveCycle Designer, que es una herramienta de diseño que permite la creación de formularios utilizando UI Elements, de manera muy intuitiva y fácil de utilizar, y está totalmente integrado en el ABAP Workbench y en el Netweaver Developer Studio.

En este tip veremos la alternativa de la creación de un formulario basado en PDF y cómo usarlo desde un programa impresor ABAP. Desarrollaremos el ejemplo desde el ABAP Workbench.

Como se menciona en párrafos anteriores, tener en cuenta que también podrían generarse formularios interactivos utilizando SAP Interactive Forms by Adobe, o también conocido como Adobe Forms, desde el cliente Netweaver Developer Studio, como herramienta de desarrollo del “lado de JAVA”. Esta alternativa no será desarrollada en el presente tip.

Cómo crear el formulario Adobe

Los formularios de impresión basados en Adobe son parte de SAP Interactive Forms by Adobe y son usados para imprimir en los sistemas SAP.

Un formulario Adobe PDF consta de tres partes, que son todas necesarias para la creación del mismo:

  • Interfase: Contiene los parámetros (tablas, estructuras, etc) que un formulario podrá utilizar. Es independiente del formulario.
  • Contexto: Contiene únicamente los parámetros de la interfase que son requeridos en un determinado formulario.
  • Layout: Es el diseño del formulario.

SAP-adobeforms-1

Pasos a seguir para la creación del formulario PDF Adobe

1. Acceder a la transacción SFP – Form Builder.

2. Crear la interfase que utilizará el formulario de la siguiente manera: indicar un nombre y presionar>Create, como se indica a continuación:

SAP-adobeform-2

3. Completar la siguiente pantalla con la descripción de la interfase. Luego, grabar seleccionando Save:

SAP-adobeforms-3

Una vez creada la interfase, se debe indicar cuales serán los parámetros de entrada y salida que manejará la misma. Esta etapa es similar al manejo de parámetros de una función. A continuación se muestra la interfase creada anteriormente, con tres parámetros de entrada:

SAP-adobeforms-4

 

Si se desea modificar la interfase en esta etapa, los pasos son los siguientes según corresponda:

 

- Hacer doble click sobre Import y agregar en la parte derecha de la pantalla todos los parámetros de entrada que tendrá la interfase.

- Repetir dicha operación para los parámetros de export , las excepciones, datos globales, etc.

- En Initialization, agregar código ABAP de ser necesario (por ejemplo para buscar datos de customizing necesarios en el formulario).

Una vez realizadas las modificaciones se debe grabar y activar.

5. Una vez generada la interfase, acceder nuevamente a la transacción SFP, para crear el formulario. Elegir un nombre para el formulario y presionar Create:

 

SAP-adobeform-5

6. Completar la descripción del formulario y asociarlo con una interfase. Luego seleccionar Save:

SAP-adobeforms-6

7. Una vez creado el formulario, se debe asociar un contexto para el mismo. En la solapa Context aparecerán sobre la izquierda todos los parámetros que se declararon en la interfase. De dicha interfase se deberán seleccionar sólo los parámetros que se utilizarán en el formulario. Para ello, arrastrar hacia el contexto (parte derecha de la pantalla) los parámetros que se deseen, tal como lo muestra la figura siguiente:

SAP-adobeform-7

8. Una vez diseñado el contexto del formulario, Grabar y activar.

9. Luego, diseñar la imagen de salida que tendrá el formulario, a través de la solapa Layout:

SAP-adobeforms_8

En la solapa Páginas de Trabajo (o Body Pages) se diseñará el formulario. Las principales herramientas para ello son las “Paletas”, que se pueden ubicar libremente en la pantalla. De no estar visibles, se las puede agregar desde el menú, yendo a Paletas y seleccionando la paleta deseada:

  • Paleta Jerarquía / Vista de Datos: En la vista de datos aparecerán todos los parámetros definidos en el contexto y simplemente habrá que arrastrarlos hacia la página de trabajo tal como muestra la figura anterior.
  • Paleta Objeto: Se definen algunos atributos del objeto tales cómo bordes, presentación, si es de sólo lectura, obligatorio, etc. Además en dicha paleta se encuentra el enlace del campo al parámetro del contexto, es decir qué parámetro del contexto está asociado a cada campo del formulario.
  • Paleta Fuente / Párrafo: Permite definir la fuente (tipo, color) y el estilo de párrafo (centrado, alineado, etc.) para cada objeto del formulario.
  • Paleta Biblioteca: Contiene todos los elementos que se pueden arrastrar al formulario tales cómo radiobuttons, campos de texto, botones, líneas, códigos de barra, etc.

 

En el caso de querer mostrar una tabla en el formulario, desde la paleta “Vista de Datos” se debe arrastrar la tabla a la página de trabajo como cualquier otro componente:

 

 

SAP-adobeforms_9

En la página de trabajo seleccionar la tabla e ir a la paleta Objeto completando con los siguientes datos:

 

SAP-adobeforms_10

 

Por último seleccionar en la página de trabajo el tipo tabla dentro de la tabla (tener cuidado que la tabla y el tipo tabla están muy encimados y es difícil distinguirlos) y completar los siguientes datos en la paleta Objeto:

SAP-adobeforms_11

En la solapa Vista Previa del PDF se puede visualizar el diseño del formulario completo.

10. Por último, grabar y activar.

Es importante tener en cuenta que para poder desplegar el formulario en la vista previa, es necesario la configuración de los Adobe Document Services (ADS) del lado del SAP Netweaver Application Server JAVA y la conexión desde ABAP con el sistema servidor JAVA que ofrece los Adobe Document Services.

La configuración de ADS está fuera del alcance de este tip. Para detalles sobre la configuración de Adobe Document Services, referirse al Help de SAP y buscar por: Adobe Document Services Configuration Guide.

Programa de impresión para el formulario

El siguiente código de programa escrito en ABAP, especifica cómo imprimir ese formulario a una impresora.

Para poder invocar al formulario desde un programa impresor ABAP se deberán seguir los siguientes pasos:

1) Llenar las tablas, estructuras, etc. que se pasarán cómo parámetros al formulario. En este ejemplo se llenaron la tabla pt_reserv y la estructura pa_header.

2) Abrir el formulario para impresión:

Invocar la siguiente función con los parámetros de impresión, entre ellos: indicar si se desea suprimir el diálogo pop-up de impresión (como en este ejemplo: l_outputparams-nodialog = ‘X’ ) e indicar que el archivo que retorne sea un PDF con el parámetro l_outputparams-getpdf = ‘X’.

DATA: l_outputparams TYPE sfpoutputparams.

* Output parameters and open spool job

l_outputparams-nodialog = ‘X’.

l_outputparams-getpdf = ‘X’.

 

* Open the form for printing

CALL FUNCTION 'FP_JOB_OPEN'

CHANGING

ie_outputparams = l_outputparams

EXCEPTIONS

cancel = 1

usage_error = 2

system_error = 3

internal_error = 4

OTHERS = 5.

IF sy-subrc <> 0.

MESSAGE ID sy-msgid TYPE sy-msgty NUMBER sy-msgno

WITH sy-msgv1 sy-msgv2 sy-msgv3 sy-msgv4.

ENDIF.

 

 

3) Obtener el nombre dinámico del formulario:

 

CALL FUNCTION 'FP_FUNCTION_MODULE_NAME'

EXPORTING

i_name = 'ZFORM_VH'

IMPORTING

e_funcname = p_func_name.

 

 

4) Llamar al formulario con el nombre obtenido, pasándole los parámetros con los datos ya cargados:

 

DATA: l_docparams TYPE sfpdocparams,

l_formoutput TYPE fpformoutput.

l_docparams-langu = 'E'.

l_docparams-fillable = c_on.

 

CALL FUNCTION p_func_name

EXPORTING

/1bcdwb/docparams = l_docparams

i_gt_reserv = pt_reserv

ga_header = pa_header

IMPORTING

/1bcdwb/formoutput = l_formoutput

EXCEPTIONS

usage_error = 1

system_error = 2

internal_error = 3

OTHERS = 4.

 

5) Cerrar el procesamiento del formulario:

 

CALL FUNCTION 'FP_JOB_CLOSE'

EXCEPTIONS

usage_error = 1

system_error = 2

internal_error = 3

OTHERS = 4.

IF sy-subrc <> 0.

MESSAGE ID sy-msgid TYPE sy-msgty NUMBER sy-msgno

WITH sy-msgv1 sy-msgv2 sy-msgv3 sy-msgv4.

ENDIF.

 

Requisitos técnicos

Para poder utilizar la herramienta de Adobe Forms (SAP Interactive Forms by Adobe) es necesario contar con los siguientes componentes de software:

  • Del lado del servidor:

- SAP Netweaver Application Server JAVA 6.40 o superior (en todos los escenarios posibles, es decir, es SIEMPRE necesario)

- SAP Netweaver Application Server ABAP 6.40 o superior (sólo en el caso de que la solución sea desarrollada con este lenguaje)

- Adobe Document Services – Configurado en el Motor JAVA. En el SAP Netweaver Application Server ABAP (desde donde se desarrolló el formulario) es necesario establecer el vínculo con el SAP WAS JAVA para poder acceder a los Adobe Document Services que corren el el Servidor JAVA)

- Adobe Credencials (Sólo para el caso de usar formularios interactivos)

  • Del lado del cliente:

- SAP Netweaver Developer Studio ó SAP GUI con Adobe Live Cycle Designer (lo que se utilizó en el caso del tip)

- Active Component Framework (para Web Dynpro Integration)

- Adobe Acrobat Reader 6.0.2 o superior, para poder mirar el PDF.

Para tener en cuenta …

  • La posibilidad de definir formularios interactivos con SAP Interactive Forms by Adobe, no se detalla en el tip presente.
  • Los formularios interactivos en formato PDF posibilitan a los usuarios cargar datos en el formulario presentado en la pantalla y guardar esas entradas en formato XML, para luego, cuando el sistema SAP reciba ese formulario PDF, pueda extraer los datos del mismo y procesarlos.
  • Ejecutar el PDF generado, ya sea para formularios interactivos o formularios de impresión basados en PDF (como en el caso del tip), involucra SIEMPRE el uso de Adobe Document Services (ADS), componente de software incluido en la solución para formularios que estamos analizando. Esta componente provee los Web Services que son usados para la generación de formularios PDF en tiempo de ejecución y se ejecutan en el motor J2EE (Java) del Netweaver Application Server.
  • Los ADS corren solamente sobre el stack Java, de modo que se necesitará tener el SAP Netweaver Application Server JAVA instalado y configurado para “deployar” y ejecutar formularios interactivos o Basados en PDF, independientemente del entorno de desarrollo utilizado para la creación del formulario PDF y del tipo de PDF generado.
  • Para los Smart Forms que pudieran ya estar desarrollados e implementados en un sistema SAP, existe una herramienta que permite migrar los SmartForms a formularios de impresión basados en PDF.

Copyright Teknoda S.A.

IMPORTANTE:
“Notas técnicas de SAP ABAP" se envía con frecuencia variable y sin cargo como servicio a nuestros clientes SAP. Contiene notas/tutoriales/artículos técnicos desarrollados en forma totalmente objetiva e independiente. Teknoda es una organización de servicios de tecnología informática y NO comercializa hardware, software ni otros productos.
Si desea suscribir otra dirección de e-mail para que comience a recibir las Notas Técnicas SAP, envíe un mensaje desde esa direcciónsapping@teknoda.com, aclarando nombre, empresa, cargo y país del suscriptor.

SAP, Netweaver, R/3, Fiori,S4/HANA y ABAP son marcas registradas de SAP AG. SAP no es el editor de esta publicación y no es responsable de la misma en ningún aspecto. La información contenida en esta publicación ha sido generada por nuestros especialistas a partir de fuentes consideradas confiables y del ejercicio profesional cotidiano. No obstante, por la posibilidad de error humano, mecánico, cambio de versión u otro, Teknoda no garantiza la exactitud o completud de la misma.
COPYRIGHT TEKNODA S.A. PROHIBIDA SU REPRODUCCION TOTAL O PARCIAL SIN CONSENTIMIENTO DE TEKNODA

 


 

Cómo consumir un Web Service desde una WebDynpro JAVA

Aprenda en SAP Netweaver los pasos necesarios  para consumir un Web Service desde un aplicativo Web Dynpro JAVA

En los nuevos escenarios de programación con SAP Netweaver, los Web Services cumplen un rol preponderante dentro del concepto de eSOA (Enterprise Services Oriented Architecture), y conforman el nuevo paradigma para el desarrollo de aplicaciones en SAP. (Referirse al Tip Nro. 16 – “ESA y Web Services en SAP Netweaver: Introducción”, para comprender la arquitectura eSOA y el importante concepto de Web Services.) 

Por otro lado, en este mismo escenario,  SAP propone el  desarrollo de Web Dynpros como la interfaz de usuario Standard (UI) para las aplicaciones, que facilitan el acceso a la funcionalidad provista por SAP, desde un entorno Web.  (Se recomienda la lectura del Tip Nro. 13: ”Entendiendo las Web Dynpro: un caso práctico paso a paso”, para una mayor comprensión del presente tip).

En este tip seguiremos por medio de un detallado ejemplo, todos los pasos necesarios para poder consumir un Web Service desde un aplicativo Web Dynpro JAVA. (Nota: en la jerga de Web Services “consumir” un web service es utilizarlo en una aplicación.)

Si bien en este tip nos enfocaremos en el consumo de un web service desde una Web Dynpro JAVA, los conceptos aplicados también son válidos para el caso de desarrollar una Web Dynpro ABAP. Una de las diferencias radica en la utilización del ABAP Workbench como entorno de desarrollo para el caso ABAP, y el SAP Netweaver Developer Studio para el desarrollo de una Web Dynpro JAVA.

Antes de empezar a especificar los pasos detallados del ejemplo, se hará un repaso de los conceptos claves que abarcan el desarrollo de una Web Dynpro (por ejemplo, el concepto de Model View Controller, utilizado tanto para las WD JAVA como para las WD ABAP ), y en particular aquellos que tienen que ver con los modelos de datos, debido a que los Web Services son considerados modelos de datos por este framework.

 

Modelos de datos en el patrón MVC

En un tip anterior (Tip Nro. 13: “Entendiendo las Web Dynpro: un caso práctico paso a paso”) se han mencionado las características más importantes del patrón MVC (Model View Controller) y se han desglosado, además, las distintas partes de las que consta este modelo.

En el presente tip vamos a especificar en detalle el Modelo.

modelo-MVC

En el patrón MVC, los modelos de datos son las entidades que representan los datos con los que va a trabajar una aplicación y es una de las capas vitales del patrón, ya que es la responsable de proveer el contenido completo en cuanto a los datos propiamente dichos.

En forma genérica estos modelos de datos pueden estar representados por clases, diagramas o cualquier tipo de descriptor que proporcione un perfil de la estructura que tendrán los datos con los que se va a trabajar.

En Web Dynpro los veremos como un componente más dentro de la aplicación, pero que es el encargado de proveernos datos de persistencia y funcionalidad para trabajar sobre ellos. El modelo encapsula la funcionalidad del negocio real. Sirve como fuente de datos para cualquier clase de visualización y provee un único punto para actualizar o recuperar información. Esto puede ser utilizando en JAVA a través EJB (enterprise Java Beans), ó ABAP a través de RFC y BAPIs, o como se explica en este tip, a través de Web Services.

Modelos de datos en WebDynpro – Web Service como Modelo de Datos

En el caso de WebDynpro se cuenta con varias posibilidades para el uso de modelos de datos.

Como se ha visto en el Tip en detalle Nro. 13: “Entendiendo las Web Dynpro: un caso práctico paso a paso”, el framework está volcado hacia el desarrollo visual y en ese sentido se dispone de una representación visual para el uso de los modelos de datos que se agreguen en un componente dado.

Lo interesante de este enfoque es que se podrán incorporar distintos tipos de modelos de datos, y se podrá manejarlos en forma análoga en todos los casos. Se verá en el ejemplo, que al incluir un modelo de datos en un componente, lo que se hace es incorporar un nuevo elemento del tipo “caja negra” que tiene puntos de entrada y puntos de salida con los cuales trabajar, pero quedan encapsulados los detalles del tipo de modelo que se esté usando.

De esta manera se podrá hacer un uso muy parecido de un modelo de datos generado a partir de un WebService o desde una RFC a través del SAP Enterprise Connector.

A continuación mostramos el menú que se despliega al crear un modelo dentro de un componente de WebDynpro. Se pueden ver las distintas opciones que éste ofrece, en lo siguiente:

menu-modelo-WebDynpro

En primer lugar se encuentra Adaptive RFC, que es en general bastante utilizado porque utiliza el SAP Enterprise Connector como base para encapsular en varias clases proxy, una conexión JCo (Java Connector) para poder realizar una llamada a una RFC en un sistema SAP ERP.

Luego la opción que nos ocupa en este tip, el Web Service Model. También, en este caso como en los otros, se generan clases que encapsulan la llamada, pero aquí particularmente, la tecnología subyacente es HTTP, SOAP y XML.

Las últimas dos opciones que se muestran son para la generación de un modelo de datos a partir de una definición UML, para lo cual se utilizan archivos en formato XMI, y los conocidos JavaBeans, (que son clases de Java con atributos miembro, que representan “Objetos”, lo cual obviamente puede usarse como perfil de un modelo de datos). La funcionalidad que se le agregue a estos objetos también podrá ser accedida a través del modelo.

Como mencionamos anteriormente, lo más interesante de la creación del modelo, es que no importa cuál de estas opciones se elija, el framework permitirá manejarlos en forma análoga. Veremos a continuación lo que el framework genera en forma gráfica para trabajar con el modelo.

framework-modelo-MVC

Este modelo gráfico encapsula todos los datos y funciones que modifican datos persistentes en un sólo modelo. Nuestro trabajo será simplemente enlazar este componente con los controladores correspondientes, cuyo trabajo consistirá en consumir los datos y funciones que este modelo provea.

Por ejemplo, desde el Component Controller, podremos tomar el contexto que representa este modelo, allí asignar valores a los parámetros de entrada de los servicios que el modelo preste, y luego ejecutar las llamadas para finalmente leer los resultados. Con ésto estaremos abarcando dos capas importantes del patrón MVC: Model y Controller, y además, para poder desplegar la información en pantalla, tendremos que incorporar la tercera capa denominada View que es la encargada de la interfaz visual.

En el siguiente esquema se puede ver la estructura típica del escenario que se acaba de describir. Se cuenta con un web service a consumir y se lo consume a través del modelo generado en el framework de Web Dynpro. Una vez generado el modelo, quedan encapsulados los detalles de la llamada propia al Web Service. Luego, el manejo queda supeditado al Component Controller que deberá poblar su contexto y realizar la llamada al servicio con métodos automáticamente generados por el entorno de desarrollo.

 

estructura-framework-modelo-MVC

 

Caso práctico

El caso práctico que desarrollaremos ejemplifica cómo se utiliza un WebService en una Web Dynpro JAVA. Para este ejemplo tomaremos un Web Service de la web, en este caso de la dirección http://coeservice.en.kku.ac.th/samples/.

En este sitio, elegimos, como ejemplo, un web service que va a permitir realizar la conversión de un valor de temperatura dado en grados Celsius a grados Farenheit. En dicha dirección de Web, hay otros Web Services disponibles, que también se podrían utilizar.

Para el desarrollo de la aplicación Web Dynpro JAVA completa que haga uso de web services como modelo de datos, es necesaria la ejecución de los siguientes pasos, que van a ser desarrollados más abajo en este tip: :

• Pasos para la creación de un proyecto Web Dynpro

• Pasos para la creación de una componente Web Dynpro

• Pasos para la creación de un modelo de datos

• Pasos para la creación de una o más vistas

• 1era. Parte: Pasos para la creación de “inbound” y “outbound plugs”

• 2da. Parte: Pasos para la conexión de los “plugs” por el uso de links de navegación

• Pasos para la creación de actions (acciones) e implementación de la navegación

• Pasos para la estructura de los contextos

• Pasos para la realización del diseño de la vista FormularioView

• Pasos para la realización del diseño de la vista ResultadoView

• Pasos para la implementación de la lógica de negocio en el Component Controller

• Pasos para agregar la llamada al Servicio en FormularioView

• Pasos para la creación de una Web Dynpro Application

• Ejecución de una Web Dynpro Application

La aplicación desarrollada se llamará: “ConsumoWebServiceWD” y va a estar compuesta por 2 vistas. Al ser ejecutada la aplicación, la primera vista debería tener el siguiente aspecto:

 

conversor-temp-vista1

Y el de la segunda vista, como sigue:

 

conversor-temp-vista2

Para comenzar a construir una Web Dynpro, lo primero que debemos hacer es abrir el producto cliente SAP Netweaver Developer Studio (el entorno de desarrollo para JAVA), que debemos tenerlo instalado en nuestro puesto de trabajo (PC).

Su ruta de acceso es Inicio --> Programas --> SAP Netweaver Developer Studio --> SAP Netweaver Developer Studio y realizamos doble click sobre la misma. Luego, aparecerá una pantalla como la siguiente:

 

developer-studio

 

A partir de aquí, lo primero que se necesita es seleccionar la perspectiva con la cual vamos a trabajar. Para ello se elige desde el menú principal: Window --> open Perspective --> Web Dynpro. Luego crearemos el Proyecto que contendrá la Web Dynpro a desarrollar.

Pasos para la creación de un proyecto Web Dynpro

1. Seleccionar File →New →Project.

2. Aparece el asistente de New Project

3. En el panel izquierdo seleccionar Web Dynpro y luego en el panel derecho Web Dynpro Project y presionar Next.

4. En la siguiente pantalla de propiedades del proyecto, colocar el nombre del proyecto, que llamaremos ConsumoWebServiceWD, y dejar las especificaciones por defecto del Project contents y el Project language.

Con los 4 pasos realizados previamente, se ha creado la estructura del proyecto, pero aún no se han definido las vistas y su layout, los controladores, ni los eventos. Para ello, debemos definir previamente una componente Web Dynpro que los encapsule.

Pasos para la creación de una componente Web Dynpro

1. Expandir el nodo Web Dynpro y posicionarse sobre Web Dynpro Components. Presionar Botón derecho del mouse y seleccionar del menú contextual: Create Web Dynpro Component

2. Se visualiza, entonces, el asistente para “New WebDynpro Component ”. Luego, se debe ingresar el nombre del Component Name: ConsumoWSComponent y especificar el paquete (tal como com.teknoda.ejemplo.consumowebservice) .

 

new-web-dynpro-component

 

3. Corregir ConsumoWSComponent en la caja de texto de Window name por el nombre ConsumoWSWindow.

4. Posteriormente, se debe corregir ConsumoWSComponentView en la caja de texto de View name por el nombre de la primera vista a crear llamadaFormularioView.

5. Dejar todas las especificaciones por defecto que aparezcan. Cerciorarse que se encuentre tildado “Embed New View”.

6. Presionar Finish.

7. Presionar el dibujo del “diskette” que se encuentra en la barra de herramientas, para que el proyecto quede guardado.

Una vez realizados estos pasos, en el panel derecho, se desplagará automáticamente el Data Modeler view, (que no va a ser usado por el momento), mientras que a la izquierda de la pantalla, en el Web Dynpro Explorer, al expandir el nodo Web Dynpro Components se podrá visualizar la nueva componente creada con nombre: ConsumoWSComponent.

La figura siguiente muestra cómo quedaría el panel Web Dynpro Explorer:

 

panel-webdynpro-explorer

Pasos para la creación de un modelo de datos

1. Expandir el nodo Web Dynpro en el panel Web Dynpro Explorer .

2. Presionar botón derecho del Mouse sobre el nodo Models.

3. Hacer “click” sobre “Create Model”.

4. Seleccionar el radio button correspondiente a “Import Web Service Model” y luego Next.

5. Luego, como se muestra en la figura de más abajo, se debe ingresar un nombre para el modelo de datos,. En este caso ingresamos el nombre “TemperaturaModel

6. Como package del modelo ingresar “com.teknoda.temperatura.model”.

7. Es importante seleccionar la fuente de generación del Web Service, en este caso se debe seleccionar el radio button correspondiente a “UDDI or URL”, ya que lo que se hará es ingresar una dirección donde está alojado el web service a utilizar.

NOTA: En general se utiliza la dirección donde está el descriptor WSDL para importar un Web Service, pero como se verá en la sección “Para tener en cuenta …” (especificado más abajo en este tip) , se puede contar con el archivo WSDL localmente y con él generar el modelo de datos en la aplicación.

 

new-model-service

8. Presionar Next.

9. Posteriormente, en la pantalla que se obtiene, ingresar la dirección del WSDL correspondiente al Web Service a utilizar, en este caso :

http://coeservice.en.kku.ac.th:8080/TemperatureConvertor/TemperatureConvertorService?WSDL

10. Luego de presionar Next, se presiona Finish, y quedará creado el modelo de datos.

Lo que resta es incorporarlo en el componente WebDynpro creado en pasos anteriores.

11. Para ello, desplegar el nodo WebDynpro Components → ConsumoWSComponent → Used Models. Presionar botón derecho del Mouse sobre el mismo y seleccionar Add… . Luego, seleccionar TemperaturaModel y, finalmente OK.

Pasos para la creación de una o más vistas

1. En el panel Web Dynpro Explorer, expandir el nodo Web Dynpro → Web Dynpro Components → ConsumoWSComponent → Windows.

2. Realizar doble click en el nodo del objeto Windows creado anteriormente con nombre ConsumoWSComponent, de esta forma en el panel derecho se visualiza el Diagram View.

3. Seleccionar el ícono Embed View de la paleta que se encuentra a la izquierda de la ventana del Diagram View. Se realiza un click en el ícono, luego el mouse se ubica en el panel del diseño y se “estira” para formar un área rectangular de un tamaño considerable.

4. Aparecerá el asistente, se deberá elegir la opción Embed new View y presionar el botón Next.

5. Ingresar el nombre para la nueva vista ResultadoView y presionar el botón Finish.

 

Luego, una vez definidas las dos vistas, se debe indicar la navegación entre las mismas. Por lo tanto, se deberán crear puntos de entrada y salida para cada vista, habilitando conectores de entradas y salidas (“inbound plugs” y “outbound plugs”). Los “inbound plugs” definen los posibles puntos de entrada de una vista, mientras que, los “outbound plugs” brindan la posibilidad de navegar hacia otra vista. Los “plugs” forman parte del controlador de la vista y se asignan a una sola de ellas cada vez.

Consideraciones importantes sobre las Vistas y los “plugs”:
  • Cada vista tiene que tener al menos un inbound plug mientras que el outbound plug es opcional.
  • En general, varias vistas se encuentran embebidas en un objeto Windows, por lo tanto hay que determinar a través de la propiedad StartView cuál va a ser la primera vista que se despliegue en el Browser. La estructura de navegación partirá de esta vista.
  • Cada vez que se coloca un inbound plug se genera automáticamente un método que maneja dicho evento en el fuente java que representa a la vista

 

La secuencia de pasos para definir la navegación está dividida en dos partes. La primera parte se refiere a la creación de los “ plugs” y la segunda parte para conectar a los links de navegación.

1º Parte: Pasos para la creación de “inbound “ y “outbound plugs”

1. Dentro del Diagram View, se selecciona el rectángulo que representa la primera vista, FormularioView, con un click derecho del mouse, se despliega el menú contextual.

2. Se selecciona la opción Create Outbound Plug.

3. Aparece el asistente, se ingresa el nombre del “outbound plug “ AResultadoView y se presiona Finish.

4. Se selecciona el rectángulo que representa la segunda vista, ResultadoView, con un click derecho del mouse, se despliega el menú contextual.

5. Se selecciona la opción Create Inbound Plug.

6. Se ingresa el nombre del “inbound plug” DesdeFormularioView, se dejan las especificaciones por defecto para el manejador de eventos y se presiona Finish.

7. Se repiten los pasos apropiadamente para la creación del “outbound plug” AformularioView para la vista ResultadoView y el “inbound plug” DesdeResultadoView para la vista FormularioView.

Tabla indicadora de las correspondencias entre “plugs” y “Vistas”

 

  outbound plug inbound plug
FormularioView AResultadoView DesdeResultadoView
ResultadoView AformularioView DesdeFormularioView

 

 

2 º Parte: Pasos para la conexión de los “plugs” por el uso de links de navegación

1. Para la creación del link de navegación de la primera vista, se selecciona el ícono Create Link desde la paleta que se encuentra a la izquierda de la ventana Diagram View y se traza la línea desde el “outbound plug “de FormularioView al “inbound plug” de ResultadoView.

2. De manera similar, se crean los links de navegación desde la segunda vista ResultadoView hacia la primera vista FormularioView.

Si se expande el árbol perteneciente al Web Dynpro Explorer (panel izquierdo de la perspectiva), desde Windows → Primera Component, al abrir este último nodo, se verán las dos vistas FormularioView y ResultadoView. Al realizar doble click sobre, por ejemplo: FormularioView, se despliega una ventana llamada Editor View inmediatamente debajo de la ventana de Diagram View.

Esta ventana presenta 5 solapas. Al seleccionar la solapa Implementation, se observa el código de java generado para dicha vista. De manera automática, en dicho código veremos implementados los métodos correspondientes a cada “inbound plug”, que se llaman onPlug<nombre del plug>.

Solapa Implementation de la vista FormularioView

public void onPlugDesdeResultadoView (com.sap.tc.webdynpro.progmodel.api.IWDCustomEvent wdEvent)
{
//@@begin onPlugDesdeResultadoView(ServerEvent)
//@@end
}

Solapa Implementation de la vista ResultadoView

public void onPlugDesdeFormularioView (com.sap.tc.webdynpro.progmodel.api.IWDCustomEvt wdEvent )
{
//@@begin onPlugDesdeFormularioView(ServerEvent)
 
//@@end
}

Para navegar de una vista a otra, se necesita una acción apropiada que permita relacionar un elemento de interfaz de usuario (por ejemplo un botón) con el traslado a otra vista. En consecuencia, se necesita implementar un método que actúe como un “manejador de eventos” y “reaccione” ante tal acción (por ej: presionar un botón), ejecutándose luego el cambio correspondiente.

Pasos para la creación de actions (acciones) e implementación de la navegación

1. Dentro del EditorView de FormularioView, seleccionar la solapa Actions.

2. Presionar el botón New.

3. Aparece el asistente para crear una nueva acción. Luego, ingresar el nombre, denominado en este caso Traducir, para la nueva acción, y dejar las opciones del Event handler por default.

4. Asignar al campo Fire plug, el “Outbound plug ” AResultadoView, y presionar Finish. La nueva acción, Traducir, se encuentra asociada con el método que actúa como manejador de eventos onActionEnviar, que se puede observar en la lista de acciones.

5. Se repiten los mismos pasos para la acción Volver perteneciente a la vista ResultadoView y se asigna al campo Fire plug, el “Outbound plug ” AFormularioView.

6. Luego, guardar la nueva metadata completa eligiendo el ícono Save All Metadata desde la barra de herramientas.

Finalmente, después de haber creado las 2 acciones: Enviar y Volver, se tendrán implementados los métodos relacionados al manejo de eventos de cada acción. Para poder visualizarlos, se debe seleccionar la solapa Implementation de ambas vistas.

Solapa Implementation de la vista FormularioView

public void onActionTraducir (com.sap.tc.webdynpro.progmodel.api.IWDCustomEvent wdEvent)
{
//@@begin onActionEnviar(ServerEvent)
wdThis.wdFirePlugAResultadoView();
//@@end

Solapa Implementation de la vista ResultadoView

 

public void onActionVolver (com.sap.tc.webdynpro.progmodel.api.IWDCustomEvent wdEvent )
{
//@@begin onActionVolver(ServerEvent)
wdThis.wdFirePlugAFormularioView();
//@@end
}
 

Arriba se puede observar cómo se llama al método wdFirePlugToResultView() perteneciente al  “outbound plug”. Para la ejecución de dicho método, se utiliza la variable privada wdThis que pertenece a la Interface IPrivateResultadoView. La misma se utiliza siempre que se necesite un método que se comunique internamente al ViewController (el concepto del  “View Controller” será desarrollado posteriormente).

Una vez que se tienen definidas las acciones se puede empezar a trabajar con el “layout “ de la vista.

Para comenzar, se deberá seleccionar la solapa  Layout en el EditorView, donde se  muestra por ej: la vista FormularioView representada por una caja de texto predefinida de color gris (predefined default text). Simultáneamente, si se observa el Outline view (panel izquierdo zona inferior) desplegará una lista de todos los elementos de la interfaz de usuario que se vayan incluyendo. Todos los elementos de la interfaz de usuario están acomodados bajo el  nodo raíz y representados en formato de árbol. Si se realiza un click derecho sobre un elemento de UI que se encuentra en el árbol y se selecciona Properties del menu contextual, se puede visualizar las propiedades de dicho elemento UI, a través de la ventana Properties view .

Pasos para la estructura de los contextos

1. Abrir el Data Modeler desde el menú contextual de ConsumoWSCompoment

 

image014

 

2. Se compartirán los contextos del modelo y del Component Controller, para lo cual se deberá crear un data link entre ellos.

3. Arrastrar Request_TemperatureConvertor_celsiusToFerenheit desde el modelo (derecha) hacia el Component Controller (izquierda).

4. Seleccionar la estructura completa del nodo que recientemente se “arrastró”, para ser incluida en el contexto del Component Controller.

5. Renombrar el nodo Request_TemperatureConvertor_celsiusToFerenheit a TempRequest para facilitar el posterior manejo en el código de dicho nodo. Pulsar OK, y luego Finish.

 

image015

6. Luego, se realiza lo propio con los contextos de ambas vistas. Se debe crear un data link entre cada una de las vistas y el Component Controller, arrastrando en cada caso todos los elementos del contexto de dicho controlador.

7. El resultado será el siguiente:

 

image016

8. Realizar “click” en Save All Metadata.

Pasos para la realización del diseño de la vista FormularioView

1. Desde la ventana Outline view, se elige el nodo raíz RootUIElementContainer y se especificacn las propiedades tal como indica la siguiente tabla:

 

Property

Value

Layout

GridLayout

CellPadding

5

ColCount

1

 

Nota: No todos los valores de la  propiedades son editables, en algunas  se debe seleccionar un valor predefinido desde una lista desplegable.

Se elige el nodo hijo DefaultTextView y se elimina el mismo:


2. Desde la ventana Outline view, se selecciona el elemento RootUIElementContainer y desde el menú contextual se elige la opción Insert Child. Seleccionar Group. Asignarle el nombre FormGroup, y establecer los siguientes valores a sus propiedades

FormGroup

Property

Value

layout

GridLayout

colCount

1

3. Desde la ventana Outline view, se selecciona el elemento FormGroup y desde el menú contextual elegir la opción Insert Child. Seleccionar TransparentContainer y asignarle el nombre FormContainer

4. Desde la ventana Outline view, se selecciona el elemento FormContainer y desde el menú contextual elegir la opción Apply Template. Seleccionar Form. Luego seleccionar el atributo celsius del contexto.

5. Con el paso previo se crean 2 nuevos elementos de la interfaz de usuario: celsius (con el tipo InputField), celsius_label (con el tipo Label). Se debe aplicar las siguientes propiedades:

celsius_label

Property

Value

Text

Celsius

LabelFor

celsius

PaddingTop

large

 

celsius

Property

Value

tooltip

Temperatura en grados Celsius

PaddingTop

large

 

6. Desde la ventana Outline view, se selecciona el elemento FormGroup y desde el menú contextual elegir la opción  InsertChild. Posteriormente, seleccionar  HorizontalGutter y presionar Ok.

7. Desde la ventana Outline view, se selecciona el elemento FormGroup y desde el menú contextual elegir la opción  InsertChild. A continuación, seleccionar Button y asignar el nombre ConvertirButton. Asignar las siguientes propiedades:

ConvertirButton

Property

Value

tooltip

Ir a la vista siguiente a ver el resultado

Event > onAction

Traducir

hAlign

center

 

Una vez concluida la vista FormularioView, se continúa con  la vista ResultadoView.

 

Pasos para la realización del diseño de la vistaResultadoView>

1. Desde la ventana Outline view, se elige el nodo raíz RootUIElementContainery se agrega un nuevo elemento del tipo Group llamado ResultadoGroup. Con las siguientes propiedades:

Property

Value

layout

GridLayout

cellPadding

5

colCount

1

 

2.Se elige el nodo hijo Group_header y se especifican las siguientes propiedades:

Property

Value

text

Conversión Temperatura

 

3. Desde la ventana Outline view, se selecciona el elemento ResultadoGroup y desde el menú contextual  elegir la opción Insert Child. Se selecciona un elemento del tipo Transparent Container. Asignar el nombre ResultadoContainer.

4. Desde la ventana Outline view, se selecciona el elemento ResultadoContainer y desde el menú contextual se elige la opción Apply Template. Nuevamente se selecciona el tipo Form y elegir el atributo Result para ser desplegado en el formulario.

5. Desde la ventana Outline view, se selecciona el elemento ResultadoGroup y desde el menú contextual elegir la opción Insert Child. Seleccionar un elemento del tipo HorizontalGutter y  asignarle el nombre Gutter.

6. Desde la ventana Outline view, se selecciona el elemento ResultadoGroup y desde el menú contextual elegir la opción Insert Child. Seleccionar un elemento del tipo Button, con el nombre VolverButton, y asignar las siguientes propiedades.

VolverButton

Property

Value

Text

Volver

Tooltip

Ir a la vista anterior

Event -> onAction

Volver

 

Finalmente, se guardan los cambios en la metadata y se selecciona el ícono “Save All Metadata que se encuentra en  la barra de Herramientas.

Pasos para la implementación de la lógica de negocio en el Component Controller

1. Abrir la ventana  EditorView de Component Controller, haciendo doble clic sobre el nodo correspondiente en la jerarquía del proyecto.

2. Agregar un método en la solapa Methods del mismo. New→ Method →  Next.


3. Al método asignarle el nombre EjecutarConversion y seleccionar  OK.


4. Editar los siguientes métodos en la solapa “Implementation”.

public void wdDoInit()
 ">
{
//@@begin wdDoInit()
// crear el objeto del modelo
Request_TemperatureConvertor_celsiusToFahrenheit requestMO = new
Request_TemperatureConvertor_celsiusToFahrenheit();
// bindear el objeto ejecutable al nodo correspondiente del contexto
wdContext.nodeTempRequest().bind(requestMO);
msgMgr = wdThis.wdGetAPI().getMessageManager();
//@@end
}

Luego,

public void EjecutarConversion( )
 { //@@begin EjecutarConversion()
 try {
 // Ejecutar el Web Service y actualizar el modelo 'Response'
      Request_TemperatureConvertor_celsiusToFarenheit requestMO =
wdContext.currentTempRequestElement().modelObject();
      requestMO.execute();
wdContext.nodeResponse().invalidate(); } catch (Exception ex) { msgMgr.reportException(ex.getLocalizedMessage(), true); } //@@end }

 

Y finalmente en la sección Others se agrega:

//@@begin others
IWDMessageManager msgMgr;
//@@end
Pasos para agregar la llamada al Servicio en FormularioView

1. Se editan los siguientes métodos en la solapa “Implementation” de la vista FormularioView.

public void onActionTraducir(com.sap.tc.webdynpro.progmodel.api.IWDCustomEvent wdEvent )
{
//@@begin onActionTraducir(ServerEvent)
wdThis.wdGetConsumoWSComponentController().EjecutarConversion();
wdThis.wdFirePlugAResultadoView();

//@@end
}

2. Se guarda la nueva metadata completa con el ícono  Save All Metadata que se encuentra en la barra de herramientas.

Antes de poder seguir con las tareas de  “deployment” (se puede realizar por contar con el motor J2EE); se necesita  la obtención de un objeto que tenga comprimido en su interior todos los elementos y la componente que estuvimos creando. Dicho objeto es una Web Dynpro Application.  Una vez que tenemos ese objeto “Web Dynpro Application”, la aplicación se encuentra en condiciones de ser “deployada”.

Pasos para la creación de una Web Dynpro Application

3. Para abrir el  Asistente , elegir  Create Application desde el  menú contextual del nodo  Applications.

4. Ingresar el nombre para la  Web Dynpro Application: ConversionApp, y especificar el nombre del paquete com.teknoda.convert.app para las clases de Java  y luego  presionar  Next.

5. En la ventana siguiente, se elige la opción Use existing component y se presiona  Next.

6. Y luego, en la próxima ventana que aparezca, se dejan los valores asignados por default y se presiona Finish.

Finalmente,  resta realizar un “deploy ” de la Web Dynpro Application, para luego poder “lanzarla” (ejecutarla) y ver la misma  desplegada en el Browser:

Para poder hacer un “deployment” de la aplicación y luego ejecutarla,  se requiere  que se encuentren  ejecutando el SAP J2EE Engine y el Software Deployment Manager (SDM)

(Nota: Para el chequeo de  los seteos del Servidor, se selecciona el menú Window Preferences SAP J2EE Engine.)

Ejecución de una Web Dynpro Application

Para ejecutar la aplicación,  se debe hacer click derecho sobre el nodo ConversionApp en el panel Web Dynpro Explorer y seleccionar la opción: “Deploy New Archive and Run”, como se muestra en la figurasiguiente:

 

image017


Para tener en cuenta …

 

  • Opción de Importar modelo desde archivo local : Las opciones de importación de la estructura del modelo abarcan no sólo la vía que hemos utilizado a través de la URL correspondiente al archivo WSDL del Web Service., sino que también existe la posibilidad de contar con el archivo WSDL en una carpeta local. En este caso se puede consultar dicho archivo, que  muchas veces contiene datos respecto de la estructura del web service y documentación acerca de la funcionalidad de dicho servicio.

Como ejemplo, se podrá observar que si en un Browser se colocara la dirección utilizada en el ejemplo para importar el Web Service, obtendremos el propio archivo WSDL correspondiente y podremos guardarlo localmente para examinarlo, y hasta eventualmente modificarlo.

Generalmente ésto no es necesario, y sólo en casos excepcionales se requerirá modificar dichos archivos, pero un caso particular y útil es aquel en el que se desea pasar algún parámetro fijo al WebService.

Para este caso  mostramos un ejemplo utilizando el fragmento específico del archivo WSDL a modificar.

Tomemos como ejemplo un web service que realiza la traducción de un texto a distintos idiomas según se especifique en un parámetro llamado LanguageMode. El siguiente fragmento especifica la dirección a la cual se realizará la petición del servicio:

<wsdl:port name="TranslateServiceHttpGet" binding="tns:TranslateServiceHttpGet">
<http:address location="http://www.webservicex.net/TranslateService.asmx"/>
</wsdl:port>

Lo que se puede realizar es agregar en esa dirección el pasaje de algún parámetro conocido, que necesitemos que quede establecido como fijo. A veces en algunos Web Services de SAP, como aquellos generados a partir de RFC, necesitan del parámetro sap-client, y éste es un punto interesante donde agregarlo.

En este ejemplo podemos hacer que la traducción sea siempre de Inglés a Español, como se ve a continuación:

<wsdl:port name="TranslateServiceHttpGet" binding="tns:TranslateServiceHttpGet">
<http:address
location="http://www.webservicex.net/TranslateService.asmx?LanguageMode=EnglishTOSpanish"/>
</wsdl:port>

LanguageMode podría haber tomado otros valores como especifica la documentación de dicho Web Service, por ejemplo, SpanishTOEnglish, EnglishTOChinese, y habérselo asignado dinámicamente, pero es interesante la posibilidad antes mencionada.

  • Disponibilidad del Web Service: En el ejemplo práctico que desarrollamos en el presente tip, se utilizó un Web Service alojado en un server privado, que ofrece la posibilidad de consumirlo en forma gratuita, siempre y cuando se encuentre disponible. Pero, hay que tener que cuenta que, en algunos casos, ya sea por congestionamiento del servicio o por simple baja del mismo, es probable que no se pueda acceder a él.

El ejemplo desarrollado en este tip es una aplicación práctica, genérica y simple que se puede adaptar fácilmente al consumo de cualquier Web Service al cual se tenga acceso. Por lo tanto  es válido aclarar que los pasos seguidos en este tip son los mismos que se llevarían a cabo para cualquier otro Web Service que se quiera consumir.


Copyright 2009 Teknoda S.A.

IMPORTANTE:
“Notas técnicas de SAP ABAP" se envía con frecuencia variable y sin cargo como servicio a nuestros clientes SAP. Contiene notas/tutoriales/artículos técnicos desarrollados en forma totalmente objetiva e independiente. Teknoda es una organización de servicios de tecnología informática y NO comercializa hardware, software ni otros productos.
Si desea suscribir otra dirección de e-mail para que comience a recibir las Notas Técnicas SAP, envíe un mensaje desde esa direcciónsapping@teknoda.com, aclarando nombre, empresa, cargo y país del suscriptor.

SAP, Netweaver, R/3, Fiori,S4/HANA y ABAP son marcas registradas de SAP AG. SAP no es el editor de esta publicación y no es responsable de la misma en ningún aspecto. La información contenida en esta publicación ha sido generada por nuestros especialistas a partir de fuentes consideradas confiables y del ejercicio profesional cotidiano. No obstante, por la posibilidad de error humano, mecánico, cambio de versión u otro, Teknoda no garantiza la exactitud o completud de la misma.
COPYRIGHT TEKNODA S.A. PROHIBIDA SU REPRODUCCION TOTAL O PARCIAL SIN CONSENTIMIENTO DE TEKNODA

 


Tema: Web Dynpro JAVA, SAP Netweaver Application Server, WebServices, J2EE

Descripción: Aprendar los pasos básicos para el consumo de un Web Service desde un aplicativo Web Dynpro JAVA y el desarrollo de un ejemplo detallado paso a paso.

Copyright © 2024 Teknoda Tech Portal & Training. Todos los derechos reservados.
Joomla! es software libre, liberado bajo la GNU General Public License.