Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

As preferências da widget são recuperadas automaticamente. Basta salvar as preferências com os nomes das variáveis da widget, como no tópico Como salvar as preferências da widget.

Como fazer uma chamada REST para obter dados

Integrando sua widget com armazenamento de dados.

Interno (Formulários)

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.

É 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:

Bloco de código
languagexml
<form name="form" role="form">
	...
	<input name="fullName" id="fullName">
	...
	<input name="birthMonth" id="birthMonth" type="number">
	...
	<input name="birthDay" id="birthDay" type="number">
	...
</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:

Bloco de código
languagejs
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:

Bloco de código
languagejs
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 aniversários, podemos assumir para esse caso que as propriedades desse objeto serão as seguintes:

  • record.fullName

  • record.birthMonth

  • record.birthDay

Externo (REST)

Para obter dados de uma fonte externa ao seu sistema, a forma mais aconselhável é via chamada REST. Vamos Vamos criar um rest dentro da própria widget, para isso devemos seguir alguns passos.

...