Cómo importar datos

Cuando se desea agregar o actualizar datos, impórtelos a CA APM utilizando el importador de datos. Los datos que se importan se insertan o actualizan los datos existentes en CA MDB.
casm173
Cuando se desea agregar o actualizar datos, impórtelos a CA APM utilizando el importador de datos. Los datos que se importan se insertan o actualizan los datos existentes en CA MDB.
En este caso, el administrador del sistema lleva a cabo la importación de datos. Sin embargo, el administrador puede conceder acceso de usuario del importador de datos o acceso de administrador del importador de datos a cualquier rol de usuario de CA APM. El acceso de usuario permite a los usuarios crear importaciones, modificar o suprimir sus propias importaciones y ver cualquier importación creada por otro usuario. El acceso de administrador permite a los usuarios crear importaciones, y modificar o suprimir cualquier importación creada por otro usuario.
El siguiente diagrama muestra cómo un administrador del sistema importa datos.
Diagrama que describe cómo importar datos
Diagram depicting how to import data
Para importar datos de CA APM, realice los siguientes pasos:
Ejemplo: importación de nuevos empleados
José, el administrador del sistema de CA APM en Document Management Company, desea importar un grupo de nuevos empleados. Los nuevos empleados utilizan el producto para gestionar los activos de hardware. José ha recibido un archivo de datos fuente de valores separados por comas (CSV) de Recursos humanos que contiene la información de los empleados. Todos los nuevos empleados del gestor de activos pertenecen al Departamento de TI y trabajan en la sede de la compañía. Sin embargo, el archivo de datos fuente también contiene datos sobre algunos empleados nuevos que trabajan en otras ubicaciones y que no pertenecen al Departamento de TI.
José solamente desea importar los datos de los empleados de TI de la sede de la compañía. Utilizando el importador de datos y el archivo de datos fuente, José crea una importación de datos para incorporar los nuevos empleados en CA MDB. Para asegurarse de que solo se importen empleados del Departamento de TI de la sede, José crea un filtro de exclusión. Una vez que José ejecute la importación, comprobará las estadísticas de la importación, el archivo de registro de la importación y la interfaz de usuario para verificar que la importación ha sido correcta.
Revisión de los requisitos previos
Para garantizar que se hayan importado los datos correctamente, verifique que se hayan completado las siguientes tareas:
  • Prepare un archivo de datos fuente en formato de texto delimitado (por ejemplo, tabuladores o comas). Este archivo contiene los datos que se desean importar.
    Se recomienda que se incluya el objeto de destino principal en el nombre del archivo de datos fuente. Esta convención de nomenclatura del archivo le ayuda a localizar los archivos de datos cuando se crea la importación. Un valor NULO en el archivo de datos fuente borra el valor del campo de destino correspondiente. Un campo vacío en el archivo de datos fuente deja sin modificar el valor del campo de destino correspondiente.
    Si un valor de datos en el archivo de datos fuente contiene el delimitador seleccionado, se deben utilizar comillas dobles alrededor del valor de datos. Por ejemplo, se selecciona la coma como delimitador para importar las compañías. Se desea incluir el valor de datos Document Management Company, Inc en el archivo de datos fuente. Especifique este valor de datos con comillas dobles: "Document Management Company, Inc".
  • (Opcional) Copie los archivos de datos fuente desde el servidor local a una de las siguientes ubicaciones. Se puede acceder a estas ubicaciones en el servidor de aplicaciones de CA APM donde está instalado el servicio del gestor de almacenamiento. La ubicación depende de donde se esté utilizando la opción multicliente.
    [ITAM Root Path]\Storage\Common Store\Import [ITAM Root Path]\Storage\Tenant_Name\Import
    Si se copia el archivo de datos antes de crear una importación, se podrá especificar el nombre del archivo cuando se crea la importación. Si no se copia el archivo de datos en primer lugar, se puede cargar el archivo desde el servidor local al crear la importación.
  • (Opcional) Copie los archivos de asignación heredados de una versión anterior del producto (si se dispone de estos archivos) desde el servidor local a una de las siguientes ubicaciones. Se puede acceder a estas ubicaciones en el servidor de aplicaciones de CA APM donde está instalado el servicio del gestor de almacenamiento. La ubicación depende de donde se esté utilizando la opción multicliente.
    [ITAM Root Path]\Storage\Common Store\Import [ITAM Root Path]\Storage\Tenant_Name\Import
