Alexander Sabino ASPEN Procwork 2003

Smart Forms SAP 4.6c

_____________________________________________________________________

ndice
O QUE SMART FORMS..................................................................................................................................................................4
PARMETROS DEFAULT DO SMART FORMS.............................................................................................................................5
INTERFACE DO SMART FORMS.....................................................................................................................................................6
ATRIBUTOS DO FORMULRIO......................................................................................................................................................7
CARACTERSTICAS GERAIS.........................................................................................................................................................................7
OPES DE SADA....................................................................................................................................................................................8
.............................................................................................................................................................................................................8
DEFINIES GLOBAIS......................................................................................................................................................................9
DADOS GLOBAIS......................................................................................................................................................................................9
CTGS...................................................................................................................................................................................................10
SMB. CAMPO........................................................................................................................................................................................11
INICIALIZAO.......................................................................................................................................................................................12
ROTINAS FORM..................................................................................................................................................................................13
FORM PAINTER.................................................................................................................................................................................14
OBJETOS DO SMART FORMS........................................................................................................................................................15
OBJETO PGINA.....................................................................................................................................................................................16
Opes de Sada...........................................................................................................................................................................17
Tela de fundo................................................................................................................................................................................18
OBJETO JANELA.....................................................................................................................................................................................19
Opes de sada...........................................................................................................................................................................20
Condies.....................................................................................................................................................................................21
OBJETO GRFICO...................................................................................................................................................................................22
Opes de sada...........................................................................................................................................................................22
Condies ....................................................................................................................................................................................22
OBJETO ALTERNATIVA.............................................................................................................................................................................23
Caractersticas Gerais.................................................................................................................................................................24
Opes de Sada...........................................................................................................................................................................25
Condies.....................................................................................................................................................................................25
OBJETO ENDEREO................................................................................................................................................................................26
Opes de Sada...........................................................................................................................................................................27
Condies.....................................................................................................................................................................................27
OBJETO TEXTO.................................................................................................................................................................................28
Opes de sada...........................................................................................................................................................................31
Condies.....................................................................................................................................................................................31
OBJETO COMANDO.................................................................................................................................................................................31
Condies.....................................................................................................................................................................................31
OBJETO LINHAS DE PROGRAMA................................................................................................................................................................32
Condies.....................................................................................................................................................................................32
OBJETO CLASSIFICADOR..........................................................................................................................................................................33
Opes de Sada...........................................................................................................................................................................33
Condies ....................................................................................................................................................................................33
OBJETO LOOP.....................................................................................................................................................................................34
Horas............................................................................................................................................................................................35

Alexander Sabino

Pgina

Smart Forms SAP 4.6c

_____________________________________________________________________
Opes de Sada...........................................................................................................................................................................35
Condies.....................................................................................................................................................................................35
OBJETO TABELA....................................................................................................................................................................................36
Table Painter................................................................................................................................................................................37
Dados...........................................................................................................................................................................................37
Horas............................................................................................................................................................................................37
Opes de Sada...........................................................................................................................................................................37
Condies.....................................................................................................................................................................................37
Inserindo um texto ou grfico em uma clula da tabela..............................................................................................................38
OBJETO PADRO....................................................................................................................................................................................39
OBJETO SEO COMPLEXA......................................................................................................................................................................39
CHAMANDO O SMARTFORMS NO PROGRAMA ABAP..........................................................................................................40
BIBLIOGRAFIA..................................................................................................................................................................................42

Alexander Sabino

Pgina

Smart Forms SAP 4.6c

_____________________________________________________________________

O que Smart Forms.

Smart Forms uma ferramenta de desenvolvimento, que est presente a partir da verso 4.6c do SAP.
Com ele possvel criar formulrios de SAPScript sem a necessidade de programar todo o
formulrio. Ao invs disso, o usurio arrasta-e-solta os objetos no Form Painter.

possvel tambm criar tabelas complexas utilizando um assistente.

