Linha Datasul

Árvore de páginas


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. 


IMPORTANTE!

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.mcc



Arquivos de customização utilizados neste exemplo: 

dts#custom.zip

05. ASSUNTOS RELACIONADOS