Objetivo
O objetivo deste treinamento é capacitar o desenvolvedor a criar novos campos, alterar telas e criar scripts de automação (Automation Scripts) no IBM Maximo. O nível deste treinamento é apenas introdutório, ou seja, poderá capacitar o desenvolvedor a iniciar as atividades de customizações no sistema.
A MaximoCon fornece diversos treinamentos para sua equipe, tanto técnicos quanto funcionais. Consulte-nos para maiores informações!
Regras de Negócio
O cliente solicitou uma forma de distinguir as Ordens de Serviço em internas e externas. As Ordens internas são tarefas realizadas para a própria empresa, enquanto as Ordens externas são serviços executados para terceiros. Como a empresa não utiliza um industry solution como o Service Provider, uma customização inicial foi solicitada para facilitar o trabalho da manutenção. Com base na solicitação do cliente, a seguinte regra foi escrita:
Inserir um campo do tipo ‘check box’ na Ordem de Serviço denominado “Interno”. Este campo, se marcado pelo usuário, deve realizar as seguintes ações:
- Colocar os campos a seguir vazios e somente leitura:
- Ativo;
- Conta Contábil;
- Preencher o campo prioridade com 5;
- Preencher o campo Tipo de Serviço com “INT”;
Definir o campo Local como obrigatório. |
Atribuições do desenvolvedor
Com a regra detalhada, precisaremos executar as tarefas a seguir:
- Criar um novo campo no Configurador de Banco de Dados;
- Inserir este campo na tela de Rastreamento de Ordem de Serviço;
- Criar um script de automação para o novo campo;
Desenvolvimento
A partir deste ponto detalharemos os aspectos técnicos da solução, como criação do campo, alteração em tela e regras de negócio (com a utilização de Script de Automação). O desenvolvimento deve ser executado na sequência para que não ocorra falha de dependências.
Criando novo campo
O campo a seguir deve ser criado acessando a aplicação “Configuração do Banco de Dados” no caminho a seguir:
Acessando a aplicação “Configuração do Banco de Dados”, busque o objeto WORKORDER (=WORKORDER):
Acesse a aba “atributos” e clique em “nova linha” para definirmos o novo campo:
Preencha os campos conforme a tabela a seguir:
| OBJETO: WORKORDER |
| Atributo |
Título / Descrição |
Tipo |
Tamanho |
Domínio |
Mesmo do… |
Tipo de Busca |
| CUST_INT |
Interno / Identifica se a Ordem de Serviço é interna |
YORN |
(PADRÃO) |
– |
– |
EXACT (PADRÃO) |
O atributo do tipo YORN cria um campo BOOLEAN no banco de dados, que aceita apenas valores binários (0 ou 1). O tipo de busca “EXACT”, informa que o usuário pode pesquisar pelo campo apenas inserindo valores equivalentes ao inserido no banco de dados. O tipo “WILDCARD” permite a busca parcial, especialmente utilizado para campos de texto, onde é possível buscar os campos inserindo trechos do valor total, compreendidos entre o símbolo “%”.
Agora, salve o registro ( 
) e retorne para a guia lista. Isto pode demorar um pouco, já que alterando o objeto WORKORDER, o Maximo também altera suas views.
O campo ainda não foi criado. Para isso, precisamos rodar o configurador do banco de dados que basicamente transforma os metadados (informações sobre os dados) em dados (alteração física no banco). No momento, temos o objeto MAXATTRIBUTECFG (entre alguns outros) com a alteração, conforme mostra a imagem a seguir:
O campo ‘changed’ <> ‘N’ busca todos as alterações ainda não efetivadas. Agora precisamos dessa alteração persistida no objeto MAXATTRIBUTE. Veja que os registros ainda não foram criados nesta tabela:
Observe que o CFG significa ConFiGuração, ou seja, o campo está na configuração, mas ainda não foi efetivado.
Para que nosso objetivo seja alcançado, precisamos rodar o configdb, que efetivará as alterações fisicamente no banco de dados e as incluirá na MAXATTRIBUTE.
Sempre que for efetivar qualquer alteração no banco de dados do Maximo, siga os passos abaixo:
- Clique em “Gerenciar modo administrativo”:
- Clique em “Ligar modo admin”:
(Esta ação é necessária, pois como realiza alterações estruturais no banco de dados, os usuários precisam ser deslogados).
É preciso aguardar até que todos os processos do Maximo sejam liberados para a execução do modo administrativo:
Agora é necessário aplicar as alterações para que o campo seja criado:
Marque a opção informando que você possui um backup (recomendado caso aconteça algum problema):
Informe os dados de autenticação e motivo da alteração:
Fique atento às mensagens exibidas no processo. Caso o configurador seja executado com sucesso, a mensagem “ConfigDB completed without erros”.
Jamais se esqueça de desativar o modo administrativo, ou alguns recursos do IBM Maximo não funcionarão:
Após alguns segundos…
Alteração de tela
Para incluir o novo campo na tela de “Rastreamento de Ordem de Serviço” acesse o aplicativo no caminho a seguir:
Acessando a aplicação “Editor de Telas”, busque o objeto WOTRACK (=WOTRACK):
WOTRACK é um arquivo XML que contém todos os componentes do IBM Maximo para o carregamento do aplicativo de OS.
Acesse a guia “Ordem de Serviço” para que possamos inserir o novo campo. Clique na paleta de controle:
Arraste a “Caixa de Seleção” para a tela, conforme as imagens a seguir:
Clique no botão de propriedades de controle:
Na próxima janela, informe o nome do atributo que criamos no capítulo anterior:
Agora temos o campo que criamos no banco de dados disponível na tela de “Rastreamento de Ordem de Serviço”:
Salve o registro ( ) e acesse o aplicativo “Rastreamento de Ordem de Serviço” para conferir:
Script de Automação
A regras abaixo deve ser executada através de um script de automação de atributo:
Criar um script para o campo “Interno” (WORKORDER.CUST_INT). Este campo, se marcado pelo usuário, deve realizar as seguintes ações:
- Colocar os campos a seguir vazios e somente leitura:
- Ativo;
- Conta Contábil;
- Preencher o campo prioridade com 5;
- Preencher o campo Tipo de Serviço com “INT”*;
Definir o campo Local como obrigatório.
| Caso o tipo de serviço “INT” não esteja cadastrado, acesse a aplicação de “Organizações” no módulo “Administração”, vá em selecionar ação, Opções de Ordens de Serviço -> Tipo de Serviço e adicione o valor “INT”:
|
Acesse a aplicação no caminho a seguir:
Crie um script de automação com ponto de ativação de atributo:
Na primeira tela de criação do novo script, vale destacar algumas informações:
- Insira o nome do ponto de ativação. Procure utilizar um nome que facilite a busca em ambientes com muitos scripts, como LP_WO_CUST_INT (Tipo do objeto, tabela, campo).
- Selecione o objeto e o atributo para os quais este ponto de ativação será acionado. No caso estamos trabalhando com WORKORDER.CUST_INT (Interno de “Rastreamento de Ordem de Serviço”).
- O evento de seleção para o qual você deseja definir o ponto de ativação é “Executar Ação”. No caso, quando o usuário marcar ou desmarcar o campo “Interno”, o script será acionado”.
No próximo passo, preencha as informações a seguir:
No primeiro quadro, insira o nome do script e a linguagem. Trabalhamos com Java Script por ter uma sintaxe mais amigável. Outra linguagem muito utilizada é python.
No segundo quadro, precisamos atribuir as variáveis que serão manipuladas no script:
- ASSETNUM (Ativo)
- LOCATION (Local)
- GLACCOUNT (Conta Contábil)
- WOPRIORITY (Prioridade da OS)
- WORKTYPE (Tipo de Serviço)
- CUST_INT (Interno)
Essas variáveis são inseridas neste ponto para que estejam disponíveis diretamente no script.
Na etapa 3, definimos o script com a regra de negócio:
Salve o script para finalizar.
Certifique-se de que as variáveis sejam definidas da seguinte forma (é possível acessá-las) depois da finalização do script na aba “Pontos de Ativação”:
Caso queira copiar o código do script:
|
if (CUST_INT) {
ASSETNUM_readonly = false;
ASSETNUM = “”;
ASSETNUM_readonly = true;
GLACCOUNT = null;
GLACCOUNT_readonly = true;
WOPRIORITY = 5;
WORKTYPE = “INT”;
LOCATION_required = true;
} else {
ASSETNUM_readonly = false;
GLACCOUNT_readonly = false;
LOCATION_required = false;
}
|
Há algumas outras opções de scripts de automação, como ações em cima de objetos que podem executar regras de inicializar, validar e ou salvar. Também podemos utilizar scripts para regras de integrações e outros eventos no sistema. Cobriremos essas e outras opções em um outro documento.
Testes
Por último e tão importante quanto o desenvolvimento, chegou o momento de testar. Acesse novamente a aplicação “Rastreamento de Ordem de Serviço”:
Criando uma nova Ordem de Serviço, insira um Local e um Ativo:
Agora marque o campo “Interno”:
Conforme o esperado:
- Campo Ativo (WORKORDER.ASSETNUM) somente leitura e vazio;
- Campo Local (WORKORDER.LOCATION) obrigatório;
- Campo Tipo de Serviço (WORKORDER.WORKTYPE) com valor “INT”;
- Campo Conta Contábil (WORKORDER.GLACCOUNT) somente leitura e vazio;
- Campo Prioridade (WORKORDER.WOPRIORITY) com valor 5;
Agora precisamos verificar o que ocorre quando o campo “Interno” é desmarcado:
Não vimos na especificação, mas nos parece óbvio que o campo Local não deve permanecer obrigatório e os campos Ativo e Conta Contábil não devem permanecer somente leitura.
Realize quantos testes julgar necessário e faça ajustes para aprimorar o código. Não deixe de tentar cobrir todos os cenários viáveis para o desenvolvimento.
Caso queira acessar o conteúdo completo desta aula em VIDEO, acesse o LINK a seguir:
Video Aula Automação no MAXIMO
Figura 1. Exemplo de fluxo de trabalho de um setor de manutenção preventiva
