Objetivo
O objetivo da funcionalidade é possibilitar que o menu de uma mesma instância[1] do produto Datasul suporte empresas de diferentes localizações, considerando diferentes estruturas de menu para cada localização.
[1] No produto Datasul, uma instância é o equivalente a uma instalação do ERP. Ou seja, o conjunto de configurações, banco de dados, aplicações e servidores de aplicação necessários para a execução do produto.
Configuração
Para ativar estas funcionalidades deverá ser alterado o arquivo de propriedades do Datasul, o datasul_framework.properties
. Este arquivo está localizado no diretório conf/datasul
do servidor de aplicação 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.
Quando atribuído false
à propriedade menu.localization.active
ou não houver esta chave no arquivo de configuração, a importação de menu ByYou somente irá importar os itens relativos a um único país de referência, isto é, os itens que são específicos 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.active
, a importação de menu ByYou considerará todos os registros independente do país da empresa de referência utilizada pelo usuário.
Figura 1 - Importação menu ByYou
A configuração sobre os países que estão relacionados a um determinado programa é exibido no cadastro de programas do produto Datasul (bas_prog_dtsul
).
Figura 2 - Cadastro de programas Datasul
Quando a funcionalidade de localização do menu estiver ativa, quando o usuário efetua a troca de empresa, o menu exibirá os itens de menu exclusivos para a 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, 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.
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.
Figura 3 - ENG20017 Programas