Árvore de páginas

Versões comparadas

Chave

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

...

Permite a consulta de entidades e outros formulário criados no Fluig para seleção de dados pelo usuário.

O acesso a Para utilizar este componente é realizado a partir de uma chamada Javascript no HTML da definição de formuláriobasta inserir um campo de texto com alguns parâmetros específicos .
Bloco de código
languagehtml/xml
"/webdesk/zoom.jsp?datasetId="+dataset+"&dataFields="+campos+"&resultFields="+resultFields+"$type="+"&title="+titulo

Onde:

 

  • title: é o título para a janela de zoom.
  • datasetId: é o nome do dataset (Built-in, CardIndex ou Customized).
  • dataFields: são os nomes dos campos a serem apresentados.
  • resultFields: são os campos que devem ser retornados para o registro selecionado pelo usuário.
  • likeField: o nome do campo para filtro de dados (se necessário).
  • likeValue: o valor a ser usado no filtro de dados (se necessário).

 

ATENÇÃO: Este parâmetro só é válido para datasets internos. Datasets customizados não permitem a utilização de filtros.

 

  • Para obter o registro selecionado pelo usuário devemos adicionar a seguinte função JavaScript ao formulário do processo:
Bloco de código
languagehtml/xml
function setSelectedZoomItem(selectedItem) {               
}

Onde selectItem é o registro selecionado pelo usuário na tela de zoom.

Nota
titleImportante

A mesma função “setSelectZoomItem” será usada para receber o resultado de todas as chamadas ao zoom. Assim, para diferenciar cada chamada foi criado o parâmetro type. Esse parâmetro é retornado em selectedItem e pode ser usado para diferenciar as chamadas ao zoom.

 

  • Para acessar um campo do registro selecionado:
<input 
	type="zoom"  
	name="colleague_zoom1"
	data-zoom="{
		'datasetId':'colleague',
		'fields':[
			{
				'field':'colleagueId', 
				'label':'ID'
			},{
				'field':'colleagueName', 
				'label':'Nome', 
				'standard':'true', 
				'search':'true'
			}
		]
	}" />

Onde:

  • type: o atributo type para este componente obrigatoriamente é 'zoom'
  • name: nome do campo
  • data-zoom: parâmetros do zoom onde:
    • displayKey: valor de exibição após selecionado o registro.
    • filterValues: atributo do dataset e valor para serem filtrados.
    • datasetId ou cardDatasetId: opte por uma das opções:
      • datasetId:  é o nome do dataset (Built-in, CardIndex ou Customized).
      • cardDatasetId: é o numero de outro formulário para consulta.
    • fields: Estrutura do filtro 
      • field: atributo do dataset que será utilizado.
      • label: descrição da coluna.
      • standard: a coluna que será utilizada como ordenação padrão e valor do registro selecionado.
      • search: a coluna que será utilizada para filtrar os registro.

 

ATENÇÃO: Este parâmetro só é válido para datasets internos. Datasets customizados não permitem a utilização de filtros.

 

  • Para obter outros atributos do registro selecionado pelo usuário pode ser adicionada a seguinte função JavaScript ao formulário do processo:
Bloco de código
languagehtml/xml
function setSelectedZoomItem(selectedItem) {               
}

Onde selectItem é o registro selecionado pelo usuário na tela de zoom.



  • Para acessar um campo do registro selecionado:
Bloco de código
languagehtml/xml
Bloco de código
languagehtml/xml
selectedItem["fieldName"]

Onde fieldName é o nome do campo de retorno que foi definido na chamada de zoom.Para obter o registroo componente de Zoom do

...

fluig foi desenvolvido para permitir que o recurso de zoom fosse utilizado em definições de formulários.

 

Para que seja possível visualizar e resgatar informações dos campos “metadatas” do formulário, é necessário utilizar a seguinte nomenclatura:

metadata_id

Retorna o código do registro de formulário

medatata_version

Retorna a versão do registro de formulário

metadata_parent_id

Retorna o código da pasta Pai

metadata_card_index_id

Retorna o código do formulário

metadata_card_index_version

Retorna a versão do formulário

metadata_active

Versão ativa

 

Abaixo um exemplo de código utilizado para visualização e resgate destes valores:

Bloco de código
languagehtml/xml
function zoomFormulario(titulo, dataset, campos, resultFields, type){
	window.open("/webdesk/zoom.jsp?datasetId="+dataset+"&dataFields="+campos+
	"&resultFields="+resultFields+"&type="+type+"&title="+titulo, "zoom", "status , scrollbars=no ,width=600, height=350 , top=0 , left=0");
} 
Informações

A utilização da PK nos filtros ao utilizar dataset de Grupo, Papel ou Colaborador é opcional, porém o mesmo valor utilizado na URL do zoom deve ser utilizado para a obtenção do valor selecionado, conforme exemplo abaixo.

Bloco de código
languagehtml/xml
function setSelectedZoomItem(selectedItem) {
	alert("Grupo: " + selectedItem['groupId'] + " Colaborador: "+ selectedItem['colleagueGroupPK.colleagueId']);
}
 
<input type="button" class="btZoom" onclick="zoomFormulario('title', 'colleagueGroup', 'groupId,Codigo,colleagueGroupPK.colleagueId,Matricula','groupId,colleagueGroupPK.colleagueId', 'nofield');">
 

_active

Versão ativa

Informações

A utilização da PK nos filtros ao utilizar dataset de Grupo, Papel ou Colaborador é opcional, porém o mesmo valor utilizado definição do zoom deve ser utilizado para a obtenção do valor selecionado, conforme exemplo abaixo.

 

Visualização e resgate destes valores 

Para utilizar filtros a chamada é similar ao de dataFields.

Segue exemplo abaixo:

Bloco de código
languagehtml/xml
window.open("/webdesk/zoom.jsp?datasetId=preCad&dataFields=codigo, Código, descricao, Descrição&resultFields=descricao&type=precad&filterValues=metadata_active, false","zoom" , "status, scrollbars=no, width=600, height=350, top=0, left=0");

Neste exemplo, o zoom irá retornar somente os registros de formulários inativos.

 

Informações

A antiga técnica para zoom ainda é suportada pela plataforma. Porém, recomendamos a utilização da técnica descrita acima que está de acordo com os padrões do fluig Style Guide e permite maior fluidez utilizando o componente.

 

 

Zoom Externo

Em situações aonde os dados dos elementos externos ao Fluig são muito volumosos é recomendada a construção de uma aplicação externa ao Fluig que fará o papel de zoom para o usuário. Abaixo será descrita uma técnica JavaScript aonde será possível chamar uma aplicação externa e a mesma poderá devolver o dado solicitado pelo usuário para um campo do formulário do Fluig.

...