Creación de una importación de datos desde un archivo de datos
Se crea una importación de datos mediante un archivo de datos fuente (archivo de texto delimitado) que contiene los datos que se desean importar. Se selecciona el archivo, se configuran los parámetros de importación y se especifica el delimitador (por ejemplo, una coma o un tabulador) que separará los datos en el archivo.
También se puede crear una importación de datos mediante un archivo de asignación heredado de una versión anterior del producto. Para obtener más información, consulte Creación de una importación de datos desde un archivo de asignación heredado.
Siga los pasos siguientes:
  1. Inicie sesión en CA APM como administrador.
    En este caso, el administrador del sistema lleva a cabo la importación de datos. Sin embargo, el administrador puede conceder acceso de usuario del importador de datos o acceso de administrador del importador de datos a cualquier rol de usuario de CA APM. El acceso de usuario permite a los usuarios crear importaciones, modificar o suprimir sus propias importaciones y ver cualquier importación creada por otro usuario. El acceso de administrador permite a los usuarios crear importaciones, y modificar o suprimir cualquier importación creada por otro usuario.
  2. Haga clic en Administración, Importador de datos.
  3. Haga clic en Nueva importación.
  4. Introduzca la información necesaria en el área Información básica y suministre la información opcional según sea necesario. A continuación, se proporciona una breve explicación de los campos siguientes:
    • Archivo de datos
      Especifica el archivo de datos fuente que se desea importar.
      Si este archivo está disponible en el servidor de aplicaciones de CA APM, busque el archivo de datos y seleccione el archivo. Si este archivo no está disponible en el servidor de aplicaciones, cargue el archivo.
    • Cargar archivo
      Busque en el servidor local un archivo de datos fuente que se desea importar o un archivo de asignación heredado que se desea utilizar para crear las asignaciones. Este archivo se carga al servidor de aplicaciones de CA APM.
      El tamaño de los archivos está limitado por la configuración del entorno del producto. Póngase en contacto con el administrador para obtener más información.
    • Objeto de destino principal
      Especifica el objeto principal para la importación.
      Los objetos de activo y modelo aparecen listados con sus correspondientes familias. También se puede especificar Todas las familias. Se muestran los objetos de documento legal por plantilla legal. También se puede especificar Todas las plantillas. Los objetos incluyen todos los objetos que se pueden importar.
      Para los activos o modelos que incluyen varios tipos de familia de activos o documentos legales que incluyen diversas plantillas legales, utilice las siguientes selecciones para este campo. Especifique la familia o plantilla concreta para cada registro en el archivo de datos fuente.
      • Para un activo, seleccione Activo (todas las familias).
      • Para un modelo, seleccione Modelo (todas las familias).
      • Para un documento legal, seleccione Documento legal (todas las plantillas).
      Asegúrese de seleccionar el objeto de destino principal correcto para la importación. No se puede cambiar el objeto de destino principal después de guardar o copiar una importación.
    • Primera fila con nombres de columna
      Especifica si la primera fila del archivo de datos fuente contiene los nombres de columna. Si la primera fila no contiene los nombres de columna, los nombres se mostrarán como nombres genéricos como, por ejemplo, Campo 1 y Campo 2.
    • Cliente
      Especifica el cliente al que se aplica la importación (si se está utilizando la opción multicliente).
      Solo se puede seleccionar un cliente cuando el multicliente está activado en CA APM y cuando se está autorizado para acceder a diferentes clientes. Si se dispone de acceso a datos públicos y se poseen varios clientes, se pueden seleccionar todos los clientes.
      Si se especifican todos los clientes, el archivo de datos fuente debe tener una columna de nombre de cliente que se asigna al campo Nombre de cliente.
      Si se especifica un cliente, compruebe que todos los datos del archivo de datos fuente pertenecen al cliente seleccionado. Si se disponen de datos de más de un cliente, se importarán los datos de todos los clientes al cliente seleccionado.
    • Delimitador de datos
      Especifica el delimitador (por ejemplo, una coma o tabulador) que se ha utilizado en el archivo de datos fuente.
      Si un valor de datos en el archivo de datos fuente contiene el delimitador seleccionado, se deben utilizar comillas dobles alrededor del valor de datos. Por ejemplo, se selecciona la coma como delimitador para importar las compañías. Se desea incluir el valor de datos Document Management Company, Inc en el archivo de datos fuente. Especifique este valor de datos con comillas dobles:
      "Document Management Company, Inc"
    • Configuración regional del archivo de datos
      Especifica la configuración regional para el archivo de datos fuente. Esta configuración determina el formato de fecha y hora.
  5. Introduzca la información necesaria en el área Configuración avanzada y suministre la información opcional según sea necesario. A continuación, se proporciona una breve explicación de los campos siguientes:
    • Umbral de error máximo (en %)
      Define el número de errores tras el cual se detiene la importación. El umbral se basa en el porcentaje de registros procesados. Se recomienda un umbral mínimo del 15 por ciento.
      El importador de datos procesa el número de registros que se especifican en Administración, Configuración del sistema, Importador de datos (campo Tamaño máximo del registro por lotes) antes de calcular si se ha alcanzado el umbral de error.
    • Tipo de procesamiento de objeto de búsqueda principal
      Especifica el tipo de actividad de importación (por ejemplo, inserción o actualización).
    • Crear objeto de búsqueda secundario
      Crea nuevos objetos de búsqueda secundarios durante el proceso de importación. Si esta opción no está seleccionada y no existen objetos secundarios, se produce un fallo.
    • Actualizar objeto de búsqueda secundario
      Actualiza los objetos de búsqueda secundarios existentes durante el proceso de importación. Si no existen objetos secundarios, se produce un fallo.
    • Error en los errores del objeto de búsqueda secundario
      Indica que el importador de datos no procesa la inserción o actualización de un objeto principal si se produce un fallo en el proceso del objeto secundario. Si se produce un fallo en el proceso de inserción o actualización de un objeto secundario y esta casilla de verificación está seleccionada, también se producirá un fallo en la inserción o actualización del objeto principal. Si no se selecciona esta casilla de verificación, el objeto principal se crea o actualiza (siempre que el objeto no sea dependiente de un objeto secundario). Sin embargo, el valor del objeto secundario no se crea o modifica. En ambos casos, el fallo del objeto secundario se registra en el archivo de registro de la importación.
      Ejemplo
      : importación de una ubicación y la ubicación tiene un país. Si se produce un fallo en la importación al intentar actualizar el objeto de país y esta casilla de verificación está seleccionada, no se crea el registro de la ubicación. Si no se selecciona esta casilla de verificación, se crea el registro de la ubicación y no se actualiza la información del país.
    • Comportamiento de normalización
      Especifica si se deben normalizar los datos o escribir un mensaje de error en el archivo de registro sin normalizar los datos.
      Este campo solo aparece si se han definido reglas de normalización.
      • Error de normalización
        Escribe un mensaje de error en el archivo de registro del importador de datos cuando los datos que se pueden normalizar se encuentran en los datos que se van a importar. No se importan los datos implicados. El mensaje de error del archivo de registro incluye los detalles sobre los datos.
        Por ejemplo, los datos incluyen el nombre de la compañía Microsoft. Las reglas de normalización de la compañía creada identifican a Microsoft como un valor recolectado (no autoritativo) y especifican a Microsoft Corporation como el valor normalizado (autoritativo). Si se selecciona esta opción al importar los datos, el objeto con el nombre de compañía Microsoft no se importa y se escribe un mensaje de error en el archivo de registro.
      • Aplicar normalización sin errores
        Utiliza las reglas de normalización para normalizar los datos que se van a importar. Si se encuentran datos que se pueden normalizar, los datos se normalizan y se importan. No se escribe ningún mensaje de error acerca de los datos en el archivo de registro.
        Por ejemplo, los datos incluyen el nombre de la compañía Microsoft. Las reglas de normalización de la compañía creadas identifican a Microsoft como un valor recolectado (no autoritativo) y especifican a Microsoft Corporation como el valor normalizado (autoritativo). Si se selecciona esta opción al importar los datos, se normalizará el objeto con el nombre de compañía Microsoft. En este ejemplo, el nombre de la compañía se cambiará a Microsoft Corporation y el objeto asociado se importará.
  6. Haga clic en Guardar.
    Se guardará la importación. Las áreas Asignación, Filtro de exclusión y Planificación de la página están ahora disponibles para la entrada de datos.
