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 precisar 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 customização de formulários.

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

 

É um recurso valioso do Fluig e preparado para realizar soluções completas e complexas. Entretanto pode ser usado de forma bastante descomplicada para atender a demandas mais simples. Utilizando datasets, o processo de armazenamentos de seus dados torna-se rápido. Imagine que você deseja guardar o nome, dia e mês do aniversário do 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 agora 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 se encotrará lá exibindo o nome escolhido no momento da criação.

Utilização

Com seu formulário pronto e alimentado 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 desse. Em seu arquivo .js execute uma chamada ao DatasetFactory. Abaixo um exemplo simples:

var datasetReturned = DatasetFactory.getDataset({codigo-do-seu-formulario}, null, null, null);

Onde:

ElementoDescrição
datasetReturnedObjeto contendo os registros do formulário retornados
{codigo-do-seu-formulario}
Código escolhido para o seu formulário (definido aqui )

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