MANUALES Y TUTORIALES WWW.MUNDOSAP.

COM

Se accede a la edicin de formularios a travs de Herramientas -> Tratamientos de textos -> Formularios o directamente mediante la transaccin SE71

Desde esta pantalla podemos crear un nuevo formulario, editar uno ya existente o modificarlo.

MANUALES Y TUTORIALES WWW.MUNDOSAP.COM

MANUALES Y TUTORIALES WWW.MUNDOSAP.COM

Un formulario est formado por varias partes.

CABECERA
Una cabecera en la que se definen los datos generales del formulario como es el nombre, la descripcin, el formato de pgina, el tipo de letra por defecto, etc

MANUALES Y TUTORIALES WWW.MUNDOSAP.COM

PARRAFOS
Los prrafos, que son las definiciones de formatos de prrafo en el que definiremos sus caractersticas, divididas en: atributos estndar, tipo de letra, tabulaciones y esquema.

Atributos estndar son la descripcin del prrafo, 2 letras de identificacin que posteriormente nos servirn para utilizarlo, mrgenes, tipos de interlineado

Fuentes. Aqu definiremos el tipo de fuente asociado al prrafo, as como sus atributos, tales como tamao, negrita, cursiva

MANUALES Y TUTORIALES WWW.MUNDOSAP.COM

Tabuladores. Aqu se definen las posiciones de tabulacin que necesitemos para cada prrafo. Le deberemos indicar una posicin, ya se en centmetros (CM), caracteres (CH), milmetros (MM), puntos (PT) y un tipo de alineacin: izquierda (LEFT), derecha (RIGHT), centrado (CENTER), al signo(SIGN) o a la coma decimal (DECIMAL).

Esquema: Es posible definir numeracin y marcas automticas de forma que podamos estructurar texto en captulos, subcapitulos y secciones.

MANUALES Y TUTORIALES WWW.MUNDOSAP.COM

STRINGS
Caracteres. Dentro de cualquier prrafo es posible cambiar el tipo de letra para la parte de la lnea que deseemos. Esto podemos hacerlo desde la opcin STRINGS. Deberemos introducir un cdigo de 2 posiciones, una descripcin, el tipo de letra que deseemos, sus atributos, as como caractersticas especiales como crear cdigos de barra, impedir que la lnea se parta en 2 cuando alcanza final de lnea, esconder el texto en la salida impresa, crear un subndice o superndice.

MANUALES Y TUTORIALES WWW.MUNDOSAP.COM

VENTANAS
Las ventanas representan reas que se posicionarn sobre las pginas.

Hay 3 tipos de ventanas: MAIN: Es la ventana principal en la que se escribir el texto variable, como podra ser el cuerpo de una carta. Esta ventana puede extenderse a ms de una pgina. VAR: Es una ventana cuyo contenido puede variar. Ests ventanas deben definirse en cada pgina en que deban aparecer. CONST: Define una ventana cuyo contenido no cambia.

MANUALES Y TUTORIALES WWW.MUNDOSAP.COM

PGINAS
Para cada formulario se ha de definir al menos una pgina. En esta apartado daremos una descripcin a la pgina, indicaremos cual es la siguiente pgina a continuacin y cmo se actualizar el contador de pginas.

MANUALES Y TUTORIALES WWW.MUNDOSAP.COM

VENTANA PGINA
En este apartado las ventanas son asignadas a las pginas. Se debe especificar la posicin y tamao de la ventana en cada pgina.

MANUALES Y TUTORIALES WWW.MUNDOSAP.COM

ELEMENTOS DE TEXTO
Los elementos de texto se definen para cada ventana. El programa de impresin accede a los elementos de texto por nombre, los formatea e imprime en la ventana correspondiente. Si entramos al editor de texto, seleccionando primero una ventana y pulsando luego en Elementos de texto veremos la siguiente pantalla: Nombre de la ventana en la que se define el elemento de texto.

Tipo de prrafo

10

MANUALES Y TUTORIALES WWW.MUNDOSAP.COM

FORMULARIO DE EJEMPLO
Formulario Z_PRUEBA

Mandante Idioma Idioma original a traducir Status Clase desarrollo Autor Fecha Hora Release Significado

011 S S s activo $TMP Los objetos temporales no se transportan nunca ! Modificado por Fecha Hora Release ES000000 17.05.1999 15:54:07 31H

ES000000 13.05.1999 11:25:39 31H prueba

Atributos std. Pgina inicial Prrafo defecto Tabulaciones Formato pgina Formato hoja Lneas/pulg. Carcter/pulg. Atributos font Familia fonts Altura fonta Negrita Cursiva Subrayado

P N 1,00 CM DINA4 Formato 6,00 10,00

COURIER 12,0 Pun no no no

Carcteres

Atributos

Cursiva Atributos font Cursiva Negrita Atributos font Negrita

Prrafos

Atributos

CO

Columnas Atributos std. Interlineado Alineacin Atributos font Familia fonts Altura fonta

1.00 LN alin. izq. COURIER 12,0 Punto

11

MANUALES Y TUTORIALES WWW.MUNDOSAP.COM

Tabuladores 1.00 CM 9.00 CM N Prrafo normal Atributos std. Interlineado Alineacin Atributos font Familia fonts Altura fonta Tabuladores 3.00 CM 12.00 CM Prrafo de pie Atributos std. Interlineado Alineacin Atributos font Familia fonts Altura fonta Cursiva Ttulo Atributos std. Interlineado Alineacin Atributos font Familia fonts Altura fonta Negrita

alineacin izq. alineacin izq.

1.00 LN alin. izq. COURIER 12,0 Punto alineacin izq. alineacin izq.

PI

1.00 LN centrado HELVE 6,0 Punto s

TI

1.00 LN centrado HELVE 14,0 Punto s

Ventanas

Atributos

CABECERA

Encabezado de pgina Tipo ventana VAR Direccin Tipo ventana Ventana princ. Tipo ventana Pie de pgina Tipo ventana

DIRECCIO

VAR

MAIN

MAIN

PIE

VAR

Pginas

Atributos

Primera pgina Cont. pgs. Modo Tipo numeracin Ventana pgina MAIN

INC cifras rabes Margen izq. Margen superior Ancho ventana Altura ventana 3.00 8.00 17.00 15.00 CM CM CM CM

12

MANUALES Y TUTORIALES WWW.MUNDOSAP.COM

CABECERA

DIRECCIO

PIE

Margen izq. Margen superior Ancho ventana Altura ventana Margen izq. Margen superior Ancho ventana Altura ventana Margen izq. Margen superior Ancho ventana Altura ventana

2.00 2.00 18.00 3.00 12.00 5.00 8.00 3.00 2.00 26.00 18.00 1.00

CM CM CM CM CM CM CM CM CM CM CM CM

Elementos texto para ventanas:

CABECERA Elemento CABECERA TI FORMULARIO DE PRUEBA Elemento LOGO /: INCLUDE 'Z_LOGO_EMPRESA' OBJECT TEXT ID ST PARAGRAPH FT

DIRECCIO N N N <N>Direccin:</> &CALLE& &CIUDAD&

MAIN Elemento ITEM_HEADER CO <N>,,COLUMNA 1,,COLUMNA 2</> Elemento ITEM_LINE CO ,,&COL1&,,&COL2&

PIE PI Pgina &PAGE&

13

MANUALES Y TUTORIALES WWW.MUNDOSAP.COM

PROGRAMA DE IMPRESIN DEL FORMULARIO

REPORT ZFORM. TABLES: ITCPO. "SAPscript Salida interfase

SELECTION-SCREEN BEGIN OF BLOCK BLK_PAR WITH FRAME. SELECTION-SCREEN SKIP. PARAMETERS P_IDIOMA LIKE RSSCF-TDSPRAS DEFAULT 'S'. PARAMETERS P_GRAF AS CHECKBOX. SELECTION-SCREEN END OF BLOCK BLK_PAR. * Variables para comunicarnos con el formulario DATA: CALLE(40), CIUDAD(20), COL1(20), COL2(20). * Configuracin de la impresora ITCPO-TDPAGESLCT = SPACE. ITCPO-TDNEWID = 'X'. ITCPO-TDCOPIES = 1. ITCPO-TDDEST = 'ORG1'. ITCPO-TDPREVIEW = SPACE. ITCPO-TDCOVER = SPACE. ITCPO-TDIMMED = 'X'. ITCPO-TDDELETE = 'X'. * Abrimos el formulario CALL FUNCTION 'OPEN_FORM' EXPORTING FORM = 'Z_PRUEBA' LANGUAGE = P_IDIOMA OPTIONS = ITCPO DEVICE = 'PRINTER' DIALOG = 'X' EXCEPTIONS OTHERS = 1. IF SY-SUBRC NE 0. WRITE /'error al abrir formulario'. STOP. ENDIF. * Imprimimos la ventana CABECERA CALL FUNCTION 'WRITE_FORM' EXPORTING WINDOW = 'CABECERA' ELEMENT = 'CABECERA' EXCEPTIONS OTHERS = 1. IF P_GRAF = 'X'. CALL FUNCTION 'WRITE_FORM' EXPORTING WINDOW = 'CABECERA' ELEMENT = 'LOGO' EXCEPTIONS OTHERS = 1. ENDIF. IF SY-SUBRC NE 0. WRITE /'error al escribir en ventana CABECERA'. STOP. ENDIF.

"Todas las pginas "Crea nuevo spool "1 copia "Nombre de la impresora "No Preview "No portada "Imprime inmediatamente "Borra despus de imprimir

14

MANUALES Y TUTORIALES WWW.MUNDOSAP.COM

* Imprimimos la ventana direccin CALLE = 'C/ ALBOROYA, S/N'. CIUDAD = 'VALENCIA'. CALL FUNCTION 'WRITE_FORM' EXPORTING WINDOW = 'DIRECCIO' EXCEPTIONS OTHERS = 1. IF SY-SUBRC NE 0. WRITE /'error al escribir en ventana DIRECCION'. STOP. ENDIF. * Imprimos la ventana principal CALL FUNCTION 'WRITE_FORM' EXPORTING WINDOW = 'MAIN' ELEMENT = 'ITEM_HEADER' EXCEPTIONS OTHERS = 1. DO 10 TIMES. COL1 = SY-INDEX. COL2 = 10 + SY-INDEX. CALL FUNCTION 'WRITE_FORM' EXPORTING WINDOW = 'MAIN' ELEMENT = 'ITEM_LINE' EXCEPTIONS OTHERS = 1. ENDDO. IF SY-SUBRC NE 0. WRITE /'error al escribir en ventana MAIN'. STOP. ENDIF. * Imprimos el pie de pgina CALL FUNCTION 'WRITE_FORM' EXPORTING WINDOW = 'PIE' EXCEPTIONS OTHERS = 1. IF SY-SUBRC NE 0. WRITE /'error al escribir en ventana PIE'. STOP. ENDIF. CHECK SY-SUBRC = 0. CALL FUNCTION 'CLOSE_FORM'.

15

MANUALES Y TUTORIALES WWW.MUNDOSAP.COM

FORMULARIOS EN VARIOS IDIOMAS

Una vez tenemos creado el formulario en un idioma padre, podemos crearlo en otros idiomas. Para ello en la pantalla de mantenimiento de formularios, seleccionamos el formulario que acabamos de crear, seleccionamos el nuevo lenguaje del formulario y seleccionamos crear. Veremos que trabajamos con una copia del formulario anterior en el que lo nico que deberemos hacer ser traducir los textos y adaptar el formulario, si fuera necesario, a las peculiaridades del nuevo idioma. Para llamar al formulario en distintos idiomas se realiza mediante la funcin de abrir formulario, indicando el idioma requerido. Si el formulario no existiera en ese idioma, se abrir el formulario en el idioma padre.
CALL FUNCTION 'OPEN_FORM' EXPORTING FORM = 'Z_PRUEBA' LANGUAGE = P_IDIOMA OPTIONS = ITCPO DEVICE = 'PRINTER' DIALOG = 'X' EXCEPTIONS OTHERS = 1.

16

MANUALES Y TUTORIALES WWW.MUNDOSAP.COM

INCLUIR GRFICOS
Para incluir grficos en un formulario, primero hay que grabarlo en SAP en forma de elemento de texto. Esto se puede realizar mediante el report RSTXLDMC que convierte un fichero en formato TIFF a elemento de texto que posteriormente es posible incorporar a un formulario con una instruccin como esta: INCLUDE 'Z_LOGO_EMPRESA' OBJECT TEXT ID ST PARAGRAPH FT Donde Z_LOGO_EMPRESA es un elemento de texto que hemos obtenido al convertir el logotipo de Lladr mediante el report mencionado.

