Árvore de páginas

Versões comparadas

Chave

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

...

Note que a função javascript createDataset, que cria o Dataset para consulta, recebe como parâmetros os campos, as constraints e a ordenação. Cabe ao desenvolvedor utilizar estes valores na lógica de implementação do Dataset avançado. Caso seja desconsiderado algum desdes campos, os filtros não serão aplicados. Os parâmetros "fields" e "sortFields" são arrays de String, que possuem, respectivamente, os nomes dos campos que serão retornados e os nomes dos campos utilizados para ordenação. Já o parâmetro "constraints" é um array de objetos do tipo Constraint, onde cada objeto deste array possui as seguintes propriedades: 

PropriedadeDescrição
fieldNameNome do campo
initialValueValor inicial para filtro neste campo
finalValue

Valor final para filtro neste campo

contraintType

Tipo do filtro deste campo, podendo ter os valores abaixo:

MUST: O valor informado precisa estar nos resultados

SHOULD: O valor informado pode estar ou não nos resultados

MUST_NOT: O valor informado não pode estar nos resultados


Para acessar estas propriedades e analisar os valores de cada item, pode-se utilizar um laço de repetição, conforme implementação abaixo:

...

Utilizando um dos modelos acima, é possível recuperar os valores "filhos" dos formulários ativos, ou seja, da última versão criada. Existem alguns parâmetros obrigatórios que devem ser passados através de constraints, onde o valor inicial e final devem ser iguais. A forma de recuperar esses valores é opcional. Segue abaixo a nomenclatura obrigatória de cada parâmetro:

ParâmetroDescrição
tablename

Atributo utilizado para nomear cada tabela filha do HTML. Exemplo:

Bloco de código
languagejs
themeEclipse
linenumberstrue
<table border="1" tablename="tabelaPecas" addbuttonlabel="Adicionar Peça">
	<!-- Campos Filhos -->
</table>
metadata#idNúmero do formulário.
metadata#versionNúmero da versão do formulário
userSecurityId

Código do usuário que será validada a permissão no formulário

Nota
titleObservação

Esse parâmetro não será validado na Visualização de Datasets, visto que nessa opção é um exemplo de visualização dos dados.

Também é possível exibir a ordem dos campos filhos, para isso deve-se utilizar o campo wdk_sequence_id, sendo que este não poderá ser utilizado como nome de algum campo do formulário.

...

Guia de Referência de Datasets

...

Dataset Factory

RetornoMétodo e Descrição
SearchConstraintcreateConstraint(java.lang.String field, java.lang.String initialValue, java.lang.String finalValue, ConstraintType type) 
Cria uma nova constraint para a seleção de registros do Dataset.
java.util.List<java.lang.String>getAvailableDatasets() 
Retorna uma lista de todos os Datasets disponíveis no sistema.
DefaultDatasetgetDataset(java.lang.String name, java.lang.String[] fields, SearchConstraint[] constraints, java.lang.String[] order) 
Carrega os dados de um Dataset.

Dataset

RetornoMétodo e Descrição
voidaddColumn(java.lang.String colName) 
Adiciona uma coluna ao Dataset.
voidaddRow(java.lang.Object[] values) 
Adiciona uma linha ao Dataset.
java.lang.StringgetColumnName(int colNum) 
Retorna o nome de uma coluna do Dataset.
java.lang.String[]getColumnsName() 
Retorna um array com os nomes das colunas do Dataset.
intgetColumnsCount() 
Retorna a quantidade de colunas de um Dataset.
java.util.ArrayList<java.util.HashMap<java.lang.String,java.lang.Object>>getMap() 
Retorna os valores do Dataset na forma de uma lista contendo mapas, onde cada registro do Dataset corresponde a um mapa com o nome da coluna como chave.
intgetRowsCount() 
Retorna a quantidade de linhas disponíveis no Dataset.
DefaultDatasetgetSubDataset(java.lang.String field, java.lang.Object value) 
Retorna um subconjunto dos dados do Dataset, na forma de um novo Dataset.
java.lang.ObjectgetValue(int row, int col) 
Retorna o valor armazenado no Dataset, na linha e coluna passadas por parâmetro.
java.lang.ObjectgetValue(int row, java.lang.String colName) 
Retorna o valor armazenado no Dataset, na linha passada e campo passados por parâmetro.
java.lang.Object[][]getValues() 
Retorna todos os valores de um Dataset, na forma de um array bidimensional.
java.sql.ResultSettoResultSet() 
Retorna um ResultSet contendo os dados do Dataset.
Dica
titleDica!

Se tiver dúvidas sobre o desenvolvimento de datasets avançados, não deixe de consultar o nosso fórum para DEVs.