Smartform Aspen

Treinamento interno
Smartforms Hortolândia - SP
SAP Smart Forms
Alexandre Sagrilo de Souza

Aspen – Procwork
Página 1 de 37
PDF Creator - PDF4Free v2.0 http://www.pdf4free.com
Treinamento interno
1. Introdução
SAP Smart Form é utilizado para criar formulários de impressão para SAP/R3. Os meios
de saída que essa ferramenta suporta são impressoras, fax, e-mail, ou internet (utilizando XML).
Algumas de suas vantagens são: criação e manutenção de formulários mais rapidamente e
com uma interface mais amigável, adaptação do layout sem nenhum conhecimento de
programação, saída em XML, etc.
Todos os novos formulários são desenvolvidos e disponibilizados utilizando a tecnologia do
Smartforms, porém a SAP garante o suporte e a continuidade dos formulários SAPscripts já
existentes, inclusive os desenvolvidos para clientes. Além disso, é possível efetuar a migração
para a nova tecnologia, permitindo assim uma padronização nos ambientes e favorecendo as
manutenções futuras.
Página 2 de 37
Treinamento interno
2. Conceitos básicos: Formulários script em SAPscript
Antes de iniciarmos os nossos estudos de Smartforms vamos recapitular cada um dos

componentes de um formulário script, utilizando a visão da tecnologia SAPscript.
• Páginas
o Todo formulário deverá conter, pelo menos, uma página. Esta página pode ser
configurada de acordo com as dimensões requeridas pelo cliente ou então por
padrão existentes no mercado;
o Só há a necessidade de mais de uma página por formulário quando o layout entre
elas diferenciarem, logo, quando estamos tratando de formulário com (n) páginas
idênticas, basta termos definido uma única página e considerar a página seguinte
como sendo a mesma. Mais adiante estaremos revendo este tópico;
quando estivermos trabalhando

com impressões matriciais, é
interessante mantermos as unidade de
medida: CH - caracteres para
comprimento e LN - linhas para altura.
• Janelas
o As janelas nada mais são que espaços pré-estabelecidos para limitação de áreas
nas páginas;
o Oferece a facilidade de lidarmos com características, formas e até edições
particulares para cada parte do todo;
o As janelas, no momento de sua criação podem ser sobrepostas umas nas outras,
exclusive utilizando o mesmo espaço físico;
em SAPscripts, uma das técnicas

utilizadas para linhas de grade é
justamente criar duas janelas
ocupando o mesmo espaço, sendo
uma para textos e outra para as linhas
horizontais e verticais.
Página 3 de 37
Treinamento interno
• Família de Parágrafos
o É possível criar uma biblioteca de formatos de parágrafos para um único
formulário;
o Para estes formatos podemos entender: definição de margens, recuos de
parágrafos, alinhamento, fonte, tabulação, etc;
o Este recurso é muito mais aplicado em impressões a laser ou jato de tinta, pois
podemos tratar as fontes e tabulações indiscriminadamente. O que não ocorre em
impressões matriciais – salve exceções de impressoras atuais que só faltam falar.
As mais antigas não possuem tanta flexibilidade e impede um bom aproveitamento
destes recursos;
o Para o SAPscript este recursos é um recurso interno do formulário, ou seja, se
para o formulário X eu criei o parágrafo Y eu não posso utilizar este parágrafo Y
em outro formulário Z;
• Família de caracteres
o Assim como as famílias de parágrafos, este recurso permite a criação de várias
formas de edição para fontes;
o Também sendo um recurso interno, permitindo o uso exclusivamente do seu
formulário;
• Programa chamador
o O SAPscript não trabalha sozinho, ele precisa de um programa ABAP para
gerenciar suas informações e ditar o que deve ser realizado;
o O programa ABAP fica encarregado de acessar o banco de dados, selecionar
informações pertinentes, formatá-las, agrupá-las e disponibiliza-las para o
formulário;
o As principais funções standards que devem ser componentes deste programa são:
OPEN_FORM – para a abertura e envio de informações do dispositivo de saída,
START_FORM inicialização de um formulário ou sua página específica,
WRITE_FORM impressão de trecho do formulário script restringidos por um
identificados chamado “Elemento de Texto”, END_FORM encerra o formulário ou
sua página e CLOSE_FORM finaliza a operação de impressão;
Página 4 de 37
Treinamento interno
3. Conceitos básicos: Formulários script em Smartforms
O Smartform é dividido inicialmente em duas partes: Opções Globais e Páginas e Janelas.

