Carga de archivo load-file

Descripción description

CAUTION
Tenga en cuenta los límites de almacenamiento SFTP, almacenamiento de la base de datos y perfil activo según el contrato de Adobe Campaign al utilizar esta funcionalidad.

La actividad de Load file le permite importar datos en un formulario estructurado para utilizarlos en Adobe Campaign. Los datos se importan temporalmente y se necesita otra actividad para integrarlos definitivamente en la base de datos de Adobe Campaign.

Contexto de uso context-of-use

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.

Se puede:

  • Utilizar la estructura de archivos para aplicarla a los datos de otro archivo (recuperados mediante la actividad de Transfer file) o
  • Utilizar la estructura y los datos del archivo para importarlos a Adobe Campaign.
IMPORTANT
Solo se tienen en cuenta los archivos de estructura “planos”, como los archivos .txt, .csv, etc.

Temas relacionados:

Configuración configuration

La configuración de actividad incluye dos pasos. En primer lugar, debe definir la estructura de archivos esperada cargando un archivo de muestra. Una vez hecho esto, puede especificar el origen del archivo cuyos datos se importarán.

NOTE
Los datos del archivo de muestra se utilizan para configurar la actividad, pero no se importan. Se recomienda utilizar un archivo de muestra que contenga pocos datos.
  1. Arrastre y suelte una actividad de Load 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. Cargue el archivo de muestra que le permitirá definir la estructura esperada al importar el archivo final.

    Una vez cargado el archivo de datos, aparecen dos pestañas nuevas en la actividad: File structure y Column definition.

  4. Vaya a la pestaña File structure para ver la estructura que se detecta automáticamente desde el archivo de muestra.

    Si la estructura de archivos se detecta incorrectamente, tiene varias opciones para corregir los posibles errores:

    • Puede elegir utilizar la estructura de otro archivo seleccionando la opción Detect structure from a new file.

    • Puede modificar los parámetros de detección predeterminados para adaptarlos al archivo. El campo File type le permite especificar si el archivo que desea importar está compuesto por columnas de longitud fija. En ese caso, también debe especificar el número máximo de caracteres para cada columna en la pestaña Column definition.

      Todas las opciones de detección necesarias para recuperar correctamente los datos del archivo se reagrupan en File format. Puede modificarlas y, a continuación, volver a detectar la estructura del último archivo cargado en la actividad teniendo en cuenta estas nuevas configuraciones. Para ello, utilice el botón Apply configuration. Por ejemplo, puede especificar un separador de columnas diferente.

      note note
      NOTE
      Esta operación tiene en cuenta el último archivo que se cargó en la actividad. Si el archivo detectado es grande, la previsualización de datos solo mostrará las primeras 30 líneas.

      En la sección File format, la opción Check columns from file against column definitions le permite verificar que las columnas del archivo que está cargando corresponden a la definición de la columna.

      Si el número o el nombre de las columnas no coinciden con la definición de la columna, aparecerá un mensaje de error al ejecutar el flujo de trabajo. Si la opción no está activada, se mostrarán advertencias en el archivo de registro.

  5. Vaya a la pestaña Column definition para comprobar el formato de los datos de cada columna y ajustar los parámetros si es necesario.

    La pestaña Column definition le permite especificar con precisión la estructura de datos de cada columna para importar datos que no contengan errores (por ejemplo, mediante el uso de la administración nula) y hacer que coincida con los tipos que ya están presentes en la base de datos de Adobe Campaign para futuras operaciones.

    Por ejemplo, puede cambiar la etiqueta de una columna y seleccionar su tipo (cadena, entero, fecha, etc.) o incluso especificar el procesamiento de errores.

    Para obtener más información, consulte la sección Formato de columna.

  6. En la pestaña Execution, especifique si el archivo se va a procesar para cargar datos:

    • Proviene de una transición entrante en el flujo de trabajo.

    • Es el que cargó durante el paso anterior.

    • Es un nuevo archivo que se carga desde el equipo local. La opción Upload a new file from local machine aparece si la carga de un primer archivo ya estaba definida en el flujo de trabajo. Esto le permite cargar otro archivo para procesarlo si el archivo actual no se ajusta a sus necesidades.

  7. Si el archivo desde el que desea cargar los datos está comprimido en un archivo GZIP (.gz), seleccione la opción Decompression en el campo Add a pre-processing stage. Esto le permite descomprimir el archivo antes de cargar los datos. Esta opción solo está disponible si el archivo procede de la transición entrante de la actividad.

    El campo Add a pre-processing stage también le permite descifrar un archivo antes de importarlo a la base de datos. Para obtener más información sobre cómo trabajar con archivos cifrados, consulte esta sección

  8. La opción Keep the rejects in a file le permite descargar un archivo que contenga errores producidos durante la importación y aplicarle una fase de procesamiento posterior. Cuando se activa la opción, se cambia el nombre de la transición saliente a “Rechazos”.

    note note
    NOTE
    La opción Add date and time to the file name le permite agregar una marca de tiempo al nombre del archivo que contiene los rechazos.

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

