administração do Ágileswiki.recife.pe.gov.br/files/file/bpm/treinamentos/administracao/... ·...

Copyright 1996-2008 Image Technology S.A. All rights reserved.

São Paulo, janeiro de 2008

Administração do ÁGILES

(treinamento para Parceiros e Clientes)

2

Treinamento: Administração do ÁGILES


Conteúdo do Curso

–Administrando o JBoss

–Utilização do módulo “Administração” do ÁGILES

–Utilização do módulo de Console


Administrando o JBoss

4



Administrando o JBoss

– O que é / como instalar

– Configuração básica do JBoss

• Porta de Comunicação

• Tempo para Timeout

• Tipo de Log

– Fazendo deploy de EAR

– Como executar o JBoss através de arquivo em lote

– Como deixá-lo como serviço

– Iniciando e parando o serviço manualmente

– Visualizando os arquivos de Log

– Considerações importantes

5



JBoss – O que é / como instalar

O JBoss é o servidor de aplicação J2EE Open Source padrão domercado, totalmente implementado em Java.

A instalação do servidor JBoss é simples, basta copiar o conteúdodo diretório /appserver do CD do ÁGILES para um diretórioqualquer desejado (como exemplo, neste material vamosconsiderar que o JBoss foi instalado no diretório C:\Agiles).

