LUMEWare 1.0 MANAUS 2009

LUMEWare 1.0 MANAUS 2009

Sumário Manual do Sistema...1 1 Apresentação...2 1.1 Breve Descrição...2 1.2 Características...2 2 Propósito do Documento...3 2.1 Introdução...3 3 Implantação...4 3.1 Banco de Dados MySQL 5.x...4 3.2 Servidor de Aplicação APACHE 2.x...8 3.3 PHP 5.2.x...8 3.4 Sistema LUMEWARE...9 4 WebServices... 11 4.1 AutenticaUsuário... 11 4.2 UsuariosDadosAlterados... 11 4.3 CursosDisponiveis... 11 4.4 UsuarioCursoInscrever... 11 5 Modelo Entidade Relacionamento... 12 6 Dicionário de Dados... 13

1 Apresentação 1.1 Breve Descrição O LUMEWare: * Alinha as inscrições dos colaboradores aos interesses da Organização * Permite gerenciar o espaço físico (salas) em função das reservas (inscrições) * Permite agendar as reservas de tal forma que não existam overlaps entre trabalhar e treinar * Permite à área de treinamento uma gestão complementar na capacitação dos colaboradores. 1.2 Características O LUMEWare foi desenvolvido utilizando as seguintes tecnologias: Linguagem de programação: PHP 5.2.X (www.php.net/downloads.php) JavaScript Ajax biblioteca prototype (www.prototypejs.org) CSS. Sistema de Gerenciamento de Banco de Dados: MySQL 5.X (www.mysql.com) MySQL Query Browser (www.mysql.com) MySQL Administrator. (www.mysql.com) Ferramenta para execução das Stored Procedures de Integração: SQL Query Analyzer Servidor de Aplicação: Apache 2.X (www.apache.org/dist/httpd/binaries) IDE: NetBeans 6.7.1 (www.netbeans.org) LUMEWARE 2

2 Propósito do Documento 2.1 Introdução Este documento compreende as informações referentes à implantação do LUMEWARE. Este documento será utilizado como base para as atividades de implantação, documentando as atividades realizadas, a fim de garantir o mínimo em configuração para implantação do sistema. As configurações aqui apresentadas foram realizadas em ambiente Windows XP Professional, localmente. LUMEWARE 3