Ejemplo: creación de una importación de datos de nuevos empleados desde un archivo de datos
José, el administrador del sistema de CA APM, lleva a cabo las acciones siguientes para crear la importación de datos:
  1. Va a Administración, Importador de datos y hace clic en Nueva importación.
  2. Introduce el archivo Nuevos empleados.csv en el campo Archivo de datos.
    Este archivo CSV es el archivo de datos fuente que José ha recibido del Departamento de Recursos humanos con la información de los nuevos empleados.
  3. Selecciona Contacto para el Objeto de destino principal y Coma para el Delimitador de datos.
  4. Selecciona Inserción o Actualización en el campo Tipo de procesamiento del objeto de búsqueda principal y hace clic en Guardar.
Creación de una importación de datos desde un archivo de asignación heredado
Se puede crear una importación de datos mediante un archivo de asignación heredado desde una versión anterior de CA APM. El archivo de asignación define el archivo de datos correspondiente y la configuración de los parámetros de importación.
Se recomienda copiar los archivos de asignación heredados y los archivos de datos correspondientes en el servidor de aplicaciones de CA APM antes de crear las importaciones de datos. Sin embargo, si es necesario, se pueden utilizar los pasos opcionales para cargar un archivo de asignación heredado.
También se puede crear una importación de datos utilizando solamente un archivo de datos. Para obtener más información, consulte Creación de una importación de datos desde un archivo de datos.
Siga los pasos siguientes:
  1. Haga clic en Administración, Importador de datos, Nueva importación.
  2. Haga clic en Buscar y cargar asignación para seleccionar un archivo de asignación heredado que ya esté disponible en el servidor de aplicaciones de CA APM.
    El archivo de datos correspondiente también debe estar disponible en el servidor de aplicaciones de CA APM.
    Si el archivo de asignación heredado no está disponible en el servidor de aplicaciones de CA APM, cargue el archivo mediante el campo Cargar archivo.
  3. (Opcional) Cargue un archivo de asignación heredado que no esté disponible en el servidor de aplicaciones de CA APM utilizando los siguientes pasos:
    1. En el campo Cargar archivo, explore el servidor local y seleccione un archivo de asignación heredado.
      El archivo de asignación heredado se carga y se muestra en el campo Cargar archivo.
    2. Haga clic en Buscar y cargar asignación y seleccione el archivo de asignación heredado cargado.
      El archivo de asignación heredado se muestra en el campo Archivo de asignación heredado.
      Se carga la Información básica.
    Si se recibe una advertencia sobre el archivo de datos fuente, cargue el archivo de datos mediante el campo Cargar archivo.
  4. Especifique los valores de Configuración avanzada y haga clic en Guardar.
    Se cargan el Filtro de exclusión y la Asignación de datos. Las áreas Asignación, Filtro de exclusión y Planificación de la página están ahora disponibles para la entrada de datos. Las áreas Asignación y Filtro de exclusión muestran los datos del archivo de asignación heredado.
    Para obtener más información sobre cómo especificar la Configuración avanzada, consulte Creación de una importación de datos desde un archivo de datos.
