Manual Smart Forms 4.

Manual Smart Forms versin 4.7

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

Ventajas:
* Creacin y mantenimiento de formularios en tiempos mucho mas cortos * Adaptacin de formularios sin ningn tipo de conocimiento de programacin * Interfase de usuario enteramente grafica * Publicacin en web usando salida XML * Herramientas de migracin desde sapscript * Salida por impresora, fax, mail,o internet * Eliminacin 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 lgica puede estar dentro del smart form; esto es lo que lo hace inteligente.

Programa Impresor Lgica Programa Impresor

Sapscript

Formulario

Smart Form Logica

Formulario

El programa impresor solo pasa los datos, luego las condiciones, el filtrado de datos, ordenamiento, etc; se realiza a travs de la lgica del smart form.

GAP1

Pgina 1

Manual Smart Forms 4.7

GAP1

Pgina 2

Manual Smart Forms 4.7

Transaccin SMARTFORMS.
La creacin y modificacin de todo formulario Smart Form, Estilo y modulo de texto se realiza por medio de la transaccin SMARTFORMS.

Con Con Con

se puede renombrar el objeto. se borra el objeto seleccionado. Se verifica el formulario.

A su ves se pueden realizar copias de formularios, estilos y mdulos de texto presionando el botn e ingresando posteriormente el nombre del nuevo Objeto.

GAP1

Pgina 3

Manual Smart Forms 4.7

Form Builder.
Desde el form builder se crean / modifican todas las caractersticas 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. Tambin 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 caractersticas generales del formulario y particulares de cada nodo. Form Painter. Se utiliza para disear el layout del formulario. Se pueden incorporar ventanas y grficos determinando sus posiciones y eligiendo sus tamaos.

Navigation Menu

Maintenance Menu

Form Painter

GAP1

Pgina 4

Manual Smart Forms 4.7

La lgica 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, grficos, etc.

Parametrizaciones Globales.
Dentro de esta rea se definen caractersticas generales para todo el formulario como ser tamao 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 lneas por pulgadas Estilo por default Formato de salida Modo de salida Dispositivo de salida

GAP1

Pgina 5

