Vous êtes sur la page 1sur 46

11 INCRVEIS USOS PARA O

ORACLE EBS PERSONALIZATION

POR EDUARDO SCHURTZ

Seja muito bem-vindo!


Eduardo aqui...
No uma das tarefas mais fceis encontrar algo sobre Oracle EBS Personalization que no seja corriqueiro na documentao disponvel. At tem bastante coisa
boa, mas geralmente os materiais esto espalhados pela internet e no so muito
didticos.
Perde-se um bom tempo procurando, tempo que poderia estar sendo aplicado em
atividades mais produtivas.
Pensando nisso, resolvi criar este eBook onde abordo vrios exemplos de OAF/
WEB Personalization e Form Personalization.
So todos exemplos prticos, alguns eu j tinha abordado no meu blog e outros
so exclusivos deste eBook.
E caso tenha interesse em se tornar um especialista e conquistar um diferencial no
mercado, conhea o meu curso de Oracle EBS Personalization.
Espero que goste!

SUMRIO
Introduo....................................................................................................................2
1. Como aumentar o limite de registros visualizados por pgina web........................ 4
2. Como adicionar tips (dicas) de texto nas pginas web......................................... 7
3. Como criar um boto para exportar registros de pgina web................................11
4. Como limitar a quantidade de caracteres de um campo........................................15
5. Como mascarar o contedo de um campo............................................................. 18
6. Como alterar a query de uma lista de valores (LOV)............................................. 21
7. Como automatizar seus testes................................................................................26
8. Descobrindo a query de uma tela web...................................................................30
9. Visualizando a sada de concurrents de outros usurios.......................................34
10. Descobrindo os valores dos parmetros para setar o contexto fora do EBS.......38
11. Facilitando a procura da execuo de concurrents..............................................42
Contato.......................................................................................................................46

#0
#1

COMO AUMENTAR O LIMITE DE


REGISTROS VISUALIZADOS POR
PGINA WEB
COMO AUMENTAR O LIMITE DE
REGISTROS VISUALIZADOS POR
PGINA WEB

#1 Como aumentar o limite de registros visualizados por pgina web


Quando temos uma tela web com listagem de registros, existe um limite de quantidade para os registros visualizados. Esse limite varia de tela para tela.
Se o limite, por exemplo, de 10 registros por vez e voc fez uma consulta que retornou 100 registros, vai precisar clicar no boto de prxima pgina 9 vezes.
Se o limite fosse aumentado para 50, voc conseguiria ver todos os 100 registros
em apenas duas telas, clicando no boto de prxima pgina apenas uma vez.
Utilizei como exemplo a tela de cadastro de fornecedores do Payables, onde o limite
de registros visualizados de 15 por vez:

Aumentarei esse limite para 50.


Como fazer:
Esses registros so mostrados na tela por meio de um objeto tabela, ento este
objeto que deve ser personalizado.
Logo acima da tabela, no canto superior esquerdo, tem um link de personalizao
chamado Personalize Suppliers Table. Clique nele:

#1 Como aumentar o limite de registros visualizados por pgina web


Vai abrir uma tela com a estrutura de personalizao, com cada objeto que pode ser
personalizado.
Clique no cone do lpis correspondente ao objeto Table: Suppliers Table:

Agora abrir uma tela com todas as opes que podem ser personalizadas deste
objeto.
A propriedade para o nosso exemplo a Records Displayed, perceba na imagem
abaixo que a definio original 15.
Vamos alterar para 50, apenas para o nvel de responsabilidade, ento deve
ser alterada na coluna Responsibility: Payables:

Depois s clicar no boto Apply e voltar para a tela principal clicando em Return to Application.
E est feito! J sero mostrados 50 registros por vez, no mais 15.
Se voc quiser ver mais detalhes dessa personalizao e tambm verificar o resultado final, gravei um vdeo demonstrando cada etapa, clique aqui para assistir.

#0
#2

COMO ADICIONAR TIPS (DICAS)


DE TEXTO NAS PGINAS WEB

#2 Como adicionar tips (dicas) de texto nas pginas web


Essa uma personalizao simples, mas muito interessante.
Nem sempre o contedo de uma pgina auto-explicativo, dificultando o entendimento de pessoas que esto acessando pelas primeiras vezes.
No seria timo poder adicionar mensagens de orientao para ajudar o usurio a
entender melhor cada rea da pgina?
E assim mostrar o caminho correto que ele deve seguir?
Os ganhos so vrios:
Menos gastos com treinamento
Menos chamados abertos
Menos erros de operao
Talvez voc j tenha notado, mas em algumas telas web do Oracle EBS j podemos
visualizar essas dicas de maneira nativa:

No exemplo acima, temos a seguinte dica:


The Allow Withholding Tax option is enabled only when the Withholding Tax option is enabled in both the supplier and payables options for the operating unit
Ou seja, s possvel marcar o campo Allow Tax Withholding se a opo Withholding Tax estiver habilitada nas Opes do Payables e do Fornecedor para
a unidade operacional.
Perceba como isso importante: Se algum sem familiaridade com essa tela
tentar marcar essa opo e no conseguir, sem a mensagem provavelmente ela no
saber o que fazer e ter que abrir um chamado ou perder tempo tentando descobrir.
Vou mostrar agora como criar as nossas prprias mensagens, utilizando como exemplo a pgina de Tax Details do cadastro do fornecedor.

#2 Como adicionar tips (dicas) de texto nas pginas web


Na rea de Supplier Sites, clique em Personalize Default Single Column:

Vamos criar um novo item nessa rea clicando em Create Item:

Em Item Style, escolha Tip, fornea um ID para esse novo objeto, escreva a sua
mensagem e clique em Apply:

#2 Como adicionar tips (dicas) de texto nas pginas web


Retorne clicando em Return to Application e confira o resultado:

til, no?
E neste exemplo eu inseri o texto diretamente na pgina, mas possvel criar mensagens no dicionrio de mensagens do EBS e customizar ainda mais a mensagem.

10

#0
#3

COMO CRIAR UM BOTO


PARA EXPORTAR REGISTROS
DE PGINA WEB

#3 Como criar um boto para exportar registros de pgina web


Uma das vantagens do OAF personalization poder criar novos objetos na
tela, coisa que infelizmente no possvel no form personalization.
Neste exemplo vou demonstrar como criar um boto para exportar detalhes dos
contatos de um fornecedor.
Vamos l:
Clique em Personalize Page (Topo superior direito da tela).
Depois em Create Item para o objeto Page Layout:

Na prxima tela, configure da seguinte maneira:

12

#3 Como criar um boto para exportar registros de pgina web

Em Item Style, escolha Export Button.


Fornea um ID para o objeto.
Em Text, informe o texto do boto.
Em View Instance, digite ContactsVO (O contedo para o campo View Instance
voc pode obter pelo link About This Page, aba Page, coluna View Object)
Clique em Apply e depois em Return to Application para retornar.
Pronto!

13

#3 Como criar um boto para exportar registros de pgina web


Ao clicar no boto de exportar, vai aparecer a popup para voc informar onde quer
salvar o arquivo com os contatos:

14

#0
#4

COMO LIMITAR A QUANTIDADE DE


CARACTERES DE UM CAMPO

#4 Como limitar a quantidade de caracteres de um campo