Asignación de las columnas del archivo de datos a los campos de datos
Se pueden asignar las columnas del archivo de datos fuente a los campos de CA APM. Realice la asignación de columnas para especificar donde se deben importar los datos fuente. Se pueden seleccionar la mayoría de los objetos y campos asociados como campos de destino durante la asignación de columnas.
Si se ha creado la importación de datos desde un archivo de asignación heredado, ya existe la asignación de columnas. Si se desea cambiar los valores, se pueden editar las reglas de asignación existentes. También se pueden agregar o eliminar filtros y reglas de asignación.
Al iniciar sesión, el rol de usuario que el administrador ha asignado al usuario determina qué objetos y campos se pueden ver y utilizar. Si el rol especifica que se no tienen permisos para un campo de objeto, el campo no estará disponible para una asignación. Solo se podrá crear una asignación e importar datos para los objetos y campos para los que se tienen permisos.
Se recomienda que, antes de asignar datos, revise la interfaz de usuario de CA APM para determinar la información que es necesaria para una asignación. Por ejemplo, revise la página Activo para ver que el nombre del activo, la familia del activo, el modelo y la clase son obligatorios. Puesto que se requiere un modelo para crear un activo, revise la página Modelo para constatar que el nombre del modelo y la familia de activos son necesarios. Al revisar la interfaz de usuario previamente a la creación de la asignación, asegúrese de que dispone de toda la información necesaria para crear una asignación.
Siga los pasos siguientes:
  1. En la ficha Administración, vaya a la página Importador de datos y en el área Asignación de la importación seleccionada, haga clic en Nuevo o haga clic en Cargar campos fuente.
    • El campo Nuevo le permite seleccionar individualmente los campos fuente del archivo de datos fuente.
    • El campo Cargar campos fuente agrega todos los campos fuente del archivo de datos fuente.
    Si se tienen asignaciones existentes, el campo Cargar campos fuente permite sustituir las asignaciones con los campos fuente del archivo de datos fuente. Esta opción también permite agregar los campos fuente del archivo de datos fuente que ya no está en las asignaciones.
    1. Si se ha hecho clic en Cargar campos fuente, haga clic en el icono Editar registro situado al lado de un campo.
  2. Haga clic en el icono Seleccionar situado junto a Campo de fuente (si este campo está vacío), seleccione una columna de la fuente de datos y haga clic en Aceptar.
    Si este campo ya contiene un Campo de fuente (porque se han cargado todos los campos de fuente), se puede omitir este paso.
    Los símbolos de porcentaje que aparecen antes y después de que los nombres de las columnas identifican los nombres como encabezados de columna en el archivo de datos fuente. También se puede especificar un valor codificado de forma rígida en el Campo de fuente que se desea aplicar a todos los registros del archivo de datos fuente. A continuación, se podrá asignar el valor codificado de forma rígida a un Campo de destino. Los valores codificados de forma rígida no se muestran con símbolos de porcentaje para que se puedan distinguir de los nombres de columnas del archivo de datos fuente. Para obtener más información, consulte Valores codificados.
  3. Haga clic en el icono Seleccionar situado junto a Campo de destino, seleccione un Campo de destino para el Campo de fuente seleccionado y haga clic en Aceptar.
    Los campos de destino que aparecen se basan en el objeto de destino principal seleccionado.
    Los campos de destino se muestran en orden jerárquico. Por ejemplo, los campos que aparecen en la jerarquía Tipo de activo son Familia del activo, Clase y Subclase. El orden de los campos en la lista representa la jerarquía de los campos. Siga la jerarquía de los campos cuando se especifiquen reglas de asignación. Por ejemplo, para la jerarquía Tipo de activo, especifique una regla para Clase antes de especificar la Subclase.
  4. Seleccione las casillas de verificación Búsqueda principal y Búsqueda secundaria según sea necesario.
    1. Seleccione la casilla de verificación Búsqueda principal para cada campo de destino que se desea utilizar para buscar el objeto principal. Utilice las directrices siguientes cuando se selecciona esta casilla de verificación:
      • Seleccione al menos una casilla de verificación Búsqueda principal en la asignación de columnas para la importación.
      • No seleccione esta casilla de verificación si el Campo de destino es Texto de la nota (en el objeto de nota). El tipo de datos de la base de datos para el campo Texto de la nota no permite que funcione como un campo de búsqueda.
    2. Seleccione la casilla de verificación Búsqueda secundaria para cada campo de destino que se desea utilizar para encontrar los objetos secundarios. Utilice las directrices siguientes cuando se selecciona esta casilla de verificación:
      • No seleccione esta casilla de verificación si el campo de destino no es uno de los campos de búsqueda del objeto secundario.
      • No seleccione esta casilla de verificación si el Campo de destino es Texto de la nota (en el objeto de nota). El tipo de datos de la base de datos para el campo Texto de la nota no permite que funcione como un campo de búsqueda.
  5. Haga clic en el icono Completar edición del registro.
  6. Haga clic en Nuevo otra vez o haga clic en el icono Editar registro situado junto a otro campo de fuente para especificar más reglas de asignación.
    Para suprimir una regla de asignación específica de la lista de columnas asignadas, haga clic en el icono Supresión situado al lado de la regla de asignación. La regla de asignación de columnas se eliminará de la lista.
  7. Haga clic en Guardar.
    Se guarda la asignación de columnas.
