Saltar al contenido

AWS S3 Get

Introducción

El complemento AWS S3 Get lee, cambia el nombre o elimina un archivo de Amazon AWS S3. Un archivo que se lee se puede utilizar como fuente en una operación.

Este complemento está disponible de forma predeterminada en Grupos de Agentes en Nube y también se puede asociar con Grupos de Agentes Privados.

Esta página detalla los pasos para utilizar el complemento AWS S3 Get:

  1. Descargue y agregue el complemento
  2. Asociar el complemento con un Grupo de Agentes
  3. Asignar el complemento a una fuente
  4. Establecer variables globales para el complemento
  5. Configuración completa de la operación

Importante

Los complementos proporcionados por Jitterbit están en desuso. Consulte Desuso y soporte en Complementos.

Cifrado

El complemento AWS S3 Get pasa el ID de la clave de acceso de AWS S3 y la clave de acceso secreta proporcionadas (que se describen a continuación en Establecer variables globales para el complemento) a Amazon. Amazon maneja la seguridad como se describe en la documentación de Amazon sobre Credenciales de seguridad de AWS.

Uso

El complemento AWS S3 Get se puede utilizar siempre que necesite recuperar, cambiar el nombre o eliminar archivos de AWS.

Funcionalidad Adicional

Además, estas opciones ofrecen funcionalidad adicional más allá del complemento AWS S3 Get:

Descargue y Agregue el Complemento

El complemento AWS S3 Get es un complemento Jitterbit estándar que ya está disponible en Management Console Complementos y no es necesario descargarlo ni agregarlo a la organización.

Si lo indica el soporte de Jitterbit, este complemento se puede descargar en el enlace que se proporciona a continuación y agregarlo a la organización (consulte Agregar nuevos complementos en Personalizaciones > Complementos).

Asociar el Complemento con un Grupo de Agentes

El complemento AWS S3 Get está asociado con los Grupos de Agentes en Nube de forma predeterminada.

Si utiliza un Grupo de Agentes Privados, antes de poder utilizar el complemento, debe asociarlo con el Grupo de Agentes Privados para que el complemento esté disponible para todos los agentes del grupo (consulte Asociar grupos de Agente en Personalizaciones > Complementos).

El complemento aparece en la Management Console Complementos página con un nombre para mostrar de Jitterbit AWS S3 Get.

Asignar el Complemento a una Fuente

En un proyecto de Design Studio, debes asignar el complemento a una fuente dentro de una operación. Una configuración de operación de ejemplo se proporciona al final de esta página.

Dentro del proyecto:

  1. Crear una operación. Se puede utilizar cualquier operación que utilice una fuente.
  2. Cree una fuente ficticia a la que se asignará el complemento. Esta fuente se utiliza como marcador de posición y en realidad no se leerá. Recomendamos utilizar una fuente de variable global. Si se utilizan otras fuentes de tipo de archivo, como almacenamiento temporal, archivo local, o FTP, durante la configuración de la fuente, se recomienda proporcionar un valor Obtener archivos de [file].[ext].
  3. Asigne el complemento a la fuente. Para hacer esto, haga clic derecho en la fuente y seleccione Complemento. En la ventana emergente, en Complementos disponibles, seleccione "Jitterbit AWS S3 Get" y haga clic en Asignar. Luego haga clic en Aceptar.

Consejo

La documentación detallada sobre la asignación de complementos está disponible en Aplicación de complementos de Pipeline.

Establecer Variables Globales para el Complemento

Para que un complemento asignado a una fuente sea funcional, cualquier variable global requerido por el complemento debe estar configurado. Estas variables se configuran en un secuencia de comandos, que debe colocarse antes de la fuente en la operación para que se puedan inicializar las variables.

Para agregar un secuencia de comandos antes de la fuente:

  1. Haga clic derecho en la fuente en la operación y seleccione Insertar antes de esto > Secuencia de Comandos.

  2. Cree un nuevo Jitterbit Script que establece las variables utilizadas por el complemento para autenticarse con su depósito S3 y leer el archivo que especifique. A continuación se proporciona una modelo de secuencia de comandos para las variables requeridas, seguida de documentación sobre todas las variables posibles que pueden incluirse en el secuencia de comandos.

    AWS S3 Get Script
    <trans>
