Smartform Aspen

Smartforms Treinamento internoHortolândia - SP

Página 1 de 37

SAP Smart Forms

Alexandre Sagrilo de Souza

Aspen – Procwork

PDF Creator - PDF4Free v2.0 http://www.pdf4free.com

http://www.pdfpdf.com/0.htm


Página 2 de 37

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 3 de 37

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 4 de 37

• 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 5 de 37

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 6 de 37

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 7 de 37

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 8 de 37

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 9 de 37

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 10 de 37

• 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 11 de 37

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 12 de 37

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 13 de 37

• 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 14 de 37

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 15 de 37

• 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 16 de 37

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 17 de 37

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 18 de 37

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 19 de 37

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 20 de 37

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 21 de 37

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 22 de 37

• Table Pianter




Página 23 de 37

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 24 de 37

O estilo está dividido em três partes:

• Dados de cabeçalho;




Página 25 de 37

• Formato de parágrafos;




Página 26 de 37

• Formato de caracteres;




Página 27 de 37

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 28 de 37

Ao aceitar este modelo indicado, o texto será transcrito para o editor do componente ativo




Página 29 de 37

9. Migração de SAPscript para Smartforms




Página 30 de 37PDF Creator - PDF4Free v2.0 http://www.pdf4free.com



Página 31 de 37

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 32 de 37

Logomarca Aviso de Lançamento Data de emissão:VBRP-ERDAT

Nome do cliente (VBRK-KUNRG)Endereço do cliente (KNA1-STRAS , KNA1-ORT01, KNA1-PSTLZ)

Aviso de CréditoVBRK-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 naTVAUT-BEZEI)

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

ICMS……………………...: R$(de posse do nº da NF pesquisar seu numero interno e na tabelaJ_1BNFSTX para este numero interno (J_1BNFSTX-DOCNUM)somar todos os valores dos itens (J_1BNFSTX-TAXVAL ) quetenham J_1BNFSTX-TAXTYP igual a ICM3.

IPI…………………………: R$(de posse do nº da NF pesquisar seu numero interno e na tabelaJ_1BNFSTX para este numero interno (J_1BNFSTX-DOCNUM)somar todos os valores dos itens (J_1BNFSTX-TAXVAL ) quetenham J_1BNFSTX-TAXTYP igual a IPI3.

R$ VBRK-NETWR + VBRK-MWSBK

Aprovação:

Nome: _____________________________ ____________________________________

Assinatura: _____________________________ _____________________________________

Área Financeira: <nome da empresa><endereço> – <bairro><cep> – <cidade> – <estado>Fone: <número> – Fax: <número>




Página 33 de 37

• 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

Nome: <tabela KNA1>

CNPJ:

Endereço:

Logomarca

Dados da Empresa

Nome: <tavela T001>

CNPJ:

Endereço:

Textos:

<texto de cabeçalho>

Data de Emissão

<tabela VBAK>

Condição de pagamento:

<ZTERM>-<Check table>

Área de Vendas:

<tabela-VBAK>

Valor total:

<tabela VBAK>

Item Material Descrição Quant./unid Valor unit. Total item

<VBAP>

<VBAP>

<VBAP>

<VBAP>




Página 34 de 37

11.Material de apoio

• SE78 – Manutenção de imagens no sistema




Página 35 de 37

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









Documents

Smartform Aspen