Ejemplo: asignación de columnas del archivo de datos a campos de datos
José lleva a cabo los siguientes pasos para asignar las columnas del archivo de datos en el archivo de datos fuente a los campos de datos de CA APM:
  1. Hace clic en Nuevo en el área Asignación de la página Detalles de la importación.
  2. Selecciona
    %Login ID%
    en el Campo de fuente haciendo clic en el icono Seleccionar situado junto a Campo de fuente y seleccionando este elemento en el cuadro de diálogo.
    Los elementos que aparecen en el cuadro de diálogo son las columnas del archivo de datos fuente.
  3. Selecciona ID de usuario en el Campo de destino haciendo clic en el icono Seleccionar junto a Campo de destino y seleccionando este elemento en el cuadro de diálogo.
  4. Selecciona la casilla de verificación Búsqueda principal.
  5. Continúa asignando las columnas restantes del archivo de datos fuente con los campos de datos de CA APM y hace clic en Guardar cuando termina.
Revisión del material de referencia de asignación
Consulte la siguiente información durante la configuración de la asignación de columnas para la importación o supresión de datos.
Combinaciones de búsqueda principal y secundaria
Los campos que se seleccionan como campos de búsqueda principal y secundaria en la asignación de columnas se utilizan para buscar datos en la base de datos del producto.
  • Asignación simple
    En una asignación simple, se especifica únicamente la búsqueda principal. Por ejemplo, si se importa o suprime un conjunto de registros de una compañía desde un archivo de texto en la base de datos del producto, se debe especificar el nombre de la compañía como valor de la búsqueda principal. Si una compañía con un nombre concreto no existe en la base de datos cuando se están importando los datos, se crea un registro para esa compañía. En la tabla siguiente se muestra un ejemplo de búsqueda para una asignación simple.
Campo de origen
Campo de destino
Búsqueda primaria
Búsqueda secundaria
%Nombre de la compañía%
Compañía.Nombre de la compañía
No
  • Asignación de campos de referencia
    En una asignación de campos de referencia, se especifican los valores de la búsqueda principal y secundaria. Para buscar un objeto único, se debe especificar más de un valor de búsqueda principal. Por ejemplo, si se desea buscar una compañía, se pueden especificar el nombre de la compañía, la compañía padre o el tipo de compañía como valores para la búsqueda principal. En este caso, el Importador de datos buscará una compañía con el nombre, compañía padre y tipo de compañía especificados. Si el objeto no existe y se están está importando los datos, se crea el registro, en función de se se ha seleccionado la opción de inserción o de actualización durante la configuración avanzada. En la tabla siguiente se muestra un ejemplo de búsqueda para la asignación de campos de referencia.
Campo de origen
Campo de destino
Búsqueda primaria
Búsqueda secundaria
%Nombre de la compañía%
Compañía.Nombre de la compañía
No
%Compañía padre%
Compañía.Compañía padre.Nombre de la compañía
%Tipo de compañía%
Compañía.Tipo de compañía.Valor
Este tipo de asignación requiere la selección de las casillas de verificación Búsqueda principal y Búsqueda secundaria tanto para Compañía padre como para Tipo de compañía. El Importador de datos utiliza el nombre de la compañía para buscar la compañía padre y, a su vez, utiliza la compañía padre para buscar el nombre de la compañía.
  • Asignación del objeto secundario
    Si se asigna una regla de asignación a una propiedad de un objeto secundario, los valores de la búsqueda principal establecen una relación entre el objeto secundario y los campos de referencia. La siguiente tabla muestra varios ejemplos de búsquedas para la asignación de un objeto secundario.
Campo de origen
Campo de destino
Búsqueda primaria
Búsqueda secundaria
%Comentario%
Documento legal.Parte legal.Comentario
No
%ID del documento legal%
Documento legal.Identificador del documento
No
%Nombre de la compañía%
Documento legal.Parte legal.Parte legal.Nombre de la compañía
%Plantilla legal%
Documento legal.Plantilla legal.Plantilla
En la primera regla de asignación, Documento legal es el objeto principal y Parte legal es el objeto secundario. Comentario es una propiedad de Parte legal.
En la tercera regla de asignación, Documento legal es el objeto principal y Parte legal es el objeto secundario. Además, Parte legal tiene un campo de referencia en la tabla Compañía. La casilla de verificación Búsqueda secundaria indica que se utiliza el nombre de la compañía para buscar el objeto Compañía. La casilla de verificación Búsqueda principal indica que se utiliza el objeto Compañía para buscar el objeto Parte legal.
Valores codificados de forma rígida
En la asignación de columnas, los símbolos de porcentaje que aparecen antes y después de que los nombres de las columnas identifican los nombres como encabezados de columna en el archivo de datos fuente. También se puede especificar un valor codificado de forma rígida en el Campo de fuente que se desea aplicar a todos los registros del archivo de datos fuente. A continuación, se podrá asignar el valor codificado de forma rígida a un Campo de destino. Los valores codificados de forma rígida no se muestran con símbolos de porcentaje para distinguirlos de los nombres de columnas del archivo de datos fuente.
Hard_coded_values.PNG
  1. Encabezado de columna del archivo de datos fuente
  2. Valor codificado de forma rígida