Vamos descrever cada uma delas e suas subdivisões:
• Opções Globais:
o Atributos do formulário: demonstrar as informações do criados e modificador do
formulário, a classe de desenvolvimento, os atributos de idioma, como: idioma
original e as traduções, formato de página, caracteres por polegada, linhas por
polegada, estilo padrão e saída por OTF ou XML
o Interface do usuário: esta interface é semelhante à interface que encontramos em
módulos de função, ou seja: importação, exportação, tabelas e exceções. Estas
interfaces serão utilizadas pelo(s) programas que farão uso do formulário
Smartform criado;
o Definições Globais: disponibiliza uma área para que sejam declarados campos,
estruturas e tabelas internas que serão aproveitadas em todo o formulário.
Identificar a sua familiaridades com os dados globais em programas ABAP;
• Páginas e Janelas:
o Página(s): identificador do formato do seu formulário, assim como o agrupador de
todos os demais subobjetos do script, como: janelas, gráficos, endereço. Neste nó
do formulário indicamos a forma de numeração do formulário, podendo ser
numérico ou alfa-numérico, indicador de página seguinte, formato vertical ou
horizontal, fonte de alimentação na impressora e método de impressão: Simplex
ou Duplex, este último só é possível quando o dispositivo esteja preparado para
impressões frente e verso de páginas e finalmente a utilização de marca d´água
ou timbre do formulário, adicionando imagem de fundo;
o Janela MAIN: assim como o SAPscript, o Smanrtform deve conter pelo menos
uma janela caracterizada como janela principal que deve estar presente em cada
uma das páginas. Suas propriedades são similares às demais janelas, o que
diferencia da tecnologia anterior é que o efeito de LOOP – leitura repetitiva – só
poderia ser realizado nesta janela;
Página 5 de 37
Treinamento interno
4. Componentes de uma janela
Janela Delimitador de uma área espacial de uma página

Gráfico Utilizado para inserir uma imagem no formulário,
podendo ser: uma logomarca, uma assinatura
virtual, uma fotografia, etc.
Esta imagem poderá ser tratada no sistema a
partir da transação SE78
Endereço Serve para identificar o número de endereço de
uma entidade presente em quase todos os
registros mestre, como Empresa T001-ADRNR,
cliente KNA1-ADRNR, etc.
Este campo também pode ser uma variável de
acordo com o dados globais do seu formulário,
indicando o nome do campo correspondente que
contém o número do endereço dinâmico entre (&)
Texto Utilizado para inserção de um texto no formulário.
Este texto pode estar mesclado de constantes e
variáveis, assim como formatações por parágrafos
e fontes.
Alternativa Recurso para que seja disponibilizado a
flexibilidade de tratar diferentes componentes,
conforme a regra estabelecida, ou seja, caso
queiramos dar um novo texto de acordo com o
conteúdo de uma variável, para isso este
componente sempre vem acompanhado de duas
opções: para a resposta afirmativa da
condição e para a negativa da condição.
Página 6 de 37
Treinamento interno
Comando Utilizado para enviar comando de impressão

diretamente para o dispositivo, como: número de
cópias, saída imediata, folha-de-rosto e até print-
controls para a impressora.
Os print-controls podem ser visualizados e
atualizados na transação SE73.
NOTA: é importante ter o manual do usuário do
dispositivo para enviar os comando em
Hexadecimal corretamente.
Programação Utilizado para a inserção de códigos ABAP para
extração e/ou tratamento de dados colhidos no
banco de dados do sistema
Classificador Recurso para definição de áreas de cabeçalho e
rodapé
Loop Leitura repetitiva de uma estrutura de tabela
interna para tratamento de entidades registros por
vez.
Tabela Criação de uma estrutura e grade e informações
alinhadas para exibição de itens de uma mesma
aplicação, como: itens de uma ordem de venda,
lista de funcionários.
Este componente facilita o trabalho que temos
atualmente de reestruturar linhas em um
formulário e também pode ser agregado de um
sistema de leitura seqüencial internamente.
Padrão Utilizado para subdividir uma janela em celular e
tratar o conteúdo de cada uma destas células
individualmente.
Seção complexa Serve como um coringa, podendo utilizar-se dos
recurso dos componentes: Loop, padrão e tabela.
Página 7 de 37
Treinamento interno
5. Como trabalhar com os componentes?
Para criar qualquer objeto no formulário você deve selecionar o nó de interesse em sua
estrutura e clicar com o botão direito do mouse para que seja aberto o menu popup. Entrar na
guia Criar e observar os componentes disponíveis para aquele nível do nó. Selecioná-lo.
Os componentes são criados com um nome pré-estabelecido pelo sistema, podendo
manter o mesmo ou determinar um nome que melhor identifique o componente, assim como a
sua descrição.
• Janela
Na aba “características gerais” você poderá indicar se esta é uma janela
principal.
Na aba “opções de saída” você poderá indicar o seu posicionamento na área
espacial de sua página, indicando: margem esquerda, margem superior, largura e
altura, ser definido se o componente será apresentado com linha de borda, qual a
sua espessura e se deseja o sombreamento em escalas de cinza em percentual.
Página 8 de 37
Treinamento interno
Na aba “Condições”, você poderá indicar uma ou mais variáveis para

condicionar a exibição destes componente em seu formulário. Da mesma forma
que a periodicidade da informação.
Página 9 de 37
Treinamento interno
• Gráfico
Pode ser tratado com valore fixos ou variáveis. Na aba “Características
gerais” você poderá informar o nome, o tipo de objeto e sua identificação.
Caso seja de interesse que estas informações tornem-se dinâmicas, basta
clicar no botão localizado na frente de cada campo para que o sistema passe a
aceitar um “ponteiro” que indicará a variável que contém a informação necessária.
Esta variável deve estar declarada globalmente e entre (&) ex. &V_OBJNOME&.
Há a possibilidade de classificar este objeto por monocromático, colorido ou
ambos dinamicamente.
Na aba “opções de saída” você poderá indicar o ponto de referência para a
montagem da imagem, como: a borda da janela ou o último parágrafo impresso.
Da mesma forma, você indicará o seu alinhamento: esquerda, direita ou
Página 10 de 37
Treinamento interno
justificado, oferecendo uma margem no campo indicado à frente com sua

respectiva unidade de medida. a indicação de borda com linhas e sombreamento.
• Endereço
i. Características gerais:
A determinação de categoria de endereço pode ser identificada por 1 –
organização, 2 – privado e 3 – centro de trabalho ou dinamicamente através da
indicação do “ponteiro” (variável global) que detém esta informação;
O número de endereço pode ser fixo ou variável, basta indicar no campo da
tela ou clicar no botão para converter para a recepção de um “ponteiro” de

dados;
Página 11 de 37
Treinamento interno
No quadro seguinte, você indicará o parágrafo que deve ser utilizado para a
impressão, assim como linhas utilizadas e país remetente;
ii. Opções de saída:

Há um campo para a indicação de um “estilo” para a impressão do texto.
Você pode fazer uso dos estilos disponibilizado no sistema ou criar o seu próprio
estilo.
uma vez que um estilo foi alterado,

todos os formulário que utilizam ele
serão afetados.
O flag “proteção de página” evita que o texto apresentado seja quebrado
entre páginas. Caso haja a quebra, o texto inteiro é transcrito na página
subseqüente.
iii. Condições:
idêntico aos itens anteriores
Página 12 de 37
Treinamento interno
• Alternativa
Você deverá indicar qual ou quais são os campos que farão parte da regra de
condição para seu processamento, indicando o nome do campo, seu operador
relacional e seu elemento de comparação.
ii. Opções de saída:

mesmas tela do componente Texto
iii. Condições:
idêntico aos componentes anteriores
• Comando
O flag transição para nova página faz a vez do comando NEW-PAGE do
SAPscript, ou seja, ele interrompe o processo e inicia uma nova página
Página 13 de 37
Treinamento interno
O campo “inserir controle de impressão” serve para que você coloque um

print-control específico. Por exemplo, para compactar fonte SF013, etc... Você
poderá consultar as variedades de print-controls na transação SE73
• Programação
Nos parâmetros de entrada você poderá identificar qual ou quais campos
você irá levar para dentro de seu código
Nos parâmetros de saída você indicará qual ou quais as variáveis será
preenchidas com o retorno do seu programa ABAP.
No editor de texto você poderá criar o seu código ABAP seguindo as regras
normais de programação, assim como a declaração de variáveis locais.
Caso você trabalhe com a programação estruturada em rotinas, a chamadas
das mesma devem ser realizadas neste ponto, porém a declaração das rotinas
devem ser globais, na aba “rotinas FORM”.
Página 14 de 37
Treinamento interno
• Classificador
i. Características gerais
Este componente irá agrupar demais componente que você queira que sejam
impressos ou no cabeçalho ou no rodapé das páginas.
• Loop
i. Dados:
Neste caso é indicado os campo que devem ser preenchidos com as suas
declarações globais. Subentende-se que houve um componente anterior que
alimentou uma tabela interna e esta deve ser declarada aqui. Da mesma forma,
declarar a estrutura que receberá o registro lido. Pode ser determinado a leitura de
registros fechados através do “de/até”.
Página 15 de 37
Treinamento interno
Também poderá utilizar este quadro para gerar os limitadores lógicos para a
leitura, realizando assim o filtro na leitura.
Finalmente a regra para uma reclassificação dos registro, mais comumente

conhecido como SORT.
ii. Horas:
Pode ser determinado a regra assim como foi determinada no componente
Classificador.
• Tabela
i. Tabela:
Única aba que se diferencia do componente Loop. Nela você definirá o seu
tio de linha para uma grade, subdividindo-a em celular numeradas
seqüencialmente.
Página 16 de 37
Treinamento interno
A largura da tabela deve compreender a somatória de todas as células

inseridas.
O tipo de linha deve possuir um identificador. Quando este tipo de linha for
definido como o Default, caso um subnó (texto por exemplo) não possuir a
identificação da sublinha, será assumido o tipo de linha padrão.
O tipo de linha também poderá possuir o flag de “proteção de página”,
conforme vimos anteriormente , ele inibe a quebra de informações entre páginas.
O conjunto de campos “n.Unit”, onde n é um número seqüencial para
identificação unívoca de uma celular e Unid a sua unidade de medida, serve para
que seja indicado a largura que esta célula irá assumir na grade.
Página 17 de 37
Treinamento interno
O modelo de tabela servirá para você determinar as linhas de grade que

deverão aparecer.
Os subnós podem ser textos, comandos ou outros tantos conforme a sua

necessidade. Na maioria dos casos utilizamos os textos para imprimir o conteúdo
da grade, observando que desta vez teremos uma subtela a mais nas opções de
saída para indicarmos o tipo de linha e célula de referência
Página 18 de 37
Treinamento interno
A primeira célula, referenciada ao

primeiro texto do subnó deve ser
preenchido da seguinte forma: Marcar
a Nova linha, indicar o tipo de linha. As
demais células referenciadas aos
outros textos devem ter somente o flag
“célula nova” marcado. Caso queira
ignorar alguma célula, basta indicar o
seu respectivo número no campo
correspondente.
• Padrão
i. Padrão:
Semelhante a tabela, o padrão você deve criar um tipo de linha informando o

tamanho da mesma, seu alinhamento horizontal e vertical;
O tipo de linha deve ter um nome unívoco;

Os campos DE e ATÉ servem para dimensionar o número de linhas da
matriz;
A referência servirá para que você indique uma tipo de linha já existente;
A altura indicará o espacejamento entre as linhas;
Página 19 de 37
Treinamento interno
E assim como a tabela, você terá (n) campos para declarar suas colunas –
células – que não deve ultrapassar o tamanho da linha;
Assim como na tabela, o padrão também terá subnós para preenchimento

das células e cada subnó deve ter sua relação definida na aba “opções de saída”,
indicando em qual linha e em qual coluna deve sairá sua informação.
• Seção Complexa
O diferencial deste componente “coringa” fica justamente nesta aba que
permite que o componente assuma diversas finalidades.
Página 20 de 37
Treinamento interno
Se flegado em processamento repetitivo, ele assumirá as características do

LOOP;
Se o tipo de saída for uma tabela, ele assumirá as características dela e o
mesmo ocorrendo para o componente PADRÃO
6. Ferramentas de apoio
Exitem estas duas ferramentas mais amigáveis para o design de tabelas e

janelas para o seu formulário, oferecendo uma visão mais realista do que será de
fato o seu componente. São eles:
• Form Painter
Página 21 de 37
Treinamento interno
• Table Pianter
Página 22 de 37
Treinamento interno
7. Estilos
Os estilos são bibliotecas de parágrafos e caracteres para a formatação de texto dos
formulários Smartforms. A grande vantagem deste recurso está na praticidade de manutenção,
visualização e padronização de seu grupo de formulários. Pode-se trabalhar com uma gama
grande de estilos já existentes no sistema ou até com cópias a partir dos padrões do R/3.
A tela de criação dos estilos é a seguinte:
Página 23 de 37
Treinamento interno
O estilo está dividido em três partes:

• Dados de cabeçalho;
Página 24 de 37
Treinamento interno
• Formato de parágrafos;
Página 25 de 37
Treinamento interno
• Formato de caracteres;
Página 26 de 37
Treinamento interno
8. Modelo de Texto
Você pode criar modelos pré-definidos de textos e reaproveitá-los em seu formulário.
Ao criar o componente texto em seu formulário, indicar a entrada de modelo de texto
Página 27 de 37
Treinamento interno
Ao aceitar este modelo indicado, o texto será transcrito para o editor do componente ativo
Página 28 de 37
Treinamento interno
9. Migração de SAPscript para Smartforms
Página 29 de 37
Treinamento interno
Página 30 de 37
Treinamento interno
10. Exercícios
• 01 – Nota de Crédito
• Descritivo do GAP
Deverá ser criado um smartform para impressão de notas de crédito,
consequentemente, resgatando o módulo de função gerado automaticamente.
• Transação
Transação XXXX
• Periodicidade
Toda criação de um faturamento de um documento de nota de crédito.
• Detalhamento do GAP
Para pesquisa do nome e endereço do cliente, identificar qual é o parceiro do
documento de faturamento (VBRK-KUNRG), após pesquisar nome (KNA1-NAME1) e
endereço, cidade e CEP (KNA1-STRAS , KNA1-ORT01, KNA1-PSTLZ)
Página 31 de 37
Treinamento interno
Logomarca Aviso de Lançamento Data de emissão:

VBRP-ERDAT
Nome do cliente (VBRK-KUNRG) Aviso de Crédito

Endereço do cliente (KNA1-STRAS , KNA1-ORT01, KNA1-PSTLZ) VBRK-VBELN
Informamos a V.Sas. que, nesta data estamos levando a seu CRÉDITO a importância de R$ KOMV-
KWERT ou somar campos VBRK-NETWR + VBRK-MWSBK
(colocar valor por extenso……………………………………………………………………….)
conforme especificações abaixo:
HISTÓRICO VALOR
Crédito ref. n/ NF nº VBAK-XBLNR de J_1BNFDOC-DOCDAT

(pesquisar nº ordem de venda na VBRP-VGBEL)
Motivo: VBAK-AUGRU (pesquisar texto em função do código na

TVAUT-BEZEI)
Valor Total do CRÉDITO: R$ VBRK-NETWR + VBRK-MWSBK
ICMS……………………...: R$ R$ VBRK-NETWR + VBRK-

