Como chamar a lista de organizações de inventário do EBS no Forms

Lista de organizações

Não sei se você já notou, mas alguns forms do EBS exigem logo ao abrir que você escolha uma organização de inventário.

Depois que você escolhe uma organização, não será solicitado novamente até você trocar de responsabilidade ou forçar a troca manualmente.

No cadastro de itens lá no INV você consegue verificar essa funcionalidade.

Nesse artigo vou mostrar o passo a passo para você utilizar esse recurso e implementar nos seus forms.

Caso você não seja desenvolvedor, também é interessante saber como funciona, principalmente pela API utilizada.

Vou abordar aqui nesse artigo:

  • Parâmetros necessários no form
  • API FND_ORG
  • Trigger para implementação (PRE-FORM)
  • Resultado Final

E vamos ao passo a passo.

Parâmetros necessários no form

Primeiramente precisamos criar alguns parâmetros no form:

  • ORG_ID
  • ORG_NAME
  • ORG_CODE
  • CHART_OF_ACCOUNTS_ID

Choose ORG Parameters

Eles ficarão assim:

Tipos Parâmetros

Esses parâmetros poderão ser utilizados para diversos fins na sua tela, como filtro de registros em blocos, filtro de registros em listas de valores e por aí vai.

API FND_ORG

A API FND_ORG.CHOOSE_ORG é a responsável por automaticamente chamar a lista de valores de organizações.

Essa procedure tem um único parâmetro não obrigatório:

  • ALLOW_CANCEL: O valor default que é passado é FALSE, ou seja, o usuário poderá cancelar e não será obrigado a escolher uma organização. Agora, se o valor informado for TRUE, uma organização deverá ser informada obrigatoriamente.

Trigger para implementação (PRE-FORM)

Agora que temos os parâmetros criados e sabemos qual API utilizar, precisamos saber onde chamar essa API.

A trigger a ser implementada é a PRE-FORM, que é uma trigger disparada logo que o form é aberto.

O processo é simples, basta efetuar a chamada da API:

FND_ORG.CHOOSE_ORG;

Resultado Final

A configuração é essa, bem simples.

Assim que o form for aberto e a organização ainda não tiver sido escolhida, a lista de valores abrirá.

Se você fechar o form e abrir novamente, assim como qualquer outro que use o mesmo recurso, a lista não será aberta novamente, pois os dados da organização já estarão armazenados nos parâmetros.

A chamada da API FND_ORG.CHOOSE_ORG é inteligente, ou seja, você não precisa se preocupar se os dados da organização já foram informados ou não. Assim que a API é chamada, ela faz essa verificação e, caso os dados já tenham sido informados, ela preenche os parâmetros e não mostra a lista de valores.

Se você sair da responsabilidade e voltar, precisará informar novamente.

Conclusão

Esse é um recurso simples mas extremamente importante.

Por questões de segurança, muitas regras de negócio exigem que os dados disponibilizados em um form sejam exclusivos de determinada organização.

Assim garantimos que usuários de uma “filial A”, não consigam visualizar dados de uma “filial B” e vice-versa.

E de posse desses parâmetros preenchidos, você pode trabalhar com eles no seu form utilizando a sintaxe:

  • :PARAMETER.ORG_ID
  • :PARAMETER.ORG_NAME
  • :PARAMETER.ORG_CODE
  • :PARAMETER.CHART_OF_ACCOUNTS_ID

Eles podem ser utilizados na cláusula WHERE do seu bloco, no WHERE das suas listas de valores, etc.

Gostou desse artigo? Foi útil? Então compartilhe com seus amigos!

Deixe um comentário

O seu endereço de e-mail não será publicado. Campos obrigatórios são marcados com *