Ao se criar um formulrio pelo Smart forms, gerado um mdulo de funo Standard, inclusive com
os parmetros de importao, exportao, changing, tabelas e excees. Alguns parmetros so
inseridos por default, estes no podem ser alterados.

Alexander Sabino

Pgina

Smart Forms SAP 4.6c

_____________________________________________________________________

Parmetros default do Smart forms

Ao se criar um smart forms, criado tambm alguns parmetros default na interface do modulo de funo.
Os parmetros default so os seguintes:

Importao:
o ARCHIVE_INDEX
o ARCHIVE_INDEX_TAB
o ARCHIVE_PARAMETERS
o CONTROL_PARAMETERS
o MAIL_APPL_OBJ
o MAIL_RECIPIENT
o MAIL_SENDER
o OUTPUT_OPTIONS: So as opes de sada do sapscript ( como se fosse a estrutura ITCPO,
s que com mais opes)
o USER_SETTINGS
Exportao:
o DOCUMENT_OUTPUT_INFO
o JOB_OUTPUT_INFO
o JOB_OUTPUT_OPTIONS
Excees:
o FORMATING_ERROR
o INTERNAL_ERROR
o SEND_ERROR
o USER_CANCELED

Alexander Sabino

Pgina

Smart Forms SAP 4.6c

_____________________________________________________________________

Interface do Smart Forms

Esta a interface do smartforms. Note que ela se

assemelha a interface de um mdulo de funo
possvel inserir novos parmetros de
importao/exportao/tabelas ou excees, porm, no
possvel alterar os parmetros defaults, nem excludos.

Neste canto ficam as opes do smartforms em formato de

rvore.
Em opes globais possvel:
Configurar os atributos do formulrio como o formato de
pgina, o nmero de caracteres por polegada, o n de linhas
por polegada e o estilo.
Em interface do formulrio possvel adicionar novos
parmetros (ver balo acima)
Em definies globais onde ser feita todas as declaraes
globais do formulrio como: Variveis, Smbolos, etc...
possvel, inclusive, incluir um cdigo abap que ser executado
assim que o smartforms for chamado

Alexander Sabino

Nesta parte da tela fica o

Form Painter, com ele
possvel arrastar objetos e
posicion-los no formulrio.

Pgina

Smart Forms SAP 4.6c

_____________________________________________________________________

Atributos do Formulrio
Nesta seo possvel configurar como o formulrio ir se comportar. O n Atributos do Formulrio se
divide em duas abas:

Caractersticas Gerais

Estas opes indicam em que condies o

formulrio ser traduzido

Alexander Sabino

Pgina

Smart Forms SAP 4.6c

_____________________________________________________________________

Opes de Sada

Indique aqui o formato de

pgina de seu formulrio.
Indique aqui o nmero de
caracteres por polegada.

Indique aqui o nmero

de linhas por polegada.
Indique aqui o estilo
(uma espcie de
modelo) do seu
formulrio.

Indique aqui se a sada do formulrio ser no formato OTF (flag

desmarcado) ou no formato XML (flag marcado).
No modo de sada voc indicar por qual meio a sada XML se dar. As
opes so: S para Spool, A para aplicao, I para ITS e B para
business connector.
No dispositivo de sada, dever ser indicada a impressora que ser utilizada
para a impresso do XSF.

Alexander Sabino

Pgina

Smart Forms SAP 4.6c

_____________________________________________________________________

Definies Globais
Neste n voc dever indicar quais so os dados globais (variveis, smbolos e etc...) do formulrio, ele se
divide em 5 abas:

Dados Globais
Nesta Aba voc dever indicar as variveis e estruturas globais. Toda varivel e estrutura que ser utilizada no
formulrio e que no esteja declarada no n interface do formulrio dever ser declarado aqui.

Alexander Sabino

Pgina

Smart Forms SAP 4.6c

_____________________________________________________________________

Ctgs.

Alexander Sabino

Pgina 10

Smart Forms SAP 4.6c

_____________________________________________________________________

Smb. Campo
Nesta aba devero ser declarados todos os smbolos do formulrio.

Alexander Sabino

Pgina 11

Smart Forms SAP 4.6c

_____________________________________________________________________

Inicializao
Nesta aba possvel escrever um cdigo abap que ser executado quando o formulrio for chamado. Eqivale
ao evento initialization do report.

No exemplo acima todos itens de um determinado documento de vendas selecionado quando o formulrio
iniciado. Note que no alto existem duas janelas: Parmetros de entrada e Parmetros de sada.
Nos parmetros de entrada devero ser indicadas todas as variveis ou estruturas que sero lidas no cdigo
abap. Nos parmetros de sada devero ser indicadas todas as variveis ou estruturas que recebero dados e
sero utilizadas no restante do formulrio.
Tanto os parmetros de entrada, quanto os de sada devero estar declarados em dados globais ou na interface
do mdulo de funo.

Alexander Sabino

Pgina 12

Smart Forms SAP 4.6c

_____________________________________________________________________

Rotinas FORM
Nesta aba so indicadas todas as rotinas form que sero utilizadas no formulrio.

Alexander Sabino

Pgina 13

Smart Forms SAP 4.6c

_____________________________________________________________________

Form Painter
O Form painter uma interface onde os objetos do formulrio podem ser posicionados livremente.

Alexander Sabino

Pgina 14

Smart Forms SAP 4.6c

_____________________________________________________________________

Objetos do Smart Forms

O Smart forms possui 13 objetos que podem ser usados para a confeco do formulrio:

Pgina: Cria uma pgina no formulrio.

Janela: Cria uma janela (para insero de textos, grficos ou tabelas) em uma pgina do formulrio
Grfico: Insere um grfico bitmap em uma janela do formulrio
Alternativa: Com este objeto possvel inserir um se no formulrio.
Endereo: Com este objeto possvel inserir uma caixa de texto, j formata, contendo o endereo de
um centro (filial) ou cliente.
Texto: Inclui um texto em uma janela do formulrio.
Comando: Insere um comando de impressora ou uma transio de pgina
Linhas de Programa: Insere um cdigo ABAP no formulrio
Classificador: Com este objeto possvel agrupar vrios objetos em um s.
LOOP: Com este objeto possvel inserir um LOOP de uma tabela interna, inserindo os resultados
em um campo de texto, por exemplo.
Tabela: Com este objeto possvel inserir uma tabela (como a do Word) no formulrio. Os dados
viro de uma tabela interna.
Padro: Insere uma tabela vazia. Os dados devero vir de um outro objeto, como um LOOP, por
exemplo.
Seo Complexa: Rene os objeto LOOP, tabela e padro em um nico objeto.

Alexander Sabino

Pgina 15

Smart Forms SAP 4.6c

_____________________________________________________________________

Objeto Pgina
Com este objeto possvel incluir uma pgina no formulrio. Existem 3 abas de configurao neste objeto que
sero explicadas abaixo:

Selecione aqui qual ser a

pgina seguinte.

Indique aqui qual ser o formato do

nmero de pgina.

Alexander Sabino

Indique aqui qual ser o

comportamento do
nmero da pgina ao se
mudar de pgina.

Pgina 16

Smart Forms SAP 4.6c

_____________________________________________________________________

Opes de Sada

Indique aqui se o formato de pgina ser

vertical (retrato) ou horizontal (paisagem)

Neste campo possvel determinar de que bandeja

da impressora destino retirado o papel.
Para determinar isto, indicar aqui qual controle de
impresso que deve ser enviado para impressora
destino.
Os valores possveis so:
TRY01: Utilizar papel da bandeja 1
TRY02: Utilizar papel da bandeja 2
TRY03: Utilizar papel da bandeja 3

Alexander Sabino

Este atributo controla qual modo de

impresso deve ser utilizado:
SIMPLEX (impresso de apenas
um lado), DUPLEX (impresso nos
dois lados) ou TUBLE DUPLEX
(os dois lados invertidos).

Pgina 17

Smart Forms SAP 4.6c

_____________________________________________________________________