No sei voc, mas eu j tive problemas srios com informaes muito grandes que
foram digitadas em alguns campos do EBS.
Por mais que a tela permita uma grande quantidade de caracteres, 260 por exemplo, em alguns cenrios interessante limitar esse tamanho.
Algum outro processo pode no estar preparado para receber tantos caracteres,
gerando erro.
J vi isso acontecer algumas vezes.
O procedimento nesses casos abrir um chamado na Oracle reportando o problema, para que resolvam em um prximo patch.
Mas isso pode demorar. Ento a soluo personalizar esse campo problemtico
at que a Oracle resolva.
Veja como simples (Utilizarei como o exemplo o campo Contact First Name do
cadastro de Fornecedores:
Clique em Personalize Page (Topo superior direito da tela).
Procure por Message Text Input: Contact First Name e clique no lpis ao lado:

Na propriedade Maximum Length, veja que valor padro 150. Vamos limitar
para no mximo 20 caracteres no nvel da responsabilidade:

16

#4 Como limitar a quantidade de caracteres de um campo

Clique em Apply e depois em Return to Application.


Agora s possvel informar no mximo 20 caracteres:

17

#0
#5

COMO MASCARAR O CONTEDO


DE UM CAMPO

#5 Como mascarar o contedo de um campo


Toda empresa tem informaes confidenciais.
Ento faz todo o sentido esconder essas informaes de quem no deve ter acesso
a elas.
Um jeito prtico de fazer isso mascarando o contedo de campos que contenham
esses dados sigilosos.
Considere que algumas pessoas com acesso tela de pedidos do OM, no devam
visualizar o valor unitrio de cada item ( apenas um exemplo).
A personalizao ficaria assim:

Em Trigger Event, escolha WHEN-NEW-RECORD-INSTANCE.


Em Trigger Object, escolha LINE
Na aba Actions:

19

#5 Como mascarar o contedo de um campo


Em Type, escolha Property.
Em Object Type, escolha Item.
Informe o nome do campo em Target Object, aqui no exemplo seria o LINE.
UNIT_SELLING_PRICE_DSP.
Em Property Name, escolha CONCEAL_DATA.
E em Value, escolha TRUE.
Pronto, agora o contedo desse campo est mascarado:

20

#6
#0

COMO ALTERAR A QUERY DE UMA


LISTA DE VALORES (LOV)

#6 Como alterar a query de uma lista de valores (LOV)


Nem sempre a query padro de uma lista de valores atende as necessidades da empresa.
Seja por uma regra de negcio, um detalhe para melhorar a visualizao da lista,
etc.
Veja por exemplo a lista de valores do campo de listas de preo, que fica na tela de
ordens de venda do OM:

Perceba que algumas listas no possuem descrio.


E se a gente s quisesse mostrar listas de preo que tenham a descrio preenchida?
fcil
Vamos l:
Primeiro precisamos saber qual o nome da lista de valores (LOV) para este campo.
Clique no campo Price List, v at o menu Help > Diagnostics > Properties >
Item.

22

#6 Como alterar a query de uma lista de valores (LOV)


Na janela Object Properties, escolha Lov Name em Property:

PRICE_LIST o nome da lista.


Precisamos criar um novo Record Group (objeto do form que armazena a query)
para a lista de valores.
Vamos personalizao:

Em Trigger Event escolha WHEN-NEW-ITEM-INSTANCE.


Em Trigger Object, ORDER.PRICE_LIST. (ORDER o bloco e PRICE_
LIST o nome do campo).
Na aba Actions teremos duas aes:
A primeira para criar o novo Record Group e a segunda para associar esse novo
Record Group lista de valores.

23

#6 Como alterar a query de uma lista de valores (LOV)


Primeira ao:

Em Type, escolha Builtin.


Em Builtin Type, selecione Create Record Group from Query.
No campo Argument, voc precisa colocar a nova query com a clusula WHERE
modificada. Eu peguei a query original e adicionei a clusula abaixo:
QLHV.description IS NOT NULL
OBS: A query original da LOV voc pode obter via trace ou abrindo o form no Oracle Forms Builder.
Segunda ao:

Em Object Type, selecione LOV.


Em Target Object, coloque o nome da LOV a ser alterada, no nosso exemplo
PRICE_LIST.

24

#6 Como alterar a query de uma lista de valores (LOV)


Informe GROUP_NAME em Property Name.
E para finalizar, informe o nome do novo Record Group que voc definiu na ao
anterior, no meu exemplo foi PRICE_LIST_LOV_CUSTOM.
Agora s salvar, fechar a tela de pedidos e abrir novamente para que os resultados
tenham efeito:

Somente listas de preo com descrio preenchida foram mostradas.

25

#0
#7

COMO AUTOMATIZAR SEUS


TESTES

#7 Como automatizar seus testes


Esse um uso um pouco diferente de EBS Personalization, mas confesso que so
esses tipos que eu mais gosto, como voc pode ver l no meu blog, em EBS Hacks.
Quando estamos realizando testes no EBS, seja para uma nova customizao ou
processo, em alguns casos temos a necessidade de digitar as mesmas informaes,
repetidamente.
Vou dar um exemplo para deixar mais fcil de entender, imagine o seguinte
cenrio:
Uma nova customizao precisa ser testada e ela precisa que vrios pedidos de venda sejam criados pela tela, com praticamente as mesmas informaes (E por alguma razo, o recurso de Copiar Pedido no pode ser utilizado).
Ao invs de digitar manualmente esses pedidos, podemos criar uma personalizao
para que toda vez que o form entre em modo de novo registro, os campos j sejam
preenchidos.
Vamos l:
Primeiramente voc precisar do nome de todos os campos que precisam ser
preenchidos, essa informao voc consegue em Help > Diagnostics > Examine.
Aqui no exemplo, preencherei os seguintes campos:
Customer
Ship To Location
Bill To Location
Order Type
Price List
Currency
A tela principal da personalizao ficaria assim:

27

#7 Como automatizar seus testes

Em Trigger Event, escolhemos WHEN-NEW-RECORD-INSTANCE.


Informe ORDER em Trigger Object.
Na condio, queremos que a personalizao dispare apenas quando for um novo
registro, ento informamos:
:SYSTEM.RECORD_STATUS = NEW
OBS: Muito importante, no esquea de definir o nvel de contexto dessa personalizao apenas para o seu usurio.
Agora na aba Actions:

Criaremos uma linha do tipo Property para cada campo a ser preenchido.

28

#7 Como automatizar seus testes


E para cada linha:
Object Type ser Item.
Target Object ser <NOME DO BLOCO>.<NOME DO CAMPO>, ou seja, ORDER. + o nome do campo que voc anotou
Property Name ser VALUE
E para finalizar, em Value informe o valor que deseja que o campo receba para os
seus testes.
Agora, toda vez que a tela entrar em modo de incluso de registro, todos os campos
sero automaticamente preenchidos.

OBS: Se preencher diretamente os IDs, ser ainda mais rpido.

29

#0
#8

DESCOBRINDO A QUERY DE UMA


TELA WEB

#8 Descobrindo a query de uma tela web


Quando precisamos descobrir a query ou um campo e/ou tabela de um form muito fcil, basta acessar: Diagnostics > Examine do menu Help.
Mas com as telas web a coisa ficou um pouco mais complicada, mas no impossvel.
Acesse a tela web desejada. No exemplo abaixo utilizarei a tela de informaes de
contato da conta bancria do Cash Management, buscaremos a origem do campo
Sobrenome:

V at o fim da tela, no canto inferior esquerdo, deve existir um link Sobre esta
Pgina, clique nele:

Depois clique em Expandir Tudo:

31

#8 Descobrindo a query de uma tela web

Agora vamos procurar pelo campo Sobrenome e seu respectivo Objeto na coluna View Object:

Se o objeto estiver na forma de link, s clicar nele e pronto. Mas em algumas


situaes ele estar apenas na forma de texto, ento copie esse texto e procure por
ele mais abaixo, na rea Detalhes de Referncias do Componente Comercial, em
View Object:

32

#8 Descobrindo a query de uma tela web

Encontrando, basta clicar e pronto, a query por trs da tela mostrada:

A est! Agora voc tem a query.

33

#0
#9

VISUALIZANDO A SADA DE
CONCURRENTS DE OUTROS
USURIOS

#9 Visualizando a sada de concurrents de outros usurios


Quando estamos em projeto, algumas vezes precisamos analisar a sada de concurrents que foram executados por outras pessoas, por exemplo:
Quando um consultor est testando uma customizao e precisa mostrar a
sada para o desenvolvedor
Quando um usurio percebe um erro em determinado concurrent e precisa
mostrar para o consultor
O jeito mais comum solicitar ao executor que salve a sada em um arquivo e envie
para o responsvel, mas muitas vezes no a maneira mais eficaz: O executor pode
demorar para enviar, ele pode enviar em um formato no satisfatrio para anlise,
etc.
Eu prefiro apenas solicitar o ID da solicitao a ser analisada, assim eu mesmo consulto a solicitao.
Outra situao interessante: Voc precisa analisar a sada de vrias solicitaes mas
no est conseguindo se comunicar com o executor, ento s pesquisar por todas
as solicitaes daquele usurio e verificar as sadas por conta prpria.
Mas tem um detalhe, o boto Verificar Sada desabilitado para visualizar a sada
de solicitaes de outros usurios no EBS, apenas o boto de Verificar Log est
disponvel. Isso faz todo o sentido por uma questo de segurana.

Se voc tem acesso responsabilidade Administrador do Sistema, existe um macete utilizando o form personalization:
Acesse a responsabilidade Administrador do Sistema e v em: Solicitaes >
Exibir

35

#9 Visualizando a sada de concurrents de outros usurios

Pesquise pelas solicitaes desejadas e acesse a tela de personalizao: Ajuda >


Diagnsticos > Personalizar Cdigo > Personalizar

Agora s criar a personalizao:

36

#9 Visualizando a sada de concurrents de outros usurios

Cada vez que voc navegar em um registro da tela de solicitaes, a personalizao


ser executada (Por isso o evento WHEN-NEW-RECORD-INSTANCE).
Ateno: Muito importante colocar como contexto apenas o seu usurio, assim a
personalizao funcionar apenas para voc.
Depois s sair da tela de solicitaes e entrar novamente, para que a personalizao tenha efeito.
OBS: Por questes de segurana, isso no deve ser feito em ambiente de produo,
apenas se a empresa permitir

37

#10
#0

DESCOBRINDO OS VALORES DOS


PARMETROS PARA SETAR O
CONTEXTO FORA DO EBS

#10 Descobrindo os valores dos parmetros para setar o contexto fora do EBS
Quando estamos dentro do EBS muitas variveis de contexto so setadas, tudo isso
feito automaticamente se o setup foi feito corretamente.
Com todo esse contexto configurado o EBS restringe o acesso aos dados pesquisados, seja pelo ID da organizao, responsabilidade, usurio, etc.
Mas algumas vezes precisamos realizar algumas consultas fora do EBS, por exemplo, executando uma query diretamente no banco.
Dependendo da query e das tabelas utilizadas, s vezes nem precisamos nos
preocupar com o contexto. Mas se queremos realizar uma pesquisa exatamente
como ela seria feita dentro do EBS, com as todas as restries, temos que configurar a sesso onde a query ser executada para simular que estamos dentro do
aplicativo.
Existem alguns comandos para fazer isso, por exemplo:
Seta o ORG_ID na R12

Seta o usurio, responsabilidade e aplicao

OK, temos os comandos, mas como obter os valores dos parmetros necessrios?
Alguns so simples de conseguir, como o ID do usurio:

O ID da responsabilidade e da aplicao tambm podemos obter por uma query:

39

#10 Descobrindo os valores dos parmetros para setar o contexto fora do EBS

Para os outros, como o ORG_ID ou o SET_OF_BOOKS_ID/LEDGER_ID, podemos fazer o seguinte para agilizar (Existem outras maneiras):
V at a responsabilidade que voc quer simular no SQL e acesse o form personalization:

Preencha os campos obrigatrios com qualquer valor, v at a aba Aes e faa


conforme abaixo:

40

#10 Descobrindo os valores dos parmetros para setar o contexto fora do EBS

Ao pressionar o boto Validate, uma mensagem mostrar a informao desejada.


O comando FND_GLOBAL.ORG_ID retorna o ORG_ID corrente (A Oracle
recomenda no utilizar mais o FND_PROFILE.VALUE(ORG_ID) na R12 para
obter esse valor).
Para retornar o SET_OF_BOOKS_ID/LEDGER_ID, utilize o comando:
FND_PROFILE.VALUE(GL_SET_OF_BKS_ID)
Esses comandos podem ser utilizados para diversos outros fins, basta dar uma
pesquisada.
Muitas vezes quando executamos uma query e no retornado nenhum registro no
SQL, um dos motivos o contexto no ter sido setado.

41

#11

FACILITANDO A PROCURA DA
EXECUO DE CONCURRENTS

#11 Facilitando a procura da execuo de concurrents


Muitas vezes precisamos procurar pela execuo de concurrents para analisar suas
sadas e/ou logs. O problema que muitos concurrents tm o nome parecido e o
campo que mostra o nome muito pequeno:

Assim temos que navegar at o campo nome e olhar a descrio completa, um a


um.
Quando se sabe o nome exato do concurrent, s filtrar por esse nome, mas muitas
vezes s sabemos ou lembramos algumas partes do texto.
Pensando em um jeito de agilizar esse processo, criei uma personalizao para
mostrar o nome completo do concurrent diretamente na tela. Toda vez que troco de
registro, a personalizao mostra o nome da solicitao corrente. Fiz assim:
Utilizei o prompt do campo ID da Solicitao para mostrar o nome:

Ento a personalizao ficou assim:

43

#11 Facilitando a procura da execuo de concurrents

agora a ao:

No prompt do campo, eu coloco o nome do concurrent + quebra de linha + prompt


original do campo (Na verdade, coloquei s o texto ID para economizar espao)
O resultado final esse:

Toda vez que trocar de registro, esse texto ir mudar com o nome do concurrent
atual.
E com esse finalizo os 11 exemplos...

44

CONCLUSO
Espero de verdade que tenha gostado deste material.
Guarde com voc e consulte sempre que necessrio.
O Oracle EBS Personalization uma ferramenta fantstica para profissionais Oracle e-Business Suite.
Recomendo agora dar uma olhada no meu curso de Personalization, tem tudo
isso que foi abordado no eBook e muito mais.
Qualquer dvida, sugesto e/ou crtica s entrar em contato, meus dados esto na
prxima pgina.
Forte Abrao
Eduardo Schurtz

45

CONTATO

Eduardo Schurtz
Nomeado Oracle ACE em Applications & Apps
Technology pela Oracle em 2015, o primeiro do Brasil nessa categoria (e nico pelo menos at edio
deste eBook).
Consultor Oracle e-Business Suite e Empreendedor
Digital.

... tem mais contedo aqui:

EDUARDOSCHURTZ.COM/ORACLE
ORACLEEBSPERSONALIZATION.COM