Home

UNIVERSIDADE DE LISBOA - Departamento de Informática

image

Contents

1. Melhorias wysiwyg Cria o da Portlet de edi o Cria o de servi os E M dulo de Pesquisa Manual Ajuste dos servi os para FrontOffice Ajuste da tree em CAF E M dulo de Pesquisa por palavra chave Cria o de servi os Cria o do algoritmo de pesquisa Interface onde s o mostrados resultados da pesquisa E M dulo de Visualiza o de t picos de ajuda Cria o de Servi os Testes Adapta o do Help Online a um projecto Reuni o com o Cliente Reformular ASI e DSI E Resolu o de problemas Identificados na ultima reuni o Solucionar problemas com passagem de informa o entre views distintas Colocar o layout gr fico do WYSIWYG igual ao utilizado no projecto Colocar a associa o de imagens ao n vel do projecto Adicionar pesquisa de imagens na edi o de conteudos Edit Adicionar pesquisa de imagens na gest o de imagens BackOffice Possibilitar escolha de visualiza o do t pico de ajuda Possibilitar Titulos Conte dos Multilanguage Utilizar o Default Locale Possibilitar desactiva o de conte dos reflectindo se em FrontOffice 1d 1d 1d 2d 1d 1d 4d 1d 2d 1d 1d 1d 10d 1d 1d 4d 29d 1d 1d 1d 2d 1d 1d 1d 1d Desabilitar o menu lateral do projecto ao abrir os t picos de ajuda do Help 1d Na edi o de conte dos mostrar todos os t picos antecedentes Constru o da Interface de Administra o Visualizar imagem
2. XML diferentes e na internet IDE para o desenvolvimento de aplica es em Java ou outras Eclipse li inguagens Componente visual independente que pode ser utilizado para Bo disponibilizar informa es dentro de uma p gina Web 16 Tecnologia que permite o desenvolvimento de aplica es compostas que podem aceder a dados de diferentes sistemas EEE E E CAF pode ser considerada como uma extens o da tecnologia JSF pois Framework CAF E uae disponibiliza controlos JSF e controlos com funcionalidades mais complexas implementadas sobre controlos JSF Java Server Faces JSF Estrutura que permite o desenvolvimento de aplica es Web de forma visual atrav s de arrastamento de componentes visuais para uma rea de edi o Permite tamb m a implementa o de ecr s em XML que depois podem ser interpretados e renderizados para HTML Asynchronous Javascript and XML Ajax Representa o uso metodol gico de tecnologias como Javascript e XML para tornar as p ginas Web mais interactivas com o utilizador valendo se de solicita es ass ncronas de informa es Jetty O Jetty um servidor HTTP e Servlet Container 100 escrito em Java A grande vantagem do Jetty a sua f cil configura o 19 Integrated Development Environment IDE Ferramenta de desenvolvimento que permite o desenvolvimento de aplica es Flow Linguagem de programa o gr fica incorporada na ferramenta
3. HO 022 Os t picos criados no Ecr de Administra o dever o por default estar com um estado desactivo HO 023 Ap s o carregamento de uma imagem poss vel efectuar uma pesquisa da mesma introduzindo um crit rio de pesquisa HO 024 Existe um Help Online por projecto HO 025 A barra de ferramentas do editor de texto dever possuir bot es que permitam apenas efectuar funcionalidades b sicas N o dever o constar por esta raz o bot es de copiar colar inser o de tabelas escolha do tipo de letra visualiza o html HO 026 Quem edita um t pico dever conseguir ver qual a sua localiza o real na arvore de conte dos HO 027 A qualquer momento poss vel gerar um relat rio que descreve todas as informa es de cada projecto para ser poss vel montar o seu HelpOnline ex associar par metros que s o enviados em Links 82 C digo Requisito Requisitos N o Funcionais Descri o Requisito Depend ncias HO NF 001 A funcionalidade de Help Online dever ser ampla tendo a possibilidade de estar presente em todos os ecr s e componentes desejadas que os utilizadores externos consigam aceder HO NF 002 A edi o dos conte dos do Help Online dever ser efectuada de forma r pida e intuitiva minimizando eventuais d vidas de processamento de texto e inser o elimina o de conte do ilustrativo HO NF 003 O Help Onli
4. HO 003 Os t picos de ajuda criados poder o ser associados aos ecr s ou a componentes desses ecr s HO 004 Os t picos de ajuda dever o ter a possibilidade de ser editados por um t cnico que apresente um perfil adequado HO 005 Os t picos de ajuda dever o ser criados e organizados pela equipa que desenvolveu o projecto a necessitar de Help Online HO 006 O Help Online composto por duas funcionalidades principais a de consulta que acess vel atrav s do frontoffice do projecto em quest o a de edi o que acess vel atrav s do backoffice do projecto em quest o Adicionalmente poder ser criada a funcionalidade de Administra o para facilitar inser es na base de dados HO 007 A informa o textual e ilustrativa dos t picos de ajuda que se querem editar dever ser inserida recorrendo a um editor de texto intuitivo cujo ambiente se assemelhe aos mais comuns HO 008 O utilizador a editar um t pico de ajuda apenas poder modificar o seu t tulo estado e conte do HO 009 O elemento da equipa de desenvolvimento ter que utilizar a interface de administra o para construir a rvore de conte do que posteriormente ser editada pelo t cnico HO 010 A rvore de conte dos ter que ser din mica com possibilidade de ser reajustada a qualquer momento HO 011 Os t picos de ajuda dever o estar associados entre si estabelecendo uma rvore hi
5. UPDATED_BY VARCHAR2 32 BYTE ja TOPICO_AJUDA_CONTEUDO_PK TOPICO AJUDA TITULO TOPICOS AJUDA aime P LOCALE E E DISABLED RULE ID TITULO CREATED AT UPDATED AT UPDATED BY HELP ONLINE ID NUMBER la TOPICO AJUDA TITULO PK eee NUMBER P LOCALE ARCHAR2 5 BYTE PF HELP ONLINE ID TIPO ELEMENTO CREATED AT UPDATED AT UPDATED BY TOPICO AJUDA TITULO ID TOPICO AJUDA TITULO LOCALE TOPICO AJUDA TITULO HO ID TOPICO AJUDA CONTEUDO ID TOPICO AJUDA CONTEUDO LOCALE 6 TOPICO_AJUDA_CONTEUDO_HO_ID NUMBER a A ANTECEDENCIAS NUMBER TOPICOS_AJUDA_PAI NUMBER TOPICOS_AJUDA_PAI_LOCALE VARCHAR2 5 BYTE TOPICOS AJUDA PAI HO ID NUMBER TOPICOS AJUDA FILHO ID NUMBER TOPICOS AJUDA FILHO LOCALE VARCHAR2 5 BYTE TOPICOS AJUDA FILHO HO ID NUMBER p iii ANTECEDENCIAS_PK gt TOPICOS AJUDA PK Fig 20 Modelo Relacional de Dados 3 4 2 Exemplo de Descri o de Servi o Nesta etapa foi tamb m efectuada uma listagem com os servi os a serem desenvolvidos Para cada servi o especificou se quais eram os seus inputs outputs assim como uma pequena descri o da opera o que viria a realizar Foi tamb m tido em conta o facto de o servi o em quest o poder utilizar outros servi os j existentes dai 47 ter sido adicionado o campo Depend ncias A descri o que contempla todos os
6. q F Provas de 3 Implementa o gt Aceitagaodo do Sistema Sistema ME para a doN velde Servi o 3 Apresenta o a e Aprova o do e Aprova o do E Apresenta o 4 istema e 6S Sistema Fig 7 Metodologias Implementa o e aceita o do Sistema de informa o As principais tarefas a realizar de acordo com o diagrama acima e enquadrados no contexto do projecto e proposta poder o ser Actividades Outputs Tarefa Forma o necess ria para a Plano de Forma o Prepara o da Forma o da Implementa o para Utilizadores Equipa de Implementa o Finais e Equipa de Implementa o Prepara o da forma o a Utilizadores Finais Carregamento de Dados ao Ambiente de Opera o Migra o e Carregamento inicial de Dados Testes de Implementa o do sistema Relat rio e resultado dos Testes de Implementa o Prepara o realiza o e avalia o dos Testes de Implementa o Testes de Aceita o do sistema Relat rio e resultado dos Testes de Prepara o realiza o e avalia o dos Testes de Aceita o Aceita o Apresenta o e Aprova o do BD e Ficheiros Convocat ria da Apresenta o sistema Carregados do Sistema Aprova o do Sistema Emiss o de Certificado de Aceita o por parte do Cliente Aprova o do Sistema Passagem a Produ o Sistema em produ o Prepara o e activa o do
7. 7 http pt wikipedia org wiki Modelo_em_tr C3 AAs_camadas 10 08 2011 8 http faculty washington edu jtenenbg courses 360 f04 sessions schneidermanGolde nRules html 31 08 2011 10 08 2011 9 http pt wikipedia org wiki ACID 10 08 2011 10 http pt wikipedia org wiki SQL 10 08 2011 11 12 13 14 15 16 17 18 19 20 21 Normas_Desenvolvimento_Cliente docx documenta o interna 15 08 2011 http java sun com docs codeconv 31 08 2011 http en wikipedia org wiki Service oriented architecture 10 08 2011 http ss64 com ora syntax naming html 10 08 2011 http pt wikipedia org wiki Business Process Management 10 08 2011 http pt wikipedia org wiki Portlet 31 08 2011 http pt wikipedia org wiki XQuery 31 08 2011 http pt wikipedia org wiki Middleware 31 08 2011 http pt wikipedia org wiki Jetty 31 08 2011 http pt wikipedia org wiki Camelcase 31 08 2011 http pt wikipedia org wiki WebServices 31 08 2011 a a d Rm O A a O e MS a 75 22 http communities softwareag com ecosystem communities public Developer web methods tutorials CAF CA FandJSF JSF_Overview html 1098892 31 08 2011 23 http en wikipedia org wiki JavaServer Faces 15 08 2011 24 http en wikipedia org wiki SOAP 15 08 2011 25 Understanding the webMethods Suite Version 7 1 Darmstadt Germany Software AG 2008 26 Getting Started with Business Process Management Version 7 1 Darmstadt Germany S
8. CONTEUDO DO TOPICO DE AJUDA Fig 40 Help Online Demo Ecr de Consulta de T picos de Ajuda 1 HELP ONLINE r Menu de pesquisa Pesquisa Manual Manual Pesquisa por T pico PROJECTO EHOGIN AS MINHAS FARM CIAS LISTA DE FARM CIAS r T pico de ajuda CONTEUDO DO TOPICO DE AJUDA Fig 41 Help Online Demo Ecr de Consulta de T picos de Ajuda 2 HELP ONLINE r Menu de pesquisa Pesquisa Manual Pesquisa por T pico _ por T pico Crit rio de Pesquisa Far LOGIN gt AS MINHAS FARM CIAS LOGIN gt LISTA DE FARM CIAS r T pico de ajuda CONTEUDO DO TOPICO DE AJUDA Fig 41 Help Online Demo Ecr de Consulta de T picos de Ajuda 3 HELP ONLINE m Menu de pesquisa M T pico de ajuda DE MOMENTO N O EXISTE AJUDA DISPONIVEL PODER UTILIZAR O MENU DE PESQUISA Fig 42 Help Online Demo Ecr de Consulta de T picos de Ajuda 4 71 O Ecr de Consulta de T picos de Ajuda acedido quando o utilizador clica na hiperliga o iuda presente no portal da aplica o para o qual se fez o Help Online sendo despoletada uma nova janela onde aparece a aplica o Help Online O primeiro componente do ecr uma sec o onde constam as opera es de pesquisa de t picos de ajuda A primeira op o chamada de Pesquisa Manual e permite ao utilizador consultar a estrutura base de como est organizado o Flow de e
9. webMethods Developer para desenvolver webservices 78 Java Linguagem de programa o orientada a objectos desenvolvida pela Sun Microsystems Simple Object Access Protocol SOAP Protocolo utilizado para a troca de informa es nos sistemas distribu dos recorrendo a outros protocolos como RPC e HTTP O formato de mensagem de SOAP tem como base o XML permitindo entre sistemas numa assim a circula o de dados linguagem normalizada Remote Procedure Call RPC Permite efectuar uma chamada a um procedimento que se encontra implementado num outro sistema atrav s do acesso por rede Sistema de Gest o de Base de Um Sistema de Gest o de Base de Dados respons vel pela gest o de uma base de dados O seu principal objectivo retirar da aplica o Dados SGBD cliente a responsabilidade de gerir o acesso manipula o e organiza o dos dados Descreve o processo de registo de eventos relevantes numa dada Lo E 8 aplica o SubVersion SVN Sistema de controlo de vers es O SSH simultaneamente um programa e um protocolo de rede que Secure Shell SSH permite a conex o com outro computador na rede de forma a executar comandos de uma unidade remota Telnet um protocolo cliente servidor usado para permitir a Telnet comunica o entre computadores ligados numa rede Baseado em TCP Drag and drop Drag and drop representa a ac o de clicar num objecto virtua
10. getTableelpOnline UDDI Registry Recent Elements helponiine resources db adapters criarProjecto E Property gt amp E Runtime Stateless Adapter Settings InputiOutput Cache resuts Cache expire Adapter Properties Adapter Name JDBC Adapter Prefetch Execution locale E Universal name FYETE 15 37 KEDO oo Fig 23 Exemplo de um Adapter Service para Criar um Projecto Principais linhas orientadores seguidas 11 e Conven o para nomes O Os nomes dos servi os folders vari veis locais aos servi os bem como as de input e output dever o ser escritos usando camelCase com a primeira letra min scula e Boas pr ticas de desenvolvimento O O Usar ao m ximo vari veis locais Minimizar o uso de loops Iniciar um documento localvars no in cio do servi o Limpar todas as vari veis n o necess rias ao output do servi o no ltimo step Colocar a inser o de dados dentro de um try catch Comentar ao m ximo cada servi o para facilitar a vida de quem tem de fazer manuten o N o deixar servi os em lock ad eternum Sempre que poss vel permitir que os servi os possuam um documento de status no output de modo a saber se correu bem ou mal 56 3 5 3 Camada de Dados A camada de dados do Help Online representa os modelos de dados mostrados anteriormente e os mecanismos de acesso aos mesmos O acesso a dados foi
11. o de conte do ilustrativo O Help Online dever ser uma funcionalidade din mica tendo capacidade de ser adaptar a distintas estruturas aplicacionais Tabela 9 Exemplos de Requisitos N o Funcionais na estrutura do documento Em suma a listagem elaborada foi de encontro a Usabilidade O GUI deve ter uma curva de aprendizagem curta reutilizando os modelos mentais dos utilizadores 4 5 Fiabilidade N o devem ser permitidas excep es n o controladas Adaptabilidade A aplica o ter que se adaptar facilmente a v rios ambientes onde seja presum vel funcionar N mero total de Requisitos N o Funcionais 6 44 3 3 4 Especifica o de Ecr Foi necess rio efectuar um primeiro esbo o do que seriam as futuras implementa es Este esbo o foi inserido na sec o de especifica o de ecr s e importante na medida que serve para ter uma vis o geral de como efectuar a implementa o sendo tamb m poss vel verificar problemas t cnicos que possam surgir no futuro Foi decidido que os prot tipos de baixa fidelidade seriam feitos no pr prio Webmethods Designer arrastando as v rias componentes e formando assim apenas uma interface est tica mas que por sua vez nos pouparia trabalho na fase de implementa o BackOffice FrontOffice Interface de Utilizador f Interface de Administra o Interface de Gest o Gest o do Help Edi o dos Online T picos de Ajuda
12. 34 35 36 37 38 39 40 41 41 42 Help Online Demo Popup de Cria o de T picos de ajuda tab 2 63 Help Online Demo Popup de Cria o de T picos de ajuda tab 3 63 Help Online Demo Popup de Edi o de T picos de ajuda tab 1 64 Help Online Demo Popup de Edi o de T picos de ajuda tab 2 64 Help Online Demo Popup de Edi o de T picos de ajuda tab 3 65 Help Online Demo Relat rio de resumo do projecto 65 Help Online Demo Interface de Gest o 66 Help Online Demo Popup de carregamento de Imagens 67 Help Online Demo Popup de Pesquisa de Imagem 68 Help Online Demo Ecr Editar T pico de Ajuda 69 Help Online Demo Popup Escolha Manual de Imagem 69 Help Online Demo Popup Escolha De Imagem por Pesquisa 69 Help Online Demo Ecr de Consulta de T picos de Ajuda 1 71 Help Online Demo Ecr de Consulta de T picos de Ajuda 2 71 Help Online Demo Ecr de Consulta de T picos de Ajuda 3 71 Help Online Demo Ecr de Consulta de T picos de Ajuda 4 71 Lista de Tabelas Tabela 1 Perfis dos colaboradores Indra re 15 Tabela 2 Metodologias Tarefas de Analise do Sistema de Infor
13. Ambiente de Produ o Tabela 5 Metodologias Tarefas de IAS do Sistema de Informa o 26 2 5 Contexto Tecnol gico A empresa webMethods foi fundada em 1996 por Phillip Merrick sendo adquirida pela Software AG em 2007 empresa essa que disp em actualmente de um conjunto de produtos honrando o nome de origem A suite webMethods caracteriza se como sendo um software para melhoria de processos disponibiliza o de SOA 13 e principalmente integra o Durante os seus primeiros anos a empresa faliu mas com uma infus o de capital e alguns novos clientes como o Citi Bank Fedex e Dell viria a ganhar novo f lego Um pouco mais tarde formalizou se uma parceria com a Microsoft para desenvolver a XML Query Language No ano seguinte desenvolveu outra parceria estrat gica desta vez com a SAP para fornecer capacidades de integra o entre as v rias tecnologias Com todas estas parcerias a webMethods estabeleceu se como um fornecedor de middleware com solu es de integra o de aplica es integra o de parceiros e produtos de BPM Com o adquirir da Webmethods a Software AG fez dessa ferramenta uma das suas principais linhas de produtos 2 5 1 A Plataforma Webmethods A plataforma webMethods pode entender se como uma tecnologia orientada a servi os que se enquadra na arquitectura SOA e no conceito BPM Abaixo s o referenciados alguns t picos que considero interessantes para introduzir esta tecnologia e Uso de uma
14. N A Descri o Para cada conte do inerente a um determinado projecto existente na tabela TOPICO AJUDA CONTEUDO actualiza os valores da tag HTML lt IMG src gt de forma a actualizar a localiza o das imagens para o novo path passado como input do servi o igualmente efectuada a actualiza o do campo URL na tabela IMAGENS REFDATA referente a cada imagem associada ao projecto 84 criarProjecto Nome criarProjecto Inputs nome descricao default language updated by Outputs status Depend ncias N A Descri o Cria a estrutura na base de dados necess ria para come ar a introduzir t picos de ajuda criarTopicoAj uda Nome criarTopicoAjuda Inputs id_projecto loc tipo portlet elemento updated_by titulo accao_conteudo id_conteudo descricao_conteudo id_antecedente Outputs status Depend ncias N A Descri o Este servi o pode seguir dois caminhos independentes consoante o que recebe o input accao conteudo No caso do accao conteudo vier preenchido com o valor existente significa que se est a tentar criar um novo t pico de ajuda no entanto o conte do que se lhe ir atribuir um conte do j existente na base de dados desta forma apenas ser efectuado um insert na tabela TOPICOS AJUDA Para o caso em que o input accao conteudo vem preenchido com o valor novo ter o de ser executados dois inserts um primeiro na tabela TOPICO AJUDA CONTEUDO e outro na tabela
15. O FrontOffice Foram mostradas as principais funcionalidades a serem propostas para um utilizador de FrontOffice Poss vel Modelo de Dados Demonstra o do Modelo de dados base que suportaria a rea de neg cio Devido boa rela o mantida entre o Cliente e a empresa esta etapa n o foi muito aprofundada pois j tinha sido discutido previamente a ideia de se construir um novo sistema de Help Online Esta etapa baseou se ent o na apresenta o feita ao cliente na qual os t picos abordados foram aceites entre ambas as partes 40 3 3 An lise do sistema de informa o ASI Nesta etapa foi feita uma discrimina o detalhada do Help Online atrav s de um documento de especifica o funcional Esse documento conta com uma descri o pormenorizada da aplica o dizendo qual o seu mbito assim como tamb m s o mostrados todos os requisitos inerentes S o apresentadas as Especifica es de ecr s Finalizado o Documento foi necess rio proceder sua aprova o por parte da equipa funcional 3 3 1 Requisitos Funcionais Estes requisitos foram obtidos atrav s de um trabalho de an lise com base em documenta o interna j existente reuni es realizadas junto com o cliente e tamb m atrav s de conhecimento partilhado dentro da equipa A listagem foi feita com a seguinte estrutura e C digo requisito C digo a ser usado por qualquer refer ncia que se fa a a este requisito espec fico e Descri o Requ
16. RPC Remote Procedure Call SGBD Sistema de Gest o de Base de Dados SOA Service Oriented Architecture SOAP Simple Object Access Protocol SQL Structured Query Language SSH Secure Shell SVN SubVersion XML eXtensible Markup Language 11 12 Cap tulo 1 Introdu o 1 1 Contexto O est gio em que me inseri teve in cio a 6 de Setembro de 2010 e uma dura o total de 9 meses tendo sido desenvolvido o projecto nas pr prias instala es do cliente que facultou os servi os disponibilizados pela Indra Sistemas Portugal S A A orienta o na empresa esteve a cargo do Eng Jos Pedro Pereira Cardoso que me acompanhou ao longo do est gio e forneceu o suporte necess rio ao desenvolvimento do projecto e integra o na tecnologia A INDRA Sistemas uma empresa multinacional de Tecnologias de Informa o n mero um em Espanha e uma das principais na Europa e na Am rica Latina A sua capitaliza o bolsista coloca a entre as tr s maiores empresas europeias do seu sector sendo uma das tr s empresas espanholas que mais investe em I D Actualmente a Indra conta com mais de 23 500 colaboradores e tem clientes em mais de 90 pa ses Em Portugal a empresa composta por uma equipa com cerca de 400 profissionais com elevada especializa o procurando ser o principal aliado dos seus clientes no uso intensivo das tecnologias de informa o A estrutura da empresa divide se em v rios mercados verticais que lhe permitem criar uma o
17. e Atomicidade a implementa o de um servi o deve ser centralizada na sua fun o pois quanto mais complexo for as suas funcionalidades menos reutiliz vel um servi o pode ser e Generaliza o a implementa o deve ser efectuada tendo em considera o a sua capacidade de reutiliza o em diferentes casos como por exemplo em outros servi os devendo ser mais generalizado poss vel mas tendo sempre em conta a sua fun o principal e Simplicidade e clareza a l gica de um servi o deve ser o mais simples e claro poss vel para facilitar a sua manuten o De entre as v rias regras impostas pela equipa ou at mesmo pelo cliente para a constru o de servi os por exemplo os servi os estarem organizados dentro de pacotes com nomes que sugiram facilmente o que fazem saliento o facto de que ao contr rio do que instintivamente foi definido na especifica o dos servi os dizendo que cada servi o recebe v rios inputs de v rios tipos de dados o que aconteceu na realidade foi que para uma maior facilidade de uso e manuten o de vari veis internamente essas v rios inputs foram colocados dentro de documentos estando os par metros de entrada num documento de entrada e os par metros de sa da num documento de sa da tendo estes documentos nomes nicos baseados no nome do servi o a que pertence como por 53 exemplo lt nome do servi o gt InputVars e lt nome do servi o gt OutputVars Esta mane
18. entre subsistemas a Constru o e Provas do Sistema CS all i C digodos Procedimentos A reparacio gt Execu o i eee ok das Provas Unitarias g lo Desenvolvimento Componentese Execu o dentegra o d Execu o das 4 Provas do E Sistema Elabora o dos Manuaisde Usuario Finais Defini oda i Forma oaos Usu rios Finais J Constru o dos Componentes e Procedimentos det Migra oeda Carga Inicial De Dados Aprova o A dos Sistemas Fig 6 Metodologias Constru o do Sistema de informa o 24 Seguidamente s o apresentadas as principais tarefas e respectivos Outputs Actividades Outputs Tarefa Desenvolvimento do C digo de C digo Fonte de Gera o do C digo dos componentes e procedimentos Componentes componentes e Procedimentos de Opera o e Seguran a Execu o de Testes Unit rios Relat rios de Testes unit rios Realiza o de Testes Unit rios Avalia o de Testes Unit rios Execu o de Testes de Integra o Relat rio de Testes de integra o Realiza o e Avalia o dos Testes de Integra o Execu o de Testes de Sistema Avalia o e Resultado dos Testes ao Sistema Realiza o e Avalia o dos Testes de Sistema Elabora o dos Manuais de Utilizador Manuais de Utilizador Elabora o dos Manuais
19. servi os esta em anexo porem de seguida encontram se dois exemplos do que foi desenvolvido Nome criarProjecto Inputs nome descri o default language updated by Outputs status Depend ncias N A Descri o Cria a estrutura na base de dados necess ria para come ar a introduzir t picos de ajuda Tabela 11 Exemplo de Descri o do servi o criarProjecto Nome criar TopicoAjuda Inputs id projecto loc tipo portlet elemento updated by titulo accao conteudo id conteudo descricao conteudo id antecedente Outputs status Depend ncias N A Descri o Criar um t pico de ajuda com um conte do vazio Tabela 12 Exemplo de Descri o do servi o criarTopicoAjuda 48 3 5 Constru o do sistema de informa o CSI Nesta fase procedeu se constru o dos diferentes componentes do sistema de informa o a partir do conjunto de especifica es l gicas e f sicas feitas nas etapas anteriores Para tal foram usados essencialmente tr s ambientes e Ambiente de Desenvolvimento Local e Ambiente de Desenvolvimento Testes de integra o e Ambiente de Testes O Ambiente Local serviu para a resolu o de pequenos problemas pois era partida o ambiente menos carregado de dados e consequente o mais r pido para se fazer a publica o da nossa aplica o No Ambiente de desenvolvimento estavam presentes os projectos a desenvolver na altura inclu do a nossa apl
20. veis tr s separadores um primeiro onde colocar os dados que identificar o t pico um segundo onde indicar se pretende criar um novo conte do ou associar o conte do de um t pico j existente e por fim um terceiro onde poss vel indicar em que ramo da rvore de conte dos ir inserir se o t pico criado Relativamente ao primeiro separador Identifica o o t cnico ter de fornecer o t tulo do t pico que identificar o t pico na rvore do projecto uma informa o sobre a portlet em que se insere e se for caso disso informa o a que elemento da portlet se refere No separador Conte do existem duas hip teses criar um novo conte do bastando para isso atribuir uma designa o ou ent o associar a este t pico de ajuda um conte do ja existente ou seja um conte do que poder j pertencer a um ou mais t picos deste projecto Por fim o separador de Anteced ncia disponibiliza a rvore de t picos do projecto Se o t cnico pretender adicionar o t pico que est a criar no n vel mais baixo tem duas solu es ou clicar no nome do projecto no exemplo da imagem acima PROJECTO 63 PT ou ent o simplesmente n o definir nenhum t pico seleccionado Caso pretenda adicionar noutro n vel bastar clicar no t pico que quer passar a ter como antecedente Ap s correcta cria o do t pico de ajuda poss vel edit lo Para isso o t cnico ter de seleccionar o t pico que pretende editar clicando no link c
21. 30 11 Interface Web do MyWebmethods Server iiirereeeererrereaeerenae 31 12 Interface de desenvolvimento do Webmethods Developer 32 13 Interface Web do Integration Server size siianiaiacaa sines aoiina das si qerebifun a aie 33 14 Arquitectura LOSIC ss a A E A KEER 34 15 Exemplo de Arquitectura F sica us ssgassis eet ea i Mick nla faca 35 16 Caso de Uso Interface de administra o ccece eee eeeeereerereeeeo 42 17 Caso de Uso Interface de DES O essa testa a Ria donde 42 18 Caso de Uso Interface de utilizador 43 19 Beras do sistema Help QU lines aaliscticadse ten eted aros peles dica de tar atalias 45 20 Modelo Relacional de Dados asa cassetes span isa acena Ga wade 47 21 Exemplo de constru o de interface no Webmethods Designer 51 22 Exemplo do Servi o inserirTemplDespacho no Developer 55 23 Exemplo de um Adapter Service para Criar um Projecto 56 24 Diagrama Requisitos vs Produto s cascais cremes singo pac ceisi nes aianana eine 60 25 Help Online Demo Interface de Administra o 61 26 Help Online Demo Popup de Adicionar Novo Projecto 62 27 Help Online Demo Popup de Cria o de T picos de ajuda tab 1 62 7 Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig 28 29 30 31 32 33
22. Clientes Internet J E IS Node 1 IS Node 2 Fig 15 Exemplo de Arquitectura F sica 35 2 5 4 Ferramentas auxiliares Base de dados Foram usadas ferramentas de base de dados que suportam a informa o e os dados dispon veis O SGBD usado em ambiente de produ o foi o Oracle 9i pois j era usado em grande parte das aplica es existentes no cliente enquanto que em ambiente de desenvolvimento foi usado o Oracle 11g A ferramenta cliente de Base de Dados mais usada foi o SQL Developer 3 tamb m da Oracle Baretail 1 Esta aplica o foi utilizada para visualizar os ficheiros de log neste caso dos servidores MWS e IS em tempo real Uma das suas fun es mais interessantes o Highlighting que permite aplicar cores de fundo a linhas que contenham uma determinada express o o que por vezes muito til na detec o de erros TortoiseSVN 2 Este foi o cliente de SVN usado e que permitiu o controlo de vers es dos v rios ficheiros utilizados pela equipa de desenvolvimento Revelou se uma das ferramentas mais utilizadas e facilitou o trabalho corporativo 36 Cap tulo 3 Trabalho realizado 3 1 Gest o de actividades O Planeamento previsto no in cio do est gio n o foi cumprido de forma rigorosa em resultado de v rios factores que foram surgindo como por exemplo e Pedido do cliente para adi o de novas funcionalidades e Altera o na estrat gia comercial Apesar da discrep ncia existent
23. Fig 19 Ecr s do sistema Help Online A estrutura de ecr s representada na Fig 19 foi dividida em 2 subgrupos BackOffice e FrontOffice O primeiro pressup e que a utiliza o do ecr ser feita por algu m com perfil de administra o do sistema Help Online O segundo pressup e que a utiliza o do ecr e feita por algu m que s pretende utilizar o sistema de ajuda De seguida exemplificada a estrutura de uma especifica o de ecr 45 1 Ecra de Consulta de T picos de Ajuda r Menu de pesquisa m T pico de ajuda DE MOMENTO N O EXISTE AJUDA DISPONIVEL PODER UTILIZAR O MENU DE PESQUISA 2 Descri o Descri o das Funcionalidades do ecr 3 Campos Campo Tipo O F Descri o Origem rvore de T picos Toogle Tree F 4 Regras de neg cio Campo Regra de Neg cio Numa rvore de conte dos vazia ir constar exclusivamente a sua raiz sendo que os t picos quando forem criados ser o subt picos deste n vel rvore de Conte dos Vazia Inexist ncia de t pico de ajuda O utilizador informado que n o existe nenhum t pico que que contenha contenha a palavra chave usada palavra chave 5 Ac es Ac o Descri o Menu de pesquisa Permite ocultar e mostrar a sec o de pesquisa de conte dos Pesquisa Manual Permite expandir ou abrir os ramos da rvore sendo poss vel passar a visualizar o seu conte
24. IS A integra o com as aplica es j existentes no Cliente ser realizada atrav s de chamadas a servi os dispon veis no Integration Server Estas chamadas sendo internas s o lan adas no pr prio servidor sem recurso a outras tecnologias A interac o com a gest o documental e uma gateway de pagamentos feita com o consumo de webservices que estas plataformas exp em Estas chamadas s o feitas usando o formato SOAP sobre um canal de comunica o HTTP Q Utilizadores Internos User Interface Gest o de Credenciais de Utilizadores Gest o Documental U Oracle Database Fig 14 Arquitectura L gica 34 2 5 3 Arquitectura F sica A arquitectura f sica que importa referir aquela que dar suporte aplica o em ambiente de produ o Dado que a tecnologia a usar WebMethods e estando j instalado no Cliente uma solu o para esta necessidade e que suportava todos os sistemas foi usada a mesma arquitectura que se espelha a t tulo de exemplo na imagem abaixo e que usada para a equipa Indra no Cliente Importa referir tamb m que toda a arquitectura se baseia naquela que imposta pela utiliza o da suite webMethods podendo apenas ser escal vel consoante a necessidade do cliente em quest o od MWS Node 1 MWS Node 2 MWS Node 3 aN Clientes Rede Interna MWS Load Balancer Apache Reverse Proxy Firewall IS Load Balancer Gest o Documental Broke
25. M dulo de wysiwyg Actualiza o do Script de imagens consuante servidor 38 Dura o 5d 15d 1d 4d 10d 3d 1d 1d 5d 5d 1d 1d 1d 2d 1d 18d 1d 16d 7d 9d 1d 10d 1d 8d 4d 4d 1d 34d 1d 1d 3d 1d 1d 1d 1d 2d 1d 1d 4d 1d inicio 06 09 2010 13 09 2010 13 09 2010 14 09 2010 20 09 2010 20 09 2010 23 09 2010 24 09 2010 27 09 2010 04 10 2010 04 10 2010 04 10 2010 05 10 2010 06 10 2010 08 10 2010 11 10 2010 11 10 2010 12 10 2010 12 10 2010 21 10 2010 03 11 2010 04 11 2010 04 11 2010 05 11 2010 05 11 2010 11 11 2010 17 11 2010 18 11 2010 18 11 2010 19 11 2010 22 11 2010 22 11 2010 22 11 2010 23 11 2010 24 11 2010 25 11 2010 25 11 2010 26 11 2010 29 11 2010 29 11 2010 Fim 10 09 2010 01 10 2010 13 09 2010 17 09 2010 01 10 2010 22 09 2010 23 09 2010 24 09 2010 01 10 2010 08 10 2010 04 10 2010 04 10 2010 05 10 2010 07 10 2010 08 10 2010 03 11 2010 11 10 2010 02 11 2010 20 10 2010 02 11 2010 03 11 2010 17 11 2010 04 11 2010 16 11 2010 10 11 2010 16 11 2010 17 11 2010 04 01 2011 18 11 2010 19 11 2010 24 11 2010 22 11 2010 22 11 2010 23 11 2010 24 11 2010 26 11 2010 25 11 2010 26 11 2010 02 12 2010 29 11 2010 Predecessores N Oo NN DD 12 13 14 10 17 19 18 16 23 25 24 22 29 30 32 33 31 37
26. NOVO PROJECTO Identifica o do Projecto Nome Descri o Fig 26 Help Online Demo Popup de Adicionar Novo Projecto Ap s a cria o do projecto na dropdown Projecto passar a ser poss vel seleccionar o novo projecto criado aparecendo de seguida o segundo componente deste ecr a Gest o de T picos do Projecto Este componente apresenta uma rvore de t picos de ajuda que inicialmente se encontra vazia Ser agora necess rio inserir t picos de forma a garantir que a estrutura criada corresponde a uma sequ ncia perfeita da navega o do portal do projecto poss vel criar um novo que despoletar o seguinte popup T PICO DE AJUDA Conte do Anteced ncia Identifica o do T pico Projecto T tulo Tipo o Portlet Elemento Portlet Fig 27 Help Online Demo Popup de Cria o de T picos de ajuda tab 1 62 T PICO DE AJUDA Identifica o Conte do Anteced ncia Conte do Conte do Criar Novo 5 Associar Existente T tulo do Novo Conte do Fig 28 Help Online Demo Popup de Cria o de T picos de ajuda tab 2 T PICO DE AJUDA Identifica o Conte do T pico Antecedente T pico Antecedente Seleccionado kh Projecto pt EM OGIN AS MINHAS FARM CIAS LISTA DE FARM CIAS Fig 29 Help Online Demo Popup de Cria o de T picos de ajuda tab 3 Neste popup o t cnico tem dispon
27. TOPICOS AJUDA sendo passado o GUID dos TOPICO AJUDA CONTEUDO como chave estrangeira do TOPICOS AJUDA efectuado tamb m um insert na tabela ANTECEDENCIAS de forma a colocar o novo t pico de ajuda no ramo correcto da rvore getAllLanguages Nome getAllLanguages Inputs N A Outputs listaPaises codigo nome status Depend ncias N A 85 Descri o Devolve uma lista com todos os pa ses existentes em base de dados Para cada pa s indicado um c digo abreviatura de duas letras e o nome getBDHelpOnline Nome getBDHelpOnline Inputs N A Outputs BDHelpOnline Documento can nico cujo conte do representa fielmente todos os dados existentes em base de dados na altura em que o servi o corrido Depend ncias adicionarLanguage changeImagesPath criarProjecto criarTopico Ajuda insereHistorico insertImage removelmage removeTopico removerLanguage removerProjecto updateTopico updateTopico Ajuda Descri o Preenche o documento can nico com todos os dados existentes na base de dados referentes ao Help Online Este documento ir servir como input do servi o insertBDHistory que guarda no hist rico a base de dados do Help Online getConteudos Nome getConteudos Inputs id projecto language Outputs conteudos GUID rule id conteudo status size Depend ncias N A Descri o Devolve uma lista com todos os conte dos existentes na base de dados na tabela TOPICO AJUDA CONTEUDO inere
28. cnicas de comunica o e t cnicas para melhorar a nossa imagem 1 3 Integra o no projecto Com o cargo de Engenheiro de Sistemas J nior o meu trabalho inseriu se quer na vertente t cnica quer na vertente funcional tendo sido alocado no sector de Solu es Tecnol gicas descrito na imagem abaixo Tecnologias Arquitecturas gt Emergentes Plataformas Sekine EDITRAN Fig 2 Organiza o do sector de Solu es Tecnol gicas Apesar do cargo sugerir apenas um trabalho de perfil t cnico foi acordado com o Gestor de Projecto a minha participa o em trabalhos funcionais tal como o planeamento enviado para a FCUL sugeria A minha integra o no projecto passou pela leitura dos documentos relativos a cada projecto a ser desenvolvido na altura Posto isto deu se a realiza o de v rias tarefas de ambienta o tecnol gica como a realiza o de pequenos tutoriais servi os etc 1 4 Objectivos Tratando se de um Est gio numa empresa que realiza servi os de consultoria existiu sempre a possibilidade de os objectivos n o estarem focados a um nico projecto mas sim a uma tecnologia No meu caso espec fico tive a possibilidade de me concentrar unicamente num projecto Sendo assim estes foram os objectivos identificados no inicio do est gio Efectuar a an lise desenho e implementa o de numa plataforma tecnol gica compreendendo primeiramente os problemas e necessidades que deram origem ao projec
29. de Utilizador Constru o de Componentes Constru o de Procedimentos de Migra o e Carregamento Inicial de Dados Procedimentos de Opera o Administra o do Sistema Seguran a e Controlo de Acesso Prepara o da migra o e carregamento inicial de dados Gera o do c digo dos Componentes e Procedimentos de Migra o e Carregamento Inicial de Dados Aprova o do sistema Apresenta o e Aprova o do sistema Tabela 4 Metodologias Tarefas de Constru o do Sistema de Informa o 2 4 5 Implementa o e aceita o do sistema IAS Este processo tem como objectivo principal a entrega e aceita o do sistema na sua totalidade e a realiza o das actividades necess rias para a passagem produ o do sistema O Sistema ir submeter se aos Testes de Implementa o com a participa o do utilizador cuja responsabilidade entre outros aspectos comprovar o comportamento do sistema sob as condi es mais extremas Tamb m se submeter aos Testes de Aceita o cuja execu o da responsabilidade do utilizador final 23 w implementa o e Aceita o do Sistema IAS F Especifica o 4 d A E ii do sietamad Implementa o almplementa o Opora o Cargado Dados a Envolvente daOperagao J Incorpora o provas de Prepara o Manuten o Estabelecimento i doAcordo
30. do Permite seleccionar o separador onde se encontra a rvore para fazer uma pesquisa manual 6 Integra es com outros sistemas Sistema Descri o Tabela 10 Exemplo de especifica o de um ecr 46 3 4 Desenho do sistema de informa o DSI Nesta etapa houve necessidade de demonstrar ao cliente o processo de desenvolvimento a ser usado Foi feita uma descri o das camadas l gicas seguindo se um pequeno resumo sobre a arquitectura na qual assentou o projecto Foi feito tamb m os Modelo de Dado finalizando se com uma descri o dos principais servi os a serem realizados Por fim assim como aconteceu no documento funcional o documento proveniente desta etapa tamb m requereu uma aprova o 3 4 1 Modelo Relacional 6 O Modelo Relacional abaixo permite criar uma representa o l gica consistente da informa o na base de dados IMAGENS REFDATA NOME_FICHEIRO VARCHA DESCRICAO v URL CREATED_AT UPDATED_AT UPDATED_BY DOC ID P GUID VARCHAR2 32 BY F HELP ONLINE ID NUMBER IMAGENS REFDATA PK HELP ONLINE REAR UMBER PROJECTO VARCHARZ 100 BYTE DESCRICAO VAR 2 CREATED AT UPDATED AT UPDATED BY le HELP ONLINE PK 200 BYTE P 1D ARC P LOCALE JARCHA PF HELP ONLINE ID NUMBER DISABLED NUMBER 1 RULE ID VARCHAR2 100 BYTE CONTEUDO CLOB CREATED_AT TIMESTAMP UPDATED_AT TIMESTAMP
31. e onde o funcionamento de uma afecta o funcionamento da outra Rela o Requisito Interface AE ED TT 5 O Forte Capacidades do Sistema Help Online Aplica o do BackOffice Frontoffice cliente M dia A Fraca Correla o interfaces Forte Positiva Positiva Negativa Interface a receber Help Edi o dos T picos de Ajuda Interface de Utilizador Interface de Administra o Gest o do Help Online Prioridade 0 10 o Wa oO MD DW Fig 24 Diagrama Requisitos vs Produto 60 3 6 Implementa o e aceita o do sistema IAS Por fim esta fase visou a realiza o das actividades necess rias para a passagem produ o do sistema onde de seguida s o mostrados os resultados tang veis O Sistema desenvolvido e que ficou a funcionar constitu do por 4 interfaces Fig 19 que podem por sua vez ser acedidas por 2 tipos de utilizadores um com perfil de administra o BackOffice e outro com perfil de utilizador gen rico FrontOffice o qual d uso s funcionalidades de ajuda on line Toda a l gica desta aplica o suportada pela cria o de uma estrutura de dados em rvore onde s o guardados os t picos de ajuda Deste modo foi nos poss vel representar a sequ ncia perfeita da navega o do portal do projecto n o esquecendo que os t picos de ajuda possuem sempre um t pico antecedente e precedente excepto o primeiro e os ltimos que possibilita a cria o de
32. fica uma descri o mais detalhada sobre cada perfil inerente s equipas Indra Perfil Descri o Director de Projecto Boa compreens o das realidades e orienta es da organiza o Fortes compet ncias na direc o de projectos Experi ncia em projectos de constru o de arquitecturas de integra o e de implementa o de solu es Conhecimento detalhado das metodologias de projecto seleccionadas pela Indra Experi ncia na constru o e seguimento de modelos de avalia o de benef cios Experi ncia na articula o com parceiros numa ptica institucional e de projecto Gestor de Projecto 14 Perfil Consultor de Qualidade Descri o Conhecimento detalhado das metodologias de projecto e dos procedimentos de controlo de qualidade da Indra Comprovada experi ncia na verifica o de qualidade de projectos nas distintas vertentes Gest o Processos Tecnologia Pessoas e Benef cios Coordenador T cnico Expert Experi ncia na lideran a operacional de equipas de implementa o Comprovada experi ncia em projectos de integra o e no desenho de arquitecturas tecnol gicas Especialista na implementa o de solu es baseadas em webMethods Experi ncia em an lise e desenho de processos Consultor S nior Tecnol gico Experi ncia na lideran a operacional de equipas de implementa o Comprovada experi ncia em projectos de integra o e no de
33. informativa quer positiva quer negativa Preven o e tratamento de erros Foram prevenidos todos os poss veis erros na medida do poss vel Esta fase por m foi sendo melhorada e s foi terminada depois da fase de testes Revers o de ac es O utilizador poder sempre que quiser fazer uma revers o das suas ac es Exemplo disto s o situa es em que uma dada tarefa feita em v rios passos podendo o utilizador sempre que desejar voltar ao passo anterior Baixa carga de memoriza o A interface foi feita de forma a estar bem estruturada e existir um equil brio que permita ao utilizador relacionar elementos com determinadas ac es Total de Interfaces 4 Total aproximado de Linhas de c digo 3508 50 id cA EL DEEA rey eeror ES Ei Process Deve 49 Solut GE Outli 5 Navi 53 O B EditarAjuda defaultview EditarAjudaDefaultviewViewjava 5 FrontOffice default view 2 Ja ales llp build 2 se E WebContent Em Administracao gt BackOffice EditarAjuda svn B defauttview amp FrontOffice amp svn B default view imagens META INF m A Meta 52 BB Save B Pack isl Library is disabled Use the library preferences to enable it Design Preview 13 44 E 04 07 2011 Fig 21 Exemplo de constru o de interface no Webmethods Designer Devido enorme quantidade de c digo existente apenas irei des
34. o de conte do s o presentes os campos t tulo activo desactivo e um editor de texto que designamos por WYSIWYG O campo t tulo n o mais que uma mera designa o dada ao t pico de ajuda sendo que esta designa o a que consta na rvore de conte dos do Ecr Gest o do Help Online O campo activo desactivo serve para activar ou desactivar o conte do de um determinado t pico de ajuda possibilitando a oculta o do seu conte do aquando de uma consulta na rvore de consulta Finalmente o WYSIWYG uma ferramenta de edi o de texto que possibilitar ao t cnico editar o conte do de ajuda que pretende disponibilizar aos utilizadores do portal tendo a particularidade de disponibilizar diversas op es intuitivas tal como inser o de imagens e formata o de texto De referir que a op o de inser o de imagens disponibilizada pela WYSIWYG foi melhorada disponibilizando uma consulta base de dados atrav s de uma dropdown que devolve todas as imagens j carregadas anteriormente para um determinado projecto bastando para isso estar seleccionando a Manual op o poss vel tamb m efectuar uma pesquisa clicando na op o Pesquisar E e i de uma determinada imagem caso a lista seja extensa Para visualizar a imagem pretendida ter que se clicar em sualizar 70 Interface de Utilizador FrontOffice HELP ONLINE E Menu de pesquisa T pico de ajuda
35. servidor aplicacional baseado em Jetty que possibilita aos utilizadores executarem fun es nas componentes webMethods e onde os Administradores podem editar aceder a essas funcionalidades O servidor My webMethods fornece um conjunto amplo de ferramentas administrativas para gerir as funcionalidades desenvolvidas Este servidor reconhece dois tipos de administradores com base nas fun es que realizam e My webMethods Administrator o Administrador por defeito e pode gerir fun es interfaces disponibilizadas aos utilizadores assim como outros aspectos de mais alto n vel e System Administrator Pode efectuar fun es de an lise configura o de conte dos e podem tamb m gerir fun es que s o disponibilizadas aos utilizadores tudo isto num n vel mais edit vel que o primeiro Sendo assim a exist ncia deste servidor desenrola se em torno de duas reas funcionais e CAF Composite Application Framework onde se permite desenvolver portlets ou mini aplica es web Estas portlets podem ser colocadas em 30 p ginas para possibilitar uma interface ao utilizador Estas p ginas s o desenvolvidas numa ferramenta chamada webMethods Designer que mais n o que uma vers o do IDE Eclipse com um grande conjunto de plugins e uma palete pr pria de desenvolvimento e Administration representada atrav s de p ginas de configura o que permitem configurar grande parte daquilo que se desenvolveu Lise J O lo
36. um path que por sua vez representa o caminho que esse utilizador percorreu A solu o desenvolvida consistiu ent o no seguinte Interface de Administra o BackOffice cto Remover Projecto Projecto Ajuda Editar T pico de Ajuda Remover T pico de Ajuda T pico Seleccionado HH Projecto pt EHOGIN AS MINHAS FARMACIAS LISTA DE FARMACIAS Fig 25 Help Online Demo Interface de Administra o O Ecr de Administra o do Help Online acedido pela equipa de desenvolvimento do projecto onde se ir inserir o Help Online Atrav s desta interface de administra o poder criar associar o s seu s novo s projecto s aplica o Help Online e posteriormente adicionar novos t picos de ajuda Neste ecr apenas relevante criar a estrutura em rvore do projecto e dos conte dos de ajuda Os textos 61 explicativos e as imagens ilustrativas do t pico de ajuda ficar o a cargo do Ecr Editar T pico de Ajuda A utiliza o da interface de administra o pressup e que o primeiro passo seja a cria o de um projecto Esta ac o ir efectuar inicializa es na base de dados que permitir o posteriormente criar e gerir os t picos de ajuda e imagens associados a um determinado projecto O primeiro componente do Ecr de Administra o do Help Online portanto a Gest o de Projectos O link didonar Novo Projecto ir despoletar o seguinte popup ADICIONAR
37. 011 19 01 2011 02 02 2011 03 02 2011 04 02 2011 07 02 2011 09 02 2011 11 02 2011 14 02 2011 07 03 2011 07 03 2011 31 03 2011 11 03 2011 16 03 2011 25 03 2011 31 03 2011 07 04 2011 09 06 2011 40 40 41 42 39 45 48 49 47 51 53 55 28 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 57 57 75 78 79 80 82 3 2 Estudo de viabilidade do sistema EVS Nesta etapa foram analisadas quais as necessidades que o cliente tinha para dar seguimento ao projecto do Help Online Nesta fase foi me atribu da pela Gestora de Projecto a responsabilidade da realiza o do Help Online Ficou tamb m definido que este projecto seria o tema central da tese de mestrado o que implicaria portanto ter um prazo m ximo de 9 meses Visto o cliente ser bastante flex vel e existir um contacto pr ximo com a empresa foi agendada uma reuni o para dar a conhecer o projecto ao cliente A reuni o focou os seguintes t picos O que ser o Help Online Come ou por ser fazer uma demonstra o das diferen as relativas ao que j existia feito e ao que poder amos fazer Requisitos Foram clarificados os requisitos que o cliente j tinha imposto sobre a aplica o anterior requisitos esses que n o eram cumpridos Falou se nomeadamente do facto de o conte do de ajuda n o poder ser edit vel O BackOffice Foram mostradas as principais funcionalidades a serem propostas para um utilizador de BackOffice
38. Arquitectura Orientada pelos Servi os SOA 13 em que as aplica es desenvolvidas devem usar funcionalidades oferecidas em forma de servi os de um sistema computacional diferente sendo que estes servi os poder o ser usados por v rias aplica es e Possibilidade de modela o gr fica de processos BPM atrav s da sua decomposi o em tarefas humanas e ou integra o de servi os aplicacionais Desta forma o cliente deter uma plataforma de gest o de processos gil e flex vel simplificando a manuten o dos processos actuais bem como a cria o de novos processos 27 e Disponibiliza o de webServices acess veis via Web HTTP e que fornecem para o exterior funcionalidades ou servi os de forma a poderem ser usados por um cliente e Uso de XML Os pontos descritos em cima privilegiam maioritariamente a facilidade de manuten o a possibilidade de expans o e a capacidade de integra o de novas funcionalidades com o intuito de permitir a evolu o do sistema ao longo do tempo de acordo com as necessidades A arquitectura pode ser vista segundo tr s n veis principais 7 sendo eles a Camada de Apresenta o a Camada de L gica de Neg cio e a Camada de Dados conforme alude a figura abaixo Clientes Web Camada de apresenta o Camada de L gica de Neg cio Camada de dados Fig 8 Modelo em tr s camadas mais Clientes Web do Webmethods Por sua vez no diagrama seguinte exemplifica
39. IRO DESCRICAO URL HELP ONLINE ID DOC ID status Depend ncias N A Descri o Este servi o devolve informa o relativa imagem cujo nome do ficheiro corresponde ao dado como input Devolve para cada imagem o GUID identifica o 87 un voca NOME FICHEIRO nome do ficheiro referente imagem por exemplo teste jpg DESCRICAO campo que permite aos utilizadores identificarem mais facilmente a imagem sendo preenchido por um titulo ou resumo da imagem URL localiza o da imagem no servidor ter de ser passada para o m dulo WYSIWYG atrav s de um protocolo http HELP ONLINE ID chave estrangeira da tabela HELP ONLINE indicando a que projecto est associada e DOC ID identifica o da imagem na referente ao AX til para garantir a integra o de dados getImages Nome getImages Inputs Help_online_id criterio Outputs outputs NOME DESCRICAO url size status Depend ncias N A Descri o Servi o que dado um identificador de projecto e um crit rio devolve uma lista das imagens existentes na tabela IMAGENS REFDATA cujo nome do ficheiro satisfaz o crit rio passado como input Os campos de cada imagem que s o devolvidos s o o NOME FICHEIRO nome do file referente imagem por exemplo teste jpg a DESCRICAO campo que permite aos utilizadores identificarem mais facilmente a imagem sendo preenchido por um titulo ou resumo da imagem e o url localiza o da imagem no servidor ba
40. Online no menu de uma determinada aplica o Este acesso j foi explicado anteriormente neste documento no Acesso ao Help Online BackOffice O Ecr Gest o do Help Online est dividido em tr s componentes Gest o de Conte dos Gest o de L nguas e Gest o de Imagens O primeiro componente do Ecr Gest o de T picos de Ajuda corresponde a uma rvore de conte dos onde constam todos os t picos de ajuda da aplica o em que poss vel editar o seu conte do A estrutura desta rvore gerida por um role de administra o que utiliza uma interface exclusiva que permite adicionar projectos e editar as respectivas rvores de t picos de ajuda explicado anteriormente A rvore criada para cada projecto dever representar com fiabilidade o Flow de ecr s da aplica o Cada elemento da rvore poder ser editado bastando para isso clicar no t pico de ajuda que se pretende alterar Automaticamente o utilizador encaminhado para o Ecr Editar T pico de Ajuda que ser posteriormente descrito detalhadamente 66 O segundo componente deste ecr permite efectuar a Gest o de L nguas associadas ao projecto possibilitando ao t cnico adicionar novas l nguas aos projectos Na pr tica o t cnico ao adicionar uma nova l ngua ir duplicar a rvore de t picos existente mas para cada t tulo do t pico de ajuda ser adicionado a abreviatura da l ngua al m do seu conte do ser totalmente limpo Por exemplo se um proje
41. SENVOLVIMENTO o 0 0 0 0 O Il Estudo de Il An lises Il Desenho ll Desenvolvimento Implementa o li Suporte Viabilidade e Testes e Aceita o Pos Implementa ao Manuten o li METODOLOGIA DE GEST O DO PROJECTO GPI GPS Q E 1 PROCESSOS DE SUPORTE lano de Plano de Plano de Plano de gest o Plano de Plano de Elabora o dos Planos de Suporte qualidade riscos comunica o da configura o organiza o aprovisionamentos GPF s Fig 3 Metodologia de Desenvolvimento 2 4 1 Estudo de viabilidade do sistema EVS O objectivo desta etapa analisar um conjunto concreto de necessidades econ micas t cnicas legais e operativas com a ideia de propor uma solu o a curto prazo sendo ela respons vel pela Avalia o do tempo e recursos necess rios Os resultados do Estudo de Viabilidade do Sistema constituir o a base para tomar a decis o de seguir em frente ou de abandonar 21 Este processo considerado importante embora o n vel de profundidade dependa de cada caso Como o sistema de Help Online foi um pedido feito directamente pelo Cliente e visto j existir um sistema base esta fase foi constitu da por reuni es para propor a solu o 2 4 2 An lise do sistema de informa o ASI O prop sito desta etapa conseguir a especifica o detalhada do Sistema de Informa o atrav s de um cat logo de requisitos e de uma s rie de modelos que cubram as necessida
42. UNIVERSIDADE DE LISBOA Faculdade de Ci ncias Departamento de Inform tica SISTEMA DE AJUDA CONTEXTUALIZADA ONLINE Steve Michael Pereira Fernandes MESTRADO EM ENGENHARIA INFORM TICA Sistemas de informa o 2011 UNIVERSIDADE DE LISBOA Faculdade de Ci ncias Departamento de Inform tica SISTEMA DE AJUDA CONTEXTUALIZADA ONLINE Steve Michael Pereira Fernandes EST GIO Trabalho orientado pelo Prof Doutor Pedro Alexandre de Mour o Antunes e co orientado por Eng Jos Pedro Pereira Cardoso MESTRADO EM ENGENHARIA INFORM TICA Sistemas de Informa o 2011 Agradecimentos minha fam lia e amigos por todo o apoio incondicional prestado durante a minha jornada acad mica Pela preocupa o coopera o e compreens o que sempre demonstraram factores que fizeram de mim a pessoa que sou hoje Sem eles nada disto seria poss vel Faculdade de Ci ncias da Universidade de Lisboa e colegas pelo meu desenvolvimento a n vel t cnico e pessoal permitindo me ganhar asas para encarar sem medo e com confian a a dif cil selva profissional dos nossos dias Indra pelo acolhimento camaradagem e cuidado demonstrado pela minha forma o e bem estar proporcionando me uma adapta o gradual ao mundo do trabalho Pelo misto de valores dos quais n o irei abdicar daqui em diante o meu muito obrigado Gostaria de expressar particularmente os meus sinceros agradecimentos s pessoas que mais directament
43. a de NES CIO sas iges susto asnssgas posp guess aueipen anta pasastadacos 53 dedo Camada de Dados ooien sia iei a aE tic 57 ZSA DE 1 nte rer an reiese a a baa e aoai RR E GS ii 59 3 6 Implementa o e aceita o do sistema IAS ssssssessssssesssessseeressressee 61 Ca piulo 4 Conclus o inernet SCOM ssa can e Saara 73 Capitulo 5 BibhoeraDA cs i325 ocesssasecyattadeceuaaocuysiay A A Aa 75 Capitulo ANEXOS kohosi itene BD n rs ae sted as Pas Doca 11 Lista de Figuras Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig 1 Organigrama Indra Sistemas Portugal e 14 2 Organiza o do sector de Solu es Tecnol gicas cee eeseeeeeeeeeeeneeeeeeees 16 3 Metodologia de Desenvolvimento sais sa cntiecielltnd seielegeaaics 21 4 Metodologias An lise do Sistema de informa o 22 5 Metodologias Desenho do Sistema de informa o 23 6 Metodologias Constru o do Sistema de informa o 24 7 Metodologias Implementa o e aceita o do Sistema de informa o 26 8 Modelo em tr s camadas mais Clientes Web do Webmethods 28 9 Arquitectura do Webmethods asas imnadasa eins o spaqissbitqradaa os ferabafadnd ata 29 10 Interface de desenvolvimento do Webmethods Designer
44. a na tabela IMAGENS REFDATA De forma a garantir a integra o dos dados poss vel passar uma c pia dos bytes da imagem para o servidor AX que por sua vez devolve um docld armazenado igualmente na IMAGENS REFDATA pesqui saPalavraChave Nome pesquisaPalavraChave Inputs criterio projecto id lingua Outputs topicos id titulo antecedente status size 92 Depend ncias N A Descri o Servi o que devolve uma lista de t picos de um determinado projecto e l ngua composta apenas por elementos cujo t tulo vai de encontro ao crit rio passado como input neste servi o Este servi o adquire import ncia quando o utilizador efectua uma pesquisa por t pico na view de FrontOffice sendo lhe transmitido um ou mais breadcrumbs sequ ncia de t picos at ser atingindo o t pico que satisfaz o crit rio O servi o getTopicos a par do pesquisaPalavraChave permite satisfazer os m todos respons veis por criar os arrays que o breadcrumbs utiliza removeImage Nome removelmage Inputs GUID docld projecto Outputs status Depend ncias N A Descri o Servi o que dado o GUID de determinada imagem constante na base de dados nomeadamente na tabela IMAGENS REFDATA executa as ac es de delete correspondentes Caso se justifique efectuada uma tentativa de elimina o da imagem do servidor AX respons vel por garantir uma integra o de dados Este servi o despoletado quando em BackOffice pedido para ser
45. ador Ajuda para a rvore Remover projecto Remover T picos de Ajuda na rvore Editar T picos de Ajuda na rvore Fig 16 Caso de Uso Interface de administra o Interface de Gest o Activar T pico Gerir conteudos de t picos de ajuda Desactivar T pico Alterar Conte do T cnico Inserir Imagem Gerir L nguas Adicionar nova Lingua Remover Lingua Carregar imagem Visualizar image Pesquisar imagem Fig 17 Caso de Uso Interface de gestao 42 Interface de utilizador Pesquisar Ajuda Manualmente Pesquisar Ajuda por Palavra chave Aceder directamente a um t pico de ajuda Utilizador Fig 18 Caso de Uso Interface de utilizador Para al m dos diagramas foi tamb m feita uma descri o elaborada de cada caso de uso permitindo assim compreender o fluxo de actividade e interac es entre o utilizador e o sistema Devido ao enorme espa o que a descri o de todos os casos de uso ocuparia s o apenas apresentados alguns exemplos para demonstrar a linha orientadora seguida Caso de Uso Remover projecto Actor Principal Administrador Pr Condi es Tem que existir um projecto P s Condi es O projecto apagado Cen rio Principal 1 O Administrador entra na p gina de administra o 2 Dentro do subgrupo Gest o de Projectos ter que seleccionar o projecto pretendido 3 Clica no bot o Remover Projec
46. ar o t pico que se pretende remover e de seguida utilizar o link Remover T pico de Ajuda De forma a facilitar a associa o entre os links Aluda existentes nos portais dos projectos que utilizam o Help Online e a pr pria estrutura de t picos criada no Ecr de Administra o do Help Online adicionamos a op o de gera o de um relat rio com toda a informa o identificativa dos t picos de ajuda A cria o desse relat rio efectuada atrav s do link Gerar Relat rio que criar um documento em formato pdf onde constar o os IDS t tulos e conte dos de cada t pico de ajuda de um determinado projecto A imagem seguinte exemplifica um relat rio de um projecto HELP ONLINE Detalhes do Projecto Gerado Por Administrator Projecto Em 2011 01 14 10 44 39 Id Titulo Contetido Associado 222 LOGIN 164 246 ALTERAR PASSWORD 190 223 AS MINHAS FARMACIAS 176 245 DADOS PESSOAIS 189 224 LISTA DE FARMACIAS 174 247 PESQUISA DE CONCURSOS 191 248 PESQUISA DE PRECO 192 Fig 33 Help Online Demo Relatorio de resumo do projecto 65 Interface de Gest o BackOffice Lingua PORTUGAL PT Eh Projecto pt EHOGIN AS MINHAS FARMACIAS LISTA DE FARMACIAS 5 Nova Lingua Seleccionar a LANGUAGE REINO UNIDO GB Remover Fig 34 Help Online Demo Interface de Gest o O Ecr Gest o do Help Online acedido atrav s do BackOffice ap s um t cnico clicar na op o Help
47. ca o de Requisitos Software ERS Especifica o do Plano de Testes Defini o do alcance dos Testes Aprova o do AS Apresenta o e Aprova o do AS Tabela 2 Metodologias Tarefas de Analise do Sistema de Informa o 2 4 3 Desenho do sistema de informa o DSI O objectivo do Desenho do Sistema de Informa o DSI obter a defini o da arquitectura do sistema e do ambiente tecnol gico que lhe ir dar suporte junto com a especifica o detalhada dos componentes do sistema de informa o O desenho da arquitectura do sistema depender em grande medida das caracter sticas da instala o requerendo a participa o dos respons veis de SI das Organiza es para as quais se desenvolve o sistema de informa o Defini o m da Arquitectura i doSistema Desenho da Arquitectura de Suporte Desenho de m casos de usolClasses Desenho ModeloFisico de Dados Verifica oe i Aceita o da Arquitectura F doSistema Cria o de A Especifica es de Constru o Desenhode i Migra ese i carga inicial Especifica o t T cnica do Plano F Estabelecimento k de Requisitos de Implementa o Fig 5 Metodologias Desenho do Sistema de informa o Aprova o de A i dos Sistemas q Desenho Seguidamente s o apresentadas as principais tarefas e respectivos Output
48. calhost 5555 webMethods Integra JDBC Adapter SMFERNANDESWT in lt 3 My webMethods Roles x A ligar x OE Eras http localhost8585 meta default wm xt fabricfolder 0000003309 gt B Googie P A 2 Mais Visitados Indra E mail Outro M Gmail Frederico Tom O Sem T tulo Facebook coloca seis ScutVias EB Marcadores EN My webMethods My webMethods Administrator My Profle Help About Logout Administration System Wide Messaging v Analytics m Business Integration v My webMethods w User Management Calendars Management Environments System Information 828 Permissions eae Roles ESTA steal ROLE NAME EDIT E Admin Role E My webMethods Administrators E My webMethods Users TN Administrators E TnPartners E INMws Users E TN Administrative Preferences RRARRRARR E frontOfficeUsers All times BST UTC 1 00 powered by webMethods 7 pm 1536 14 06 2011 Pro Dm HT Fig 11 Interface Web do My Webmethods Server O webMethods Developer uma ferramenta IDE na qual se desenvolvem e testam webservices maioritariamente atrav s da linguagem Flow mas tamb m atrav s de outras linguagens de programa o como Java e C O uso desses webservices assenta no protocolo SOAP 24 que utilizado para troca de informa es estruturadas em sistemas distribu dos recorrendo tamb m a outros protocolos como o caso do RPC ou HTTP O for
49. cliente para este projecto e Ter um sistema que disponibilize ajuda para cada ecr da aplica o e Ter um sistema em que seja poss vel editar a ajuda presente em cada ecr e A ajuda tanto pode ser relativa a um ecr como a um componente desse ecr exemplo bot o e O sistema de ajuda tem que ser ajust vel a todos os projectos desenvolvidos na ferramenta WebMethods e Terno Help Online uma op o de pesquisa sobre uma ajuda Averiguada a grande quantidade e complexidade de ecr s que um projecto pode possuir e descritos os principais objectivos para o projecto podemos afirmar que o Help Online ter os seguintes resultados tang veis e Ganhos de tempo por parte da equipa ao inv s de ocupar tempo ajudando utilizadores ou disponibilizando forma o poder o ocupar o tempo com outras tarefas 20 e Ganhos de tempo por parte do utilizador ao inv s de solicitar ajuda equipa de desenvolvimento poder resolver os problemas por si mesmo e Ganhos para a empresa visto o projecto ser adapt vel a todas as aplica es webMethods 2 4 Metodologia Neste cap tulo descrita a metodologia usada servindo o esquema seguinte para uma visualiza o mais expl cita das actividades que decorrem em simult neo nas Metodologia de Desenvolvimento e de Gest o de Projecto De referir que nem todas as tarefas dentro de cada etapa foram realizadas ajustando assim a metodologia realidade do projecto li METODOLOGIA DE DE
50. cr s do portal da aplica o entenda se Flow como a sequ ncia de ecr s dependentes entre si Poder a qualquer momento clicar no t pico de ajuda desejado abrindo na sec o em baixo o respectivo conte do do t pico A segunda op o chamada de Pesquisa por T pico e permite ao utilizador fazer uma pesquisa sobre algum assunto desejado Dessa forma insere o crit rio de pesquisa sendo devolvidos os caminhos existentes no Flow de ecr s que terminem na palavra ou express o dada pelo utilizador podendo o utilizador utilizar os links devolvidos para abrir por baixo o conte do desse t pico de ajuda O segundo componente do ecr a sec o onde aberto o conte do de um t pico de ajuda quer pelo facto utilizador clicar num dos links devolvidos pela primeira componente quer por o utilizador clicar em 2iuda durante a navega o na aplica o Caso o t pico que pretende consultar esteja desactivado ir aparecer a seguinte mensagem De momento n o existe ajuda dispon vel Poder utilizar o menu de pesquisa 12 Cap tulo 4 Conclus o O est gio foi realizado no mbito da cadeira Projecto de Engenharia Inform tica do Mestrado em Engenharia Inform tica rea de especializa o Sistemas de Informa o da Faculdade de Ci ncias da Universidade de Lisboa e deu origem a um sistema de ajuda contextualizada no qual se consegue editar online os conte dos de ajuda para determinada interface ou componente
51. cto tiver a seguinte rvore de t picos kh Projecto pt EHOGIN AS MINHAS FARMACIAS LISTA DE FARMACIAS Ao adicionarmos uma nova l ngua ao projecto ir ser criada a seguinte rvore kh Projecto FR EHOGIN FR AS MINHAS FARM CIAS FR LISTA DE FARM CIAS FR Ao clicarmos nos novos conte dos FR estes estar o completamente limpos possibilitando ao t cnico escrever o conte do mas agora na l ngua francesa A altera o entre rvores poss vel atrav s da dropdown L ngua existente na Gest o de Conte dos deste ecr e que possibilita a escolha entre uma das l nguas previamente adicionadas O terceiro componente deste ecr corresponde Gest o de Imagens Nesta rea o t cnico poder carregar novas imagens para serem usadas em t picos de ajuda eliminar imagens j existentes e efectuar pesquisas por imagens j inseridas Para carregar uma nova imagem o t cnico ter de clicar no link saarimsaem que despoletar o seguinte popup CARREGAR IMAGEM Caminho Procurar Descri o Fig 35 Help Online Demo Popup de carregamento de Imagens Neste popup o utilizador poder indicar o local onde se encontra a imagem que pretende carregar e atribuir lhe uma descri o que permitir identifica la mais facilmente Ap s o t cnico clicar no bot o iss adicionada uma refer ncia na 67 base de dados e a imagem carregada para o servidor passando a estar dispon vel para ser a
52. da a estrutura gen rica e mais usual dos servidores que comp em a suite webMethods e tamb m a forma como se encontram interligados e como comunicam 28 Cliente AS JDBC JDBC Base de dados Aplicacional Base de dados webMethods Fig 9 Arquitectura do Webmethods 2 5 1 1 Principais Ferramentas da Plataforma O webMethods Designer uma ferramenta de desenvolvimento gr fico que teve por base o Eclipse e que possibilita a constru o de interfaces aplica es portlet usando a tecnologia CAF que permite a constru o das ditas portlets tendo acesso a dados provenientes de v rios sistemas independentes A constru o de varias portlets usando esta ferramenta comp em uma aplica o final que correr num servidor especifico o MyWebMethods Server A tecnologia CAF considerada uma extens o da tecnologia JSF 22 23 tecnologia que permite a implementa o de ecr s em XML para posteriormente serem interpretados em HTML que por sua vez um Framework MVC para o desenvolvimento de aplica es Web visuais onde a constru o da interface feita numa zona de edi o para a qual se arrastam as diferentes componentes visuais disponibilizadas Alguns dos controlos CAF recorrem tecnologia Ajax permitindo uma interac o ass ncrona com o servidor Para al m de componentes gr ficas no webMethods Designer tamb m faculta a modela o de processos e tarefas 29 A publica o dos ecr s e dos p
53. dela O trabalho iniciou se com integra o na empresa e posteriormente procedeu se integra o no cliente projecto De seguida realizou se a an lise de documenta o existente de modo a compreender o neg cio assim como a tecnologia a ser usada A solu o foi ent o desenvolvida na plataforma webMethods utilizando a arquitectura SOA tendo o Help Online permitido de forma lata o seguinte e Disponibilizar ajuda para cada ecr da aplica o ou componente do mesmo podendo esta ajuda ser editada online e sendo fornecido ao utilizador uma ferramenta de pesquisa de ajuda e Criar um sistema de Ajuda para a maioria das aplica es desenvolvidas em webMethods As vantagens deste projecto residiram essencialmente nos ganhos de tempo por parte do utilizador na procura de uma solu o para o seu problema pontual na aplica o e tamb m nos ganhos para a empresa visto o sistema ser adapt vel a todos as aplica es em webMethods Durante todo o est gio o aluno desenvolveu v rias capacidades na vertente t cnica funcional e at mesmo na gest o de actividades Tecnicamente consegui grande evolu o na utiliza o do webMethods apesar de saber inicialmente que a curva de aprendizagem seria bastante longa visto ser uma tecnologia dif cil onde praticamente n o existe documenta o Visto estar presente em todo o processo de desenvolvimento 73 do sistema foi poss vel rever e aplicar muitos dos conhecimentos adquiridos na fac
54. des de informa o dos utilizadores para os quais se desenvolver o sistema de informa o Neste processo inicia se tamb m a especifica o do Plano de Testes que se completar no processo Desenho do Sistema de Informa o DSI An lise do Sistema AS lt Estabelecimento q dos Requisitos 4 i Funcionaise Tecnol gicos Defini o E d lo Sistema Identifica o dos Subsistemas de An lise An lise de casos de usolClasses Defini o de Interfases de Usu rio Fig 4 Metodologias An lise do Sistema de informa o As principais tarefas a realizar de acordo com o diagrama acima e enquadrados no contexto do projecto poder o ser Actividades Outputs Tarefa Defini o do sistema Cat logo de requisitos Determinar o alcance do gerais sistema e utilizadores finais Identifica o de Requisitos Cat logo de requisitos Obten o e an lise de Funcionais e n o Funcionais modelo funcional Requisitos Identifica o de Subsistemas de Determina o e integra o de An lise subsistemas de an lise 22 Actividades Outputs Tarefa Defini o de Interfaces de Utilizador modelo funcional Especifica o de Princ pios Gerais do Interface An lise de Consist ncia e Especifica o de Requisitos Especifica o de Requisitos Software Especifica o e analise dos modelos Elabora o da Especifi
55. dicionada no editor de texto do Ecr Editar T pico de Ajuda Cada linha da tabela que lista as imagens inerentes ao projecto tem duas op es Visualizar e Remover Se o t cnico clicar em susiza despoletada uma nova janela contendo a imagem que o t cnico pretende pr visualizar Esta nova janela permite ao t cnico visualizar a imagem facilitando a sua identifica o Uma funcionalidade que poder ser pr tica em projectos extensos com um grande n mero de imagens associadas a pesquisa de imagens O t cnico se pretender poder est clicar em Pesquisar Imagem sendo despoletado o seguinte popup PESQUISAR IMAGEM Pesquisar Fig 36 Help Online Demo Popup de Pesquisa de Imagem Neste popup o t cnico poder inserir o crit rio de pesquisa que pretende e 2 posteriormente a clicar no bot o Pesquisar A tabela de imagens actualizada demonstrado apenas as imagens cujo nome do ficheiro vai de encontro ao colocado no crit rio de pesquisa Para a tabela voltar a listar a totalidade das imagens inerentes ao projecto bastar clicar em impar Pesauisa gy ent o voltar a despoletar o popup de pesquisa de imagens e efectuar uma pesquisa sem crit rio 68 Interface de Gest o Edi o dos T picos de Ajuda BackOffice r Informa o TIPO ANTECEDENTES 7 Portlet LOGIN Conte do activo O desactivo Titulo LOGIN v Bz2u EBS ie eel S Fig 37 H
56. e importa referir que todas as funcionalidades planeadas para o Help Online foram totalmente implementadas 37 3 1 1 Calendarizacao Nome Integra t Evento de acolhimento aos novos colaboradores E Integra o no Projecto Integra o na sede do Cliente Leitura de Documentos dos projectos a decorrer E Integra o tecnol gica Forma o Introdut ria webMethods Developer webMethods Designer Tutoriais E Estudo e Visibilidade do Sistema EVS Reuni o Analise das necessidades do Cliente Avalia o do tempo necess rio Realiza o do planeamento Reuni o e Revis o E An lise do Sistema de Informa o ASI Entrevista com stakeholder E Inicio do Documento de An lise Funcional Documento de Requisitos Prot tipo de Baixo n vel Especifica o de ecr s Reuni o para aprova o da An lise E Desenho do Sistema de Informa o Reuni o com coordenador t cnico E Documento de Desenho t cnico Arquitecturas Modelo de Dados Reuni o para aprova o do Desenho t cnico Constru o do Sistema de Informa o CSI Reuni o com o Cliente e Coordenador Reformular DSI e ASI E M dulo de Gest o de Imagens Cria o do CAF relativo a este m dulo Cria o dos servi os relativos Gest o de imagens Upload de imagens para o servidor Adicionar Remover E M dulo rvore de T picos de Ajuda Cria o de servi os Cria ao da Tree em CAF E
57. e JDBC adapters Os adapters que foram criados podem ter um c digo SQL de selec o actualiza o inser o ou elimina o relacionado ou pode invocar um procedimento implementado na camada da Base de Dados Estes adapters s o posteriormente utilizados dentro dos servi os tendo por norma um nome semelhante Total de Adapter Services desenvolvidos 25 54 Transac es J com os Servi os e Adapter Services criados foi necess rio ter em aten o o uso de transac es existindo j servi os pr prios para in cio e fecho de transac es Com uma an lise pr via foram detectados poss veis problemas ao se verificar o uso de muitos adapters de escrita em quase todos os servi os Sendo assim durante a execu o de uma transac o de escrita era poss vel a abertura de outro adapter que escrevesse no mesmo s tio sem que a 1 tivesse terminado Assim enquanto uma transac o aberta n o estiver fechada o acesso a mesma conex o fica bloqueada Foram assim respeitadas as regras ACID 9 que definem uma transac o Passo a citar Atomicidade Ap s a transac o terminar commit ou abort a base de dados n o deve reflectir resultados parciais da transac o Faz tudo ou n o faz nada e Consist ncia Regras de integridade da base de dados s o sempre asseguradas e Isolamento O trabalho feito isoladamente Opera es externas a uma dada transac o n o ir o ver essa transac o em estados intermed
58. e e o projecto correspondem aos passados como input do servi o til para pr visualizar as imagens de um projecto em novas janelas despoletadas pelas views BackOffice e Editar Ajuda 91 insertBDHistory Nome insertBDHistory Inputs BDHelpOnline Documento can nico cujo conte do representa fielmente todos os dados existentes em base de dados na altura em que o servi o corrido Outputs status Depend ncias historyHandler trigger que despoleta ac o atrav s do broker Descri o Servi o que recebe como input um documento can nico que representa fielmente o estado actual da base de dados completa do Help Online e replica a para o schema help online history Esta ac o fica a cargo do broker evitando desta forma que o utilizador tenha que aguardar o t rmino da replica o da base de dados sempre que este servi o seja despoletado O insertBDHistory tem uma ac o preventiva uma vez que sempre que existem altera es no schema principal do Help Online guardada uma c pia integral no schema de hist rico insertImage Nome insertImage Inputs nome descricao url help_id docld fileBytes Outputs status Depend ncias N A Descri o Servi o despoletado quando carregada uma nova imagem para o servidor onde se insere o Help Online Sempre que criada uma nova imagem por File System no servidor necess rio armazenar a sua localiza o na base de dados Essa refer ncia imagem criad
59. e o receptor ser o mesmo o nosso caso o Integration Server mas numa arquitectura de maior dimens o poder fazer a liga o entre diversos Integrations Servers 2 5 2 Arquitectura l gica A imagem abaixo representa a arquitectura l gica que d suporte s aplica es que se desenvolveram Como vis vel existe uma poss vel interac o entre os Utilizadores e uma interface desenvolvida na tecnologia CAF da suite webMethods sendo este processo feito atrav s do MyWebMethods Server Para acesso informa o contida na base de dados aplicacional a camada da User Interface far chamadas a servi os disponibilizados no Integration Server no formato SOAP sobre um canal de comunica o HTTP Os servi os a desenvolver no Integration Server ser o implementados numa de duas formas conforme a complexidade da sua l gica interna 33 Em Flow orienta o da suite WebMethods ser o desenvolvidos os servi os cuja l gica seja simples de implementar Em Java ser o implementados os servi os mais complexos Todos os servi os a desenvolver poder o ficar dispon veis para o Cliente sendo poss vel caso necess rio expor os mesmos a aplica es externas atrav s de webservices Desta forma respeita se a arquitectura SOA e recomenda se a reutiliza o de servi os A persist ncia dos dados aplicacionais ser efectivada com recurso a um esquema Oracle que ser consultado atrav s de servi os implementados no
60. e se envolveram no desenvolvimento deste est gio e Ao Professor Pedro Alexandre de Mour o Antunes pelo acompanhamento acad mico e inspira o fornecida e Rute Sofia Patr cio Arez ao Jos Pedro Pereira Cardoso e Frederico Emanuel Moreira Santos pelo suporte t cnico e organizacional e companheirismo prestado sempre prontos em me auxiliar e encaminhar na direc o certa e Ao Jo o Carlos Seixas Almeida Felisberto e Rui Emanuel Brito De Almeida pelo esp rito de entreajuda e excelente ambiente de trabalho que me proporcionaram Para ti H lio Jonilson Van D nem Filipe Resumo O presente relat rio descreve o trabalho realizado ao longo de um est gio de nove meses no mbito da cadeira Projecto em Engenharia Inform tica bastante usual o utilizador final de uma dada aplica o n o possuir um conhecimento pr vio das suas potencialidades funcionalidades o que por sua vez faz com que seja necess rio fornecer um suporte aplicacional que o vise formar na utiliza o da aplica o O projecto foi realizado na plataforma webMethods e surgiu justamente para colmatar o tempo gasto no suporte aplicacional e forma o dos utilizadores tendo sido a sua base o melhoramento de um sistema de ajuda contextualizada online para utilizadores de uma aplica o na Web que existia actualmente no Cliente Entre os v rios aspectos a melhorar estava o facto de a ajuda fornecida aos utilizadores n o poder ser edit vel o que torna
61. ee 24 2 4 5 Implementa o e aceita o do sistema TAS 25 29 Contexto VeECnOlO RCO ua 27 2 5 1 A Plataforma WebmethodS 2 1 sx cccal soscedst teen sate cdeai seeded eset eens 27 2 5 2 Arguitect ra TOI CA e re a e N ai 33 Did Arg itectura FISICA siso tasas na en a E E aS 35 254 Ferramentas auxiliares as A adiada 36 Cap tulo 3 Trabalho realizados x cesses cosdiis veucses seca da pas dos area ea Nae 37 Sel Gest o de achiVIDAdES sici e eaa a AEA A ERA 37 Sad Calendariza o seatanna a a 38 3 2 Estudo de viabilidade do sistema EVS iii 40 3 3 An lise do sistema de informa o ASI ceeceeeeseeeesreeeeeeeeceeeeeenteeeesaes 41 3 3 1 Requisitos Funcionais Sreroguad osessassucsdeessdeesacanecomacs ocd echdeeedeaasturta nencden 41 3 3 2 Diagramas Caso de USO sasesiguas asas igar am atos adia gude god guess stiess 42 3 3 3 Requisitos N o PUnciOMaiss cicsisseieagsasiactuscagentasdedecesasadeeessecsaccedaaacten 44 3 3 4 Especifica o de CTA seu dieses cies nsc ro ata Ga da SAS Las Eanes arg eats 45 3 4 Desenho do sistema de informa o DSI 47 3 4 1 Modelo Relacional 6 e eererererererereneaerenenea 47 3 4 2 Exemplo de Descri o de Servi o 47 3 5 Constru o do sistema de informa o CSD ue eee eeeeceeeeeeeeeeeeeeeteeeeeaes 49 3 5 1 Camada de Apresenta o si 5 cas uso gato quad anita a sued asa aga dna GRE aaa 50 3 5 2 Camada de L gic
62. elete na tabela TOPICOS AJUDA s o igualmente eliminadas informa es da tabela ANTECEDENCIAS e TOPICO AJUDA TITULO No caso do conte do do t pico de ajuda que se pretende eliminar n o estar associado a mais nenhum t pico ent o neste caso efectuada uma ac o de delete na tabela T PICO AJUDA CONTEUDO Para os casos particulares em que o t pico que se pretende eliminar possui ramos ou seja ele antecedente de outros t picos ent o a tabela de ANTECEDENCIAS sofre update passando os t picos imediatamente procedentes ao eliminado a ter como antecedente o mesmo do t pico eliminado 94 setEstado Nome setEstado Inputs id loc estado projecto Outputs status Depend ncias N A Descri o Servi o despoletado pela view de Editar Ajuda e que efectua uma actualiza o no estado de um determinado conte do do t pico Na pr tica este servi o permite transmitir para a base de dados as altera es entre activo e desactivo Se o t pico transmitido como activo ent o efectuado um update na tabela TOPICO AJUDA CONTEUDO alterando se o valor disabled para 0 caso o t pico esteja activo este update efectuado com o valor 1 Esta altera o tem consequ ncias imediatas para os utilizadores do portal dado que estes receber o informa es distintas consoante o estado do t pico updateTopico Nome update Topico Inputs id topico id projecto tipo u portlet u elemento u criar novo conteudo id
63. elp Online Demo Ecr Editar T pico de Ajuda ESCOLHA DE IMAGEM Manual Pesquisar GestaoTopicosAjuda png X Imagem Seleccionada Visualizar Nome Gest oTopicos juda png Descri o Imagem para gest o de t picos de ajuda Fig 38 Help Online Demo Popup Escolha Manual de Imagem ESCOLHA DE IMAGEM Manual Pesquisar Gest oTopicos Seleccione a Imagem Imagens NOME 7 DESCRICAO 7 Gest oTopicos juda png Imagem para gest o de t picos de ajuda Imagem Seleccionada Visualizar Nome Gest oTopicos juda png Descri o Imagem para gest o de t picos de ajuda Fig 39 Help Online Demo Popup Escolha De Imagem por Pesquisa 69 O Ecr Editar T pico de Ajuda permite que um t cnico com perfil de gest o do conte do do Help Online edite os t picos de ajuda existentes na rvore de conte dos do Ecr Gest o do Help Online Este ecr despoletado ap s o t cnico no Ecr de Gest o do Help Online escolher na rvore de conte dos o t pico que pretende editar O Ecr Editar T pico de Ajuda composto por dois grupos sendo um dedicado a informa o sobre o t pico em quest o e sendo outro dedicado edi o do seu conte do A sec o de informa o disponibiliza ao utilizador o formato do t pico de ajuda que pode ser uma portlet ou apenas uma componente elemento da portlet assim como a sua localiza o f sica anteced ncias na estrutura da aplica o Na sec
64. entes sistemas da aplica o Os servi os desenvolvidos no IS s o desenvolvidos maioritariamente na linguagem Java ou ent o numa linguagem de programa o gr fica pr pria da suite webMethods denominada Flow A ferramenta de desenvolvimento de servi os fornecida pelo webMethods o webMethods Developer A administra o configura o do IS feita atrav s de uma p gina Web que este disponibiliza 32 http localhost 5555 gt B Googie P A 62E 2 Mais Visitados Indra E mail Outro _ M Gmail Frederico Tom Sem T tulo Facebook coloca seis ScutVias EB Marcadores SMFERNANDESW 7 indra es Integration Server BE Total Sessions 1 Completed Reg s 140 Licensed Sessions o 1 10000 Average Time 2408 ms 2408 ms Service Threads 1 Service Errors 46 System Threads 79 79 Started Ended Uptime 0h 8m 56s Req s per minute 1 min 1 min Memory Total 516608 KB Used 377777 KB 74 TE Free 138831 KB 26 NNE Memory Usage average per hour 518912 KB User Management ACLs Certificates nd P fa Auditing Settings Fig 13 Interface Web do Integration Server O Broker ver Fig 9 o servidor que regista quem publica os documentos e quem os subscreve mantendo um registo dos emissores e receptores e agindo com a fun o de carteiro de documentos com por exemplo o Integration Server Numa arquitectura mais simples o emissor
65. er rquica que tender a corresponder ao fluxo de ecr s da aplica o HO 012 Dever existir uma rea de gest o de imagens onde o gestor poder carregar e eliminar os conte dos ilustrativos que insere nos t picos HO 013 Cada imagem dever conter um campo descri o HO 014 Cada t pico de ajuda tem associados apenas um titulo e um conte do Esses t tulos e conte dos por sua vez podem ser representados em v rias l nguas HO 015 necess rio a cria o de Links para aceder ao Help Online Esses links ser o colocados pela equipa que desenvolve o projecto na interface 81 C digo Requisito Descri o Requisito Depend ncias do portal referente ao projecto HO 016 A rvore de conte dos apresentada utilizando os t tulos dados ao t picos de ajuda HO 017 A cada ecra elemento componente da aplica o s pode estar associado um nico t pico de ajuda HO 018 V rios t picos de ajuda podem ter o mesmo conte do de ajuda HO 019 Um conte do poder estar dispon vel em diversas l nguas HO 020 Uma rvore de conte dos poder ser copiada para uma rvore id ntica noutra l ngua HO 021 Dever ser poss vel desactivar um t pico de ajuda sendo mostrada ao utilizador que tenta aceder a esse t pico uma mensagem a indicar que de momento n o existe ajuda dispon vel mas que poder utilizar as funcionalidades de pesquisa
66. ferta diferencial potenciando o desenvolvimento de solu es pr prias para cada segmento de mercado como por exemplo Administra o P blica e Sa de Transporte e tr fego Finan as e Seguros Energia e Industria Telecomunica es e Media e Defesa A Indra presta servi os que v o desde consultoria desenvolvimento de projectos integra o de sistemas e aplica es at ao outsourcing de sistemas de informa o e de processos de neg cios 13 A oferta de solu es inclui uma ampla gama de sistemas aplica es e componentes para a capta o de dados e informa o o seu tratamento transmiss o e posterior apresenta o basicamente direccionados para o controle e gest o de processos complexos e ou cr ticos De um modo geral as solu es da Indra servem o n cleo de opera o do negocio dos seus clientes e requerem como capacidade essencial a integra o de sistemas isto o desenho configura o desenvolvimento e implementa o de componentes aplica es e sistemas de informa o completos incorporando produtos pr prios e de terceiros OPERA ES PORTUGAL RECURSOS HUMANOS CONTROLO DE GEST O E FINANCEIRA SOLU ES TECNOL GICAS STECM STEBM CONSULTORIA IND STRIA PROD SOFTWARE COM RCIO E SERVI OS Fig 1 Organigrama Indra Sistemas Portugal TRANSPORTES FERROVI RIO VIAL E SERVI OS FINANCEIROS DEFESA SEGURAN A MAR TIMO De seguida
67. i rios e Durabilidade Os efeitos de uma transac o em caso de sucesso commit s o permanentes mesmo em presen a de falhas i 15555 UsemameAd File Edit Session Compose Test Tools Window Help Envio ABs E o gt PAS e Q E gs m _helpOnline pub criarProjecto Lx daa r US tX 2 5 419 E E HeloBPMCorrecto E HelloBPMproc oO MAP E HeloBPMSteve E SEQUENCE TryiCatch E HelpontineFramewiork E try SEQUENCE ae gt pub art transaction startTransaction gt helpOniine pub getBDHelpOniine Stateless False Cache results False Cache expire 15 Reset cache Prefetch False E amp hetponine Prefetch activation 1 docs o Bu D gt adicionarLanguage D gt changeConnectionindividual BP changelmagePath D gt changelmagesPath BP changemageum criar jecto D gt criarTopicosjuda D gt getalLanguages D gt getBDHelponiine D gt getConteudos D gt getDescricao D gt getEstado D getExtendedSettings D gt getimageByNome D gt getimages D gt getimagesForwysiwyg C gt aelproims UDDI Registry Recent Elements FFEERZTE gt helpOniine resources dh adapters criarProjecto EA BRANCH EF local estado 0 SEQUENCE of map E pub art transaction rollbackTransaction EF local estado 1 SEQUENCE of map Eb pub flowtracePipeline gt pub art transaction commit Transaction gt pub publish publish E catch SEQUENCE gt pub art transaction rollbackT
68. ica o Neste ambiente era poss vel montar o nosso Help Online sobre um projecto do cliente O Ambiente de testes replicava o que existia no ambiente de desenvolvimento com a vantagem dos dados provenientes da BD serem mais coerentes Este servidor era usado maioritariamente pela equipa funcional De seguida elaborada uma explica o das ferramentas segundo o modelo de tr s camadas 7 Camada de Apresenta o Camada de L gica de Neg cio Camada de Dados Por fim descrita a fase de testes e qualidade do sistema Help Online passando pela realiza o dos mesmos e finalizando na avalia o dos resultados obtidos 49 3 5 1 Camada de Apresenta o Para o desenvolvimento da camada de apresenta o foi usada a ferramenta Webmethods Designer a qual me permitiu criar as interfaces Fig 19 fazendo essencialmente drag and drop das v rias componentes presentes na palete da aplica o Grande parte do c digo Java por tr s da interface gerado automaticamente pela aplica o embora seja necess ria a cria o de v rios m todos auxiliares Foram estas as minhas maiores preocupa es 8 durante a constru o das interfaces Consist ncia Visto as componentes da interface serem j predefinidas pela ferramenta de desenvolvimento esta caracter stica n o requereu grandes preocupa es Feedback informativo Todas as ac es a serem realizadas pelo utilizador possuem uma resposta do sistema
69. ira de implementa o evita a substitui o n o intencionada de valores de alguma vari vel durante a constru o do servi o pois comum existirem vari veis com o mesmo nome que ficam na pipeline durante a execu o de um servi o coberta assim uma potencial fonte de erros j previamente conhecidos na plataforma webMethods Na maioria dos servi os desenvolvidos existe uma vari vel status como output Essa vari vel preenchida com um de dois valores ok e fail Nas situa es em que o status devolvido com ok indicado que o servi o correu todos passos correctamente caso contr rio devolvido fail Este status particularmente importante dado que despoleta os popups de confirma o das ac es que o utilizador executa no Help Online Relativamente vari vel size comum encontr la em servi os que possuem no output listas O size tal como o status permite verificar se tudo correu como pretendido dado que determinados servi os dever o sempre devolver listas preenchidas com um determinado n mero de valores Caso o valor do size seja incoerente este poder despoletar uma mensagem de erro tal como o status efectua Total de Servi os desenvolvidos 34 Adapter Services Nesta mesma camada e usando a mesma ferramenta foram tamb m constru dos v rios Adapter Services Como j foi explicado no contexto tecnol gico o Integration Server comunica com a camada da Base de Dados atrav s d
70. isito Descri o do requisito em quest o e Depend ncias Uma ou mais depend ncias a requisitos anteriores De seguida s o mostrados alguns exemplos ficando a lista com todos os requisitos funcionais em anexo C digo Requisito Descri o Requisito Depend ncias HO 001 ae a informa o organizada em t picos de Os t picos de ajuda dever o ter a possibilidade de HO 004 ser editados por um t cnico que apresente um perfil adequado O utilizador a editar um t pico de ajuda apenas HO 008 p a 5 7 poder modificar o seu t tulo estado e conte do Cada t pico de ajuda tem associados apenas um HO_014 titulo e um conte do Esses t tulos e conte dos por sua vez podem ser representados em v rias l nguas Tabela 6 Exemplo de Requisitos Funcionais na estrutura do documento N mero Total de Requisitos Funcionais 27 41 3 3 2 Diagramas Caso de Uso A metodologia usada pela empresa n o implicou a cria o dos diagramas de caso de uso sendo este trabalho feito por vontade pr pria e porque a experi ncia acad mica assim o indicou Foram criados de forma a descrever elaboradamente os Casos de Uso com o objectivo de refinar a an lise de requisitos funcionais da aplica o Help Online As Figura 16 17 e 18 representam os diagramas de Casos de Uso e demonstram as interac es dos v rios utilizadores com o sistema Interface de Administra o Adicionar projecto Criar T picos de Administr
71. l e arrasta lo para uma posi o diferente ou sobre um outro objecto virtual Pipeline Mem ria tempor ria interna do servidor onde s o guardados valores tempor rios criados durante a execu o de servi os ou outras componentes Java Database Connectivity JDBC Defini o utilizada em Java acerca de como que o acesso base de dados efectuado Structured Query Language Linguagem de pesquisa declarativa utilizada em bases de dados SQL relacionais ACID ACID um conceito utilizado para caracterizar uma transac o Refere se ideia de fazer permanentes um conjunto de mudan as Commit experimentais 79 E a denomina o em ingl s para a pr tica de escrever palavras 2 Camelease compostas ou frases onde cada palavra iniciada com Mai sculas e unidas sem espa os 20 Conjunto de comandos em SQL Encapsula tarefas repetitivas aceita Stored procedure A P par metros de entrada e retorna um valor de status O popup uma janela extra que se abre no browser ao visitar uma p gina Popup web ou aceder a uma hiperliga o espec fica 80 C digo Requisito Requisitos Funcionais Descri o Requisito Depend ncias HO 001 O Help Online uma aplica o gestora da informa o de ajuda que disponibilizada aos utilizadores externos das aplica es HO 002 Toda a informa o organizada em t picos de ajuda
72. ma o 23 Tabela 3 Metodologias Tarefas de Desenho do Sistema de Informa o 24 Tabela 4 Metodologias Tarefas de Constru o do Sistema de Informa o 25 Tabela 5 Metodologias Tarefas de IAS do Sistema de Informa o 26 Tabela 6 Exemplo de Requisitos Funcionais na estrutura do documento 41 Tabela 7 Exemplo de descri o de Caso de Uso 43 Tabela 8 Exemplo de descri o de Caso de Uso 44 Tabela 9 Exemplos de Requisitos N o Funcionais na estrutura do documento 44 Tabela 10 Exemplo de especifica o de um ecr 46 Tabela 11 Exemplo de Descri o do servi o criarProjecto s 48 Tabela 12 Exemplo de Descri o do servi o criarTopicoAjuda 48 Tabela 13 Exemplo de C digo escrito em Java a 52 Tabela 14 Stored Procedure Specification Sps ssssesesssesssesessseessresserssesesssessee 57 Tabela 15 Stored Procedure Body spb siscsssssvccricevetcacersascesactoveaseaysccsevethedansesoess 58 10 Lista de Acr nimos Acr nimo Extenso Ajax Asynchronous Javascript and XML BD Base de Dados BPM Business Process Management CAF Composite ApplicationFramework GUI Graphical User Interface HTTP Hypertext Transfer Protocol I D Investiga o Desenvolvimento IDE Integrated Development Environment IS Integration Server JDBC Java Database Connectivity JSF Java Server Faces MWS MyWebMethods
73. mato das mensagens trocadas atrav s do protocolo SOAP baseado em XML garantindo assim a circula o de dados entre sistemas numa linguagem normalizada O Flow uma linguagem de programa o visual onde diferentes componentes que simbolizam c digo de programa o ou mapeamento de vari veis podem ser arrastados formando uma sequencia l gica para realizar determinada tarefa 31 Por sua vez o Integration Server ver Fig 13 disponibiliza uma interface que permite a configura o de v rias componentes que fazem parte do servidor componentes essas que podem ser pacotes onde s o guardados webservices p e scheduler conex es entre outros Gi localhost5555 Usemame Adminis ve Tot T File Edit Session Compose Test Tools Window Help Ginew 7 F FF EETA EXE ma EO navigation Sis a e HeloBPMSteve E HelpOntineFramework HelponiineFrameworkConnections UDI Registry Recent Elements SRoavwm x A lek ok a a Fig 12 Interface de desenvolvimento do Webmethods Developer O Integration Server o servidor aplicacional que nos permite integrar os servi os que ir o compor o nosso sistema sendo tamb m ele respons vel por executar toda a l gica de neg cio necess ria ao processamento dos diversos pedidos um servidor baseado em Java e entre os diversos servi os que suporta encontram se o mapeamento de dados entre diferentes formatos e a comunica o entre os difer
74. ne dever elucidar o gestor que a rvore de conte dos corresponde s sequ ncias de ecr s HF NF 004 As funcionalidades menos intelig veis dever o estar associadas a estruturas e diagramas que as simplifiquem como toggle trees e breadcrumbs HF_NF_005 O Help Online dever ser uma funcionalidade din mica tendo capacidade de ser adaptada a distintas estruturas aplicacionais HF_NF_006 A gest o de conte dos do Help Online n o dever requerer qualquer tipo de desenvolvimento program tico O sistema de Help Online dever por esta raz o ser aut nomo e o mais personaliz vel poss vel 83 Servi os Neste ponto ser o descritas as fun es de cada servi o existente no package HelpOnlineFramework no servidor IS Para cada servi o ir o ser indicados os inputs e os outputs e que ac es efectuam ao n vel da base de dados adicionarLanguage Nome adicionarLanguage Inputs Loc user default loc projecto Outputs status Depend ncias N A Descri o Adiciona uma nova l ngua ao projecto que passado como input Na pr tica replica a estrutura de t picos de ajuda existente para a default language no entanto os novos conte dos criados estar o a null e os t tulos ser o preenchidos com os da default language seguidos do alpha2code da nova l ngua changeImagesPath Nome changeImagesPath Inputs id projecto novo path Outputs status Depend ncias
75. ne month internship for Computer Engineering Project Discipline It is quite usual that an end user of a given application does not have a prior knowledge of its capabilities features so it is necessary to provide an application support to train him in the use of the application The project was made at the webMethods platform with the purpose of filling the time spent on the application support and user training This was based on an improvement of an online help system for web application users that currently existed in the Client Among the different points that needed an improvement was the fact that the Help content provided to the users could not be editable which made the system easily too static and outdated After performing the Analysis Design and Construction steps it was reached a system in which help content was editable online Each one of the contents was named as a Help Topic and it was part of a tree Help Topic Tree representing the possible navigation within the web application Thus it was possible to perform an additional search system where the result was the pathway from the web application root to the node with a help content that match the search key The system has three types of users Administrator Technical and User each one having specific functions and having access to different interfaces The Administrator and Technical profile implies access to the Back office interfaces where one can manage multiple project
76. novo conteudo desc novo conteudo titulo u id novo antecedente updated by Outputs status Depend ncias N A Descri o Servi o despoletado pela view de Administra o permitindo efectuar altera es estrutura dos t picos de ajuda de um determinado projecto Atrav s deste servi o poss vel modelar todo um projecto desde os t tulos dos t picos at rvore de aplica o t tulos conte dos e toda a restante informa o inerente a um determinado t pico Os factos menos intuitivos deste servi o prendem se com os problemas levantados por conte dos associados anteced ncias e l nguas Se um t pico for actualizado sendo indicado que este passar a ter um novo conte do ent o caso o antigo conte do associado deixe de ter t picos associados automaticamente eliminado Este procedimento evita a exist ncia de uma gest o complexa de conte dos Relativamente s anteced ncias este servi o comporta se da mesma forma que o removerTopicos ou seja nos casos particulares em que o t pico que se pretende alterar a anteced ncia possui ramos situa es em que ele pr prio antecedente de outros t picos ent o os t picos imediatamente procedentes ao alterado passam a ter como antecedente o antigo antecedente do t pico 95 alterado Por fim se qualquer elemento estrutural do t pico de ajuda alterado essas altera es repercutem se ao n vel de todas as l nguas activas do projecto por exemplo se alterar alg
77. ntes a um determinado projecto e lingua S o indicados os campos GUID RULE ID neste resultado representa um g nero de um titulo do conte do e CONTEUDO c digo HTML que ir representar o conte do a apresentar no portal quando um utilizador pretende visualizar o t pico de ajuda getDescricao Nome getDescricao Inputs nome projecto Outputs descricao status Depend ncias N A 86 Descri o Servi o que dado o nome de uma imagem e o id do projecto em que se insere devolve a sua descri o Ele acede tabela IMAGENS REFDATA na base de dados getEstado Nome getEstado Inputs id loc projecto Outputs disabled status Depend ncias N A Descri o Servi o que vai tabela TOPICO AJUDA CONTEUDO e verifica se um determinado conte dos est activo ou desactivo Se o output disabled vier preenchido a O ent o est desactivado se vier preenchido a 1 ent o o conte do est activo getExtendedSettings Nome getEstado Inputs path1 path2 Outputs result1 result2 Depend ncias N A Descri o Servi o vai as extended settings do servidor IS e preenche os outputs com os valores obtidos pelas properties passadas pelos pathl e path2 Normalmente as properties utilizadas pelo projecto Help Online s o watt server cliente helponline images1 e watt server cliente helponline images2 getImageByNome Nome getlmageByNome Inputs nome projecto Outputs results GUID NOME FICHE
78. numa p gina pr pria Modificar a mensagem no caso do conte do estar desactivado Conte do inactivo por default Modificar a pesquisa por palavra chave Upload de imagens para servidor http Criar um Hist rico para o Help Online Actualiza o de ASI e DSI Testes Relat rio Preliminar El Implementa o e Aceita o do Sistema IAS Manual de Instala o Cria o dos Links de acesso Help Online gt Projecto Cria o dos Conte dos de ajuda do Projecto Actualiza o de documentos Semana de forma o IBM Infosphere Relat rio Final 39 1d 10d 1d 1d 1d 2d 2d 1d 15d 15d 18d 4d 3d 7d 4d 5d 45d 30 11 2010 01 12 2010 02 12 2010 03 12 2010 03 12 2010 06 12 2010 07 12 2010 07 12 2010 08 12 2010 10 12 2010 13 12 2010 13 12 2010 14 12 2010 28 12 2010 29 12 2010 30 12 2010 05 01 2011 05 01 2011 06 01 2011 07 01 2011 10 01 2011 12 01 2011 13 01 2011 14 01 2011 17 01 2011 18 01 2011 19 01 2011 20 01 2011 03 02 2011 04 02 2011 07 02 2011 08 02 2011 10 02 2011 14 02 2011 15 02 2011 15 02 2011 08 03 2011 08 03 2011 14 03 2011 17 03 2011 28 03 2011 01 04 2011 08 04 2011 30 11 2010 01 12 2010 02 12 2010 06 12 2010 03 12 2010 06 12 2010 10 12 2010 07 12 2010 09 12 2010 10 12 2010 13 12 2010 13 12 2010 27 12 2010 28 12 2010 29 12 2010 04 01 2011 14 02 2011 05 01 2011 06 01 2011 07 01 2011 11 01 2011 12 01 2011 13 01 2011 14 01 2011 17 01 2011 18 01 2
79. o til na medida em que poder o ser criados diversos Help Online cada um associado a aplica es distintas existindo desta forma t picos conte dos e anteced ncias tamb m distintas 89 getProjects Nome getProjects Inputs N A Outputs Project id projecto descricao status Depend ncias N A Descri o Servi o que devolve uma lista preenchida com todos os projectos existentes em base de dados na tabela HELP ONLINE getTopicoAEditar Nome getTopicoA Editar Inputs projecto id topico id lingua Outputs titulo id titulo tipo portlet elemento conte do conte do id antecedente antecedente id status Depend ncias N A Descri o Servi o que devolve toda a informa o indicada como output deste servi o relativamente a um determinado t pico de ajuda Esta informa o revela se indispens vel para preencher os dados de um t pico de ajuda quando este est a ser editado na interface de Administra o getTopicoAjudaEditar Nome getTopicoAjudaEditar Inputs projecto id id topico lingua Outputs dados topico id t tulo tipo portlet elemento antecedente conteudo status Depend ncias N A Descri o Este servi o devolve o t pico de ajuda cujo projecto a l ngua e o id correspondem ao inserido como input Os campos de output deste servi o s o preenchidos com dados recolhidos das tabelas TOPICOS AJUDA TOPICO AJUDA CONTEUDO e TOPICO AJUDA TITULO Este servi o exec
80. o grande parte do c digo feito na camada de dados Como estavam os dois enquadrados na mesma tecnologia e a realizar tarefas semelhantes cada um identificou erros do outro e Testes unit rios para cada servi o verificando se est de acordo com a sua especifica o de input e output Nesta fase o campo status falado anteriormente foi nos bastante til e Testes unit rios a cada componente das interfaces Foi feito segundo uma bateria de testes concebida pela equipa funcional pois possuem uma lista pr concebida para problemas que acontecem a maior parte das vezes no desenvolvimento em webMethods Adicionalmente foi criado um diagrama Fig 24 para definir as rela es existentes entre os requisitos identificados inicialmente e as capacidades do produto desenvolvido assim como a prioridade tida em conta no seu cumprimento O seu objectivo foi facilitar o tracing desde os requisitos at a um n vel mais baixo que neste caso diz respeito ao produto final desenvolvido A Rela o Requisito Interface representa a import ncia que o requisito tem na interface e Forte o requisito vis vel e M dia o requisito vis vel indirectamente e Fraca o requisito suposto 59 A Correla o interfaces pretende demonstrar como as interfaces se afectam entre si e onde o funcionamento de uma depende directamente da outra e onde o funcionamento de uma depende da outra mas a depend ncia n o directa
81. oftware AG 2007 27 webMethods Broker Administrator s Guide Version 7 1 Darmstadt Germany Software AG 2007 28 webMethods Process Engine User s Guide 7 1 1 Darmstadt Germany Software AG 2007 29 webMethods Task Engine User s Guide Version 7 1 1 Darmstadt Germany Software AG 2007 30 webMethods Designer Process Development Help Version 7 1 1 Darmstadt Germany Software AG 2008 31 http en wikipedia org wiki Software peer review 15 08 2011 76 Cap tulo 6 Anexos Gloss rio Soft skills As soft skills representam as atitudes e comportamentos das pessoas em interac o com outras S o atitudes comportamentais por natureza e desenvolvem se atrav s da pr tica em situa es de trabalho reais Webmethods empresa Empresa especializada em ferramentas de integra o fundada por Phillip Merrick em 1997 Adquirida pela Software AG em 2007 Um WebServise pode definir se como um m dulo de uma aplica o Webservices acess vel via Web e que fornece para o exterior uma funcionalidade ou servi o de forma a poder ser usado por um cliente 21 uma ferramenta baseada no Eclipse e que pertencente suite de webMethods WebMethods Designer f Permite o desenvolvimento de componentes gr ficas atrav s da tecnologia CAF e a modelagem de processos BPM Ferramenta de desenvolvimento pertencente suite de webMethods que WebMethods Developer permite o desenvolvimen
82. orrespondente na rvore de conte dos e de seguida pressionar Editar T pico de Ajuda despoletado um popup igual ao que aparece quando se clica em Criar Novo T pico de Ajuda no entanto os campos v m totalmente preenchidos com os dados do t pico As imagens abaixo demonstrar o um exemplo do popup de edi o T PICO DE AJUDA AS MINHAS FARM CIAS Identifica o Conte do Anteced ncia Identifica o do T pico Projecto T tulo AS MINHAS FARM CIAS Tipo fg Portlet Elemento Portlet Fig 30 Help Online Demo Popup de Edi o de T picos de ajuda tab 1 T PICO DE AJUDA AS MINHAS FARM CIAS Identifica o Conte do Anteced ncia Conte do Conte do Criar Novo Associar Existente Conte do Seleccionado Conte do das minhas farm cias CONTE DOS 7 Conte do de Login Conte do da lista de farm cias Conte do das minhas farm cias Fig 31 Help Online Demo Popup de Edi o de T picos de ajuda tab 2 64 T PICO DE AJUDA AS MINHAS FARM CIAS Identifica o Conte do T pico Antecedente gt gt gt gt gt gt gt T pico Antecedente Seleccionado LOGIN kh Projecto pt EHOGIN AS MINHAS FARM CIAS LISTA DE FARM CIAS Fig 32 Help Online Demo Popup de Edi o de T picos de ajuda tab 3 Os t picos de ajuda de um projecto podem ser removidos Para efectuar tal ac o necess rio seleccion
83. principal foco sobre situa es que levam o utilizador a ficar com d vidas sobre o que est ou o que deve fazer substituindo assim o 19 Suporte que muitas das vezes se resumia a uma simples indecis o do utilizador sobre uma funcionalidade de um ecr Embora existisse um antigo sistema de Ajuda Online esse sistema representava uma solu o n o gen rica e que n o se adaptava aos v rios projectos a serem desenvolvidos n o indo assim de encontro aos objectivos do Cliente explicados no ponto seguinte No sistema antigo eram fornecidos manuais de utiliza o previamente concebidos por uma equipa funcional para cada p gina de uma aplica o web por exemplo atrav s de um link de ajuda dispon vel despoletando assim o respectivo download do documento para posterior leitura por parte do utilizador Entre v rias limita es identificadas 4 5 estava o facto de o utilizador ter que sair da aplica o para abrir o documento 2 3 Objectivos Operacionais O objectivo principal que seria fornecer ajuda contextualizada para a aplica o j estava impl cito mas de facto o que o cliente pretendia era algo diferente dando assim origem lista de requisitos proveniente das reuni es onde se discutiram os pr s e contra do Sistema antigo fornecendo ao mesmo tempo ideias inovadoras para o que viria a ser o novo sistema de Help Online De seguida s o mostrados os principais requisitos que acabam por definir o objectivo do
84. ransaction pub flow getLastError of MAP cleanup Execution locale E Retry on ISRuntimeE Max attempts o Retry interval o E Universal name Namespace name Local name E Audit Enable auditing Never Log on Error oniy Input Output Pipeline Comments mir X 2 3 4114 Specification Reference Input E output e B inputs TLA 15 33 ik ja 4 04 07 2011 Se hh DE ES ee Fig 22 Exemplo do Servi o inserir TemplDespacho no Developer 53 File Edit Session Compose Test Tools Window Help WM RECTA EE ie o criarProjecto Properties a E adapters Reset cache adicionar anguage K criar ntecedencia Adapter Connection Name _helpOnlineFrameWork repository resources db connectHELPONLINEJdbcReadWirite Prefetoh activation 5 criarConteudo Adapter Service Template com wm adapter wmjdbc services StoredProcedureWithSigneture G criarProjecto R cristTtuio Namespace name Q criarTopicoAjuda Local name K criarTopicoExistente E Audit K criarTopicoNovo Enable auditing Never eiminarimagem Logon Error only getConteudos Include pipeline Never E getConteudosByProject E Permissions GF getDescricao List ACL Default inherit getEstado K getisPrimeiroTopico GF getimageByNome G getimages K getimagesForysiwyg getLanguages K getProjeciName K getProjects GF getTableantecedencias G
85. removida uma imagem tendo esta que ser eliminada n o s por File System na pasta do servidor mas tamb m a sua refer ncia na base de dados e no AX removerLanguage Nome removerLanguage Inputs loc projecto Outputs status Depend ncias N A Descri o Servi o despoletado na view BackOffice ap s um t cnico indicar a remo o de uma l ngua activa Este servi o recebe o identificador do projecto sobre o qual vai efectuar a ac o e a l ngua a remover Ao ser despoletado remove da base de dados todos os valores referentes a essa l ngua Ffectua assim uma ac o de delete nas tabelas 93 TOPICOS AJUDA TOPICO AJUDA CONTEUDO TOPICO AJUDA TITULO e ANTECEDENCIAS removerPro j ecto Nome removerProjecto Inputs id_projecto Outputs status Depend ncias N A Descri o Servi o despoletado na view de Administra o Este servi o recebe como input o identificador do projecto e remove todos os t picos de ajuda conte dos t tulos e imagens associadas S o efectuadas ac es de delete em todas as tabelas do schema Help Online de forma a que todos os dados inerentes a um determinado projecto sejam totalmente eliminados removeTopi co Nome removeTopico Inputs id topico language id projecto Outputs status Depend ncias N A Descri o Servi o despoletado na view de Administra o que dado os identificadores de um t pico de ajuda remove o da base de dados Al m da ac o de d
86. rocessos incluindo as tarefas humanas para o MyWebMethods Server executado tamb m atrav s no pr prio webMethods Designer TARERE 5 Ea gt 1 Solution Navigat 5 EE Outline D 5 MywebMethods Server Remote 53 1 amp Palette 53 28 leg Diria E A palette is not available PesquisaPedidoPosto a amp ProrrogacaoObras General Information gt Publishing Reclamacao Specify the host name and other common settings RecuperarPassword gt Timeouts amp RegistoUtilzador Server name My webMethods Server Remote gt resources Host name localhost8585 SeleccionarConcurso gt SibrnisesoCurteira olival Runtime Environment My webMethods Server M S WEB INF Open launch configuration x classpath D project Connection Information build xml Specify the connection information Em HeipOniine 5 E Debug Port 5000 B Sav 9 pac X MWS ft Meta O sol helio E oft Meta Publish Timeout seconds 120 BS pE E 03 not connected E Bind E Con Po 3 2D tE Default not connected aS Overview al EE Properties fi Problems 4 Servers 53 Ant os fo ANS operotons to cesptay mt thes tim Server State Status PF My webMethods Preview Server at localhost Eb Stopped 5 My webMethods Server Remote Eb Stopped ne Writable 19 32 14 06 2011 ER D al o Fig 10 Interface de desenvolvimento do Webmethods Designer O MyWebMethods Server um
87. s 23 Actividades Outputs Tarefa Desenho da Arquitectura Desenho Detalhado de Desenho de Subsistemas de Subsistemas Suporte Desenho F sico de Dados Modelo F sico de Desenho do Modelo F sico de Dados Dados MFD Desenho da Migra o e Plano de Migra o e Desenho de Procedimentos e Carregamento Inicial de Dados Carregamento Inicial de Dados componentes de Migra o e Carregamento Inicial Especifica o T cnica do Plano de Testes Doc de Planifica o dos Testes Especifica o do Ambiente de Testes e respectivo plano Estabelecimento de requisitos de Implementa o Requisitos de Implementa o Especifica o de requisitos de implementa o Aprova o do Desenho do sistema Apresenta o e Aprova o do DS Tabela 3 Metodologias Tarefas de Desenho do Sistema de Informa o 2 4 4 Constru o do sistema de informa o CSI A constru o do Sistema de Informa o CSI tem como objectivo final a constru o e teste dos diferentes componentes do sistema de informa o tendo por base o Processo de Desenho do Sistema de Informa o DSI Prepara se o ambiente de constru o cria se o c digo de cada um dos componentes do sistema de informa o e vai se realizando medida que se vai finalizando a constru o os testes unit rios de cada um deles e os de integra o dita p E REN A y k 1 Cs Cria odo
88. s web Applications that would have an Help Online system and it is also possible to make a content management to each help system The user has access to an Front Office interface that provides help to each page and also a web search system Currently the system is running on the client and it is also being used by other companies working on the client Keywords Help Online Content Management Help Search System SOA Webmethods Conte do Capitulo introduchs enn SEA ee ee Sie 13 dE CONERO RR ts acne Socal as RS RR UR DRE o RR O RDNS END E RR E as ee RR 13 1 27 AMPS RTACAG NA ere Sd a yas Ia O aan AE 15 Lod VINES BrACAO NG PIO CIO Suas na aaa ad Ria 16 R4 BIC CIY OS ERA GOD ID a 17 1 5 Organiza o do Documento oc 45 siusscaed ssecaseds soncadedseaeduaidouceeesaumensanseee ne 17 Cap tulo 2 Contexto do projecios ce seca os cscs asec ges ceded stcosae gaia aa 19 2A Vii passada id dai alada 19 Bode IMD SCE ENR SEES SE E a aa 19 2 3 GID ECT VOSPERACIONAIS 31 lt 5 cessecdissiusscged grata Eca AREA RAN Rare 20 ZA VICE ONO SIE POR RR RNP PRE PRESS acdeecd decosac E nc es oc suceneweas esavaoeones 21 2 4 1 Estudo de viabilidade do sistema EVS cccecsessccececeeeeeesenseaeees 21 2 4 2 An lise do sistema de informa o ASD sssssessssessesssesssesrsssressre 22 24 3 Desenho do sistema de informa o DSI eeeeeeeeeeeeeeeeeteeeeeeees 23 2 4 4 Constru o do sistema de informa o CSTD seseeeeesereserererrs
89. sempre realizado atrav s da execu o de stored procedures ao inv s de um acesso mais directo Estas procedures s o necess rios para a interac o entre o IS e os objectos da base de dados e respectivos dados pois a maioria dos Adapter Services criados referenciavam estes procedimentos Nesta camada foram aplicados v rias normativas para nomenclatura dos objectos que mais uma vez teriam que respeitar os nomes dos Adapter Services e dos anteriores servi os que o iriam chamar Por fim de referir que teve que ser criado um script de export da base de dados para passagem a produ o Esse script foi dividido e Script com DDL 10 Data Definition Language Script que permitiu definir as tabelas do Help Online e os elementos associados e Script com DML 10 Data Manipulation Language Script maioritariamente constitu do com inserts necess rios para o bom funcionamento da base de dados Total de Packages 1 PKG HELP ONLINE Total de Procedures 25 create or replace PACKAGE PKG HELP ONLINE AS PROCEDURE PRC SET ESTADO GD TOPICO IN varchar2 LOC IN varchar2 ESTADO IN varchar2 END PKG HELP ONLINE Tabela 14 Stored Procedure Specification sps 57 create or replace PACKAGE BODY PKG HELP ONLINE AS PROCEDURE PRC SET ESTADO GD TOPICO IN varchar2 LOC IN varchar2 ESTADO IN varchar2 IS id conteudo varchar2 100 locale conteudo varchar2 100 BEGIN select topico ajuda conteudo id topico ajuda con
90. senho de arquitecturas tecnol gicas Experi ncia na implementa o de solu es baseadas em Java Experi ncia em an lise e desenho de processos Consultor Engenheiro de sistemas Forte conhecimento das ferramentas a utilizar no projecto privilegiando se a certifica o nos mesmos Experi ncia no desenho e desenvolvimento de interfaces Experi ncia de programa o em tecnologias utilizadas no projecto Experi ncia na utiliza o de webservices Experi ncia no desenho t cnico e modela o de processos de workflow Tabela 1 Perfis dos colaboradores Indra 1 2 Integra o na empresa Na primeira semana tive oportunidade de participar numa sess o de acolhimento cujo objectivo foi integrar os novos colaboradores principalmente aqueles que como eu n o tinham experi ncia profissional possibilitando assim uma adapta o gradual ao longo de uma semana Esse evento contou com 3 dias de forma o proporcionados por uma empresa contratada para o efeito Os dois primeiros dias serviram particularmente para conhecer melhor a empresa a sua estrutura os projectos em que participa e as solu es de que disp em Para tal foi feita uma apresenta o individual por parte de cada director de cada mercado 15 Nos ltimos 3 dias fomos presentes a v rias forma es que visavam desenvolvem as nossas soft skills para ingressar no mundo profissional Aprendemos t cnicas para trabalhar em equipa t
91. stante til para o m dulo WYSIWYG getImagesForWysiwyg Nome getlmagesForWysiwyg Inputs projecto Outputs outputs NOME DESCRICAO URL status Depend ncias N A Descri o Servi o que dado um identificador de projecto devolve uma lista das imagens existentes na tabela IMAGENS REFDATA e correspondem ao projecto passado Os campos de cada imagem que s o devolvidos s o o NOME FICHEIRO nome do file referente imagem por exemplo teste jpg a DESCRICAO campo que permite aos utilizadores identificarem mais facilmente a imagem sendo preenchido por um titulo ou 88 resumo da imagem e o url localiza o da imagem no servidor bastante til para o m dulo WYSIWYG getLanguages Nome getLanguages Inputs projecto Outputs locale alpha2 label status Depend ncias N A Descri o Servi o que dado um identificador de um projecto devolve uma lista com as languages j activadas getLocaleDefault Nome getLocaleDefault Inputs N A Outputs property Value status Depend ncias N A Descri o Servi o que vai s extended settings do servidor IS e detecta a l ngua pr definida getProjectName Nome getProjectName Inputs id Outputs nome projecto status Depend ncias N A Descri o Este servi o vai tabela HELP ONLINE identifica a inst ncia com o id transmitido como input e devolve o nome do projecto a que se refere determinado Help Online Este servi
92. tacar um m todo elaborado cujo objecto construir a rvore de t picos de ajuda import com webmethods caf backoffice Topico private Topico ajuda array topicos array topicos criterio private void buildTree getGetTopicos2 refresh __topicos outputs lista topicos getGetTopicos2 getResult getTopicos outputs array topicos new Topico lista_topicos length Topico topicoActual new Topico Topico topicoActualAux new Topico preencher array de topicos for int i 0 i lt lista topicos length i if i lista topicos length 1 array topicos i new Topico Integer parseInt lista_topicos i getId toString lista_top icos i getTitulo 0 else array topicos i new Topico Integer parseInt lista topicos il getId toString lista top icos il getTitulo Integer parseInt lista topicos i getAntecedente toString 51 for int i 0 i lt lista topicos length i topicoActual array topicos i if topicoActual getAntecedente 1 treeLeafs add new Object null topicoActual jelse for int a 0 a lt lista_topicos length att topicoActualAux array topicos a if topicoActualAux getId topicoActual getAntecedente treeLeafs add new Object topicoActualAux topicoActual tree new ListTreeContentProvider treeLeafs row 1 row 0 null Tabela 13 E
93. teudo locale into id conteudo locale conteudo from topicos ajuda where id to number id topico and locale LOC UPDATE topico ajuda conteudo SET disabled estado WHERE id id conteudo and locale locale conteudo END PRC SET ESTADO END PKG HELP ONLINE Tabela 15 Stored Procedure Body spb Principais linhas orientadoras seguidas 11 e Oracle naming conventions 14 e N o devem ser criados objectos fora de packages procedimentos ou fun es e Todo o c digo que funcionalmente esteja relacionado deve ser agrupado num package e Deve ser assegurado um n vel de normaliza o adequado e Todo o c digo desenvolvido deve ser testado em termos de performance 58 3 5 4 Testes Passando ent o para a fase de testes do sistema importa referir que o principal objectivo desta etapa passou por assegurar a qualidade do produto e um n vel de confian a na utiliza o de forma a satisfazer os requisitos funcionais e n o funcionais Para tal acontecer foi necess rio e N o deixar passar em claro poss veis defeitos na fase de constru o do sistema e Assegurar que o produto respeita os requisitos funcionais e n o funcionais atribu dos inicialmente Foram utilizadas as seguintes t cnicas de verifica o de qualidade e Peer Reviews 31 Em parceria com outro colega esta foi a forma mais r pida e f cil e que por consequ ncia consumiu menos tempo para fazer uma an lise a partes do c digo Java assim com
94. to 4 despoletado um Popup de confirma o 5 Caso tenha a certeza o administrador clica em OK Cen rios Alternativos 5 a Caso o administrador clique em Cancelar 1 Caso de uso termina Tabela 7 Exemplo de descri o de Caso de Uso 43 Caso de Uso Activar T pico Actor Principal T cnico Pr Condi es Tem que existir um projecto e um T pico desactivo P s Condi es O t pico fica activo e vis vel para o utilizador Cen rio Principal 1 O t cnico entra na interface de Gest o 2 Dentro do subgrupo rvore de Conte dos ter que seleccionar o t pico pretendido 3 Ser aberta a interface de edi o de t picos de ajuda 4 Dentro do subgrupo Conte do seleccionar Activo 5 Clicar em Terminar Cen rios Alternativos 5 a Caso o administrador clique em Cancelar 1 Caso de uso termina Tabela 8 Exemplo de descri o de Caso de Uso 3 3 3 Requisitos N o Funcionais O sistema tem de possuir determinadas caracter sticas que ir o contribuir para o desempenho global do sistema Esses requisitos n o funcionais foram descritos segundo a mesma estrutura C digo Requisito Descri o Requisito Depend ncias HO NF 002 intuitiva minimizando eventuais d vidas de HO NF 005 A edi o dos conte dos do Help Online dever ser efectuada de forma r pida e processamento de texto e inser o elimina
95. to Desenvolvimento de um sistema atrav s da plataforma webMethods nomeadamente componentes da interface gr fica e webservices para uso da mesma recorrendo s ferramentas apresentadas pela plataforma em quest o webMethods Designer e webMethods Developer Fazer an lise critica dos m todos de desenvolvimento aplicados procurando sempre melhorar a utiliza o da plataforma webMethods Executar casos de testes para valida o funcional e t cnica dos processos implementados Ter contacto directo com o cliente atrav s de reuni es peri dicas 1 5 Organiza o do Documento Este documento encontra se organizado em 4 cap tulos que s o elucidados de seguida No Capitulo 1 feita uma introdu o ao documento deixando claro o seu contexto apresentada a empresa onde se realiza o est gio e s o identificados os objectivos No Capitulo 2 feita uma contextualiza o sobre as condi es que deram origem ao trabalho desenvolvido descrevendo a tecnologia arquitectura usada assim como as metodologias para o seu desenvolvimento No Capitulo 3 comentou se o trabalho que foi realizado quer na vertente mais t cnica quer na vertente de gest o das actividades mostrando no fim o resultado tang vel de todo o est gio O Capitulo 4 conclui este relat rio dando uma perspectiva final sobre o est gio desde o processo de acolhimento at sua conclus o 17 18 Cap tulo 2 Contexto do projecto Este projecto te
96. to de webservices atrav s de Flow Service Oriented Architecture E uma arquitectura em que as aplica es desenvolvidas devem usar funcionalidades oferecidas por servi os de um sistema diferente sendo que estes servi os poder o ser usados por v rias aplica es Os servi os SOA implementados oferecem s aplica es uma interface atrav s por exemplo dos webServices anteriormente falados XQuery uma linguagem de consulta com o objectivo de fazer consultas XML Query Language em conjuntos de dados escritos em XML semanticamente similar ao SQL 17 Middleware O termo Middleware refere se ao software que se executam entre as T11 aplica es e os sistemas operativos O objectivo do middleware facilitar o desenvolvimento de aplica es tipicamente as distribu das 18 Business Process Management BPM O BPM um conceito que une a gest o de neg cios tecnologia da informa o com o objectivo de melhorar os resultados das organiza es atrav s da optimiza o dos processos do neg cio 15 Workflow Conjunto de tarefas que constituem um processo de neg cio Hypertext Transfer Protocol HTTP Protocolo de comunica o na camada de aplica o utilizado nos sistemas distribu dos eXtensible Markup Language Linguagem que permite representar v rios tipos de dados facilitando a partilha dos mesmo entre aplica es desenvolvidas em linguagens
97. uldade conhecimentos a que at agora n o dava a devida import ncia A n vel de gest o visto existirem prazos a cumprir foi tamb m poss vel evoluir na capacidade de organiza o de projectos de desenvolvimento de software Grande parte da positiva adapta o se deveu boa forma o acad mica prestada pela faculdade nomeadamente nas disciplinas que envolviam programa o em Java como tamb m nas disciplinas menos t cnicas como An lise e desenho de Sistemas de Informa o A cadeira de aplica es na Web teve um papel muito importante pois proporcionou o contacto directo com a arquitectura SOA e com Javascript o que facilitou a compreens o do funcionamento de grande parte da plataforma Em suma apesar de algumas dificuldades provenientes principalmente da complexidade da tecnologia usada o saldo foi bastante positivo e todos os objectivos iniciais foram cumpridos salientando apenas algumas pequenas mudan as no planeamento mas que em nada afectaram o sucesso do projecto 74 Cap tulo 5 Bibliografia 1 http www baremetalsoft com baretail 15 08 2011 2 http tortoisesvn net 15 08 2011 3 http www oracle com technetwork developertools sgldeveloper overview index ht ml 15 07 2011 4 Http www slideshare net garrettdimon improving interface design 15 07 2011 5 Sun Microsystems Inc Java Look And Feel Design Patterns 1999 15 07 2011 6 http pt wikipedia org wiki Modelo_relacional 10 08 2011
98. uma posi o de um elemento da rvore de t picos essa altera o efectuada nas rvores das restantes l nguas updateTopicoAjuda Nome update Topico Ajuda Inputs id projecto id l ngua titulo conte do updated by Outputs status Depend ncias N A Descri o Servi o despoletado pela view Editar Ajuda quando o t cnico efectua altera es a um determinado t pico previamente seleccionado As altera es t m efeito directo sobre duas tabelas na base de dados TOPICO AJUDA CONTEUDO e TOPICO AJUDA TITULO possibilitando altera es ao n vel do t tulo estado e conte do do t pico 96
99. utado no initialize da view Editar Ajuda preenchendo todos os elementos do t pico de ajuda 90 getTopicoName Nome getTopicoName Inputs id lingua PROJECTO Outputs nome status Depend ncias N A Descri o Servi o que devolve o t tulo de um determinado t pico de ajuda de um projecto O comando em base de dados que devolve o resultado pretendido percorre tr s tabelas HELP ONLINE T PICOS AJUDA e T PICO AJUDA TITULO getTopicos Nome getTopicos Inputs id projecto l ngua Outputs topicos outputs id titulo antecedente status Depend ncias N A Descri o Servi o que dado um identificador do projecto e uma determinada l ngua devolve uma lista preenchida com os t picos do projecto informando para cada elemento o respectivo id t tulo e id do t pico antecendente Percorre as tabelas HELP ONLINE TOPICOS AJUDA e ANTECEDENCIAS para devolver o resultado solicitado Este servi o adquire especial import ncia dado que o respons vel por alimentar as rvores de t picos de ajuda existentes pelas diferentes views do projeco Tamb m respons vel por alimentar os arrays utilizados pelo m todo que constroem o breadcrumbs segu ncia de t picos chamado pela pesquisa por t pico da view FrontOffice getURL Nome getURL Inputs nome projecto Outputs url status Depend ncias N A Descri o Servi o que devolve o url de uma imagem existente na tabela IMAGENS REFDATA cujo nom
100. va o sistema bastante est tico e desactualizado mal se procedesse a uma altera o da aplica o Ap s as etapas de An lise Desenho e Constru o ficou se com um sistema onde a ajuda editada online Cada conte do de ajuda ficou conhecido por T pico de ajuda e por sua vez construiu se uma rvore de T picos de Ajuda que representa a navega o poss vel dentro da aplica o Web Assim foi poss vel realizar adicionalmente um sistema de pesquisa de ajuda em que o resultado o caminho desde a raiz da aplica o at ao n onde se encontra o t pico de ajuda com o crit rio que o utilizador pesquisou O sistema abrangeu 3 tipos de utilizadores Administrador T cnico e Utilizador tendo cada um deles fun es espec ficas e acesso a interfaces diferentes O perfil de Administrador e T cnico pressup em acesso a interfaces de BackOffice onde se administram os v rios projectos que t m um sistema de Help Online sendo tamb m poss vel fazer uma gest o dos conte dos de ajuda para cada sistema de ajuda O Utilizador por sua vez tem acesso a uma interface de FrontOffice onde fornecida a ajuda sobre a aplica o web e tamb m um sistema de pesquisa Actualmente o sistema encontra se a funcionar no cliente sendo inclusive utilizado por outras empresas a desenvolverem no local Palavras chave Ajuda Online Edi o de Conte dos Pesquisa de Ajuda SOA webMethods Abstract This report describes the work done over a ni
101. ve por base o melhoramento de um sistema que j estava implementado no cliente mas que se encontrava obsoleto e n o ia ao encontro dos objectivos pretendidos Foram propostas v rias solu es sendo elas elaboradas e completadas medida que se iam realizando reuni es e se percebia a dimens o do problema assim como qual seria a solu o final pretendida De seguida feita uma contextualiza o sobre o surgimento do projecto 2 1 Vis o Muitas das vezes um utilizador final de um sistema n o aquele que imp s os requisitos do projecto e especificou as funcionalidades pretendidas para o mesmo Sendo assim perfeitamente compreens vel que ele n o possua um conhecimento profundo sobre o sistema e que por sua vez n o conhe a as funcionalidades potencialidades de que pode usufruir o que normalmente colmatado na fase de Suporte P s implementa o Manuten o por quem desenvolveu o sistema ou por quem tem algum conhecimento sobre ele Este passo sempre tido em conta no planeamento de um projecto mas justamente sobre ele que incidiu o estudo fornecendo um sistema de ajuda contextualizada para reduzir o tempo gasto no Suporte podendo assim efectuar outras actividades consideradas mais importantes para a empresa 2 2 Miss o Este projecto surge para fornecer um sistema de ajuda on line contextualizada que se adapte a todos os projectos feitos em webMethods A ajuda fornecida contextualizada e pr definida tendo um
102. xemplo de C digo escrito em Java Principais linhas orientadoras a seguir C digo 11 12 o Comentarios c digo deve ser devidamente documentado para que seja facilmente leg vel o Nomes Ter aten o aos nomes atribu dos de modo a que identifiquem devidamente o objecto em quest o o Excep es e tratamento de erros Tratar devidamente de todas as excep es e erros que poder o surgir ao longo dos testes do projecto para minimizar os custos de manuten o ap s a fase de fecho do projecto CAF 11 o Conven o para nomes Os portlets dever o ser compostos por nomes abreviados o mais expl cito poss vel 52 3 5 2 Camada de L gica de Neg cio Servi os A constru o dos servi os utilizando o Webmethods Developer n o necessitou na maior parte dos casos de um recurso a programa o bastando arrastar os v rios componentes que a aplica o disp em e conjuga los de modo a criar um m todo semelhante ao que seria um m todo escrito por exemplo em Java Como conhecido uma das maiores vantagens de SOA a diminui o de custos de desenvolvimento pois permite a reutiliza o de funcionalidades j implementadas permitindo tamb m uma maior facilidade de integra o entre funcionalidades de sistemas diferentes e uma maior facilidade na manuten o das funcionalidades j existentes Sendo assim durante a constru o de qualquer servi o fui sempre tendo em conta os seguintes aspectos 13

Download Pdf Manuals

image

Related Search

Related Contents

LME : quels impacts pour la  ブーメランスポーツ取扱説明書    重要事項説明書 - American Express  (9021_Manual Fog\365es de Indu\347\343o...)    Technical Publications LOGIQ e Quick Guide  Behringer Guitar 629 User's Manual  Wonderful Communication, Mobile Life  Miele KM 6117 hob  

Copyright © All rights reserved.
Failed to retrieve file