(de posse do nº da NF pesquisar seu numero interno e na tabela MWSBK
J_1BNFSTX para este numero interno (J_1BNFSTX-DOCNUM)
somar todos os valores dos itens (J_1BNFSTX-TAXVAL ) que
tenham J_1BNFSTX-TAXTYP igual a ICM3.
IPI…………………………: R$
(de posse do nº da NF pesquisar seu numero interno e na tabela
J_1BNFSTX para este numero interno (J_1BNFSTX-DOCNUM)
somar todos os valores dos itens (J_1BNFSTX-TAXVAL ) que
tenham J_1BNFSTX-TAXTYP igual a IPI3.
Aprovação:
Nome: _____________________________ ____________________________________
Assinatura: _____________________________ _____________________________________
Área Financeira: <nome da empresa>

<endereço> – <bairro>
<cep> – <cidade> – <estado>
Fone: <número> – Fax: <número>
Página 32 de 37
Treinamento interno
• 02 – Resumo para Ordem de Venda

• Descritivo do GAP
Desenvolvimento de um formulário para resumir os principais dados de uma
ordem de venda gerada através da transação VA01
• Transação
XXXX
• Periodicidade
A cada ordem de venda criada
• Detalhamento do GAP
Dados do Cliente Dados da Empresa
Nome: <tabela KNA1> Nome: <tavela T001>
CNPJ: Logomarca CNPJ:
Endereço: Endereço:
Textos: Data de Emissão

<texto de cabeçalho> <tabela VBAK>
Condição de pagamento: Área de Vendas: Valor total:

<ZTERM>-<Check table> <tabela-VBAK> <tabela VBAK>
Item Material Descrição Quant./unid Valor unit. Total item
<VBAP>
<VBAP>
<VBAP>
<VBAP>
Página 33 de 37
Treinamento interno
11. Material de apoio

• SE78 – Manutenção de imagens no sistema
Página 34 de 37
Treinamento interno
• SE73 – administração de controle de impressões para scripts
Página 35 de 37
Treinamento interno
Página 36 de 37
Treinamento interno
Página 37 de 37

Smartform Aspen

Diunggah oleh

Informasi Dokumen

Judul Asli

Hak Cipta

Format Tersedia

Bagikan dokumen Ini

Bagikan atau Tanam Dokumen

Opsi Berbagi

Apakah menurut Anda dokumen ini bermanfaat?

Apakah konten ini tidak pantas?

Hak Cipta:

Format Tersedia

Smartform Aspen

Diunggah oleh

Hak Cipta:

Format Tersedia

Treinamento interno

SAP Smart Forms

Alexandre Sagrilo de Souza

2. Conceitos básicos: Formulários script em SAPscript

Antes de iniciarmos os nossos estudos de Smartforms vamos recapitular cada um dos

quando estivermos trabalhando

em SAPscripts, uma das técnicas

3. Conceitos básicos: Formulários script em Smartforms

O Smartform é dividido inicialmente em duas partes: Opções Globais e Páginas e Janelas.

4. Componentes de uma janela

Janela Delimitador de uma área espacial de uma página

Comando Utilizado para enviar comando de impressão

5. Como trabalhar com os componentes?

Na aba “Condições”, você poderá indicar uma ou mais variáveis para

Caso seja de interesse que estas informações tornem-se dinâmicas, basta

justificado, oferecendo uma margem no campo indicado à frente com sua

tela ou clicar no botão para converter para a recepção de um “ponteiro” de

ii. Opções de saída:

uma vez que um estilo foi alterado,

ii. Opções de saída:

O campo “inserir controle de impressão” serve para que você coloque um

Finalmente a regra para uma reclassificação dos registro, mais comumente

A largura da tabela deve compreender a somatória de todas as células

O modelo de tabela servirá para você determinar as linhas de grade que

Os subnós podem ser textos, comandos ou outros tantos conforme a sua

A primeira célula, referenciada ao

Semelhante a tabela, o padrão você deve criar um tipo de linha informando o

O tipo de linha deve ter um nome unívoco;

Assim como na tabela, o padrão também terá subnós para preenchimento

Se flegado em processamento repetitivo, ele assumirá as características do

Exitem estas duas ferramentas mais amigáveis para o design de tabelas e

A tela de criação dos estilos é a seguinte:

O estilo está dividido em três partes:

Ao criar o componente texto em seu formulário, indicar a entrada de modelo de texto

9. Migração de SAPscript para Smartforms

Logomarca Aviso de Lançamento Data de emissão:

Nome do cliente (VBRK-KUNRG) Aviso de Crédito

Crédito ref. n/ NF nº VBAK-XBLNR de J_1BNFDOC-DOCDAT

Motivo: VBAK-AUGRU (pesquisar texto em função do código na

Valor Total do CRÉDITO: R$ VBRK-NETWR + VBRK-MWSBK

ICMS……………………...: R$ R$ VBRK-NETWR + VBRK-

Nome: _____________________________ ____________________________________

Assinatura: _____________________________ _____________________________________

Área Financeira: <nome da empresa>

• 02 – Resumo para Ordem de Venda

Textos: Data de Emissão

Condição de pagamento: Área de Vendas: Valor total:

11. Material de apoio

• SE73 – administração de controle de impressões para scripts

Anda mungkin juga menyukai

Nome: _ ________

Assinatura: _ _________