Sie sind auf Seite 1von 9

Documentacao sobre o Plugin de (sugestao de

diagnostico?)
Laboratorio de Universalizac ao de Acesso - UFMG
20 de mar co de 2014
SUM

ARIO
Sumario
1. Descricao 2
2. Exemplo de Funcionamento 2
3. Utilizando o Plugin 3
3.1. Preparando o XPDL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
3.2. Arquivo de Congurac ao . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
3.2.1. Connection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
3.2.2. Formula . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
4. Instalacao 8
1
1. Descricao
Este plugin permite que campos de um workow qualquer sejam preenchidos automati-
camente dada uma regra, nesse caso uma formula booleana, estabelecida previamente. Neste
documento mostrar a todos os passos necess arios para instalar e congurar o plugin no Flux.
2. Exemplo de Funcionamento
As imagens abaixo mostram o funcionamento do plugin para um caso simples. Observe que
o atributo que recebe a resposta do plugin n ao e exibido durante a execuc ao da atividade.
Figura 1: Exemplo de execuc ao do Plugin
2
3. Utilizando o Plugin
A seguir mostraremos todos os passos necessarios para utilizar o plugin
3.1. Preparando o XPDL
Para que o Flux reconheca o plugin e necessaria sua congurac ao no arquivo XPDL. No
Together workow Editor encontre a atividade onde deseja que o plugin seja executado (atividade
que possui o atributo alvo, ou seja, o atributo que ser a preenchido pelo plugin)
Figura 2: Workow Exemplo
Selecione o primeiro atributo (o Flux procura pelas informac oes de um possvel plugin apenas
no primeiro atributo de cada atividade) e adicione os seguintes atributos estendidos:
application - Dene que comando deve ser invocado pelo Flux
Valor: nome do executavel arquivo de congurac ao
application is plugin - Dene o execut avel esta no diretorio de plugins
Valor: [true]
get idActivity Adiciona o id da atividade que chama o plugin `a lista de argumentos passado
ao executavel
3
3.1. Preparando o XPDL
Valor: [true]
get idInstance Adiciona o id da instancia que chama o plugin `a lista de argumentos
passado ao execut avel
Valor: [true]
Figura 3: Primeiro atributo da atividade
Crie o atributo onde a resposta deve ser salva, caso nao exista, e adicione o atributo estendido
PLUGIN OUTPUT para que o mesmo n ao seja exibido durante a execuc ao da atividade.
Figura 4: Atributo alvo do Plugin
4
3.2. Arquivo de Congurac ao
3.2. Arquivo de Conguracao
Para que o plugin funcione corretamente tambem e necess ario um arquivo de congurac ao,
nele est ao especicados os par ametros de comunicac ao com o banco e as regras que dever ao ser
utilizadas para preencher os atributos alvo. Abaixo est a o arquivo de congurac ao do exemplo
utilizado nessa documentacao. O arquivo segue o padr ao yml e tem a seguinte forma:
Figura 5: Arquivo de congura cao exemplo
Alguns detalhes sobre o formato yml :
Todo arquivo yml comeca com - - -
Todo arquivo yml termina com . . .
Toda linha que comeca com um # e um comentario e e ignorada
O blocos s ao reconhecidos atraves do alinhamento.
Mais informac oes em: http://en.wikipedia.org/wiki/YAML
5
3.2. Arquivo de Congurac ao
3.2.1. Connection
Dene os par ametros de conex ao com o banco de dados.
Server: Endereco da maquina que contem o banco de dados
User: Usuario do banco
Password: Senha do usu ario
Database: Nome do banco de dados
3.2.2. Formula
Dene a regra que sera utilizada para gerar a resposta automatica.
Scope: Dene se a quais atributos o plugin tera acesso. Caso seja necess ario que o plugin
acesse os atributos de todas as atividades da instancia
1
, utilize o escopo global. Caso
contrario, se todos os dados necess arios estao na atividade atual, utilize o escopo local.
Name: Nome da formula
Expression: A expressao booleana que sera utilizada no calculo da resposta. Esse e o
campo mais importante da formula ja que ele dene exatamente como a resposta sera gerada.
A expressao e composta por atributos, seus valores esperados e operadores logicos. O formato
de um atributo e o seguinte:
Referencia:ValorEsperado
Os operadores suportados sao:
OR (ou l ogico) : |
AND (e l ogico) : &
NOT (negac ao) : !
1
O Flux, por padrao, nao limita o n umero de execu coes de uma atividade. Portanto no caso do escopo global,
o plugin tem acesso aos atributos da propria atividade e de todas as atividades ascendentes. Isso e necessario pois
caso existam dois atributos com o mesmo identicador o plugin e incapaz de decidir qual utilizar
6
3.2. Arquivo de Congurac ao
Existem dois modos de escrever a expressao booleana e esse depende do escopo utilizado na
formula. No caso do escopo local, o plugin tera acesso apenas aos atributos da atividade em
que e executado (esses s ao passados por parametro no momento da chamada do plugin pelo
Flux). Nesse caso, para referenciar um atributo, basta utilizar sua posicao na atividade.
Exemplo:
Figura 6:
No caso global os atributos s ao refrenciados pelo seu nome no XPDL. O exemplo a seguir e
uma execuc ao do plugin na segunda atividade do workow exemplo. Ele busca o resultado
da execuc ao anterior do plugin (formula1) e da o risco que a mesma oference ao paciente
dado sua idade.
Target: Indica em qual atributo a resposta deve ser salva. Deve ser indicado o nome do
atributo no XPDL.
ResponseIfTrue: Resposta caso o calculo retorne verdadeiro
ResponseIfFalse: Resposta caso o calculo retorne falso
7
4. Instalacao
Para instalar o plugin basta mover o executavel e o arquivo de congura cao para a pasta de
plugins do Flux, considerando que o workow ja esteja carregado e congurado corretamente.
Caso nao possua o executavel siga os seguintes passos:
1. Faca o checkout do plugin no reposit orio do Flux. Utilize o comando:
svn checkout svn+ssh://cabernet.luar.dcc.ufmg.br/var/svn/uxdev/src/trunk/plugins/ACI
2. Entre no diret orio src e, caso n ao haja um executavel, execute o seguinte comando:
make aci
A compila cao pode falhar devido a falta de bibliotecas, nessa caso execute o seguinte comando
no terminal:
sudo apt-get install libyaml-dev libmysqlclient-dev
8

Das könnte Ihnen auch gefallen