Tela de fundo
Nesta aba possvel indicar uma tela de fundo para a pgina que pode ser exibida somente durante a prvia
da impresso ou tambm na impresso. A imagem bitmap utilizada j dever ter sido carregada pela transao
SE76.

Indique aqui os atributos da

imagem bitmap

Indique aqui a resoluo e o tambm quando a

imagem dever ser exibida: Na exibio prvia da
impresso ou na exibio prvia da impresso e
impresso.

Alexander Sabino

Pgina 18

Smart Forms SAP 4.6c

_____________________________________________________________________

Objeto Janela
Uma janela pode contm textos, imagens e tabelas.

Este flag indica se esta janela a janela

principal do formulrio.
Geralmente a janela principal a janela
main.
S pode existir uma janela principal em
cada pgina.

Alexander Sabino

Pgina 19

Smart Forms SAP 4.6c

_____________________________________________________________________

Opes de sada

Indique aqui as margens esquerda e

superior, assim como a largura e altura da
janela.

Indique aqui se a janela ser envolvida por uma linha

(e sua espessura). Tambm possvel incluir um
sombreamento nas linhas da janela.

Alexander Sabino

Pgina 20

Smart Forms SAP 4.6c

_____________________________________________________________________

Condies
Nesta aba possvel determinar em que condies a janela ser exibida. Por exemplo: imprima esta janela
apenas se o centro for Rio de Janeiro.

Indique aqui as condies

Tambm possvel indicar em que

momento a janela ser impressa.

Alexander Sabino

Pgina 21

Smart Forms SAP 4.6c

_____________________________________________________________________

Objeto Grfico
Com este objeto possvel inserir uma imagem bitmap em qualquer parte do formulrio.
OBS: A imagem a ser inserida j dever ter sido carregada pela transao SE76.

Indique aqui os atributos da

imagem bitmap, como: nome,
objeto e identificador.

Indique tambm se ele

ser impresso de forma
colorida ou em preto e
branco.

Indique aqui a resoluo.

Quanto maior a resoluo,
menor ser a imagem exibida.

Opes de sada
Ver objeto janela

Condies
Ver objeto janela
Alexander Sabino

Pgina 22

Smart Forms SAP 4.6c

_____________________________________________________________________

Objeto Alternativa
Com este objeto possvel incluir um se no formulrio, ou seja, voc pode definir qual objeto ser impresso
ou executado quando a condio for verdadeira e qual objeto ser impresso ou executado quando a condio
for falsa.

Insira abaixo do true todos os objetos que

devero ser impressos ou executados
quando a condio for verdadeira

Insira abaixo false todos os objetos que

devero ser impressos ou executados
quando a condio for falsa.

Alexander Sabino

Pgina 23

Smart Forms SAP 4.6c

_____________________________________________________________________

Caractersticas Gerais

Indique aqui as condies que

devero ser consideradas como
verdadeira.

Voc pode indicar tambm quais condies adicionais

sero consideradas como verdadeiras.

Alexander Sabino

Pgina 24

Smart Forms SAP 4.6c

_____________________________________________________________________

Opes de Sada

Indique aqui o estilo que ser utilizado neste

objeto. Um estilo contm todas as
configuraes de caracteres e pargrafos.

Ao marcar este flag voc evita que o

texto seja separado por uma quebra de
pgina.

Indique aqui se a janela ser envolvida por uma linha

(e sua espessura). Tambm possvel incluir um
sombreamento nas linhas da janela.

Condies
Ver objeto Janela

Alexander Sabino

Pgina 25

Smart Forms SAP 4.6c

_____________________________________________________________________

Objeto Endereo
Com este objeto possvel inserir um endereo, j formatado, de uma organizao, de um cliente ou de um
centro de trabalho (filial).
Indique aqui qual endereo voc deseja inserir, seja o de uma
organizao, privado (cliente) ou de um centro de trabalho.
possvel ainda selecion-lo de forma dinmica, ou seja, a partir
de um smbolo (ou varivel) de programa. Para isso, selecione
a opo 4 e no campo texto ao lado insira a varivel entre &.

