Cómo crear y actualizar un CSV Adapter
Escrito por Ed Kinne
Última actualización Hace alrededor de 22 horas
En este artículo se repasan los conceptos básicos para crear un archivo CSV de datos. Adapter
Este artículo analiza un adaptador de datos específico. Para obtener información más general, consulte
Los adaptadores de datos CSV utilizan un archivo CSV almacenado en su Media Manager de Korbyt para crear una tabla de datos que luego se puede utilizar para mostrar o controlar información en Korbyt. A continuación, la información se actualiza importando un archivo CSV actualizado a Korbyt de manera que se sobrescriba el archivo antiguo
Paso 1: importar el archivo de datos CSV a Korbyt
En su ordenador, cree el archivo de datos CSV utilizando la aplicación que prefiera
Asegúrate de guardar el archivo en formato CSV
Importe el archivo CSV a su cuenta de Korbyt (Media Manager)
Esto se puede hacer manualmente
Para obtener ayuda sobre los pasos de la importación manual, consulta: Usar el Media Manager
También se puede importar a través de un servicio de mensajería
Para obtener ayuda sobre los servicios de mensajería, consulta: Couriers for Automatic Content Import
Paso 2: Creación de la galería de datos CSV
Una vez que el archivo CSV se encuentre en la biblioteca multimedia de Korbyt, puede crear el «adapter».
Si aún no se encuentra en la sección «Integración», abra el Mega Menú y, a continuación, en la sección «Avanzado», haga clic en «Data Integration».
En la esquina superior derecha, haz clic en «Crear Adapter».
Se le pedirá que asigne un nombre a su Adapter (la descripción es opcional, pero puede resultar útil para otros usuarios si el nombre no es claro)
A continuación, haz clic en el icono de Plantilla situado en el centro y haz clic en Siguiente
En la siguiente pantalla, «Adapter Configuration», verá los paneles izquierdo y derecho
En el lado izquierdo, utiliza el menú desplegable para seleccionar «Adapter CSV» y la vista cambiará
A la izquierda, puedes configurar varias opciones
Permitir editar datos en la vista previa (sí/no)
Sí: permitirá el ajuste manual de la tabla de datos final dentro de la configuración de CSV
Si el adaptador sigue en ejecución, estas modificaciones se sobrescribirán cuando el adaptador se actualice
Horario de funcionamiento
Los días y horas en que se ejecutará el «adapter» para recopilar nuevos datos de la fuente
Scripts de ejecución del cliente
Añadir cualquier script necesario: script previo a la ejecución, script previo a la inserción/actualización, script previo a la eliminación y script posterior a la ejecución
A la derecha, configurará los detalles del propio adapter
Utilice el archivo de la biblioteca multimedia para seleccionar el archivo CSV que se ha cargado en el Media Manager
Establezca el carácter delimitador de datos, el carácter de comillas de cadena y el carácter de escape de cadena para su tabla de datos
Si no utiliza los valores personalizados, déjelos en sus valores predeterminados
El intervalo de actualización establece la frecuencia con la que el script de ejecución posterior revisa el archivo CSV en busca de nueva información
Ahora deberá definir las columnas de la tabla de la base de datos y el tipo de información que contendrá cada columna
Haga clic en Definir la tabla de la base de datos para crear la estructura de su base de datos
Al hacer clic en Guardar, verá que la opción Definir tabla de la base de datos se ha vuelto verde
Los pasos opcionales incluyen la configuración de los permisos de usuario y el reinicio de Adapter; haz clic en esos pasos en la parte superior
Una vez configurado, haz clic en «Guardar y crear»; aparecerá un cuadro de diálogo que te informará del progreso del inicio del «Adapter»
Ahora dispone de un servicio de datos que analiza periódicamente el archivo CSV en busca de información y la introduce en una tabla de datos
Visualización de la tabla de datos
Una vez creado y en ejecución el «Adapter», puede ver la tabla de datos haciendo clic en el icono del ojo
Actualización y modificación de los datos
Cargar un nuevo archivo
Al cargar un nuevo archivo CSV, se actualizará la información del adaptador de datos cuando este se ejecute
. Recuerda que has establecido un intervalo para que el adaptador de datos se actualice, por lo que la nueva información no aparecerá en la tabla hasta que se ejecute el intervalo del adaptador
Si el nuevo archivo CSV no se carga correctamente, no sustituirá al archivo antiguo y los datos no se actualizarán
Para cargar un nuevo archivo CSV
Actualice el archivo CSV en su ordenador
Mantenga el mismo nombre de archivo que el original que se subió
En Korbyt Media Manager, localiza la carpeta que contiene el archivo CSV original
Haga clic en «Importar medios»
ANTES DE SELECCIONAR EL ARCHIVO DE TU ORDENADOR: marca la casilla «Sobrescribir el archivo si ya existe»
Ahora selecciona el nuevo archivo navegando o arrastrando y soltando
Haga clic en «Guardar»
Verás que sigues teniendo solo un archivo CSV con datos en el Media Manager
Si desea forzar la ejecución inmediata del adaptador CSV y actualizar la información, puede ir al adaptador CSV, desactivarlo y, a continuación, volver a activarlo.
Configurar el adaptador CSV para que examine un nuevo archivo
Si el archivo CSV original se ha eliminado de Media Manager, o si simplemente deseas vincular el adaptador a un nuevo archivo, puedes editar el adaptador para que consulte el nuevo archivo.
Para cambiar el archivo CSV que utiliza el adaptador CSV
Localice el adaptador CSV
Haga clic en el botón verde de activación para desactivarlo
Haga clic en el icono del lápiz para editar el adaptador de CSV
Haga clic en «Siguiente» en la pantalla del nombre de «Adapter»
En la configuración de Adapter, haz clic en «Archivo de la biblioteca multimedia»
Seleccione el nuevo archivo de la biblioteca multimedia
Si este ha sido el único cambio, haz clic en «Guardar y crear»
Aparecerá una advertencia indicando que los datos existentes se eliminarán de la tabla
Haga clic en «Sí»; los datos se volverán a rellenar cuando
Haga clic en «Activar» para que adapter se reinicie
Ahora puede hacer clic en el icono del ojo para ver la nueva tabla de datos
Añadir columnas de información adicionales al generador de datos y al archivo CSV
Para añadir columnas adicionales a la tabla de datos, deberá editar el Adapter de datos CSV, concretamente la configuración de la tabla de la base de datos, para añadir la nueva columna.
Para cambiar el archivo CSV que utiliza la tabla de datos
Localice el Adapter CSV
Haga clic en el botón verde de activación para desactivarlo
Haz clic en el icono del lápiz para editar el Adapter
Haga clic en «Siguiente» en la pantalla del nombre de «Adapter»
En la configuración de Adapter, haz clic en Definir tabla de base de datos
Si este fuera el único cambio, haga clic en Guardar y crear
Aparecerá una advertencia indicando que los datos existentes se eliminarán de la tabla
Haga clic en «Sí»; los datos se volverán a rellenar cuando
haga clic en «Activar» para que el «adapter» se reinicie
Ahora puede hacer clic en el icono del ojo para ver la nueva tabla de datos
Archivo CSV: la mejor estructura para archivos CSV
El archivo CSV espera valores separados por comas y no debe utilizar otros marcadores de delimitación
Como práctica recomendada, debe haber un valor único para cada entrada (fila) que se pueda utilizar como valor de clave principal
Esto podría ser un ID de empleado o un correo electrónico, un valor de ID de cola o un número incrementado, de modo que cada fila sea única de alguna manera que el sistema pueda detectar