3 Implantação Esta seção compreende os passos necessários para instalação e configuração do sistema. 3.1 Banco de Dados MySQL 5.x O SGBD utilizado neste tutorial será o MySQL, após instalação será necessário executar os seguintes scripts: 01_CREATE_DATABASE.sql CREATE DATABASE lumeware USE lumeware 02_DEFINIR_PERMISSOES.sql GRANT ALL ON lumeware.* TO 'usuariolumeware'@'localhost' IDENTIFIED BY 'lumeware' 03_CREATE_TABELAS.sql CREATE DATABASE IF NOT EXISTS lumeware USE lumeware DROP TABLE IF EXISTS curso DROP TABLE IF EXISTS grade DROP TABLE IF EXISTS item_grade DROP TABLE IF EXISTS empresa DROP TABLE IF EXISTS cargo DROP TABLE IF EXISTS departamento DROP TABLE IF EXISTS usuario DROP TABLE IF EXISTS sala DROP TABLE IF EXISTS reserva_sala DROP TABLE IF EXISTS tipo_perfil DROP TABLE IF EXISTS perfil DROP TABLE IF EXISTS matricula CREATE TABLE curso ( codcurso VARCHAR(15) NOT NULL, nomecur VARCHAR(200) NULL, PRIMARY KEY (codcurso) LUMEWARE 4

CREATE TABLE grade ( codgrade VARCHAR(15) NOT NULL, mesgra VARCHAR(2) NOT NULL, anogra VARCHAR(4) NOT NULL, disponivelgra CHAR(1) NOT NULL, PRIMARY KEY (codgrade), UNIQUE INDEX mesano(mesgra,anogra) CREATE TABLE item_grade ( codi_gragra VARCHAR(15) NOT NULL, codi_gracur VARCHAR(15) NOT NULL, PRIMARY KEY (codi_gragra, codi_gracur), FOREIGN KEY (codi_gracur) REFERENCES curso (codcurso), FOREIGN KEY (codi_gragra) REFERENCES grade (codgrade) CREATE TABLE empresa ( codempresa VARCHAR(30) NOT NULL, nomeemp VARCHAR(100) NOT NULL, cnpjemp VARCHAR(18) NULL, emailemp VARCHAR(100) NULL, telefoneemp VARCHAR(20) NULL, cepemp VARCHAR(9) NULL, ufemp CHAR(2) NULL, cidadeemp VARCHAR(255) NULL, bairroemp VARCHAR(50) NULL, enderecoemp VARCHAR(255) NULL, numeroemp INT NULL, complementoemp VARCHAR(50) NULL, PRIMARY KEY (codempresa) CREATE TABLE cargo ( codcargo VARCHAR(30) NOT NULL, nomecar VARCHAR(100) NOT NULL, PRIMARY KEY (codcargo) LUMEWARE 5

CREATE TABLE departamento ( coddepartamento VARCHAR(30) NOT NULL, coddepemp VARCHAR(30) NOT NULL, nomedep VARCHAR(100) NOT NULL, PRIMARY KEY (coddepartamento), FOREIGN KEY (coddepemp) REFERENCES empresa (codempresa) CREATE TABLE usuario ( matriculausuario VARCHAR(20) NOT NULL, nomeusu VARCHAR(100) NOT NULL, sexousu CHAR(1) NULL, loginusu VARCHAR(50) NULL, senhausu VARCHAR(32) NULL, emailusu VARCHAR(100) NULL, datanascimentousu DATE NULL, codusudep VARCHAR(30) NOT NULL, codusucar VARCHAR(30) NOT NULL, codusuemp VARCHAR(30) NOT NULL, PRIMARY KEY (matriculausuario), FOREIGN KEY (codusuemp) REFERENCES empresa (codempresa), FOREIGN KEY (codusucar) REFERENCES cargo (codcargo), FOREIGN KEY (codusudep) REFERENCES departamento (coddepartamento) CREATE TABLE sala ( numerosala INT NOT NULL, localsal VARCHAR(200) NOT NULL, capacidadesal INT NOT NULL, PRIMARY KEY (numerosala) CREATE TABLE reserva_sala ( codreservasala VARCHAR(15) NOT NULL, numeror_salsal INT NOT NULL, datar_sal DATE NOT NULL, horarior_sal TIME NOT NULL, LUMEWARE 6

codr_sali_gragra codr_sali_gracur PRIMARY KEY (codreservasala), VARCHAR(15) NOT NULL, VARCHAR(15) NOT NULL, FOREIGN KEY (codr_sali_gragra, codr_sali_gracur) REFERENCES item_grade (codi_gragra, codi_gracur), FOREIGN KEY (numeror_salsal) REFERENCES sala (numerosala), UNIQUE INDEX reserva(numeror_salsal,datar_sal,horarior_sal) CREATE TABLE tipo_perfil ( codtipo_perfil INT NOT NULL, descper VARCHAR(100) NOT NULL, PRIMARY KEY (codtipo_perfil) CREATE TABLE perfil ( matriculaperusu VARCHAR(20) NOT NULL, codpert_per INT NOT NULL, PRIMARY KEY (matriculaperusu, codpert_per), FOREIGN KEY (codpert_per) REFERENCES tipo_perfil (codtipo_perfil), FOREIGN KEY (matriculaperusu) REFERENCES usuario (matriculausuario) CREATE TABLE matricula ( codreservasala VARCHAR(15) NOT NULL, matriculausuario VARCHAR(20) NOT NULL, matriculado CHAR(1) NOT NULL, autorizado CHAR(1) NOT NULL, PRIMARY KEY (codreservasala, matriculausuario), FOREIGN KEY (matriculausuario) REFERENCES usuario (matriculausuario), FOREIGN KEY (codreservasala) REFERENCES reserva_sala (codreservasala) 04_INSERT_TIPO_PERFIL.sql. USE lumeware INSERT INTO tipo_perfil VALUES(1,"ADMINISTRADOR") INSERT INTO tipo_perfil VALUES(2,"TREINAMENTO") LUMEWARE 7

INSERT INTO tipo_perfil VALUES(3,"GESTOR") INSERT INTO tipo_perfil VALUES(4,"ALUNO") 3.2 Servidor de Aplicação APACHE 2.x Após instalação, é apresentada a seguinte estrutura de pastas: *Abra o arquivo httpd.conf, na pasta conf. No final do arquivo, depois de tudo o que tiver nele, adicione as duas linhas a seguir: PHPIniDir C:\\php5 LoadModule php5_module C:\\php5\\php5apache2_2.dll Salve e feche o arquivo httpd.conf. *Abra o arquivo mime.types e adicione no final de tudo as duas linhas a seguir: application/x-httpd-php php application/x-httpd-php-source phps Salve e feche o arquivo mime.types. 3.3 PHP 5.2.x Após a instalação do php, alterar as seguintes linhas do php.ini: allow_url_include alterar o valor de Off para On. default_charset= iso-8859-1 Caso esteja comentado, favor descomentar. LUMEWARE 8

error_reporting comentar (error_reporting=e_all) e descomentar (error_reporting=e_all & ~E_NOTICE) extension_dir=./ descomentar e apontar para o diretório onde se encontra as bibliotecas, na figura acima as bibliotecas se encontram no diretório (C:\php5\ext). extension=php_mysqli.dll descomentar. extension=php_mssql.dll descomentar. extension=php_soap.dll comentar. max_execution_time alterar o valor de 30 para 60. register_globals alterar o valor de Off para On. short_open_tag alterar o valor de Off para On. 3.4 Sistema LUMEWARE Nesta seção será demonstrado o arquivo de configuração do sistema, chamado constantes.php. Abaixo, é apresentado o arquivo de configuração do sistema LUMEWARE: constantes.php LUMEWARE 9

Vale salientar, que o valor da constante chamada $cod_empresa, constante referente ao código de cada distribuidora é a seguinte: CEAL: 1 CEPISA: 2 Amazonas Energia: 192 CERON: 4 Eletroacre: 5 Boa Vista Energia: 132. LUMEWARE 10

4 WebServices 4.1 AutenticaUsuário (Verifica Auteticação) Este método é invocado no momento em que o usuário envia matrícula e senha, o método retorna 1(um) caso o usuário seja válido e 0(zero) caso seja um usuário inválido. Se houver alguma falha referente ao acesso ao WebService, o usuário é autenticado localmente. É passado como parâmetros chave do cliente, login e senha, retorna um arquivo XML podendo extrair um inteiro e email caso o usuário tenha efetuado alteração de seus dados no lms. 4.2 UsuariosDadosAlterados (Retorna os usuários que alteram seus dados nas últimas 24 horas) Este método é invocado sempre que o usuário de perfil Administrador é autenticado no sistema. É passado como parâmetros chave do cliente e código da empresa, retornando um arquivo XML podendo extrair matrícula, senha e email dos usuário que efetuaram alteração de seus dados no lms. 4.3 CursosDisponiveis (Retorna os cursos diponíveis) Este método é invocado sempre que o usuário de perfil Administrador seleciona o link no sistema Lumeware chamado [Obter grade de cursos da DTCOM]. É passado como parâmetros chave do cliente, mês e ano, retorna um arquivo XML podendo extrair o código do curso e a descrição. 4.4 UsuarioCursoInscrever (Inscreve um usuário em um curso) Este método é invocado sempre que o usuário Administrador ou Treinamento efetuam a matrícula dos alunos. É passado como parâmetros chave do cliente, matrícula, código do curso, ação e mensagem do email que será retornado ao aluno, este método retorna um arquivo xml. LUMEWARE 11

5 Modelo Entidade Relacionamento, LUMEWARE 12

6 Dicionário de Dados DESCRIÇÃO DAS TABELAS E CAMPOS TABELA: EMPRESA codempresa VARCHAR(30) NOT NULL Código da empresa nomeemp VARCHAR(100) NOT NULL Nome da empresa cnpjemp VARCHAR(18) NULL C.N.P.J. da empresa emailemp VARCHAR(100) NULL Email da empresa telefoneemp VARCHAR(20) NULL Telefone de contato na empresa cepemp VARCHAR(9) NULL C.E.P. da empresa ufemp CHAR(2) NULL UF da empresa cidadeemp VARCHAR(255) NULL Cidade da empresa bairroemp VARCHAR(50) NULL Bairro da empresa enderecoemp VARCHAR(255) NULL Endereço da empresa numeroemp INT NULL Numero da empresa complementoemp VARCHAR(50) NULL Complemento da empresa TABELA: DEPARTAMENTO coddepartamento VARCHAR(30) NOT NULL Código do departamento coddepemp VARCHAR(30) NOT NULL Código da empresa ao qual o departamento pertence nomedep VARCHAR(100) NOT NULL Nome do departamento TABELA: CARGO codcargo VARCHAR(30) NOT NULL Código do cargo nomecar VARCHAR(100) NOT NULL Nome do cargo TABELA: USUARIO matriculausuario VARCHAR(20) NOT NULL Matrícula do usuário na empresa precedido da sigla do estado nomeusu VARCHAR(100) NOT NULL Nome do usuário sexousu CHAR(1) NULL Sexo do usuário F/M loginusu VARCHAR(50) NULL Identificação para acesso ao lms ou ao lumeware, é o mesmo valor do campo matriculausuario senhausu VARCHAR(32) NULL Senha criptografada em MD5. emailusu VARCHAR(100) NULL Email do usuário datanascimentousu DATE NULL Data de nascimento do usuário codusudep VARCHAR(30) NOT NULL Código do departamento ao qual o usuário pertence codusucar VARCHAR(30) NOT NULL Código do cargo ao qual o usuário pertence codusuemp VARCHAR(30) NOT NULL Código da empresa ao qual o usuário pertence TABELA: PERFIL LUMEWARE 13

matriculaperusu VARCHAR(20) NOT NULL Matrícula do usuário Código do tipo de perfil do codpert_per INT NOT NULL usuário TABELA: TIPO_PERFIL codtipo_perfil INT NOT NULL Código do tipo de perfil do usuário descper VARCHAR(100) NOT NULL Descrição do tipo de perfil TABELA: MATRICULA Código referente a reserva da sala codreservasala VARCHAR(15) NOT NULL matriculausuario VARCHAR(20) NOT NULL Matrícula do usuário matriculado CHAR(1) NOT NULL autorizado CHAR(1) NOT NULL Indentificação referente a matrícula do usuário em determinado curso, se 0 o usuário não foi matriculado, se 1 o usuário foi matriculado Identificação referente à autorização do usuário pelo gestor, se 0 usuário não autorizado pelo gestor, se 1 usuário autorizado pelo gestor, caso seja recusado, é excluído fisicamente desta tabela TABELA: RESERVA_SALA codreservasala VARCHAR(15) NOT NULL Código referente a reserva da sala numeror_salsal INT NOT NULL Número de identificação da sala datar_sal DATE NOT NULL Data de reserva da sala horarior_sal TIME NOT NULL Horario de reserva da sala codr_sali_gragra VARCHAR(15) NOT NULL Código da grade codr_sali_gracur VARCHAR(15) NOT NULL Código do curso ao qual a sala está reservada TABELA: SALA numerosala INT NOT NULL Número de identificação da sala localsal VARCHAR(200) NOT NULL Local físico da sala capacidadesal INT NOT NULL Capacidade da sala TABELA: ITEM_GRADE codi_gragra VARCHAR(15) NOT NULL Código da grade codi_gracur VARCHAR(15) NOT NULL Código do curso TABELA: CURSO codcurso VARCHAR(15) NOT NULL Código do curso nomecur VARCHAR(200) NULL Nome do curso LUMEWARE 14

TABELA: GRADE codgrade VARCHAR(15) NOT NULL Código da grade mesgra VARCHAR(2) NOT NULL Mês o qual a grade pertence anogra VARCHAR(4) NOT NULL Ano o qual a grade pertence Tornar disponível a grade para que, os usuário possam efetuar a inscrição, se 0 grade indisponível, se 1 grade disponivelgra CHAR(1) NOT NULL disponível LUMEWARE 15