Transferencia de archivo

Descripción

La actividad Transfer file le permite recibir o enviar archivos, comprobar si hay archivos presentes o archivos de lista en Adobe Campaign.

Contexto de uso

La forma en que se extraerán los datos se define al configurar la actividad. El archivo que se va a cargar puede ser una lista de contactos, por ejemplo.

Puede utilizar esta actividad para recuperar datos que luego se estructuran con la actividad Load file.

Temas relacionados:

• Caso de uso: Actualización de datos en función de una descarga automática de archivos

Configuración

1. Coloque una actividad Transfer file en el flujo de trabajo.

2. Seleccione la actividad y, a continuación, ábrala con el botón , en las acciones rápidas que aparecerán.

3. Utilice la lista desplegable del campo Action para seleccionar una de las siguientes acciones de actividad:

   

   • Descargar archivo: permite descargar un archivo.
   • Cargar archivo: permite cargar un archivo. Al cargar un archivo desde un archivo de Adobe Campaign, se genera una entrada de registro en el menú Export audits. Para obtener más información sobre las auditorías de exportación, consulte la sección Auditoría de exportaciones.
   • Comprobar si existe un archivo: permite comprobar si hay un archivo.
   • Lista de archivos: permite enumerar los archivos presentes en el servidor definido en la pestaña Protocol. Esta acción se utiliza principalmente con fines de depuración, para comprobar si la actividad está configurada según sus necesidades antes de descargar los archivos del servidor remoto.

4. Seleccione el protocolo que desee utilizar:

   • HTTP
   • SFTP
   • Amazon S3
   • almacenamiento de blob de Microsoft Azure
   • Archivos presentes en el servidor de Adobe Campaign

5. La sección Additional options, disponible en función del protocolo seleccionado, le permite añadir parámetros al protocolo. Se puede:

   • Delete the source files after transfer
   • Disable passive mode
   • List all files: esta opción está disponible al seleccionar la acción File listing en la pestaña General. Permite indexar todos los archivos presentes en el servidor en la variable de evento vars.filenames en la que los nombres de archivo están separados por los caracteres 'n'.

6. La sección If no files are found de la pestaña Advanced options permite configurar acciones específicas si se detectan errores o archivos inexistentes al iniciar la actividad.

   También puede definir reintentos. Los diferentes reintentos aparecen en el registro de ejecución del flujo de trabajo.

   

7. Confirme la configuración de la actividad y guarde el flujo de trabajo.

Configuración con HTTP

El protocolo HTTP permite iniciar la descarga de un archivo desde una cuenta externa o desde una dirección URL.

Con este protocolo, puede elegir esta opción: Use connection parameters defined in an external account. En este caso, seleccione la cuenta que desee y especifique la ruta del archivo que desea descargar.

También puede elegir la opción Quick configuration. Solo es necesario introducir la dirección URL en el campo URL.

Configuración con SFTP

El protocolo SFTP permite iniciar la descarga de un archivo desde una dirección URL o una cuenta externa.

Con este protocolo, puede elegir la opción Use connection parameters defined in an external account, luego seleccionar la cuenta que desee y especificar la ruta del archivo que quiera descargar.

También puede elegir la opción Quick configuration. Solo es necesario introducir la dirección URL en el campo URL.

Configuración con Amazon S3

El protocolo Amazon S3 permite iniciar la descarga de un archivo desde una URL o una cuenta externa a través de Amazon Simple Storage Service (S3).

1. Seleccione una cuenta externa de Amazon S3. Para obtener más información, consulte esta página.

2. Elija si desea Define a file path o Use a dynamic file path.

3. Especifique la ruta del archivo que desea descargar.

   

   PRECAUCIÓN

   Los comodines no son compatibles con Amazon S3.

   Para dirigirse a varios archivos como my_file_02 y my _file_3433, puede utilizar la siguiente sintaxis: acs-myawsbucket.s3.amazonaws.com/object-path/my_file_.

