Índice

 

Objetivo

O objetivo deste guia é demonstrar a integração de widgets com formulários/datas fluig.

Deseja um exemplo completo de consumo de dados de formulários/datasets no fluig?
Baixe já o Kit Intranet na Fluig Store e confira no repositório GIT os códigos fontes descritos no exemplo abaixo.

Armazenamento

Frequentemente é necessário armazenar dados além daqueles que a plataforma fluig já guarda nativamente e não faz sentido esperar que toda pessoa que precise de tal recurso tenha de saber ou contratar alguém que saiba configurar novas tabelas no banco de dados. Pensando nisso, o fluig disponibiliza uma forma de guardar seus dados de forma simples e ágil. Estamos falando da personalização de formulários.

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

Esse é um recurso valioso do 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. Por padrão, os formulário localizam-se em Documentos / Formulários fluig. Seu formulário estará lá exibindo o nome escolhido no momento da criação.

 

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.
Em 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).

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];
		// ... restanto 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