Histórico da Página

...

3) Criação de um componente com PO-UI, pela área de negócio, que utilize o componente PO-DYNAMIC-VIEW. Nele será utilizado a lista de campos personalizados e os dados a serem apresentados..

Explicando o funcionamento da técnica:

O componente criado pela área de negócio com o PO-DYNAMIC-VIEW deverá fazer duas requisições ao servidor REST, que são:

1) Para uma será para buscar os valores dos dados a serem apresentados, onde poderá ser passados o código do programa personalizado e também um id do "registro corrente" para obtenção dos valores. Após retornados os valores dos dados, é necessário

2) Para buscar a lista de campos personalizados com a utilização do utilizando o endpoint progress fornecido pelo framework, que é o /api/btb/v1/personalizationView/metadata/ + codigo_do_programa.

...

Campo

Descrição

Obrigatório

Código Programa Datasul

Código do programa "base" que podem ser aplicadas as técnicas de personalização

Nota

title	Nota

É possível cadastrar os campos somente em programas que permitem a personalização

Sim

Identificador Campo

Identificador único do campo (por programa), necessário para a geração da tela personalizada (código do campo)

Sim

Nome Campo

Nome do campo que será apresentado na tela (label do campo)

Caso o campo não seja informado, o nome do campo apresentado será o informado no identificador.

Não

Tipo Campo

Tipo do campo cadastrado

Caso o campo não seja informado, será considerado que o campo é do tipo string.

Tipos de campos permitidos:

Tipo JavaScript	Tipo Progress	Descrição
boolean	logical	Valores lógicos
currency	decimal	Valores monetários
date	date	Valores de datas. Aceita os tipos string e Date padrão do Javascript, por exemplo: '2017-11-28' ou new Date(2017, 10, 28).
datetime	datetime	Valor de data com horário. Aceita o tipo string no formato ISO-8601 estendido 'yyyy-mm-ddThh:mm:ss+\|-hh:mm' e o tipo Date padrão
number	integer	Valores numéricos
string	character	Textos

Informações

title	Dica

Sugerimos a utilização do facilitador progress "com.totvs.framework.api.JsonAPIUtils", que faz a conversão dos tipos da dados do progress

para tipo de dados JavaScript e contêm o método abaixo :

Assinatura:

convertAblTypeToHtmlType (INPUT cType AS CHARACTER)

Exemplo:

ASSIGN cType = JsonAPIUtils:convertAblTypeToHtmlType ("integer").

O retorno no cType será "number", que é um formato reconhecido pelo PO-UI.

Não

Validação Campo

Caso o campo possuir alguma validação de máscaras, restrição de valores, é necessário informar neste campo (máscara de formatação do campo)

Exemplos:

Em um campo personalizado CNPJ, utilizamos o formato de exibição '99.999.999/9999-99'.

Não

Somente Leitura

Opção para que o campo seja apresentado como 'somente leitura' (torna o campo readOnly)

Sim

Habilita personalização

Opção para habilitar ou desabilitar a apresentação da personalização por campo (torna o campo visível)

Sim

...

Tela do componente HTML com o resultado da personalização

06. LINKS ÚTEIS

Documentação API Datasul:

https://tdninterno.totvs.com/display/public/FRAMJOI/Desenvolvimento+de+APIs+para+o+produto+Datasul

PO-UI:

Migração THF PO-UI (https://po-ui.io/guides/migration-thf-to-po-ui)
Dynamic-View (https://po-ui.io/documentation/po-dynamic-view);
I18N (https://po-ui.io/documentation/po-i18n)

GIT Projeto:

fwk-tools-jille/DATASUL/customization-poui/ ( https://github.com/totvs/fwk-tools-jille )

07. CONCLUSÃO

A ideia era apresentar uma técnica de construção para a personalização de um programa TOTVS da Liinha Datasul, de forma segura e simples.

...

Árvore de páginas

Versões comparadas

Versão antiga 9

Nova versão 10

Chave