administração do Ágiles - secretaria de planejamento e
TRANSCRIPT
Administração
do Ágiles
2
Objetivo
O objetivo desse manual é detalhar todos os módulos da sessão de Administração do
Ágiles.
Esse manual é dividido em duas partes. Na primeira serão explicados os módulos de
administração. E na segunda abordará os principais comando do AdminConsole.
3
Sumário Objetivo ......................................................................................................................................... 2
Acessando o Ágiles ........................................................................................................................ 5
Administração do Ágiles ................................................................................................................ 8
Biblioteca de Funções ............................................................................................................... 9
Categorias ................................................................................................................................ 10
Console de Administração....................................................................................................... 11
Detalhes de Licença e Servidor ............................................................................................... 12
Dimensões e Níveis Organizacionais ....................................................................................... 13
Estrutura Organizacional ......................................................................................................... 15
Grupo....................................................................................................................................... 17
Histórico de Login .................................................................................................................... 19
Lista de Conexões .................................................................................................................... 20
Modelo de ObjectType ............................................................................................................ 21
Atividades Bloqueadas ............................................................................................................ 26
Consumidores de Sinal Registrado .......................................................................................... 27
Eventos de Sinal Lançados ...................................................................................................... 28
Atividades com Erro ................................................................................................................ 29
Atividades sem Responsável ................................................................................................... 30
Eventos de Sinal Com erro ...................................................................................................... 31
Monitoramento de Execução .................................................................................................. 32
Processos Parados ................................................................................................................... 32
Módulos Externos ................................................................................................................... 33
Permissão de Acesso ............................................................................................................... 34
Relatório de Permissões .......................................................................................................... 37
Trilha de Auditoria ................................................................................................................... 38
Usuário .................................................................................................................................... 41
Usuários Logados .................................................................................................................... 44
Visitor Root .............................................................................................................................. 45
AdminConsole ............................................................................................................................. 46
4
Help ......................................................................................................................................... 47
completeActivity ..................................................................................................................... 48
detailProcess ........................................................................................................................... 50
reactivateActivity .................................................................................................................... 52
resetAllAssignees .................................................................................................................... 54
resetAssignees ......................................................................................................................... 55
suspendActivity ....................................................................................................................... 57
suspendProcess ....................................................................................................................... 59
unlockActivity .......................................................................................................................... 61
suspendAllProcesses ............................................................................................................... 63
Como deixar ativo um processo suspenso .............................................................................. 64
5
Acessando o Ágiles
Para acessar o Ágiles, deve-se digitar no navegador o endereço do Ágiles. Este
endereço varia dependendo da instalação.
Em seguida digita-se o usuário e senha do administrador. Por padrão de instalação:
Usuário: administrator
Senha: admin
Essa senha deve ser alterada, por questão de segurança.
6
Após entrar no sistema, será exibida a seguinte tela:
7
Para abrir o modulo de administração, deve-se clicar no botão destacado a imagem abaixo:
8
Administração do Ágiles
A imagem a seguir ilustra os módulos de administração que serão detalhados a seguir.
9
Biblioteca de Funções
Esse modulo lista as biblioteca de funções do software. Armazena os grupos de
funções nativas, assim como os que forem criados pelos usuários (as funções serão utilizadas
no Desenho dos Processos).
10
Categorias
Através deste modulo define-se a árvore de diretórios onde serão armazenados e
executados os processos (estas categorias serão utilizadas nos módulos “Desenho de
Processos” e “Área de Trabalho”).
Para criar uma categoria deve-se clicar no botão “Adicionar”, destacado na imagem a
seguir.
Em seguida devem-se preencher os campos “Nome” e “Descrição”. E em seguida clica
no botão “Salvar”
11
Em seguida a nova categoria estará listada na pagina desse modulo.
Console de Administração
Com esse modulo é possível dar manutenção nas instancias dor processos. O próximo
modulo desse manual será dedicado a esse modulo.
12
Detalhes de Licença e Servidor
Nesse modulo é possível verificar os detalhes da licença do Ágiles e informações do
servidor.
13
Dimensões e Níveis Organizacionais
Permite o cadastramento de dimensões e níveis organizacionais, representando a
hierarquia da empresa (divisões, unidades, diretorias, cargos).
Por exemplo, é possível elaborar uma estrutura onde, numa empresa existam duas
unidades (São Paulo e Rio de Janeiro) e dois níveis de cargo (Gerente e Diretor)
14
Para criar os níveis é deve-se utilizado o botão “Adicionar Nivel”.
Montada essa estrutura no modulo “Estrutura organizacional” serão criados os Nós
para relacionar aos usuários.
15
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ários e/ou grupos respondem por cada função /
área.
Na inclusão de nós organizacionais, digite o nome e descrição, e clique em "Definir
Nível" para escolher a dimensão e o nível que deseja associar. Deve-se utilizar o botão "Definir
Nível" quantas vezes forem necessárias para completar a estrutura deste nó.
16
17
Grupo
Permite cadastrar grupos de usuários. O agrupamento é conveniente para que se
possa atribuir permissões, atividades e/ou tarefas para diversos usuários de uma vez.
No padrão, quando o ÁGILES é instalado não existem grupos, e eles devem ser criados
de acordo com a necessidade.
Para a criação de um novo grupo de usuários, deve-se clicar no botão “Adicionar
Novo”, destacado na imagem abaixo:
Na tela seguinte deve-se preencher o campo “Nome”, “Descrição” (não obrigatório). Também
é possível, de já adicionar a esse novo grupo os usuários, para isso deve-se clicar no “+” na
sessão “Usuários deste Grupo”.
18
Quando finalizar o preenchimento, deve-se clicar no botão “Salvar” para finalizar a operação.
19
Histórico de Login
Neste modulo é possível listar os usuários que logaram no sistema. Para isso, deve-se
preencher os campos do filtro e em seguida clicar no botão “Buscar”
20
Lista de Conexões
Permite o cadastramento de listas de conexões para agilizar o acesso a bancos de
dados externos ao ÁGILES.
Para incluir uma lista de conexão deve-se clicar no botão “Adicionar Novo”.
Na tela seguinte deve preencher os dados da conexão.
No campo “Driver” possui a seguintes opções:
Após preencher os dados, deve-se clicar no botão “Salvar” para finalizar.
21
Modelo de ObjectType
O ObjectType Template é um modelo de representação de um conjunto de
informações (entidade), possuindo atributos com tipos variados.
Para criar um OT novo, deve-se clicar no botão “Adicionar Novo”.
E em seguida preencher os campos
22
Para editar um OT deve-se clicar no botão “Editar Selecionado”
Na edição do ObjectType devem ser definidos os campos, ações, eventos e telas que
comporão seu conteúdo.
23
Também existe a opção de exportar um ObjectType, para ser usado em outra base, pro
exemplo. Para fazer isso se deve selecionar o OT e depois clicar no botão “Exportar”
E ira abrir a tela para fazer o download
24
Caso seja necessário importar um OT, deve-se clicar no botão “Importar”.
Na tela seguinte, clicar no botão “Escolher arquivo”.
25
Ira abrir uma tela para escolher o arquivo do OT
Caso o OT selecionado tenha que substituir um já existente, deve-se selecionar o
checkbox “Substituir”.
E para finalizar a importação deve-se clicar no botão “Salvar”
26
Atividades Bloqueadas
Para evitar que dois (ou mais) usuários de um grupo, peguem a mesma atividade para
realizar, o Ágiles bloqueia atividade para o primeiro usuário que entrou nela.
Uma vez bloqueada uma atividade a um usuário, este tem que realiza-la. Porem caso
seja necessário que outro usuário acesse essa atividade, será necessário, primeiro desbloquear
a atividade do primeiro usuário. Para isso é utilizada esse modulo.
Para desbloquear uma ou mais atividades, elas devem ser pesquisadas, selecionadas e
em seguida deve-se clicar no botão “Liberar”. Destacado na imagem a seguir.
27
Consumidores de Sinal Registrado
Esse modulo lista todos os sinais que estão ativos esperando ser chamados.
28
Eventos de Sinal Lançados
Esse modulo lista todos os sinais que foram lançados pelos processos
29
Atividades com Erro
Esse módulo lista todas a atividades que estão com erro.
Na frente de cada atividade com erro, existe um link “Reativar Atividade”. Depois que correção
do erro estiver no ar, esse link reativara a atividade e ela seguira o fluxo.
Se esse link for clicado antes da correção, a atividade será reativada e o erro ocorrerá
novamente.
30
Atividades sem Responsável
Toda vez que o ÁGILES for verificar os responsáveis por uma atividade e não conseguir
identificá-los, enviará um e-mail para o grupo responsável por falhas informando que ocorreu
um problema na atividade.
Este problema pode ocorrer por diversas razões: o grupo / nó organizacional / tabela auxiliar
que deveria receber a atividade não possui usuários, houve uma falha de conexão com algum
outro aplicativo (SAP por exemplo), etc.
Sempre que ocorrer este tipo de falha, o administrador do ÁGILES deve corrigir o problema
que a originou (cadastrar os usuários, restabelecer a conexão, etc.) e acessar o comando
“Risco: Atividades sem Responsável” para tentar restabelecer os assignees.
31
Eventos de Sinal Com erro
Esse modulo lista os sinais enviados que estão com erro.
32
Monitoramento de Execução
Esse modulo monitora todos os processos que estão rodando na engine do Ágiles.
Processos Parados
Este modulo lista as instancias de processos que estão parados no Ágiles. Um processo fica
parado quando não possui uma atividade ativa.
33
Módulos Externos
Neste modulo é possível registrar módulos externos ao Ágiles. Para registra um novo modulo
deve-se clicar no botão “Adicionar Novo”
Em seguida deve-se preencher os campos “Nomes”, “Descrição” e “URL da Tela”. Se selecionar
o campo “Enviar dados para autenticação” o Ágiles verificar se o usuário esta logado antes de
abrir a pagina.
Em seguida deve clicar no botão “Salvar” para finalizar
34
Permissão de Acesso
Nessa sessão é possível dar as permissões no Ágiles. Existem seis tipos de permissão.
Permissão de Categoria: quando é necessário dar permissão em alguma categoria do Ágiles.
(categoria criada no modulo “Categoria” da Administração)
Permissão de Item: quando precisamos dar permissão a um item especifico do Ágiles, pode
ser para um template de processo, ou mesmo para uma versão especifica de template.
Permissão de Módulos: quando é necessário dar permissão para os módulos do Ágiles.
Permissão de Módulos Externos: quando é necessário dar permissão para algum Modulo
externo.
Permissão de Object Type: quando é necessário dar permissão nos ObjectType.
Permissão de Visitante: quando é necessário dar permissão nos diretórios do Visitante.
Para qualquer tipo de permissão o funcionamento é sempre o mesmo:
Primeiramente, dentre de um dos módulos de permissão, deve-se escolher um ou mais itens
que deseja dar a permissão. E em seguida clicar no botão “Editar Permissão”
35
Em seguida, deve-se escolher um usuário ou grupo que será dado a permissão.
E em seguida deve-se clicar no botão “Editar Permissão”
E o ultimo passo é especificar a permissão. Para cada item é possível escolher:
Sim: liberar permissão
Não: Não liberar permissão
Não Definido: Terá acesso, se outra permissão, lhe der acesso
36
É importante ressaltar que é necessário dar “permissão de modulo” para que um
módulo seja visível no menu do lado esquerdo do Ágiles. E também é necessário dar a
permissão referente a cada modulo.
Por exemplo: se for dar permissão de “Modulo Externo”, será necessário utilizar o
“Permissão de Modulo” para exibir a opção “Modulo Externo” no menu do Ágiles.
Depois será necessário utilizar a “Permissão de Módulos Externos” para dar
permissões em quais módulos externo será dado à permissão de acesso.
37
Relatório de Permissões
Nesse modulo é possível visualizar as permissões de acesso dos módulos.
38
Trilha de Auditoria
O ÁGILES registra todas as transações ocorridas durante seu uso, desde logins até atividades
realizadas, e a Trilha de Auditoria permite a consulta destas movimentações.
Para fazer uma pesquisa devem-se preencher as informações e em seguida clicar no botão
“Ver Detalhes”
Como exemplificado na imagem a seguir
39
Segue algumas opções que pode ser preenchido no campo “Ação”:
login
my activities
visitor
Initial Page
Show External Module
console
List Login History
Ao clicar no botão “Ver Detalhe” é listado o resultado. Caso queira ver os detalhes de uma
ocorrência, deve-se seleciona-la e clicar no botão “Ver detalhes”.
40
41
Usuário
Nesse modulo é listado todos os usuário do sistema. Para criar um novo usuário deve-se clicar
no botão “Adicionar usuário” destacado na imagem abaixo.
Será exibida a tela seguinte onde devem ser preenchidos os dados do novo usuário
42
Também é possível editar um usuário já existente. Para isso deve-se selecionar o usuário e em
seguida clicar no botão “Editar informações do usuário”, destacada na imagem a seguir.
43
Na próxima tela é possível editar as informações do usuário. Também é possível desabilitar o
usuário, para isso deve-se desmarcar a opção “Ativo”
Também existem as seguintes opções:
1. Adicionar a um Grupo
2. Adicionar a um Nó
3. Criar senha
4. Trocar senha
5. Substituir
6. Salvar
7. Voltar
44
Usuários Logados
Neste modulo é possível visualizar os usuários que estão logados no Ágiles. È possivel,
selecionar um ou mais usuários e o desconectar, utilizando o botão “desconectar”.
Também é possível enviar alguma mensagem aos usuários logados. Para isso, seleciana
os usuários que devem receber a mensagem. Depois preencher os campos “Titulo” e “Corpo” e
em seguida clicar no botão “Enviar Mensagem”
45
Visitor Root
Permite a definição da árvore de diretórios onde serão armazenados os documentos
publicados (para consulta pelo módulo Visitante).
Esta árvore também pode ser alterada automaticamente pelos processos em execução.
Para criar um diretório deve-se clicar no botão “Adicionar Novo”, destacado na imagem abaixo
Na próxima tela, devem-se preencher os campos “Nome” e “Descrição” e em seguida clicar no
botão “Salvar” para finalizar.
46
AdminConsole
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 consequências pode
gerar danos irreparáveis.
Toda atividade executada nesta ferramenta é registrada no log do Ágiles,
mantendo assim a trilha completa da auditoria.
47
Help
O comando “Help” serve para listar todos os comandos do AdminConsole
48
completeActivity
O comando “completeActivity” serve para forçar completar uma atividade.
Sintaxe:
completeActivity {ACTIVITY_INSTANCE_PK}
Para conseguir o {ACTIVITY_INSTANCE_PK}, na tela de “Minhas atividades” deve-se localizar a
atividade que devera ser completada. Clicar no ícone “Mais informações”, destacado abaixo.
Ai ira ser exibida a pk da instancia do processo.
49
Com essa pk, é rodado o comando, como ilustrada na imagem a seguir.
50
detailProcess
Esse comando serve para detalhar o fluxo que o processo passou.
Sintaxe:
detailProcess {PROCESS_INSTANCE_PK}
Para conseguir o { PROCESS_INSTANCE_PK }, na tela de “Minhas atividades” deve-se
localizar a atividade que devera ser completada. Clicar no ícone “Mais informações”,
destacado abaixo.
51
Com essa pk, é rodado o comando, como ilustrada na imagem a seguir.
52
reactivateActivity
Esse comando é utilizado quando é necessário reativar uma atividade
Sintaxe:
reactivateActivity {ACTIVITY_INSTANCE_PK}
Para conseguir o {ACTIVITY_INSTANCE_PK }, na tela de “Minhas atividades” deve-se localizar a
atividade que devera ser completada. Clicar no ícone “Mais informações”, destacado abaixo.
53
Com essa pk, é rodado o comando, como ilustrada na imagem a seguir.
54
resetAllAssignees
Esse comando serve para redefinir os usuários de todas as atividades instanciadas no Ágiles.
Será definido o usuário em relação ao que foi definido no desenho do processo.
Caso haja muitas instancias de processo na base, esse comando pode ser demorado.
Sintaxe:
resetAllAssignees
55
resetAssignees
Esse comando serve para redefinir o usuário de uma atividade. Será definido o usuário
em relação ao que foi definido no desenho do processo.
Sintaxe:
resetAssignees {ACTIVITY_INSTANCE_PK}
Para conseguir o {ACTIVITY_INSTANCE_PK }, na tela de “Minhas atividades” deve-se
localizar a atividade que devera ser completada. Clicar no ícone “Mais informações”,
destacado abaixo.
56
Com essa pk, é rodado o comando, como ilustrada na imagem a seguir.
57
suspendActivity
Esse comando serve para suspender uma atividade.
Sintaxe:
suspendActivity {ACTIVITY_INSTANCE_PK}
Para conseguir o {ACTIVITY_INSTANCE_PK }, na tela de “Minhas atividades” deve-se localizar a
atividade que devera ser completada. Clicar no ícone “Mais informações”, destacado abaixo.
58
Com essa pk, é rodado o comando, como ilustrada na imagem a seguir.
59
suspendProcess
Esse comando serve para suspender uma instancia de processo.
Sintaxe:
suspendProcess {PROCESS_INSTANCE_PK}
Para conseguir o { PROCESS_INSTANCE_PK }, na tela de “Minhas atividades” deve-se localizar a
atividade que devera ser completada. Clicar no ícone “Mais informações”, destacado abaixo.
60
Com essa pk, é rodado o comando, como ilustrada na imagem a seguir.
61
unlockActivity
Esse comando serve para desbloquear uma atividade. Essa operação também pode ser feita no
modulo “Atividades Bloqueadas”
Sintaxe:
unlockActivity {ACTIVITY_INSTANCE_PK}
Para conseguir o {ACTIVITY_INSTANCE_PK }, na tela de “Minhas atividades” deve-se localizar a
atividade que devera ser completada. Clicar no ícone “Mais informações”, destacado abaixo.
62
Com essa pk, é rodado o comando, como ilustrada na imagem a seguir.
63
suspendAllProcesses
Esse comando serve para suspender TODAS às instancias de atividades do Ágiles.
Sintaxe:
suspendAllProcesses
64
Como deixar ativo um processo suspenso
Se um processo foi suspenso e por algum motivo é necessário deixa-lo ativo
novamente, devem-se executar os seguintes comandos:
setprocessstatus <PK da instancia do processo> status.process.running
reactivateactivity <Pk da instancia da ultima atividade do processo>