1.- INTRODUCCION.......................................................................................................3 1.1.- Qu es un formulario SAPSCRIPT?...................................................................3 1.2.- Arquitectura de un formulario...............................................................................4 1.3.- Mtodo de proceso de Formularios.......................................................................5 2.1.- Cabecera..............................................................................................................10 2.2.

- Formato de prrafo..............................................................................................11 2.3.- Formato de carcter.............................................................................................13 2.4.- Disposicin de pgina.........................................................................................14 2.5.- Ventanas, pginas y ventana pgina....................................................................14 SAPscript: Definition of borders, lines, and shading .................................................20 Description.............................................................................................................20 Effect......................................................................................................................20 Additional...............................................................................................................20 specifs.....................................................................................................................20 Measurements........................................................................................................20 Unit.........................................................................................................................20 Effect......................................................................................................................20 Additional...............................................................................................................20 specifs.....................................................................................................................20 Effect......................................................................................................................20 Additional...............................................................................................................20 specifs.....................................................................................................................20 4.- IMGENES...............................................................................................................23 5.- PROGRAMA DE CONTROL...................................................................................29 6.- FORMULARIOS ASIGNADOS A LOS DOCUMENTOS DE SAP.......................31 7.- OPERACIONES CON FORMULARIO...................................................................34 7.1.- Copiar formulario por mandante.........................................................................34 7.2.- Exportar un formulario a fichero.........................................................................34

1.- INTRODUCCION

1.1.- Qu es un formulario SAPSCRIPT?

Es una plantilla que simplifica el proceso de disear documentacin anexada a los documentos generados por SAP: suministrando la disposicin (por ejemplo, el tamao de la pgina) y el contenido (por ejemplo, datos de las ventas para una factura). Se necesitan formularios de SAPSCRIPT para imprimir, distribuir, o mostrar los detalles del documento creado por el sistema. Ejemplos: Pedidos de compras, Facturas, Albaranes de entrega, emisin de cheques, .

1.2.- Arquitectura de un formulario

Un formulario de SAPSCRIPTS consiste en dos componentes principales: - Disposicin: se estructura en pginas, ventanas - Contenido: es la informacin que aparece en cada ventana

1.3.- Mtodo de proceso de Formularios

Para poder extraer en SAP R/3 un formulario, se necesita: - Programa de control: que extrae la informacin de la base de datos, y realiza mediante funciones la llamada al formulario - SAPscript runtime environment: es el procesador que interpreta la plantilla de
SAPSCRIPT

Existen dos formas de extraccin de formularios: - Formularios asociados a un documento: SAP incluye en cada documento (pedido de compras, pedidos de ventas, avisos, orden,. ) la gestin de mensajes de formularios. Mediante parametrizacin se anexar a estos mensajes el programa de control y el formulario. El sistema, ya tiene una serie de programas de control y formularios estndares ya realizados. Ejemplo: pedido de compras

- Formularios no asociados a los documentos, donde se tiene que crear el programa de control y el formulario. Desde el mismo programa de control, se gestiona la salida de los formularios. Utilizaremos como ejemplo el programa de control RSTXEXP1 con el formulario S_EXAMPLE_1.

El formulario es dependiente del mandante y del idioma.

2.- FORMULARIO: Form Painter

Trasaccin de acceso a Form Painter : Tools SAPscript SE71 -Form. Para gestionar el SAPSCRIPT tenemos dos herramientas: - Form Painter: donde especificaremos la disposicin del formulario - PC Editor: donde colocaremos el contenido de las ventanas mediante cdigo especfico. Estas dos herramientas tienen dos versiones: la grfica y la Standard.

Form Painter: Standard Form Painter Grfico Para poder activar las versiones grficas, desde la primera pantalla del Form Painter: en el men Opciones

El formulario est formado por diferentes partes: Cabecera: datos de gestin y parametrizacin bsica Formato de prrafo Formato de caracteres Disposicin: ventanas, pgina, ventana por pgina Documentacin Editor de Sapscript : elemento de texto