Indique o nmero do endereo (para

endereo organizao, privado ou centro
de trabalho) e/ou n. pessoal (para

endereo privado).

Alexander Sabino

Pgina 26

Smart Forms SAP 4.6c

_____________________________________________________________________

Opes de Sada
Indique aqui o estilo que ser utilizado neste
objeto. Um estilo contm todas as
configuraes de caracteres e pargrafos.

Indique aqui as margens esquerda e

superior da janela, assim como a
largura e altura.

Indique aqui se a janela ser envolvida por uma linha

(e sua espessura). Tambm possvel incluir um
sombreamento nas linhas da janela.

Condies
Ver Objeto Janela

Alexander Sabino

Pgina 27

Smart Forms SAP 4.6c

_____________________________________________________________________

Objeto Texto
Insere um texto livre em uma janela ou em uma clula de uma tabela. Este objeto tambm poder ser usado
para receber os dados do objeto LOOP.
Escreva aqui o texto
Indique aqui se o texto ser um elemento
de texto, um mdulo include ou um texto
include.

Indique aqui se o texto ser

includo em um novo pargrafo,
em uma nova linha ou ser
anexada diretamente

Alexander Sabino

Pgina 28

Smart Forms SAP 4.6c

_____________________________________________________________________

Para a categoria de Mdulo de texto, ser exibida a seguinte tela:

Indique aqui o nome do texto.

Para a categoria de Texto Include, ser exibida a seguinte tela:

Alexander Sabino

Pgina 29

Smart Forms SAP 4.6c

_____________________________________________________________________

Indique o nome do texto, o objeto de

texto, o ID de texto e o idioma para
ser includo na caixa de texto

Alexander Sabino

Pgina 30

Smart Forms SAP 4.6c

_____________________________________________________________________

Opes de sada
Ver objeto Endereo.

Condies
Ver objeto Janela

Objeto Comando
Insere um comando de impressora ou uma transio de pgina.

Marque este flag para efetuar

uma transio para a pgina
selecionada no combo box..
Este comando determina que a
numerao de um pargrafo de
estrutura hierrquica reinicializado
para o valor de incio. Se no comando
estiver indicado um nome de um
pargrafo de estrutura hierrquica, a
respetiva numerao de pargrafo
inicializada com nveis inferiores da
estrutura hierrquica.

Indique o parmetros de spool que

sero modificados e seus
respectivos valores.

Indique aqui um comando de

impressora a ser impresso.

Condies
Ver objeto Janela

Alexander Sabino

Pgina 31

Smart Forms SAP 4.6c

_____________________________________________________________________

Objeto Linhas de Programa

Insere um cdigo abap dentro do smart forms.

Note que no alto existem duas janelas: Parmetros de entrada e Parmetros de sada.

Nos parmetros de entrada devero ser indicadas todas as variveis ou estruturas que sero lidas no cdigo
abap. Nos parmetros de sada devero ser indicadas todas as variveis ou estruturas que recebero dados
e sero utilizadas no restante do formulrio.

Tanto os parmetros de entrada, quanto os de sada devero estar declarados em dados globais ou na
interface do mdulo de funo.

Insira aqui os parmetros

de entrada

Insira aqui os parmetros

de sada

Insira o cdigo
abap nesta caixa de
texto.

Condies
Ver objeto Janela

Alexander Sabino

Pgina 32

Smart Forms SAP 4.6c

_____________________________________________________________________

Objeto Classificador
Permite agrupar vrios objetos em uma nica pasta. A partir deste objeto possvel tambm incluir
reas de rodap e cabealho no formulrio.
No exemplo abaixo foi includo o objeto texto na pasta classificadora.

Ao marcar este flag, ser aberta uma

rea de cabealho onde poder ser
inserido qualquer objeto. Eles sero
exibidos no incio de cada pgina e/ou
em quebra de pgina.

Opes de Sada
Ver objeto Alternativa

Ao marcar este flag, ser aberta uma

rea de rodap onde poder ser
inserido qualquer objeto. Eles sero
exibidos na quebra de pgina e/ou no
fim de uma seo.