$AWS.S3.BUCKET_NAME="<YOUR_BUCKET_NAME>";
$AWS.S3.ACCESS_KEY_ID="<YOUR_ACCESS_KEY>";
$AWS.S3.SECRET_ACCESS_KEY="<YOUR_SECRET_KEY>";
$AWS.S3.OBJECT_KEY="<myfile.txt>";
</trans>
Nombre Tipo Requerido. Descripción
AWS.S3.ENDPOINT Cadena Opcional La URL del extremo de Amazon AWS S3. El valor predeterminado es "s3.amazonaws.com" si no está configurado. Los nombres de extremo válidos por región se proporcionan en la documentación de Amazon regiones y Extremos de AWS.
AWS.S3.BUCKET_NAME Cadena Obligatorio El nombre del depósito de origen de S3. Para leer desde una carpeta dentro del depósito, agregue el nombre de la carpeta después de una barra diagonal (p. ej. "my_bucket/folder").
AWS.S3.ACCESS_KEY_ID Cadena Obligatorio La clave de acceso S3 (p. ej. "ABCDEFGHI1JK2LM3NOPQ").
AWS.S3.SECRET_ACCESS_KEY Cadena Obligatorio La clave de acceso secreta de S3 (p. ej. "1aBCd2e/F34gH56IJ7Kl/Mno8pqRsTUvw9x0yzzz").
AWS.S3.REGION Cadena Opcional La región S3. El valor predeterminado es "DEFAULT_REGION" si no está configurado (no recomendado). Los nombres de las regiones actuales se proporcionan en la documentación de Amazon regiones y Extremos de AWS.
AWS.S3.OBJECT_KEY Cadena Obligatorio La clave del objeto S3 que se va a leer. Este es el nombre del archivo específico que desea que se le devuelva, como por ejemplo "myfile.txt". La clave del objeto distingue entre mayúsculas y minúsculas. No se admite la especificación de varios archivos ni el uso de comodines.
AWS.S3.DELETE booleano Opcional Si se establece en "true", elimina el objeto del depósito de S3 después de leerlo. El valor predeterminado es "false". No utilizar con el AWS.S3.NEWNAME variable.

Advertencia

Esta variable elimina el objeto especificado en el propio depósito de S3.
AWS.S3.NEWNAME Cadena Opcional El nombre utilizado para cambiar el nombre del objeto en el depósito de S3 después de leerlo. El uso de esta variable cambiará la clave del objeto S3. No utilizar con el AWS.S3.DELETE variable.

Advertencia

Esta variable elimina el objeto especificado en el propio depósito de S3.

Advertencia

Aunque se incluye en el manifiesto del complemento, la variable AWS.S3.OBJECT_KEY_PREFIX no es funcional. En este momento, no es posible leer varios archivos a la vez; sólo se puede leer un archivo a la vez.

Precaución

Algunas de las variables anteriores no deben usarse en combinación con otras. Si se usan juntos, esto causará errores en su operación.

Configuración Completa de la Operación

La parte del complemento de la configuración de la operación se completa después de que tenga (1) el secuencia de comandos que define las variables que se usarán con el complemento y (2) el complemento asignado a una fuente en la operación.

Para completar la configuración de su operación, defina un objetivo para archivar sus datos de S3, o agregue un destino y una transformación si desea transformar sus datos antes de alcanzar el objetivo.

operación de configuración

Precaución

Si utiliza un almacenamiento temporal, archivo local, o Sitio FTP destino, para que el nombre de archivo S3 y la extensión se escriban en el destino, se recomienda ingresar [AWS.S3.OBJECT_KEY] en el campo Nombre(s) de archivo para usar el mismo nombre de archivo en el destino que el que lee el complemento. Usando un valor de [file].[ext] devolverá el ID S3 del archivo en lugar del nombre del archivo S3.