Uso de IBM Aspera con IBM App Connect Enterprise

IBM® Aspera permite la transferencia de datos a alta velocidad de grandes archivos y conjuntos de datos a través de redes globales, independientemente del tamaño del archivo, la distancia de transferencia o las condiciones de la red.

Los siguientes pasos le muestran cómo conectarse a una IBM Aspera cuenta y configurar un nodo de solicitud IBM Aspera mediante el descubrimiento de conectores.

1. En el kit de herramientas de « IBM App Connect Enterprise », crea un flujo que contenga un nodo « IBM » de « Aspera Request ».
2. Seleccione el nodo IBM Aspera Request en el flujo para mostrar las propiedades del nodo en el editor.
3. En la pestaña Básico, haz clic en Iniciar Connector Discovery.
   Se visualiza un panel en el que se especifica el nombre del proyecto de política y los detalles de almacenamiento que se utilizarán durante el descubrimiento del conector.
4. Especifique los detalles del proyecto de política y almacenamiento que se utilizará durante el descubrimiento del conector:
   1. En el campo Proyecto de políticas, especifique el proyecto de políticas que se utiliza para almacenar las políticas que se crean durante la detección de conectores.
      De forma alternativa, puede crear un nuevo proyecto de política pulsando Nuevo y especificando el nombre del nuevo proyecto de política. A continuación, pulse Finalizar.
   2. Especifique el almacén que se utilizará durante el descubrimiento del conector. De forma predeterminada, las credenciales que se utilizan durante la detección de conectores se almacenan en un almacén de directorio externo, que es un App Connect Enterprise bóveda que puede ser utilizada por cualquier servidor de integración. Alternativamente, puede almacenar las credenciales en una bóveda del servidor de integración, que se crea en el directorio de trabajo del servidor de integración y sólo puede ser utilizada por ese servidor de integración específico.
      Para especificar el almacén que se utilizará para almacenar las credenciales, completa los pasos de la sección Uso del asistente Connector Discovery de uno de los siguientes temas:

      • Configuración de un almacén de directorios externo
      • Configuración de un almacén del servidor de integración
   3. En el campo Clave de almacén, introduzca la clave de almacén que se utiliza para acceder a las credenciales almacenadas en el almacén. La clave de almacenamiento debe tener al menos 8 caracteres de longitud.
   4. Opcional: De forma predeterminada, la ubicación del almacén y la clave del almacén especificadas se guardan como preferencias en el kit de herramientas para que los valores estén preestablecidos al iniciar Connector Discovery. Si no desea que se guarden las preferencias, deseleccione Guardar en las preferencias de almacenamiento.
5. Haga clic en Launch Discovery para iniciar el asistente Connector Discovery para el conector IBM Aspera.
   Aparecerá la ventana Connector Discovery. Si existen IBM Aspera conexiones (cuentas) existentes, se muestra una lista de dichas conexiones. Si no hay conexiones existentes, el estado del IBM Aspera conector se muestra como Not connected.
   • Si hay una o varias IBM Aspera conexiones (cuentas) disponibles, complete los siguientes pasos:
     1. Seleccione la conexión (cuenta) que desea utilizar haciendo clic en ella.
     2. Haga clic en Mostrar acciones.
     3. Pulse el tipo de objeto necesario y, a continuación, seleccione la acción que desea realizar en el objeto. Por ejemplo, para recuperar todos los índices de IBM Aspera haga clic en Archivos y, a continuación, en Recuperar metadatos de archivo por ID.
   • Si no hay conexiones (cuentas) existentes, realice los pasos siguientes:
     1. Aparece una ventana en la que puede introducir los datos de conexión de su cuenta IBM Aspera cuenta. Introduzca la siguiente información en el asistente del conector:

        • URL de la API del nodo Aspera : especifique la URL base donde se aloja la API del nodo Aspera
        • Aspera clave de acceso a la API del nodo : Especifique la clave de acceso para autenticar la API del nodo Aspera
        • Aspera node API secret : especifique el secreto para autenticar la API del nodo Aspera
        • Anular servidor URL : Especifique el servidor de anulación URL si desea conectarse a un punto final en una red privada utilizando el cliente de red privada, o para anular el servidor URL. Especifique un valor de anulación para el host y el puerto para el conector en el formato <http o https>://<nombre_host>:<puerto>. Si no utiliza el cliente de red privada o no necesita una anulación, deje este campo en blanco.
        • Permitir certificados auto firmados: Establezca este campo en true para poder aceptar certificados autofirmados que sean de confianza y que sólo se utilicen en un entorno que no sea de producción. El valor por omisión es false.
     2. Pulse Conectar.

     Para obtener más información sobre cómo identificar estos datos de conexión, consulte «Cómo utilizar IBM App Connect con IBM Aspera » en la documentación sobre entrega continua (CD) de IBM App Connect in containers.

6. Establezca las propiedades de conector necesarias en el asistente.
   También puede establecer propiedades que especifiquen el número máximo de registros a recuperar y la acción a realizar si se supera ese límite.
7. Cuando hayas terminado de especificar las propiedades en el asistente Connector Discovery, haz clic en Guardar.
   La credencial que se utiliza para conectarse a IBM Aspera se guarda en la bóveda, y los demás detalles de la conexión se guardan en la política IBM Aspera. Los valores de las propiedades que se configuran en el asistente se devuelven al nodo de solicitud « IBM » ( Aspera ) del kit de herramientas « IBM App Connect Enterprise ».