Si se produce algún error con la actividad después de ejecutar el flujo de trabajo, consulte los registros para obtener más detalles sobre los valores incorrectos en el archivo. Para obtener más información sobre los registros del flujos de trabajo, consulte esta sección.

Formato de columna column-format

Al cargar un archivo de muestra, el formato de columna se detecta automáticamente con los parámetros predeterminados para cada tipo de datos. Puede modificar estos parámetros predeterminados para especificar los procesos concretos que se aplican a los datos, especialmente cuando hay un error o un valor vacío.

Para ello, seleccione Edit properties entre las acciones rápidas de la columna cuyo formato desee definir. Se abrirá la ventana de detalles de formato de columna.

A continuación, podrá modificar el formato de cada columna.

El formato de columna permite definir el valor de procesamiento de cada columna:

  • Ignore column: no se procesa esta columna durante la carga de datos.

  • Data type: especifica el tipo de datos esperados para cada columna.

  • Format and separators, Propiedades: especifique las propiedades de un texto, el formato de hora, fecha y valor numérico, así como el separador especificado por el contexto de columna.

    • Maximum number of characters: especifica el número máximo de caracteres para las columnas de tipo de cadena.

      Este campo debe rellenarse al cargar archivos formados por columnas de longitud fija.

    • Letter case management: define si es necesario aplicar un proceso de mayúsculas y minúsculas de caracteres a los datos de texto.

    • White space management: especifica si determinados espacios deben ignorarse en una cadena para datos de texto.

    • Time format, Date format: especifica el formato para los datos de fecha, hora y fecha y hora.

    • Format: le permite definir el formato de los valores numéricos para los datos de números enteros y números flotantes.

    • Separator: define el separador especificado por el contexto de columna (separador de miles o decimales para valores numéricos, separador de fechas y hora) para datos de fecha, hora, fecha y hora, números enteros y números flotantes.

  • Remapping of values: este campo solo está disponible en la configuración de detalles de la columna. Permite transformar determinados valores al importarlos. Por ejemplo, se puede transformar “tres” en “3”.

  • Error processing: define el comportamiento si se produce un error.

    • Ignore the value: se ignora el valor. Se genera una advertencia en el registro de ejecución del flujo de trabajo.
    • Reject the line: no se procesa la línea completa.
    • Use a default value: reemplaza el valor que provoca el error con un valor predeterminado definido en el campo Default value.
    • Use a default value in case the value is not remapped: reemplaza el valor que causa el error por un valor predeterminado, definido en el campo Default value, a menos que se haya definido una asignación para el valor erróneo (consulte la opción Remapping of values anterior).
    • Reject the line when there is no remapping value: la línea completa no se procesa a menos que se haya definido una asignación para el valor erróneo (consulte la opción Remapping of values anterior).
    note note
    NOTE
    Error processing se refiere a errores relacionados con los valores del archivo importado. Por ejemplo, se encontró un tipo de datos erróneo (“cuatro” en letras para una columna “entero”), una cadena que contiene más caracteres que el número máximo autorizado, una fecha con separadores erróneos, etc. Sin embargo, esta opción no afecta a los errores generados por la administración de valores vacía.
  • Default value: especifica el valor predeterminado de acuerdo con el procesamiento de error seleccionado.

  • Empty value management: especifica cómo administrar valores vacíos durante la carga de datos.

    • Generate an error for numerical fields: genera un error solo para los campos numéricos; en caso contrario, inserta un valor NULL.
    • Insert NULL in the corresponding field: autoriza los valores vacíos. Por lo tanto, se inserta el valor NULL.
    • Generate an error: genera un error si un valor está vacío.
recommendation-more-help
3ef63344-7f3d-48f9-85ed-02bf569c4fff