Saltar al contenido

Actividad Amazon S3 Put Object en Jitterbit Studio

Introducción

Una actividad Amazon S3 Put Object, utilizando su conexión Amazon S3, coloca datos de objetos en Amazon S3 y está diseñada para usarse como destino para consumir datos en una operación.

Requisitos previos

La actividad Put Object requiere los siguientes permisos de Amazon S3:

Permiso necesario Funcionalidad
s3:ListAllMyBuckets Prueba de la conexión y recuperación de metadatos de actividad durante la configuración de actividad
s3:PutObject y s3:GetBucketLocation Ejecución de la actividad Put Object

Crear una actividad Amazon S3 Put Object

Se crea una instancia de una actividad Amazon S3 Put Object a partir de una conexión Amazon S3 utilizando su tipo de actividad Put Object.

Para crear una instancia de una actividad, arrastra el tipo de actividad al lienzo de diseño o copia el tipo de actividad y pégalo en el lienzo de diseño. Para obtener más detalles, consulta Crear una instancia de actividad o herramienta en Reutilización de componentes.

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

Configurar una actividad Amazon S3 Put Object

Sigue estos pasos para configurar una actividad Amazon S3 Put Object:

Paso 1: Ingresa un nombre y selecciona un bucket

En este paso, proporciona un nombre para la actividad y selecciona un bucket para usar.

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

Seleccionar bucket de la lista

Si se selecciona Seleccionar bucket de la lista para Opciones de bucket, se presenta la interfaz descrita a continuación.

Consejo