Manual Smart Forms 4.7

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 tamaos 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 estndar. Salida XSF. (idioma basado en el XML) Salida XSF + HTML. (se generan datos en HTML que se pueden enviar a un browser para la visualizacin.

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. APLICACIN. Los datos se devuelven a la aplicacin 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

Pgina 6

Manual Smart Forms 4.7

Interfase Formulario.
Se define en import o tablas las tablas internas que se utilizan en el formulario. Nota importante: por una cuestin de funcionamiento interno el tipo referencia de las tablas que se importan debe ser de un tipo definido por el usuario con la transaccin SE11. En la interfase Formulario se definen todos los argumentos ya sean de salida (EXPORT) como de entrada (IMPORT , TABLAS).

Tipo definido por el usuario

La tipificacin puede ser una de los siguientes:

GAP1

Pgina 7

Manual Smart Forms 4.7

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: estndar 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 Pgina 8

Manual Smart Forms 4.7

En la solapa Inicializacin se puede ingresar cdigo 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 Parmetros de entrada y parmetros de salida segn corresponda. En la solapa Rutinas Form se ingresan en cdigo ABAP todos los perform a ser utilizados en el formulario.

GAP1

Pgina 9

Manual Smart Forms 4.7

Paginas y Ventanas.

Paginas.
Creacin de Paginas. La creacin de nuevas paginas se realiza haciendo clic con el botn derecho del mouse en el rbol de navegacin. Del men que se despliega seleccionar Crear->Pagina.

Definicin de caractersticas.

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 ejecucin del contador. GAP1 Pgina 10

Manual Smart Forms 4.7

Opciones de Salida. En esta solapa se definen los formatos de las paginas (vertical, apaisado) y los atributos de impresin.

Fondo Se puede definir la imagen de fondo y sus caractersticas en esta solapa

GAP1

Pgina 11

Manual Smart Forms 4.7

Ventanas.
Los formularios Smart Form estn divididos en ventanas, cada una de estas se puede manejar en forma independiente siendo la nica condicin de que solo exista una ventana Main por pagina. Al layout y sus correspondientes ventanas se accede presionando el botn FORM PAINTER ( ).

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

GAP1

Pgina 12

Manual Smart Forms 4.7

Tambin se pueden cambiar la ubicacin y el tamao de cada ventana desde el mismo Form Painter. Ventana Main. Dentro de cada pagina es necesaria la inclusin de una y solo una ventana principal o MAIN.

En esta ventana se incorpora el ncleo 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 navegacin.

GAP1

Pgina 13

Manual Smart Forms 4.7

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

Pgina 14

Manual Smart Forms 4.7

Ingreso de caractersticas.

Texto Literal Campos y variables Tipo texto. elemento de texto. modulo de texto. (SE32) texto include. (desde sapscript text) Inicio. prrafo nuevo. (el texto se aade en un prrafo nuevo) lnea nueva. (el texto se aade en una lnea nueva) aadir directamente. (el texto se aade directamente) Formato de prrafos y caracteres.

los prrafos y caracteres a seleccionar dependen del estilo seteado.

GAP1

Pgina 15

Manual Smart Forms 4.7

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

Ingreso al editor de texto. Para ingresar al editor de texto hacer clic en el botn Editor txt ( ).

GAP1

Pgina 16

Manual Smart Forms 4.7

para ingresar campos presionar el botn y luego ingresar el campo entre signos &.

Con el botn

se borra un campo seleccionado y con el botn

se modifica.

Nodo Grafico.
Permite la visualizacin de grficos, previamente cargados en sap, en las paginas del formulario. Creacin de un nodo grafico en el formulario. Realizar clic derecho en la pagina en la cual quiero crear el nodo grafico y seleccionar Crear->funcin Grafica.

Propiedades Generales.

GAP1

Pgina 17

Manual Smart Forms 4.7

Identificacin del grafico en sap Modo de visualizacin

Opciones de Salida. En opciones de salida se definen la posicin, tamao, marcos y sombreados del grafico.

GAP1

Pgina 18

Manual Smart Forms 4.7

Nodo Direccin.
Permite la visualizacin de direcciones previamente cargadas en sap en los formularios. Creacin. En el lugar en el que se quiere ingresar el nodo direccin hacer clic derecho y seleccionar crear->direccin.

Propiedades Generales.

Pasndole una variable al numero de direccin la informacin se obtiene de manera dinmica. En caso de poner un valor fijo siempre se va a mostrar la misma direccin. Los tipos de direccin pueden ser: Direccin organizacin. Direccin Personal. Direccin puesto de trabajo. Fijar dinmicamente cualquiera de las tres.

GAP1

Pgina 19

Manual Smart Forms 4.7

Nodo mascara de edicin.
Permite definir tablas de visualizacin estticas (concepto de tabulaciones). Para crear clic derecho en el nodo padre y seleccionar crear->mascara de edicin.

Mascara de edicin.

permite definir el ancho total de la mascara, su alineacin, y las distintas lneas que la componen indicando para cada una su altura y el tamao de cada campo. Luego en cada nodo texto dentro de el nodo mascara de edicin se tiene que definir en que lnea y columna muestra el texto (o variable).

GAP1

Pgina 20

Manual Smart Forms 4.7

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

Funciones: dibujar lneas y columnas. Insertar, cortar, copiar, y borras lneas. Borrar celdas. Cambiar el tamao de las celdas y mover el separador de las celdas. Separar celdas.

GAP1

Pgina 21

Manual Smart Forms 4.7

Nodo Tabla
Permite crear tablas de visualizacin de N columnas (fijas) y N filas (dinmicas) agregadas en el momento de ejecucin. Dentro de las caractersticas 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. Tamao de la tabla esperado menor o igual que la ventana en donde esta incorporado el nodo. Alineacin Horizontal. Alineacin dentro de la ventana. TipoLinea. Se definen los distintos tipos de lnea y los tamaos de las columnas para cada uno de ellos. Luego en la lgica del formulario se podr definir en que columna de que tipo de lnea se imprime el texto o el campo.

GAP1

Pgina 22

Manual Smart Forms 4.7

Presionando el botn Table Painter ( ) se puede definir el layout de la tabla en modo grafico de la misma manera que con el nodo mascara de edicin. Recorrido de los datos de una tabla interna desde el nodo tabla.

En el parmetro 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 lnea se puede definir desde que registro a que registro se va a copiar a la tabla interna global. En condicin where se puede filtrar la tabla interna por alguna caracterstica en particular. En criterios de clasificacin se puede realizar un sort sobre la tabla interna. reas de salida: mbito cabecera. Todos los nodos que estn en su interior se ejecutan al comienzo de la tabla.

GAP1

Pgina 23

Manual Smart Forms 4.7

rea Principal. Imprime todas las lneas de informacin (registros) segn el recorrido de la tabla interna mbito pie Pg. 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 informacin se tienen que utilizar los nodos: cabecera. Indica que tipo de lnea (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

Pgina 24

Manual Smart Forms 4.7

Nodo Command.
Ejecuta los eventos definidos cuando se llega al nodo.

La funcin mas importante es la de efectuar un salto de pagina.

Nodo Seccin Compleja.

Los nodos seccin compleja incorporan caractersticas de otros nodos. Este nodo puede reemplazar a los siguientes nodos: loop tabla mascara de edicin

GAP1

Pgina 25

Manual Smart Forms 4.7

Nodo Loop.
Recorre los registros de una tabla interna. Los parmetros 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

Pgina 26

Manual Smart Forms 4.7

Nodo Alternative.
Permite la ejecucin de ciertos nodos segn se cumpla o no ciertas condiciones.

Si la condicin es verdadera se ejecutan los nodos dentro del nodo es falsa se ejecutan los nodos dentro del nodo .

, si la condicin

Nodo Program Line.

Permite ingresar cdigo Abap al formulario, ejecutndose el mismo cuando la secuencia llega al nodo.

GAP1

Pgina 27

Manual Smart Forms 4.7

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

GAP1

Pgina 28

Manual Smart Forms 4.7

Solapa Condiciones.
En todos los nodos existe una solapa en la cual se puede setear la condicin de ejecucin del nodo. Esto significa que un nodo y todos sus nodos subordinados se van a tratar solo si se cumple la condicin de salida. En caso de dejar la condicin de salida vaca, el nodo se va a ejecutar siempre.

Se ejecuta solo si un campo tiene cierto valor

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

GAP1

Pgina 29

Manual Smart Forms 4.7

Smart Styles (estilos).
Permite crear distintos formatos de prrafos y caracteres que luego se pueden incorporar al formulario. Se puede acceder desde la transaccin SmartForms,

o directamente desde la transaccin SmartStyles,

GAP1

Pgina 30

Manual Smart Forms 4.7

Formatos de Prrafo.
Permite crear nuevos prrafos para ser incorporados a los formularios o a una parte de estos. Sangras e interlineados.

Flujo de textos: Conservar lneas juntas. Evita que se divida un prrafo en la pagina siguiente. Si el prrafo no entra en la pagina actual se imprime completo en la prxima pagina. Prrafo Sig. Misma pag. El prrafo subsiguiente al actual se edita en la misma pagina. Font.

GAP1

Pgina 31

Manual Smart Forms 4.7

Tabuladores.

permite definir tabuladores para los prrafos indicando el numero, posicin y unidad de medida; aparte de la alineacin.

Numeracin y esquema.

Permite generar un esquema jerrquico de prrafos.

GAP1

Pgina 32

Manual Smart Forms 4.7

Formatos de Carcter.
Permite establecer las caractersticas de los caracteres a ser incorporados al formulario.

El cdigo de barras se relaciona con el formato de carcter creado.

GAP1

Pgina 33

Manual Smart Forms 4.7

Modulo de Texto
Permite crear oraciones de texto prearmadas que pueden ser utilizadas en varios formularios. Esto permite la creacin de texto reutilizable. Se accede por medio de la transaccin SmartForms seleccionando la opcin mdulos de textos.

Luego se crea el texto reutilizable definiendo formatos de prrafo y carcter.

En la solapa Gestin se puede definir el Estilo para el modulo de texto.

Una ves terminado el modulo se graba con el botn

GAP1

Pgina 34

Manual Smart Forms 4.7

Importacin de Grficos.
Para importar grficos ya creados, directamente desde la PC, se debe acceder a la transaccin SE78. Los formatos de grficos soportados son: BMP y TIF. Como resultado de la importacin se carga el grafico en el sistema y se almacena en el Business Document Server (BDS). Pasos: Transaccin SE78.

Descomprimir el rbol: Grficos 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

Pgina 35

Manual Smart Forms 4.7

Atributos de impresin.
Residente en memoria impresora. Cuando un grafico aparece por primera vez, se define como una macro durante el proceso de impresin y se almacena en la memoria de la impresora. Si el grafico aparece varias veces en la impresin puede ser tomado de la memoria de la impresora, reduciendo el tamao de los archivos de impresin. Reservar altura automticamente. El sistema automticamente reserva la altura del grafico para el corte de pagina. Compresin. Se comprime el grafico para que ocupe menos memoria.

Para cambiar las propiedades tales como resolucin, se debe hacer clic sobre el botn Propiedades ( ).

GAP1

Pgina 36

Manual Smart Forms 4.7

Migracin de Sapscript a Smart Forms
Pasos que ejecuta el sistema en la migracin. 1- copia los atributos de lenguaje y opciones de salida. 2- migra informacin 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 lneas comentadas y los despliega en texto. Lo nico que no migra es el programa impresor.

GAP1

Pgina 37

Manual Smart Forms 4.7

Programa impresor.
El programa impresor para formularios Smart Forms se caracteriza por ser simple dejando la complejidad de la lgica en el mismo formulario. La estructura generalmente es la siguiente: definicin de tipos y tablas parmetros de seleccin carga de las tablas internas a pasar al formulario llamada a la funcin SSF_FUNCTION_MODULE_NAME para la obtencin del modulo de funcin del formulario. Llamada del modulo de funcin del formulario obtenido en el paso anterior.

Integracin del formulario a la aplicacin.

La integracin del formulario a la aplicacin se realiza por medio de la llamada a dos funciones. Por un lado se llama a la funcin que devuelve el modulo de funcin del formulario (este modulo de funcin se genera automticamente 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 funcin 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

Pgina 38

Manual Smart Forms 4.7

ndice:
Manual Smart Forms versin 4.7............................................................................................1 Ventajas:..............................................................................................................................1 Transaccin SMARTFORMS.............................................................................................3 Form Builder.......................................................................................................................4 Parametrizaciones Globales................................................................................................5 Atributos Formulario.......................................................................................................5 Interfase Formulario........................................................................................................7 Definiciones Globales.....................................................................................................8 Paginas y Ventanas...........................................................................................................10 Paginas..........................................................................................................................10 Creacin de Paginas......................................................................................................10 Ventanas........................................................................................................................12 Ventana Main................................................................................................................13 Ventanas Auxiliares......................................................................................................13 Nodos................................................................................................................................14 Nodo Texto....................................................................................................................14 Nodo Grafico.................................................................................................................17 Nodo Direccin.............................................................................................................19 Nodo mascara de edicin..............................................................................................20 Table Painter.................................................................................................................21 Nodo Tabla....................................................................................................................22 Nodos Cabecera y celdas..............................................................................................24 Nodo Command............................................................................................................25 Nodo Seccin Compleja................................................................................................25 Nodo Loop....................................................................................................................26 Nodo Alternative...........................................................................................................27 Nodo Program Line.......................................................................................................27 Solapa Condiciones.......................................................................................................29 Smart Styles (estilos).........................................................................................................30 Formatos de Prrafo......................................................................................................31 Sangras e interlineados.................................................................................................31 Font...............................................................................................................................31 Tabuladores...................................................................................................................32 Numeracin y esquema.................................................................................................32 Formatos de Carcter....................................................................................................33 Modulo de Texto...............................................................................................................34 Importacin de Grficos....................................................................................................35 Atributos de impresin..................................................................................................36 Migracin de Sapscript a Smart Forms.............................................................................37 Integracin del formulario a la aplicacin.....................................................................38

GAP1

Pgina 39