Es posible definir un valor codificado de forma rígida en el campo de fuente para ampliar los datos fuente y garantizar que se incluyen todos los campos obligatorios. Por lo general, los valores codificados de forma rígida no empiezan ni terminan con un símbolo de porcentaje (%). Si dispone de valores codificados de forma rígida con símbolos de porcentaje, estos no pueden coincidir con los nombres de los campos del archivo de datos fuente.
Ejemplo: uso de valores codificados de forma rígida para la familia del activo
En este ejemplo, los activos del archivo de datos fuente no contienen la familia de activos, que se requiere a la hora de crear un activo. Es posible agregar un valor codificado de forma rígida a la asignación. Si todos los activos son hardware, se puede introducir Hardware en el campo de fuente. Se puede asignar este valor al campo Familia del activo. Si los recursos que pertenecen a familias distintas, agregue una columna al archivo de datos fuente con las familias de activos correspondientes antes de importar o suprimir datos.
La siguiente información muestra la diferencia entre los valores en el archivo de datos fuente y aquellos que se agregan mediante los valores codificados de forma rígida:
  • Dispone de una columna Familia del activo en el archivo de datos fuente. La selección del campo de fuente es %familia del activo%.
No dispone de una columna Familia del activo en el archivo de datos fuente. Sin embargo, todos los activos son de hardware. Se especifica el valor codificado de forma rígida Hardware en el campo de fuente.
También se puede utilizar el objeto de destino principal para especificar que todos los registros del archivo de datos fuente pertenecen a una familia o plantilla concretas. Por ejemplo, la selección de Activo (hardware) en Objeto de destino principal especifica que todos los registros de fuente pertenecen a la familia de activos de hardware.
Varios valores para un solo campo
Se puede agregar una asignación con varios valores del Campo de fuente que se asignan a un único Campo de destino.
Ejemplo: utilización de varios valores para un único campo
El archivo de datos fuente tiene dos columnas con los nombres Fabricante y Nombre del catálogo. El usuario combina estas columnas mediante su selección en el Campo de fuente. En este ejemplo, la selección del Campo de fuente sería %Fabricante% %Nombre del catálogo%.
También se pueden introducir varios valores codificados de forma rígida en el Campo de fuente. Por ejemplo, Departamento de TI %nombre del modelo% de la Compañía de gestión de documentos.
Filtrado de los datos de la importación
Se puede identificar un subconjunto de registros en el archivo de datos fuente que se desea excluir de la importación. El filtro de exclusión del importador de datos permite filtrar una parte de la fuente de datos utilizando reglas de filtro de exclusión.
Ejemplo: definición de un filtro de exclusión para procesar activos devueltos
Un archivo CSV que se recibe del distribuidor de hardware incluye activos que se solicitaron y devolvieron al distribuidor. Se desea procesar solo los activos devueltos, así que solo se desea importar los datos para actualizar esos registros. Se define un filtro de exclusión para excluir los registros que no tienen el estado Devuelto.
Siga los pasos siguientes:
  1. En la ficha Administración, vaya a la página Importador de datos y en el área Filtro de exclusión de una importación seleccionada, seleccione el Tipo de filtro.
    • Y
      Excluye un registro del archivo de datos fuente solamente si todas las reglas que se especifican son válidas para el registro.
    • O
      Excluye un registro del archivo de datos fuente si cualquiera de las reglas que se especifican es válida para el registro.
  2. Haga clic en Nuevo.
  3. Haga clic en el icono Seleccionar situado junto a Campo de fuente, seleccione una columna del archivo de datos fuente y haga clic en Aceptar.
    Los símbolos de porcentaje situados antes y después de que los nombres de columna identifican los nombres como columnas del archivo de datos fuente.
  4. Seleccione el operador.
    Para especificar el operador "no igual a", seleccione "<>".
  5. Introduzca un Valor del filtro para la regla.
    Se pueden utilizar caracteres especiales y caracteres comodín en el valor del filtro. Las reglas pueden procesar campos de texto, numéricos y de fecha.
  6. Haga clic en el icono Completar edición del registro.
  7. (Opcional) Haga clic en Nuevo y especifique más reglas de filtro de exclusión.
  8. Haga clic en Guardar.
    Las reglas de filtro de exclusión se guardarán y se aplicarán cuando se procese la importación.
Ejemplo: creación de un filtro de exclusión
José lleva a cabo los siguientes pasos para crear un filtro de exclusión. El filtro elimina de la importación de datos a los empleados ajenos a las TI y a los empleados que no trabajan en la sede de la compañía.
  1. Selecciona Y para el Tipo de filtro y hace clic en Nuevo en el área Filtro de exclusión de la página Detalles de la importación.
  2. Selecciona
    %Departament%
    para Campo de fuente.
  3. Selecciona <> para el operador.
  4. Introduce TI para el valor del filtro.
  5. Hace clic en el icono Editar el registro completo y hace clic en Nuevo.
  6. Selecciona %Location% para el Campo de fuente.
  7. Selecciona <> para el operador.
  8. Introduce Sede para el Valor del filtro.
  9. Hace clic en el icono Editar el registro completo y hace clic en Guardar.