8. Cuando termines el descubrimiento y guardes los valores de las propiedades, sal del asistente de descubrimiento de conectores haciendo clic en la X de la esquina superior derecha de la ventana o pulsando Alt+F4.
9. Volver a editar el nodo « IBM » ( Aspera ) en el kit de herramientas « IBM App Connect Enterprise ».
   Las propiedades del conector que se establecieron en el asistente de descubrimiento de conectores (en el paso 6 ) son ahora visibles en el nodo IBM Aspera Request en el editor de propiedades. La pestaña Básico muestra los valores de las propiedades Acción y Objeto que ha establecido en el asistente. Por ejemplo, si ha seleccionado Archivos > Recuperar metadatos de archivo por ID en el asistente, las siguientes propiedades estarán visibles en la pestaña Básico del nodo:

   • Acción - getFilesByIdFiles
   • Objeto - Files

   Los valores de las propiedades Acción y Objeto se visualizan en formato de solo lectura. Si desea cambiar estos valores, puede hacerlo pulsando de nuevo Iniciar el descubrimiento del conector y estableciendo nuevos valores en el asistente de descubrimiento de conectores.

   La propiedad Schema base name especifica el nombre base de los archivos de esquema que describen el formato de los mensajes de solicitud y respuesta que se envían y reciben del IBM Aspera conector. El nombre base del esquema se establece automáticamente la primera vez que se ejecuta la detección para el nodo, y se basa en el nombre del flujo actual y el nombre del nodo. Si establece esta propiedad manualmente antes de ejecutar la detección por primera vez, se utilizará el valor que haya establecido. Si cambia el nombre de los esquemas después de la detección, debe editar esta propiedad para que coincida con el nombre base del esquema que utilizan los esquemas renombrados en el proyecto. Si cambia esta propiedad después de la detección, deberá renombrar los nombres de los esquemas para que coincidan o volver a ejecutar la detección.

   Dependiendo de la acción seleccionada durante la detección, el asistente de detección de conectores genera un esquema de solicitud y un esquema de respuesta, o sólo un esquema de respuesta. Sólo se genera un esquema de solicitud si la acción y el objeto seleccionados requieren un mensaje de solicitud. El esquema de solicitud generado se utiliza para validar el mensaje de solicitud. Si la acción fue RETRIEVE o DELETE, el conector sólo devuelve el esquema de respuesta.

   Los archivos de esquema generados se añaden al proyecto y pueden ser utilizados por un nodo de Mapeo para transformar los datos de entrada o salida. El nombre de archivo completo del esquema se deriva del nombre base del esquema (como gen/MyMessageFlow.IBM_Aspera_Request), con el sufijo response.schema.json o request.schema.json. Puede abrir el esquema haciendo clic en Abrir esquema de solicitud o Abrir esquema de respuesta.

10. Compruebe que la configuración de las propiedades del nodo IBM Aspera Request es correcta y, a continuación, guarde el flujo de mensajes.
11. En la pestaña Connection del nodo IBM Aspera Request, la propiedad Policy muestra el nombre de la política que contiene los detalles de la identidad de seguridad que se utilizará para la conexión. La póliza tiene un tipo de IBM Aspera.
    Para más información, consulte IBM Aspera policy.
12. Opcional: Establezca la propiedad Tiempo de espera en la pestaña Conexión para especificar el tiempo (en segundos) que el nodo espera a que IBM Aspera procese la operación.
13. La pestaña Filtro del nodo IBM Aspera Request contiene propiedades que controlan cómo selecciona los datos el flujo de mensajes. Los valores iniciales de estas propiedades se toman de los valores de las propiedades que se establecieron para el IBM Aspera en el asistente Connector Discovery, incluidas las propiedades de las opciones de filtro y cualquier condición que se haya especificado (como se describe en el paso 6 ). Luego, si vuelves al asistente de Connector Discovery y cambias los valores de cualquier propiedad (añadiendo nuevas condiciones, por ejemplo) esas actualizaciones se reflejarán en las propiedades establecidas en el nodo.

    Las propiedades de las Opciones de Filtrado controlan sobre qué objetos se va a operar cuando se ejecute el nodo IBM Aspera Request. Las propiedades Límite del filtro controlan el número máximo de elementos que se recuperarán y la acción que se llevará a cabo si se supera el límite.

    Puede modificar los valores haciendo clic en Editar junto al valor que desea modificar en la sección Opciones de filtro, y cambiando los valores de las propiedades que se han establecido en la sección Límite del filtro.

    Los valores de las propiedades pueden ser valores de texto o expresiones ESQL o XPATH que se resuelven a partir del contenido del mensaje que se pasa al nodo IBM Aspera Request a medida que se ejecuta.

14. En la pestaña Solicitud, establezca la propiedad Ubicación de datos para especificar la ubicación en el árbol de mensajes entrantes que contiene los datos de objeto que se crearán en IBM Aspera. Estos datos forman la solicitud que se envía desde el nodo de solicitud IBM Aspera al IBM Aspera sistema.
15. En la pestaña Resultado, establezca la propiedad Ubicación de los datos de salida para especificar la ubicación en el árbol de mensajes de salida que contendrá los datos del registro creado en IBM Aspera.
16. Por defecto, los mensajes de solicitud se validan contra el esquema de solicitud que se generó durante el descubrimiento del conector. Puede desactivar la validación de solicitudes o cambiar la configuración de validación mediante las propiedades de Validación del nodo Solicitud de IBM Aspera.
17. Guarde el flujo de mensajes.