Anda di halaman 1dari 49

CA930

CREACIN DE

FORMULARIOS

CON SAPSCRIPT
INTERNACIONAL DE SISTEMAS S.A. DE C.V. C REACIN DE FORMULARIOS CON
SAPSCRIPT

REFERENCIAS
Para una mayor referencia terica del presente documento se pueden consultar los
siguientes manuales:

CA930 Creating Layout Sets using SAPscript

VERSIN
Versin 1.0 20.01.99

2
REFERENCIA: CLON015 C:\MIS DOCUMENTOS\SAPSCRIPT COMPLETO.DOC
INTERNACIONAL DE SISTEMAS S.A. DE C.V. C REACIN DE FORMULARIOS CON
SAPSCRIPT

Objetivo.

El propsito del presente documento es resumir las consideraciones prcticas ms


importantes referentes a las funciones del Editor SAPscript del sistema R/3, estas
consideraciones incluyen el detalle de los conceptos bsicos para la edicin de
Formularios en SAPscript.

Introduccin.

SAPscript es un procesador de textos integrado que se usa para el formateo y


presentacin de documentos, reportes y en general cualquier aplicacin dentro del
sistema R/3 que lo requiera.

3
REFERENCIA: CLON015 C:\MIS DOCUMENTOS\SAPSCRIPT COMPLETO.DOC
INTERNACIONAL DE SISTEMAS S.A. DE C.V. C REACIN DE FORMULARIOS CON
SAPSCRIPT

UNIDAD 1.
VISIN GENERAL DE SAPSCRIPT.
OBJETIVOS.

Obtener un conocimiento general de la estructura de SAPscript.


Conocer como se integra SAPscript al sistema R/3.
Conocer los componentes de SAPscript.
Conocer como interactuan los componentes de SAPscript, principalmente el
programa de impresin y los formularios.

LAYOUT SET (FORMULARIO) .

Un Layout set (Formulario) especifica la apariencia y estructura de un documento,


contiene mdulos de texto predefinidos con espacios reservados para variables de
datos, dichos mdulos de texto se pueden utilizar para diferentes aplicaciones.

Cada documento SAPscript usa un Layout set (Formulario); para realizar cambios en
los documentos, tales como una parte de texto, tipo de letra, formatos de prrafo y
tabuladores slo es necesario modificar el Layout set.

Para editar Formularios desde el men principal del R/3 seleccionar:

ToolsWord processing Layout sets.

Para crear Formularios propios, se pueden copiar y adecuar Formularios existentes.

PROGRAMA DE IMPRESIN.

El programa de impresin controla:

La salida de texto a la impresora, pantalla o fax

Selecciona los datos desde la Base de datos o a partir de la entrada del usuario

Selecciona un Formulario y controla cual texto debe ser impreso, su secuencia y


frecuencia

Determina los atributos de la impresora tales como dispositivo de salida, nmero


de copias, y si ser inmediatamente impreso.

PROGRAMA DE IMPRESIN.

La apariencia final de un documento depende de la interaccin entre el programa y


el Formulario.

El programa de impresin de SAPscript inicializa el proceso de impresin. Cada


comando introducido usando la interface de programacin de SAPscript se transfiere
hacia el Composer.

4
REFERENCIA: CLON015 C:\MIS DOCUMENTOS\SAPSCRIPT COMPLETO.DOC
INTERNACIONAL DE SISTEMAS S.A. DE C.V. C REACIN DE FORMULARIOS CON
SAPSCRIPT

El composer recibe la informacin del formato desde el formulario especificado en el


programa de impresin.

Si los documentos contienen variables, el Composer reemplaza las variables con


datos desde el sistema R/3, tales como la fecha actual o con las datos del usuario
seleccionados por el programa de impresin.

El programa de impresin controla la terminacin del formulario. Una vez que este es
realizado, el Composer coloca el documento terminado en el Spool.

UNIDAD 2.
CREACIN Y MANTENIMIENTO DE FORMULARIOS

5
REFERENCIA: CLON015 C:\MIS DOCUMENTOS\SAPSCRIPT COMPLETO.DOC
INTERNACIONAL DE SISTEMAS S.A. DE C.V. C REACIN DE FORMULARIOS CON
SAPSCRIPT

OBJETIVOS

Conocer los elementos usados para crear un formulario en SAPscript


Como crear y modificar esos elementos en el sistema

T RABAJANDO CON FORMULARIOS.

Se pueden crear y mantener Formularios seleccionando ToolsWord


ProcessingLayout set desde el men de R/3, o directamente utilizando la
transaccin /se71

Se puede desplegar la lista de todos los formularios existentes o uno


especifico, utilizando los criterios de bsqueda con F4.

Tambin desde la pantalla inicial, se puede seleccionar cada seccin


(elemento) de manera independiente:

6
REFERENCIA: CLON015 C:\MIS DOCUMENTOS\SAPSCRIPT COMPLETO.DOC
INTERNACIONAL DE SISTEMAS S.A. DE C.V. C REACIN DE FORMULARIOS CON
SAPSCRIPT

HEADER. (CABECERA)

Contiene la Informacin general y configuracin bsica.

La informacin general incluye:


El nombre del formulario
Nmero del cliente
Clase de desarrollo
Estatus del formulario (Active, saved, etc.)
Fecha de creacin y ltima modificacin
Versin del sistema

Dentro de la configuracin bsica se especifica:


Descripcin del formulario
Formato de Prrafo default
Tamao y tipo de medida de tabulador
Primera pgina (para definir atributos de pgina
Formato de pgina (letter, A4, etc)
Tipo y orientacin de la pgina
Atributos de letra (letra, tamao de letra, negrillas, itlicas, o subrayado)

Los valores Lines/inch (LPI, lineas por pulgada) y character/inch (CPI,


caracteres por pulgada) se usan para convertir medidas especificadas en
lneas y caracteres a valores absolutos.

7
REFERENCIA: CLON015 C:\MIS DOCUMENTOS\SAPSCRIPT COMPLETO.DOC
INTERNACIONAL DE SISTEMAS S.A. DE C.V. C REACIN DE FORMULARIOS CON
SAPSCRIPT

T IPOS DE ESTATUS.

Un formulario puede tener tres tipos de estatus:

New: El formulario an no esta listo para imprimirse

Active: El formulario esta listo para imprimirse. Para establecer el estatus de


un formulario en activo, seleccionar Layout setActivate

Revised: Si un formulario se pone en estatus revised y saved el sistema utilizara


la versin activa del formulario al momento de imprimir.

Para deshacer cambios realizados a un formulario seleccionar UtilitiesReset

PAGES (PGINAS).

Nombre y secuencia de pginas en el formulario.

8
REFERENCIA: CLON015 C:\MIS DOCUMENTOS\SAPSCRIPT COMPLETO.DOC
INTERNACIONAL DE SISTEMAS S.A. DE C.V. C REACIN DE FORMULARIOS CON
SAPSCRIPT

En esta opcin es importante definir el tipo de numeracin y las caractersticas


de numeracin de las pginas.

Se pueden definir una o ms pginas en un formulario, el control de la


secuencia de las paginas se define especificando la primera pgina y las siguientes
paginas en los atributos de pgina; si no se especifican las paginas siguientes, el
proceso de impresin termina despus de la pgina actual que ha sido impresa.

Tambin se debe especificar el modo de numeracin, este determina si el


nmero de pgina se incrementar, ser el mismo o retornar a un valor inicial.

WINDOWS (VENTANAS).
Descripcin de reas en las pginas.

9
REFERENCIA: CLON015 C:\MIS DOCUMENTOS\SAPSCRIPT COMPLETO.DOC
INTERNACIONAL DE SISTEMAS S.A. DE C.V. C REACIN DE FORMULARIOS CON
SAPSCRIPT

Se pueden definir ventanas lgicas en un formulario especificando el nombre


y tipo de ventana.

Cada rea dentro de una pgina se define con una ventana. Una ventana
contiene principalmente el texto y las variables a imprimir. El texto a su vez puede
estar estructurado en Bloques llamados Text elements.

El Tipo de ventana tambin es importante ya que a excepcin de la ventana


MAIN las ventanas pueden ser de tipo VAR o CONST que son para variables y
constantes respectivamente. El contenido de un variable de ventana se regenera en
cada nueva pgina: el contenido de una constante de ventana se genera una vez
que inicia el despliegue y se imprime en cada pgina de salida.

Todas las ventanas que contienen diferente informacin en diferentes pginas


deben ser de tipo VAR, es decir, el alto y ancho de la ventana puede variar.

Las ventanas de tipo CONST, se usan para aquellas que tienen la misma
dimensin en todas las pginas donde ocurren.

LA VENTANA MAIN.

Una ventana especial es MAIN, la cual contiene la salida de los grupos de


lineas de un documento. La ventana MAIN contiene un texto de longitud variable, tal
como una lista de clientes, por eso cuando una ventana en una pgina esta llena,
SAPscript continua con el texto en la ventana MAIN de la siguiente pgina

Una ventana MAIN puede tener diferente altura y posicin en las diferentes
pginas en que ocurra, pero siempre tendr el mismo ANCHO.

Para ver los textos dentro de una ventana es necesario seleccionar la ventana
y enseguida el botn Text elements.

Para imprimir etiquetas, o imprimir documentos con mas de una columna, se


puede definir mas de una ventana MAIN en cualquier pgina seleccionando
EditMain Window.

10
REFERENCIA: CLON015 C:\MIS DOCUMENTOS\SAPSCRIPT COMPLETO.DOC
INTERNACIONAL DE SISTEMAS S.A. DE C.V. C REACIN DE FORMULARIOS CON
SAPSCRIPT

PAGE WINDOWS (VENTANAS DE PGINA).

Posicin y tamao de las ventanas en las paginas.

Una sola ventana puede aparecer en ms de una pgina de un Formulario.


SAPscript distingue entre Ventana Lgica (Logical window) y la Pgina de ventana
fsica (physical page window).

La misma ventana lgica puede aparecer en varios tamaos y posiciones en


diferentes pginas del formulario.

Se puede determinar la distribucin de las Paginas de ventana fsicas en una


pgina especfica definiendo el tamao y posicin de cada ventana.

Definiendo el formato de texto en una pgina de ventana fsica,


automticamente se define el formato de todas las dems ventanas que pertenecen
a la misma ventana lgica.

Para que una ventana aparezca dentro de Page Windows debe ser definida
primero dentro de Windows; a partir de esta lista se puede entrar a los Elementos
de texto de cada ventana.

11
REFERENCIA: CLON015 C:\MIS DOCUMENTOS\SAPSCRIPT COMPLETO.DOC
INTERNACIONAL DE SISTEMAS S.A. DE C.V. C REACIN DE FORMULARIOS CON
SAPSCRIPT

PARAGRAPH FORMAT (FORMATO DE PRRAFO).

Informacin sobre Tamao y Tipo de letra y Tabuladores por prrafo.

Un Paragraph Format contiene toda la informacin necesaria para formatear


un prrafo de texto. El Tipo de letra (Font) y los Tabuladores son importantes para los
prrafos; si no se especifica el FONT, se usa la letra fijada en el header. La forma de
crear columnas en la salida en un documento es especificando una lista de
tabuladores.

Se pueden especificar los siguientes atributos estndar de prrafo:

Margen derecho
Margen izquierdo
Espaciado vertical: espacio antes /espacio despus
Alineacin de prrafo: Izquierdo, derecho, centrado o justificado
Proteccin de pgina: no permite break automtico en un prrafo

12
REFERENCIA: CLON015 C:\MIS DOCUMENTOS\SAPSCRIPT COMPLETO.DOC
INTERNACIONAL DE SISTEMAS S.A. DE C.V. C REACIN DE FORMULARIOS CON
SAPSCRIPT

FONTS (TIPOS DE LETRA).

Los atributos de letra para prrafos incluyen:

Familia de letra (Font Family), como COURIER, HELVE, o TIMES


Tamao de letra (Tamao de letra)
Negrillas (bold)
Itlicas (Italics)
Subrayado (underlining)

Se puede tomar un atributo de letra desde los atributos generales del


formulario.

TABS (T ABULADORES).

Los atributos de tabulador controlan las posiciones en un prrafo:


Se pueden definir tantas posiciones de tabulador como se desee. Las
posiciones definidas reemplazan los tabuladores de default. Para alinear un prrafo,
use las posiciones de tabulador: Left, Right, enter, Sign, Decimal.
Para definir la posicin de nmeros en un prrafo, seleccione Sign o Decimal.
Sign, Permite definir nmeros alineados a la derecha del tabulador. Deja
espacio para un signo de menos o un espacio en blanco al final del nmero.
Decimal, Permite alinear puntos decimales con cualquier posicin de
tabulador.

OUTLINES (DIVISIONES DE TEXTO).


13
REFERENCIA: CLON015 C:\MIS DOCUMENTOS\SAPSCRIPT COMPLETO.DOC
INTERNACIONAL DE SISTEMAS S.A. DE C.V. C REACIN DE FORMULARIOS CON
SAPSCRIPT

Se pueden utilizar atributos de outline para dividir el texto en unidades como


captulos, subcaptulos, y secciones.

Para numerar parrafos automticamente, existen los siguientes tipos:


Arabic numerals
Roman numerals.
Letters.
Fixed characters.
Tambin se pueden numerar unidades de texto creando niveles consecutivos
de numeracin.

CHARACTER FORMAT (FORMATO DE CARACTERES).

Caractersticas del texto en un prrafo.

Un Character Format se usa para remarcar los prrafos, por ejemplo cambio
de letra normal a itlica.

Los atributos estndar del formato de caracteres incluyen:

Subscript: La cadena de caracteres es impresa a medio espacio de linea abajo


de la linea

Superscript: La cadena de caracteres es impresa a medio espacio arriba de la


linea

Character protection: La cadena de caracteres no puede ser dividida, y ser


impresa en una linea

Hidden: La cadena de caracteres no se imprime

Bar code: La cadena de caracteres se encripta e imprime como un cdigo de


barras.

Para sobreescribir una definicin previa de Formato de caracteres seleccione,


On u Off en la definicin de atributos.

14
REFERENCIA: CLON015 C:\MIS DOCUMENTOS\SAPSCRIPT COMPLETO.DOC
INTERNACIONAL DE SISTEMAS S.A. DE C.V. C REACIN DE FORMULARIOS CON
SAPSCRIPT

15
REFERENCIA: CLON015 C:\MIS DOCUMENTOS\SAPSCRIPT COMPLETO.DOC
INTERNACIONAL DE SISTEMAS S.A. DE C.V. C REACIN DE FORMULARIOS CON
SAPSCRIPT

UNIDAD 3.
EDICIN DE TEXTO
OBJETIVOS

Como usar el editor de texto


Opciones para operaciones de texto y posibilidades de formateo
Como esta constituido el editor de texto

EL EDITOR DE T EXTO.

PANTALLA DEL EDITOR


El contenido de las ventanas se define en el editor SAPscript.

La barra de ttulos despliega el nombre del documento y el modo de


procesamiento
La barra de Men despliega los mens desde los cuales se pueden
seleccionar funciones para salvar o imprimir texto.
La columna TAG contiene formatos clave, los cuales definen el formato
de salida o inician comandos de control. Aqu se pueden introducir formatos de
prrafo.

Los elementos del editor son: Status Line, Text Line y Tag Column.

STATUS LINE.

La lnea de estatus despliega informacin para el Editor SAPscript,


esta informacin incluye:

La lnea de estatus muestra el nombre del formulario.


Las lneas desplegadas en el editor (numero de lineas en la pantalla /
nmero total de lineas)
Los prrafos y Formatos de carcter seleccionados.

TEXT LINE.

El rea de texto en el editor SAPscript contiene una regla y las lneas


del editor a partir de las cuales se pueden introducir textos, Elementos de
texto y cualquier dato que se desee desplegar por medio de SAPscript.
Los textos se pueden formatear usando los prrafos clave contenidos
en el Tag Column que contiene todos los formatos de salida, tambin se
pueden usar los Comandos de control de SAPscript.

Nota: Un elemento de texto siempre empieza con la lnea /E<Nombre


del Elemento de Texto> y continua hasta el siguiente Elemento de Texto o al
final del editor, cualquiera que sea primero.

TAB CHARACTERS .

Los tabuladores en un prrafo se especifican por ,,.

16
REFERENCIA: CLON015 C:\MIS DOCUMENTOS\SAPSCRIPT COMPLETO.DOC
INTERNACIONAL DE SISTEMAS S.A. DE C.V. C REACIN DE FORMULARIOS CON
SAPSCRIPT

SMBOLOS .

&NN&
Los Smbolos se encierran entre & y no deben contener ningn
blanco, estos smbolos se reemplazan por su valor correspondiente en el
formato de salida.

TAG COLUMN.

El Tag Column contiene formatos clave para definir el formateo de


salida de un texto o para iniciar Comandos de control. Estos formatos clave
pueden ser definidos por el usuario y constan de uno o dos caracteres.

Existen algunos formatos claves definidos en SAPscript:

* Default paragraph (Prrafo preestablecido)


Aplica el formato de prrafo preestablecido como default

/ New line (lnea nueva)


El texto se imprime en una nueva linea conservando los atributos del
ltimo prrafo definido.

/: SAPscript control command (Comando de control de SAPscript)


Los caracteres no se despliegan como texto ya que se toman como
comandos de control y no se interpretan o ejecutan hasta el despliegue; estos
comandos se deben poner en una linea completa.

/* Comment line (Lnea de Comentario)


La lnea de comentario no se toma en cuenta en el despliegue.

= Extended line (Lnea extendida


Toma los atributos definidos en la linea anterior. Debe haber como
mnimo un carcter en blanco al inicio de la extensin de la lnea.

17
REFERENCIA: CLON015 C:\MIS DOCUMENTOS\SAPSCRIPT COMPLETO.DOC
INTERNACIONAL DE SISTEMAS S.A. DE C.V. C REACIN DE FORMULARIOS CON
SAPSCRIPT

INTRODUCCIN DE TEXTO.

Para crear un nuevo prrafo, posicione el cursor y presione ENTER.


Un asterisco (*) en la columna TAG indica le formato de prrafo default
El nuevo prrafo tiene el mismo formato que el anterior
Para insertar un corte de linea en un prrafo, use F6. Una diagonal invertida
(/) en la columna TAG indica este corte de linea.

Para unir dos prrafos:

1. Use espacios en blanco para sobreescribir el formato actual


2. Seleccione Format

Para borrar lineas en blanco o unir lineas separadas:

1. Use espacios en blanco para sobreescribir el formato actual.


2. Seleccione Format.

SALIDA DE TEXTO.

Para imprimir un texto, seleccione TextPrint

En la caja de dilogo se pueden especificar parmetros de impresin como:

18
REFERENCIA: CLON015 C:\MIS DOCUMENTOS\SAPSCRIPT COMPLETO.DOC
INTERNACIONAL DE SISTEMAS S.A. DE C.V. C REACIN DE FORMULARIOS CON
SAPSCRIPT

Dispositivo de salida
Nmero de copias
Pginas a imprimir
Opciones de Spool, como salida inmediata
Para ver la salida previa del texto, seleccione Print preview
Alternativamente, para desplegar un texto en la pantalla, se puede
seleccionar TextPrint preview.
Los parmetros del spool (dispositivo de salida y controlador de
impresin) son tomados desde los defaults del usuario.

INSERTAR TEXTO.

Para insertar texto, posicione el cursor y seleccione insert. La barra de ttulos


muestra el modo Insert activo, y lineas en blanco.

El Formato de Prrafo permanece igual cuando se inserta texto, aunque


puede ser modificado si as se desea.

Para salir del modo Insert, seleccione End insertion,

MOVER Y COPIAR TEXTO.

Para borrar o copiar una seccin de texto, seleccione el texto que ser
copiado o borrado.

Para seleccionar texto, elija Select u oprima doble click en la posicin que
desee marcar.

Cuando seleccione el inicio de la seccin de texto, SAPscript se encuentra en


el modo Select. El texto seleccionado esta en modo resaltado

Para definir el final de la seccin de texto, elija Select o doble click en la


posicin deseada

Para seleccionar una parte de texto oprima doble click en la columna TAG

Seleccione Cut o Copy. El texto marcado se copia al Clipboard.

Cut borra el texto marcado.

Copy No borra el texto marcado.

Cuando se corta o copia texto, se borra el contenido previo del clipboard.

Para insertar el contenido del clipboard, posicione el cursor y seleccione Paste

Para copiar texto a un editor diferente, use el clipboard

Existen tres clipboards, los cuales pueden usarse para salvar texto.
Seleccione GotoUser Clipboard

19
REFERENCIA: CLON015 C:\MIS DOCUMENTOS\SAPSCRIPT COMPLETO.DOC
INTERNACIONAL DE SISTEMAS S.A. DE C.V. C REACIN DE FORMULARIOS CON
SAPSCRIPT

FORMATEO DE PRRAFOS Y CARACTERES.

Se puede organizar texto usando los formatos de Prrafo y Carcter que


estn disponibles en el formulario actual.

Para aplicar formatos de Prrafo y carcter, seleccione FormatParagraph o


FormatCarcter.

La caja de dialogo despliega los formatos predefinidos, sus descripciones y


atributos. Introduzca prrafos predefinidos en la columna TAG. se pueden cambiar o
borrar formatos predefinidos que ya han sido introducidos.
Para desplegar una lista de los posibles formatos de prrafo, seleccione F4.
Para formatear una cadena de caracteres:
Introduzca NN.../. NN o seleccione Format

Cuando se marca una seccin entera, asegurese que no existan espacios en


blanco entre la ltima palabra que ser marcada y el cursor

Para aplicar nuevamente el ltimo formato usado, seleccione Transfer


character o Transfer paragraph.

CARACTERES ESPECIALES.

Para suprimir el reconocimiento de caracteres especiales, utilice

Para mover un parte de texto hacia la siguiente posicin de tabulador, escriba


una coma doble (,,) al inicio del texto que desea mover.

Se pueden definir posiciones de tabulador en Prrafos. Sino define


tabuladores, se usan las posiciones de default predefinidas del formulario.
Para agregar lneas de comentario que sean ignoradas cuando se formatea el
texto, introduzca /* en la columna tag

Para proteger una linea extendida con el formato predefinido, introduzca =.


Esta funcin tambin suprime los espacios en blanco implcitos en el editor al final de
la linea anterior.

Los smbolos consisten de espacios reservados para variables de datos. Los


datos se insertan durante la preparacin de la impresin.

Para formatear smbolos, introduzca &N...N&

Para usar comandos de control de SAPscript, introduzca /: en la columna


TAG. Los comandos de control no son interpretados hasta que el documento se
procesa por el composer.

UNIDAD 4.
20
REFERENCIA: CLON015 C:\MIS DOCUMENTOS\SAPSCRIPT COMPLETO.DOC
INTERNACIONAL DE SISTEMAS S.A. DE C.V. C REACIN DE FORMULARIOS CON
SAPSCRIPT

SMBOLOS Y COMANDOS DE CONTROL


OBJETIVOS

Como usar smbolos en SAPscript


La diferencia entre los diferentes tipos de smbolos
Las opciones de formateo
Como controlar la salida de un texto SAPscript usando los comandos de
control

USO DE LOS SMBOLOS.

Se pueden usar smbolos para incluir datos a partir de tablas en documentos


SAPscript.

Cuando se imprime un documento, se imprimen los datos a partir de tablas en vez


de los smbolos.

Cada smbolo tiene un nombre el cual se encierra entre &

No se hace distincin entre maysculas y minsculas.


No se permiten espacios en los nombres de smbolos
El smbolo completo (el nombre entre &..&) debe caber en una lnea

Para insertar smbolos en un documento, seleccione IncludeSymbols

T IPOS DE SMBOLOS.

SAPscript emplea 4 diferentes tipos de smbolos:

Smbolos de sistema
Smbolos estndar
Smbolos de programa
Smbolos de texto

SMBOLOS DE SISTEMA.

SAPscript proporciona smbolos de sistema estndar que se reemplazan


automticamente con datos del Sistema R/3 cuando se imprime un documento

Estos smbolos de sistema se pueden utilizar en cualquier documento

DATE Fecha
DAY Da
NAME_OF_DAY Nombre del da
MONTH Mes
NAME_OF_MONTH Nombre del mes
YEAR Ao
TIME Tiempo
HOURS Horas
MINUTES Minutos
SECONDS Segundos
21
REFERENCIA: CLON015 C:\MIS DOCUMENTOS\SAPSCRIPT COMPLETO.DOC
INTERNACIONAL DE SISTEMAS S.A. DE C.V. C REACIN DE FORMULARIOS CON
SAPSCRIPT

PAGE Nmero de pgina


NEXTPAGE Nmero de la siguiente pgina
DEVICE Dispositivo
SPACE Espacio en blanco
ULINE Subrayado
VLINE lnea vertical

Para incluir un smbolo de sistema, seleccione: Include SymbolsSystem

SMBOLOS ESTNDAR.

Los smbolos estndar son definidos por el usuario. Y son mantenidos


centralmente en la tabla TTDTG.

Se pueden usar smbolos estndar en cualquier documento .

Se pueden desplegar o cambiar smbolos estndar seleccionando


SystemServicesTable maintenance o seleccionando ToolsWord
processingSettings, seguido de los smbolos estndar.

Los smbolos estndar son especficos por lenguaje.

Algunos ejemplos de Smbolos estndar son:

&SGDH& Para el saludo: Dear Sir/Madam:


&MFG& Para terminar el saludo: Yours Faithfulliy

SMBOLOS DE PROGRAMA.

Los smbolos de programa despliegan datos desde programas ABAP/4 los


cuales han sido llamados desde la funcin de procesamiento de texto.

Los smbolos de programa representan los contenidos de los campos de base


de datos. Es necesario definir dichos campos en una tabla o estructura del
diccionario ABAP/4 y declararlos en el programa de impresin usando la instruccin
TABLES.

La instruccin TABLES crea reas de trabajo en el programa de impresin las


cuales se llenan con datos en el programa. SAPscript formatea estos datos de
acuerdo a los atributos definidos en el Diccionario

SMBOLOS DE TEXTO.

Se pueden definir smbolos de texto para cualquier mdulo de texto. Estos


smbolos son vlidos slo en el mdulo de texto para el cual fueron definidos.

Se pueden asignar valores a un smbolo de las siguientes dos maneras:

Empleando DEFINE.
El valor asignado al smbolo se salva cuando se salva el mdulo de
texto.

22
REFERENCIA: CLON015 C:\MIS DOCUMENTOS\SAPSCRIPT COMPLETO.DOC
INTERNACIONAL DE SISTEMAS S.A. DE C.V. C REACIN DE FORMULARIOS CON
SAPSCRIPT

Para asignar varios valores diferentes al mismo smbolo, emplee


DEFINE cada vez que asigne un nuevo valor.

Seleccionando un smbolo de texto estndar.


Para hacerlo, seleccione IncludeSymbolsText.

El sistema despliega todos los smbolos de texto disponibles en el


texto actual y/o formulario.

El valor asignado a un smbolo de texto slo es temporal. Este valor no


se salva junto con el texto.

OPCIONES DE FORMATO.

El valor de un smbolo se despliega completamente. Sin embargo, los


espacios en blanco se eliminan para cambiar el despliegue del smbolo, emplee las
siguientes opciones adicionales:

Offset Salida a partir de una determinada posicin


&symbol+4&

Length Dato con una longitud de salida especfica


&symbol(5)&

Suprime el valor inicial


&symbol(I)&

Elimina ceros iniciales


&symbol(Z)&

C Comprime espacios en blanco consecutivos en un slo espacio


en blanco. Los espacios en blanco iniciales se eliminan.
&symbol(C)&

R La salida es justificada a la derecha


&symbol(S)&

S Oculta operadores
&symbol(S)&

* La longitud del campo es definida por el diccionario ABAP/4


&symbol(*)&

(x,y) Notacin decimal: Los datos tienen x longitud con y posiciones


decimales
&symbol(8.2)&

El texto se puede insertar antes o despus de un smbolo, por ejemplo: &


text1SYMBOLtext2&.

Tambin se puede combinar opciones de formateo.

23
REFERENCIA: CLON015 C:\MIS DOCUMENTOS\SAPSCRIPT COMPLETO.DOC
INTERNACIONAL DE SISTEMAS S.A. DE C.V. C REACIN DE FORMULARIOS CON
SAPSCRIPT

COMANDOS DE CONTROL.

Se pueden usar comandos de control para modificar la salida de texto. Estos


comandos permiten:

Incluir texto en un documento


Asignar valores a Smbolos de texto
Iniciar o suprimir un corte de pgina
Inicializacin de prrafos

Para introducir un comando, utilice el formato clave /: en la columna de


formato

La longitud de un comando no debe exceder de una lnea

Ejemplos de comandos de control.

/: INCLUDE
/: DEFINE
/: ADDRESS... ENDADDRESS
/: PROTECT... ENDPROTECT
/: NEW-PAGE
/: IF ... ENDIF
/: CASE ... ENDCASE

MDULOS DE TEXTO.

Un formulario frecuentemente contiene mdulos de texto predefinidos tales


como una lista de materiales, descripciones de clientes, etc.

Estos mdulos de texto se introducen y almacenan individualmente.

Se pueden combinar y desplegar estos mdulos en un formulario.

Se puede usar un mdulo de texto en mas de un formulario.

Para identificar un texto se especifica el cliente, nombre, lenguaje, objeto de


texto y un identificador del texto.

Los objetos de texto y los identificadores de texto son usados para clasificar
textos.
Un objeto de texto describe el contexto de un documento, por ejemplo: Texto
Materiales, o Texto estndar, estos textos pueden ser utilizados por mas de una
aplicacin.

Los objetos de texto se dividen en Identificadores de texto (text Ids) para


permitir una clasificacin ms precisa de los tipos de texto. Por ejemplo, la categora
Textos de Ventas y Distribucin es una subcategora de Textos de Materiales.

Para trabajar en cualquier documento estndar, esto es, todos los textos ubicados en
el Objeto de Texto, seleccione

24
REFERENCIA: CLON015 C:\MIS DOCUMENTOS\SAPSCRIPT COMPLETO.DOC
INTERNACIONAL DE SISTEMAS S.A. DE C.V. C REACIN DE FORMULARIOS CON
SAPSCRIPT

ToolsWord processingStandar text

MDULOS DE T EXTO INCLUIDOS.

Se pueden incluir mdulos de texto para el cliente actual en cualquier ventana


en un formulario. Tambin se pueden incluir mdulos de texto en otros mdulos de
texto. En ambos casos se utiliza INCLUDE.

Se puede especificar el nombre del texto que se desea incluir.


Se pueden especificar campos clave adicionales para el texto utilizando los
parmetros OBJECT, ID y LENGUAJE.
Si se usa el parmetro PARAGRAPH para especificar un formato de prrafo en un
formulario, este ser usado como el formato default en el texto insertado.

FORMATO DE DIRECCIN.

Se deben especificar explcitamente valores para los smbolos de texto.

Para asignar valores a los smbolos de texto, se usa DEFINE antes de que el
smbolo de texto sea desplegado por primera vez.

Los smbolos de texto son retenidos en el documento. Esto significa que los
smbolos de texto permanecen en el mdulo de texto la siguiente vez que es llamado.

Para formatear una direccin de acuerdo a las convenciones por pas, utilice
ADDRESS...ENDADDRESS.

Defina las convenciones postales en el parmetro COUNTRY

Los campos referenciados son descritos en la estructura ADRS. Se pueden


asignar literales o smbolos a esos parmetros.

FORMATOS DE HORA, FECHA Y DECIMALES.

Estos formatos son especficos del usuario.

Para modificar los formatos de programa y smbolos de sistema, utilice los


siguientes comandos de control:

SET TIME MASK


Controla el formato de campos de tiempo
/: SET TIME MASK = .........

SET DATE MASK


Controla el formato de campos de fecha
/: SET DATE MASK = .........

SET CONTRY
Proporciona una opcin de formato para fecha o decimales especfica por
pas.
/: SET COUNTRY = .........

25
REFERENCIA: CLON015 C:\MIS DOCUMENTOS\SAPSCRIPT COMPLETO.DOC
INTERNACIONAL DE SISTEMAS S.A. DE C.V. C REACIN DE FORMULARIOS CON
SAPSCRIPT

Para definir mascaras de formato utilice lineas de comando (command lines).

CORTE Y PROTECCIN DE PGINA.

SAPscript inserta automticamente un corte de pgina cuando la ventana


MAIN esta llena.

Para omitir el corte de pgina automtico e insertar un corte de pgina


manual, utilice NEW-PAGE.

Se puede indicar el siguiente corte de pgina explcitamente, sino se indica, la


pgina definida en el Formulario se utiliza como siguiente pgina.

Para evitar cortes de pgina no deseados, utilice PROTECT...ENDPROTECT.


Todas las lineas de texto encerradas entre estos comandos se imprimiran en una
pgina.

/: NEW-PAGE (page)

/: PROTECT
...
...
/: ENDPROTECT

Si no hay suficiente espacio en la pgina, el comando PROTECT acta como


un comando NEW-PAGE e inserta un corte de pgina.

SALIDA DE TEXTO CONDICIONADA: DISTINCIN CASE

Se puede especificar que lineas de texto deben imprimirse slo cuando se


encuentra cierta condicin. Para establecer estas condiciones, utilice IF...ENDIF.

/: IF Condition
.
.
.
/: ENDIF

Si la expresin lgica evaluada con el comando IF es verdadera, las lineas de


texto encerradas entre los comandos IF... ENDIF se imprimen, de otra forma se
ignoran.
Los siguientes operadores de comparacin son permisibles para expresiones
lgicas:

= EQ igual
LT menor que
GT mayor que
LE menor o igual que
GE mayor o igual que
EN diferente de

Operadores de comparacin
26
REFERENCIA: CLON015 C:\MIS DOCUMENTOS\SAPSCRIPT COMPLETO.DOC
INTERNACIONAL DE SISTEMAS S.A. DE C.V. C REACIN DE FORMULARIOS CON
SAPSCRIPT

NOT, AND, OR

Slo son validas comparaciones de texto

Para distinguir entre casos de doble nivel y multinivel, utilice ELSE y ELSEIF
con IF... ENDIF.

CASE es un tipo especial de distincin multinivel usando comandos IF.

/: CASE symbol
/: WHEN Value
:
:
/: ENDCASE

27
REFERENCIA: CLON015 C:\MIS DOCUMENTOS\SAPSCRIPT COMPLETO.DOC
INTERNACIONAL DE SISTEMAS S.A. DE C.V. C REACIN DE FORMULARIOS CON
SAPSCRIPT

UNIDAD 5.
EL PROGRAMA DE IMPRESIN
OBJETIVOS:

Comprender la estructura de programas de impresin en SAPscript


Comprender como trabajan juntos el Programa de Impresin y el Formulario
Familiarizarse con los mdulos de funcin para la salida de texto
Comprender la salida de Elementos de texto en formularios
Comprender como trabaja el Composer SAPscript

EL PRINT PROGRAM Y EL COMPOSER

En el sistema R/3, tanto el Programa de impresin y el formulario son necesarios


para imprimir documentos. El programa de impresin es tanto un reporte ABAP/4
como un Module pool.

El programa de impresin:

Recupera datos de aplicaciones R/3 desde la base de datos


Define el proceso lgico del formulario (el orden y repeticin de los elementos
de texto
Selecciona el formulario para impresin
Selecciona el dispositivo de salida, tal como impresora, monitor o fax
Fija los atributos de impresin como salida inmediata, nmero de copias, y
pginas a ser impresas.

El Composer Controla:

Lineas y cortes de pgina en el Formulario


Formateo de Comandos de Control SAPscript y variables de smbolos
La inclusin de textos largos en un documento
La descripcin de pgina para el spool request (Formato final o OTF)

ESTRUCTURA DE UN PROGRAMA DE IMPRESIN.

Las aplicaciones R/3 como FI, CO, y MM son provedos con formularios
estndar y programas de impresin que pueden ser customizados.

Con el programa de impresin se debe distinguir entre:


Recuperacin de datos desde el sistema R/3
Inicio y fin de impresin del Formulario
Cambios para diferentes Formularios
Salida de texto en el Formulario

Cada vez que se imprime un Formulario, se debe usar el par de mdulos de


funcin OPEN_FORM y CLOSE_FORM

Un programa de impresin tambin puede imprimir varios formularios los


cuales pueden ser administrados individualmente como Spool request individuales o
combinados en un slo spool request.

28
REFERENCIA: CLON015 C:\MIS DOCUMENTOS\SAPSCRIPT COMPLETO.DOC
INTERNACIONAL DE SISTEMAS S.A. DE C.V. C REACIN DE FORMULARIOS CON
SAPSCRIPT

Para combinar Formularios en un slo spool request, utilice START_FORM y


END_FORM.

Para imprimir elementos de texto en las ventanas de un Formulario, utilice


WRITE_FORM

Para transferir comandos de control hacia el Formulario, utilice


CONTROL_FORM

Ejemplo. program rstxexp1.


tables: scustom, sbook, ...
Recuperacin select * from ...
de datos ...
call function OPEN_FORM
exporting form = ...
...
call function START_FORM ...
...
Abre formulario call function WRITE_FORM Cambio a otro
para impresin exporting element = ... Formulario
window = ...
...
call function END_FORM...
...
call function START_FORM...
...
Cierra impresin call function END_FORM...
del formulario ... Salida de
call function CLOSE_FORM... impresin en
un formulario

INICIO Y FIN EN LA IMPRESIN DE UN FORMULARIO.

29
REFERENCIA: CLON015 C:\MIS DOCUMENTOS\SAPSCRIPT COMPLETO.DOC
INTERNACIONAL DE SISTEMAS S.A. DE C.V. C REACIN DE FORMULARIOS CON
SAPSCRIPT

El mdulo de funcin OPEN_FORM inicializa la impresin del Formulario. Se


puede llamar el OPEN_FORM antes de que se pueda trabajar con cualquiera de los
otros mdulos de funcin de Formulario.

Para especificar el Formulario y el lenguaje deseado, utilice los parmetros


FORM y LANGUAJE.

Para controlar el canal de salida, utilice el parmetro DEVICE con:

PRINTER para imprimir usando el Spool


TELEFAX para salida a FAX utilizando el Spool o SAPconnect
SCREEN para salida a monitor usando GUI. No se puede imprimir
el texto si se utiliza este valor.

Para especificar atributos para impresiones o faxes, tales como nmero de


copias, salida inmediata, etc. utilice la opcin PARAMETERS (estructura ITCPO).

Para suprimir la caja de dilogo para parmetros de salida, tales como el


nombre del dispositivo en DEVICE = PRINTER o DEVICE = TELEFAX, utilice el
parmetro DIALOG.

Para terminar la impresin de un Formulario, utilice el mdulo de funcin


CLOSE_FORM

Una vez que la impresin del Formulario ha terminado, se puede obtener


informacin de estatus y la impresin y parmetros de fax a partir del parmetro
RESULT (estructura ITCPP).

CALL FUNCTION OPEN_FORM


EXPORTING
FORM = ...
LANGUAJE = ...
DEVICE = ...
OPTIONS = ...
DIALOG = ...
IMPORTING
LANGUAJE = ...
EXCEPTIONS... =...

-----------------------------------------------------------

CALL FUNCTION CLOSE_FORM


IMPORTING
RESULT =...
EXCEPTIONS... =...

SALIDA DE MAS DE UN FORMULARIO UTILIZANDO UN SOLO SPOOL REQUEST.

Para imprimir varios Formularios idnticos que contienen datos diferentes con
un slo Spool Request, inicie cada Formulario usando START_FORM y terminelo
usando END_FORM
30
REFERENCIA: CLON015 C:\MIS DOCUMENTOS\SAPSCRIPT COMPLETO.DOC
INTERNACIONAL DE SISTEMAS S.A. DE C.V. C REACIN DE FORMULARIOS CON
SAPSCRIPT

Antes de usar START_FORM por primera vez, se debe llamar el


OPEN_FORM.

Los mdulos de funcin para cada Formulario son llamados entre


START_FORM y END_FORM

END_FORM no termina el proceso de impresin.

Utilice START_FORM o CLOSE_FORM despus de END_FORM.

Nota: END_FORM no puede reemplazar a END_FORM.

Para especificar el Formulario bajo START_FORM, utilice los parmetros


FORM y LANGUAJE.

Para seleccionar una pgina de inicio diferente a la pgina de inicio default,


utilice el parmetro STARTPAGE.

CALL FUNCTION START_FORM


EXPORTING
FORM = ...
LANGUAGE = ...
STARTPAGE = ...
IMPORTING
LANGUAGE = ...
EXCEPTIONS ... = ...

---------------------------------------------------------------

CALL FUNCTION END_FORM


IMPORTING
RESULT = ...
EXCEPTIONS ... = ...

OPCIONES DE SALIDA PARA ELEMENTOS DE T EXTO.

Para salida de Elementos de texto en la ventana de un Formulario, utilice el


mdulo de funcin WRITE_FORM.

El orden en el cual se imprimen los elementos de texto corresponden al orden


en el cual el mdulo de funcin WRITE_FORM es llamado. En otras palabras, este se
determina por el programa de impresin.
31
REFERENCIA: CLON015 C:\MIS DOCUMENTOS\SAPSCRIPT COMPLETO.DOC
INTERNACIONAL DE SISTEMAS S.A. DE C.V. C REACIN DE FORMULARIOS CON
SAPSCRIPT

Se debe especificar el elemento de texto deseado usando el parmetro


ELEMENT.

El parmetro WINDOW especifica la ventana en la cual se despliega el


elemento de texto.

El parmetro TYPE especifica el rea de salida en la ventana MAIN.

El parmetro FUNCTION si el texto ser introducido, reemplazado o borrado.

CALL FUNCTION WRITE_FORM


EXPORTING = ...
ELEMENT = ...
FUNCTION = ...
TYPE = ...
WINDOW = ...
EXCEPTIONS
... = ...

Main window (MAIN) Non-main window

Para introduccin de texto Para introducir texto


Para definir encabezados Para reemplazar texto
Para borrar encabezados Para borrar texto

SALIDA DE ELEMENTOS DE T EXTO EN LA VENTANA MAIN DE UN FORMULARIO.


Para imprimir Elementos de Texto en la ventana principal de un formulario,
utilice WRITE_FORM.

El orden en que los Elementos de Texto se imprimen corresponde al orden en


el cual se utiliza mdulo de funcin en el programa de impresin.

Se debe especificar el Elemento de texto deseado usando el parmetro


ELEMENT.

El parmetro WINDOW debe ser asignado a MAIN. Este es el valor de default.


32
REFERENCIA: CLON015 C:\MIS DOCUMENTOS\SAPSCRIPT COMPLETO.DOC
INTERNACIONAL DE SISTEMAS S.A. DE C.V. C REACIN DE FORMULARIOS CON
SAPSCRIPT

El parmetro TYPE debe ser asignado a BODY. Este es el valor de default.


El parmetro FUNCTION no es relevante aqu.

La salida de los Elementos de texto en la ventana principal manda un corte de


pgina tan pronto como la ventana de pgina esta llena.
Tambin se puede utilizar el mdulo de funcin WRITE_FORM_LINES. Para
hacerlo indique directamente el parmetro LINES e indique el texto a imprimir.

CALL FUNCTION WRITE_FORM


EXPORTING ELEMENT = ...
EXCEPTIONS... = ...

AGREGANDO ELEMENTOS DE TEXTO A UNA VENTANA NO PRINCIPAL.

Para agregar un Elemento de texto a una ventana no principal, utilice


WRITE_FORM con FUNCTION = APPEND.
El texto insertado en la ventana principal, cualquier texto que no quepa en la
ventana de pagina (page window) actual se pierde.
Como con la ventana principal, el orden en el cual los elementos de texto se
imprimen corresponde al orden en el cual el mdulo de funcin WRITE_FORM es
usado en el programa de impresin.

Se debe especificar el nombre del Elemento de texto en el parmetro


ELEMENT.

Se debe especificar el nombre de la ventana no principal en el parmetro


WINDOW.
El parmetro TYPE no es relevante aqu.
El parmetro FUNCTION debe tener el valor APPEND.

CALL FUNCTION WRITE_FORM


EXPORTING ELEMENT = ...
FUNCTION = APPEND
WINDOW = INFO
EXCEPTIONS... = ...

REEMPLAZANDO ELEMENTOS DE T EXTO EN VENTANAS NO PRINCIPALES.

Para reemplazar el contenido actual de una ventana no principal con un


elemento de texto, utilice el mdulo de funcin WRITE_FORM con FUNCTION =
SET.

Se debe especificar el nombre del Elemento de texto en el parmetro


ELEMENT.

Se debe especificar el nombre de la ventana en el parmetro WINDOW.


El parmetro TYPE no es relevante aqu.
El parmetro FUNCTION no tiene el valor SET.

33
REFERENCIA: CLON015 C:\MIS DOCUMENTOS\SAPSCRIPT COMPLETO.DOC
INTERNACIONAL DE SISTEMAS S.A. DE C.V. C REACIN DE FORMULARIOS CON
SAPSCRIPT

BORRANDO UN ELEMENTO DE TEXTO EN UNA VENTANA NO PRINCIPAL.

Para borrar un Elemento de texto en una ventana no principal, utilice


WRITE_FORM con FUNCTION = DELETE.

Se debe especificar el Elemento de texto en el parmetro ELEMENT.


Se debe especificar la ventana en el parmetro WINDOW.
El parmetro TYPE no es relevante aqu.
El parmetro FUNCTION debe tener el valor DELETE.

CALL FUNCTION WRITE_FORM


EXPORTING ELEMENT = ...
FUNCTION = DELETE
WINDOW = HEADER
EXCEPTIONS ... = ...

VENTANA MAIN.

Se puede desplegar texto en la ventana MAIN en cualquiera de las tres ares


de salida TOP (header), BODY y BOTTOM (footer). TOP

Se pueden crear encabezados de pgina (page headers) y/o pies de pgina


(page footers) en el header y footer de la ventana MAIN. Estos son parecidos a los
encabezados y pies de pgina creados en ABAP/4 durante la impresin de una lista.

El espacio ocupado por el encabezado y pie dependen de la cantidad de texto


que contengan; este espacio es tomado del BODY
BODY
Se pueden definir y cambiar los contenidos de las ares de salida TOP, BODY y
BOTTOM dinmicamente en cualquier momento durante la salida del formulario.
SAPscript automticamente imprime esas reas en cada pgina de un formulario que
contenga una ventana MAIN.

34
REFERENCIA: CLON015 C:\MIS DOCUMENTOS\SAPSCRIPT COMPLETO.DOC

BOTTOM
BOTTOM
INTERNACIONAL DE SISTEMAS S.A. DE C.V. C REACIN DE FORMULARIOS CON
SAPSCRIPT

MAIN

bobo

DEFINIENDO Y BORRANDO ENCABEZADOS.

Para introducir encabezados en la ventana MAIN, utilice WRITE_FORM, TYPE


= TOP, FUNCTION = SET.

Si el rea del BODY no contiene ningn texto, el encabezado se imprime en la


pgina actual.

Si el rea del BODY contiene texto, el encabezado se imprime por primera vez
al inicio de la siguiente pgina.

Para imprimir Elementos de texto, bajo un encabezado en la ventana MAIN,


utilice el mdulo de funcin WRITE_FORM, TYPE = BODY. La salida bajo el
encabezado puede extenderse a mas de una pgina

Para borrar un encabezado cuando sus Elementos de texto han sido


impresos, utilice WRITE_FORM, TYPE = TOP, FUNCTION = DELETE.

35
REFERENCIA: CLON015 C:\MIS DOCUMENTOS\SAPSCRIPT COMPLETO.DOC
INTERNACIONAL DE SISTEMAS S.A. DE C.V. C REACIN DE FORMULARIOS CON
SAPSCRIPT

El encabezado no se borra hasta la siguiente pgina. Por esta razn, un


encabezado en el rea TOP no puede ser borrado retroactivamente si ya existe texto
en el rea BODY.

En el siguiente ejemplo, el encabezado, la direccin del cliente, se imprime


primero en el rea BODY y despus se coloca en el rea TOP para las siguientes
pginas.

Call function START_FORM...


...
Salida de encabezado en call function WRITE_FORM
Pgina actual exporting element = ITEM_HEADER
type = BODY
window = MAIN
Introduccin de
call function WRITE_FORM
Encabezado en el rea exporting element = ITEM_HEADER
TOP function = SET
type = TOP
window = MAIN
...
Borrado de encabezado
En el rea TOP para la call function WRITE_FORM
exporting element = ITEM_HEADER
Siguiente pgina
function = DELETE
type = TOP
window = MAIN
...
call function END_FORM...

CMO TRABAJA EL COMPOSER.

La ventana MAIN controla el corte de pgina. Los elementos de texto de


ventanas no main no son procesados hasta el corte de pgina.

Un corte de pgina se ejecuta por:

Un overflow de la ventana MAIN (automtico)


Un comando NEW-PAGE en la ventana MAIN (manual)

Para imprimir los elementos de texto en el rea TOP, BODY o BOTTOM de la


ventana MAIN, o en ventanas no MAIN, utilice el mdulo de funcin WRITE_FORM.

Un Elemento de texto default al inicio de una ventana no MAIN se imprime una


vez en la ventana tan pronto como esta es procesada. Sin embargo, siguiendo un
corte de pgina los elementos de texto default en la ventana MAIN no aparecen en la
ventana MAIN de la siguiente pgina.

La ventana MAIN controla los cortes de pgina.

36
REFERENCIA: CLON015 C:\MIS DOCUMENTOS\SAPSCRIPT COMPLETO.DOC
INTERNACIONAL DE SISTEMAS S.A. DE C.V. C REACIN DE FORMULARIOS CON
SAPSCRIPT

Los elementos de Texto en una ventana no MAIN se procesan al corte de


pgina o al final del formulario.

Los smbolos en el rea BODY de la ventana MAIN se reemplazan con datos


inmediatamente.

Los smbolos en el rea TOP o BOTTOM se reemplazan con datos aunque


se hagan cambios en esta rea.

Los smbolos en una ventana no MAIN se reemplazan cuando ocurre un corte


de pgina.

UNIDAD 6.
DEFINICIN Y USO DE ESTILOS
OBJETIVOS

Comprender el uso de estilos


Crear y mantener estilos
Asignar estilos a textos SAPscript

ESTILOS: UNA AYUDA DE FORMATEO.

Se pueden usar estilos para definir prrafos y formatos de caracteres, que no


existan en el formulario actual, que permanezcan independientemente de los
definidos por el formulario.

SAPscript provee varios estilos estndar, como los usados en mensajes de


correo electrnico o para documentacin en lnea.

Se puede asignar un estilo a cualquier texto. Para hacerlo seleccione


Format Style.

37
REFERENCIA: CLON015 C:\MIS DOCUMENTOS\SAPSCRIPT COMPLETO.DOC
INTERNACIONAL DE SISTEMAS S.A. DE C.V. C REACIN DE FORMULARIOS CON
SAPSCRIPT

Para desplegar todos los formatos definidos para un estilo, seleccione


Format Character, y Format Paragraph.

Para hacer cambios de estilo temporales en un documento, utilice el comando


de control /: STYLE.

Cuando se asigna un estilo, la definicin el prrafo y el formato de caracteres


usado en el estilo sobreescriben los del formulario actual.

Para encontrar estilos estndar, realizar cambios en estilos, crear nuevos


estilos o desplegar los estilos disponibles, utilice la transaccin para mantenimiento
de estilos:

Tools Word processing Style

Para accesarla desde el mantenimiento del formulario o desde el


mantenimiento estndar de texto, seleccione Environment Style.

UNIDAD 7.
INTERFAZ DE PROGRAMACIN PARA PROCESAMIENTO DE TEXTO
OBJETIVOS

Familiarizarse con los mdulos de funcin de SAPscript para la


administracin de documentos
Aprender como salvar texto SAPscript usando el procedimiento de
actualizacin
Familiarizarse con las transacciones de aplicacin de SAPscript.

INICIALIZANDO Y CAMBIANDO TEXTOS.

Se debe preparar un encabezado de texto y una tabla por cada documento


que sea editado por un programa de aplicacin.

El encabezado de texto contiene todos los datos pertenecientes a un


documento.

La tabla de linea contiene las lineas de texto

Cuando se crea un nuevo texto, se inicializan las reas de trabajo usando


INIT_TEXT. El comando CLEAR HEADER no es suficiente.

38
REFERENCIA: CLON015 C:\MIS DOCUMENTOS\SAPSCRIPT COMPLETO.DOC
INTERNACIONAL DE SISTEMAS S.A. DE C.V. C REACIN DE FORMULARIOS CON
SAPSCRIPT

Para llamar el editor de texto largo, utilice EDIT_TEXT Se pueden controlar


numerosas funciones, tales como el desplegado o el modo de cambio usando
parmetros de entrada.

Cuando se selecciona TextSave mientras se usa EDIT_TEXT, el mdulo de


funcin SAVE_TEXT se llama automticamente. Para suprimir esta funcin, utilice el
parmetro SAVE = SPACE.

Para transferir el texto a ser editado al mdulo de funcin EDIT_TEXT, utilice


HEADER y LINES.

Areas de Trabajo para textos SAPscript en el programa de impresin:

HEADER: Texto de encabezado (cadena con estructura del diccionario THEAD)


LINES:Tabla de linea (Tabla interna con estructura del diccionario TLINE)

INIT_TEXT: Inicializacin de reas de trabajo requeridas en el programa para crear


un nuevo texto

EDIT_TEXT: Llama al editor, el cual permite introducir datos en un texto nuevo o uno
ya existente.
HEADER y LINES sirven como parmetros de transferencia

BSQUEDA DE T EXTO.

SELECT_TEXT:
Selecciona texto en base al criterio dado por el usuario.
Despliega un catlogo de texto.

Entrada: Clave de texto (se permiten entradas genricas)


Salida: Tabla con informacin de encabezado en todos los
textos Encontrados

El mdulo de funcin SELECT_TEXT genera una tabla con los textos de


encabezado de todos los mdulos de texto correspondientes a la clave de bsqueda

Los textos SAPscript son especficos del cliente.

Los textos clave contienen cuatro caracteres:

OBJECT Objeto de texto


ID ID del texto
NAME Nombre del texto
LANGUAGE Lenguaje del texto

Generalmente se puede seleccionar texto con SELECT_TEXT usando un


asterisco *.

EL PROCESO DE ACTUALIZACIN DE T EXTO.

39
REFERENCIA: CLON015 C:\MIS DOCUMENTOS\SAPSCRIPT COMPLETO.DOC
INTERNACIONAL DE SISTEMAS S.A. DE C.V. C REACIN DE FORMULARIOS CON
SAPSCRIPT

La mayora de los documentos SAPscript en los programas de aplicacin se


salvan con el procedimiento de actualizacin.

El concepto de actualizacin del R/3 se explica completamente en la


Documentacin R/3.

El modo BACKUP (V = Actualizacin, D = Directo sin Actualizacin) es un


atributo de una clase de documento, es decir, de todos los documentos alojados en
un objeto de texto particular. El desarrollador define este modo en una transaccin
separada.

Tools Word processing ... y Environment Settings)

Cuando se salva un texto por medio del procedimiento de actualizacin, todos


los mdulos de funcin trabajan con el texto en memoria.

El texto en memoria contiene todos los cambios realizados en el programa de


aplicaciones.

Para almacenar cambios a un texto en la base de datos:


Utilizar COMMIT_TEXT
Utilizar el comando ABAP/4 COMMIT WORK

Si no se realizan los pasos descritos arriba, todos los cambios se perdern y la


actualizacin se terminar.
LEYENDO, SALVANDO Y BORRANDO T EXTO.

READ_TEXT: Lee un solo texto desde el texto en memoria o desde la base de


datos en el rea de trabajo.

Entrada: Clave de texto.


Salida: HEADER y LINES

SAVE_TEXT: Almacena un texto desde el rea de trabajo en el texto en


memoria o en la base de datos.

Entrada: HEADER y LINES

DELETE_TEXT: Borra uno o ms textos en texto de memoria o en la base de


datos

Entrada: Texto clave (puede ser genrico)

ACTUALIZACIN DE TEXTOS.

COMMIT_TEXT
Actualiza texto desde el texto de memoria en el archivo de actualizacin.
La memoria de texto se limpia despus de una llamada exitosa.

COMMIT WORK
Llamada desde un programa de aplicacin (Comando ABAP/4).
Necesario para almacenar texto en la Base de Datos.

40
REFERENCIA: CLON015 C:\MIS DOCUMENTOS\SAPSCRIPT COMPLETO.DOC
INTERNACIONAL DE SISTEMAS S.A. DE C.V. C REACIN DE FORMULARIOS CON
SAPSCRIPT

Cuando el R/3 salva texto (o datos en general) por medio de actualizacin,


este toma lugar asincronamente en un proceso separado, llamado tarea de
actualizacin.

Para almacenar cambios de texto por el procedimiento de actualizacin de


texto:
Utilice COMMIT_TEXT.
Utilice el comando de ABAP/4 COMMIT WORK.

COMMIT_TEXT no reemplaza al comando ABAP/4 COMMIT WORK.

Se puede llamar el COMMIT_TEXT y el COMMIT WORK slo una vez por


unidad lgica de trabajo (LUW), y hacerlo al final del procedimiento.

Si no se ejecutan el COMMIT_TEXT o el COMMIT WORK, todos los cambios


a los textos se perdern.

Despus de que se ha ejecutado un COMMIT_TEXT, el texto de memoria


queda vaco.

SALVANDO TEXTO DIRECTAMENTE.

Como una alternativa para la actualizacin del archivo se puede salvar texto
directamente en la base de datos. Esto aplica a todos los textos cuyos objetos de
texto tienen el modo backup D.

El modo BACKUP (V = actualizacin, D = Directo sin actualizacin) es un


atributo de una clase de texto completa, esto es, de todos los textos localizados para
un objeto de texto particular. El desarrollador define este modo en una transaccin
individual (Tools Word processing ... y Environment Settings)

Para un procesamiento masivo de textos (como en transporte, copias de


clientes o reorganizacin de la compaa), se puede especificar el modo backup
temporalmente como D.

Para hacer uso de este modo temporal bajo SAVE_TEXT o DELETE_TEXT,


utilice el parmetro SAVEMODE_DIRECT.

Cuando se define el SAVEMODE_DIRECT = X, el mdulo de funcin


SAVE_TEXT y DELETE_TEXT actan como se muestra arriba (imagen pg. 7-10).

SAVEMODE_DIRECT trabaja slo una vez, para una sola llamada del mdulo
de funcin correspondiente.

NOTA: No mezclar actualizacin normal con SAVEMODE_DIRECT bajo


ninguna circunstancia.

41
REFERENCIA: CLON015 C:\MIS DOCUMENTOS\SAPSCRIPT COMPLETO.DOC
INTERNACIONAL DE SISTEMAS S.A. DE C.V. C REACIN DE FORMULARIOS CON
SAPSCRIPT

APENDICE A
PERSONALIZANDO FORMULARIOS
Invoice Forms (SD) (Forma de factura)
Order Form (MM) (Forma de Ordenes)
Account Statement (FI) (Forma de Estado de Cuenta)

NAVEGANDO EN LA PERSONALIZACIN DE FORMULARIOS

Para accesar la Gua de implementacin de personalizacin de R/3, se


selecciona:
Tools Business Engineering Customizing, y luego Enterprise IMG

La Gua de Implementacin Enterprise (IMG) es un apartado de la Referencia


IMG de SAP (de donde es generado).

Desde este men, se puede llegar a la aplicacin apropiada (como Financial


accounting, Logistics general o Sales and Distribution)

INVOICE FORM (SD) (FORMA DE FACTURA) I

Para asignar programas de impresin dentro de SD, se selecciona:


Sales and Distribution Basic Functions Output Output
determination Process output and forms Assign forms and programs.

En la caja de dilogo, se selecciona el formulario para una transaccin


desde SD (de tipo salida).

INVOICE FORM (SD) (FORMA DE FACTURA) II

42
REFERENCIA: CLON015 C:\MIS DOCUMENTOS\SAPSCRIPT COMPLETO.DOC
INTERNACIONAL DE SISTEMAS S.A. DE C.V. C REACIN DE FORMULARIOS CON
SAPSCRIPT

Seleccionar Assign forms and programs. Esta ventana de dilogo da


acceso a diferentes clases de formularios de SD.

Posicionarse en la lnea deseada y seleccionar Choose.

INVOICE FORM (SD) (FORMA DE FACTURA) III

La asignacin de un programa de impresin y un formulario se de termina de


acuerdo al tipo de mensaje.
El tipo de mensaje indica el tipo de formulario que se va a usar.
La columna 3 (medium) indica la manera en el que el mensaje se va a mandar.
La columna 4 contiene las entradas de los programas de impresin
estndares.
Si desea cambiar el programa de impresin o el formulario, debe ingresar su
objeto propio (o un objeto modificado) hasta este punto.

Ver el material del Apndice B concerniente a modificaciones.

ORDER FORM (MM) (FORMA DE ORDENES) I

Para asignar programas de impresin dentro de Manejo de Materiales (MM),


se selecciona:
Material Management Purchasing Messages Layout sets
for messages Customize/Assign layout set for purchase order.

ORDER FORM (MM) (FORMA DE ORDENES) II

La caja de dilogo te permite entrar a las transacciones de formas de


ordenes de compra.

Selecciona la transaccin que se necesite colocando el cursor en ella.

ORDER FORM (MM) (FORMA DE ORDENES) III

Se pueden asignar programas de impresin a formularios de acuerdo al


tipo de salida.

Las entradas de los programas estndares se graban aqu.

Para cambiar el programa de impresin o el formulario, debe ingresar su


objeto propio.

Ver el material del Apndice B concerniente a modificaciones.

ACCOUNT STATEMENT (FI) (FORMA DE ESTADO DE CUENTA) I

Para asignar programas de impresin en los mdulos FI (un estado de


cuenta por ejemplo). Seleccionar:

Financial Accounting Financial Accounting Global Settings


Correspondence Define form names for correspondence print

43
REFERENCIA: CLON015 C:\MIS DOCUMENTOS\SAPSCRIPT COMPLETO.DOC
INTERNACIONAL DE SISTEMAS S.A. DE C.V. C REACIN DE FORMULARIOS CON
SAPSCRIPT

ACCOUNT STATEMENT (FI) (FORMA DE ESTADO DE CUENTA) II

Para asignar programas de impresin a formularios, seleccionar:

Define form names for correspondence print

Las entradas de los programas estndar son grabados.

Para hacer modificaciones al formulario o a programas de impresin, ver


tambin el Apndice B.

OUTGOING PAYMENTS (FI) I

Para cambiar la entrada de programas de impresin y formularios para


salida de pagos dentro de FI, seleccionar:

Financial Accounting Accounts Receivable and Accounts


Payable Business Transactions Outgoing payments Outgoing
payments Global Settings Automatic Outgoing Payments Payment
method/Bank Selection Configure payment program.

OUTGOING PAYMENTS (FI) II

Para cambiar el programa de impresin, seleccionar Ctry payment


methods.

La caja de dilogo muestra los pases disponibles.

Dar doble click en el pas deseado.

OUTGOING PAYMENTS (FI) III

Dar doble click en el mtodo de pago de los que se despliegan.

En el ejemplo (pg. 8-13 Appendix A Customizing R/3 Layout sets) se


seleccion el mtodo de pago C (cheque).

OUTGOING PAYMENTS (FI) IV

Ingresar los cambios al programa de impresin.

OUTGOING PAYMENTS (FI) V

Para cambiar el formulario, seleccionar Paying Company Codes.

Dar doble click para seleccionar el pas.

44
REFERENCIA: CLON015 C:\MIS DOCUMENTOS\SAPSCRIPT COMPLETO.DOC
INTERNACIONAL DE SISTEMAS S.A. DE C.V. C REACIN DE FORMULARIOS CON
SAPSCRIPT

El mismo mtodo de pago se despliega en los programas de impresin.


Seleccione las entradas apropiadas. En el ejemplo el mtodo de pago es
Cheque.

OUTGOING PAYMENTS (FI) VI

Para ir a la entrada del medio de pago, seleccionar Form data.

APENDICE B.
MODIFICACIONES
Visin General: Para realizar modificaciones.
En el formulario
En el programa de impresin

PARA REALIZAR MODIFICACIONES.

Para modificar formularios:


Copiar los formularios relevantes como Z o Y Z o Y son los
rangos de nombre para el cliente, hacer todas las modificaciones
en las copias.
Grabar el formulario nuevo en la Gua de Implementacin
(Implementation Guide) (IMG) Ver apndice A.
Para utilizar campos o elementos de bases de datos, modificar ell
programa de impresin. Copiar los programas de impresin como
son Z o Y, modificar las copias, y grabarlas en el IMG.
Ver apndice A.

COPIAR FORMULARIOS.

Para copiar formularios, seleccionar Tools Word procesing Layout set del
men principal de R/3.

Despus seleccionar Utilities Copy from client.

El cliente objetivo es siempre el cliente con el que esta actualmente en el


sistema.

Despus de esto ya se puede editar el formulario en el rango de nombre del


cliente.

MODIFICANDO PROGRAMAS DE IMPRESIN.

Para copiar el programa objeto (Z o Y), seleccionar ABAP-/4


Workbench ABAP/4 Editor. Despus seleccionar Program Copy.

45
REFERENCIA: CLON015 C:\MIS DOCUMENTOS\SAPSCRIPT COMPLETO.DOC
INTERNACIONAL DE SISTEMAS S.A. DE C.V. C REACIN DE FORMULARIOS CON
SAPSCRIPT

Ahora se puede ya mirar ya a travs del cdigo del programa para encontrar
los lugares en donde se desean hacer las modificaciones. En esta etapa, es valioso
considerar si hay puntos en los que pudiera ser funcional incluir accesos adicionales
a las tablas de la base de datos.

Si se experimentan problemas de impresin, usar el debugger, seleccionando


Tools Word processing Layout set Utilities Activate debugger.

PRUEBA DE IMPRESIN.

Despus de modificar formularios, se puede ver previamente antes de


imprimirlo seleccionando Utilities Test print.
Las posiciones y el tamao de las ventanas sern indicadas.
Todos los elementos de texto de la ventana principal se visualizan, no importa
cuantas pginas ocupe. Todas las ventanas en estas pginas tambin se imprimen.
Los smbolos de programa se reemplazan por Xs.

46
REFERENCIA: CLON015 C:\MIS DOCUMENTOS\SAPSCRIPT COMPLETO.DOC
INTERNACIONAL DE SISTEMAS S.A. DE C.V. C REACIN DE FORMULARIOS CON
SAPSCRIPT

APENDICE C.
FUENTES.
Estilos de Fuentes
Utilizando estilos de Fuentes
Fuentes del sistema y fuentes de impresin

VISIN GENERAL DE LAS FUENTES.

Este apndice intenta dar una visin general de las fuentes que se utilizan en
SAPscript.

Para accesar la transaccin de mantenimiento de fuentes (SE73), seleccionar


Tools Word processing Font.

FAMILIAS DE FUENTES.

Todas los nombres de fuentes que se pueden usar estn agrupados en


familias. Existe tambin una bandera para mostrar si la fuente es proporcional o
equidistante.

El mantenimiento a las familias de fuentes se hace con la transaccin de


mantenimiento de fuentes. Tambin se puede dar mantenimiento a los atributos
Proportional o Equidistant aqu.

FUENTES DEL SISTEMA.

Una fuente del sistema (Fuente SAP) es la combinacion de familias de


fuentes, tamao de letra y los atributos bold e italic. La seleccin de la fuente usada
en los procesos de SAPscript siempre se refiere a una fuente del sistema.

FUENTES DE IMPRESIN.

Una fuente de impresin es una combinacin del tipo de impresora y una


fuente del sistema.

Las fuentes de impresin son las fuentes que SAPscript tiene disponibles en
los dispositivos. (impresoras, pantallas, telex etc.). Para las fuentes proporcionales,
deben grabarse en el formato Adobe AFM (Adobe Font Metrics) los datos metricos.

47
REFERENCIA: CLON015 C:\MIS DOCUMENTOS\SAPSCRIPT COMPLETO.DOC
INTERNACIONAL DE SISTEMAS S.A. DE C.V. C REACIN DE FORMULARIOS CON
SAPSCRIPT

Para las fuentes equidistantes, los valores deben darce en el CPI (Characters Per
Inch), Caracteres por pulgada.

SAPscript tiene una conversin automtica entre las fuentes del sistema de un
documento y las fuentes de impresora instaladas en una impresora en particular.
Para habilitar estas conversiones, es necesario tener fuentes de reemplazo para
cada famila de fuentes.

Las conversiones entre fuentes del sistema y fuentes de impresora se


despliegan en el mantenimiento de fuentes. Se puede por ejemplo, convertir una
fuente dada por el sistema para diferentes impresoras, o convertir diferentes fuentes
del sistema para una sola impresora.

CDIGOS DE BARRA DEL SISTEMA Y DE IMPRESIN.

El atributo de cadena de caracteres Bar Code (Cdigo de barras), permite


imprimir cdigos de barra utilizando SAPscript. El mantenimiento de los diferentes
tipos de cdigos de barras se hace independientemente de cualquier dispositivo,
como cdigos de barras del sistema.

Para los tipos para impresoras que soportan impresin de cdigos de barras,
la impresora establece una conexin con el control especfico del dispositivo,
conocido como control de impresin. El mantenimiento de los controles de impresin
se hace con la transaccion de administracin de spool. Para accesar esta
transaccin, se selecciona:
Tools Administration Spool Spool Admimnistration.

Cuando se imprime un cdigo de barras, primero se manda un control de


impresin llamado cdigo prefijo a la impresora. Este es seguido por los datos del
cdigo de barras (por ejemplo un nmero de 8 dgitos). Finalmente otro control de
impresin, el cdigo sufijo, se manda.

CONTROLES DE IMPRESIN.

Un control de impresin es una secuencia de control que se manda a un


dispositivo que tiene una direccin asignada con un nombre simblico. Se usa la
transaccin de administracin del spool para dar mantenimiento a los controles de
impresin de cada tipo de dispositivo. Para accesar esta transaccin, se selecciona:
Tools Administration Spool Spool Admimnistration.

Los controles de impresin son los responsables de controlar las fuentes de


impresora y los cdigos de barras. En la transaccin de mantenimiento de fuentes,
solo se ingresa el nombre simblico del control de impresin para fuentes de
impresin cdigos de barras.

La impresora es controlada por varios drivers que convierten el formato de


salida interno de SAPscript (OTF,output text format) en secuencias de control que
puedan ser interpretadas por las impresoras. Las secuencias de control se definen
por lo general usando controles de impresin. En la transaccin de administracin del
spool se asignan los drivers para los tipos de dispositivos.

48
REFERENCIA: CLON015 C:\MIS DOCUMENTOS\SAPSCRIPT COMPLETO.DOC
INTERNACIONAL DE SISTEMAS S.A. DE C.V. C REACIN DE FORMULARIOS CON
SAPSCRIPT

APENDICE D.
INSERTAR ELEMENTOS GRFICOS.
Ejemplo: Insertando el logotipo de una compaa.

REQUERIMIENTOS.

Para insertar una grfica en un formulario:


La grfica debe estar disponible en la terminal en formato TIFF (Tag
Image File Format).
Definir una ventana nueva en el formulario. Despus de cargar la
grfica en la forma de texto estndar, se incorpora la grfica como
mdulo de texto en la nueva ventana.
Para cargar el archivo TIFF en texto estndar, se usa el reporte
RSTXLDMC de ABAP/4.

RSTXLDMC: INSERTANDO UNA GRFICA.

Para insertar la grfica en un formulario, se usa el reporte RSTXLDMC.

Usar RSTXLDMC para salvar el archivo TIFF en la terminal. El sistema sugiere


un nombre para el texto: ZHEX-MACRO-*. El asterisco se refiere al tipo del archivo, el
ejemplo el archivo se llama BMON, as es que el nombre sera ZHEX-MACRO-BMON.
Usar el ID ST y el lenguaje de log-on.

Se puede especificar la posicin exacta de la grfica cuando se carga. Esta


posicin es independiente de la posicin de la ventana en la pgina donde aparece.

Para verificar el cambio resultante en el formulario, seleccionar:


Utilities Print test.

Se debe correr la prueba de impresin con una impresora que soporte


grficos.

49
REFERENCIA: CLON015 C:\MIS DOCUMENTOS\SAPSCRIPT COMPLETO.DOC

Anda mungkin juga menyukai