Envío de la importación
Para iniciar una importación inmediatamente, haga clic en Enviar en el área Planificación de la página. Se procesan los registros de las fuentes de datos desde el archivo de datos para la importación seleccionada.
Se puede especificar un archivo de datos distinto del predeterminado (en la Información básica) si desea utilizar un archivo diferente.
También se puede planificar la importación en una determinada fecha y hora. Para obtener más información, consulte Planificación de la importación.
Para ver los trabajos de importación de la importación seleccionada actual, haga clic en Trabajos asociados en la parte izquierda de la página. Para ver todas las tareas de importación de todas las importaciones, haga clic en Trabajos de importación en la parte izquierda de la página. En la lista de trabajos de importación que aparece, haga clic en Mensaje de estado para ver el estado de una importación.
También se puede ver el archivo de registro para obtener más información sobre la actividad de la importación. En la lista de trabajos de importación, haga clic en Ver registros para la importación seleccionada.
Planificación de la importación
Se puede planificar una importación en una hora específica y se puede especificar el intervalo de la importación (por ejemplo, diario o semanalmente). Se pueden planificar varias importaciones para que se procesen de forma simultánea.
Siga estos pasos:
  1. En la ficha Administración, vaya a la página Importador de datos y en el área Planificación de una importación seleccionada, seleccione la casilla de verificación Planificado.
  2. Proporcione la información necesaria para la planificación. A continuación, se proporciona una breve explicación de los campos siguientes:
    • Hora de ejecución
      Especifica la hora del día, en formato de 24 horas, en la que se procesará la importación. Cuando se planifiquen importaciones, utilice la zona horaria local del servidor de aplicaciones de CA APM.
    • Día del intervalo
      Especifica el día del Tipo de intervalo para procesar la importación. Por ejemplo, si el Tipo de intervalo es Mes y el Día del intervalo es 1, la importación se procesará en el primer día del mes.
    • Archivo de datos
      Especifica un nombre del archivo de datos distinto del predeterminado (de la Información básica) si se desea utilizar un archivo diferente.
      Si este archivo está disponible en el servidor de aplicaciones, se puede buscar y seleccionar el archivo. Si este archivo no está disponible en el servidor de aplicaciones, se puede buscar y cargar el archivo.
    • Cargar archivo de datos
      Busque el archivo de datos fuente que se desea importar. Este archivo se carga en el servidor de aplicaciones.
    • Fecha de primera ejecución
      Especifica la fecha cuando se procesa la primera importación.
    • Tipo de intervalo
      Especifica el tipo de intervalo para la importación (por ejemplo, Día, Mes, Trimestre, Semana o Año).
    • Intervalo
      Especifica la frecuencia con la que se procesa la importación. Este intervalo se basa en el Tipo de intervalo especificado. Por ejemplo, si el Tipo de intervalo es Semanal y el Intervalo es 2, la importación se procesará cada dos semanas.
    • Último día del intervalo
      Especifica que la importación se procesa en el último día del Tipo de intervalo seleccionado. Si se selecciona esta casilla de verificación, se elimina cualquier valor anterior que se agrega al campo Día del intervalo y se desactiva el campo Día del intervalo.
  3. Haga clic en Enviar.
    La importación de datos se ha planificado para la fecha y hora especificadas.
Ejemplos: utilización de la configuración de la planificación
Los siguientes ejemplos ilustran el uso de la configuración de la planificación.
  • Seleccione Día para el Tipo de intervalo y 2 para el Intervalo. La importación se procesará cada dos días.
  • Seleccione Semana para el Tipo de intervalo, 1 para el Día del intervalo y 3 para el Intervalo. La importación se procesará cada tres semanas, en el primer día de la semana (domingo).
  • Seleccione Mes para el Tipo de intervalo, 15 para el Día del intervalo y 2 para el Intervalo. La importación se procesará cada dos meses, en el día 15 del mes.
  • Seleccione Trimestre para el Tipo de intervalo y seleccione Último día para el Intervalo. La importación se procesará cada trimestre (cada tres meses), en el último día del último mes del trimestre.
  • Seleccione Año para el Tipo de intervalo, 1 para el Día del intervalo y 1 para el Intervalo. La importación se procesará el 1 de enero de cada año.
Para ver los trabajos de importación de la importación seleccionada actual, haga clic en Trabajos asociados en la parte izquierda de la página. Para ver todas las tareas de importación de todas las importaciones, haga clic en Trabajos de importación en la parte izquierda de la página. En la lista de trabajos de importación que aparece, haga clic en Mensaje de estado para ver el estado de una importación.
También se puede ver el archivo de registro para obtener más información sobre la actividad de la importación. En la lista de trabajos de importación, haga clic en Ver registros para la importación seleccionada.
Visualización de los detalles de la planificación
Se pueden ver los detalles de la planificación para una tarea de importación planificada que se ha creado.
En primer lugar, abra la lista de trabajos de importación.
  • Para ver los trabajos de importación planificados para la importación seleccionada actualmente, haga clic en Trabajos asociados en la parte izquierda de la página, seleccione la casilla de verificación Planificado y haga clic en Ir.
  • Para ver todos los trabajos de importación de todas las importaciones, haga clic en Trabajos de importación en la parte izquierda de la página, seleccione la casilla de verificación Planificado y haga clic en Ir.