2.1.- Cabecera
En la cabecera, se informa los datos de gestin y las parametrizaciones bsicas del formulario. En los datos de gestin, el nico dato que se puede informar es la descripcin del formulario. El resto de informacin, hace referencia a: - mandante en que se ha creado el formulario: es un objeto dependiente de mandante. - Clave de idioma: el formulario es dependiente de idioma, y cuando se accede al form painter, hay que especificar el nombre del formulario como el idioma de creacin (importante para formularios estndar y los mensajes anexos al documento)

En la parametrizacin bsica del formulario, hay que especificar: - la pgina inicial del formulario - formato de pgina: vertical o apaisado, como las dimensiones del formulario - los valores por defecto del formato de texto

2.2.- Formato de prrafo

Contiene la informacin de los diferentes formatos de texto, que se pueden utilizar en el contenido de una ventana. No todos los formatos de prrafo, se tienen que utilizar en el formulario. Se utiliza en el editor para cada lnea de contenido:

Formato de prrafo en el editor En cada prrafo se tiene que especificar: - las fuentes: tipo de letra y tamao, caractersticas (negrita, cursiva, subrayado) - tabuladores: la posicin de los tabuladores, as como su alineacin - mrgenes, alineacin y espacio entre lneas

2.3.- Formato de carcter

Es el formato de texto que se aplica no para todo un prrafo sino para un carcter. En el editor se especificar de la siguiente forma con el prrafo B. Se especificar el tipo de letra, tamao y caractersticas (negrita, cursiva y subrayado). Tambin se puede especificar si corresponde a CODIGO DE BARRAS.

2.4.- Disposicin de pgina

Si tenemos el form painter grfico, tendremos esta componente. En esta seccin, se puede: - gestionar las pginas: especificando que pgina es la siguiente - gestionar las ventanas: para la pgina declarada en la parte superior, se seleccionan las ventanas, especificando las dimensiones y la posicin en la pgina - disposicin de las ventanas: permite mover la ventana a la posicin deseada

2.5.- Ventanas, pginas y ventana pgina

En el caso de no tener el form painter grfico, aparecern tres nuevas componentes: - pgina: donde se especifican las pginas declaradas, con los mrgenes y la pgina siguiente - ventanas: se declaran las ventanas - ventana pgina: para cda pgina, se asocia las ventanas con sus dimensiones y su posicin en la pgina Una ventana, puede estar asociada a varias pginas, con diferentes dimensiones y posiciones. Pero con un nico ELEMENTO DE TEXTO (contenido de la ventana).

3.- FORMULARIO: Editor

Para cada ventana, se definen los elementos de texto (contenido del formulario). Para acceder al editor, se selecciona la ventana a tratar y se pulsa sobre el icono

Nombre de la ventana que se esta tratando

Tipo de formato de lnea

Comandos de control: literales, variables y sentencias

Cada lnea del editor, comenzar con el tipo de formato de lnea. Si abrimos la ayuda de bsqueda aparecern todos los Formatos de Prrafos creados con anterioridad. Este formato define la apariencia de la lnea ( mrgenes, tipo de letra, tabuladores,).