Para que o JBoss funcione é necessário ter o SDK 1.4.2.Xinstalado (se não tiver, faça download do endereçohttp://java.sun.com/j2se/1.4.2/download.html).

Após isso, precisa-se configurar a variável de ambienteJAVA_HOME que deve apontar para o diretório onde estáinstalado o SDK (para maiores informações veja o manual deinstalação do ÁGILES).

http://java.sun.com/j2se/1.4.2/download.html

















6



JBoss – Config. Porta de Comunicação

Para configurar a porta de comunicação deve-se alterar o arquivoserver.xml, que está, a partir do diretório do JBoss, em\server\default\deploy\jbossweb-tomcat55.sar\

Neste arquivo, deve-se localizar o texto a seguir:

<Connector port="8080" address="${jboss.bind.address}“

maxThreads="250" strategy="ms" maxHttpHeaderSize="8192“

emptySessionPath="true“

enableLookups="false" redirectPort="8443" acceptCount="100“

connectionTimeout="20000" disableUploadTimeout="true"/>

Onde se lê “8080” pode-se ter 80, 8081, 8085, entre outras.Depende da disponibilidade do servidor, o que pode ser obtidocom o administrador da rede.

Obs.: a porta escolhida não deve possuir restrição de acesso (firewall oubloqueio), pois será através dela que os clientes acessarão oÁGILES.

7



JBoss – Config. Tempo de Timeout

Para configurar o tempo de Timeout deve-se alterar o arquivojta-service.xml, que está, a partir do diretório do JBoss, em\server\default\deploy.


<mbean code="org.jboss.tm.TransactionManagerService“name="jboss:service=TransactionManager“xmbean-dd="resource:xmdesc/TransactionManagerService-xmbean.xml"><attribute name="TransactionTimeout">300</attribute><attribute name="GlobalIdsEnabled">true</attribute><depends optional-attribute-name="XidFactory">jboss:service=XidFactory</depends><depends>jboss:service=Naming</depends>

</mbean>

Onde se lê “300” pode-se ter qualquer valor (expresso em segundos).

Para redes lentas ou com tráfego intenso, pode ser necessárioaumentar esse valor. Para a maioria das redes este número ésuficiente.

8



JBoss – Config. Tipos de LogPara configurar o tempo de Timeout deve-se alterar o arquivo log4j.xml,que está, a partir do diretório do JBoss, em \server\default\conf.


<appender name="FILE" class="org.jboss.logging.appender.DailyRollingFileAppender"><errorHandler class="org.jboss.logging.util.OnlyOnceErrorHandler"/>

<param name="File" value="${jboss.server.home.dir}/log/server.log"/><param name="Append" value="true"/><param name="Threshold" value="INFO"/><param name="DatePattern" value="'.'yyyy-MM-dd"/>

<layout class="org.apache.log4j.PatternLayout">...</layout>

</appender>

O conteúdo value=“true” deve ser colocado, pois originalmente o valor é“false”. Ele tem como função guardar o arquivo de log mesmo que oJBoss seja reiniciado.

A linha <param name="Threshold" value="INFO"/> mantém oarquivo de log mais limpo, impedindo que informações desnecessáriasde debug sejam registradas no mesmo.

9



JBoss – Deploy do EAR

Quando for necessário atualizar o arquivoagiles.ear (assim como outros arquivos dotipo EAR, JAR, WAR ou SAR), copie-o daorigem (CD de atualização do ÁGILES,FTP, e-mail, etc.) para o diretório\server\default\deploy\ dentro do diretóriodo JBoss (lembre-se que, como exemplo,estamos considerando que o diretório doJBoss está dentro de C:\Agiles).

Para atualizar bibliotecas de funções,copie o arquivo agilesFunctions.jar parao diretório apropriado (configurado noarquivo agiles.properties, na linha decomando libDir=<diretório>). Na figuraao lado, o diretório é C:\Agiles\functions.

10



JBoss – Como Executar

Caso esteja depurando aplicações e/ouprocessos, é conveniente executar diretamente oJBoss (através de arquivo em lote).

Dessa forma será possível acompanhar arealização do trabalho tanto pela janela do JBossque ficará aberta, como através do arquivo deLog (a visualização dos arquivos de Log serávista mais adiante).

Para isso, acesse o diretório BIN, dentro doJBoss, e execute o arquivo RUN.BAT (o quepoderá ser feito tanto pelo prompt de comandodo Windows como através do Windows Explorer).

11



JBoss – Configurando o BD

Na primeira vez que o JBoss for executado em um servidor quepossui o ÁGILES, apresentará uma exception porque tentalocalizar, algumas informações de especiais do Ágiles (que ficamno Prefs do Java), informações que ainda não existem.

Para solucionar esta questão, rode o programa ChangeDir.jar doÁgiles

Comando: java -jar /”caminho do arquivo”/ChangeDir.jar –s/”caminho de instalação do Ágiles”/config

12



JBoss – Deixando-o como Serviço (windows)

Na utilização diária é conveniente deixar o JBosscomo serviço, pois assim ele poderá ser executado(e parado) manual ou automaticamente. Porém, oacompanhamento das operações realizadas só serápossível através do arquivo de Log.

Para deixar o JBoss como serviço (windows):

– Acesse o prompt de comando do Windows, através do

botão Iniciar, comando Executar.

– Dentro do diretório do JBoss, na pasta Bin, está o arquivo

em lote “MyApp.bat”, que deve ser executado com o

parâmetro “install” (seguindo nosso exemplo, o comando

seria “Run c:\Agiles\jboss3.2.3\bin\MyApp.bat install”).

13



JBoss – Deixando-o como Serviço (linux)

Para deixar o JBoss como serviço no linuxexistem várias formas diferentes, cabe aoadministrador do Linux a escolha. Abaixodescrevemos uma opção que é deixar oJBoss rodando em Background:

– Crie um arquivo de script (bash) contendo a seguinte

linha de comando:

• /“Caminho do Jboss”/bin/run.sh &

Observação: Outra opção de instalação seria deixar a

chamada do JBoss dentro do rc.local ou utilizar o webmin

(aplicativo para administração do linux) entre outras.

14



Depois de instalar o JBoss como serviço, ele poderá serexecutado e finalizado das seguintes formas:

No ambiente Linux utilize o comando KILL para parar o serviço.

Para Windows: Através do Painel de Controle.

Dentro do Painel de Controle, acesse: FerramentasAdministrativas, Serviços. Clique com o botão direito no itemJBoss Application Server e, no menu que surgir, clique em“Iniciar” para começar a executá-lo (quando desejar terminara execução clique em “Parar”).

Se quiser que o JBoss seja executado automaticamente quando oWindows for carregado, clique em “Propriedades” e altere oitem “Tipo de inicialização” para “Automático” (no padrão eleestará como “Manual”).

É importante lembrar que o acompanhamento das operaçõesdeste serviço só poderá ser feito através do arquivo de Log(que será explicado a seguir).

JBoss – Iniciando e Parando o Serviço

15



Na tela de Propriedades deve-se

definir, também, as formas de

recuperação do JBoss.

Para isso, acesse a aba

“Recuperação” e defina como o

Windows deve proceder no caso

de falhas no serviço.

Recomenda-se colocar “Reiniciar

o serviço” em todos os tipos de

falha.


16




17



JBoss – Visualizando Arquivos de Log

Os arquivos de Log ficam na pasta \server\default\logdentro do diretório do JBoss.

Eles são arquivos de texto e podem ser lidos com o Bloco de Notas do Windows ou “Vi” e/ou “VIM” do linux.

A nomenclatura deles é: “server.log” mais a data em que foram gerados.Ex.: server.log.2005-03-31.

É criado um arquivo por dia e o que estiver sem a data no nome corresponde ao do dia atual.

18



JBoss – Considerações Importantes

– Qualquer alteração em arquivos de configuração do JBoss oudo ÁGILES (.xml, .properties, etc.) exige a reinicializaçãodo JBoss.

– O JBoss do CD de instalação do ÁGILES (versão 4.0.3) édiferente da mesma versão disponível para download nainternet (www.jboss.org). Portanto, ele deve ser copiado doCD (como citado anteriormente), pois o download nãoproduzirá o efeito desejado.

– Toda vez que for atualizar o ÁGILES (arquivo EAR, entreoutros) recomenda-se fazer backup dos arquivos que serãosubstituídos, assim como do banco de dados.

http://www.jboss.org/






Utilização do módulo

“Administração” do ÁGILES

20



Módulo “Administração” do ÁGILES

Este módulo é responsável pelo gerenciamento do software.

Nele é feita a manutenção dos diversos cadastros, tais como:usuários, grupos de usuários, estrutura organizacional, categoriasde processos, árvore de diretórios do Visitor.

21



Administração – Usuário

Permite o cadastramento de usuários. Ao clicar no comando “Usuário”

aparecem os usuários ativos.

Se desejar os inativos (“excluídos”)

também, selecione esta opção.

Utilize estes botões para

acrescentar novos usuários.

As telas de inclusão e alteração

estão representadas no próximo

slide.

Selecione o usuário e depois

utilize estes botões para alterar

ou apagar e para ver a Trilha de

Auditoria (movimentações) do

usuário selecionado.


estão representadas no próximo

slide.

22



Lembre-se de especificar o

idioma padrão para este

usuário (isso determina o

idioma em que as telas

aparecerão) e o fuso horário

(o Brasil é GMT -3:00).

Permite que se defina quais grupos

e/ou nós organizacionais que o

usuário pertence.

Administração – Usuário

Tela de Inclusão Tela de Alteração. Exibe grupos e nós a que este usuário pertence.

23



Administração – Usuários Logados

Permite que você saiba quais os usuários que estão logados noÁgiles e pode também enviar uma mensagem instantânea paraele(s).

Lista de usuários

logados/conectados.

24



Administração – Grupo

Permite cadastrar grupos de usuários (primeiro deve-se cadastrarusuários, depois os grupos). O agrupamento é conveniente para que sepossa atribuir permissões, atividades e/ou tarefas para diversos usuáriosde uma vez.

Ao clicar no comando “Grupo”

aparecem os grupos ativos.

Se desejar os inativos (“excluídos”)

também, selecione esta opção.

Utilize estes botões para acrescentar

novos grupos, e para alterar ou apagar

um dos que existem (neste caso,

selecione o grupo desejado).

A tela de inclusão e alteração está

representada no próximo slide.

25



Digite o nome e

descrição do grupo, e

utilize o botão “+” para

adicionar usuários e o

“-” para removê-los.

Preencha as informações e

salve o grupo.

Administração – Grupo

No padrão, quando o ÁGILES é instalado não existem grupos, e elesdevem ser criados de acordo com a necessidade.

Após a criação, os conteúdos (categorias, diretórios) a que estes gruposterão acesso deverão ser definidos no item “Módulos” (descrito adiante).

Utilize o botão “+” para

adicionar outros grupos

e o “-” para removê-los.

26



Administração – Permissões de Acesso

Possibilita a definição das permissões para os usuários, grupos,categorias e diretórios, ou seja, o que estes usuários / grupospoderão fazer dentro do sistema, e quem poderá acessar ascategorias e diretórios.Ao clicar no comando

“Permissões de Acesso”

aparecem os sub-módulos para

definição de tipos de permissão.

Clicando no tipo de permissão

aparecem seus conteúdos (aqueles

que podem ter permissões

atribuídas).

Clicando na categoria aparecem os

processos cadastrados na mesma.

Selecione os

itens (ou

módulos)

para os quais

definirá as

permissões e

clique em

“Editar

Permissões”.

27




Possibilita a definição das permissões para os usuários, grupos,categorias e diretórios, ou seja, o que estes usuários / grupospoderão fazer dentro do sistema, e quem poderá acessar ascategorias e diretórios.

Ao clicar no comando “Permissões de Acesso”

aparecem os sub-módulos para definição de tipos de

permissão.

Clicando no tipo de permissão (no exemplo clicamos

em Permissões de Categoria), aparecem seus

conteúdos (aqueles que podem ter permissões

atribuídas).

Selecione os

itens (ou

módulos)

para os quais

definirá as

permissões e

clique em

“Editar

Permissões”.

28




Ao clicar em “Editar Permissões” aparecerão os usuários ativos,escolha aqueles para os quais atribuirá as permissões, cliqueem “Editar Permissões”, defina-as e confirme a operação.

29




Ao clicar em “Editar Permissões” aparecerão os usuários ativos,escolha aqueles para os quais atribuirá as permissões, cliqueem “Editar Permissões”, defina-as e confirme a operação.

A permissão pode ser para o

usuário específico ou para o grupo

que ele pertence.

Permissões: Não Definido, Sim, Não.

Recursivo: aplica a permissão aos

“filhos” do item atual.

Propagar para Origem: aplica a

permissão para os “pais” do item

atual.

(“Recursivo” e “Propagar para

Origem” só se aplicam aos itens JÁ

existentes).

30



Administração – Trilha de Auditoria

O ÁGILES registra todas as transações ocorridas durante seuuso, desde logins até atividades realizadas, e a Trilha deAuditoria permite a consulta destas movimentações.

Ao clicar no comando “Trilha

de Auditoria” aparece a tela

de filtro vazia.

Digite os conteúdos que

deseja pesquisar e clique em

"Ver Detalhes".

31




Se quiser ver detalhes de uma

ocorrência, selecione-a e clique

em "Ver Detalhes".

Neste exemplo foi feita uma

pesquisa por data.

32




Se quiser ver detalhes de uma

ocorrência, selecione-a e clique

em "Ver Detalhes".

Neste exemplo foi feita uma

pesquisa por data.

33



Administração – Categorias

Através deste item defini-se a árvore de diretórios onde serãoarmazenados e executados os processos (estas categorias serãoutilizadas nos módulos “Desenho de Processos” e “Área de Trabalho”).

Ao clicar no comando

“Categorias” aparecem, do

lado direito da tela, as

categorias existentes.

Ao expandir a árvore de

“Categorias” não aparecem,

necessariamente, todas as

categorias existentes.

São exibidas somente as que

este usuário tem acesso para

o uso em processos (módulos

“Desenho de Processos” e

“Área de Trabalho”). Utilize estes botões para acrescentar novas categorias

(dentro da que está sendo exibida no momento) e para

alterar ou apagar uma das que existem (neste caso,

selecione a categoria desejada).

Na inclusão e alteração só é possível especificar o

nome e a descrição. A data é colocada pelo ÁGILES.

34



Administração – Lista de Conexões

Permite o cadastramento de listas de conexões para agilizar oacesso a bancos de dados externos ao ÁGILES.

Ao clicar no comando “Lista

de Conexões” aparecem as

conexões existentes.

Utilize estes botões para acrescentar novas conexões,

e para alterar ou apagar uma das que existem (neste

caso, selecione a conexão desejada).

A tela de inclusão e alteração está representada no

próximo slide.

35



Escolha um dos drivers

existentes e ele sugerirá a

URL e o Teste SQL (alguns

não possuem teste).


salve a conexão.


Para incluir ou alterar uma lista de conexão será utilizada atela abaixo.

36



Exemplo de uma

conexão preenchida.


37



Administração – Biblioteca de Funções

Contém as bibliotecas de funções do software. Armazena os grupos defunções nativas, assim como os que forem criados pelos usuários (asfunções serão utilizadas no Desenho dos Processos).

Veja as informações de

instalação do Ágiles para saber

como cadastrar uma nova

biblioteca de funções.

38



Administração – Risco: Ativ. sem Respons.

Toda vez que o ÁGILES for verificar os responsáveis por umaatividade e não conseguir identificá-los, enviará um e-mailpara o grupo responsável por falhas* informando queocorreu um problema na atividade.

* Para definir o grupo responsável por falhas, cadastre-o como um grupo

normal e especifique sua função no arquivo de propriedades agiles.properties

(disponível no diretório onde estão as configurações do ÁGILES).

A linha que diz qual grupo será utilizado para o chamado failureGroup é:

mail.failureGroup=??, onde ?? é o ID do grupo.

Este problema pode ocorrer por diversas razões: o grupo / nóorganizacional / tabela auxiliar que deveria receber a atividadenão possui usuários, houve uma falha de conexão com algumoutro aplicativo (SAP por exemplo), etc.

39



Administração – Risco: Ativ. sem Respons.

Sempre que ocorrer este tipo de falha, o administrador do ÁGILESdeve corrigir o problema que a originou (cadastrar os usuários,restabelecer a conexão, etc.) e acessar o comando “Risco: Atividadessem Responsável” para tentar restabelecer os assignees.


“Risco: Atividades sem

Responsável” aparecem

as atividades que estão

sem Assignee.

Clique em “Resetar

Assignees” para que o

ÁGILES tente redefinir os

responsáveis pela

atividade.

Se ele conseguir,

aparecerá uma

mensagem informando o

sucesso da ação, caso

contrário será

apresentada nova

mensagem de erro.

40



Administração – Modelos de ObjectType

O ObjectType Template é um modelo de representação de umconjunto de informações (entidade), possuindo atributos comtipos variados.

Deve ser criado para representar entidades que não sãonativas do ÁGILES. Exemplo: cliente, pois o cliente teminformações muito semelhantes ao usuário, mas o cadastro deusuários é parte do ÁGILES e o cliente não. Ao clicar no comando

“Modelos de

ObjectType” aparecem

os ObjectTypes ativos.

Utilize estes botões para

acrescentar novos ObjectTypes,

e para manipular os que existem

(nestes casos, exceto para

importação, selecione o modelo

desejado).


estão representadas nos

próximos slides.

41




salve o ObjectType.


No padrão, quando o ÁGILES é instalado não existem ObjectTypes,e eles devem ser criados de acordo com a necessidade.

A definição do conteúdo do ObjectType será feita posteriormente,através da edição do mesmo.

42



Cada item terá uma tela específica

para definição das suas

informações.

Para criar campos, deve-se

escolher o Tipo do mesmo antes

de clicar em Adicionar Novo.


Na edição do ObjectType devem ser definidos os campos, ações,eventos e telas que comporão seu conteúdo.

43



Administração – Dimensões e Níveis Org.

Permite o cadastramento de dimensões e níveis organizacionais,representando a hierarquia da empresa (divisões, unidades,diretorias, cargos).

Utilize estes botões para acrescentar novas dimensões

ou para alterar / remover a que estiver selecionada.

Na inclusão, especifica-se o nome e descrição da

dimensão, e se é permitida a subida de nível (em caso

afirmativo, tarefas enviadas para pessoas deste nível

poderão ser repassadas para os integrantes do nível

superior a ele – isso acontece em conjunto com os nós

organizacionais, que serão vistos adiante).

44




Para visualizar e cadastrar níveis em uma dimensão, clique sobreo nome da mesma. Para incluir sub-níveis, proceda da mesmaforma (assim será possível definir a estrutura hierárquica daempresa).

Clique aqui para incluir níveis nesta dimensão.

Ou clique em um nível e, depois, no botão

Adicionar para incluir sub-níveis.

45




Para visualizar e cadastrar níveis em uma dimensão, clique sobreo nome da mesma. Para incluir sub-níveis, proceda da mesmaforma (assim será possível definir a estrutura hierárquica daempresa).

Clique aqui para incluir níveis nesta dimensão.

Ou clique em um nível e, depois, no botão

Adicionar para incluir sub-níveis.

Neste exemplo está-se

incluindo um sub-nível da

Área Comercial.

46



Administração – Estrutura Organizacional

Permite relacionar as dimensões e níveis com os usuários e grupos,criando "nós organizacionais". Os nós informam quais usuáriose/ou grupos respondem por cada função / área.

Clique aqui para adicionar um novo nó.

Esta tela será exibida no próximo slide.

47




Na inclusão de nós organizacionais, digite o nome e descrição, eclique em "Definir Nível" para escolher a dimensão e o nível quedeseja associar. Deve-se utilizar o botão "Definir Nível" quantasvezes forem necessárias para completar a estrutura deste nó.

Utilize estes

botões para

adicionar e

remover

usuários.

Clique aqui

para escolher

as dimensões

e níveis que

compõem

este nó.

Nessa situação, este

botão tem a função

“cancelar”, ou seja,

abandona a inclusão.

48




Permite relacionar as dimensões e níveis com os usuários e grupos,criando "nós organizacionais". Os nós informam quais usuáriose/ou grupos respondem por cada função / área.

Clique no nome de um nó para

visualizar seu conteúdo.

Nessa situação, este

botão apaga o nó

como um todo.

49



Administração – Risco: Ativ. Bloqueadas

Quando acontecerem problemas em atividades automáticas, seráenviado um e-mail para o grupo responsável por falhas relatando o erro.

A origem do problema pode ser diversa (acesso a outro aplicativo, porexemplo). Quando ocorrer, o administrador do ÁGILES deve corrigi-lae, depois, acessar o comando “Risco: Atividades Bloqueadas” paratentar reativar a atividade.

Ao clicar no comando “Risco:

Atividades Bloqueadas”

aparecem todas as atividades

nesta situação.

Clique em “Reativar

Atividade” para que o ÁGILES

tente executá-la novamente.

Se ele conseguir, aparecerá

uma mensagem informando o

sucesso da ação, caso

contrário será apresentada

nova mensagem de erro.

50



Administração – Visitor Root

Permite a definição da árvore de diretórios onde serão armazenadosos documentos publicados (para consulta pelo módulo Visitante).Esta árvore também pode ser alterada automaticamente pelosprocessos em execução.


“Visitor Root” aparecem os

diretórios existentes.

51



Administração – Módulos Externos

Permite adicionar qualquer outra aplicação web ao Ágiles.

Em geral é utilizado para adicionar aplicações relacionadas aosprocessos implementados (CRUD’s e/ou Reports).

Ao clicar no comando “Módulos

Externos” aparecem as aplicações

cadastradas.


Utilização do Console de

Administração (AdminConsole)

53



AdminConsole

Caro cliente,

o AdminConsole é uma ferramenta que deve ser utilizada única e exclusivamente por profissionais responsáveis por

manter o ambiente ÁGILES em funcionamento (administrador de processos de negócio).

O AdminConsole contém um importante conjunto de comandos que pode alterar o comportamento de um processo. Executar estes comandos sem prévia análise das conseqüências

pode gerar danos irreparáveis.

A IMAGE Technology recomenda que a utilização desta ferramenta esteja restrita aos usuários que tenham feito este treinamento e conheçam as regras de negócios dos processos.

54



AdminConsole

Informações Gerais

– Toda atividade executada nesta ferramenta éregistrada no log do Ágiles, mantendo assim a trilhacompleta de auditoria.

– O AdminConsole está dentro do móduloAdministração do Ágiles na versão 2.0.

55



AdminConsole

Pré-Requisitos

Instalar o JRE - J2SE-Java Runtime Environment (JRE)

versão 1.4.2 (ou V 1.5) http://java.sun.com/j2se/1.4.2/download.html

Usuário:Dar permissão a um usuário ou grupo ao adminconsole


56



Acesso à página

Clicando em Administração / Console Administração

aparecerá esta tela para entrada de comandos.

57



Visão geralInformações de usuário

e Server conectado.

Área para

entrada de

comandos

Área de resposta do

sistema aos comandos

executados

Botão para

executar os

comandos

Fecha todas

as telas

58



HelpComando help exibe todos os

comandos disponíveis no

AdminConsole

Reexecuta o

comando deste

painel

Remove o painel

59



Comandos disponíveis

Available Commands:

help - Shows help message – Exibe todos os comandos disponíveis no AdminConsole

quit|exit - End this program – sai do AdminConsole

detailProcess {PROCESS_INSTANCE_PK} - Show Process Information – Exibe quais atividades foram executadas por aquela instância do processo e as PK’s / nomes dos formulários utilizados.

reactivateActivity {ACTIVITY_INSTANCE_PK} - Reactivates this activity – Reativar uma atividade

showFormValues {PK} - Show Form Values for form with PK, or all forms for process with PK – Exibe o valor contido em cada campo do formulário

setFormValue {PK} {NAME} {VALUE} - Sets attribute named NAME in form PK with value VALUE –Atribui um novo valor para um campo do formulário

addAssignee {ACTIVITY_INSTANCE_PK} [USER_NAME|USER_PK] - Adds an assignee for this activity –Adiciona um responsável pela atividade

showAssignees {ACTIVITY_INSTANCE_PK} - Shows the assignees for this activity – Exibe o responsável pela atividade

60




Available Commands:

suspendActivity {ACTIVITY_INSTANCE_PK} - Suspends this activity – Suspende a atividade

suspendProcess {PROCESS_INSTANCE_PK} - Suspends this process – Suspende o processo

suspendAllProcesses - Suspends all processes. Be careful, very Dangerous – Suspende todos os processos do servidor. Comando muito perigoso não deve ser executado em ambiente de produção.

showMetaData {PK} - Show Metadata for item PK – Exibe o metadata

setMetaData {PK} {NAME} {VALUE} - Sets Metadata named NAME in item PK with value VALUE –Atribui um valor para o metadata

resetAssignees {ACTIVITY_INSTANCE_PK} - Re-evaluates the expression for the assignees – Reexecuta a expressão que identifica o responsável pela atividade.

showScheduledTasks [id] - Finds scheduled Tasks by ID (can be partial) – Exibe todas as atividades que estão programadas.

removeScheduledTasks [id] - Removes scheduled Tasks by ID (can be partial) – Remove uma tarefa programada.

61




Available Commands:

showPendingActivities {[USER_PK]|[USER_NAME]} - Show Pending Activities for User – Exibe as atividades pendentes para um usuário.

setInitiator {PROCESS_INSTANCE_PK} [USER_NAME|USER_PK] - Sets the initiator to a process – Atribui um novo Initiator para uma instância de um processo.

completeActivity {ACTIVITY_INSTANCE_PK} - Completes this activity – Completa a atividade

unPublish PK - Unpublishes an item from the Visitor – Remove a publicação no visitor folder

listVisitorFolders - Lists Visitor Folders – Lista o visitor Folder

showAttachments {PROCESS_INSTANCE_PK} - Show Attachments – Exibe as PK dos arquivos que estão em anexo de uma instância de processo.

detailProcessTemplate {PROCESS_TEMPLATE_VERSION_PK} - Show Process Template Information –Exibe informações do template do processo (todas as pk e descrições das atividades).

activateNewActivity {ACTIVITY_TEMPLATE_PK} {PROCESS_INSTANCE_PK} - Activates a new Activity for a process – Determina uma nova atividade para uma instância do processo.

62



detailProcess

detailProcess {PROCESS_INSTANCE_PK} - Show Process Information – Exibe quais atividades foram executadas por aquela instância do processo e as PK’s / nomes dos formulários utilizados.Encontre a Instance PK do processo (vide coluna ID).

ID = Process_Instance_PK

Você pode identificar as PKs

em “Meus Processos”.

63



detailProcess

Encontre a Instance PK do processo (vide coluna ID).

ID = Process_Instance_PK

Também é possível

identificar as PKs em

“Minhas Atividades”.

64



detailProcess

Nome dado para a

instância

Usuário que iniciou

o processo

Status do processo

(concluído ou em

andamento)

Datas de início e fim do processo

Todas as atividades

que foram

executadas por esta

instância Nome dos

formulários que este

processo utiliza

65



reactivateActivity

reactivateActivity {ACTIVITY_INSTANCE_PK} - Reactivates this activity – Reativar uma atividade

Indicação de que a tarefa foi executada corretamente. Caso

contrário, o sistema exibirá a mensagem de exception (erro)

para análise do problema.

66



showFormValues

showFormValues {PK} - Show Form Values for form with PK, or all forms for process with PK –Exibe o valor contido em cada campo do formulário1) Primeiro você tem que saber a PK do formulário, isto é possível através do comando detailProcess.