17

MANUALES Y TUTORIALES WWW.MUNDOSAP.COM

CAJAS, LINEAS Y SOMBREADOS

Se pueden dibujar cajas y lneas en SAPScript mediante los siguiente comandos: BOX: Dbuja una caja o una lnea. POSITION: Especfica el punto inicial de una caja o lnea SIZE: Especifica la anchura o altura de una caja. Ejemplo: Creamos una nueva ventana de tipo CONST de identicas proporciones que la ventana MAIN que dibuje una caja que rodee las dos columnas de la ventana MAIN del ejemplo.
/: /: BOX XPOS '0.5' CM WIDTH 8 CM HEIGHT 15 CM FRAME 10 TW. BOX XPOS '8.5' CM WIDTH 8 CM HEIGHT 15 CM FRAME 10 TW.

18

MANUALES Y TUTORIALES WWW.MUNDOSAP.COM

COMANDOS DE CONTROL
SAPScript dispone de una serie de comandos que permiten obtener un control total sobre el texto. Estos comandos son introducidos en el editor de textos igual que una lnea normal excepto que el deberemos seleccionar el prrafo /: Estos comandos son: 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 TIME MASK. Define el formato de los campos hora. 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. STYLE: Cambia el contenido del estilo actual deltexto. 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.

19

MANUALES Y TUTORIALES WWW.MUNDOSAP.COM

CASE: Cubre el caso de mltiples comandos IF anidados. PERFORM. Permite llamar una rutina de un programa ABAP PRINT-CONTROL: Llama directamente ciertas funciones de la impresora. BOX, POSITION, LINE: Dibuja lneas y cajas. HEX ENDHEX. Enva a la impresora rdenes en el lenguaje que utiliza la impresora. SUMMING. Acumula un valor total para un smbolo de programa.

20

MANUALES Y TUTORIALES WWW.MUNDOSAP.COM

SAPSCRIPT SYMBOLS
La informacin variable se introduce en los formularios SAPScript mediante smbolos o variables que SAP reconoce porque van rodeadas de &. Ej: &symbol&. Los smbolos que se pueden utilizar son: Smbolos del sistema: variable como fecha, hora Smbolos de programa: variables almacenas en aplicaciones SAP como campos del diccionario de datos o variables globales de los programas. Smbolos estndar definidos en la tabla TTDTG. El valor de estos smbolos es dependiente del lenguaje y puede contener hasta 60 caracteres. SAP mantiene esta tabla con valores estndar. Smbolos de texto. Aquellos que no corresponden a los tipos de smbolos definidos anteriormente. Son definidos por el usuario en el editor de texto, eligiendo Incluir -> Smbolos ->Texto. O bien definindolos con el comando INCLUDE.

21

MANUALES Y TUTORIALES WWW.MUNDOSAP.COM

SIMBOLOS 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

CAMPOS GENERALES DE SAPSCRIPT

&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-JOBPAGES&. N total de pginas de todos los formularios contenido en la peticin de impresin actual. &SAPSCRIPT_CONTER_X& (x = 09) Representan 10 variables de contador que se puede utilizar en el texto y formularios para cualquier propsito.

22

MANUALES Y TUTORIALES WWW.MUNDOSAP.COM

OPCIONES DE FORMATO DE LOS SIMBOLOS

Desplazamiento Longitud de salida Omisin del signo Sacar el signo por la izquierda Sacar el signo por la derecha Omitir los ceros iniciales Comprimir los espacios Nmero de decimales Omitir el indicador de miles Especificar exponente Alinear a la derecha Rellenar de caracteres Suprimir valores iniciales Ignorar rutinas de converisin Cambiar valor de un contador Textos precedentes &symbol+offset& &symbol(length)& &symbol(S)& &symbol(<)& &symbol(>)& &symbol(Z)& &symbol(C)& &symbol(.2)& &symbol(T)& &symbol(E2)& &symbol(8R)& &symbol(Ff)& &symbol(I)& &symbol(K)& &SAPSCRIPT_COUNTER_X(+)& &SAPSCRIPT_COUNTER_X(+)& &pre-textsymbolpost-text&

23