Objetivo

...

O objetivo do projeto da funcionalidade é possibilitar que o menu de uma mesma instanciainstância[1] do produto Datasul suporte empresas de diferentes localizações, considerando diferentes estruturas de menu para cada localização.

...

...

Configuração

...

...

Para ativar estas funcionalidades deverá ser alterado o arquivo é necessário acessar a área de propriedades do Datasul, o datasul_framework.properties. Este arquivo está localizado no diretório conf/datasul do servidor JBoss. Neste arquivo deverá ser acrescentada uma nova propriedade com o nome menu.localization.active e atribuir um valor logico indicando se o menu multi localizado deve ser habilitado. Caso a propriedade não esteja declarado no arquivo datasul_framework.properties, o Datasul assumira o valor false como padrão. Para ativar as funcionalidades atribua o valor true à propriedade, conforme abaixo.

Image Removed

...

produto e nas opções de MENU, habilitar o Menu Localizado:

Image Added

Informações
Sempre que houver alteração na propriedade

...

, obrigatoriamente será necessária a importação completa do menu.

Importação do Menu

...

...

Quando atribuído false à propriedade menu.localization.activea propriedade não estiver habilitada, a importação de menu Byyou funciona como na versão anterior à Datasul 12.1.7 ou seja, somente serão importados somente irá importar os itens relativos a um único país e de referência, isto é, os itens que são específicos de outros dos demais países serão desconsiderados. O país referência para importação do menu é o mesmo configurado para a empresa utilizada pelo usuário. 

Quando atribuído true à propriedade menu.localization.activea propriedade estiver habilitada, a importação de menu ByYou importará considerará todos os registros independente do país da empresa de referência utilizada pelo usuário.

Image Added

Figura 1 - Importação menu ByYou

A lista de países aos quais um programa está relacionado encontra-se na posição 47 do arquivo de menu do módulo (men_<modulo>.d), a relação programa x localidade é armazenada na tabela prog_dtsul_localid e pode ser consultado no cadastro Manutenção de Programas A configuração de à quais países o programa deve ser exibido está no cadastro de programas do produto Datasul (bas_prog_dtsul) e, para cadastro interno, no aplicativo GOLD – programa ENG20017.

Renderização do menu

, aba "Localidade".

Image Added

Figura 2 - Cadastro de programas Datasul

Fluxo resumido

...

Image Added

Estrutura de menu

...

Quando a funcionalidade de localização do menu estiver ativa, no momento em que o usuário efetua a troca de empresa, o menu exibirá Quando o menu localizado está ativo (menu.localization.active=true), na troca de empresas pelo usuário, o menu será renderizado para exibir os itens de menu exclusivos para a nova localidade e ocultar os itens da anterior, quando os países das empresas forem diferentes. Quando o menu localizado está inativo, o menu não é renderizado. Isto porque, nesta situação, a instancia deverá ter localização associada à empresa, ocultando os itens de outras localizações. Quando esta funcionalidade estiver desativada, o menu exibirá todos os itens de menu. Nesta situação, a instância do produto Datasul deverá conter apenas uma localização.

Importação de arquivo XML

...

Nos arquivos XML de localização, que deverá ser importado utilizando o programa btb/btb982.p, quando um determinado programa possuir mais de uma DPC de diferentes localizações relacionada, será necessário utilizar o programa de intermediação de DPCs – utp/ut-dpc-<versão da dpc>.p. Por exemplo: Caso a DPC seja padrão EMS5 deverá ser indicado no arquivo xml no campo nom_prog_dpc o programa utp/ut-dpc-ems5.p.As DPCs deverão ser relacionadas à país e programa no aplicativo GOLD, na tela cadastro de programas.

Os arquivos xml com a relação programa x DPC deverá ser providenciado pelas áreas de negócios.

Informações Complementares para Desenvolvimento

...

Cadastro de programas – GOLD

...

No cadastro de programas do GOLD (eng20017) existem 2 novos itens de cadastros: localização e Associar DPC.

No item localização serão informados os países para quais o programa deverá ser exibido no menu. Se nenhum país for informado, este programa será exibido para todos os países.

No item Associar DPC, será possível associar a DPC do programa a um país. Somente uma DPC por país poderá ser associada. 

...

(equipes internas)

As DPCs deverão ser relacionadas à país e programa no portal GCAD Tools, na opção Datasul > Menu Datasul > Menu - Programas.

Para cadastramentos de Locais e Associação de DPC, acesse a documentação interna a seguir e verifique a opção Programas para instruções na ferramenta: Cadastro de Menu Datasul - Engenharia-Segmentos