Condies
Ver objeto Janela

Alexander Sabino

Pgina 33

Smart Forms SAP 4.6c

_____________________________________________________________________

Objeto LOOP
Com este objeto possvel incluir um loop em uma tabela interna. Por exemplo: listar todos os dados de uma
tabela interna.
Indique aqui o nome da tabela interna.
Obs.: a tabela interna dever estar
declarada ou na interface do mdulo de
funo ou em dados globais.

Indique aqui as
condies where para
leitura dos registros.

Indique aqui uma estrutura que ir

receber os dados da tabela interna. Esta
estrutura dever estar declarada em dados
globais.

Indique aqui o range de registros

que devero ser lidos.

Indique aqui um critrio de ordenao para

a leitura da tabela interna.

Alexander Sabino

Pgina 34

Smart Forms SAP 4.6c

_____________________________________________________________________

Horas
Na aba horas voc poder criar reas de rodap e cabealho, podendo inserir objetos nestas reas.

Opes de Sada
Ver objeto Texto

Condies
Ver objeto Janela

Alexander Sabino

Pgina 35

Smart Forms SAP 4.6c

_____________________________________________________________________

Objeto Tabela
Insere uma tabela (como a do Word) no formulrio. Este objeto depende de outros objetos como o objeto
Texto.

Ser necessrio inserir um objeto texto, ou grfico, para cada clula da tabela.

Indique aqui o
alinhamento

Indique aqui a largura da

tabela

Para criar a tabela existem 3 possibilidades:

Inserir uma tabela a partir de um modelo.
Inserir as configuraes das clulas manualmente. Neste caso
voc dever indicar em tipo de linha um nome para linha e ao
lado, configurar a largura de cada clula.
Desenhar a tabela com o table Painter

Alexander Sabino

Pgina 36

Smart Forms SAP 4.6c

_____________________________________________________________________

Table Painter

Nesta rea voc ir desenhar a

tabela

Dados
Ver objeto LOOP

Horas
Ver objeto LOOP

Opes de Sada
Ver objeto LOOP

Condies
Ver objeto Janela

Alexander Sabino

Pgina 37

Smart Forms SAP 4.6c

_____________________________________________________________________

Inserindo um texto ou grfico em uma clula da tabela

Insira um objeto texto dentro do objeto tabela e, na aba opes de sada, marque para a primeira clula da
linha, o flag nova linha e indique o nome da linha. Para as demais, apenas marque o flag clula nova,
deixando em branco o campo de nmero da clula.

Primeira clula da linha1

Segunda clula da linha 1

Alexander Sabino

Pgina 38

Smart Forms SAP 4.6c

_____________________________________________________________________

Objeto Padro
O objeto padro muito semelhante ao objeto tabela, a nica diferena que ele no possui a aba dados. Este
objeto poder ser usado para formatar dados estticos em uma tabela.
Para maiores informaes sobre sua interface, ver o objeto tabela.

Objeto Seo complexa

O objeto seo complexa rene os trs objetos mencionados acima (LOOP, Tabela e Padro) em um s.

Indique se este objeto ser um LOOP

(selecione simples e marque
Processamento repetitivo), tabela ou
padro.

Alexander Sabino

Pgina 39

Smart Forms SAP 4.6c

_____________________________________________________________________

Chamando o smartforms no programa ABAP

Para executar o smart forms a partir de um programa ABAP voc dever, antes, saber qual foi o nome do
mdulo de funo gerado para ele. Para isso, no menu ambiente selecione a opo Nome do mdulo de
funo. O nome do mdulo de funo ser exibido em uma mensagem de informao como demonstrado
abaixo:

Alexander Sabino

Pgina 40

Smart Forms SAP 4.6c

_____________________________________________________________________
A partir da, basta chamar o mdulo de funo no programa ABAP.

Alexander Sabino

Pgina 41

Smart Forms SAP 4.6c

_____________________________________________________________________

Bibliografia
Help do SAP 4.6c

Alexander Sabino

Pgina 42