Este tópico explica como criar uma tarefa de integração para importar ativos de um arquivo XML. Isso permite que os ativos listados em arquivos XML sejam cadastrados automaticamente na estrutura organizacional e sejam mantidos atualizados.
Observe que essa tarefa não contempla a importação de componentes de ativo.
Os arquivos XML podem ter estruturas específicas para seus cabeçalhos, seções, tags de identificação de conteúdo e outros elementos. Uma terminologia diferente também pode ser utilizada para se referir às mesmas propriedades. Por exemplo, o nome do ativo no arquivo XML pode ser encontrado no campo "Asset Name", enquanto no sistema esse campo é chamado de "Name". Para que as informações sejam importadas corretamente, os termos que aparecem nesses campos devem ser mapeados para os campos correspondentes no sistema.
Além disso, é possível que uma determinada propriedade de um ativo não esteja incluída no arquivo XML, o que pode causar problemas quando a tarefa for executada. Se um campo for opcional no sistema e for deixado em branco ou não existir no arquivo XML, não haverá erros na importação. No entanto, se um campo de preenchimento obrigatório não for incluído no arquivo XML, ocorrerá um erro quando a tarefa de integração for executada. Para evitar esse problema, um valor padrão pode ser definido para cada campo de preenchimento obrigatório que for deixado em branco ou que esteja omitido nos arquivos XML. Observe que se os ativos cadastrados em um arquivo XML forem os mesmos cadastrados em outro arquivo XML a ser integrado ao sistema através de uma segunda tarefa, a informação não será consolidada e é possível que haja ativos duplicados. Uma opção está disponível para que os ativos importados que tenham sido excluídos do Módulo Risk Manager sejam recriados na próxima vez em que a tarefa for executada se esses ativos ainda existirem nos arquivos.
Outro recurso que pode ser utilizado no mapeamento é a conversão de números, pois o arquivo pode utilizar escalas diferentes das que são utilizadas no sistema. Por exemplo: no arquivo, a criticidade do ativo é pontuada em uma escala que vai de 1 a 10, enquanto o sistema utiliza uma escala de 1 a 5. Nesse caso, devem ser criadas regras para converter esses valores. Os valores 1 e 2 podem ser convertidos para 1, os valores 3 e 4 podem ser convertidos para 2 e assim por diante.
Para detalhes sobre o mapeamento dos campos necessários para a importação do arquivo, veja o Apêndice -> Mapeamentos para a importação de ativos de arquivos XML.
Os arquivos XML podem ser importados diretamente da sua máquina local ou de um repositório remoto. Caso você esteja utilizando um ambiente SaaS (Software como Serviço), os arquivos XML deverão ser importados localmente do seu computador.
O caminho completo do arquivo XML deve ser fornecido caso o arquivo esteja localizado em um repositório remoto, como um caminho de rede, uma pasta no servidor ou um arquivo online. Se um arquivo que já tenha sido processado pelo sistema estiver no mesmo diretório que os novos arquivos XML, ele só será importado uma vez. Se o diretório especificado contiver vários arquivos XML não processados, todos eles serão importados. Por isso, especificar a ordem em que os arquivos serão importados ajuda a assegurar que as últimas informações serão importadas por último. Ao configurar a tarefa de integração para importar arquivos de um repositório remoto, você pode definir se a ordem de importação dos arquivos seguirá a data de criação ou o nome dos arquivos.
Se os arquivos XML estiverem disponíveis localmente no seu computador, você poderá selecioná-los diretamente para importação. A ordem de importação segue a ordem alfabética dos nomes dos arquivos. Tarefas para importação local de arquivos são executadas imediatamente após serem salvas, não sendo necessário agendar a tarefa.
Os ativos serão importados para um perímetro na estrutura organizacional. Na tarefa de integração, é possível especificar se os ativos serão importados para um perímetro existente ou se um novo perímetro será criado para eles.