Descripción general

BarTender 2019 introduce nuevos tipos de bases de datos de texto, incluyendo bases de datos XML. Como Designer puede leer estos tipos de bases de datos de forma nativa, ahora también puedes usarlas como archivos de activación sin necesidad de una transformación XLST.

Este tutorial te guiará a través de lo siguiente:

• Usar un archivo XML como base de datos
• Configurar una integración de archivo XML
• Probar y desplegar tu integración

Se proporciona un ejemplo de datos que se utiliza en el tutorial. Una vez que te familiarices con el proceso, siéntete libre de seguir los mismos pasos con tus propios datos y etiquetas para crear una integración XML que se adapte a tus necesidades.

Aplicable a

BarTender 2019 y versiones posteriores

Información

Creando una base de datos XML

A continuación se muestra un ejemplo de base de datos XML para una empresa ficticia de alimentos para mascotas, Seagull Pet Snacks. La base de datos contiene una sección de encabezado simple <HEADER> con un cuerpo de datos dentro de <DETAILS>.

<?xml version="1.0"?>
<LABEL>
  <HEADER>
    <BRAND>Seagull Pet Snacks</BRAND>
    <PACKAGE>Bag</PACKAGE>
    <LOCATION>Seattle</LOCATION>
    <DETAILS>
        <NAME>Kitty Kibble</NAME>
        <TAGLINE>Delicious snacks for kitty</TAGLINE>
        <FLAVOR>Salmon</FLAVOR>
    </DETAILS>
  </HEADER>
</LABEL>

Para crear una base de datos XML

1. Abre un editor de texto como el Bloc de notas.
2. Pega el texto anterior en tu editor.
3. Ve a Archivo > Guardar como y cambia el tipo de guardado a Todos los archivos.
4. Asigna un nombre como Database.xml, por ejemplo, y haz clic en Guardar.

Creando el archivo de etiqueta

1. Abre BarTender Designer y crea un nuevo documento.
2. Cuando termines el asistente de nuevo documento, ve a Archivo > Configuración de conexión a base de datos.
3. Selecciona Crear una nueva conexión de base de datos y haz clic en Siguiente.
4. Selecciona Archivo XML de la lista y haz clic en Siguiente.
5. Usa el botón Examinar para localizar el archivo database.xml. Selecciónalo y haz clic en Siguiente.
6. Para este tutorial, selecciona la primera opción para Detectar automáticamente el esquema desde el archivo XML y haz clic en Siguiente.
7. En la siguiente pantalla podrás indicarle a BarTender dónde se almacenan realmente los datos en tu archivo XML.
   En nuestra base de datos del ejemplo anterior, tenemos un encabezado llamado <HEADER> y una sección que detalla cada registro o etiqueta marcada como <DETAILS>. Como solo queremos usar la información de la sección DETAILS como nuestra base de datos, selecciónala de la lista en el panel superior como se muestra en la captura de pantalla a continuación:
   
   Observa cómo la vista previa del archivo cambia dependiendo de la etiqueta que selecciones. El panel inferior te mostrará cómo se ven tus datos en formato de tabla. Si la vista previa aparece como etiquetas, haz clic en la pestaña Campos en el lado derecho para cambiar a formato de tabla.
8. Con la etiqueta DETAILS seleccionada en el panel superior, haz clic en Siguiente.
9. En la siguiente pantalla podrás desmarcar campos si deseas ignorarlos. Para este ejemplo, dejaremos los 3 campos seleccionados. Haz clic en Finalizar en el asistente y luego en OK en el cuadro de diálogo.
10. Ahora que la base de datos está conectada, haz clic en la pestaña Fuentes de datos en tu caja de herramientas si aún no está seleccionada.
11. Haz clic y arrastra los tres campos a tu etiqueta.
    Consejo: si el campo TAGLINE es demasiado ancho para tu etiqueta, puedes activar el ajuste de texto en las propiedades de texto, en la sección de ajuste.
12. Guarda tu etiqueta. ¡Ya está lista para usarse!

Creando la integración

1. Abre Integration Builder.
2. En la pantalla de inicio, selecciona Crear nueva integración.
3. Selecciona Archivo en el cuadro de diálogo y haz clic en OK.
4. En Detección de archivos, elige la ubicación de la carpeta de escaneo. Aquí es donde la integración recogerá los archivos.
   
   Nota: Se recomienda elegir una carpeta en una ubicación común, como la unidad C. Las carpetas en Mis documentos o el escritorio pueden requerir permisos especiales para acceder a ellas.
5. Cambia el patrón de archivo a *.xml, ya que vamos a buscar archivos xml.
6. Haz clic en la acción Imprimir documento.
7. En la pestaña Documento, usa el botón Examinar para navegar hasta el documento que creaste en la sección anterior. Al igual que con la carpeta de escaneo, se recomienda que este documento esté ubicado en una carpeta centralizada y no en Mis documentos.
8. Configura la opción Sobrescribir base de datos.
   
   BarTender 2019: En la pestaña Opciones de impresión, bajo Sobrescrituras de base de datos, marca la casilla junto a Usar fuente de datos y deja la opción desplegable como Datos de entrada de integración.
   
   
   BarTender 2021: En la pestaña Opciones de impresión, bajo Sobrescrituras de base de datos, haz clic en el botón azul de más para agregar una opción de sobrescritura de base de datos. Establece la Fuente de datos en Variable y el campo Variable en "%EventData%".
   
   
   
9. Guarda tu archivo.

Probar y desplegar la integración

Antes de desplegar la integración, primero vamos a probarla y crear algunos archivos de activación de ejemplo. Los archivos de activación deben tener la misma estructura que la base de datos vinculada al archivo de etiqueta. Aquí tienes algunos datos de ejemplo para probar. Estos datos son diferentes a los de la base de datos de la etiqueta, pero la estructura es la misma:

<?xml version="1.0"?>
<LABEL>
  <HEADER>
    <BRAND>Seagull Pet Snacks</BRAND>
    <PACKAGE>Box</PACKAGE>
    <LOCATION>Seattle</LOCATION>
    <DETAILS>
        <NAME>Dog Crunchies</NAME>
        <TAGLINE>Crunchy snacks for your best friend!</TAGLINE>
        <FLAVOR>Duck</FLAVOR>
    </DETAILS>
  </HEADER>
</LABEL>

1. Crea un archivo de activación de ejemplo usando los datos anteriores. Asegúrate de que la extensión del archivo sea .XML, ya que es lo que espera la integración.
2. Con la integración abierta, haz clic en la pestaña Probar.
3. Haz clic en el botón verde Iniciar en la cinta superior.
4. Coloca el archivo en la carpeta de escaneo que configuraste en la sección anterior.
5. Comenzarán a aparecer mensajes de integración, confirmando que la integración ha detectado el archivo.
6. Una vez que tengas una impresión exitosa, es momento de desplegar.
7. Haz clic en la pestaña Desplegar y luego en el botón verde Desplegar.
8. Si no has guardado tu archivo, se te pedirá que lo hagas.
9. Haz clic en el menú desplegable y selecciona Esta computadora de la lista. Haz clic en Siguiente.
10. Selecciona Desplegar ahora y luego haz clic en Finalizar.
11. Tu integración ya está desplegada.

Recursos adicionales

Imprimir documento usando Print Command Script (Video - 9:40)

Crear una integración de archivos usando Print Command Script (27:58)