Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

dasd

Índice

OBJETIVO

01. Objetivo

Esse documento tem por finalidade instruir o usuário a realizar o procedimento de customização da logo apresentada no menu

do ERP. Section
Column
width20%

Image Removed

Column
width80%

IMPORTANTE: Antes de iniciar é recomendado copiar o arquivo custom.war (que está localizado na pasta WEBAPPS do Tomcat), para uma outra pasta qualquer para executar os procedimentos sem riscos.

O arquivo custom.war  precisa ser descompactado.

Para isso basta trocar a extensão war por zip ao final do arquivo (ou utilizar um software como por exemplo o 7zip).

Ex: custom.zip

  Image Removed

e login.

A customização para o login contempla as telas: login, esqueci minha senha, trocar senha, carregando e logout (sair).

Informações
titleImportante

A customização de logo nas telas de login, esqueci minha senha, troca senha, carregando e logout estão disponíveis a partir da release 12.1.2311.

Tela MenuTela LoginTela Esqueci Minha SenhaTela Trocar SenhaTela Carregando

Image Added

Image Added

Image Added

Image Added

Image Added

Tela Logout

Image Added

02. Passo a Passo

1. Faça a seguinte parametrização no ERP:

Propriedades do Sistema → Propriedades Menu → Habilite a opção Habilita alteração da logomarca da empresa?;

2. Extraia o projeto webapps/custom.war para um diretório temporário:

Image AddedImage Added

3. Seguindo o exemplo acima, acesse C:\tmp\custom\assets\img e crie um diretório:

Para customizar a logo apresentada no menu, crie um diretório chamado totvs-menu:

Image Added

Para customizar a logo apresentada nas telas de login, trocar senha, esqueci minha senha, carregando e logout crie um diretório chamado totvs-login:

Image Added

4. Dentro do diretório criado, adicione as imagens correspondentes as logos:

Para customizar a logo apresentada no menu, adicione no diretório totvs-menu as imagens correspondentes as logos de menu desejadas para cada empresa:

A nomenclatura da imagem deve seguir o padrão menu-logo-<código da empresa>.png, sendo que o <código da empresa> corresponde ao código da empresa no programa BTB962AA - Parâmetros do Foundation. Caso o código da empresa tenha letra, a mesma informação seja em Maiúscula ou Minúscula no BTB962AA precisa estar no trecho do nome da logo menu-logo-<código da empresa>.png.

Image Added

Para customizar a logo apresentada nas telas de login, trocar senha, esqueci minha senha, carregando e logout, adicione no diretório totvs-login a imagem correspondente ao logo que deseja:

A nomenclatura da imagem deve seguir o padrão logo.png.

Image Added


5. Abra o prompt de comando do Windows, posicione a sessão no diretório C:\tmp\custom e execute o comando jar -cvf dts#custom.war *:

Image AddedImage Added

6. Copie o projeto gerado dts#custom.war para o servidor de aplicação no diretório webapps:

Image AddedImage Added

Informações

Em alguns casos, pode ser necessário limpar o cache/histórico do navegador após alterar o arquivo de imagem.

03. Informações Complementares  

 Propriedades de Menu do Sistema - CFG - Menu

Section
Column
width20%

Image Removed

Column
width80%

Em seguida deve-se colocar na raiz da pasta descompactada os arquivos customizados.

Conforme a imagem de exemplo a seguir:

Image Removed

Section
Column
width20%

Image Removed

Column
width80%

Após inserir as customizações é preciso compilar a pasta para gerar um novo WAR e assim incorporar as customizações ao produto.

Para isso é necessário abrir o prompt de comando dentro da pasta custom e executar o comando jar -cvf dts#custom.war *

Image RemovedImage Removed

Ao final da compilação será gerado um novo arquivo WAR

Section
Column
width20%

Image Removed

Column
width80%

O último passo é mover o dts#custom.war para dentro da pasta WEBAPPS do Tomcat e colocar o ambiente no ar.

Image Removed

Dica
titleDica

O caractere # para o Apache Tomcat é interpretado como um separador de diretórios, no qual é recomendado validar a estrutura dos arquivos após a geração do arquivo .war.

Exemplos:

Com o comando para a geração do arquivo .war executado a partir do diretório c:\geracao-custom, no arquivo .war conterá todos os arquivos a partir desta origem.

Image Removed

Dentro do diretório custom-test, existe somente um arquivo teste.html a critério de exemplo.

Image Removed

Observe que após a geração do arquivo .war, foi inserido os diretórios a partir da raiz de sua geração (e automaticamente foi gerado o diretório META-INF).

Image Removed

Ao efetuar um teste com acesso a URL, verifique que ao digitar dts/custom/..., o próprio servidor de aplicação interpreta que se trata de um acesso dentro do arquivo dts#custom (que foi realizado o deploy com o mesmo nome), com a alteração automática do # por / e consequentemente é possível acessar os arquivos dentro de sua estrutura.

Image Removed