Capítulo 8: Como importar dados
Esta seção contém os seguintes tópicos: Como importar dados (na página 177)
Como importar dados
Quando você deseja adicionar ou atualizar dados, importe-os para o CA APM usando o Data Importer. Os dados importados são inseridos, ou atualizam os dados existentes, no CA MDB.
Importante: Nesse cenário, o administrador do sistema executa a importação de dados.
No entanto, o administrador pode conceder Acesso de usuário ao Data Importer ou Acesso de administrador ao Data Importer para qualquer perfil do usuário do CA APM. O acesso de usuário permite que os usuários criem importações, modifiquem ou excluam suas próprias importações e exibam qualquer importação que tenha sido criada por outro usuário. O acesso de administrador permite que os usuários criem
importações e modifiquem ou excluam qualquer importação que tenha sido criada por qualquer usuário.
Como importar dados
178 Guia de Administração
Como importar dados
Capítulo 8: Como importar dados 179 Para importar dados do CA APM, execute estas etapas:
1. Revisar os pré-requisitos (na página 180).
2. Criar uma Importação de dados a partir de um arquivo de dados (na página 181) ou criar uma importação de dados a partir de um arquivo de mapa de herança (na página 185).
3. Mapear colunas do arquivo de dados para campos de dados (na página 186). 4. Revisar o material de referência de mapeamento (na página 188).
■ Combinações de pesquisa principal e secundária (na página 189)
■ Valores embutidos em código (na página 191)
■ Vários valores para um único campo (na página 192) 5. Filtrar dados na importação (na página 192).
6. Enviar a importação (na página 194). 7. Programar a importação (na página 195).
8. Exibir o arquivo de log de importação (na página 197).
9. Revisar as Práticas recomendadas do arquivo de log de importação (na página 197). 10. Verificar os dados importados (na página 198).
Exemplo: importar novos funcionários
Sam, o administrador do sistema do CA APM na Empresa de Gerenciamento de Documentos, deseja importar um grupo de novos funcionários. Os novos funcionários usam o produto para gerenciar ativos de hardware. Sam recebeu um arquivo de dados de origem em formato CSV (Comma-separated Value - Valor Separado por Vírgula) do Recursos Humanos que contém as informações do funcionário. Todos os novos funcionários gerentes de ativos pertencem ao departamento de TI trabalham na matriz da empresa. No entanto, o arquivo de dados de origem também contém dados sobre alguns novos funcionários que trabalham em outros locais e não pertencem ao departamento de TI. Sam deseja importar somente os dados dos funcionários de TI da matriz. Usando o Data Importer e o arquivo de dados de origem, Sam cria uma importação de dados para incorporar os novos funcionários no CA MDB. Para garantir que somente os funcionários do departamento de TI da matriz sejam importados, Sam cria um filtro de exclusão. Após Sam executar a importação, ele examina as estatísticas de importação, o arquivo de log de importação e a interface de usuário para verificar se a importação foi bem-sucedida.
Como importar dados
180 Guia de Administração
Verifique os pré-requisitos
Para garantir que seja possível importar os dados com êxito, verifique se você concluiu as tarefas a seguir:
■ Prepare um arquivo de dados de origem no formato de texto delimitado (por exemplo, tabulação ou vírgulas). Esse arquivo contém os dados que você deseja importar.
Observação: é recomendável que você inclua o objeto de destino principal no nome do arquivo de dados de origem. Essa convenção de nomenclatura de arquivos ajuda a localizar os arquivos de dados quando você cria a importação.
Observação: um valor NULL no arquivo de dados de origem limpa o valor do campo de destino correspondente. Um campo vazio no arquivo de dados de origem deixa o valor do campo de destino correspondente inalterado.
Importante: Se um valor de dados em seu arquivo de dados de origem tiver o
delimitador selecionado, é necessário usar aspas duplas ao redor do valor de dados. Por exemplo, é possível selecionar uma vírgula como o delimitador para importar empresas. Você deseja incluir o valor Document Management Company, Inc. em seu arquivo de dados de origem. Especifique esse valor de dados entre aspas duplas:
“Document Management Company, Inc”
■ (Opcional) Copie os arquivos de dados de origem do servidor local para um dos
seguintes locais. É possível acessar esses locais no servidor de aplicativos do CA APM onde o Serviço do gerenciador de armazenamento está instalado. O local depende de se você está usando multilocação.
[Caminho raiz do ITAM]\Armazenamento\Repositório comum\Importação [Caminho raiz do ITAM]\Armazenamento\Nome_do_inquilino\Importação Observação: se você copiar o arquivo de dados antes de criar uma importação, poderá então especificar o nome do arquivo ao criar a importação. Se você não copiar o arquivo de dados primeiro, é possível fazer upload do arquivo no servidor local ao criar a importação.
■ (Opcional) Copie os arquivos de mapeamento herdado de uma release anterior do produto (se tiver esses arquivos) de seu servidor local para um dos seguintes locais. É possível acessar esses locais no servidor de aplicativos do CA APM onde o Serviço do gerenciador de armazenamento está instalado. O local depende de se você está usando multilocação.
[Caminho raiz do ITAM]\Armazenamento\Repositório comum\Importação [Caminho raiz do ITAM]\Armazenamento\Nome_do_inquilino\Importação
Como importar dados
Capítulo 8: Como importar dados 181
Criar uma importação de dados a partir de um arquivo de dados
Crie uma importação de dados usando um arquivo de dados de origem (arquivo de texto delimitado) que contém os dados que você deseja importar. Selecione o arquivo, configure os parâmetros de importação e especifique o delimitador (por exemplo, uma vírgula ou tabulação) que separa os dados no arquivo.
Também é possível criar uma importação de dados usando um arquivo de mapa de herança de uma release anterior do produto. Para obter mais informações, consulte a criação de uma importação de dados a partir de um arquivo de mapa de herança (na página 185).
Siga estas etapas:
1. Efetue logon no CA APM como o administrador.
Importante: Nesse cenário, o administrador do sistema executa a importação de
dados. No entanto, o administrador pode conceder Acesso de usuário ao Data Importer ou Acesso de administrador ao Data Importer para qualquer perfil do usuário do CA APM. O acesso de usuário permite que os usuários criem
importações, modifiquem ou excluam suas próprias importações e exibam qualquer importação que tenha sido criada por outro usuário. O acesso de administrador permite que os usuários criem importações e modifiquem ou excluam qualquer importação que tenha sido criada por qualquer usuário.
2. Clique em Administração, Data Importer. 3. Clique em Nova importação.
4. Insira as informações necessárias na área Informações básicas e forneça informações opcionais, conforme necessário. Os seguintes campos exigem explicação:
Arquivo de dados
Especifica o arquivo de dados de origem que você deseja importar. Se esse arquivo estiver disponível no servidor de aplicativos do CA APM, é possível pesquisar e selecionar o arquivo de dados. Se esse arquivo não estiver disponível no servidor de aplicativos, é possível fazer upload do arquivo de dados.
Fazer upload de arquivo de dados
Permite procurar no servidor local o arquivo de dados de origem que você deseja importar. Esse arquivo é transferido para o servidor de aplicativos do CA APM.
Importante: O tamanho do arquivo é limitado pelas configurações ambientais
do produto. Para obter mais informações, entre em contato com o administrador ou o suporte técnico da CA.
Como importar dados
182 Guia de Administração
Objeto de destino principal
Especifica o objeto principal para a importação.
Os objetos de modelo e ativo são listados com suas respectivas famílias. Também é possível especificar Todas as famílias. Os objetos de documento jurídico são listados de acordo com o modelo jurídico. Também é possível especificar Todos os modelos. Os objetos incluem todos os objetos que podem ser importados.
Observação: para ativos ou modelos que incluem vários tipos de famílias de ativos ou documentos jurídicos que incluem vários modelos jurídicos, use as seleções a seguir para esse campo. Especifique o modelo ou família específica para cada registro em seu arquivo de dados de origem.
■ Para um ativo, selecione Ativo (Todas as famílias).
■ Para um modelo, selecione Modelo (Todas as famílias).
■ Para um documento jurídico, selecione Documento jurídico (Todos os modelos).
Importante: Certifique-se de selecionar o objeto de destino principal correto
para a importação. Não é possível alterar o objeto de destino principal depois de salvar ou copiar uma importação.
A primeira linha tem nomes de coluna
Especifica se a primeira linha no arquivo de dados de origem contém os nomes de colunas. Se a primeira linha não contém os nomes de colunas, os nomes são exibidos como nomes genéricos, como Campo 1 e Campo 2.
Inquilino
Especifica o inquilino que se aplica à importação (se você estiver usando multilocação).
É possível selecionar um inquilino somente quando a opção multilocação está ativada no CA APM e você está autorizado a acessar diferentes inquilinos. Se você tiver acesso a dados públicos e tiver vários inquilinos, é possível selecionar todos os inquilinos.
Observação: se você especificar todos os inquilinos, seu arquivo de dados de origem deverá ter uma coluna de nome do inquilino que você mapeia para o campo Nome do inquilino.
Importante: Se você especificar um inquilino, verifique se todos os dados no
arquivo de dados de origem pertencem ao inquilino selecionado. Se você tiver dados de mais de um inquilino, os dados de todos os inquilinos serão
Como importar dados
Capítulo 8: Como importar dados 183 Delimitador de dados
Especifica o delimitador (por exemplo, vírgula ou tabulação) usado no arquivo de dados de origem.
Importante: Se um valor de dados em seu arquivo de dados de origem tiver o
delimitador selecionado, é necessário usar aspas duplas ao redor do valor de dados. Por exemplo, é possível selecionar uma vírgula como o delimitador para importar empresas. Você deseja incluir o valor Document Management Company, Inc. em seu arquivo de dados de origem. Especifique esse valor de dados entre aspas duplas:
“Document Management Company, Inc”
Configuração regional do arquivo de dados
Especifica a configuração regional do arquivo de dados de origem. Essa configuração determina o formato de data e hora.
5. Insira as informações necessárias na área Configurações avançadas e forneça informações opcionais, conforme necessário. Os seguintes campos exigem explicação:
Limite de erro máximo (em %)
Define o número de erros após o qual a importação será interrompida. O limite se baseia na porcentagem de registros processados. É recomendável um limite mínimo de 15 por cento.
Observação: o Data Importer processa o número de registros especificado em Administração, Configuração do sistema, Data Importer (campo Tamanho máximo de registro do lote) antes de calcular se o limite de erro foi alcançado. Tipo de processamento de objeto de pesquisa principal
Especifica o tipo de atividade de importação (por exemplo, inserir ou atualizar). Criar objeto de pesquisa secundária
Cria novos objetos de pesquisa secundária durante o processo de importação. Se essa opção não for selecionada e não existir um objeto secundário, ocorrerá um erro.
Atualizar objeto de pesquisa secundária
Atualiza os objetos de pesquisa secundária existentes durante o processo de importação. Se um objeto secundário não existir, ocorrerá um erro.
Como importar dados
184 Guia de Administração
Erro Pesquisa secundária Erros de objetos em
Indica que o Data Importer não processa a inserção de um objeto principal ou atualização se o processo do objeto secundário falhar. Se o processo de inserção ou atualização de um objeto secundário falhar e essa caixa de seleção estiver marcada, a inserção ou atualização do objeto principal também falhará. Se essa caixa de seleção não estiver marcada, o objeto principal será criado ou atualizado (desde que o objeto não seja dependente do objeto secundário). No entanto, o valor do objeto secundário não será criado ou alterado. Em ambas as situações, o erro do objeto secundário é registrado no arquivo de log de importação.
Exemplo: você importa um local e o local tem um país. Se a importação falhar ao tentar atualizar o objeto de país e essa caixa de seleção estiver marcada, o registro do local não será criado. Se essa caixa de seleção não estiver marcada, o registro do local será criado e as informações do país não serão atualizadas. Comportamento da normalização
Especifica se deve-se normalizar os dados ou gravar uma mensagem de erro no arquivo de log sem normalizar os dados.
Observação: esse campo é exibido apenas se você tiver definido regras de normalização.
Erro na normalização
Grava uma mensagem de erro no arquivo de log do Data Importer quando dados que podem ser normalizados são encontrados nos dados que você está importando. Os dados envolvidos não serão importados. A mensagem de erro do arquivo de log inclui os detalhes sobre os dados.
Por exemplo, seus dados incluem o nome da empresa Microsoft. As regras de normalização de empresa que você criou identificam Microsoft como um valor coletado (não autoritativo) e especificam Microsoft Corporation como o valor normalizado (autoritativo). Se você selecionar esta opção ao importar os dados, o objeto com o nome de empresa Microsoft não será importado e uma mensagem de erro será gravada no arquivo de log. Aplicar normalização sem erro
Usa as regras de normalização para normalizar os dados que você está importando. Se dados que podem ser normalizados forem encontrados, os dados serão normalizados e importados. Nenhuma mensagem de erro sobre os dados será gravada no arquivo de log.
Por exemplo, seus dados incluem o nome da empresa Microsoft. As regras de normalização de empresa criadas identificam Microsoft como um valor coletado (não autoritativo) e especificam Microsoft Corporation como o valor normalizado (autoritativo). Se você selecionar esta opção ao importar os dados, o objeto com o nome de empresa Microsoft será normalizado. Nesse exemplo, o nome da empresa é alterado para Microsoft Corporation e o objeto associado é importado.
Como importar dados
Capítulo 8: Como importar dados 185 6. Clique em Salvar.
A importação é salva. As áreas de Mapeamento, Filtro de exclusão e Cronograma da página agora estão disponíveis para a sua entrada.
Exemplo: criar uma importação de dados de novos funcionários a partir de um arquivo de dados
Sam, o administrador do sistema do CA APM, executa as ações a seguir para criar a importação de dados:
1. Navega até Administração, Data Importer e clica em Nova importação. 2. Insere o arquivo Novos funcionários.csv no campo Arquivo de dados.
Esse arquivo CSV é o arquivo de dados de origem que Sam recebeu do Recursos Humanos com as informações do novo funcionário.
3. Seleciona Contato como o Objeto de destino principal e a vírgula como Delimitador de Dados.
4. Seleciona Inserir ou atualizar no campo Tipo de processamento de objeto de pesquisa principal e clica em Salvar.
Criar uma importação de dados a partir de um arquivo de mapa de herança
É possível criar uma importação de dados usando um arquivo de mapa de herança de uma release anterior do CA APM. O arquivo de mapeamento define o arquivo de dados correspondente e as configurações de parâmetro de importação.Observação: recomendamos que você copie os arquivos de mapeamento herdado e os arquivos de dados correspondentes para o servidor de aplicativos do CA APM antes de criar as importações de dados. No entanto, se necessário, é possível usar as etapas opcionais para fazer upload de um arquivo de mapeamento herdado.
Também é possível criar uma importação de dados usando somente um arquivo de dados. Para obter mais informações, consulte a criação de uma importação de dados a partir de um arquivo de dados (na página 181).
Siga estas etapas:
1. Clique em Administração, Data Importer, Nova importação.
2. Clique em Pesquisar e carregar o mapa para selecionar um arquivo de mapeamento herdado que já esteja disponível no servidor de aplicativos do CA APM.
Importante: O arquivo de dados correspondente também deve estar disponível no
servidor de aplicativos do CA APM.
Se o arquivo de mapeamento herdado não estiver disponível no servidor de aplicativos do CA APM, faça upload do arquivo usando o campo Fazer upload do arquivo de dados.
Como importar dados
186 Guia de Administração
3. (Opcional) Faça upload de um arquivo de mapeamento herdado que não esteja disponível no servidor de aplicativos do CA APM usando as seguintes etapas: a. No campo Fazer upload do arquivo de dados, procure no servidor local e
selecione um arquivo de mapeamento herdado.
b. Clique em OK quando receber uma mensagem sobre o tipo de arquivo. O arquivo de mapeamento herdado é transferido e exibido no campo Arquivo de dados.
c. Clique em Redefinir.
d. Clique em Pesquisar e carregar o mapa, e selecione o arquivo de mapeamento herdado que você transferiu.
O arquivo de mapeamento herdado é exibido no campo Arquivo de mapeamento herdado.
As informações básicas são carregadas.
Observação: se você receber um aviso sobre o arquivo de dados de origem, faça upload do arquivo de dados usando o campo Fazer upload do arquivo de dados. 4. Especifique as Configurações avançadas e clique em Salvar.
Os mapeamentos de dados de Filtro de exclusão e Dados de mapeamento são carregados. As áreas de Mapeamento, Filtro de exclusão e Cronograma da página agora estão disponíveis para a sua entrada. As áreas de Mapeamento e Filtro de exclusão exibem os dados do arquivo de mapa de herança.
Observação: para obter informações sobre como especificar as Configurações avançadas, consulte criando uma importação de dados a partir de um arquivo de dados (na página 181).
Mapear colunas do arquivo de dados para campos de dados
É possível mapear as colunas no arquivo de dados de origem para os campos no CA APM. Execute o mapeamento de colunas para especificar para onde os dados de origem serão importados. É possível selecionar a maioria dos objetos e campos associados como campos de destino durante o mapeamento de colunas.
Observação: se você tiver criado a importação de dados a partir de um arquivo de mapa de herança, o mapeamento de colunas existe. Se desejar alterar os valores, é possível editar as regras de mapeamento existentes. Também é possível adicionar ou remover as regras e os filtros de mapeamento.
Ao efetuar logon, o perfil do usuário que o administrador atribuiu a você determina os objetos e campos que você pode ver e usar. Se a sua função especificar que você não tem permissões para um campo de objeto, o campo não estará disponível para um mapeamento. Só é possível criar um mapeamento e importar dados para os objetos e campos para os quais você tem permissões.
Como importar dados
Capítulo 8: Como importar dados 187 Observação: é recomendável que, antes de mapear dados, você revise a interface de usuário do CA APM para determinar as informações necessárias para um mapeamento. Por exemplo, revise a página Ativo para ver que o nome, a família, o modelo e a classe do ativo são necessários. Uma vez que um modelo é necessário para criar um ativo, revise a página Modelo para ver se o nome do modelo e a família de ativos são necessários. Ao rever a interface de usuário antes de criar um mapeamento, você se certifica de que tem todas as informações necessárias para criar um mapeamento. Siga estas etapas:
1. Na guia Administração, na página Data Importer, na área de Mapeamento para uma importação selecionada, clique em Novo.
2. Clique no ícone Selecionar ao lado do Campo de origem, selecione uma coluna na sua fonte de dados e clique em OK.
Observação: os sinais de porcentagem que aparecem antes e depois dos nomes das colunas identificam os nomes como cabeçalhos de coluna no arquivo de dados de origem. Também é possível especificar um valor embutido em código no Campo de origem que você deseja aplicar a todos os registros no arquivo de dados de origem.