PK do formulário

Com o comando detailProcess

você identifica a PK do

formulário

67



showFormValues

PK do formulário que deseja

visualizar o conteúdo

Todos os campos do formulário

e seus valores são relacionados

68



setFormValue

setFormValue {PK} {NAME} {VALUE} - Sets attribute named NAME in form PK with value VALUE –Atribui um novo valor para um campo do formulário

Novo valor, inclusive as aspas

serão adicionadas

PK do formulário

Campo do formulário que

deseja trocar conteúdo

69



setFormValue

Visualização do conteúdo

modificado

70



showAssignees

showAssignees {ACTIVITY_INSTANCE_PK} - Shows the assignees for this activity –Exibe o responsável pela atividade

Usuário responsável por

executar a atividade

71



showAssignee

Atividade sem usuário definido.

72



addAssignee

addAssignee {ACTIVITY_INSTANCE_PK} [USER_NAME|USER_PK] - Adds an assignee for this activity –Adiciona um responsável pela atividade

PK do usuário

Activity instance PK

73



suspendActivity

suspendActivity {ACTIVITY_INSTANCE_PK} - Suspends this activity –Suspende a atividade

74



suspendProcess

suspendProcess {PROCESS_INSTANCE_PK} - Suspends this process –Suspende o processo

75



suspendAllProcess

suspendAllProcesses - Suspends all processes. Be careful, very Dangerous –Suspende todos os processos do servidor. Comando muito perigoso não deve ser executado em ambiente de produção.

76



showMetaData

showMetaData {PK} - Show Metadata for item PK – Exibe o metadata

Metadata é a generalização (abstração) dinâmica (em runTime) de algo (objeto).

Quando utilizar: Você utilizará este comando para visualizar as propriedades deum objectType.

ou

Para visualizar as informações de uma instância de um processo.

Exemplos de uso de metaData:• Guardar uma exception ocorrida em um processo.• Referenciar um processo com os sub-processos (exemplo PMO – IMAGE: os sub-

processos recebem um parâmetro chamado objInstancePK)

77



showMetaData

showMetaData {PK} - Show Metada for item PK – Exibe o metadata

Id do processo

Metadata do processo e

seus valores

78



resetAssignees

resetAssignees {ACTIVITY_INSTANCE_PK} - Re-evaluates the expression for the assignees –Reexecuta a expressão que identifica o responsável pela atividade.

79



showScheduledTasks

showScheduledTasks [id] - Finds scheduled Tasks by ID (can be partial) –Exibe todas as atividades que estão programadas.

80



showScheduledTasks

Posso referenciar um ID ou

parte dele (alias).

81



removeScheduledTasks

removeScheduledTasks [id] - Removes scheduled Tasks by ID (can be partial) –Remove uma tarefa programada.

82



showPendingActivities

showPendingActivities {[USER_PK]|[USER_NAME]} - Show Pending Activities for User –Exibe as atividades pendentes para um usuário.

Relação de atividades

pendentes.

PK do usuário

Administrator

83



setInitiatorsetInitiator {PROCESS_INSTANCE_PK} [USER_NAME|USER_PK] - Sets the initiator to a process –Atribui um novo Initiator para uma instância de um processo.

Define que Fernanda (1-2) será

considerada a INITIATOR desta

instância de processo (119-2109)

84



completeActivity

completeActivity {ACTIVITY_INSTANCE_PK} - Completes this activity – Completa a atividade. Atenção: Este comando não pode ser executado para uma atividade suspensa. Verifique se todas as tarefas obrigatórias foram concluídas. Caso contrário, ocorrerá um erro.

85



unPublish

unPublish PK - Unpublishes an item from the Visitor – Remove a publicação no visitor folder. Para descobrir a PK, clique com o botão direito no form e/ou em relatedItem e selecione a opção properties.

1) Click com o botão

direito do mouse

2) Escolha Propriedades

3) Veja a PK

