Índice

Objetivo

...

Este guia é destinado aos desenvolvedores internos e externos do fluig que desejam utilizar o componente Seleção de comunidades para recuperar a comunidade desejada e utilizá-la em seu componente ou widget. O objetivo é apresentar o seu funcionamento e o detalhamento de todos os parâmetros de configuração.

Pré-requisitos

...

Conhecer os conceitos dos componentes de negócio do fluig, disponíveis na página Componentes de Negócio.

Seleção de comunidades

...

O componente Seleção de comunidades tem como objetivo facilitar a etapa de seleção de uma ou mais comunidades, encapsulando todas as configurações básicas necessárias para essa operação, restando para o desenvolvedor somente configurar o plugin e utilizar o callback para montar sua lógica de negócio.

Estrutura Básica

...

A seguir é apresentada a estrutura básica do componente:

SOCIALBC.selectCommunity(config, callback);

O componente recebe dois parâmetros:

• o primeiro, um objeto config com as configurações do componente;
• e o segundo, uma função callback contendo o erro e/ou o sucesso da seleção.

O primeiro parâmetro espera um objeto contendo dois atributos: multiselect, e required, sendo os dois opcionais.

var config - {
	multiselect: true, //opção que determina se é possível a seleção de uma ou mais comunidades do componente. - Valor default: true
	required: true //opção que determina se a seleção de comunidade é uma etapa obrigatório no fluxo. - Valor default: false
};

O segundo parâmetro espera uma função que recebe dois valores: error e data.

function(error, data) {
	if(error) {
		//tratamento de erro...
	}
	
	//lógica do sucesso...
}

Utilização Básica

...

A utilização básica do componente é apresentada a seguir:

var GlobalSearch = SuperWidget.extend({

	alias: null,
	
	bindings: {
		local: {
			'select-comunity': ['click_selectCommunity']
		}
	},
	
	init: function() {
		//init essential params
	},
	
	selectCommunity: function(el, ev) {
		var that = this;

		SOCIALBC.selectCommunity({
			multiselect : false,
			required : true
		}, function(data) {
			that.someFunc(data);
		});
	},

	someFunc: function(data) {
		//Qualquer coisa com o retorno de sucesso...
	}
});

No application.info de seu widget, adicione o componente como dependência:

application.resource.component.1=social/selectcommunity

Tela exibida ao chamar o componente

Image Added

O componente de seleção de usuários oferece a possibilidade do usuário selecionar um ou mais usuários para alguma necessidade dentro de seu componente ou widget.

Para habilitar o componente de seleção de usuário na sua widget, adiciona-se a seguinte propriedade no application.info da widget:

 application.resource.component.1=wcm/selectuser

O componente possui as opções:

multiselect: true para que seja possível selecionar mais de um registro, false para que seja possível selecionar apenas um registro.

required: true para que seja possível avançar apenas se algum registro estiver selecionado, false para obrigar a selecionar algum usuário.

A utilização deste componente pode ser feita da seguinte maneira:

WCMBC.selectUser(
	{	
		multiselect: true/false, 
		required:true/false
	}, 
	functionfuncaoCallbackSucesso, 
	funcaoCallbackCancelar
);
 
Exemplo:
 

 
var MyWidget = SuperWidget.extend({
    init: function() {},
    
	selectUsers: function(htmlElement, event) {
    	var options = {multiselect: true, required: true};
    	WCMBC.selectUser(options, function(data){
    		FLUIGC.toast({
    	        title: 'Usuários selecionados: ' + data.length,
    	        message: data[0].login,
    	        type: 'success'
    	    });
    		console.log(data);
    	}, function() {
    		FLUIGC.toast({
    	        title: 'Cancelar',
    	        message: 'Usuário cancelou a seleção',
    	        type: 'success'
    	    });
    	});
    }
});

Ao executar o componente, ele será apresentado.

Image Removed