Índice
Índice |
---|
outline | true |
---|
exclude | .*ndice |
---|
style | none |
---|
|
Objetivo
Este guia é destinado aos desenvolvedores internos e externos da plataforma que desejam utilizar o componente Busca de documentos. 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 da plataforma, disponíveis na página Componentes de Negócio.
Componente
O componente Busca de documentos tem como objetivo facilitar a busca de documentos e pastas da plataforma, restando para o desenvolvedor somente configurar o plugin e utilizar o callback para montar sua lógica de negócio.
Estrutura Básica
Como pode-se notar na estrutura básica, o componente recebe basicamente 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. Veja o exemplo abaixo:
Bloco de código |
---|
language | js |
---|
theme | Eclipse |
---|
title | Estrutura básica do componente |
---|
|
ECMBC.searchDocument(config, callback); |
O primeiro parâmetro espera um objeto contendo até nove atributos, onde nenhum é obrigatório:
Bloco de código |
---|
language | js |
---|
theme | Eclipse |
---|
title | Parâmetro config |
---|
|
var config = {
width: 750, // valor default 750. Define a largura da janela
height: 500, // valor default 500. Define a altura da janela
parentId: 0, // valor default 0. Id do diretório inicial da busca, com breadcrumb completo
docTypeId: '1-2-8', // valor default '1-2-8'. Id dos tipos de documentos que devem aparecer na busca, separados por -
showPrivate: false, // mostrar ou não aquivos privados
minPermission: 0, // id da permissão mínima para mostrar o arquivo
showCheckOutDocs: false, // mostrar ou não arquivos em checkout
socialDocId: 0, // id da pasta onde a busca vai iniciar, o breadcrumb será apenas desta pasta em diante
selectableDocTypeId: '1-2-8' // valor default '1-2-8'. Id dos tipos de documentos que podem ser selecionados na busca, separados por -
}; |
O segundo parâmetro espera uma função que recebe dois valores: error e data. O valor data contém o objeto do arquivo/pasta selecionado.
Bloco de código |
---|
language | js |
---|
theme | Eclipse |
---|
title | Parâmetro callback |
---|
|
function(error, data) {
if(error) {
//tratamento de erro...
}
//lógica do sucesso...
} |
Utilização Básica
Um exemplo da utilização básica abaixo:
Bloco de código |
---|
language | js |
---|
theme | Eclipse |
---|
title | minhawidget.js |
---|
|
var EcmDocumentUpdate = SuperWidget.extend({
width: null,
docTypeId: null
bindings: {
local: {
'search-document': ['click_searchDocument']
}
},
init: function() {
this.width = 900;
this.docTypeId= '1-2';
},
searchDocument: function(el, ev) {
var that = this;
ECMBC.searchDocument({
width: that.width,
docTypeId: that.docTypeId
}, function(err, data) {
if(err) {
return alert(err.responseText);
}
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. Como no exemplo abaixo:
Bloco de código |
---|
language | bash |
---|
theme | Eclipse |
---|
title | application.info |
---|
|
application.resource.component.1=ecm/searchdocument |
- Abaixo você confere um exemplo da tela exibida ao chamar o componente:
![](/download/attachments/505770336/image2019-8-6_15-43-37.png?version=1&modificationDate=1565116875863&api=v2)
Tela exibida ao chamar o componente