´
E apresentada nesta secc¸˜ao a lista de operac¸˜oes e funcionalidades implementadas se- gundo os m´etodos e classes disponibilizados pela API em Java do Oracle BPEL Process Manager.
Este conjunto de servic¸os divide-se em dois Web Services: o BPELProvider e o BPELConsole. O primeiro ´e o respons´avel por disponibilizar funcionalidades que per- mitem a interacc¸˜ao e sincronizac¸˜ao dos fluxos BPEL com os m´odulos do SIGARRA. Quanto ao segundo, pertence `as implementac¸˜oes suplementares desenvolvidas para este projecto e disponibiliza servic¸os para a Consola e para o Gestor de Tarefas do Sistema de Informac¸˜ao. Todos estes servic¸os s˜ao invocados por processos BPEL e pelo novo m´odulo dos Trouble Tickets atrav´es da troca de mensagens XML no formato SOAP.
Tabela 7.1: Lista de Servic¸os do Web Service BPELProvider Servic¸os BPELProvider
Operac¸˜ao Descric¸˜ao
deleteInstance Permite apagar de todo o sistema tudo o que seja relacionado com uma dada instˆancia passada como parˆametro de entrada.
getSensorValues Obt´em os valores de todos os sensores de uma dada instˆancia.
executeBatchTask Possibilita responder a uma dada tarefa, passando o seu identi- ficador, o utilizador que responde e o valor da resposta. Servic¸o de extrema importˆancia para a sincronizac¸˜ao das instˆancias BPEL com o Sistema de Informac¸˜ao.
getInstance Retorna todas as informac¸˜oes relativas a uma instˆancia, tais como o seu nome, estado, identificador, data de criac¸˜ao e modificac¸˜ao.
getUserParticipants Utilizado na integrac¸˜ao dos utilizadores da FEUP com o BPEL. Permite retornar a lista de utilizadores dado o identificador do grupo a que pertencem. Este servic¸o ´e utilizado pelos proces- sos BPEL, na criac¸˜ao de Tarefas Humanas para m´ultiplos uti- lizadores.
startProcess Inicia uma nova instˆancia BPEL da ´ultima vers˜ao registada no servidor para um dado processo. S˜ao igualmente passados, em formato XML, os parˆametros de entrada do processo.
cancelTask Permite cancelar uma dada tarefa pendente para um utilizador. Para isto foi definido um utilizador sistema gen´erico que ´e o dono e o respons´avel por todas as tarefas e notificac¸˜oes enviadas no BPEL. Deste modo, ´e poss´ıvel que este efectue um pedido para cancelar uma dada tarefa sem a intervenc¸˜ao dos destinat´arios.
Tabela 7.2: Lista de Servic¸os do Web Service BPELConsole utilizados pela Consola BPEL Servic¸os BPELConsole
Operac¸˜ao Descric¸˜ao
getProcessNames Obt´em a lista de nomes dos processos BPEL registados no servi- dor. Caso existam m´ultiplas vers˜oes do mesmo projecto, ´e igual- mente retornada a sua vers˜ao.
deleteAllSensors Apaga todos os registos e valores dos sensores criados por todas as instˆancias.
deleteAllInstances Apaga todas as instˆancias do sistema independentemente do seu estado.
undeployProcess Permite remover um dado processo da lista de processos activos no servidor.
getInstanceTrace Desenvolvido para retornar o Instance Trace de uma instˆancia. Este corresponde a uma estrutura XML contendo todas as activi- dades processadas num dado fluxo de uma instˆancia e as respec- tivas ligac¸˜oes.
getAuditTrail Retorna uma grande estrutura XML que cont´em os detalhes e val- ores de todas as actividades processadas num dado fluxo.
getTotalInstancias Devolve o total de instˆancias activas ou terminadas de um dado processo BPEL. Usado para efectuar a paginac¸˜ao dos resultados.
getTotalProcessos Devolve o total de processos registados no servidor BPEL. Usado para efectuar a sua paginac¸˜ao.
initiateProcess Possibilita iniciar uma nova instˆancia para um dado processo, re- cebendo um conjunto de parˆametros nome e valor, que correspon- dem aos parˆametros de entrada de um dado processo BPEL.
getProcessForm Gera um c´odigo html que ´e inserido no formul´ario para iniciar um processo, com o nome e tipos de todos os parˆametros de en- trada desse processo. Permite posteriormente invocar o servic¸o
initiateProcesspassando esta lista de valores.
deleteInstance Permite apagar de todo o sistema tudo o que seja relacionado com uma dada instˆancia passada como parˆametro de entrada.
abortInstance Permite cancelar o processamento de uma dada instˆancia, man- tendo todo o seu hist´orico no reposit´orio.
getInstance Retorna todas as informac¸˜oes relativas a uma instˆancia, tais como o seu nome, estado, identificador, data de criac¸˜ao e modificac¸˜ao.
getProcess Retorna todas as informac¸˜oes relativas a um dado processo BPEL registado no servidor, tais como o seu nome, vers˜ao, o total de istˆancias activas e terminadas.
getInstanceByStatus Devolve todas as instˆancias que verifiquem o conjunto de fil- tros parametrizados neste Servic¸o. Deste modo ´e possivel fil- trar instˆancias pelo seu estado e processo e ainda definir a sua paginac¸˜ao.
Tabela 7.3: Lista de Servic¸os do Web Service BPELConsole utilizados pelo Gestor de Tarefas Servic¸os BPELConsole
Operac¸˜ao Descric¸˜ao
getTasks Permite retornar todo o conjunto de tarefas de um determinado utilizador passando o seu c´odigo. Permite ainda filtrar os resul- tados por processo, por instˆancia e por nome da tarefa e ainda aplicar uma paginac¸˜ao aos resultados retornados.
getTotalUserTasks Retorna o total de tarefas e notificac¸˜oes terminadas ou pendentes para um dado utilizador. Permite efectuar a paginac¸˜ao destes re- sultados.
executeBatchTask Possibilita responder a um grupo de tarefas, passando os seus identificadores, o utilizador que responde e os respectivos valores das respostas.