4. Si desea eliminar los archivos de origen cuando la transferencia se haya completado, marque Delete the source files after transfer.

Configuración con Microsoft Azure Blob Storage

El protocolo de Microsoft Azure Blob permite acceder al blob ubicado en una cuenta de Microsoft Azure Blob Storage.

1. Seleccione la cuenta externa de Microsoft Azure Blob. Para obtener más información, consulte esta página.

2. Elija si desea Define a file path o Use a dynamic file path.

   

3. Especifique la ruta del archivo que desea descargar. Puede coincidir con varios blobs. En ese caso, la actividad File transfer activa la transición de salida una vez por cada blob detectado. Luego se procesan en orden alfabético.

   PRECAUCIÓN

   Los caracteres comodín no son compatibles con varios nombres de archivo. En su lugar, debe introducir un prefijo. Se admiten todos los nombres de blob que coincidan con ese prefijo.

   Aquí tiene una lista de ejemplos de rutas de archivos:

   • “campaign/”: coincide con todos los blobs de la carpeta Campaign ubicada en la raíz del contenedor.
   • “campaign/new-”: coincide con todos los blobs con un nombre de archivo que empieza por “new-” y se encuentra en la carpeta Campaign.
   • “”: introducir una ruta vacía permite hacer coincidir todas las etiquetas disponibles en el contenedor.

Configuración con archivos presentes en el servidor de Adobe Campaign

El protocolo de File(s) present on the Adobe Campaign server corresponde al repositorio que contiene los archivos que se van a recuperar.
Se pueden usar metacaracteres o caracteres comodín (por ejemplo, * o ?) para filtrar archivos.

Elija si desea Define a file path o Use a dynamic file path
La opción Use a dynamic file path permite utilizar una expresión estándar y variables de eventos para personalizar el nombre del archivo que desea transferir. Para obtener más información, consulte esta página.

Tenga en cuenta que la ruta debe estar relacionada con el directorio de espacio de almacenamiento del servidor de Adobe Campaign. Los archivos se encuentran en el directorio sftp<yourinstancename>/ . Tampoco puede examinar los directorios situados encima del espacio de almacenamiento.

Por ejemplo:

user<yourinstancename>/my_recipients.csv es correcto.

../hello/my_recipients.csv es incorrecto.

//myserver/hello/myrecipients.csv es incorrecto.

Configuración de la histórica

Cada vez que se ejecuta una actividad de Transfer file, almacena los archivos cargados o descargados en una carpeta dedicada. Se crea una carpeta para cada actividad de Transfer file de un flujo de trabajo. Por lo tanto, es importante poder limitar el tamaño de esta carpeta para conservar el espacio físico en el servidor.

Para ello, puede definir la Historization settings en las Advanced options de la actividad Transfer File.

Historization settings permite definir un número máximo de archivos o un tamaño total para la carpeta de la actividad. De forma predeterminada, se autorizan 100 archivos y 50 MB.

Cada vez que se ejecuta la actividad, la carpeta se marca de la siguiente manera:

• Solo se tienen en cuenta los archivos creados más de 24 horas antes de la ejecución de la actividad.
• Si el número de archivos que se tiene en cuenta es mayor que el valor del parámetro Maximum number of files, se eliminan los archivos más antiguos hasta que se alcance el valor de Maximum number of files permitido.
• Si el tamaño total de los archivos que se tienen en cuenta es mayor que el valor del parámetro Maximum size (in MB), se eliminan los archivos más antiguos hasta que se alcance el valor de Maximum size (in MB) permitido.

Variables de salida

La actividad Transfer file genera variables de evento como salida que puede aprovechar en otras actividades, por ejemplo para comprobar el número de archivos descargados mediante una actividad Test.

Tenga en cuenta que las variables de evento también se pueden pasar a otro flujo de trabajo mediante una señal externa (consulte Personalización de un flujo de trabajo con parámetros externos).

Las variables de salida disponibles son:

• fileName: nombre de los archivos transferidos.
• filesCount: número de archivos transferidos.