86



unPublish

87



listVisitorFolders

listVisitorFolders - Lists Visitor Folders – Lista o visitor Folder

Lista completa do

Visitor Folder

88



showAttachments

showAttachments {PROCESS_INSTANCE_PK} - Show Attachments –Exibe as PK dos arquivos que estão em anexo de uma instância de processo.

89



detailProcessTemplate

detailProcessTemplate {PROCESS_TEMPLATE_VERSION_PK} - Show Process Template Information –Exibe informações do template do processo (todas as pk e descrições das atividades).

1) Vá no modulo de desenho de

processos

2) Veja a PK

90



detailProcessTemplate

Relação de atividades deste

template

91



activateNewActivity

activateNewActivity {ACTIVITY_TEMPLATE_PK} {PROCESS_INSTANCE_PK} - Activates a new Activity for a process – Determina uma nova atividade para uma instância do processo.** Tenha certeza de que a atividade atual do processo esteja concluída (o processo pode exigir que alguns campos do formulário estejam preenchidos)** Descubra a PK da atividade para qual você deseja desviar.

1) Com o comando

detailProcessTemplate veja a lista

de atividades do processo

2) Identifique a PK para a

qual você deseja desviar

(ACTIVITY_TEMPLATE_PK)

92



activateNewActivity

** Descubra a PK da instância do processo.

3) Identifique a PK da

instância do processo (em

“Minhas Atividades”) –

PROCESS_INSTANCE_PK

93



activateNewActivity

4) Execute o comando


Obrigado!

Em caso de dúvidas favor entrar em contato com a Image Technology.

(11) 3846-3190

[email protected]

mailto:[email protected]

administração do Ágileswiki.recife.pe.gov.br/files/file/bpm/treinamentos/administracao/... ·...

Documents