En este artículo se explica cómo preparar un fichero “stores” para importarlo con Splio.
Encontrarás un ejemplo de un fichero para este alcance al final del artículo.
Requisitos previos
- Conocimiento básico del formato CSV y la codificación UTF-8
- Un editor de texto UTF-8
- Un software de hoja de cálculo
- Creación de la subsecuencia para la tabla “stores” en el fichero de configuración
Preparación de un fichero de tiendas
Edita el fichero de importación con tu editor de texto de UTF-8 preferido. Si es necesario, utiliza un software de hoja de cálculo con el que te sientas cómodo para controlar el número y la posición de las columnas.
💡| Recuerda guardar siempre utilizando la codificación UTF-8 sin BOM.
Cabecera y columnas
La primera línea del archivo, llamada cabecera, se utiliza para determinar el contenido de las líneas siguientes. Por lo tanto, debería contener únicamente los nombres de los campos (uno por cada columna).
⚠️ | Recuerda que el Datahub no procesará el fichero si encuentra un nombre de columna que no reconoce o si el fichero no contiene la columna obligatoria store_id.
Para el fichero “stores”, están disponibles las siguientes columnas:
Columna |
Obligatorio |
Tipo de dato / Longitud máxima |
Descripción |
store_id |
Sí |
Texto (máx. 50 caracteres) |
Identificador externo de la tienda; esta columna es obligatoria y debe ser única para cada tienda. |
name |
No |
Texto (máx. 120 caracteres) |
Nombre de la tienda. |
online |
No |
0 o 1 |
1 si es una tienda online, 0 si no lo es. |
date_updated |
No |
YYYY-MM-DD HH:MM:SS |
Fecha de la última actualización de la tienda. |
manager |
No |
Texto (máx. 120 caracteres) |
Nombre del director de la tienda |
store_type |
No |
Texto (máx. 120 caracteres) |
Tipo de tienda que se muestra en Splio. |
date_added |
No |
YYYY-MM-DD HH:MM:SS |
Fecha de cuando la tienda se creó. |
c0 |
No |
|
Una o más columnas correspondientes a los campos personalizados de tienda en tu universo. Puedes incluir hasta 32 columnas denominadas o por l’id del campo (de “c0” a “c31”) o per el nombre del campo. |
📗| Ten en cuenta que todos los nombres de campos de sistema se escriben siempre en minúscula.
Ejemplo de fichero
Un fichero pequeño que contenga tres tiendas tendría el siguiente aspecto:
store_id;name;online;manager
MSEST;"Megastore East";"0";"Emma Smith"
EXBBY;"Express Store Brigby";"0";"Bob Brown"
OLDLV;"Online Delivery";"1";NULL
📗 | Todas las filas tienen exactamente cuatro columnas, store_id, name, online (solo la última línea es una tienda online) y manager. No se han utilizado columnas personalizadas.
Nombre del fichero
Guarda tu fichero con un nombre compuesto por el nombre del universo, el alcance (“stores”), la subsecuencia y la fecha actual. Por ejemplo:
myuniverse_stores_apparel_20210315.csv
Este nombre de archivo pertenece al universo “myuniverse”, subsecuencia “apparel” definido para tiendas y su fecha es el 15 de marzo de 2021.
Si deseas más información, consulta la sección «Reglas de nomenclatura de ficheros» en el Datahub - Información general.
Ahora puedes subir el fichero al SFTP/FTPS.
Fechas
Todas las fechas de los ficheros de importación de tienda están compuestas por 4 dígitos para el año, 2 para el mes, y 2 para el día, seguido de las horas, minutos y segundos, 2 dígitos cada uno. Una fecha correcta para el 11 de marzo de 2021, 1:17 p.m. tiene el siguiente formato:
2021-03-11 13:17:00
El día y hora están separados por un espacio en blanco. Puedes omitir la parte de la hora y utilizar solo la fecha. Si lo haces de esta forma, Splio asumirá la hora más temprana posible del día (medianoche). Por lo tanto,
2021-03-07
será tratada exactamente como si introdujeras
2021-03-07 0:00:00
⚠️ | Usar fechas sin hora no es una opción muy recomendada: 00:00:00 es medianoche y Splio intentará procesar la fecha como tal. Esto puede causar errores y algunos triggers relacionados con las fechas fallarán.
📗| Un beneficio adicional de utilizar fechas completas es que podrás buscar y filtrar por fecha con una precisión mucho mayor.
⚠️ | Al importar fechas con hora, asegúrate de que siempre utilizas la misma franja horaria (es decir, GMT+1 para clientes fuera de China, y GMT+8 para clientes chinos).
Explicación: NULL y valores de borrado
NULL es un valor especial que informa a la base de datos de que el campo que lo contiene está vacío.
Tu universo Splio puede configurarse para interpretar los valores NULL como instrucciones para vaciar campos. Puedes utilizarlo para borrar valores almacenados en la base de datos. Para ello, asegúrate de que el valor importado es exactamente NULL. Debes evitar espacios delante o detrás: “ NULL” o “NULL ” se reconocerán como valores string.
Si esta opción no está configurada, Splio retendrá los valores para los campos en los que el valor importado sea NULL.
Diferencia entre NULL y campo vacío
“”es un string vacío. En la mayoría de los casos, tanto NULL como “” serán importados como un valor vacío.
Ten presente que el string vacío “” no es considerado como un valor NULL, por lo que no provocará el borrado del valor existente en un campo.