Los formatos comunes son los siguientes: - * prrafo por defecto, que es el formato definido en la cabecera del formulario - / avance de lnea - /: lnea de comando, sentencias de control (IF, ENDIF, ) - /* comentarios - /E elemento de texto, que son llamados mediante el programa de control En la lneas de cdigo, se puede introducir: - Literales: no van entre comillas - Variables: se introduce entre &. Ej: &date& - Comandos de control: sentencias del tipo IF, ENDIF - Cajas, lneas y sombreados: BOX, POSITION, SIZE - Imgenes: INCLUDE, BITMAT 1.-Variables smbolos del sistema &DATE&: Fecha del sistema. Se imprimir de acuerdo al tipo de SET DATE MASK definida anteriormente. &DAY& &MONTH& &YEAR& &NAME_OF_DAY& &NAME_OF_MONTH& &TIME& &HOURS& &MINUTES& &SECONDS& &PAGE& &NEXTPAGE& &DEVICE&. Tipo del dispostivo de salida (PRINTER, SCREEN, TELEX, ABAP). &SPACE& Smbolo . &ULINE& Lnea de subrayado &VLINE& Lnea vertical &SAPSCRIPT-SUBRC&. Recibe un valore despus de ejecutar un comando INCLUDE. (0 si lo encuentra, 4 si no).

 &SAPSCRIPT-DRIVER&. Nombre del dispositivo de salida (POST, HPL2, PRES). &SAPSCRIPT-FORMPAGES&. N total de pginas del form. &SAPSCRIPT_CONTER_X& (x = 09) Representan 10 variables de contador que se puede utilizar en el texto y formularios para cualquier propsito. Se puede especificar el formato de estas variables mediante: Desplazamiento &symbol+offset& Longitud de salida &symbol(length)& Omisin del signo &symbol(S)& Sacar el signo por la izquierda &symbol(<)& Sacar el signo por la derecha &symbol(>)& Omitir los ceros iniciales &symbol(Z)& Comprimir los espacios &symbol(C)& Nmero de decimales &symbol(.2)& Omitir el indicador de miles &symbol(T)& Especificar exponente &symbol(E2)& Alinear a la derecha &symbol(8R)& Rellenar de caracteres &symbol(Ff)& Suprimir valores iniciales &symbol(I)& Ignorar rutinas de converisin &symbol(K)& Cambiar valor de un contador &SAPSCRIPT_COUNTER_X(+)& Textos precedentes &pre-textsymbolpost-text& 2.- Variables smbolos de programas El programa aceptar las variables, que se hayan definido en el programa de control. En el caso de que la variable no est declarada, el valor de la variable ser inicial. 3.- Comandos de control Las sentencias que permite Sapscript sn las siguientes: NEW-PAGE. Provoca el salto automtico de pgina PROTECT ENDPROTECT. Se asegura que el texto introducido entre estos dos comandos aparezca siempre en una misma pgina. NEW-WINDOW. Llama automticamente a la siguiente ventana MAIN definida en una misma pgina. DEFINE: Permite crear una constante con un valor dado. SET DATE MASK. Define el formato de los campos fecha. /: SET DATE MASK = DD/MM/YYYY SET TIME MASK. Define el formato de los campos hora. /: SET TIME MASK = HH:MM SET COUNTRY. Define el formato de ciertos campos como el punto para los millares adaptados a un pas especfico. SET SIGN. Indica la posicin del signo. RESET. Inicializa el contador de un prrafo de numereacin. INCLUDE: Inserte el contenido de otro texto en el texto actual. /: INCLUDE ADRS_FOOTER OBJECT TEXT ID ADRS Donde ADRS_FOOTER es un texto estandar

 STYLE: Cambia el contenido del estilo actual del texto. ADDRESS - ENDADDRESS: Formatea una direccin de acuerdo con las convenciones postales del pas definido por el parmetro COUNTRY.

TOP ENDTOP.. Especifica lneas de texto que siempre quieres definir en la parte superior de la ventana MAIN. BOTTOM ENDBOTTOM. Especifica lneas de texto que siempre quieres definir en la parte inferior de la ventana MAIN. IF ENDIF. Permite especificar que lneas debera imprimirse solamente cuando se cumplan ciertas condiciones. CASE: Cubre el caso de mltiples comandos IF anidados. PERFORM. Permite llamar una rutina de un programa ABAP /: PERFORM <form> IN PROGRAM <proa> /: USING &INVAR1& /: USING &INVAR2& /: CHANGING &OUTVAR1& /: CHANGING &OUTVAR2& /: ENDPERFORM En el programa, se crear un form con las variables: FORM <form> TABLES IN_TAB STRUCTURE ITCSY OUT_TAB STRUCTURE ITCSY. .. ENDFORM. Donde la tabla IN_TAB, OUT_TAB, recogen los campos de entrada y de salida. PRINT-CONTROL: Llama directamente ciertas funciones de la impresora. BOX, POSITION, LINE: Dibuja lneas y cajas.
BOX XPOS '2.5' CM WIDTH 7 CM HEIGHT 10 CM FRAME 12 TW. BOX XPOS '7.5' CM WIDTH 7 CM HEIGHT 10 CM FRAME 10 TW.

/: /:

SAPscript: Definition of borders, lines, and shading

Description
In SAPscript Release 3.0A, text commands were introduced for drawing borders, lines, and shading. Parameters can be set for position, size, border thickness, and shading. Within a layout set, individual windows or specific text passages within a window can therefore be output with a border or shading. The SAP printer drivers based on page printers (HP Laserjet driver, Postscript driver, Kyocera Prescribe driver) convert this command during output. All other line printers or page printers not supported in the standard version ignore these commands. This printout can be displayed in the SAPscript previewer (30A: UNIX Motif , 30B: DOS, NT WINDOWS). How are the borders defined in the layout set? Using the following new text commands: 1. /: BOX [XPOS] [YPOS] [WIDTH] [HEIGHT] [FRAME] [INTENSITY] 2. /: POSITION [XORIGIN] [YORIGIN] [WINDOW] [PAGE] 3. /: SIZE [WIDTH] [HEIGHT] [WINDOW] [PAGE] 1. /: BOX [XPOS] [YPOS] [WIDTH] [HEIGHT] [FRAME] [INTENSITY]

Effect
Draws a box at this position with the specified size.

Additional
XPOS, YPOS, WIDTH, HEIGHT and FRAME always require

specifs.
a measurement and a unit of measurement to be specified. The additional specification INTENSITY requires the specification of a percent number between 0 and 100. XPOS, YPOS Upper left corner of box, based on the values from the POSITION command. Default: Values from POSITION command The following internal calculation rule is used to determine the absolute output position of a box on the page: X(abs) = XORIGIN + XPOS Y(abs) = YORIGIN + YPOS WIDTH Width of box Default: WIDTH value from SIZE command HEIGHT Height of box Default: HEIGHT value from SIZE command FRAME Frame thickness Default: 0 (no frame line)

 HEX ENDHEX. Enva a la impresora rdenes en el lenguaje que utiliza la impresora. SUMMING. Acumula un valor total para un smbolo de programa. Las sentencias no finalizan con punto, y el formato de lnea es /: Textos estndar El editor puede hacer referencia a un texto estndar ya definido (cdigo independiente de formulario). /: INCLUDE ADRS_FOOTER OBJECT TEXT ID ADRS El texto estndar ADRS_FOOTER, se crea desde la misma transaccin SE71

Donde se accede al editor

4.- IMGENES
En los formularios, se pueden incorporar imgenes. Para ello se tienen que introducir el fichero dentro del sistema. Transaccin de gestin de imgenes para SAPSCRIPT : SE78 Funcin Grfica Existe dos mtodos: - Imagen en el servidor - conversin en texto estndar 4.1.- Imgenes grfico en tramas Objeto Grfico: GRAPHICS ID Grfico: BMAP

Las propiedades del fichero

Visualizar el fichero:

Para crear una nueva imagen:

Los formatos permitidos del fichero de la imagen son: *.bmp (Window Bitmap) *.tif, *.tiff (Tagged Image File Format) En el editor del formulario, se utilizar la sentencia: /: BITMAP ENJOY OBJECT GRAPHICS ID BMAP TYPE BCOL o utilizando el asistente en el editor

Se puede incluir la Resolucin (para aumentar o disminuir la imagen) 4.2.- Imgenes texto estndar Objeto Grfico: TEXT ID Grfico: ST

Tambin se puede acceder a visualizar las propiedades (no son modificables) y la imagen (no todos los textos estndar son del tipo imagen, por lo que no se visualizarn). Para crear un texto estndar

donde se debe incluir: ruta del fichero (formato *tif) BMON o BCOL Resolucin Nombre del Texto Estndar Idioma (es dependiente de idioma) En el editor del formulario, se utilizar la sentencia: /: INCLUDE BIR_LOGO OBJECT TEXT ID ST LANGUAGE ES o utilizando el asistente en el editor

5.- PROGRAMA DE CONTROL

Es un programa de SAP, donde se realizan las siguientes funciones: - declaracin de variables - bsqueda de datos a la BD - llamada del formulario - control del disposicin de salida del formulario: impresin, correo electrnico, fax, por pantalla, salida inmediata, - llamada de los diferentes elementos del formularios Utiliza funciones para realizar todas estas tareas: - Llamada al formulario, idioma y opciones de salida:
CALL FUNCTION 'OPEN_FORM' EXPORTING DEVICE = 'PRINTER' FORM = 'S_EXAMPLE_1' OPTIONS = ITCPO DIALOG = 'X' EXCEPTIONS CANCELED =1 DEVICE =2 FORM =3 OPTIONS =4 UNCLOSED =5 OTHERS = 6.

La estructura ITCPO, determina las caractersticas de salida del formulario: cantidad de copias, salida inmediata, El campo DIALOG, implica si aparece la pantalla de dilogo de caractersticas de salida

- Cerrar el formulario Si se utiliza la funcin OPEN_FORM, se necesita cerrar el formulario con la funcin

CALL FUNCTION 'CLOSE_FORM' EXCEPTIONS OTHERS = 1. IF SY-SUBRC <> 0. WRITE 'Error in close_form'(007). EXIT. ENDIF.

- Empezar y cerrar formulario:

CALL FUNCTION 'START_FORM' EXCEPTIONS OTHERS = 1. CALL FUNCTION 'END_FORM' EXCEPTIONS OTHERS = 1. IF SY-SUBRC <> 0. WRITE 'Error in end_form'(006). EXIT. ENDIF.

- Llamada a elementos de texto de una ventana

CALL FUNCTION 'WRITE_FORM' EXPORTING ELEMENT = 'HEADING' FUNCTION = 'SET' TYPE = 'TOP' WINDOW = 'MAIN' EXCEPTIONS OTHERS = 1. CALL FUNCTION 'WRITE_FORM' EXPORTING ELEMENT = 'BOOKING' FUNCTION = 'SET' TYPE = 'BODY' WINDOW = 'MAIN' EXCEPTIONS OTHERS = 1.

6.- FORMULARIOS ASIGNADOS A LOS DOCUMENTOS DE SAP

Los documentos de SAP (pedidos de compras, contratos, pedidos de ventas, entrega, avisos, ....) tienen una opcin de salida de documento para poderlos gestionar. Ejemplo: pedido de compras

Los documentos de SAP, tienen asociados MENSAJES de IMPRESIN, donde se especifican las caractersticas: - mensaje - mtodo de envio: externo-mail, fax, impresin. - idioma del formulario asociado - forma de gestin: inmediato, o mediante programa de impresin. Todas estas caractersticas, vienen por defecto con el mensaje de impresin. El mensaje de impresin, se debe parametrizar:

En el mensaje se parametriza el programa de control y el formulario asociado:

7.- OPERACIONES CON FORMULARIO

7.1.- Copiar formulario por mandante
Los formularios como son dependientes de mandante, se puede copiar de un mandante a otro:

7.2.- Exportar un formulario a fichero

Se puede exportar el contenido de un formulario a un fichero, para ello hay que utilizar el programa RSTXSCRP