01. DADOS GERAIS
Produto: | TOTVS Framework
|
---|---|
Linha de Produto: | Linha Datasul |
Segmento: | Tecnologia |
Módulo: |
Framework (Linha Datasul) - Utilitários (MUT)
|
Função: | RFI - Customização |
País: | Brasil |
Ticket: | 13225977 |
Requisito/Story/Issue (informe o requisito relacionado) : | DFWKTOOLS-6478 |
02. SITUAÇÃO/REQUISITO
As chamadas aos fontes customizados não são executadas quando são acessadas por intermédio de um link do RFI.
03. SOLUÇÃO
Foram efetuados ajustes na chamada dos scripts customizados quando o acesso é realizado pelo RFI.
A seguir são apresentados um passo a passo de customização, como exemplo o programa /dts/rfimodules/mcc/rfimcc1000/
Os scripts customizados deve estar presente em uma estrutura padrão dentro do arquivo dts#custom.war
A estrutura deve seguir o modelo custom.<produto>.<modulo>.<programa>.
Devido a estrutura base de programas executados por RFI, assume-se que o módulo é sempre rfimodules e o programa neste caso é o mcc.
Ao abrir o programa, um script .js será executado automaticamente para carregar na memória as customizações, onde será considerado o nome do programa rfimcc1000 para localizar o arquivo.
A execução automática do script é única, sempre será considerado como base o nome do programa, caso queria separar os scripts por sub-telas, bastaria declarar em define. Mais detalhes no Passo 2.
Caso seja necessário separar os scripts de customizações, é necessário configurar na chamada do define o nome do(s) arquivo(s) que serão executados.
Com o exemplo abaixo observe no Passo 1 que foram carregados os scripts rfimcc1000.js, quotation.js e rfi.include.ctrl.js.
dts#custom/rfimodules/mcc/rfimcc1000.js:
dts#custom/rfimodules/mcc/rfimcc1000/quotation.js
dts#custom/rfimodules/mcc/rfimcc1000/quotation/rfi.include.ctrl.js
Com os scripts de customização devidamente configurados e presentes na estrutura correta, bastaria executa-los (a partir do programa padrão) via evento ou tag.
Lembrando que a chamada por evento não deve ser considerado o prefixo custom.
html-rfimodules\html\mcc\rfimcc1000\quotation\rfi.include.ctrl.js
html-rfimodules\html\mcc\rfimcc1000\quotation\rfi.include.ctrl.html
html-rfimodules\html\mcc\rfimcc1000\quotation\rfi.view.ctrl.html
Ao abrir o programa via link do RFI, os eventos presentes nos arquivos de customização serão executados nos programas que os configurou:
Executou a função customPageInclude do dts#custom/rfimodules/mcc/rfimcc1000.js, onde foi chamado pela tag totvs-custom-element do html-rfimodules/html/mcc/rfimcc1000/quotation/rfi.include.ctrl.html
Executou a função initEvent do dts#custom/rfimodules/mcc/rfimcc1000.js, onde foi chamado pelo evento customizationService.callEvent('dts.rfimodules.mcc', 'initEvent', ctrl); do html-rfimodules/html/mcc/rfimcc1000/quotation/rfi.include.ctrl.js
Executou a função initEvent do dts#custom/rfimodules/mcc/quotation.js, onde foi chamado pelo evento customizationService.callEvent('dts.rfimodules.mcc.rfimcc1000.quotation', 'initEvent', ctrl); do html-rfimodules/html/mcc/rfimcc1000/quotation/rfi.include.ctrl.js
Executou a função initEvent do dts#custom/rfimodules/mcc/quotation/rfi.include.ctrl.js, onde foi chamado pelo evento customizationService.callEvent('dts.rfimodules.mcc.rfimcc1000.quotation.rfiincludectrl', 'initEvent', ctrl); do html-rfimodules/html/mcc/rfimcc1000/quotation/rfi.include.ctrl.js
Executou a função customPageView do dts#custom/rfimodules/mcc/rfimcc1000.js, onde foi chamado pela tag totvs-custom-element do html-rfimodules/html/mcc/rfimcc1000/quotation/rfi.view.ctrl.html
04. DEMAIS INFORMAÇÕES
A utilização da tag totvs-custom-element nos arquivos .html requer atenção na declaração.
Devido a estrutura padrão de diretórios do RFI as funções de tag são executadas em um formato de declaração específica apresentadas no Passo 1, ou seja, para o exemplo citado são executados os scripts pertencentes ao custom.dts.rfimodules.mccIMPORTANTE!
Arquivos de customização utilizados neste exemplo:
05. ASSUNTOS RELACIONADOS