Fluig - Plataforma - DES - Os valores estão retornando 'null' na consulta de datasets offline no mobile

Dúvida

Percebemos que, se na declaração dos campos de um dataset, a grafia do nome dos campos está em minúsculo, o dataset é consumido normalmente na web ou no mobile online. Porém, quando consumindo no mobile jornalizado (offline) temos que usar o nome dos campos em maiúsculo para que a consulta não retorne 'null'.

Neste cenário, o que podemos fazer para sempre retornar os valores corretos?

Ambiente
TOTVS Fluig Plataforma - Desenvolvimento sobre a plataforma - Versão 1.7.0 Lake e superiores.

Solução

Esse comportamento ocorre em virtude da criação das tabelas no banco de dados, que por padrão utiliza as colunas com nomes todo em maiúsculo. Em alguns pontos do desenvolvimento sobre a plataforma é possível que as colunas sejam acessadas somente usando a definição do nome da mesma no banco de dados, ou seja, todo em maiúsculo.

Para evitar esta situação é sugerido que a definição das colunas seja sempre em maiúsculo, assim indiferente de onde realizemos a consulta, estará sempre respeitando o “padrão“.

Veja os exemplos abaixo:

Note que nesta forma de definição, os campos estão em minúsculo portanto, não recomendada:

function defineStructure() { 
	addColumn("cod_cliente");
	addColumn("nom_cliente");
	
	setKey(["cod_cliente"]);
}

Recomendamos a definição das colunas de forma padronizada, com caracteres em MAIÚSCULO, veja:

function defineStructure() {
	addColumn("COD_CLIENTE");
	addColumn("NOM_CLIENTE");
	
	setKey([ "COD_CLIENTE" ]);
}

Indiferente da funcionalidade usada, o acesso a coluna será sempre da mesma forma e, por esse motivo, é importante que a definição e a consulta estejam padronizadas.

Confira abaixo o exemplo de acesso a coluna via desenvolvimento sobre a plataforma, que funcionará tanto na web quanto no mobile, online e offline:

var dataset = DatasetFactory.getDataset('dataset', new Array(), new Array(), new Array());
var dados = dataset.values;
for ( var i in dados ) {
	var dado= dados[i];
	var codigo = dado["COD_CLIENTE"];
	var nome = dado["NOM_CLIENTE"];
}