Cómo enviar una importación de datos utilizando un workflow de procesos

Se puede utilizar un workflow de procesos (por ejemplo, CA Process Automation) para enviar una importación de datos del importador de datos para su procesamiento en lugar de utilizar la interfaz de usuario de CA APM.
casm173
Se puede utilizar un workflow de procesos (por ejemplo, CA Process Automation) para enviar una importación de datos del importador de datos para su procesamiento en lugar de utilizar la interfaz de usuario de CA APM.
Se puede crear un workflow de procesos de importación datos utilizando un archivo XML de ejemplo proporcionado por la compañía y realizando la integración con CA Process Automation.
Para enviar una importación de datos utilizando un workflow de procesos, realice los siguientes pasos:
Ejemplo: importación de nuevos dispositivos de hardware a través de un workflow de procesos
José, el administrador del sistema de CA APM en Document Management Company, ha definido un workflow de procesos de negocio. El workflow detecta nuevos dispositivos de hardware, agrega los nuevos dispositivos al repositorio de datos de la compañía y ejecuta informes sobre los dispositivos nuevos. José ya ha creado una importación de datos en CA APM que agrega los nuevos dispositivos de hardware al repositorio de datos. José desea ejecutar dicha importación de datos en un momento determinado de su workflow general. Desea integrar la importación de datos con su workflow general de procesos de negocio. José desea que la importación de datos se ejecute en el momento en el que el workflow se especifica sin que el usuario tenga que iniciar sesión en la interfaz de usuario del producto. José actualiza su workflow de procesos de negocio para que incluya las llamadas a las operaciones del servicio web de CA APM para el importador de datos.
Revisión de los requisitos previos
Para garantizar que se pueda enviar correctamente una importación de datos utilizando un workflow de procesos, verifique que se hayan completado los requisitos previos siguientes:
  1. Defina una importación de datos con todas las asignaciones y configuraciones de la interfaz de usuario de CA APM.
  2. Compruebe que la ruta del archivo de datos (si se está especificando una ruta) sea accesible desde el servidor donde se está ejecutando el servicio de importación. Además, el usuario del servicio de red (identidad del grupo de aplicaciones) requiere tener acceso a esta ruta.
  3. Defina un workflow de procesos utilizando un proveedor de workflows (por ejemplo, CA Process Automation).
Especificación de las llamadas del workflow
Para iniciar el importador de datos y ejecutar una importación de datos desde un workflow de procesos, se proporcionan las llamadas del workflow específicas para las operaciones del servicio web de CA APM. Estas operaciones realizan las siguientes funciones:
  • Operación Login: inicio de sesión en CA APM.
  • Envía una importación de datos mediante una de las siguientes formas de proporcionar un archivo de datos:
    • Operación SubmitImportwithfilepath: el archivo de datos está disponible en una ruta de archivo especificada. Esta ruta de archivo debe ser accesible desde el servidor donde se está ejecutando el servicio de importación. La operación del servicio web carga el archivo.
    • Operación SubmitImport: el contenido del archivo de datos se ha convertido al formato binario de la matriz de bytes. La operación del servicio web recibe el contenido de la matriz de bytes desde una aplicación y envía el contenido al importador de datos.
      Para utilizar este modo de proporcionar un archivo de datos, cree una aplicación, si no tiene una disponible, para convertir el contenido del archivo de datos al formato de la matriz de bytes. La aplicación, a continuación, envía el contenido a la operación del servicio web.
Incorpore las llamadas a estas operaciones al workflow de procesos de negocio.
Para obtener más información sobre la creación de un workflow de procesos, consulte la documentación del producto del proveedor de workflows.
Operación Login
Esta operación inicia sesión en CA APM utilizando el ID de usuario y la contraseña especificados de CA APM. El resultado de esta operación es el token de inicio de sesión. El token de inicio de sesión se utiliza como entrada para otras operaciones del workflow de importación de datos.
  • Parámetros de entrada
    ItamUserName: ID de usuario de CA APM
    ItamUserPassword: contraseña del usuario de CA APM
  • Parámetros de salida
    loginToken: token que se devuelve tras iniciar sesión en CA APM.