En la lista de trabajos de importación que aparece, haga clic en Detalles de la planificación para una importación seleccionada.
Visualización de los archivos de registro de la importación
Se pueden ver los archivos de registro del importador de datos para ver los detalles de todas las importaciones proporcionadas por CA y definidas por el usuario que se hayan completado. El importador de datos crea un archivo de registro para cada importación que se ejecuta, incluyendo las importaciones que se han enviado inmediatamente o que se han planificado para el futuro. Todas las actividades de la importación se guardan en los archivos de registro.
Para ver los archivos de registro, abra primero la lista de trabajos de importación.
  • Para ver los trabajos de importación de la importación seleccionada actual, haga clic en Trabajos asociados en la parte izquierda de la página.
  • Para ver todos los trabajos de importación para todas las importaciones, haga clic en Trabajos de importación.
En la lista de trabajos de importación, haga clic en Ver archivos de registro para una importación seleccionada. Si más de un archivo de registro está disponible (por ejemplo, para una importación planificada que ya se ha completado unas cuantas veces), se enumerarán todos los archivos con las fechas de creación correspondientes.
Se puede ver cualquier archivo de registro de sincronización de importación LDAP disponible. Si se hace clic en Iniciar la sincronización e importación de datos LDAP en la página Sincronización e importación de datos LDAP (Administración, Gestión de usuarios y roles), se mostrará un ID de trabajo de importación. Utilice este ID de trabajo para localizar el trabajo en la lista del importador de datos de los trabajos de importación. A continuación, haga clic en Ver archivos de registro para ese trabajo.
También se puede buscar y ver los archivos de registro de importación en la siguiente ubicación del servidor de aplicaciones de CA APM:
[ITAM Root Path]\Storage\Common Store\Import\Logs
Revisión del archivo de registro de la importación: prácticas recomendables
El archivo de registro del Importador de datos contiene información y mensajes de error relacionados con el procesamiento de los trabajos de importación. La información contenida en este archivo facilita la comprensión de los resultados de la importación y permite solucionar cualquier posible error. Esta sección contiene algunas mejores prácticas recomendadas para trabajar con el archivo de registro del Importador de datos.
Coincidencia del número de fila del archivo de datos con el mensaje de error del archivo de registro
El mensaje de error del archivo de registro identifica el número de fila correspondiente en el archivo de datos. También se puede localizar el número de fila del archivo de datos en la fila anterior o posterior al mensaje de error en el archivo de registro.
A veces, el mensaje de error del archivo de registro no muestra el número de fila del archivo de datos. En este caso, los valores reales del archivo de datos se muestran inmediatamente después del mensaje de error en el archivo de registro.
Recuento del número de mensajes de error en el archivo de registro
  1. Se deben buscar las siguientes frases en el archivo de registro para localizar los mensajes de error en el archivo. Estas frases se incluyen con los mensajes de error.
    Web Service threw exception Error at record
  2. Una vez localizado un tipo de mensaje de error, se debe buscar ese error en el archivo de registro y hacer un recuento del número de instancias.
  3. A continuación, se deben identificar y buscar más tipos de error que aparezcan en el archivo de registro y contar el número de instancias.
  4. Finalmente, se debe comparar el recuento de todos los errores del archivo de registro con las estadísticas generadas por el Importador de datos para la importación asociada. Para visualizar estas estadísticas, se debe hacer clic en Mensaje de estado en la lista de Trabajos asociados o Trabajos de importación. Esta comparación facilita el recuento de todos los errores relevantes e identifica los mensajes de error que no son válidos y que se pueden ignorar.
Comprobación de los datos importados
Se puede comprobar que la importación de datos se ha realizado correctamente consultando los datos en CA APM y revisando las estadísticas del importador de datos.
  • Revise las estadísticas del importador de datos.
    Para consultar las estadísticas de la importación seleccionada actual, haga clic en Trabajos asociados en la parte izquierda de la página. En la lista de trabajos de importación que aparece, haga clic en Mensaje de estado de la importación.
    También se puede ver el archivo de registro para obtener más información sobre la actividad de la importación. En la lista de trabajos de importación, haga clic en Ver registros para la importación seleccionada.
  • Vea los datos importados a CA APM.
    Para ver los datos importados, vaya a la ficha y subficha, si es necesario, del objeto importado (por ejemplo, activo, compañía o contacto). Busque los objetos que se han importado y verifique que los objetos estén disponibles.
Ejemplo: verificación de la importación de datos de nuevos empleados
Una vez que José ejecute la importación, llevará a cabo los siguientes pasos para verificar la importación de datos de nuevos empleados:
  1. Comprueba las estadísticas de la importación.
    • Hace clic en Trabajos asociados o Trabajos de importación en la parte izquierda de la página Importador de datos.
    • Hace clic en Mensaje de estado para la importación y consulta las estadísticas.
  2. Consulta el archivo de registro de la importación y la interfaz de usuario.
    • Hace clic en Ver registros en la lista de trabajos de importación y revisa el contenido del archivo de registro.
    • Va a Directorio, Contacto de la interfaz de usuario de CA APM. Busca los nuevos empleados. Verifica que no están disponibles los empleados que no son del Departamento de TI ni los que son empleados que no trabajan en la sede de la compañía.