Mapeamentos para a importação de ativos de arquivos XML

Este tópico explica como definir os mapeamentos necessários para importar ativos de arquivos XML através de uma tarefa de integração. Esses mapeamentos devem ser inseridos no campo Configurações de Mapeamento durante a criação da tarefa. Para detalhes sobre como criar a tarefa em si, veja o Capítulo 17: Administração -> Integrações -> Criação de uma tarefa para importar ativos de arquivo XML.

Abaixo estão listados todos os campos que devem ser mapeados para cadastrar um ativo a partir de um arquivo XML. Todos os atributos customizados de ativos, com exceção de atributos dos tipos Relacionamento, Anexo e Fórmula, podem ser mapeados através da tarefa de integração.

Variável	Descrição	Obrigatório?		Limite/Formato
Source	Identifica de onde os ativos foram importados.	Sim		100 caracteres
Id	Identificador único para o ativo.	Sim		N caracteres
name	Nome do ativo.	Sim		400 caracteres
type	Tipo do ativo.	Sim		Tecnologia, Pessoa, Ambiente, Processo, ou nome do tipo customizado de ativo.
description	Descrição do ativo.	Não		N caracteres
hostaddress	Endereço host do ativo, que pode ser um nome DNS, um nome NetBIOS ou um endereço de IP.	Não		100 caracteres
relevance	Relevância do ativo. Por padrão, é definida como 3.	Não		1 - 5
analysisFrequency	Frequência, em dias, com que o ativo deve ser analisado.	Não		0 - 1000
responsible	Pessoa responsável pelo ativo, definida por padrão no mapeamento.	Não		Nome de uma pessoa cadastrada no sistema.
criticality	Criticidade do ativo.	Não		0 - 100
location/latitude	Latitude da localização do ativo.	Não		-90 a +90
location/longitude	Longitude da localização do ativo.	Não		-180 a +180
location/description	Descrição da localização do ativo.	Não	1000 caracteres

Observe que se o campo para definir a pessoa responsável pelo ativo for deixado em branco ou se houver mais de uma pessoa com o nome fornecido, a pessoa selecionada na criação da tarefa no campo Responsável pelos Objetos Importados será alocada como responsável pelo ativo. Para assegurar que uma pessoa tenha uma identificação única, pode ser utilizada uma combinação do seu nome e do seu endereço de e-mail.

Exemplo 1:

Arquivo XML:

<responsible email="joao.silva@dominio.com">Joao Silva</responsible>

Mapeamento:

Exemplo 2:

Arquivo XML:

<responsible >Joao Silva</responsible>

<email>joao.silva@dominio.com</email>

Mapeamento:

Para escrever esses mapeamentos, você deve informar o nó em que cada ativo está localizado. Essa configuração é feita através do basePath escrevendo o Xpath absoluto do respectivo caminho no arquivo XML. Desse ponto em diante, os campos devem ser mapeados através do Xpath relacionado a esse basePath. O basePath pode ser agrupado por tipo de ativo, permitindo que diferentes tipos de ativo tenham comportamentos distintos em uma única tarefa de integração. Se existirem condições mais complexas que não são atendidas separando os tipos de ativo, devem ser criadas tarefas de integração separadas para categorizar essas informações.

Os seguintes recursos também estão disponíveis:

• Conversão/mapeamento dos valores para que correspondam aos valores aceitos pelo sistema. Por exemplo:

</mappings>

</relevance>

• Conversão do conteúdo em um hash md5. Observe que alguns softwares não fornecem um identificador único para cada ativo, sendo necessário gerar esse identificador único. No exemplo, esse identificador é gerado a partir do atributo customizado de nome "IDunico".

• Definição de valores padrão para os campos não incluídos no arquivo, ou que devem ser importados sempre com um valor padrão.

• Limitação do tamanho de um determinado campo para respeitar os limites do sistema. Se não for definido um limite, um erro irá ocorrer cada vez que for importado um arquivo cujo conteúdo exceda o limite permitido. Se o parâmetro "truncate" não for utilizado, o sistema considera que ele tem o valor "false".

• Definição de mapeamentos para tipos customizados e padrão de ativo.

</mappings>

</type>

• Definição de mapeamentos para atributos customizados de ativos, onde os seguintes tipos de atributos customizados são suportados: Data/Hora (Data somente, Data/Hora e Hora somente), E-mail, Link, Lista de Opções (Seleção Única e Seleção Múltipla), Número (respeitando os valores máximo e mínimo e o número de casas decimais), Parágrafo, Texto (respeitando os valores máximo e mínimo e a máscara de expressão regular) e Tópicos (Lista de Marcador e Lista Numerada).

Observe que os valores presentes no arquivo devem ser compatíveis com os valores aceitos pelo atributo. Caso contrário, nenhum ativo será importado e uma mensagem de erro será exibida no histórico da tarefa de integração. Assim, valores máximos e mínimos, número de casas decimais e quaisquer máscaras de expressões regulares definidos para os atributos devem ser respeitados. A variável do atributo deve ser utilizada ao criar os mapeamentos.

</customAttributes>

• Definição do formato de números e datas, de acordo com o formato definido para um idioma. Esse recurso é utilizado através do parâmetro "culture" e está disponível para atributos Data/Hora (Data somente, Data/Hora e Hora somente) e Número. Por exemplo:

Double: 83,29 utilizando vírgula. Pode ser lido na cultura "pt".

Double: 83.29 utilizando ponto. Pode ser lido na cultura "en".

Para mais informações sobre a cultura, consulte http://msdn.microsoft.com/en-us/goglobal/bb896001.aspx.

• Definição de mapeamentos de propriedades através do Xpath.

Arquivo XML:

<tag name="nome-netbios">MODSIC-SERVER</tag>

</HostProperties>

Mapeamento: