Cómo crear una integración básica de CSV utilizando sobrescritura de base de datos
Descripción general
Las integraciones CSV son unas de las integraciones más sencillas y útiles. Solo requieren una pequeña configuración para comenzar. Este tipo de integración utiliza la información de un archivo desencadenador para sobrescribir la base de datos asociada a una etiqueta. Asegúrate de usar el menú desplegable de versión en la parte superior, ya que la interfaz puede variar entre versiones de BarTender.
Si buscas integraciones similares, consulta estos otros tutoriales útiles:
- Imprimir documento usando Print Command Script (Video - 9:40) - una integración que establece la impresora y la información de la etiqueta en el encabezado del script y contiene una base de datos CSV
- Cómo crear una integración CSV usando fuentes de datos nombradas - una integración CSV que divide un archivo CSV y lo distribuye en fuentes de datos nombradas en la etiqueta. También se puede usar para establecer la impresora y la información de la etiqueta.
Aplicable a
BarTender 2022 y posteriores
Información
Configuración de la etiqueta
Primero, comienza configurando el archivo de la etiqueta y conectándolo a una base de datos. Puedes usar tu propio archivo CSV o guardar esta base de datos de ejemplo en un archivo de texto o CSV:
Name,Food,ID
Seagull Kitty Snax,cat treats,12334668
BarTender Dog Bones,dog food,25346489
- Crea una nueva etiqueta y conéctala a la base de datos de texto. Si no conoces el proceso, revisa Primeros pasos con conexiones a bases de datos (Video - 5:20).
- En la caja de herramientas (ubicación predeterminada a la izquierda de la interfaz), haz clic en la pestaña Fuentes de datos.
- Haz clic y arrastra un campo de la base de datos desde esta caja de herramientas y suéltalo en el área de diseño de la etiqueta. Repite esto para cada campo de la base de datos que quieras agregar a la etiqueta.
- Guarda la etiqueta.
Creación de la integración
Para tu integración, necesitarás un archivo desencadenador. El archivo debe coincidir con el formato de base de datos que usaste con la etiqueta. Así, un desencadenador CSV debe coincidir con una base de datos CSV y una base de datos delimitada por tabulaciones debe tener un desencadenador delimitado por tabulaciones. Si usaste el ejemplo anterior, aquí tienes un archivo desencadenador de muestra para usar:
Name,Food,ID
Seagull Seed Rings,bird food,1236468
- Abre Integration Builder y selecciona "Crear nueva integración".
- En el cuadro de diálogo de nueva integración, selecciona Integración de archivos y haz clic en OK.
- Primero, configura cómo la integración detectará los archivos estableciendo la carpeta de escaneo. Aquí es donde se colocarán tus archivos desencadenadores y la integración los recogerá. En mi ejemplo, usé una carpeta en la unidad C. Evita ubicaciones como Mis documentos o el Escritorio, ya que requieren permisos adicionales para acceder a esas ubicaciones.
- Haz clic en el menú desplegable Ubicación y selecciona "Equipo/Red"
- Usa el botón Examinar para localizar tu carpeta o escribe el nombre de la carpeta.
- Cambia el patrón de archivo para que coincida con tu archivo. Yo estoy usando el valor predeterminado .dat, pero puedes usar .txt, .csv o cualquier tipo que prefieras.
- Desplázate hasta la parte inferior de esta sección. Si estás usando un patrón de archivo *.txt, cambia las opciones de "Después de la detección" a una extensión de archivo diferente para que la integración no recoja el mismo archivo una y otra vez.
- En el menú de la izquierda, haz clic en la acción Imprimir documento.
- En la sección Documento, selecciona el documento que se imprimirá cuando se active la integración.
- Haz clic en la pestaña Opciones de impresión. En la sección Reemplazos de base de datos, haz clic en el botón "Agregar reemplazo de base de datos". Cambia la fuente de datos a Variable. Selecciona EventData en la lista desplegable de Variable.
-
La opción (La base de datos predeterminada) se selecciona por defecto cuando no has importado la configuración del documento. Especifica que se sobrescribirá la primera conexión de base de datos a nivel de documento en el documento. No se refiere a objetos de tabla ni a conexiones de base de datos de controles de entrada de datos. Si en cambio deseas sobrescribir una conexión de base de datos de un objeto de tabla o de un control de entrada de datos, o conoces el nombre de la conexión, puedes seleccionar un nombre existente en la lista Base de datos a sobrescribir o hacer clic en
Agregar y escribir el nombre en el campo de texto Base de datos a sobrescribir para agregar una nueva conexión. - Guarda tu integración.
- Haz clic en el botón Probar integración en la barra de herramientas superior.
- Haz clic en el botón verde Iniciar en la esquina superior derecha.
- En el Explorador de archivos, arrastra el archivo desencadenador CSV a la carpeta de escaneo. La integración se activará y se imprimirá una etiqueta.
Desplegar la integración
Después de probar la integración, querrás desplegarla en producción.
- Haz clic en la pestaña Desplegar y luego en el botón Desplegar en la barra de herramientas superior. Si hay cambios, se te pedirá que guardes tu archivo de integración antes de continuar.
- Haz clic en la lista desplegable y selecciona "Este equipo" para desplegar localmente. Haz clic en Siguiente.
- Deja seleccionada la opción Desplegar ahora y haz clic en Finalizar.
- Después de un momento, se abrirá la Consola de administración y la integración aparecerá como desplegada y en ejecución.
Aplicable a
BarTender 2021
Información
Configuración de la etiqueta
Primero, comienza configurando el archivo de la etiqueta y conectándolo a una base de datos. Puedes usar tu propio archivo CSV o guardar esta base de datos de ejemplo en un archivo de texto o CSV:
Name,Food,ID
Seagull Kitty Snax,cat treats,12334668
BarTender Dog Bones,dog food,25346489
- Crea una nueva etiqueta y conéctala a la base de datos de texto. Si no conoces el proceso, revisa Primeros pasos con conexiones a bases de datos (Video - 5:20).
- En la caja de herramientas (ubicación predeterminada a la izquierda de la interfaz), haz clic en la pestaña Fuentes de datos.
- Haz clic y arrastra un campo de la base de datos desde esta caja de herramientas y suéltalo en el área de diseño de la etiqueta. Repite esto para cada campo de la base de datos que quieras agregar a la etiqueta.
- Guarda la etiqueta.
Creación de la integración
Para tu integración, necesitarás un archivo desencadenador. El archivo debe coincidir con el formato de base de datos que usaste con la etiqueta. Así, un desencadenador CSV debe coincidir con una base de datos CSV y una base de datos delimitada por tabulaciones debe tener un desencadenador delimitado por tabulaciones. Si usaste el ejemplo anterior, aquí tienes un archivo desencadenador de muestra para usar:
Name,Food,ID
Seagull Seed Rings,bird food,1236468
- Abre Integration Builder y selecciona "Crear nueva integración".
- En el cuadro de diálogo de nueva integración, selecciona Integración de archivos y haz clic en OK.
- Primero, configura cómo la integración detectará los archivos estableciendo la carpeta de escaneo. Aquí es donde se colocarán tus archivos desencadenadores y la integración los recogerá. En mi ejemplo, usé una carpeta en la unidad C. Escribe el nombre de la carpeta o usa el botón Examinar para localizarla. Evita ubicaciones como Mis documentos o el Escritorio, ya que requieren permisos adicionales para acceder a esas ubicaciones.
- Cambia el patrón de archivo para que coincida con tu archivo. Yo estoy usando el valor predeterminado .dat, pero puedes usar .txt, .csv o cualquier tipo que prefieras.
- Desplázate hasta la parte inferior de esta sección. Si estás usando un patrón de archivo *.txt, cambia las opciones de "Después de la detección" a una extensión de archivo diferente para que la integración no recoja el mismo archivo una y otra vez.
- En el menú de la izquierda, haz clic en la acción Imprimir documento.
- En la sección Documento, selecciona el documento que se imprimirá cuando se active la integración
- Haz clic en la pestaña Opciones de impresión. En la sección Reemplazos de base de datos, haz clic en el botón "Agregar reemplazo de base de datos". Cambia la fuente de datos a Variable. Selecciona EventData en la lista desplegable de Variable.
-
La opción (La base de datos predeterminada) se selecciona por defecto cuando no has importado la configuración del documento. Especifica que se sobrescribirá la primera conexión de base de datos a nivel de documento en el documento. No se refiere a objetos de tabla ni a conexiones de base de datos de controles de entrada de datos. Si en cambio deseas sobrescribir una conexión de base de datos de un objeto de tabla o de un control de entrada de datos, o conoces el nombre de la conexión, puedes seleccionar un nombre existente en la lista Base de datos a sobrescribir o hacer clic en
Agregar y escribir el nombre en el campo de texto Base de datos a sobrescribir para agregar una nueva conexión. - Guarda tu integración.
- Haz clic en el botón Probar integración en la barra de herramientas superior.
- Haz clic en el botón verde Iniciar en la esquina superior derecha.
- En el Explorador de archivos, arrastra el archivo desencadenador CSV a la carpeta de escaneo. La integración se activará y se imprimirá una etiqueta.
Desplegar la integración
Después de probar la integración, querrás desplegarla en producción.
- Haz clic en la pestaña Desplegar y luego en el botón Desplegar en la barra de herramientas superior. Si hay cambios, se te pedirá que guardes tu archivo de integración antes de continuar.
- Haz clic en la lista desplegable y selecciona "Este equipo" para desplegar localmente. Haz clic en Siguiente.
- Deja seleccionada la opción Desplegar ahora y haz clic en Finalizar.
- Después de un momento, se abrirá la Consola de administración y la integración aparecerá como desplegada y en ejecución.
Aplicable a
BarTender 2019
Información
Configuración de la etiqueta
Primero, comienza configurando el archivo de la etiqueta y conectándolo a una base de datos. Puedes usar tu propio archivo CSV o guardar esta base de datos de ejemplo en un archivo de texto o CSV:
Name,Food,ID
Seagull Kitty Snax,cat treats,12334668
BarTender Dog Bones,dog food,25346489
- Crea una nueva etiqueta y conéctala a la base de datos de texto. Si no conoces el proceso, revisa Primeros pasos con conexiones a bases de datos (Video - 5:20).
- En la caja de herramientas (ubicación predeterminada a la izquierda de la interfaz), haz clic en la pestaña Fuentes de datos.
- Haz clic y arrastra un campo de la base de datos desde esta caja de herramientas y suéltalo en el área de diseño de la etiqueta. Repite esto para cada campo de la base de datos que quieras agregar a la etiqueta.
- Guarda la etiqueta.
Creación de la integración
Para tu integración, necesitarás un archivo desencadenador. El archivo debe coincidir con el formato de base de datos que usaste con la etiqueta. Así, un desencadenador CSV debe coincidir con una base de datos CSV y una base de datos delimitada por tabulaciones debe tener un desencadenador delimitado por tabulaciones. Si usaste el ejemplo anterior, aquí tienes un archivo desencadenador de muestra para usar:
Name,Food,ID
Seagull Seed Rings,bird food,1236468
- Abre Integration Builder y selecciona "Crear nueva integración".
- En el cuadro de diálogo de nueva integración, selecciona Integración de archivos y haz clic en OK.
- Primero, configura cómo la integración detectará los archivos estableciendo la carpeta de escaneo. Aquí es donde se colocarán tus archivos desencadenadores y la integración los recogerá. En mi ejemplo, usé una carpeta en la unidad C. Escribe el nombre de la carpeta o usa el botón Examinar para localizarla. Evita ubicaciones como Mis documentos o el Escritorio, ya que requieren permisos adicionales para acceder a esas ubicaciones.
- Cambia el patrón de archivo para que coincida con tu archivo. Yo estoy usando el valor predeterminado .dat, pero puedes usar .txt, .csv o cualquier tipo que prefieras.
- Desplázate hasta la parte inferior de esta sección. Si estás usando un patrón de archivo *.txt, cambia las opciones de "Después de la detección" a una extensión de archivo diferente para que la integración no recoja el mismo archivo una y otra vez.
- En el menú de la izquierda, haz clic en la acción Imprimir documento.
- En la sección Documento, selecciona el documento que se imprimirá cuando se active la integración
- Haz clic en la pestaña Opciones de impresión. En la sección Reemplazos de base de datos, haz clic en la casilla de verificación y mantén la opción predeterminada de "Datos de entrada de la integración"
- Guarda tu integración.
- Haz clic en el botón Probar integración en la barra de herramientas superior.
- Haz clic en el botón verde Iniciar en la esquina superior derecha.
- En el Explorador de archivos, arrastra el archivo desencadenador CSV a la carpeta de escaneo. La integración se activará y se imprimirá una etiqueta.
Desplegar la integración
Después de probar la integración, querrás desplegarla en producción.
- Haz clic en la pestaña Desplegar y luego en el botón Desplegar en la barra de herramientas superior. Si hay cambios, se te pedirá que guardes tu archivo de integración antes de continuar.
- Haz clic en la lista desplegable y selecciona "Este equipo" para desplegar localmente. Haz clic en Siguiente.
- Deja seleccionada la opción Desplegar ahora y haz clic en Finalizar.
- Después de un momento, se abrirá la Consola de administración y la integración aparecerá como desplegada y en ejecución.
Recursos adicionales