README.md
Gerenciador de templates - Interface web de utilização do templates-broker
O Gerenciador de Templates é o sistema responsável por gerenciar os modelos de documentos que são ofertados pelo templates-broker, ele serve como uma espécie de IDE para edição dos modelos. O propósito do sistema é permitir que os usuários possam interagir diretamente com os modelos de documentos.
Requisitos
- Código-fonte do Gerenciador de Templates pode ser baixado a partir do link https://softwarepublico.gov.br/gitlab/ans/gerenciador-de-templates/tags
- Apache Maven para baixar as dependências e compilar o pacote.
- Servidor JBoss EAP 7.0.4 ou Wildfly 10.
- Templates-broker implantado e configurado.
- Conexão com a internet para que o Maven acesse os repositórios hospedeiros das dependências.
Procedimentos para instalação
Criar e configurar os arquivos de propriedades no JBoss
O Gerenciador de Templates faz uso de dois arquivos de propriedades que ficam na pasta <JBOSS_HOME>\ans\properties, os arquivos necessários são services.properties e ws-users.properties. Abaixo as propriedades que se fazem necessárias nestes arquivos.
Arquivo Propriedade Descrição services.properties templates.broker.uri URL do templates-broker ws-users.properties templates.web.user Usuário utilizado para se autenticar no broker templates.web.password Senha do usuário utilizado para se autenticar no broker
Criar security-domain no JBoss
É necessário que haja um security-domain registrado com o nome ans-form-auth, o mesmo pode utilizar um banco de dados<sup>1</sup> ou o LDAP. É importante destacar que o sistema trabalha com autorização baseada em papéis(RBAC<sup>2</sup>) e que os usuários precisam ter seus papéis atribuídos. No caso do Gerenciador de Templates os usuários precisam ter o papel usuario_interno, essa configuração pode ser alterada no web.xml.
Implantar pacote gerado pelo Maven
Após a realização de todos os passos anteriores, teremos o JBoss pronto para receber o pacote do Gerenciador de Templates. O deploy pode ser feito de diversas maneiras e não é o foco desse manual.
Para essa etapa é necessário ter o Maven instalado e configurado. Ao realizar o primeiro build devemos desabilitar os testes automatizados, os testes dependem de uma instância ativa e impedirão a geração do pacote.