Manual Técnico

Machine Translated by Google
Versão
3.4
" Manual técnico
Janeiro de 2022
Autor Tecnoteca srl
www.tecnoteca.com
POR
www.cmdbuild.org
Manual técnico
Nenhuma parte deste documento pode ser reproduzida, no todo ou em parte, sem a permissão expressa por escrito
da Tecnoteca srl
O CMDBuild ® usa muitas tecnologias excelentes da comunidade de código aberto:

PostgreSQL, Apache, Tomcat, Eclipse, Ext JS, JasperSoft, JasperReports, IReport, Enhydra Shark, TWE, OCS
Inventory, Liferay, Alfresco, GeoServer, OpenLayers, Quartz, BiMserver.
Agradecemos as grandes contribuições que levaram à criação desses produtos.
CMDBuild ® é um produto da Tecnoteca Srl que é

responsável pelo design e desenvolvimento do software, é o mantenedor oficial e
registrou o logotipo do CMDBuild.
O CMDBuild ® é lançado sob a licença de código aberto AGPL (http://www.gnu.org/licenses/agpl-3.0.html)
CMDBuild ® é uma marca registrada da Tecnoteca Srl.

Sempre que o logotipo do CMDBuild® for utilizado, o mantenedor oficial "Tecnoteca srl" deve ser mencionado;
além disso, deve haver um link para o site oficial:
http://www.cmdbuild.org.
Logotipo do CMDBuild®:
• não pode ser modificado (cor, proporção, forma, fonte) de forma alguma e não pode ser integrado em
outros logotipos
• não pode ser usado como logotipo corporativo, nem a empresa que o usa pode aparecer como autor/proprietário
/mantenedor do projeto
• não pode ser removido do aplicativo e, em particular, do cabeçalho na parte superior de cada
página
O site oficial é http://www.cmdbuild.org
CMDBuild – Configuração de código aberto e banco de dados de gerenciamento Página 2

Manual técnico
Conteúdo
1. Introdução............................................... ................................................ ................................5
1.1. A aplicação................................................ ................................................ ................................5 1.2. Website
oficial................................................ ................................................ ......................................6 1.3. Módulos do
CMDBuild.............................................. ................................................ .........................6 1.4. Manuais
disponíveis.................................................. ................................................ .........................6 1.5. Aplicações baseadas em
CMDBuild.......................................... ................................................ .........6 2. Configuração do
sistema.............................. ................................................ .............................8 2.1. Requisitos de

hardware ....................................... ................................................ ...................8 2.2. Requisitos de
software............................................. ................................................ ......................8 2.3. Requisitos do
cliente ....................................... ................................................ .........................10
3. Instalando o CMDBuild.......................................... ................................................ ...................11 3.1.

Começando................................................ ................................................ ................................11 3.2. Instalação do
CMDBuild.............................................. ................................................ ......................11 3.3. Instalação do CMDBuild via GUI
(Windows e Linux)........................................... ................................11 3.4. Instalação manual do CMDBuild (Linux e
Windows)............................. ................................16 3.5. Configuração do banco de dados CMDBuild via Db Config Wizard
(Linux e Windows)...........................16 3.6. Configuração manual do banco de dados do CMDBuild para
Windows.............................. ......................17 3.7. Configuração manual do banco de dados do CMDBuild para
Linux.......................................... .............................18
4. Atualização da versão do CMDBuild............................. ................................................ ...........19 4.1. Atualização do

CMDBuild.................................. ................................................ .............................19
5. Configuração para acessar um DMS através do CMIS............................... ................................20 5.1.

Introdução................................................. ................................................ .........................................20 5.2. Configuração da
gestão de categorias.............................................. .........................................20 5.3. Configuração do DMS no
CMDBuild.......................................... ................................................ 22
6. Backup dos dados do CMDBuild........................................... ................................................ ...........24 6.1. Backup do banco de

dados.............................................. ................................................ .............................24 6.2. Restauração do banco de
dados.............................................. ................................................ .............................24
7. Backup de dados Alfresco............................... ................................................ ..........25 7.1. Agendamento de

backup.............................................. ................................................ .............................26
8. Modos de autenticação........................................... ................................................ ................27

8.1. Introdução................................................. ................................................ .........................................27 8.2. Configuração
do tipo de autenticação.................................. ................................................27 8.3 . Configurando a autenticação
LDAP........................................... ................................................ ......30 8.4. Configuração de logon único por meio do
CAS.............................. .........................................30
9. Ativação da interface móvel.............................. ................................................ ..........31

9.1. Introdução................................................. ................................................ .........................................31 9.2. Componentes
e arquitetura.............................................. ................................................ ...........31 9.3.
Compatibilidade................................................. ................................................ ......................................31 9.4. Limitação de
uso ....................................... ................................................ ................................32
10. Ativação do GUI Framework.............................. ................................................ ........33

10.1. Introdução................................................. ................................................ ......................................33 10.2.
Configuração................................................. ................................................ ................................33
11. Geoservidor.............................................. ................................................ .............................35

11.1. Introdução ao GeoServer.............................................. ................................................ ................35 11.2. Instalando o
GeoServer.............................................. ................................................ ......................35

Manual técnico
11.3. Configurando o GeoServer no CMDBuild.......................................... ................................................35
12. BIM............................................. ................................................ .........................................36

12.1. Introdução................................................. ................................................ ......................................36 12.2. Introdução ao
BIMServer.............................................. ................................................ ................36 12.3.
Instalação................................................. ................................................ .........................................36 12.4. Introdução ao
Xeokit.............................................. ................................................ .........................38
13. Configuração do CMDBuild no modo cluster............................... ......................................40 13.1. Introdução ao

cluster.............................................. ................................................ ......................40 13.2. Configuração de
cluster.............................................. ................................................ ......................41 13.3. Configurando o balanceador de carga no
Apache.......................................... .........................................42 13.4. Verificar se o Cluster está
funcionando.......................................... ................................................ ...........42 13.5. Aplicando patches no modo
Cluster.......................................... ................................................ ....42
14. Apêndice: Glossário............................................. ................................................ ................43

Manual técnico 1. Introdução
1. Introdução
1.1. O aplicativo CMDBuild

é um ambiente web de código aberto para a configuração de aplicativos personalizados para o
Asset Management.
Por um lado, fornece mecanismos nativos para o administrador, implementados em um código "core" que foi mantido
separado da lógica de negócios, para que o sistema possa ser configurado com todas as suas funcionalidades.
Por outro lado, gera dinamicamente uma interface web para os operadores, para que estes mantenham sob controle a
situação patrimonial e conheçam sempre sua composição, destacamento, relações funcionais e como se atualizam, de
forma a gerenciar seu ciclo de vida de forma maneira abrangente.
O administrador do sistema pode construir e estender seu próprio CMDB (daí o nome do projeto), modelando o CMDB
de acordo com as necessidades da empresa; uma interface adequada permite adicionar progressivamente novas
classes de itens, novos atributos e novas relações. Você também pode definir filtros, "visualizações" e permissões de
acesso limitadas a linhas e colunas de cada classe.
Utilizando editores visuais externos, o administrador pode desenhar fluxos de trabalho, importá-los para o CMDBuild e
colocá-los à disposição dos operadores, para que possam executá-los de acordo com o automatismo configurado.
Da mesma forma, utilizando editores visuais externos, o administrador pode desenhar diversos relatórios sobre os
dados do CMDB (impressões, gráficos, etiquetas de código de barras, etc.), importá-los para o sistema e colocá-los à
disposição dos operadores.
O administrador também pode configurar alguns painéis compostos por gráficos que mostram imediatamente a situação
de alguns indicadores no sistema atual (KPI).
Um gerenciador de tarefas incluído na interface do usuário do Módulo de Administração permite agendar

várias operações (inícios de processos, recebimento e envio de e-mails, execuções de conectores) e vários
controles nos dados do CMDB (eventos síncronos e assíncronos). Com base em suas descobertas, ele
envia notificações, inicia fluxos de trabalho e executa scripts.
Graças aos sistemas de gestão documental que suportam o padrão CMIS (Content Management interoperability
Services) - entre os quais também existe a solução de código aberto Alfresco - você poderá anexar documentos, fotos,
vídeos e outros arquivos.
Há também um Agendamento, que pode ser fornecido tanto automaticamente no preenchimento de uma ficha de dados
quanto manualmente. Este Agendamento irá gerir prazos únicos ou recorrentes relacionados, por exemplo, com
certificações, garantias, contratos com clientes e fornecedores, procedimentos administrativos, etc.
Além disso, você pode usar recursos GIS para georreferenciar e exibir ativos em um mapa geográfico (serviços de
mapas externos) e/ou em mapas vetoriais (GeoServer local e banco de dados espacial PostGIS) e recursos BIM para
visualizar modelos 3D (formato IFC).
O sistema também inclui um serviço web REST, para que os usuários do CMDBuild possam implementar soluções
personalizadas de interoperabilidade com sistemas externos.
Além disso, o CMDBuild inclui duas estruturas externas:
• o Advanced Connector CMDBuild, que é escrito em Java e pode ser configurado em Groovy: auxilia na
implementação de conectores com fontes externas de dados, ou seja, sistemas de inventário automático,
virtualização ou monitoramento (fornecidos com licença não aberta para os usuários que assinar a Assinatura
anual com a Tecnoteca) • o GUI Framework CMDBuild, que auxilia na
implementação de gráficos adicionais

interfaces, ou seja, páginas da web (simplificadas para não técnicos) que devem ser publicadas em portais
externos e que podem interagir com o CMDB por meio do serviço da web REST
O CMDBuild inclui uma interface móvel (para smartphone e tablet). É implementado como aplicativo multiplataforma
(iOS, Android) e é capaz de interagir com o CMDB por meio do serviço web REST (fornecido com licença não aberta para
os usuários que assinam a assinatura anual da Tecnoteca).
O CMDBuild é um sistema empresarial: server-side Java, web Ajax GUI, arquitetura SOA (Service Oriented Architecture),
baseado em web service e implementado utilizando as melhores tecnologias open source e seguindo os padrões do setor.
O CMDBuild é um sistema em constante evolução, lançado pela primeira vez em 2006 e atualizado várias vezes ao ano
para oferecer mais recursos e suportar novas tecnologias.
1.2. Website oficial

O CMDBuild possui um site dedicado: http://www.cmdbuild.org O site
reúne muitos documentos sobre as características técnicas e funcionais do projeto: brochuras, slides, manuais (ver
próximo parágrafo), depoimentos, histórias de casos, boletins informativos, fóruns .
1.3. Módulos CMDBuild

O aplicativo CMDBuild inclui dois módulos principais:
• o Módulo de Administração para a definição inicial e as próximas alterações do modelo de dados e configuração de
base (classes e tipologias de relação, usuários e autorização, painéis, relatório de upload e fluxos de trabalho,
opções e parâmetros) • o Módulo de Gerenciamento, usado para gerenciar cartões
e relações, adicionar anexos, executar
processos de fluxo de trabalho, visualizar painéis e executar relatórios
O Módulo de Administração está disponível apenas para os usuários com a função "administrador"; o Módulo de Gestão
é utilizado por todos os usuários que visualizam e editam dados.
1.4. manuais disponíveis

Este manual é para aqueles que precisam de algumas primeiras informações introdutórias sobre o CMDBuild e estão
interessados em conhecer a filosofia geral do projeto.
Você pode encontrar todos os manuais no site oficial (http://www.cmdbuild.org):

• visão geral do sistema ("Manual de Visão Geral")
• uso do sistema para operadores ("Manual do Usuário") •
administração do sistema ("Manual do Administrador") •
configuração do fluxo de trabalho ("Manual do Fluxo de
Trabalho") • detalhes e configuração do serviço web ("Manual do Serviço Web")
1.5. Aplicações baseadas no CMDBuild A Tecnoteca utilizou
o ambiente CMDBuild para implementar duas diferentes soluções pré-configuradas:
• CMDBuild READY2USE, para a gestão de ativos e serviços de TI, orientado para infraestruturas
de TI internas ou serviços para clientes externos (http://www.cmdbuild.org/it/prodotti/ready2use)
de acordo com a melhor prática ITIL (Information Technology Infrastructure
Biblioteca) • openMAINT, para a gestão de inventário de ativos, propriedades e manutenção relacionada

atividades (http://www.openmaint.org)
Ambos os aplicativos são lançados com licença de código aberto, exceto alguns componentes externos
(conectores de sincronização de dados, portal de autoatendimento, APP móvel, etc.), reservados aos usuários que
assine a Assinatura anual com a Tecnoteca.
CMDBuild – Configuração de código aberto e banco de dados de gerenciamento página 7

Manual técnico 2. Configuração do sistema
2. Configuração do sistema
Nos parágrafos seguintes serão apresentados os requisitos de software necessários para o sistema CMDBuild e
como instalar e configurar seus componentes.
Ao planejar a configuração do sistema, questões de segurança da informação devem ser levadas em consideração.
A ativação de uma aplicação web como o CMDBuild demanda a disponibilidade de hardware e componentes de
rede com níveis de segurança adequados. Isso é necessário para evitar acessos externos indesejados (firewall,
DMZ) e para fornecer uma boa disponibilidade on-line do sistema e tempos de resposta adequados.
2.1. Requisitos de hardware Para a

instalação do CMDBuild é necessário um servidor físico ou virtual, com as seguintes características:
• CPU de última geração • um

mínimo de 8 GB de RAM, 16 GB se houver uso intensivo de adicional
funcionalidades, como DMS, servidor de mapas, servidor BIM.
• armazenamento em disco mínimo de 120 GB, deve ser muito maior se você precisar gerenciar arquivos
extensos de documentos (alimentados pelo gerenciamento de anexos).
Aconselhamos ainda que:
• o armazenamento em disco deve estar em configuração

RAID • os dados do sistema CMDBuild devem ser copiados
diariamente • um UPS disponível para evitar falhas repentinas de energia elétrica
2.2. Requisitos de software A instalação e

o uso do CMDBuild requerem os seguintes componentes de software.
Sistema operacional
Todo sistema operacional que suporte JVM e o software necessário suportará o CMDBuild.
O sistema operacional Linux é sugerido porque o CMDBuild é mais amplamente testado nele.
Base de dados
O PostgreSQL da versão 10 à versão 12 (versão recomendada) é necessário.

Você deve verificar se "plpgsql" está ativo e se o banco de dados está definido com uma codificação UTF-8.
O CMDBuild usa a biblioteca "tomcat-dbcp" para se conectar ao banco de dados, essa biblioteca é distribuída com
o Tomcat, mas não está incluída em algumas distribuições do Linux. Nesses casos, a biblioteca pode ser encontrada
na distribuição oficial do Tomcat ou na pasta extras/tomcat-libs/{Tomcat version dir} dentro do arquivo zip CMDBuild;
a biblioteca deve ser colocada em /usr/share/{Tomcat version dir}/lib.
O CMDBuild suporta apenas o banco de dados PostgreSQL, pois é o único que implementa a funcionalidade de
"derivação" de tabelas no sentido "orientado a objetos". Isso é usado para gerenciar

as subclasses e para gerenciar o histórico de cartões.

Se você usar os recursos GIS do CMDBuild, também deverá instalar a extensão espacial PostGIS para PostGRES. Se você
precisar de suporte para instalar e configurar o PostGIS, consulte os documentos e suporte oficiais do postgis: http://
www.postgis.net/install
Contêiner Servlet / Servidor Web
O CMDBuild precisa do Apache Tomcat 8.5 ou mais recente (tomcat 9.0.30 sugerido).
Se o CMDBuild for instalado via GUI, uma nova instalação do tomcat será fornecida.
Para suportar os caracteres UTF-8 ao usar anexos (consulte Instalação do sistema DMS), edite o arquivo de
configuração “server.xml” e especifique o atributo URIEncoding="UTF-8" para o elemento "Conector" principal.
Você pode usar o servidor web Apache 2.2 para acessar muitas instâncias do CMDBuild por meio de hosts
virtuais que suportam diferentes domínios.
Site de referência para ambos: http://www.apache.org/
Sistema de Gestão de Documentos (DMS)

Qualquer DMS que suporte o protocolo CMIS pode ser instalado para as funcionalidades do Sistema de Gestão
de Documentos (que são opcionais).
Alfresco é o DMS sugerido.
Site de referência: http://www.alfresco.com/
Bibliotecas Java
As bibliotecas Java são exigidas pelo Apache Tomcat.

CMDBuild requer java 17.
Site de referência: http://www. oracle .com/
Bibliotecas incluídas no lançamento
O arquivo CMDBuild disponível para download no site do projeto contém algumas bibliotecas já dentro do pacote
de instalação, a saber:
• a biblioteca para a conexão JDBC com o banco de dados PostgreSQL • as
bibliotecas Jasper Reports para a produção de relatórios (http://www.jasperforge.org/) • Bibliotecas
TWS Together Workflow Server 4.4 que implementam o mecanismo de fluxo de trabalho usado por
CMDBuild (http://www.together.at/prod/workflow/tws)
• o webservice disponível no sistema DMS Alfresco para usar seu repositório (http://www.alfresco.com/ )
• as bibliotecas ExtJS para a geração da interface de usuário Ajax (http://extjs.com/) • os

componentes servidor e cliente para publicação de cartografia georreferenciada (http://geoserver.org/ e
http://openlayers.org/)
• os componentes do servidor e do cliente para a visualização dos componentes BIM
Para desenhar relatórios personalizados, você pode usar o editor visual Jasper Studio (6.x) ou IReport (versão
5.x), que produzem seu descritor em formato compatível com o mecanismo Jasper Reports

(http://jasperforge.org/projects/ireport).
Para projetar fluxos de trabalho personalizados, sugerimos o uso do editor visual TWE Together Workflow
Editor 4.4 (http://www.together.at/prod/workflow/twe). O editor produz na saída um arquivo XPDL 2.0
compatível com o mecanismo Together Workflow Server 4.4.
Para integração de sistemas de inventário automático sugerimos a utilização do OCS Inventory versão 1.3.3
(http://www.ocsinventory-ng.org/).
Algumas funcionalidades do CMDBuild podem ser integradas como portlets dentro de sistemas compatíveis
com o Portal JSR, entre elas o Liferay versão 6.0.6 ou mais recente (http://www.liferay.com/).
Todos os softwares listados acima são lançados com uma licença Open Source (o sistema operacional não
está incluído se você optar por não usar o sistema operacional Linux).
2.3. Requisitos do cliente

Toda interação feita com o CMDBuild (utilização, administração, atualização do sistema e estruturação do
banco de dados) é feita via aplicação web.
Isso significa que o usuário, para interagir com o sistema, deverá ter um navegador web de última geração
instalado (navegadores suportados: Mozilla Firefox, Google Chrome, Microsoft Explorer 11, Microsoft Edge,
Apple Safari).
A arquitetura web garante usabilidade completa para qualquer organização de TI que opere em vários locais
(ou seja, fluxo de trabalho colaborativo); qualquer cliente confiado pode se conectar e interagir com o sistema
usando um navegador da web padrão.

Manual técnico 3. Instalando o CMDBuild
3. Instalando o CMDBuild
3.1. Introdução O CMDBuild
pode ser instalado de diferentes maneiras, sugerimos a instalação via GUI. De qualquer forma,
a seguinte lista de software é necessária antes da instalação:
• Banco de dados PostgreSQL (deve ser iniciado e acessível) • Servidor
de aplicação Tomcat (somente se for feita instalação manual) • DMS Alfresco (ou
outros que suportem o protocolo CMIS, caso pretenda utilizar o gerenciamento de documentos anexos)
• o ambiente Java
Como primeiro passo, portanto, é necessário garantir o download e a instalação desses produtos, recuperando-os
nos links mencionados no capítulo anterior.
Atenção: você deve ter cuidado para usar diretórios que não contenham espaços em todo o caminho.
3.2. Instalação do CMDBuild

Depois de obter e instalar os programas necessários anteriormente, podemos prosseguir com a instalação do
CMDBuild.
Os arquivos de instalação são fornecidos no site oficial do CMDBuild no seguinte link: http://www.cmdbuild.org/en/download/
Um arquivo .war é fornecido para prosseguir com a instalação gráfica ou manual.
3.3. Instalação do CMDBuild via GUI (Windows e Linux)

Para simplificar a instalação e configuração padrão do CMDBuild, uma instalação GUI guiada foi fornecida para
sistemas operacionais Windows e Unix.
Depois de baixar o arquivo .war, abra um terminal (no linux) ou uma janela cmd (no windows) e vá para a pasta que
contém o arquivo .war. Para executar a GUI, digite o seguinte comando:
java -jar cmdbuild.war -v
Este comando iniciará a interface gráfica como na captura de tela a seguir:
Ao clicar em “instalar CMDBuild V3” seremos levados aos primeiros passos de configuração:


Neste formulário podemos decidir a configuração básica do CMDBuild, os vários campos são agora descritos:
• Tomcat dir: o caminho onde instalar um novo tomcat • Tomcat port:
a porta que o tomcat usará para se comunicar • Database type: dois bancos
de dados básicos são apresentados, um vazio onde apenas a estrutura básica é apresentada, mas nenhum dado é
adicionado, ou uma demonstração onde, além da estrutura básica, alguns dados são adicionados para fins de
demonstração
• Host do banco de dados: o host onde instalar o tomcat, localhost se quisermos executá-lo em nosso
máquina
• Porta do banco de dados: a porta usada para se comunicar com o banco de dados
• Nome do banco de dados: o nome do banco de dados que será criado
• Usuário do banco de dados: o usuário básico do banco de dados, padrão: cmdbuild
• Senha do banco de dados: a senha básica do usuário do banco de dados, padrão: cmdbuild • Usuário
administrador do banco de dados: o usuário administrador do banco de dados, padrão: postgres
• Senha do administrador do banco de dados: a senha do usuário administrador do banco de dados, padrão: postgres
Uma boa prática é testar a configuração com o botão “Test Config”, se tudo estiver configurado corretamente aparecerá o
seguinte pop-up:

Agora podemos prosseguir com o botão “INSTALAR”.

Apache tomcat e CMDBuild serão instalados, também o banco de dados selecionado será carregado:
Assim que a instalação for concluída, um pop-up nos perguntará se queremos iniciar o aplicativo
ou não:

Ao escolher sim, o Apache Tomcat será carregado e o instalador nos notificará assim que o aplicativo
está pronto para ser usado:

3.4. Instalação manual do CMDBuild (Linux e Windows)

Se ao invés da instalação gráfica quisermos instalar e configurar manualmente o CMDBuild, deve-se seguir um
procedimento diferente. Em primeiro lugar, o Apache Tomcat (e todos os softwares necessários listados anteriormente)
devem ser instalados manualmente (consulte o capítulo acima para obter links de download e versões suportadas). Depois
que o Tomcat for instalado com sucesso, podemos prosseguir com a instalação manual.
Observação: se você estiver instalando o OpenMAINT, deverá substituir as referências a "cmdbuild" por "openmaint".
O arquivo baixado (cmdbuild-3.4.war) contém os arquivos do aplicativo da web que podem ser extraídos na pasta de
instalação do tomcat em /webapps/cmdbuild .
Isso nos fornecerá uma instalação funcional do CMDBuild, mas nenhum banco de dados foi criado ainda.
Para configurar o banco de dados, podemos usar o assistente de configuração do banco de dados fornecido após a
primeira inicialização do tomcat ou podemos prosseguir com uma configuração manual via linha de comando.
3.5. Configuração do banco de dados CMDBuild via Db Config Wizard

(Linux e Windows)
Como no CMDBuild versão 2.5 ou anterior, um assistente para executar a configuração do banco de dados foi fornecido
para novas instalações do CMDBuild.
Após configurar e iniciar uma instância do tomcat com o webapp cmdbuild, ao acessar o aplicativo via navegador seremos
redirecionados para a página de configuração do banco de dados:
Neste formulário podemos configurar o banco de dados com os seguintes campos:
• Tipo: a base de dados que queremos configurar, seja uma das fornecidas (demo, vazia), existente ou de um arquivo

• Nome: o nome usado pelo postgres •

Host: host do postgres
• Porta: porta postgres
• Nome de usuário: nome de usuário postgres padrão (cmdbuild
sugerido) • Senha: senha postgres padrão (cmdbuild sugerido) • Nome
de usuário do administrador: nome de usuário postgres do administrador (postgres
sugerido) • Senha do administrador: senha postgres do administrador (postgres sugerido)
Depois de compilados todos os campos, sugere-se usar o "Testar conexão com o banco de dados" para verificar
a validade da configuração, se nenhum erro for exibido, podemos prosseguir pressionando o botão configurar.
Após uma configuração bem-sucedida, pode ser exibida uma lista de patches que devem ser aplicados ao banco
de dados carregado, pressionando "Aplicar patches" o sistema prosseguirá com o aplicativo.
Assim que a página de login for exibida, o sistema estará pronto para ser usado.
3.6. Configuração manual do banco de dados CMDBuild para Windows Se o sistema

operacional em uso for Windows, a importação do banco de dados deve ser feita manualmente via software
como pgAdmin ou via linha de comando postgres, o arquivo dump para o banco de dados é fornecido em WEB-
INF/ sql/dump localizado na pasta webapp. Se você deseja carregar um dump que inclui recursos gis/postgis,
consulte a documentação do postgis para qualquer problema relacionado à configuração do postgis e/ou
atualização/migração da versão do postgis.
Exemplo de instalação do postgis com postgres 12 e postgis 3.x para Windows 10: -Faça o
download e instale o postgres 12 do site oficial http://postgresql.org/download/windows
-Faça o download e instale o postgis para postgres 12 do repositório online oficial: http://download.osgeo.org/
postgis/windows/pg12 Conecte-se ao banco de dados postgres
usando um software como pgadmin 4. Como o usuário administrador padrão, crie um novo usuário chamado cmdbuild com senha.
Em seguida, crie um banco de dados para o usuário cmdbuild, agora você pode se reconectar a esse banco de dados
como usuário cmdbuild e criar um esquema gis: create schema gis;
Ceate a extensão postgis (nota: você pode ter que conceder permissões de superusuário ao usuário cmdbuild para este comando;
você deve revogar a permissão de superusuário depois): criar extensão postgis schema
gis;
Agora você pode prosseguir com a importação de um banco de dados. Podemos usar, por exemplo, um dos
dumps fornecidos com a instalação do CMDBuild.
Usando pgadmin como usuário cmdbuild, podemos realizar uma restauração com cmdbuild como banco de
dados de destino, a importação irá gerar vários avisos que podem ser ignorados, esses são causados por
algumas informações duplicadas no arquivo dump e no banco de dados existente (função gis e tipos ).
Após a conclusão do processo, o aplicativo pode ser executado iniciando o tomcat com o arquivo de inicialização,
lembre-se de que, se a porta ou qualquer configuração do tomcat precisar ser alterada, isso pode ser feito
modificando o arquivo de configuração do tomcat chamado server.xml na pasta < tomcat_install_folder>/conf.

3.7. Configuração manual do banco de dados CMDBuild para Linux Para

os sistemas linux o comando que será utilizado é o dbconfig, e pode ser chamado utilizando o
arquivo cmdbuild.sh na pasta webapp. Este comando pode realizar a criação de um novo banco de
dados baseado em um dump, e outras funções descritas nas demais documentações.
Neste ponto, o banco de dados de demonstração fornecido com o arquivo de guerra do CMDBuild pode ser importado.
Para fazer isso, você pode usar o comando dbconfig como no seguinte:
bash webapps/cmdbuild/cmdbuild.sh dbconfig create demo -configfile /path/to/configfile O CMDBuild agora
configurará um novo banco de dados com o nome fornecido na configuração e carregará o despejo de demonstração
fornecido no arquivo war.

Manual técnico 4. Atualização da versão do CMDBuild
4. Atualização da versão do CMDBuild
4.1. Atualização do CMDBuild

Para atualizar o CMDBuild para uma versão mais recente, siga este procedimento:
• Desligue a execução do tomcat e faça backup de todas as informações necessárias (ou seja, o banco de dados)
• Salve qualquer configuração necessária da pasta de configuração: <tomcat_installation_folder>/

webapps/<webapp_name>/WEB-INF/conf
• Exclua o diretório de seu aplicativo da web CMDBuild ( <tomcat_installation_folder>/webapps/ em gato

<webapp_name> )
• Descompacte o arquivo war da versão mais recente do CMDBuild na mesma pasta
• Limpe o cache do navegador para garantir que tudo esteja atualizado
Quando o aplicativo for iniciado novamente, na tela de login, um pop-up notificando que há um novo
versão instalada aparecerá.
Para restaurar as configurações salvas anteriormente, o tomcat deve ser desligado novamente e o antigo
as configurações devem ser movidas para a pasta de configuração.

Manual técnico 5. Configuração para acessar um DMS através do CMIS
5. Configuração para acessar um DMS através do CMIS

5.1. Introdução
O CMDBuild permite a integração com qualquer sistema de gestão documental que suporte CMIS, um padrão aberto para troca de
dados documentais através do protocolo web, suportado por todos os principais produtos do setor.
A aceitação de tal protocolo permite suportar recursos básicos para:
• Anexe qualquer tipo de arquivo a qualquer cartão de
dados • Atribua uma categoria a cada arquivo
• Exiba os arquivos carregados
O gerenciamento de categorias e metadados no momento é suportado apenas pelo protocolo CMIS 1.1, mas o CMDBuild suporta
até DMS baseado no CMIS 1.0. No caso da necessidade de categorias e metadados, um DMS baseado no CMIS 1.1 deve ser
usado.
5.2. Configuração do gerenciamento de categorias Nesta

seção você aprenderá como configurar um DMS que suporte o protocolo CMIS 1.1, para gerenciar
a classificação de anexos ao atualizá-los e atualizá-los nos cartões CMDBuild.
Aqui está um exemplo de configuração para Alfresco 5.0.
Observe que os nomes usados aqui são desvinculados.
Para configurar algumas categorias personalizadas com alfresco, dois arquivos devem ser criados e salvos na pasta alfresco:
${ALFRESCO_HOME}/tomcat/shared/classes/alfresco/extension
1) cmdbuild-model-context.xml
<?xml version='1.0' encoding='UTF-8'?>

<!DOCTYPE beans PUBLIC 'http://www.springframework.org/dtd/ '-// PRIMAVERA // DTD FEIJÃO//PT'
spring-beans.dtd'>
<feijão>

<bean id="example.dictionaryBootstrap" parent="dictionaryModelBootstrap" depende

on="dictionaryBootstrap">
<nome da propriedade="modelos">
<lista>
<value>alfresco/extension/cmdbuild-model.xml</value>
</lista>
</propriedade>
</bean>
</beans>

2) cmdbuild-model.xml
<?xml versão="1.0" codificação="UTF-8"?>



<model name="cmdbuild:module" xmlns="http://www.alfresco.org/model/dictionary/1.0">

<description>Modelo personalizado para CMDBuild</description>

<autor>Equipe do CMDBuild</autor>
<versão>1.0</versão>

<importações>

<import uri="http://www.alfresco.org/model/dictionary/1.0" prefix="d"/>  <import
uri="http:// www.alfresco.org/model/content/1.0" prefix="cm"/>
</imports>


<namespaces>
<namespace uri="org.cmdbuild.dms.alfresco" prefix="cmdbuild"/>
</namespaces>
<aspectos>

<aspect name="cmdbuild:classificável">
<title>Classificação</title>
<propriedades>
<property name="cmdbuild:classification">
<type>d:texto</type>
</propriedade>
</propriedades>
</aspect>
</aspectos>
</modelo>

5.3. Configuração do DMS no CMDBuild

Através de comandos REST as configurações do DMS no CMDBuild podem ser alteradas, seja via
comando editconfig rest para abrir uma interface mostrando todas as configurações disponíveis (se o CMDBuild estiver ativado
a máquina local) ou via comando setconfig/setconfigs rest, no exemplo:
cmdbuild.sh restws setconfig org.cmdbuild.dms.enabled true
Configurações gerais:
configuração Tipo Descrição
org.cmdbuild.dms.enabled boleano Ativa ou desativa o serviço DMS
org.cmdbuild.dms.service.type Corda Tipo de serviço DMS (cmis, postgres,

sharepoint_online); cmis é um protocolo padrão
usado, por exemplo, por Alfresco dms; postgres é
uma implementação dms incorporada que depende
sobre cmdbuild postgres db
org.cmdbuild.dms.category.lookup Corda Define a categoria DMS de pesquisa base
org.cmdbuild.dms.regularAttachments.ma Int Tamanho máximo de arquivo permitido, expresso em MB

xFileSize
org.cmdbuild.dms.incomingEmailAttachm List<String> Extensões de arquivo permitidas, minúsculas, para entrada

ents.allowedFileExtensions e-mail (anexos rejeitados serão ignorados e
imprimir um aviso, sem afetar o e-mail
em processamento)
org.cmdbuild.dms.autolink.path Corda Caminho base do link automático (substitui a base do provedor dms
caminho, para links)
org.cmdbuild.dms.autolink.script Corda Script auxiliar de link automático
Configurações relacionadas ao CMIS:
org.cmdbuild.dms.service.cmis.user Corda Nome de usuário do serviço CMIS
org.cmdbuild.dms.service.cmis.password Corda Senha do serviço CMIS
org.cmdbuild.dms.service.cmis.path Corda caminho de serviço CMIS
org.cmdbuild.dms.service.cmis.url Corda URL do serviço CMIS
Configurações relacionadas ao Sharepoint:
org.cmdbuild.dms.service.sharepoint.user String nome de usuário do serviço Sharepoint
org.cmdbuild.dms.service.sharepoint.password String Senha do serviço Sharepoint
org.cmdbuild.dms.service.sharepoint.url String URL do serviço Sharepoint
org.cmdbuild.dms.service.sharepoint.path String Caminho do serviço do Sharepoint

org.cmdbuild.dms.service.sharepoint.graphApi. url String URL do serviço da API do gráfico do Sharepoint
org.cmdbuild.dms.service.sharepoint.auth.servi ceUrl String URL do serviço de autenticação do Sharepoint
org.cmdbuild.dms.service.sharepoint.auth.clien String Id do cliente de autenticação do Sharepoint tId
org.cmdbuild.dms.service.sharepoint.auth.client tSecret String Segredo do cliente de autenticação do Sharepoint
org.cmdbuild.dms.service.sharepoint.auth.prot ocol String Protocolo de autenticação do Sharepoint
org.cmdbuild.dms.service.sharepoint.auth.reso urceId String Id do recurso de autenticação do Sharepoint
org.cmdbuild.dms.service.sharepoint.auth.tena ntId String ID do locatário de autenticação do Sharepoint
org.cmdbuild.dms.service.sharepoint.model.aut String Coluna de mapeamento do autor do modelo Sharepoint horColumn
org.cmdbuild.dms.service.sharepoint.model.cat String Coluna de mapeamento de categoria de modelo de Sharepoint egoryColumn
org.cmdbuild.dms.service.sharepoint.model.de String Coluna de mapeamento de descrição do modelo Sharepoint

scriptionColumn

Manual técnico 6. Backup dos dados do CMDBuild
6. Backup dos dados do CMDBuild

6.1. Backup do banco de dados No
CMDBuild todas as informações são armazenadas no Banco de Dados PostgreSQL, portanto para realizar um backup
das informações é necessário fazer backup do banco de dados.
Várias formas podem realizar um backup do banco de dados, programas como o PgAdmin podem realizar
esta ação com o apoio de uma interface gráfica. Caso contrário, o PostgreSQL fornece uma função para
executar um backup do banco de dados.
No exemplo:
pg_dump --host localhost --port 5432 --username “postgres” --format custom -- detalhado --file /backup/cmdbuild/cmdbuild.backup
cmdbuild_db
Este comando criará um backup do banco de dados com o nome “cmdbuild.backup”. Este arquivo será o
backup do banco de dados “cmdbuild_db” no PostgreSQL instalado no localhost na porta 5432, realizando a
autenticação como usuário “postgres”, compactando o banco de dados com um formato personalizado e
notificando o usuário sobre o que o programa está executando ( com o parâmetro detalhado).
O local onde o arquivo de backup será salvo é /backup/cmdbuild.
6.2. Restauração do banco de dados
Um backup pode ser restaurado a qualquer momento com um procedimento simples.
O CMDBuild fornece diferentes funções para executar várias ações, como ações relacionadas ao banco de
dados.
Se o objetivo for restaurar um backup, este comando restaurará o backup salvo anteriormente descartando o
banco de dados atual e criando um novo: bash webapps/
cmdbuild/cmdbuild.sh dbconfig recreate /path/to/database/backup.backup

Manual técnico 7. Backup de dados ao ar livre
7. Backup de dados ao ar livre

Para fazer backup de dados no Alfresco, basta fazer backup do banco de dados PostgreSQL (daqui em diante
suponha que esteja no banco de dados PostgreSQL).
Quanto ao CMDBuild, o comando para fazer backup do banco de dados na linha de comando é o seguinte:
pg_dump --host localhost --port 5433 --username "postgres" --format custom --
verbose --file /backup/alfresco/alfresco.backup alfresco_db
Também é necessário backup - como arquivo zip ou tar.gz - também todo o diretório contendo o
repositório onde os arquivos são salvos (por exemplo: C:/alfresco/repository para sistemas Windows ou
/var/alfresco/repository para sistemas *nix).
#!/bin/sh
ALFRESCO_SERVICE="/etc/init.d/alfresco"
TT_PG_BACKUP="/usr/local/bin/tt_pg_backup.sh"
BACKUP_HOME="/backup"
ALFRESCO_BACKUP_HOME="${BACKUP_HOME}/alfresco"
BACKUP_LOG="/var/log/cmdbuild/crontab-backup.log 2>&1"
ALFRESCO_DATABASE="ao ar livre"
ALFRESCO_DATA="/var/lib/alfresco/data"
TIMESTAMP=`data +%Y%m%d%H%M%S`
ALFRESCO_DATA_BACKUP="alfresco-data-${TIMESTAMP}.tar.gz"
logger "Parando o serviço Alfresco"

parada ${ALFRESCO_SERVICE}
dormir 5
logger "Backup do banco de dados Alfresco"

${TT_PG_BACKUP} "${ALFRESCO_BACKUP_HOME}" "${ALFRESCO_DATABASE}" > ${BACKUP_LOG}
logger "Backup de dados Alfresco"

tar czf "${ALFRESCO_BACKUP_HOME}/${ALFRESCO_DATA_BACKUP}" ${ALFRESCO_DATA}
logger "Foi feito backup do banco de dados/dados do Alfresco."
logger "Iniciando o serviço Alfresco"
${ALFRESCO_SERVICE} início

Manual técnico 7. Backup de dados ao ar livre
7.1. Agendamento de backup

Para agendar um backup periódico de dados em sistemas Linux, sugerimos que você faça o seguinte:
1. crie um arquivo /etc/cron.d/backup
2. insira os comandos no arquivo de backup, com a sintaxe cron adequada.
Para uma limpeza mais eficiente, recomendamos que você crie vários scripts individuais, um para cada
sistema e chame-os neste arquivo em vez de escrever os comandos diretamente no próprio arquivo cron.
Um exemplo:
***
00 19 root /usr/local/bin/tt_pg_backup.sh /backup/cmdbuild cmdbuild
&>> /var/log/cmdbuild/backup/backup.log
10 19 * * 7 raiz /usr/local/bin/alfresco-backup.sh &>>
/var/log/cmdbuild/backup/backup.log

Manual técnico 8. Modos de autenticação
8. Modos de autenticação
8.1. Introdução
Graças às configurações adequadas do CMDBuild, o controle de autenticação pode ser delegado a
serviços externos.
Esta possibilidade diz respeito ao controle da conta (nome de usuário e senha). Perfis e
as permissões ainda serão gerenciadas dentro do grupo CMDBuild ao qual o usuário pertence.
Através de comandos REST as configurações da autenticação podem ser alteradas, seja via editconfig
comando rest para abrir um gui mostrando todas as configurações disponíveis (se o CMDBuild estiver no local
machine) ou via comando setconfig/setconfigs rest, no exemplo:
cmdbuild.sh restws setconfig org.cmdbuild.auth.case.insensitive true
8.2. Configuração do tipo de autenticação

O CMDBuild suporta os seguintes métodos de autenticação:
• Autenticação padrão
• Autenticação SSO CAS
• Autenticação SSO SAML
• Autenticação Oauth2
A autenticação padrão pode ser configurada para utilizar dois repositórios de usuários diferentes:
• Credenciais armazenadas no banco de dados
• Sistema LDAP
Além disso, existem os seguintes métodos de autenticação adicionais:

• Autenticação RSA
• Autenticação de cabeçalho
• Login personalizado (semelhante à autenticação de cabeçalho, mas com uma adição de script de controle)
Para configurar qual tipo ou tipos de autenticação usar, a partir da versão 3.4, é possível especificar diferentes módulos de
autenticação com o seguinte esquema de configuração
Tipo Descrição
Configurar org.cmdbuild.auth.modules Corda Lista de nomes de módulos de autenticação
org.cmdbuild.auth.modules.{ModuleName}.type Corda Tipo de autenticação para o especificado

{Nome do módulo}
org.cmdbuild.auth.modules.{ModuleName}.description String Descrição do módulo de autenticação, mostrada em auth

botão de login
org.cmdbuild.auth.modules.{ModuleName}.enabled Boolean Especifica se o módulo está habilitado ou não
org.cmdbuild.auth.modules.{ModuleName}.hidden Booleano Especifica se o módulo está oculto ou não, se

escondido é usado apenas de passagem
cm_login_module na solicitação

org.cmdbuild.auth.modules.{ModuleName}.... Corda Configurações adicionais para o especificado

{Nome do módulo}
org.cmdbuild.auth.modules.{ModuleName}.type pode ter os seguintes valores conforme especificado acima:

• Autenticação padrão
• Autenticação SSO CAS
• Autenticação SSO SAML
• Autenticação Oauth2
Configurações relacionadas ao CAS:
org.cmdbuild.auth.module.cas.server.url URL do serviço CAS de string
org.cmdbuild.auth.module.cas.login.page Página de login do URL do CAS de string
org.cmdbuild.auth.module.cas.service.param Parâmetro de serviço CAS de string
org.cmdbuild.auth.module.cas.ticket.param String Parâmetro de tíquete de serviço CAS
Configurações relacionadas a SAML:
org.cmdbuild.auth.module.saml.handlerScript Manipulador de resposta de autenticação SAML de string

roteiro
org.cmdbuild.auth.module.saml.idp.cert Cadeia de caracteres SAML certificado idp
org.cmdbuild.auth.module.saml.idp.id String SAML idp idp URL
org.cmdbuild.auth.module.saml.idp.login URL de login de idp de string SAML
org.cmdbuild.auth.module.saml.idp.logout URL de logout idp de string SAML
org.cmdbuild.auth.module.saml.logout.enabled Sinalização habilitada para logout de idp SAML booleano
org.cmdbuild.auth.module.saml.requireSignedAssertions Booleano SAML requer sinalizador de declaração assinado
org.cmdbuild.auth.module.saml.requireSignedMessages Booleano SAML requer sinalizador de mensagens assinadas
org.cmdbuild.auth.module.saml.signatureAlgorithm URL do algoritmo de assinatura SAML de string
org.cmdbuild.auth.module.saml.sp.baseUrl String URL base do provedor de serviços SAML
org.cmdbuild.auth.module.saml.sp.cert String certificado base do provedor de serviços SAML
org.cmdbuild.auth.module.saml.sp.id String URL do ID do provedor de serviços SAML
org.cmdbuild.auth.module.saml.sp.key String chave privada do provedor de serviços SAML
org.cmdbuild.auth.module.saml.strict String de validação estrita do provedor de serviços SAML

bandeira

Configurações relacionadas ao Oauth:
org.cmdbuild.auth.module.oauth.clientId String ID do cliente OAuth
org.cmdbuild.auth.module.oauth.clientSecret String Segredo do cliente OAuth
org.cmdbuild.auth.module.oauth.login.attr Atributo de login OAuth de string a ser correspondido

usuários do cmdbuild
org.cmdbuild.auth.module.oauth.login.type Correspondência de tipo de login OAuth (nome de usuário ou

e-mail)
org.cmdbuild.auth.module.oauth.logout.enabled Booleano OAuth logout ativado sinalizador
org.cmdbuild.auth.module.oauth.logout.redirectUrl String URL de redirecionamento de logout OAuth
org.cmdbuild.auth.module.oauth.protocol Protocolo OAuth de cadeia de caracteres (ou seja, msazureoauth2)
org.cmdbuild.auth.module.oauth.redirectUrl String URL local OAuth aceita do provedor
org.cmdbuild.auth.module.oauth.resourceId String ID do recurso OAuth
org.cmdbuild.auth.module.oauth.scope Escopo OAuth da string
org.cmdbuild.auth.module.oauth.serviceUrl URL do serviço OAuth de string
org.cmdbuild.auth.module.oauth.tenantId String ID do locatário OAuth
Configurações relacionadas ao LDAP:
Tipo Descrição
Configuração org.cmdbuild.auth.ldap.server.address String URL do endereço do servidor LDAP
org.cmdbuild.auth.ldap.server.url String url do servidor LDAP (se definido, substituirá o servidor

configuração de host, porta e SSL); você pode especificar
vários urls separados por um espaço
org.cmdbuild.auth.ldap.server.port Porta do servidor LDAP inteira
org.cmdbuild.auth.ldap.basedn Cadeia de caracteres LDAP base dn para consulta do usuário
org.cmdbuild.auth.ldap.bind.attribute Atributo de vinculação do usuário LDAP de string
org.cmdbuild.auth.ldap.followReferrals Indicação de habilitação do acompanhamento de referências booleanas do LDAP
org.cmdbuild.auth.ldap.search.auth.method String Método de autenticação LDAP (nenhum, simples, forte)
org.cmdbuild.auth.ldap.search.auth.password String Senha de autenticação LDAP
org.cmdbuild.auth.ldap.search.auth.principal Entidade de autenticação LDAP da string
org.cmdbuild.auth.ldap.search.filter Filtro de pesquisa LDAP de sequência
org.cmdbuild.auth.ldap.use.ssl Sinalizador booleano de habilitação de ssl do LDAP
org.cmdbuild.auth.ldap.use.tls Sinalizador booleano de habilitação tls do LDAP


org.cmdbuild.auth.case.insensitive Sinalizador de login booleano que não diferencia maiúsculas de minúsculas
org.cmdbuild.auth.loginAttributeMode Corda Modo de atributo de login (nome de usuário, e-mail,

auto_detect_email)
org.cmdbuild.auth.loginServiceReturnSessionId Corda Retorna o ID da sessão no login (automático, sempre)
org.cmdbuild.auth.logoutRedirect URL de redirecionamento de logout de string
org.cmdbuild.auth.maxLoginAttempts.count Número máximo de tentativas de login
org.cmdbuild.auth.maxLoginAttempts.window Tempo inteiro em segundos entre as tentativas máximas de login
org.cmdbuild.auth.preferredPasswordAlgorythm String Algoritmo de criptografia de senha (legado,

cm3fácil, cm3)
org.cmdbuild.auth.users.expireInactiveAfterPeriod Iso 8601 Período de tempo para expiração de usuários inativos
8.3. Configurando a autenticação LDAP

Esta seção documenta como configurar a autenticação no CMDBuild via LDAP.
Para gerenciar as permissões de usuário dentro do CMDBuild é necessário que os usuários que
acesso ao CMDBuild eles também estão presentes no webapp.
Por exemplo, se um usuário com LDAP UID j.doe precisar acessar o CMDBuild como um usuário do
grupo "técnicos", você deve executar estas etapas:
• criação de usuário no j.doe CMDBuild com uma senha padrão (não necessariamente a do LDAP)
• criação do Grupo Técnico e definição das respectivas licenças
• adicionar usuário ao grupo j.doe Técnicos
Neste ponto, quando você autenticar j.doe, suas credenciais serão verificadas (usando o método de autenticação
cadeia definida em auth.methods) na árvore LDAP.
8.4. Configuração de logon único por meio do CAS

Esta seção documenta como configurar o logon único (SSO) no CMDBuild via CAS.
A autenticação é executada da seguinte forma:
• o usuário solicita a url do CMDBuild
• o autenticador CAS envia a solicitação para o servidor CAS (${cas.server.url} + $

{cas.login.page}) especificando o URL de acesso do CMDBuild (no ${cas.service.param}
parâmetro)
• o servidor CAS responde com um ticket (parâmetro ${cas.ticket.param}) que você pode extrair
o nome de usuário de
• se o nome de usuário for validado/extraído corretamente, o CMDBuild continua com o login
Para gerenciar as permissões de usuário dentro do CMDBuild é necessário que os usuários que
acesso ao CMDBuild eles também estão presentes no webapp.

Manual técnico 9. Ativação da interface móvel
9. Ativação da interface móvel
9.1. Introdução
O CMDBuild “mobile” é uma interface que pode ser utilizada em smartphones e tablets para rodar funcionalidades úteis do
aplicativo durante as atividades em campo.
Ele é criado com “Sencha Touch” (um framework Javascript desenvolvido pela Sencha, o mesmo produtor do framework Ext
JS usado pela interface de desktop do CMDBuild), e é capaz de interagir com o CMDBuild via webservice REST.
O CMDBuild mobile implementa os principais recursos da interface de desktop: multilíngue, login multigrupo, menus de
navegação, gerenciamento de classes, relações, anexos, …
9.2. Componentes e arquitetura O aplicativo

é criado com o uso dos seguintes componentes:
• Sencha Touch (framework Javascript criado por Sencha) • Cordova
(framework multiplataforma móvel) • Deft JS (extensão
empresarial móvel para aplicativos desenvolvidos com Sencha Touch) • log4javascript (framework de log
javascript) • Crosswalk (ferramenta para a implantação de
aplicativos em um visualização da web personalizada independente do

versão android)
• Siesta (biblioteca para uso de testes de unidade/integração)
Do lado do servidor, a camada de serviço web REST é desenvolvida usando o framework Apache CXF, que já está integrado
no CMDBuild, também usado para a camada de serviço web SOAP.
O sistema refaz a arquitetura de software do serviço web REST com os seguintes recursos:
• recursos divididos em recursos da web
• recursos endereçáveis (URI) • métodos
padrão HTTP (GET, POST, PUT, DELETE) • tipo de mídia JSON
• link para a navegação de recursos

• apátrida
9.3. Compatibilidade O
sistema móvel é compatível com:
• Android 4.0.3 ou mais recente
• IOS 6 ou mais recente

Manual técnico 9. Ativação da interface móvel
9.4. Limitação de uso

A interface móvel está disponível apenas com a licença de código não aberto, que permite apenas aqueles
que assinaram com a Tecnoteca srl um serviço de manutenção do aplicativo CMDBuild, e somente
até que a manutenção esteja ativa, com um custo adicional limitado.

Manual técnico 10. Ativação do GUI Framework
10. Ativação do GUI Framework
10.1. Introdução
O GUI Framework disponibiliza uma interface simplificada para o pessoal não técnico.
O GUI Framework inclui os seguintes recursos principais:
• pode ser ativado em portais baseados em diferentes tecnologias, pois é desenvolvido em

ambiente javascript/JQuery
• permite uma liberdade (quase) ilimitada na hora de projetar o layout gráfico, definido através
um descritor XML e com possibilidade de intervenção no CSS
• concede uma configuração rápida graças a funções predefinidas (comunicação,
lógicas de autenticação, etc.) e a soluções gráficas nativas (formulários, grids, botões de upload e
outros widgets)
• ele interage com o CMDBuild por meio do webservice REST
• é capaz de coletar dados do banco de dados de outros aplicativos, permitindo o gerenciamento
de soluções de mistura
10.2. Configuração
A estrutura define páginas HTML a partir de sua definição em XML.
Essas páginas podem ser inseridas em um arquivo HTML, permitindo que o framework seja inserido em portais existentes
pontos de acesso aos dados do CMDBuild.
A configurabilidade do sistema pode ser alcançada através da definição de CSS e Javascript personalizados.
O elemento que deve ser inserido no html do portal é um container html (DIV, IFRAME...) no
seguinte formato:
<script src="//ajax.googleapis.com/ajax/libs/jquery/2.1.1/jquery.min.js"></
roteiro>
<script type="text/javascript" src="http://10.0.0.107:8080/cmdbuild-gui framework/api/
cmdbuildAP.js"></script>
<tipo de script="texto/javascript">
$(documento).pronto(função(){
$("#cmdbuilForm").cmdbuildAP({
apiUrl: 'http://10.0.0.107:8080/cmdbuild/services/rest/',
appRootUrl:
'http://10.0.0.107:8080/cmdbuild-gui-framework/api/',
appConfigUrl: 'http://
10.0.0.107:8080/cbap/cbap/config/bologna/',
cqlUrl: 'http://10.0.0.107:8080/cbap/cbap/cql/',
customjs : [
'back-end/GUIForm.js',
'back-end/Process.js'
],
início: "home.xml",
tema: [
"jquery-ui.theme-crt-toscana.min.css",
"CSS customizado"
],

Manual técnico 10. Ativação do GUI Framework
}); });
</script> <div
id="cmdbuilForm"></div>
A configuração do estilo é designada ao CSS, que pode ser carregado diretamente da tag Html. Isso torna a GUI flexível,
permitindo que o programador a inclua no portal para que não pareça um elemento não relacionado.
Você também pode definir os servidores que contêm o sistema CMDBuild, os arquivos de configuração de formulário e o
mecanismo Cql, a linguagem nativa de consulta de dados no CMDBuild.
Na tag customjs são inseridos alguns arquivos de customização da GUI.
A tag carrega o mecanismo GUI configurando-o com os arquivos mencionados acima.
Os formulários são definidos em XML através de uma linguagem similar ao HTML, com possibilidade de definir formulários
de gerenciamento de dados diretamente vinculados aos metadados definidos no CMDBuild.
Todas as tags, comandos e comportamentos da GUI podem ser configurados novamente pelo programador de acordo com
os critérios do sistema.
Como a biblioteca se refere a JQuery, onde foi desenvolvido o GUI Framework, o programador pode utilizar nativamente
todos os plugins compatíveis com JQuery, desenvolvendo as funcionalidades disponíveis.
Outro elemento que marca o funcionamento da GUI é o mecanismo "backend", ou seja, as classes Javascript que ligam a
GUI aos servidores. Desta forma, o aplicativo oferece mais liberdade fornecida pela possibilidade de definir o formato de
dados que o servidor está esperando e o nome do servidor ao qual você deseja se conectar.

Manual técnico 11. Geoservidor
11. Geoservidor
11.1. Introdução ao GeoServer

O CMDBuild inclui a capacidade de gerir a georreferenciação de ativos ou de quaisquer outras entidades de informação
(como clientes, fornecedores, localizações, etc.) através da visualização em mapa e/ou plantas baixas.
A georreferenciação do território é feita através da integração de serviços externos como “OpenStreetMap”, Google maps,
entre outros, enquanto a gestão de planos foi implementada utilizando o sistema open source GeoServer.
Através do uso do GeoServer, você pode adicionar camadas personalizadas (por exemplo, planos) que você pode usar no
módulo GIS.
Os formatos suportados são Shape, GeoTiff e WorldImage
11.2. Instalando o Geo Server Para instalar o
Geo Server é necessário: • Baixar o aplicativo do site oficial
do GeoServer: http://geoserver.org/ • Instalar o arquivo war na pasta de instalação do Tomcat em webapp •
Entrar no GeoServer com nome de usuário admin e senha geoserver • Exclua qualquer
área de trabalho instalada anteriormente • Crie uma nova área de trabalho com um nome
arbitrário (ou seja, “cmdbuild”)
Para imprimir os mapas do CMDBuild, um plug-in adicional deve ser instalado, o plug-in pode ser baixado em https://
docs.geoserver.org/maintain/en/user/extensions/printing/index.html Para configurar o plugin o procedimento é o seguinte:
• Baixe a biblioteca geoserver-2.xx-printing-plugin.zip • Extraia o arquivo e
copie os arquivos jar na pasta geoserver webapp na pasta de instalação do tomcat ( <tomcat_installation_folder>/
webapps/geoserver/WEB-INF/lib/ )
• Depois de reiniciar o Tomcat, uma pasta de “impressão” será criada na pasta de dados sob o
aplicativo da web do geoservidor
• Adicione o arquivo chamado “config.yaml” na pasta de impressão, este arquivo pode ser
encontrado na pasta extras dentro do pacote cmdbuild.zip disponível no site www.cmdbuild.org
• Se qualquer informação adicional for necessária, consulte as informações oficiais de impressão
em: http://docs.geoserver.org/maintain/en/user/extensions/printing/configuration.html
11.3. Configurando o GeoServer no CMDBuild Após

efetuar login no CMDBuild e acessar o Módulo de Administração, o módulo GIS pode ser habilitado na
página relativa na seção Configuração do Sistema.
Para alterar a configuração do serviço GIS, várias guias são fornecidas para alterar as camadas do geoservidor e sua ordem.

Manual técnico 12. BIM
12. BIM
12.1. Introdução
O CMDBuild oferece a possibilidade de visualizar modelos BIM e conectar cartões e objetos bim.
Na versão anterior, o CMDBuild tornava isso possível com o uso do BIMServer, um serviço que armazenava e
fornecia diferentes APIs para visualizar dados BIM através de arquivos ifc.
A partir da versão 3.4 foi introduzido um novo visualizador BIM, o opensource Xeokit.
Mais informações nos capítulos seguintes.
12.2. Introdução ao BIMServer

O BIMServer é um software de código aberto feito para criar facilmente ferramentas relacionadas ao bim. Para usar
arquivos ifc no CMDBuild, o BIMServer deve estar instalado.
12.3. Instalação
O CMDBuild suporta a versão 1.5.138 do BIMServer, esta pode ser obtida no GitHub oficial do BIMServer no seguinte link:
https://github.com/opensourceBIM/BIMserver/releases .
Depois de obter o arquivo, podemos começar com o procedimento de instalação:
O servidor BIM é um aplicativo da web, você pode criar uma nova pasta chamada "bimserver" em sua instalação apache
tomcat local na pasta webapps.
Agora extraia o arquivo war na pasta recém-criada.
Você pode iniciar o tomcat e dar uma olhada nos logs no arquivo "catalina.out", onde será exibida a configuração inicial do
BIMServer.
Depois que o aplicativo estiver em execução, vá para o endereço http://localhost:8080/BIMServer/ em qualquer navegador
para acessar a página de configuração do BIMServer:
Deixe o endereço do site como está e escolha o nome e a descrição do servidor.

Depois de pressionar próximo, seremos obrigados a decidir o nome de usuário e a senha do administrador, digite sua
preferência uma vez, o nome de usuário deve ser um endereço de e-mail.
No próximo passo temos a possibilidade de configurar um e-mail, passo que não é obrigatório e não será feito aqui
Na próxima página será fornecida uma lista de plug-ins padrão, esses plug-ins serão instalados para uma configuração
ideal do BIMServer, clique em próximo.
Na última página, pressionando "Setup", a instalação e configuração completa do BIMServer será iniciada, tanto a página
quanto o log catalina.out nos informarão o estágio da instalação e quando ela estiver concluída.
Uma vez concluída a configuração, você pode atualizar a página para obter uma página de status do seu BIMServer:

Tudo o que você precisa fazer para concluir a configuração do serviço BIM é entrar no módulo de administração do CMDBuild e
habilitar os serviços BIM com as informações que você forneceu durante a configuração do BIMServer.
12.4. Introdução ao Xeokit

Xeokit é um SDK gráfico 3D de código aberto para BIM e AEC. Ele utiliza um formato de modelo binário que, comparado ao
equivalente ifc, é extremamente leve (falando em tamanho de arquivo, a proporção é de cerca de 10:1).
O visualizador xeokit foi introduzido dentro do código CMDBuild como uma alternativa ao BIMServer.
Um procedimento para migrar arquivos ifc para arquivos Xeokit xkt também foi incluído.
Caso haja a necessidade de migrar projetos bim para o novo formato de arquivo na lista de projetos bim na administração um
botão fará a conversão automática de ifc para xkt, e manterá armazenados no banco de dados tanto o arquivo ifc quanto o xkt.
Uma vez que todos os arquivos tenham sido migrados, o bimserver pode ser desativado.
Quando o visualizador xeokit estiver em uso, os usuários não verão nenhuma diferença no uso porque ainda carregarão o
arquivo ifc, o CMDBuild converterá internamente o arquivo ifc para xkt e manterá as duas versões dentro do banco de dados.

org.cmdbuild.bim.enabled Sinalizador de habilitação do serviço Booleano Bim
org.cmdbuild.bim.viewer Visualizador de serviço String Bim (bimserver ou xeokit)
org.cmdbuild.bim.conversiontimeout Tempo limite de conversão de número inteiro para arquivo ifcÿxkt

conversão
Configurações relacionadas ao Bimserver:
org.cmdbuild.bim.bimserver.enabled Sinalizador de habilitação do servidor Booleano Bim
org.cmdbuild.bim.bimserver.url URL do servidor String Bim
org.cmdbuild.bim.bimserver.username Nome de usuário do servidor String Bim
org.cmdbuild.bim.bimserver.password Senha do servidor String Bim

Manual técnico 13. Configuração do CMDBuild no modo cluster
13. Configuração do CMDBuild no modo cluster

13.1. Introdução ao cluster
O CMDBuild permite configurar uma arquitetura em modo Cluster, onde um balanceador de carga do servidor web é ativado.
Este balanceador distribui as requisições ao CMDBuild em diversas instâncias da aplicação (nós), conectadas através do
mesmo banco de dados PostgreSQL, que está configurado no modo de replicação Master-Slave.
O clustering de serviços permite atingir objetivos:
• Alta disponibilidade: se uma instância do CMDBuild parar de funcionar, outras instâncias podem manter o serviço
funcionando
• Escalabilidade: a disponibilidade de várias instâncias (nós) permite dividir a carga e assim atender mais
rapidamente as solicitações.
O esquema a seguir descreve a arquitetura do CMDBuild na configuração de Cluster:
No exemplo acima, o balanceador de carga foi feito pelo servidor web Apache.
Tanto o balanceador de carga quanto o banco de dados PostgreSQL podem ser redundantes por meio de diferentes técnicas,
que não são consideradas neste capítulo.

13.2. Configuração do cluster Neste

capítulo simularemos a criação de uma arquitetura CMDBuild no modo Cluster, composta por quatro
servidores: • Um
servidor com PostgreSQL como banco mestre • Um servidor
com uma instância do CMDBuild (nó 1) com endereço 10.0.0.100: 8080 • Um servidor com
uma instância do CMDBuild (nó 2) com endereço 10.0.0.101:8080 • Um servidor com Apache
como balanceador de carga
Abaixo, o caminho do webapp cmdbuild dentro dos servidores será identificado com $ {cmdbuild_home}.
A pasta que contém os arquivos de configuração ${cmdbuild_home}/ WEB-INF/ conf deve ser sincronizada
entre as várias instâncias do Tomcat: caso as instâncias do Tomcat estejam localizadas em servidores
diferentes, sugere-se carregar a pasta conf nas várias instâncias através NFS, para que você não precise
gerenciar o alinhamento de vários arquivos de configuração.
Assumindo que o CMDBuild foi instalado nos dois servidores seguindo o guia de instalação podemos agora
proceder com os seguintes passos:
Etapa
1: A configuração do cmdbuild de ambos os servidores deve ser alterada para informar ao aplicativo que
habilite o modo de cluster.
A variável clusterizada deve ser definida como verdadeira:
org.cmdbuild.cluster.enabled true
Isso pode ser feito via comando rest, editando a variável com um comando setconfig ou visualizando toda a
configuração com o comando editconfig.
Passo
2: Agora deve-se configurar o serviço que mantém a comunicação entre as diversas instâncias (JGroups).
A configuração da comunicação entre as instâncias descritas neste manual é baseada em uma pilha de
protocolos padrão. TCP é o protocolo de transmissão que ele usa.
A configuração descrita a seguir permite a descoberta entre instâncias que podem ser acessadas por meio de
um endereço IP ou nome de domínio e deve abranger a maioria dos tipos de instalação.
Se o objetivo é iniciar vários nós no mesmo host, a configuração da porta tcp deve ser alterada em um dos
nós com a seguinte configuração:
org.cmdbuild.cluster.node.tcp.port
Agora, a lista de nós deve ser definida por meio de:
org.cmdbuild.cluster.nodes = 10.0.0.101,10.0.0.102

13.3. Configurando o balanceador de carga no Apache Antes

de configurar o balanceador de carga, certifique-se de que todos os seguintes módulos do Apache
estejam funcionando:
• procurador
• proxy_http
• proxy_balancer
• lbmethod_byrequests
• cabeçalhos
Em seguida, o arquivo de configuração do módulo balanceador de carga deve ser modificado.
Também é necessário configurar o VirtualHost desejado ativando-o nos sites habilitados para configurar um domínio para
acessar o cluster.
13.4. Verifique se o cluster está funcionando Para verificar
se o clustering está funcionando conforme o esperado, você pode controlar o conteúdo da tabela:
quarz_scheduler_state
que deve estar presente no esquema quarz no banco de dados CMDBuild.
Se tudo estiver funcionando corretamente para cada node Tomcat configurado (no nosso caso Node1 e Node2) aparecerá
um registro na tabela e o valor da coluna last_checkin_time será atualizado em alguns segundos.
13.5. Aplicando patches no modo Cluster Se o

CMDBuild estiver configurado no modo Cluster e o aplicativo web precisar ser atualizado, o seguinte
procedimento deverá ser seguido:
• Depois de desligar o CMDBuild, atualize cada aplicativo da Web do CMDBuild
• Iniciar uma única instância
• Acesse a instância iniciada por meio do navegador e aplique quaisquer correções SQL
• Inicie as outras instâncias do cluster

Manual técnico 14. Apêndice: Glossário
14. Apêndice: Glossário
ANEXO
Um anexo é um arquivo associado a um cartão.
Para gerenciar os anexos, o CMDBuild utiliza em modo embarcado qualquer sistema de documentos compatível com o protocolo
padrão CMIS.
A gestão dos anexos suporta o versionamento daqueles arquivos que foram carregados algumas
vezes, com numeração automática.
Veja também: Cartão
ATIVIDADE
Atividade: etapa do fluxo de trabalho.
Uma atividade pode ser uma interação com o operador (interativo) ou um script que processa operações via API (automático).
Uma instância de processo é um único processo que foi ativado automaticamente pelo aplicativo ou manualmente por um operador.
Veja também: Processo
ATRIBUTO
O termo refere-se a um atributo de uma classe CMDBuild (por exemplo, na classe "fornecedor" os atributos podem ser: nome,
endereço, número de telefone, etc.).
O CMDBuild permite criar novos atributos (em classes e domínios) ou editar os existentes.
Na base de dados, cada atributo está relacionado com uma coluna da tabela que implementa a classe associada e corresponde,
no Módulo de Gestão de Dados, a um campo de entrada de dados do cartão específico para a gestão da classe.
Veja também: Classe, Domínio, Relatório, Superclasse, Tipo de Atributo
BIM
Método com o objetivo de apoiar todo o ciclo de vida de um edifício: desde a sua construção, utilização e manutenção, até à sua
demolição, se for o caso.
O método BIM (Building Information Modeling) é suportado por diversos programas de TI que podem interagir através de um
formato aberto para troca de dados, denominado IFC (Industry Foundation Classes).
O CMDBuild inclui um conector para sincronizar algumas informações do IC (registros técnicos ou de manutenção) e um
visualizador interativo para o modelo 3D do edifício representado pelo arquivo IFC.
Veja também: CI, GIS
CI
Definimos CI (Item de Configuração) cada item que presta um serviço a um usuário e possui nível de detalhamento suficiente para
seu gerenciamento técnico.
No CMDBuild, o termo é aplicado a um contexto genérico de Asset Management estendendo o conceito usualmente utilizado na
gestão de infraestrutura de TI.
Exemplos de IC incluem: servidor, estação de trabalho, software, planta, painel elétrico, extintor de incêndio, móveis, etc.
Veja também: Configuração, ITIL

AULA
Uma classe é um tipo de dados complexo com um conjunto de atributos que descrevem esse tipo de dados.
Uma Classe modela um objeto que deve ser gerenciado no CMDB, como uma empresa, um prédio, um ativo, um serviço etc.
O CMDBuild permite ao administrador - com o Módulo Schema - definir novas classes ou deletar/editar as já existentes.
Uma classe é representada na base de dados com uma tabela gerada automaticamente ao definir a classe e corresponde - no
Módulo de Gestão de Dados - a um cartão para consulta e atualização dos cartões previstos no modelo.
Veja também: Carta, Atributo
CMDB
A melhor prática ITIL (Information Technology Infrastructure Library), que se tornou um "padrão de fato" e um sistema não
proprietário para gerenciamento de serviços, introduziu o termo CMDB referido ao banco de dados de itens de configuração.
O CMDBuild estende o conceito de CMDB aplicando-o a um contexto genérico de gerenciamento de ativos.

Veja também: Banco de Dados, ITIL
CONFIGURAÇÃO
O processo de gerenciamento de configuração tem como objetivo manter atualizadas e disponíveis para os demais processos as
informações dos itens (Item de Configuração), suas relações e seu histórico.
Mesmo sendo conhecido como um dos principais processos dentro da ITIL Best Practice, o mesmo conceito é utilizado no CMDBuild
para contextos genéricos de Asset Management.
Veja também: CI, ITIL
PAINEL
No CMDBuild, um dashboard corresponde a uma página de aplicação que inclui uma ou mais representações gráficas diferentes,
desta forma pode-se ter imediatamente em evidência alguns parâmetros chave (KPI) relacionados com aspetos de gestão do
serviço de Gestão de Ativos.
Veja também: Relatório
BASE DE DADOS
O termo refere-se a uma coleção estruturada de informações, hospedadas em um servidor, bem como softwares utilitários que
manipulam essas informações para tarefas como inicialização, alocação, otimização, backup, etc.
O CMDBuild conta com o PostgreSQL, o banco de dados mais poderoso, confiável, profissional e de código aberto, e usa seus
recursos avançados e estrutura orientada a objetos.
A base de dados Asset Management, implementada com base na lógica e filosofia do CMDBuild, também é indicada como CMDB
(Configuration Management Data Base).
DOMÍNIO
Um domínio é uma relação entre duas classes.
Um domínio tem um nome, duas descrições (direta e inversa), códigos de classes, cardinalidade e atributos.
O administrador do sistema, através do Módulo de Administração, pode definir novos domínios ou deletar/editar os existentes.
É possível definir atributos customizados para cada domínio.

Veja também: Classe, Relação
FILTRO DE DADOS
Um filtro de dados é uma restrição da lista dos elementos contidos em uma classe, obtida pela especificação de condições booleanas
(igual, diferente, contém, começa com, etc.) sobre os valores possíveis que podem ser aceitos por cada atributo de classe.
Os filtros de dados podem ser definidos e usados excepcionalmente, caso contrário, podem ser armazenados pelo operador e depois
recuperados ou configurados pelo Administrador e disponibilizados pelos operadores.
Consulte também: Classe, Visualização
SIG
Um SIG é um sistema capaz de produzir, gerenciar e analisar dados espaciais associando elementos geográficos a uma ou mais
descrições alfanuméricas.
As funcionalidades GIS no CMDBuild permitem criar atributos geométricos (além dos atributos padrão) que representam, em plantas/
mapas, posição de marcadores (ativos), polilinhas (linhas de transmissão) e polígonos (pisos, salas, etc.).
Veja também: BIM
QUADRO DE GUI
É uma estrutura fornecida pelo CMDBuild para simplificar a implementação de interfaces de usuário personalizadas externas e para
conceder acesso simplificado a não técnicos. Eles podem ser emitidos em qualquer portal da Web e podem ser usados com o CMDBuild
por meio do serviço da Web REST padrão.
O CMDBuild GUI Framework é baseado em bibliotecas javascript JQuery.
Veja também: Mobile, Webservice
ITIL
É um sistema de "melhores práticas" que estabeleceu um "padrão de fato"; é um sistema não proprietário para gerenciamento de
serviços de TI, seguindo um esquema orientado a processos (Information Technology Infrastructure Library).
Os processos ITIL incluem: Suporte a Serviços, Gerenciamento de Mudanças e Gerenciamento de Configuração.
Para cada processo, o ITIL trata da descrição, componentes básicos, critérios e ferramentas para gestão da qualidade, papéis e
responsabilidades dos recursos envolvidos, pontos de integração com outros processos (para evitar duplicidades e ineficiências).
O CMDBuild usa alguns conceitos ITIL e os aplica a um contexto genérico de Asset Management.
Veja também: Configuração
OLHO PARA CIMA
O termo "Lookup" refere-se a um par de valores (Código, Descrição) definidos pelo administrador no Módulo de Administração.
Esses valores são usados para vincular a escolha do usuário (no momento do preenchimento do formulário) a um dos valores predefinidos
(também chamados de múltipla escolha ou lista de opções).
Com o Módulo de Administração é possível definir novas tabelas "LookUp" de acordo com as necessidades da organização.
Veja também: Tipo de atributo
MÓVEL

É uma interface de usuário para ferramentas móveis (smartphones e tablets).

É implementado como aplicativo multiplataforma (iOS, Android) e pode ser usado com o CMDB por meio do webservice REST.
Veja também: Webservice
PROCESSO
O termo processo (ou fluxo de trabalho) refere-se a uma sequência de etapas que realizam uma ação.
Para cada processo (tipo de processo) uma nova instância de processo será iniciada quando os usuários tiverem que realizar uma ação
nos ativos de acordo com um procedimento implementado como fluxo de trabalho.
Um processo é ativado ao iniciar um novo processo (preenchimento do formulário relacionado) e termina quando a última etapa do fluxo
de trabalho é executada.
Os fluxos de trabalho gerenciados no CMDBuild são descritos na linguagem de marcação padrão XPDL (XML Process Definition
Language), regida pelo WFMC (WorkFlow Management Coalition).
Vide também: Etapa do fluxo de trabalho
RELAÇÃO
Uma relação é um link entre dois cartões CMDBuild ou, em outras palavras, uma instância de um determinado domínio.
Uma relação é definida por um par de identificadores únicos de cartão, um domínio e atributos (se houver).
O CMDBuild permite que os usuários, através do Módulo de Gerenciamento, definam novas relações entre os cartões armazenados no
CMDB.
Veja também: Classe, Domínio
RELATÓRIO
O termo refere-se a um documento (PDF ou CSV) contendo informações extraídas de uma ou mais classes e domínios relacionados.
Os relatórios podem ser configurados no Módulo de Administração importando em formato XML a descrição do layout desenhado com
o editor visual JasperReports. Eles podem ser fornecidos aos operadores no menu do aplicativo.
Os usuários do CMDBuild podem imprimir relatórios através do Módulo de Gerenciamento, que resultarão em impressos, gráficos,
documentos, etiquetas, etc.
Veja também: Classe, Domínio, Banco de Dados
CARTÕES
O termo "cartão" refere-se a um elemento armazenado em uma classe (correspondente ao registro de uma tabela no banco de dados).
Um cartão é definido por um conjunto de valores, ou seja, os atributos definidos para sua classe.
Os usuários do CMDBuild, através do Módulo de Gerenciamento, podem armazenar novos cartões e atualizar/excluir os existentes.
As informações do cartão são armazenadas no banco de dados e, mais exatamente, na tabela/colunas criadas para aquela classe
(Módulo de Administração).
Veja também: Classe, Atributo
SUPERCLASSE
Uma superclasse é uma classe abstrata usada como modelo para definir atributos compartilhados entre subclasses.
Da classe abstrata, ou de hierarquias de classes abstratas, pode-se derivar classes reais que contenham dados e incluam tanto atributos
compartilhados (especificados na superclasse) quanto atributos específicos de subclasses, além das relações nos domínios da
superclasse e em domínios específicos.

Por exemplo, você pode definir a superclasse "Empresa" com alguns atributos básicos (número de IVA, razão social, número
de telefone, etc.) e as subclasses derivadas "Clientes" e "Fornecedores", cada uma com atributos genéricos da superclasse e
seus próprios atributos e relações.
Veja também: Classe, Atributo
INQUILINO
Um "inquilino", no CMDBuild, é uma parte do CMDB reservada a usuários pertencentes a uma suborganização da instância do
CMDBuild (uma Sociedade de Grupo, uma Sede, uma Divisão, etc.).
Trabalhando em modo "multitenant", cada usuário trabalha apenas com dados de sua suborganização e, no caso, com dados
comuns: "tenants".
A lista de inquilinos utilizáveis pode ser definida a partir de uma classe aplicável de CMDBuild (postos, empresas,
clientes, etc.) ou de uma função personalizada de banco de dados, onde você pode implementar regras de visibilidade
complexas.
TIPO DE ATRIBUTO
Cada atributo tem um tipo de dados que representa informações e gerenciamento de atributo.
O tipo de atributo e seus modos de gerenciamento são definidos no Módulo de Administração.
O CMDBuild gerencia os seguintes tipos de atributo: “Boolean”, “Date”, “Decimal”, “Double”, “Inet” (endereço IP),
“Integer”, “LookUp” (listas definidas em "Settings" / "LookUp") , “Referência” (chave estrangeira), “String”, “Texto”,
“TimeStamp”.
Veja também: Atributo
VISUALIZAR
Uma exibição inclui cartões definidos com critérios lógicos de filtros aplicados a uma ou mais classes CMDB.
Em particular, uma exibição pode ser definida no CMDBuild aplicando um filtro a uma classe (para que contenha um conjunto
reduzido das mesmas linhas) ou especificando uma função SQL que extrai atributos de uma ou mais classes relacionadas.
O primeiro tipo de visualização mantém todas as funcionalidades disponíveis para uma aula, o segundo permite a visualização
e busca única com filtro rápido.
Veja também: Classe, Filtro
SERVIÇO DE INTERNET
Um webservice é uma interface que descreve uma coleção de métodos, disponível em uma rede e trabalhando com mensagens
XML.
Com webservices, uma aplicação permite que outras informações e aplicações interajam com seus métodos.
O CMDBuild inclui um SOAP e um webservice REST, que são fornecidos a aplicativos externos para ler ou gravar dados no
CMDB ou processar operações.
FERRAMENTA
Um widget é um componente de uma GUI que melhora a interação do usuário com o aplicativo.
O CMDBuild utiliza widgets (apresentados como "botões") que podem ser colocados em cartões ou processos. Os botões
abrem janelas pop-up que permitem consultar ou inserir dados ou processar outras operações.
O CMDBuild inclui alguns widgets padrões para processar as operações mais comuns, mas também fornece as especificações
para implementar outros widgets personalizados.

Manual Técnico

Enviado por

Dados do documento

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

Manual Técnico

Enviado por

Direitos autorais:

Formatos disponíveis

Machine Translated by Google

" Manual técnico

O CMDBuild ® usa muitas tecnologias excelentes da comunidade de código aberto:

CMDBuild ® é um produto da Tecnoteca Srl que é

O CMDBuild ® é lançado sob a licença de código aberto AGPL (http://www.gnu.org/licenses/agpl-3.0.html)

CMDBuild ® é uma marca registrada da Tecnoteca Srl.

O site oficial é http://www.cmdbuild.org

CMDBuild – Configuração de código aberto e banco de dados de gerenciamento Página 2

sistema.............................. ................................................ .............................8 2.1. Requisitos de

3. Instalando o CMDBuild.......................................... ................................................ ...................11 3.1.

4. Atualização da versão do CMDBuild............................. ................................................ ...........19 4.1. Atualização do

5. Configuração para acessar um DMS através do CMIS............................... ................................20 5.1.

6. Backup dos dados do CMDBuild........................................... ................................................ ...........24 6.1. Backup do banco de

7. Backup de dados Alfresco............................... ................................................ ..........25 7.1. Agendamento de

8. Modos de autenticação........................................... ................................................ ................27

9. Ativação da interface móvel.............................. ................................................ ..........31

10. Ativação do GUI Framework.............................. ................................................ ........33

11. Geoservidor.............................................. ................................................ .............................35

CMDBuild – Configuração de código aberto e banco de dados de gerenciamento Página 3

11.3. Configurando o GeoServer no CMDBuild.......................................... ................................................35

12. BIM............................................. ................................................ .........................................36

13. Configuração do CMDBuild no modo cluster............................... ......................................40 13.1. Introdução ao

14. Apêndice: Glossário............................................. ................................................ ................43

CMDBuild – Configuração de código aberto e banco de dados de gerenciamento Página 4

Manual técnico 1. Introdução

1.1. O aplicativo CMDBuild

Um gerenciador de tarefas incluído na interface do usuário do Módulo de Administração permite agendar

CMDBuild – Configuração de código aberto e banco de dados de gerenciamento Página 5

Manual técnico 1. Introdução

1.2. Website oficial

1.3. Módulos CMDBuild

1.4. manuais disponíveis

Você pode encontrar todos os manuais no site oficial (http://www.cmdbuild.org):

1.5. Aplicações baseadas no CMDBuild A Tecnoteca utilizou

o ambiente CMDBuild para implementar duas diferentes soluções pré-configuradas:

CMDBuild – Configuração de código aberto e banco de dados de gerenciamento Página 6

Manual técnico 1. Introdução

CMDBuild – Configuração de código aberto e banco de dados de gerenciamento página 7

Manual técnico 2. Configuração do sistema

2.1. Requisitos de hardware Para a

• CPU de última geração • um

• o armazenamento em disco deve estar em configuração

2.2. Requisitos de software A instalação e

O PostgreSQL da versão 10 à versão 12 (versão recomendada) é necessário.

CMDBuild – Configuração de código aberto e banco de dados de gerenciamento página 8

Manual técnico 2. Configuração do sistema

as subclasses e para gerenciar o histórico de cartões.

Contêiner Servlet / Servidor Web

Sistema de Gestão de Documentos (DMS)

As bibliotecas Java são exigidas pelo Apache Tomcat.

Bibliotecas incluídas no lançamento

• as bibliotecas ExtJS para a geração da interface de usuário Ajax (http://extjs.com/) • os

CMDBuild – Configuração de código aberto e banco de dados de gerenciamento página 9

Manual técnico 2. Configuração do sistema

2.3. Requisitos do cliente

CMDBuild – Configuração de código aberto e banco de dados de gerenciamento página 10

Manual técnico 3. Instalando o CMDBuild

3.2. Instalação do CMDBuild

Um arquivo .war é fornecido para prosseguir com a instalação gráfica ou manual.

3.3. Instalação do CMDBuild via GUI (Windows e Linux)

CMDBuild – Configuração de código aberto e banco de dados de gerenciamento página 11

Manual técnico 3. Instalando o CMDBuild

CMDBuild – Configuração de código aberto e banco de dados de gerenciamento Página 12

Manual técnico 3. Instalando o CMDBuild