Los campos con un icono de variable admiten el uso de variables globales, variables de proyecto y variables de Jitterbit. Comienza escribiendo un corchete de apertura [ en el campo o haz clic en el icono de variable para mostrar un menú con las variables existentes para elegir.

  • Menú de extremos: Si tienes múltiples extremos del mismo tipo de conector configurados, un menú en la parte superior de la pantalla muestra el nombre del extremo actual. Haz clic en el menú para cambiar a un extremo diferente. Para más información, consulta Cambiar el extremo asignado en Pantallas de configuración.

    • Editar extremo: Aparece al pasar el cursor sobre el nombre del extremo actual. Haz clic para editar la configuración de conexión del extremo seleccionado actualmente.

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

  • Seleccionar un bucket: De la lista poblada, selecciona el bucket que contiene el objeto.

  • Clave: Ingresa la clave del objeto que deseas recuperar del bucket. Se ignorará si bucketName u objectId se especifican en el esquema de datos PutObjectRequest.

  • Configuración opcional: Haz clic para expandir la configuración opcional adicional.

    • Región de AWS (anula la región del bucket): Selecciona una región de Amazon S3.

    • Metadatos del sistema: Utiliza esta tabla para adjuntar metadatos del sistema al cargar archivos mediante el conector de Amazon S3. Haz clic en el icono de agregar para agregar una nueva fila a la tabla. Selecciona una Clave e ingresa un Valor.

    • Metadatos del usuario: Utiliza esta tabla para adjuntar metadatos del usuario al cargar archivos mediante el conector de Amazon S3. Haz clic en el icono de agregar para agregar una nueva fila a la tabla e ingresa una Clave y un Valor.

      En ambas tablas de Metadatos del sistema y Metadatos del usuario, haz clic en el icono de envío en la columna más a la derecha para guardar una fila o utiliza el icono de descartar cambios para descartar los cambios que acabas de hacer. Para editar o eliminar una fila individual existente, pasa el cursor sobre la columna más a la derecha y utiliza el icono de editar o el icono de eliminar .

      Importante

      Los campos en las tablas muestran el icono de variable solo en modo de edición. Para que los valores de variable de estos campos se completen en tiempo de ejecución, la versión del agente debe ser al menos 10.75 / 11.13.

      Para eliminar todas las filas, haz clic en Borrar todo.

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

  • Siguiente: Haz clic para almacenar temporalmente la configuración de este paso y continuar al siguiente paso. La configuración no se guardará hasta que hagas clic en el botón Finalizado en el último paso.

  • Descartar cambios: Después de hacer cambios, haz clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje te pide que confirmes que deseas descartar los cambios.

Proporcionar bucket de S3 manualmente

Si se selecciona Proporcionar bucket de S3 manualmente para Opciones de bucket, se muestran estos campos:

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

  • Nombre del bucket: Ingresa el nombre del bucket de Amazon S3 que contiene el objeto.

  • Clave: Ingresa la clave del objeto que deseas recuperar del bucket. Se ignorará si bucketName u objectId se especifican en el esquema de datos PutObjectRequest.

  • Configuración opcional: Haz clic para expandir la configuración opcional adicional.

    • Región de AWS (anula la región del bucket): Selecciona una región de Amazon S3.

    • Metadatos del sistema: Utiliza esta tabla para adjuntar metadatos del sistema al cargar archivos mediante el conector de Amazon S3. Haz clic en el icono de agregar para agregar una nueva fila a la tabla. Selecciona una Clave e ingresa un Valor.

  • Metadatos de usuario: Usa esta tabla para adjuntar metadatos de usuario al cargar archivos con el conector de Amazon S3. Haz clic en el icono de agregar para añadir una nueva fila a la tabla e ingresa una Clave y un Valor.

    En ambas tablas de Metadatos del sistema y Metadatos de usuario, haz clic en el icono de envío en la columna más a la derecha para guardar una fila o usa el icono de descartar cambios para descartar los cambios que acabas de hacer. Para editar o eliminar una fila individual existente, pasa el cursor sobre la columna más a la derecha y usa el icono de editar o el icono de eliminar .

    Importante

    Los campos en las tablas muestran el icono de variable solo en modo de edición. Para que los valores de variable de estos campos se completen en tiempo de ejecución, la versión del agente debe ser al menos 10.75 / 11.13.

    Para eliminar todas las filas, haz clic en Borrar todo.

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

  • Siguiente: Haz clic para almacenar temporalmente la configuración de este paso y continuar al siguiente paso. La configuración no se guardará hasta que hagas clic en el botón Finalizado en el último paso.

  • Descartar cambios: Después de hacer cambios, haz clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje te pide que confirmes que deseas descartar los cambios.

Paso 2: Revisa los esquemas de datos

Se muestran todos los esquemas de solicitud o respuesta generados a partir del endpoint. Cada elemento de la interfaz de usuario de este paso se describe a continuación.

  • Esquemas de datos: Estos esquemas de datos los heredan las 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 la API de Amazon Simple Storage Service. Consulta la documentación de la acción PutObject 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:

    • Solicitud:

      Campo/Nodo del esquema de solicitud Descripción
      PutObjectRequest Solicitud para colocar contenido en un bucket como una carga de varias partes
      Bucket Cadena con el nombre del bucket que contiene la carga de varias partes iniciada existente, con la cual se asociará esta nueva parte
      Key Cadena con la clave de la carga de varias partes iniciada
      Data Base64binary que contiene el contenido del objeto, que se cargará como una carga de varias partes

      Consejo

      Puedes usar una combinación de las funciones Base64Encode, HexToBinary y StringToHex de Jitterbit para convertir datos a base64binary:
      $amazonData = Base64Encode(HexToBinary(StringToHex($myData)));

  • Respuesta:

    | Campo/Nodo del esquema de respuesta | Descripción                                                                                                                                       |
| ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| **`PutObjectResponse`**             | Respuesta al colocar contenido en un bucket como una carga de varias partes                                                                       |
| `ETag`                              | La [etiqueta de entidad](https://docs.aws.amazon.com/AmazonS3/latest/API/API_Object.html#AmazonS3-Type-Object-ETag) (ETag) que identifica el nuevo objeto |
| `LastModified`                      | Valor de fecha y hora del encabezado Last-Modified, que indica la fecha y hora en que Amazon S3 registró por última vez una modificación al objeto asociado |
| `Result`                            | Cadena del resultado                                                                                                                              |

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

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

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

  • Descartar cambios: Después de realizar cambios, haz clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje te pide que confirmes que deseas descartar los cambios.

Próximos pasos

Después de configurar una actividad Put Object de Amazon S3, completa la configuración de la operación agregando y configurando otras actividades o herramientas como pasos de la operación. También puedes configurar los parámetros de la operación, que incluyen la capacidad de encadenar operaciones que se encuentren en los mismos flujos de trabajo o en flujos de trabajo diferentes.

Las acciones de menú de una actividad son accesibles desde el panel del proyecto y el lienzo de diseño. Para obtener más detalles, consulta Menú de acciones de actividad en Conceptos básicos de conectores.

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

Para usar la actividad con funciones de scripting, escribe los datos en una ubicación temporal y luego usa esa ubicación temporal en la función de scripting.

Cuando esté listo, implementa y ejecuta la operación y valida el comportamiento verificando los registros de operación.