Saltar al contenido

Actividad de colocación de objetos de Amazon S3

Introducción

Una actividad Put Object de Amazon S3, que utiliza su conexión de Amazon S3, coloca datos de objetos en Amazon S3 y está destinado a usarse como destino para consumir datos en una operación.

Crear una actividad Put Object de Amazon S3

Se crea una instancia de una actividad Put Object de Amazon S3 desde una conexión de Amazon S3 utilizando su tipo de actividad Poner objeto.

Para crear una instancia de una actividad, arrastre el tipo de actividad al tela de diseño o copie el tipo de actividad y péguelo en el tela de diseño. Para obtener más detalles, consulte Creación de una instancia de actividad en Reutilización de componentes.

Se puede editar una actividad Put Object de Amazon S3 existente desde estas ubicaciones:

Configurar una actividad Put Object de Amazon S3

Siga estos pasos para configurar una actividad Put Object de Amazon S3:

Paso 1: Ingrese un nombre y seleccione un depósito

En este paso, proporcione un nombre para la actividad y seleccione el depósito que se utilizará.

La interfaz utilizada en este paso de la configuración de una actividad Put Object de Amazon S3 depende del Bucket Opciones seleccionadas:

  • Usar listas: Esta opción completará una lista de depósitos existentes para elegir.

  • Usar entradas de texto: Para esta opción, ingresará manualmente el nombre del depósito de Amazon S3.

Utilice listas

Si se selecciona Usar listas para Opciones de depósito, se presenta esta interfaz:

Paso 1 de configuración de la actividad Put Object de Amazon S3

Sugerencia

Campos con un ícono de variable Ícono de variable admite el uso de variables globales,variables del proyecto y variables Jitterbit. Comience escribiendo un corchete abierto [ en el campo o haciendo clic en el ícono de variable para mostrar una lista de las variables existentes para elegir.

  • Nombre: Ingrese un nombre para identificar la actividad. El nombre debe ser único para cada actividad Put Object de Amazon S3 y no debe contener barras diagonales (/) o dos puntos (:).

  • Seleccionar un depósito: De la lista completa, seleccione el depósito que contiene el objeto.

  • Clave: Ingrese la clave del objeto que desea recuperar del depósito. Esto se ignorará si bucketName o objectId se especifica en el esquema de datos PutObjectRequest.

  • Configuración opcional: Haga clic para expandir configuraciones opcionales adicionales:

    Configuración opcional del objeto put de Amazon S3

  • Guardar y salir: Si está habilitado, haga clic para guardar la configuración de este paso y cerrar la configuración de la actividad.

  • Siguiente: Haga clic para almacenar temporalmente la configuración de este paso y continuar con el siguiente paso. La configuración no se guardará hasta que haga clic en el botón Terminado en el último paso.

  • Descartar cambios: Después de realizar cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le solicitará que confirme que desea descartar los cambios.

Utilizar entradas de texto

Si se selecciona Usar entradas de texto para Opciones de depósito, se presenta esta interfaz:

El objeto put de Amazon S3 utiliza entradas de texto

  • Nombre: Ingrese un nombre para identificar la actividad. El nombre debe ser único para cada actividad Put Object de Amazon S3 y no debe contener barras diagonales (/) o dos puntos (:).

  • Nombre del depósito: Ingrese el nombre del Amazon S3 que contiene el objeto.

  • Clave: Ingrese la clave del objeto que desea recuperar del depósito. Esto se ignorará si: bucketName o objectId se especifica en el esquema de datos PutObjectRequest.

  • Configuración opcional: Haga clic para expandir configuraciones opcionales adicionales:

    Configuración opcional del objeto put de Amazon S3

  • Guardar y salir: Si está habilitado, haga clic para guardar la configuración de este paso y cerrar la configuración de la actividad.

  • Siguiente: Haga clic para almacenar temporalmente la configuración de este paso y continuar con el siguiente paso. La configuración no se guardará hasta que haga clic en el botón Terminado en el último paso.

  • Descartar cambios: Después de realizar cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le solicitará que confirme que desea descartar los cambios.

Paso 2: Revisar los esquemas de datos

Se muestran todos los esquemas de solicitud o respuesta generados desde el extremo. A continuación, se describe cada elemento de la interfaz de usuario de este paso.

Paso 2 de configuración de la actividad Put Object de Amazon S3

  • Esquemas de datos: Estos esquemas de datos son heredados por transformaciones adyacentes y se muestran nuevamente durante el mapeo de transformación.

    Nota

    Los datos suministrados en una transformación tienen prioridad sobre la configuración de la actividad.

    El conector de Amazon S3 utiliza el AWS SDK para Java versión 1.12.770. Consulte la documentación de la API para obtener información sobre los nodos y campos del esquema.

    Los esquemas de datos de solicitud y respuesta constan de estos nodos y campos:

    Campo/nodo de esquema de solicitud Campo/método de API de Amazon S3 Descripción
    SolicitudDeObjetoDePublicar SolicitudDeSubirParte Solicitud para colocar contenido en un depósito como una carga de varias partes
    Bucket bucketName Cadena con el nombre del bucket que contiene la carga multiparte existente e iniciada, con la que se asociará esta nueva parte
    Clave clave Cadena con la clave de la carga multiparte iniciada
    Datos clave Base64binary que contiene el contenido del objeto, que se cargará como una carga de varias partes

    Consejo

    Puedes utilizar una combinación de Jitterbit Base64Encode, HexToBinary, y StringToHex funciones para convertir datos a binario base64:
    $amazonData = Base64Encode(HexToBinary(StringToHex($myData)));
    Campo/nodo de esquema de respuesta Campo/método de API de Amazon S3 Descripción
    PutObjectResponse Resultado de carga múltiple completa Respuesta al colocar contenido en un depósito como una carga de varias partes
    ETag obtenerETag La etiqueta de entidad que identifica el nuevo objeto
    Última modificación getLastModified Valor de fecha y hora del encabezado Última modificación, que indica la fecha y hora en la que Amazon S3 registró por última vez una modificación en el objeto asociado
    Resultado n/a Cadena del resultado

  • Actualizar: Haga clic en el ícono de actualización Ícono de actualización o la palabra Actualizar para regenerar esquemas desde el extremo de Amazon S3. Esta acción también regenera un esquema en otras ubicaciones en todo el proyecto donde se hace referencia al mismo esquema, como en una transformación adyacente.

  • Atrás: Haga clic para almacenar temporalmente la configuración de este paso y regresar al paso anterior.

  • Terminado: Haga clic para guardar la configuración de todos los pasos y cerrar la configuración de la actividad.

  • Descartar cambios: Después de realizar los cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le solicitará que confirme que desea descartar los cambios.

Próximos pasos

Después de configurar una actividad Put Object de Amazon S3, complete la configuración de la operación agregando y configurando otras actividades, transformaciones o secuencias de comandos como pasos de la operación. También puede configurar los ajustes de la operación, que incluyen la capacidad de encadenar operaciones que se encuentran en el mismo flujo de trabajo o en flujos de trabajo diferentes.

Se puede acceder a las acciones del menú de una actividad desde el panel del proyecto y el tela de diseño. Para obtener más información, consulte menú de acciones de la actividad en Conceptos básicos del conector.

Las actividades Put Object de Amazon S3 se pueden usar como destino con estos patrones de operación:

Para utilizar la actividad con funciones de script, escriba los datos en una ubicación temporal y luego use esa ubicación temporal en la función de script.

Cuando esté listo, desplegar y ejecute la operación y validar el comportamiento comprobando los registros de operación.