Gerando Documentos Automaticamente

O Positivo Network Manager pode gerar automaticamente documentos a partir de ações executadas em seus ativos. Esses documentos se baseiam em modelos previamente cadastrados e faz o uso de substituições de máscaras para montar o documento final.

Para cadastrar a geração automática de um documento, os seguintes passos devem ser seguidos:

  1. Criar um modelo de documento utilizando máscaras
  2. Cadastrar um contador para o documento
  3. Cadastrar um modelo de documento
  4. Cadastrar a geração do documento

1. Criar um modelo de documento utilizando máscaras

Passos para criar um modelo de documento:

Para apresentar dados do Positivo Network Manager em documentos o mecanismo de substituição de máscaras é utilizado. A seguir é explicado como funcionam as máscaras e apresentada uma tabela de máscaras pré-definidas no Positivo Network Manager.

Máscaras de propriedades

Uma máscara de propriedade é aquela que será substituída com o valor de determinada propriedade de um ativo cadastrado no Positivo Network Manager.

Para criar uma máscara utiliza-se o nome da propriedade desejada entre cerquilhas. Caso a propriedade faça parte de um grupo, é necessário colocar o caminho completo até a propriedade separando cada item do caminho por <>. Segue um exemplo de criação de uma máscara para a propriedade Razão Social de um ativo da categoria Site.

Repare que a propriedade Razão Social faz parte do grupo Geral, portanto a máscara deverá ser criada utilizando-se o caminho completo para a propriedade. A máscara ficará:

##Geral<>Razão Social##

Um outro uso de máscaras de propriedade surge quando da necessidade de acessar propriedades de um valor preenchido. Por exemplo, a propriedade Centro de Custo de um software adquirido aponta para um ativo da categoria Site. Supondo que seja necessário saber o responsável pelo site de determinado software adquirido, a seguir é apresentado como criar uma máscara para este caso.

Quando se deseja o valor de propriedades que estão ligadas a outras propriedades é necessário utilizar o separador |. Ele indica ao Positivo Network Manager para buscar por valores em propriedades externas. A máscara para o exemplo do responsável pelo centro de custo de um software adquirido ficaria:

##Centro de Custo|Geral<>Responsável/Contato##

sendo que, se a máscara fosse somente ##Centro de Custo## o valor retornado seria Ativos Operacionais (que é o valor cadastrado como centro de custo do Software Adquirido Exemplo). Mas utilizando a máscara ##Centro de Custo|Geral<>Responsável/Contato##, o valor que será apresentado será o valor preenchido na propriedade Responsável/Contato de Ativos Operacionais (no exemplo, Claudio Emílio Neto).

É possível navegar indefinidamente por propriedades. Se a propriedade Reponsável/Contato apontasse para uma categoria, seria possível utilizar novamente o separador | para acessar valores de propriedades dessa categoria.

 

Máscaras de Contadores

O Positivo Network Manager conta com a substituição de máscaras de contadores, ou seja, é possível cadastrar um contador e utilizá-lo em documentos. Para criar um contador basta adicionar um ativo da categoria Contador no Positivo Network Manager cadastrando seu valor inicial e o tipo de reset. Para utilizar contadores em documentos, utilize umaa máscara no seguinte formato:

##CONTADOR:Nome do contador##

Os contadores não são incrementados cada vez que são encontrados em um modelo de documento. Para ordenar ao Positivo Network Manager que incremente o contador após seu uso é necessário colocar um sinal de + após o nome do contador na máscara. Segue um exemplo que utiliza um contador cujo nome é Contador de Documentos, e que é incrementado cada vez que um documento é gerado:

##CONTADOR:Contador de Documentos+##

 

Máscaras de Pesquisas

É possível também incluir máscaras nas quais o valor substituído é o resultado de uma pesquisa. Para utilizar máscaras de pesquisas é necessário criar uma pesquisa, armazená-la no Positivo Network Manager e preencher a máscara como a seguir:

##PESQUISA:Nome da pesquisa##

O resultado da pesquisa aparecerá como apresentado no executor de pesquisas do Positivo Network Manager, incluindo os estilos na página de resultado.

É possível utilizar pesquisas tanto feitas pela ferramenta Criar Pesquisa quanto pela ferramenta Criar Sql. Também é possível utilizar critérios dinâmicos nas pesquisas, desde que o ativo que gerará o documento satisfaça os critérios. Para mais informações sobre critérios dinâmicos de pesquisas consultar #########.

 

Máscaras pré-definidas pelo Positivo Network Manager

Para facilitar a criação de documentos automaticamente, o Positivo Network Manager disponibiliza máscaras de data, hora e informações sobre a posição do ativo na árvore de ativos. Segue uma tabela de todas as máscaras disponíveis:

 

Máscara Resultado
##INTERNAL_DIA## Retorna o dia do mês em formato numérico.
##INTERNAL_MES## Retorna o mês em formato numérico.
##INTERNAL_ANO## Retorna o ano em formato numérico.
##INTERNAL_HORA## Retorna a hora em formato numérico.
##INTERNAL_MINUTO## Retorna os minutos em formato numérico.
##INTERNAL_SEGUNDO## Retorna os segundos em formato numérico.
##INTERNAL_MES_DO_ANO## Retorna o mês por extenso.
##INTERNAL_DIA_DA_SEMANA## Retorna o dia da semana por extenso.
##INTERNAL_NOME_DO_ATIVO## Retorna o nome do ativo cadastrado na árvore do Positivo Network Manager. O ativo em questão é o gerador do documento.
##INTERNAL_CAMINHO_DO_ATIVO## Retorna o caminho até o ativo na árvore do Positivo Network Manager. O ativo em questão é o gerador do documento.
##INTERNAL_SITE_PAI## Retorna o site em que o ativo está contido na árvore do Positivo Network Manager.
##INTERNAL_GRUPO_PAI## Retorna o grupo em que o ativo está contido na árvore do Positivo Network Manager.
##INTERNAL_SITE_OU_GRUPO_PAI## Retorna ou o grupo ou o site em que o ativo está contido na árvore do Positivo Network Manager.

 

2. Cadastrar um contador para o documento

Um contador é algo importante na geração de documentos já que ele será utilizado no nome de cada documento salvo pelo Positivo Network Manager e também pode ser utilizado no próprio documento durante sua geração.

Para cadastrar um contador:

Todos os contadores cadastrados encontram-se na pasta Documentos/Contadores na árvore de ativos do Positivo Network Manager.

 

3. Cadastrar um modelo de documento

O modelo de documento é um arquivo que será utilizado como base na geração de um documento. No modelo são programadas as máscaras que serão substituídas pelos valores que o Positivo Network Manager possui cadastrado em sua base de dados. Para mais detalhes sobre máscaras consulte a seção ###########. Para se cadastrar um modelo de documento:

Caso o contador utilizado no nome do documento não seja incrementado explicitamente na geração documento, a indicação para incrementar deve ser feita já no nome do arquivo a ser gerado, ou seja, um sinal de + deve ser colocado logo após ao nome do contador. Por exemplo

Relação de Software ##CONTADOR:Cont Doc Gerados + ##.html

 

4. Cadastrar a geração de documentos

Após seguidos os passos acima mencionados é possível cadastrar quando o Positivo Network Manager deverá gerar os documentos. Para cadastrar a geração automática de documentos:

Como um exemplo, suponha que seja necessário gerar um documento quando um novo computador é encontrado e adicionado no Positivo Network Manager. Para isso: