Cómo crear una integración CSV utilizando fuentes de datos nombradas
Descripción general
Las integraciones CSV son unas de las integraciones más sencillas y útiles. A diferencia de otros tipos de integraciones, esta integración toma una base de datos CSV contenida en un archivo disparador y la divide en variables que pueden pasarse a un archivo de etiquetas. 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 un script de comando de impresión (Video - 9:40) - una integración que configura 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 básica de CSV - una integración CSV que utiliza una anulación de base de datos para enviar datos a una etiqueta.
- Crear una integración de base de datos (Video - 33:42) - una integración que funciona de manera muy similar a este tipo de integración CSV y utiliza fuentes de datos nombradas en la etiqueta.
Aplicable a
BarTender 2022 y versiones posteriores
Información
Configuración de la etiqueta
Este tipo de etiqueta no utiliza una base de datos, sino que usa Fuentes de Datos Nombradas para manejar toda su información. Aquí te mostramos lo básico para configurar esta etiqueta. Para más información, consulta Fuentes de Datos Nombradas en el archivo de ayuda.
- Crea una nueva etiqueta.
- Agrega un objeto de texto en el área de diseño de la etiqueta.
- Haz clic derecho sobre la etiqueta y selecciona propiedades.
- Selecciona la fuente de datos de la lista. Aparecerá como "Texto de ejemplo".
- Haz clic en la casilla junto al campo Nombre.
- En el cuadro de diálogo, escribe un nombre único y haz clic en OK. Para este ejemplo, usa ProductName.
- Asegúrate de que el Tipo esté configurado como Datos Incrustados.
- Al crear más objetos de texto, el cuadro de diálogo de Fuente de Datos Nombrada se verá diferente. Cuando hagas clic en la casilla junto al campo Nombre, selecciona la primera opción para crear un nombre nuevo. Por ejemplo, usa ProductType.
- Una vez que hayas creado todas las Fuentes de Datos Nombradas que necesites, guarda la etiqueta.
Creando la integración
Para tu integración, necesitarás un archivo disparador. Los nombres de los campos del CSV no tienen que coincidir con los nombres de tus Fuentes de Datos Nombradas, ya que aquí en la integración vas a relacionar los campos con las fuentes de datos. Estos nombres de campos del CSV se convertirán automáticamente en variables dentro de tu integración. Asegúrate de que los nombres de los campos no tengan espacios.
Este ejemplo también incluye información de la impresora. Modifica el nombre de la etiqueta y de la impresora antes de probarlo en tu propia integración. Aquí tienes el ejemplo:
Name,Food,ID,btw,printer
Seagull Seed Rings,bird food,1236468,Test.btw,Zebra 105
- 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 disparadores 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.
- Haz clic en el menú desplegable junto a Ubicación y elige "Equipo/Red"
- Escribe el nombre de la carpeta o usa el botón Examinar para ubicarla.
- 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 usas 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 el botón + junto a Acciones.
- En el cuadro de diálogo, haz clic en la categoría Transformar y luego selecciona "Transformar texto en conjunto de registros" y haz clic en OK.
- Haz clic en el botón "Configuración de conexión de base de datos" y sigue los pasos del asistente para conectar un archivo con formato CSV que contenga los campos de base de datos que usarás al imprimir.
- Cambia la "Fuente de texto" a "Variable", luego asegúrate de que la variable esté configurada como "%EventData%".
- Haz clic en el botón "Configuración de conexión de base de datos" y sigue los pasos del asistente para conectar un archivo con formato CSV que contenga los campos de base de datos que usarás al imprimir.
- Haz clic nuevamente en el botón + junto a Acción.
- Haz clic en la categoría Base de datos y luego selecciona "Para cada registro de base de datos" y haz clic en OK.
- Haz clic en la acción Imprimir documento en la lista de Acciones y arrástrala debajo de la acción "Para cada registro de base de datos" hasta que quede indentada. Esto hará que la acción Imprimir documento sea hija de esta acción.
- En la sección Documento, selecciona el documento que creaste en la sección anterior. Más adelante haremos que use un nombre de variable.
- Cambia la Ubicación a "Equipo/Red"
- Escribe el nombre de la carpeta o usa el botón Examinar para ubicarla.
- Haz clic en el botón [Importar configuración de documento...]
- En el cuadro de diálogo, haz clic en OK.
- Haz clic en la pestaña Fuentes de Datos Nombradas y observa la información que se ha importado y rellenado automáticamente.
Los nombres de variables que debes poner en el campo Valor son los nombres de los campos de tu CSV. Las variables se marcan rodeando el nombre con %. Uno de nuestros campos se llama Name, así que la variable equivalente sería %Name%.
- Introduce las variables en las columnas correspondientes. Usando la base de datos de ejemplo, los valores serían los siguientes:
- Si deseas sobrescribir la información de la impresora y la etiqueta, también puedes usar variables aquí.
- Haz clic en la pestaña Opciones de impresión
- En el cuadro de Impresora, escribe %printer%, que coincide con el campo de impresora en el archivo disparador csv
- Haz clic en la pestaña Documento.
- En el campo Documento, elimina el nombre de tu archivo btw pero mantén la ruta intacta. Reemplaza el nombre del documento por %btw%, que coincide con el nombre del campo en el archivo disparador. El campo Documento tendrá una ruta y una variable, como en este ejemplo:
Ten en cuenta que cuando la ruta contiene una variable, la vista previa no se podrá generar. Esto es normal.
- 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 disparador CSV a la carpeta de escaneo. La integración se activará y se imprimirá una etiqueta.
Desplegando 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á guardar 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 y BarTender 2021
Información
Configuración de la etiqueta
Este tipo de etiqueta no utiliza una base de datos, sino que usa Fuentes de Datos Nombradas para manejar toda su información. A continuación se explican los conceptos básicos para configurar esta etiqueta. Para más información, consulta Fuentes de Datos Nombradas en el archivo de ayuda.
- Crea una nueva etiqueta.
- Agrega un objeto de texto en el área de diseño de la etiqueta.
- Haz clic derecho sobre la etiqueta y selecciona propiedades.
- Selecciona la fuente de datos de la lista. Aparecerá como "Texto de ejemplo".
- Haz clic en la casilla junto al campo Nombre.
- En el cuadro de diálogo, escribe un nombre único y haz clic en OK. Para este ejemplo, usa ProductName.
- Asegúrate de que el Tipo esté configurado como Datos Incrustados.
- Al crear más objetos de texto, el cuadro de diálogo de Fuente de Datos Nombrada se verá diferente. Cuando hagas clic en la casilla junto al campo Nombre, selecciona la primera opción para crear un nuevo nombre. Por ejemplo, usa ProductType.
- Una vez que hayas creado todas las Fuentes de Datos Nombradas que desees, guarda la etiqueta.
Creando la integración
Para tu integración, necesitarás un archivo disparador. Los nombres de los campos del CSV no tienen que coincidir con los nombres de tus Fuentes de Datos Nombradas, ya que aquí en la integración vas a vincular los campos con las Fuentes de Datos Nombradas. Estos nombres de campos del CSV se convertirán automáticamente en variables dentro de tu integración. Asegúrate de que los nombres de los campos no tengan espacios.
Este ejemplo también incluye información de la impresora. Modifica el nombre de la etiqueta y el nombre de la impresora antes de probar en tu propia integración. Aquí tienes el ejemplo:
Name,Food,ID,btw,printer
Seagull Seed Rings,bird food,1236468,Test.btw,Zebra 105
- 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 disparadores 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 ubicarla. Evita ubicaciones como Mis Documentos o el Escritorio, ya que requieren permisos adicionales para acceder.
- 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 el botón + junto a Acciones.
- En el cuadro de diálogo, haz clic en la categoría Transformar y luego selecciona "Transformar texto en conjunto de registros" y haz clic en OK.
- Haz clic en el botón "Configuración de conexión de base de datos" y sigue los pasos del asistente para conectarte a un archivo con formato CSV que contenga los campos de base de datos que usarás al imprimir.
- Cambia la "Fuente de texto" a "Variable", luego asegúrate de que la variable esté configurada como "%EventData%".
- Haz clic en el botón "Configuración de conexión de base de datos" y sigue los pasos del asistente para conectarte a un archivo con formato CSV que contenga los campos de base de datos que usarás al imprimir.
- Haz clic nuevamente en el botón + junto a Acción.
- Haz clic en la categoría Base de datos y luego selecciona "Para cada registro de base de datos" y haz clic en OK.
- Haz clic en la acción Imprimir documento en la lista de Acciones y arrástrala debajo de la acción "Para cada registro de base de datos" hasta que quede indentada. Esto hará que la acción Imprimir documento sea hija de esta acción.
- En la sección Documento, selecciona el documento que creaste en la sección anterior. Más adelante haremos que use un nombre de variable.
- Haz clic en el botón [Importar configuración de documento...]
- En el cuadro de diálogo, haz clic en OK.
- Haz clic en la pestaña Fuentes de Datos Nombradas y observa la información que se ha importado y rellenado automáticamente.
Los nombres de las variables que debes poner en el campo Valor son los nombres de los campos de tu CSV. Las variables se marcan rodeando el nombre con %. Uno de nuestros campos se llama Name, así que la variable equivalente sería %Name%.
- Introduce las variables en las columnas correspondientes. Usando la base de datos de ejemplo, los valores serán los siguientes:
- Si deseas sobrescribir la información de la impresora y la etiqueta, también puedes usar variables aquí.
- Haz clic en la pestaña Opciones de impresión
- En el cuadro de Impresora, escribe %printer%, que coincide con el campo de impresora en el archivo disparador csv
- Haz clic en la pestaña Documento.
- En el campo Documento, elimina el nombre de tu archivo btw pero mantén la ruta intacta. Reemplaza el nombre del documento con %btw%, que coincide con el nombre del campo en el archivo disparador. El campo Documento tendrá una ruta y una variable, como en este ejemplo:
Ten en cuenta que cuando la ruta contiene una variable, la vista previa no se podrá generar. Esto es normal.
- 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 disparador CSV a la carpeta de escaneo. La integración se activará y se imprimirá una etiqueta.
Desplegando 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á guardar tu archivo de integración antes de continuar.
- Haz clic en la lista desplegable y selecciona "Esta computadora" 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.