96861639 Manual de Smart Forms

Manual Smart Forms 4.7

Manual Smart Forms versión 4.7

Smart Forms es la nueva herramienta de sap para la creación de formularios y su posterior mantenimiento.Igual Sapscript se va a mantener en el futuro pudiendo elegir utilizar uno u otro.

Ventajas:

* Creación y mantenimiento de formularios en tiempos mucho mas cortos * Adaptación de formularios sin ningún tipo de conocimiento de programación* Interfase de usuario enteramente grafica* Publicación en web usando salida XML* Herramientas de migración desde sapscript* Salida por impresora, fax, mail,o internet* Eliminación de la complejidad del programa impresor

Para imprimir un formulario se necesita un programa impresor y el smart form.Pero a diferencia de sapscript la lógica puede estar dentro del smart form; esto es lo que lo hace inteligente.

El programa impresor solo pasa los datos, luego las condiciones, el filtrado de datos, ordenamiento, etc; se realiza a través de la lógica del smart form.

GAP1 Página 1

Programa Impresor

Sapscript Formulario

Lógica

Programa Impresor

Smart Form Formulario

Logica


GAP1 Página 2


Transacción SMARTFORMS.

La creación y modificación de todo formulario Smart Form, Estilo y modulo de texto se realiza por medio de la transacción SMARTFORMS.

Con se puede renombrar el objeto.

Con se borra el objeto seleccionado.

Con Se verifica el formulario.

A su ves se pueden realizar copias de formularios, estilos y módulos de texto presionando

el botón e ingresando posteriormente el nombre del nuevo Objeto.

GAP1 Página 3


Form Builder.

Desde el form builder se crean / modifican todas las características del formulario. Estando dividido este en tres áreas / ventanas de trabajo:

• Navigation Menu. Desde esta área de trabajo se pueden visualizar todos los nodos del formulario. También es posible crear nuevos haciendo clic derecho con el mouse sobre el nodo padre. Arrastrando y soltando se pueden posicionar los nodos dentro / debajo de un nodo distinto al original.

• Maintenance Menu. Manejote propiedades y atributos de los objetos. Desde acá se setean todas las características generales del formulario y particulares de cada nodo.

• Form Painter. Se utiliza para diseñar el layout del formulario. Se pueden incorporar ventanas y gráficos determinando sus posiciones y eligiendo sus tamaños.

GAP1 Página 4

Navigation Menu Maintenance Menu Form Painter


La lógica del formulario es representada por una estructura de árbol que consiste en distintos objetos como paginas y ventanas, parametrizaciones y nodos individuales, como seteo global, textos, tablas de salida, gráficos, etc.

Parametrizaciones Globales.

Dentro de esta área se definen características generales para todo el formulario como ser tamaño de pagina, datos de interfase, variables globales, inicializaciones de variables, rutinas form, Estilo por default, tipos.

Atributos Formulario.

Permite setear:• atributos de idioma• formato de paginas• caracteres y líneas por pulgadas• Estilo por default• Formato de salida • Modo de salida• Dispositivo de salida

GAP1 Página 5


Atributos idioma: El formulario se puede traducir a todos los idiomas, solo algunos seleccionados o no traducirlo a ninguno directamente.

Opciones de salida generales de tamaños de pagina y estilos. El estilo definido en esta solapa es el estilo por default para el resto del formulario.

