Cargar un archivo CSV en un origen

Nota: debes tener asignado el rol de administrador de proyectos de Extracción y Procesamiento Inteligentes (IXP) como usuario de Automation Cloud, o los permisos de administrador de orígenes y Editar mensajes como usuario heredado para cargar archivos CSV en un origen.

Para cargar datos de un archivo CSV en un origen de datos, aplica los siguientes pasos:

Nota:

• Actualizar cualquier cosa que no sean las propiedades del usuario hará que se pierdan las anotaciones de campo generales en los conjuntos de datos asociados. Por ejemplo, actualizar los mensajes existentes en un origen, cambiar las propiedades del mensaje, como el texto del mensaje, la marca de tiempo enviado_a y hacia o desde. Asegúrate de anclar la última versión del modelo en los conjuntos de datos asociados antes de hacerlo.

• Para obtener más información sobre la creación de un origen de datos, consulta Crear o eliminar un origen de datos en la GUI.

1. Ve a la página Administrador .
2. Selecciona la pestaña Fuentes y localiza la fuente a la que deseas cargar los datos.
3. Selecciona el icono de carga en la tarjeta de origen de datos.
4. Utiliza Seleccionar archivo para elegir un archivo CSV de tu ordenador.
5. Selecciona el archivo CSV que deseas cargar. Asegúrate de que el archivo cumple los siguientes criterios:
   • El archivo debe incluir encabezados en la primera línea y estar delimitado por comas o tabulaciones.
   • El archivo debe contener un mínimo de tres columnas:
     • Mensaje: el texto del mensaje.
     • Marca de tiempo: cuando se creó el mensaje.
     • ID único: un identificador distinto para cada mensaje.
   • Todos los campos de texto deben estar entre comillas dobles en el archivo.
   • El archivo debe estar codificado como UTF-8, UTF-16 o UTF-32. La plataforma detecta automáticamente la codificación correcta.
   • El archivo debe tener 128 MiB o menos. Para archivos más grandes, divídelos en varios archivos, cada uno de menos de 128 MiB.
6. Selecciona las columnas requeridas, donde los menús desplegables contienen los encabezados de columna detectados en el archivo CSV:
   • Columna de ID de mensaje : una columna con un ID único que puede identificar el mensaje. Los ID de mensaje solo pueden contener caracteres alfanuméricos ASCII (AZ, az, 0-9) y signos de puntuación, excepto la barra diagonal /.
     Nota: Si hay mensajes existentes en el origen con el mismo ID, se actualizarán para que coincidan con el contenido del nuevo archivo.

   • Columna de mensaje : la columna que contiene el texto del mensaje que quieres analizar en la plataforma.
   • Columna de marca de tiempo : la columna que contiene la fecha y la hora en que se grabó el mensaje. El formato de la marca de tiempo es flexible y la plataforma lo infiere automáticamente. Para obtener más información, consulta Utilizar los formatos correctos.
7. Puedes seleccionar las siguientes columnas adicionales, si tienes datos que contienen líneas de asunto, hilos o participantes, que suelen encontrarse en casos o hilos de correo electrónico:
   • Columna de asunto : la columna que contiene el asunto del mensaje.
   • Columna del remitente : la columna que contiene el remitente.
   • Columna A : la columna que contiene uno o más destinatarios. Asegúrate de que los destinatarios múltiples estén separados por un punto y coma ;.
   • Columna Cc : la columna que contiene uno o más destinatarios en el campo Cc. Asegúrate de que los destinatarios múltiples estén separados por un punto y coma ;.
     • Para obtener más información sobre el uso de los formatos correctos en los campos Remitente, Para y Cc, consulta Uso de los formatos correctos.
   • Columna de ID de hilo : la columna que contiene el ID de hilo del mensaje. El ID del hilo vincula diferentes mensajes al mismo hilo.
8. Puedes seleccionar las propiedades de usuario adicionales que deseas cargar con los mensajes. Las propiedades de usuario son metadatos contextuales asociados a cada mensaje que puedes filtrar en la plataforma. Los modelos de aprendizaje automático de la plataforma también pueden aprovechar estas propiedades de usuario, que son de los siguientes tipos:
   • Las propiedades de usuario de cadena son metadatos categóricos, por ejemplo, ID, países, contrapartes, etc.
   • Las propiedades de número de usuario son metadatos numéricos, por ejemplo, NPS, estadísticas de correo electrónico, cantidades, etc.
   Nota: Si tu archivo contiene una puntuación NPS como propiedad de usuario, debes incluirla como propiedad numérica, y nombrarla solo NPS para desencadenar la carga de gráficos NPS nativos en la plataforma.

9. Una vez que hayas seleccionado todas las propiedades de usuario, selecciona Cargar.

   Se te pedirá que inspecciones los mensajes cargados en un conjunto de datos que contenga el origen en el que cargaste los datos. Si el origen no está asociado a ningún conjunto de datos, puedes crear un nuevo conjunto de datos para comprobar que la carga es la esperada.

   Nota: Si cometiste un error al seleccionar las propiedades del usuario, puedes cargar el mismo archivo de nuevo. La plataforma utilizará el ID de columna como identificador para sobrescribir los mensajes y propiedades existentes. Esto no afectará a las etiquetas aplicadas a los mensajes existentes.

Utilizar los formatos correctos

El formato Remitente/Para/CC

Asegúrese de que:

• El número de destinatarios no supera el máximo de 2048 por hilo.
• El remitente o cualquier destinatario no supera el límite de 512 caracteres.
• Solo hay un punto y coma en una fila. Por ejemplo, lo siguiente tiene un formato incorrecto: [e-mail] ; [e-mail].

