Actividad de obtención de objetos de Amazon S3

Introducción

Una actividad Obtener objeto de Amazon S3, que utiliza su conexión de Amazon S3, recupera un objeto de un bucket de Amazon S3 y está destinado a ser utilizado como una fuente para proporcionar datos en una operación.

Prerrequisitos

La actividad Obtener objeto requiere los siguientes permisos de Amazon S3:

Se requiere permiso	Funcionalidad
s3:ListAllMyBuckets	Probando el connection y recuperar metadatos de la actividad durante la configuración de la actividad
s3:GetObject y s3:ListBucket	Get Object activity ejecución
s3:GetObjectTagging(opcional)	Get Object activity ejecución cuando Incluir metadatos de etiquetado en la respuesta está habilitado (descrito a continuación)

Crear una actividad Obtener objeto de Amazon S3

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

Para crear una instancia de una actividad, arrastre el tipo de actividad al tela de diseño de tela de diseño o cópielo y péguelo en él. Para obtener más información, consulte Crear una instancia de actividad o herramienta en Reutilización de componentes.

Una actividad Obtener objeto de Amazon S3 existente se puede editar desde estas ubicaciones:

• El tela de diseño (vea menú de acciones del componente en Lienzo de diseño).
• La pestaña Componentes del panel del proyecto (vea menú de acciones de componentes en la pestañaComponentes del panel Proyecto)

Configurar una actividad Obtener objeto de Amazon S3

Siga estos pasos para configurar una actividad Obtener objeto de Amazon S3:

• Paso 1: Ingrese un nombre y seleccione un depósito
  Asigne un nombre a la actividad y seleccione el contenedor que se utilizará.

• Paso 2: Revisar los esquemas de datos
  Se muestran todos los esquemas de solicitud o respuesta generados desde el extremo.

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 Obtener objeto de Amazon S3 depende de las Opciones de depósito seleccionadas:

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

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

Usar listas

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

Consejo

Campos con un icono de variable soporte utilizando variables globales,variables del proyecto y variables de 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 de Obtener objeto 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 GetObjectRequest.

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

  

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

  • Incluir metadatos de etiquetado en la respuesta: (Deshabilitado por defecto). Cuando está habilitado, la actividad Obtener objeto devuelve el conjunto de etiquetas de un objeto en la respuesta. Para usar esta configuración, la instancia de Amazon S3 debe tener s3:GetObjectTagging permiso.

• 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 guardar temporalmente la configuración de este paso y continuar con el siguiente. La configuración no se guardará hasta que haga clic en el botón Finalizado 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 pedirá 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:

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

• Nombre del depósito: Ingrese el nombre del depósito de 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 GetObjectRequest.

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

  

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

  • Incluir metadatos de etiquetado en la respuesta: (Deshabilitado por defecto). Cuando está habilitado, la actividad Obtener objeto devuelve el conjunto de etiquetas de un objeto en la respuesta. Para usar esta configuración, la instancia de Amazon S3 debe tener s3:GetObjectTagging permiso.

• 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 guardar temporalmente la configuración de este paso y continuar con el siguiente. La configuración no se guardará hasta que haga clic en el botón Finalizado 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 pedirá 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.

• Esquemas de datos: Se muestran los esquemas de solicitud y respuesta de esta actividad. Estos esquemas de datos son heredados por 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 el AWS SDK para Java versión 2.29.34. 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 de esquema de solicitud	Campo/método de API de Amazon S3	Descripción
  ObtenerSolicitudDeObjeto	ObtenerSolicitudDeObjeto	Solicitud para recuperar contenido de un bucket
  solicitud	n/a	Nodo que representa la solicitud
  bucketName	bucketName	Cadena con el nombre del depósito que contiene el objeto deseado
  objectId	key	Cadena con la clave en el depósito especificado en el que se almacena el objeto

  Campo/Nodo de esquema de respuesta	Campo/Método de API de Amazon S3	Descripción
  Obtener respuesta de objeto	ObtenerContenidoObjeto	Respuesta al recuperar contenido de un bucket
  Última modificación	obtenerÚltima modificación	Valor de fecha y hora del encabezado Última modificación, que indica la fecha y hora en que Amazon S3 registró por última vez una modificación en el objeto asociado
  Metadatos	getObjectMetadata	Los metadatos almacenados por Amazon S3 para este objeto
  Nombre	n/d	Cadena establecida en la constante ContentType
  Valor	obtenerTipoContenido	Cadena establecida en el encabezado HTTP Content-Type, que indica el tipo MIME estándar del contenido almacenado en el objeto asociado
  Metadatos del sistema	Metadatos del sistema	Metadatos del sistema que se almacenan con el objeto en el depósito
  Metadatos del usuario	Metadatos del usuario	Metadatos que asigna el usuario al cargar un objeto al depósito
  Datos	obtenerContenidoObjeto	Binario Base64 que contiene el contenido de este objeto Consejo Puedes utilizar una combinación de Jitterbit Base64Decode, BinaryToHex, y HexToString funciones para convertir base64binary a texto: $amazonData = Base64Decode(BinaryToHex(HexToString($myData)));

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

• Atrás: Haga clic para guardar 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 cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le pedirá que confirme que desea descartar los cambios.

Próximos pasos

Después de configurar una actividad Obtener objeto de Amazon S3, complete la configuración de la operación agregando y configurando otras actividades o herramientas como pasos de la operación. También puede configurar los ajustes de la operación, lo que incluye la posibilidad de encadenar operaciones que se encuentren 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 más detalles, consulte menú de acciones de la actividad en Conceptos básicos del conector.

Las actividades Obtener objeto de Amazon S3 se pueden usar como fuente con estos patrones de operación:

• Patrón de Transformación
• Patrón de archivo de dos objetivos (solo como primera fuente) - Patrón de archivo HTTP de dos destinos (solo como primera fuente)
• Patrón de dos transformaciones (como primera o segunda fuente)

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 ejecutar la operación y validar el comportamiento comprobando los registros de operación.