El formato de salida puede ser:• Salida estándar.• Salida XSF. (idioma basado en el XML)• Salida XSF + HTML. (se generan datos en HTML que se pueden enviar a un

browser para la visualización.

los modos de salida permitidos pueden ser:• SPOOL. La salida se realiza en el spool. Este modo se puede utilizar para el formato

de salida XSF.• APLICACIÓN. Los datos se devuelven a la aplicación de llamada como tabla

interna.

Pagina BSP/URL. Transferir de nuevo los datos de los campos declarados como listos para entrada del browser al URL indicado en este apartado.

GAP1 Página 6


Interfase Formulario.

Se define en import o tablas las tablas internas que se utilizan en el formulario.

Nota importante: por una cuestión de funcionamiento interno el tipo referencia de las tablas que se importan debe ser de un tipo definido por el usuario con la transacción SE11.

En la interfase Formulario se definen todos los argumentos ya sean de salida (EXPORT) como de entrada (IMPORT , TABLAS).

La tipificación puede ser una de los siguientes:

GAP1 Página 7

Tipo definido por el usuario


Definiciones Globales.

En la solapa datos globales se definen todas las variables que se van a utilizar posteriormente en el formulario.

El tipo de referencia puede ser:• estándar de sap• definido por el usuario por medio de la SE11• types definidos por el usuario en la solapa Tipos

En la solapa Tipos se ingresan los tipos de datos definidos por el usuario.

Este tipo definido podrá ser utilizado como tipo referencia en la solapa Datos Globales.

GAP1 Página 8


En la solapa Inicialización se puede ingresar código Abap que va a ser ejecutado cuando se inicie el formulario.

Las variables globales que van a ser utilizadas tienen que estar definidas en el área de Parámetros de entrada y parámetros de salida según corresponda.

En la solapa Rutinas Form se ingresan en código ABAP todos los perform a ser utilizados en el formulario.

GAP1 Página 9


Paginas y Ventanas.

Paginas.

Creación de Paginas.

La creación de nuevas paginas se realiza haciendo clic con el botón derecho del mouse en el Árbol de navegación.

Del menú que se despliega seleccionar Crear->Pagina.

Definición de características.

Pagina subsiguiente. Se define el nombre de la pagina en donde se va a continuar el procesamiento una ves que la ventana principal este llena o que se ejecute un salto de pagina.

Contador de paginas. Define el formato y el modo de ejecución del contador.

GAP1 Página 10


Opciones de Salida.

En esta solapa se definen los formatos de las paginas (vertical, apaisado) y los atributos de impresión.

Fondo

Se puede definir la imagen de fondo y sus características en esta solapa

GAP1 Página 11


Ventanas.

Los formularios Smart Form están divididos en ventanas, cada una de estas se puede manejar en forma independiente siendo la única condición de que solo exista una ventana Main por pagina.

Al layout y sus correspondientes ventanas se accede presionando el botón FORM

PAINTER ( ).

Para crear una nueva ventana directamente desde el Form Painter botón derecho del mouse Crear->ventana.

GAP1 Página 12


También se pueden cambiar la ubicación y el tamaño de cada ventana desde el mismo Form Painter.

Ventana Main.

Dentro de cada pagina es necesaria la inclusión de una y solo una ventana principal o MAIN.

En esta ventana se incorpora el núcleo del procesamiento del formulario.

Ventanas Auxiliares.

Resto de las ventanas que no son la ventana principal.

Tanto la ventana principal como las ventanas auxiliares se pueden crear desde el Form Painter y desde el árbol de navegación.

GAP1 Página 13


Nodos.

Nodo Texto.

Imprime un texto literal, variables o campos de una tabla interna definida previamente en datos globales.

Los nodos texto se pueden anidar dentro de otros nodos.

Como agregar un nodo:

Hacer clic derecho sobre el nodo en el cual se quiere agregar el nodo texto y seleccionar Crear->Texto.

GAP1 Página 14


Ingreso de características.

Tipo texto.• elemento de texto.• modulo de texto. (SE32)• texto include. (desde sapscript text)

Inicio.• párrafo nuevo. (el texto se añade en un párrafo nuevo)• línea nueva. (el texto se añade en una línea nueva)• añadir directamente. (el texto se añade directamente)

Formato de párrafos y caracteres.

los párrafos y caracteres a seleccionar dependen del estilo seteado.

GAP1 Página 15

Texto Literal

Campos y variables


Opciones de salida.

Ingreso al editor de texto.

Para ingresar al editor de texto hacer clic en el botón Editor txt ( ).

GAP1 Página 16

Estilo seteado para el nodo texto en particular, si se deja vació toma el estilo por default.


para ingresar campos presionar el botón y luego ingresar el campo entre signos &.

Con el botón se borra un campo seleccionado y con el botón se modifica.

Nodo Grafico.

Permite la visualización de gráficos, previamente cargados en sap, en las paginas del formulario.

Creación de un nodo grafico en el formulario.

Realizar clic derecho en la pagina en la cual quiero crear el nodo grafico y seleccionar Crear->función Grafica.

Propiedades Generales.

GAP1 Página 17


Opciones de Salida.

En opciones de salida se definen la posición, tamaño, marcos y sombreados del grafico.

GAP1 Página 18

Identificación del grafico en sap

Modo de visualización


Nodo Dirección.

Permite la visualización de direcciones previamente cargadas en sap en los formularios.

Creación.

En el lugar en el que se quiere ingresar el nodo dirección hacer clic derecho y seleccionar crear->dirección.

Propiedades Generales.

Pasándole una variable al numero de dirección la información se obtiene de manera dinámica.

En caso de poner un valor fijo siempre se va a mostrar la misma dirección.

Los tipos de dirección pueden ser:

• Dirección organización. • Dirección Personal.• Dirección puesto de trabajo.• Fijar dinámicamente cualquiera de las tres.

GAP1 Página 19


Nodo mascara de edición.

Permite definir tablas de visualización estáticas (concepto de tabulaciones).

Para crear clic derecho en el nodo padre y seleccionar crear->mascara de edición.

Mascara de edición.

permite definir el ancho total de la mascara, su alineación, y las distintas líneas que la componen indicando para cada una su altura y el tamaño de cada campo.Luego en cada nodo texto dentro de el nodo mascara de edición se tiene que definir en que línea y columna muestra el texto (o variable).

GAP1 Página 20


Table Painter.

Desde el table Painter ( ) se puede definir el layout de la tabla en modo grafico.

Funciones:• dibujar líneas y columnas.• Insertar, cortar, copiar, y borras líneas.• Borrar celdas.• Cambiar el tamaño de las celdas y mover el separador de las celdas.• Separar celdas.

GAP1 Página 21


Nodo Tabla

Permite crear tablas de visualización de N columnas (fijas) y N filas (dinámicas) agregadas en el momento de ejecución.

Dentro de las características que posee esta la de poder recorrer una tabla interna dentro del mismo nodo.

Para crear hacer clic derecho en el nodo padre y seleccionar Crear->Tablas.

En la solapa tabla se ingresan las parametrizaciones generales. • Ancho Tabla. Tamaño de la tabla esperado menor o igual que la ventana en donde

esta incorporado el nodo.• Alineación Horizontal. Alineación dentro de la ventana.• TipoLinea. Se definen los distintos tipos de línea y los tamaños de las columnas

para cada uno de ellos.

Luego en la lógica del formulario se podrá definir en que columna de que tipo de línea se imprime el texto o el campo.

GAP1 Página 22


Presionando el botón Table Painter ( ) se puede definir el layout de la tabla en modo grafico de la misma manera que con el nodo mascara de edición.

Recorrido de los datos de una tabla interna desde el nodo tabla.

En el parámetro Operdo. Se asigna la tabla interna importada desde el programa impresor y definida en el área Interfase Formulario, a la tabla interna definida en el área definiciones Globales.

La tabla interna establecida en definiciones globales es la que efectivamente luego se va a utilizar para imprimir los datos en el formulario.

En línea se puede definir desde que registro a que registro se va a copiar a la tabla interna global.

En condición where se puede filtrar la tabla interna por alguna característica en particular.En criterios de clasificación se puede realizar un sort sobre la tabla interna.

Áreas de salida:• Ámbito cabecera. Todos los nodos que estén en su interior se ejecutan al comienzo

de la tabla.

GAP1 Página 23


• Área Principal. Imprime todas las líneas de información (registros) según el recorrido de la tabla interna

• Ámbito pie Pág. Se ejecuta al final de la tabla.

Nodos Cabecera y celdas.

Para indicar en que celda de que tipo de fila se va a mostrar la información se tienen que utilizar los nodos:

• cabecera. Indica que tipo de línea (definido en el nodo padre TABLA) se va a utilizar.

• Celdas. En orden descendente indica en que celda de la tabla se va imprimir los

nodos que posee en su interior.

GAP1 Página 24


Nodo Command.

Ejecuta los eventos definidos cuando se llega al nodo.

La función mas importante es la de efectuar un salto de pagina.

Nodo Sección Compleja.

Los nodos sección compleja incorporan características de otros nodos.

Este nodo puede reemplazar a los siguientes nodos:

• loop• tabla• mascara de edición

GAP1 Página 25


Nodo Loop.

Recorre los registros de una tabla interna.

Los parámetros de la solapa DATOS son iguales a los del nodo TABLA.

En la solapa Eventos se puede indicar mostrar Ámbitos cabecera y pie de paginas, y en que momento mostrarlos.

GAP1 Página 26


Nodo Alternative.

Permite la ejecución de ciertos nodos según se cumpla o no ciertas condiciones.

Si la condición es verdadera se ejecutan los nodos dentro del nodo , si la condición es falsa se ejecutan los nodos dentro del nodo .

Nodo Program Line.

Permite ingresar código Abap al formulario, ejecutándose el mismo cuando la secuencia llega al nodo.

GAP1 Página 27


En parámetros de entrada y de salida se definen las variables globales (previamente ingresadas en definiciones globales).

GAP1 Página 28


Solapa Condiciones.

En todos los nodos existe una solapa en la cual se puede setear la condición de ejecución del nodo.

Esto significa que un nodo y todos sus nodos subordinados se van a tratar solo si se cumple la condición de salida.

En caso de dejar la condición de salida vacía, el nodo se va a ejecutar siempre.

GAP1 Página 29

Se ejecuta el nodo solo si se cumple alguna de las condiciones

Se ejecuta solo si un campo tiene cierto valor


Smart Styles (estilos).

Permite crear distintos formatos de párrafos y caracteres que luego se pueden incorporar al formulario.

Se puede acceder desde la transacción SmartForms,

o directamente desde la transacción SmartStyles,

GAP1 Página 30


Formatos de Párrafo.

Permite crear nuevos párrafos para ser incorporados a los formularios o a una parte de estos.

Sangrías e interlineados.

Flujo de textos:• Conservar líneas juntas. Evita que se divida un párrafo en la pagina siguiente. Si el

párrafo no entra en la pagina actual se imprime completo en la próxima pagina.• Párrafo Sig. Misma pag. El párrafo subsiguiente al actual se edita en la misma

pagina.

Font.

GAP1 Página 31


Tabuladores.

permite definir tabuladores para los párrafos indicando el numero, posición y unidad de medida; aparte de la alineación.

Numeración y esquema.

Permite generar un esquema jerárquico de párrafos.

GAP1 Página 32


Formatos de Carácter.

Permite establecer las características de los caracteres a ser incorporados al formulario.

El código de barras se relaciona con el formato de carácter creado.

GAP1 Página 33


Modulo de Texto

Permite crear oraciones de texto prearmadas que pueden ser utilizadas en varios formularios.

Esto permite la creación de texto reutilizable.

Se accede por medio de la transacción SmartForms seleccionando la opción módulos de textos.

Luego se crea el texto reutilizable definiendo formatos de párrafo y carácter.

En la solapa Gestión se puede definir el Estilo para el modulo de texto.

Una ves terminado el modulo se graba con el botón .

GAP1 Página 34


Importación de Gráficos.

Para importar gráficos ya creados, directamente desde la PC, se debe acceder a la transacción SE78. Los formatos de gráficos soportados son: BMP y TIF.

Como resultado de la importación se carga el grafico en el sistema y se almacena en el Business Document Server (BDS).

Pasos:

Transacción SE78.

Descomprimir el Árbol:Gráficos de formulario->Archivo en servidor doc.->GRAPHICS->BMAP.

Hacer doble clic sobre BMAP.

Seleccionar el menú Grafico->importar.

Se debe ingresar el path del archivo a cargar, el nombre del archivo y el tipo (blanco/negro o color).

GAP1 Página 35


Atributos de impresión.

• Residente en memoria impresora. Cuando un grafico aparece por primera vez, se define como una macro durante el proceso de impresión y se almacena en la memoria de la impresora. Si el grafico aparece varias veces en la impresión puede ser tomado de la memoria de la impresora, reduciendo el tamaño de los archivos de impresión.

• Reservar altura automáticamente. El sistema automáticamente reserva la altura del grafico para el corte de pagina.

• Compresión. Se comprime el grafico para que ocupe menos memoria.

Para cambiar las propiedades tales como resolución, se debe hacer clic sobre el botón

Propiedades ( ).

GAP1 Página 36


Migración de Sapscript a Smart Forms

Pasos que ejecuta el sistema en la migración.

1- copia los atributos de lenguaje y opciones de salida.2- migra información de layout. Incluidas paginas, ventanas, y sus atributos y

posiciones.3- copia el texto en el formulario.4- despliega los campos de texto.5- convierte los comandos sapscript a líneas comentadas y los despliega en texto.

Lo único que no migra es el programa impresor.

GAP1 Página 37


Programa impresor.

El programa impresor para formularios Smart Forms se caracteriza por ser simple dejando la complejidad de la lógica en el mismo formulario.

La estructura generalmente es la siguiente:• definición de tipos y tablas• parámetros de selección• carga de las tablas internas a pasar al formulario• llamada a la función SSF_FUNCTION_MODULE_NAME para la obtención del

modulo de función del formulario.• Llamada del modulo de función del formulario obtenido en el paso anterior.

Integración del formulario a la aplicación.

La integración del formulario a la aplicación se realiza por medio de la llamada a dos funciones.

Por un lado se llama a la función que devuelve el modulo de función del formulario (este modulo de función se genera automáticamente al activar el formulario).

call function 'SSF_FUNCTION_MODULE_NAME' exporting formname = p_form* EL SF QUE VOY A LLAMAR* variant = ' '* direct_call = ' ' importing fm_name = fm_name* ES EL PROGRAMA GENERADO POR EL SF exceptions no_form = 1 no_function_module = 2 others = 3.

Luego se ejecuta el modulo de función obtenido en el paso anterior.

call function fm_name exporting output_options = ls_composer_param* user_settings = 'X' t_vbrk = t_vbrk t_vbrp = t_vbrp* TABLA QUE EXPORTA AL SF* importing document_output_info = exceptions formatting_error = 1 internal_error = 2 send_error = 3 user_canceled = 4 others = 5.

GAP1 Página 38


Índice:

Manual Smart Forms versión 4.7 ............................................................................................ 1 Ventajas: .............................................................................................................................. 1 Transacción SMARTFORMS. ............................................................................................ 3 Form Builder. ...................................................................................................................... 4 Parametrizaciones Globales. ............................................................................................... 5

Atributos Formulario. ...................................................................................................... 5 Interfase Formulario. ....................................................................................................... 7 Definiciones Globales. .................................................................................................... 8

Paginas y Ventanas. .......................................................................................................... 10 Paginas. ......................................................................................................................... 10 Creación de Paginas. ..................................................................................................... 10 Ventanas. ....................................................................................................................... 12 Ventana Main. ............................................................................................................... 13 Ventanas Auxiliares. ..................................................................................................... 13

Nodos. ............................................................................................................................... 14 Nodo Texto. ................................................................................................................... 14 Nodo Grafico. ................................................................................................................ 17 Nodo Dirección. ............................................................................................................ 19 Nodo mascara de edición. ............................................................................................. 20 Table Painter. ................................................................................................................ 21 Nodo Tabla .................................................................................................................... 22 Nodos Cabecera y celdas. ............................................................................................. 24 Nodo Command. ........................................................................................................... 25 Nodo Sección Compleja. ............................................................................................... 25 Nodo Loop. ................................................................................................................... 26 Nodo Alternative. .......................................................................................................... 27 Nodo Program Line. ...................................................................................................... 27 Solapa Condiciones. ...................................................................................................... 29

Smart Styles (estilos). ........................................................................................................ 30 Formatos de Párrafo. ..................................................................................................... 31 Sangrías e interlineados. ................................................................................................ 31 Font. .............................................................................................................................. 31 Tabuladores. .................................................................................................................. 32 Numeración y esquema. ................................................................................................ 32 Formatos de Carácter. ................................................................................................... 33

Modulo de Texto ............................................................................................................... 34 Importación de Gráficos. ................................................................................................... 35

Atributos de impresión. ................................................................................................. 36 Migración de Sapscript a Smart Forms ............................................................................. 37

Integración del formulario a la aplicación. .................................................................... 38

GAP1 Página 39

96861639 Manual de Smart Forms

Documents

Transcript of 96861639 Manual de Smart Forms