Aunque la plataforma elimina cualquier espacio en blanco antes o después de un destinatario, no realiza ninguna limpieza de datos adicional. Los siguientes son algunos ejemplos de formato que puedes utilizar para tus datos:

• Ejemplo 1: Robert Bog <[e-mail]>; John Smith <[e-mail]>
• Ejemplo 2: [e-mail] ;[e-mail]
• Ejemplo 3: [e-mail] ; [e-mail]

La plataforma delimita los diferentes destinatarios por punto y coma ;.

Antes de cargar tus datos, asegúrate de que los correos electrónicos tengan el formato adecuado.

Nota: En un caso de uso estándar de hilos, como los hilos de correo electrónico, cada celda del remitente debe contener solo un remitente.

El formato de la marca de tiempo

Si el formato de marca de tiempo elegido es ambiguo para el orden de días, meses y años, como 01/02/03 10:10, puedes sugerir la interpretación correcta:

• 2 de enero de 2003: ninguno
• 1 de febrero de 2003: primer día
• 3 de febrero de 2001: primer año
• 2 de marzo de 2001: primero el día + primero el año

Para evitar ambigüedades, se recomienda proporcionar las marcas de tiempo en el formato RFC 3339 . Por ejemplo, 2020-01-31T12:34:56Z para UTC o con una zona horaria: 2020-08-031T11:20:60-08:00.

Solución de problemas

Nota: Si tu carga de CSV falla a mitad de la carga, puedes cargar el mismo CSV de nuevo, después de corregir el error. Si los ID de los mensajes y el texto (asunto y cuerpo) de cualquier mensaje ya cargado permanecen sin cambios, no se le cobrarán AI Units o Platform Units adicionales al reintentar la carga.

Esta sección contiene los posibles mensajes de error que pueden producirse durante el proceso de carga y las soluciones a cada uno de ellos.

En los siguientes mensajes de error, {something} se asigna a información contextual sobre dónde se produjo el error. Además, la forma en que nos referimos a una posición en el archivo está estandarizada como:

Cadena	Se expande a:
{posición}	registro {row-number} en la línea {line-number} columna {column-number} (byte {byte-number})

El título del mensaje de error se muestra junto con una descripción, como se muestra en la siguiente imagen:

Nota: Si encuentras un error diferente a los enumerados en la tabla, vuelve a intentar la carga.

Tipo de error	Mensaje de error	Descripción
No hay suficientes columnas	El archivo CSV solo contiene {number-columns} columnas, pero se necesitan al menos 3, es decir, texto, marca de tiempo e ID.	El CSV cargado no contiene al menos 3 columnas, o la plataforma ha detectado mal la codificación del archivo.
Codificación no válida	El archivo contiene caracteres no válidos, donde la codificación se detecta como {detected-encoding}.	El archivo no está codificado correctamente como UTF-8, UTF-16 o UTF-32. La plataforma detecta automáticamente el formato del archivo.
Encabezado no válido	string:ti:er' no coincide con '(^delimiter|id|message|timestamp |timestamp_default_utc_offset |timestamp_day_first|timestamp_year_first\\Z)|(^(?P<property_type>number|string):(?P<name>\\w(?:[\\w]{0,30}\\w)?)\\Z)'	Si un encabezado de columna es un nombre no válido para una propiedad de usuario, la plataforma devuelve el mensaje predeterminado para cuando el esquema de una solicitud no es válido. Comprueba que cada encabezado de columna tiene un formato válido para su propósito. La longitud máxima de un encabezado de columna es de 32 caracteres alfanuméricos.
Longitudes de fila desiguales	El CSV contiene longitudes de fila desiguales. El mensaje {position} tiene {number} campos, pero el registro anterior tiene {number} campos.	El CSV contiene filas con diferentes números de celdas o que son inconsistentes con el número de encabezados.
Formato de ID	ID de mensaje no válido para {record}. Los ID solo pueden constar de caracteres alfanuméricos ASCII y signos de puntuación, excepto la barra diagonal /. Valor de la celda: {cell-value}.	Se produce cuando un campo de ID consta de caracteres no válidos como se describe en el mensaje de error.
Longitud de ID	El ID es demasiado largo para el mensaje {record}. Tiene {number} bytes, se espera un máximo de 1024.	Se produce cuando un campo de ID es más largo que la longitud máxima permitida, 1024 caracteres.
Formato de marca de tiempo	Marca de tiempo con formato incorrecto en el mensaje {position}: {timestamp-error-message}. Valor de la celda: {cell-value}.	Se produce cuando no se ha podido analizar un campo de marca de tiempo.
Longitud del mensaje	El mensaje es demasiado largo para el mensaje {position}. Tiene {number} bytes, esperados como máximo 65536.	Se produce cuando un campo de mensaje es más largo que la longitud máxima permitida, 65536 caracteres.
Formato de propiedad de número	Número con formato incorrecto en el mensaje {position}: {number-error-message}. Valor de la celda: {cell-value}.	Se produce cuando no se ha podido analizar un campo de propiedad de usuario numérico. La plataforma debe permitir cualquier formato que pueda decodificarse razonablemente como un número.
Longitud de la propiedad	La propiedad es demasiado larga para el mensaje {position}. Tiene {number} bytes, se esperan como máximo 4096.	Se produce cuando un campo de propiedad de usuario es más largo que la longitud máxima permitida, 4096 caracteres.
Error desconocido	Error de CSV desconocido: {underlying-error-message}.	Si se produce un error desconocido, vuelve a intentar la carga.