Árvore de páginas

Índice


Objetivo

O objetivo deste guia é demonstrar a integração de widgets com formulários/datasets do TOTVS Fluig Plataforma.

Exemplo completo

Deseja um exemplo completo de consumo de dados de formulários/datasets no Fluig Plataforma? Faça o download dos códigos-fonte do Kit Intranet no repositório Git.

Armazenamento

Frequentemente é necessário armazenar dados além daqueles que a plataforma Fluig já guarda nativamente. Pensando nisso, o TOTVS Fluig Plataforma disponibiliza a personalização de formulários, uma forma de guardar seus dados de forma simples e ágil:

Esse é um recurso valioso da plataforma Fluig e preparado para realizar soluções completas e complexas. Entretanto, pode ser usado de forma bem fácil para atender as demandas mais simples. Utilizando datasets, o processo de armazenamentos de dados torna-se rápido.

Imagine que você deseja guardar o nome, o dia e o mês do aniversário dos colaboradores de sua empresa. Considere os passos abaixo:

<form name="form" role="form">
	...
	<input name="newTitle" id="newTitle">
	...
	<input name="newDescription" id="newDescription">
	...
	<input name="newsSourceURL" id="newsSourceURL">
	...
</form>

Feito isso, basta seguir os passos de exportação de um artefato Fluig para um servidor Fluig e seu formulário já estará pronto para armazenamento. Uma dica é escolher a pasta padrão "Formulários Fluig" para armazenar os formulários no momento da exportação para a plataforma.


Utilização

Com seu formulário pronto e preenchido com os dados desejados, basta buscar a identificação do seu formulário no início do arquivo JavaScript.

Dúvidas para criar o widget? Siga o guia.

De posse da identidade do registro, é simples buscar os dados dele. Em seu arquivo .js execute uma chamada ao DatasetFactory. A seguir é apresentado um exemplo simples:

var datasetReturned = DatasetFactory.getDataset("kit_news", null, null, null);

Onde:

ElementoDescrição
datasetReturnedObjeto contendo os registros do formulário retornados.
"kit_news"
Código escolhido para o formulário/dataset (definido aqui).

Datasets Internos

A mesma técnica que é utilizada para consumir datasets de formulários, permite consultar também datasets internos do Fluig. Basta substituir o código do dataset e seus respectivos campos.


O consumo desses registros pode ser efetuado da seguinte forma:

if(datasetReturned != null && datasetReturned.values != null && datasetReturned.values.length > 0){
	var records = datasetReturned.values;
	for (var index in records) {
		var record = records[index];
		// ... restante do código omitido
	}
}

Onde:

ElementoDescrição
datasetReturned
Objeto contendo os registros do formulário retornados.
records
Um array de objetos (Object[ ]) contendo os registros.
index
Índice do registro corrente conforme o laço (for) avança pelo array.
record

É o registro, ou seja, o objeto contendo as propriedades de um registro de formulário.

Considerando o exemplo do formulário de notícias, podemos assumir para esse caso que as propriedades desse objeto serão as seguintes:

  • record.newTitle

  • record.newDescription

  • record.newsSourceURL

Veja o exemplo em nosso repositório aqui.