Histórico da Página
...
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:
- Siga os passos para criar um formulário
- No arquivo html do formulário inclua três campos (para detalhamento na forma de apresentação, veja na sessão controles visuais):
Bloco de código | ||
---|---|---|
| ||
<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 | ||
---|---|---|
| ||
var datasetReturned = DatasetFactory.getDataset({codigo-do-seu-formulario}, null, null, null); |
Onde:
Elemento | Descrição |
---|---|
datasetReturned | Objeto 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 | ||
---|---|---|
| ||
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:
Elemento | Descriçã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:
|
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.
...