Operación SubmitImport
Esta operación recibe el contenido del archivo de datos que se ha convertido al formato de la matriz de bytes y envía el contenido con la importación de datos al importador de datos. Para utilizar esta operación, cree una aplicación, si no tiene una disponible, para convertir el contenido del archivo de datos al formato de la matriz de bytes. La aplicación, a continuación, envía el contenido a esta operación del servicio web.
Esta operación devuelve un ID de trabajo de importación de datos, que se utiliza para verificar el estado del trabajo de importación.
  • Parámetros de entrada
    loginToken: token que se devuelve tras iniciar sesión en CA APM.
    ImportNam: nombre de la importación de datos.
    Datafilename: nombre del archivo de datos que se asocia con la importación de datos.
    Datafilestream: contenido del archivo de datos en formato de la matriz de bytes.
    Caprovided: (opcional) indicador que especifica una importación de datos proporcionada por el producto. Establezca este parámetro en uno (1) para especificar una importación proporcionada por el producto.
    Tenant: (solo para multicliente) nombre del cliente al que se aplica la importación.
  • Parámetros de salida
    Job ID: ID que se devuelve después de que una importación de datos se haya enviado correctamente. La operación GetJobStatus utiliza este ID para verificar el estado de un trabajo de importación.
Operación SubmitImportwithfilepath
Esta operación carga un archivo de datos desde una ruta de archivo especificada y envía el archivo de datos con la importación de datos al importador de datos. Esta ruta de archivo debe ser accesible desde el servidor donde se está ejecutando el servicio de importación.
La operación devuelve un ID de trabajo de importación de datos, que se utiliza para verificar el estado del trabajo de importación.
  • Parámetros de entrada
    loginToken: token que se devuelve tras iniciar sesión en CA APM.
    ImportNam: nombre de la importación de datos.
    Datafilepath: ruta completa y nombre del archivo de datos que se asocia con la importación de datos. Esta ruta debe ser accesible desde el servidor donde se está ejecutando el servicio de importación. Además, el usuario del servicio de red (identidad del grupo de aplicaciones) requiere tener acceso a esta ruta.
    Si la ubicación del archivo de datos es una ruta compartida, el servidor de CA APM y el equipo compartido deben estar en el mismo dominio. Caprovided (opcional): indicador que especifica una importación de datos proporcionada por el producto. Establezca este parámetro en uno (1) para especificar una importación proporcionada por el producto.
    Tenant: (solo para multicliente) nombre del cliente al que se aplica la importación.
  • Parámetros de salida
    Job ID: ID que se devuelve después de que una importación de datos se haya enviado correctamente. La operación GetJobStatus utiliza este ID para verificar el estado de un trabajo de importación.
Comprobación del estado del trabajo de importación
El importador de datos proporciona un resumen del estado de cada trabajo de importación de datos enviado. El workflow de procesos puede incluir una llamada a la operación del servicio web de CA APM que recupera el estado de un trabajo de importación de datos enviado. Incorpore la llamada a esta operación en el workflow de procesos.
Operación GetJobStatus
Esta operación utiliza el ID de trabajo de importación de datos para verificar el estado de un trabajo de importación.
  • Parámetros de entrada
    loginToken: token que se devuelve tras iniciar sesión en CA APM.
    Job ID: ID que se devuelve después de que una importación de datos se haya enviado correctamente.
  • Parámetros de salida
    Job Status: estado del trabajo de importación.
Respuesta a los mensajes de error
Si se producen errores durante el proceso del workflow de importación de datos, se pueden recibir mensajes de error. Los siguientes mensajes requieren una explicación:
  • 20002: no se puede acceder a la importación de datos debido a los permisos del usuario. Póngase en contacto con el administrador.
    El rol de usuario requiere tener acceso de administrador del importador de datos o acceso de usuario del importador de datos para enviar una importación de datos.
  • 20005: no se puede conectar con el servicio de importación. Póngase en contacto con el administrador.
    Verifique la dirección URL del servicio de importación en el archivo ImportProcessor.config o póngase en contacto con el administrador.
  • 21002: el nombre de la importación de datos no es válido.
    La importación de datos no existe o el usuario no tiene acceso a la importación de datos. Si la importación de datos es una importación proporcionada por el producto, especifique el valor 1 para el parámetro Caprovided.
  • 21004: se ha producido un error al cargar el archivo de datos.
    Este mensaje puede ser el resultado de un error de configuración. Revise los archivos de registro del servicio de gestores de almacenamiento.
  • 21005: no hay asignaciones definidas para la importación de datos.
    Defina las asignaciones y vuelva a enviar la importación de datos.
  • 22001: el ID de trabajo de importación de datos no es válido. Compruebe el ID de trabajo e intente ejecutar de nuevo la importación.
    Compruebe el ID de trabajo iniciando sesión en CA APM y ubicando el trabajo de importación de datos. Vuelva a enviar la importación de datos con el ID de trabajo válido.