Descripción general

Al automatizar la impresión de etiquetas usando la API REST de BarTender, es posible sobrescribir una conexión de base de datos para tu etiqueta con datos personalizados usando archivos de texto, sin necesidad de modificar tu archivo BTW.

Al utilizar la función TransformTextToRecordSetAction durante tu llamada a la API, los datos de tu archivo de texto se convierten en registros de datos que luego llenan tu etiqueta al momento de imprimir.

En este artículo te mostraremos cómo llamar a esta función usando YAML.

Para una descripción general sobre cómo funciona la API REST, puedes consultar este artículo. 

Aplicable a

BarTender 2022 y versiones posteriores

Edición Automation y superiores 

Información

Crea tu documento de BarTender

1. Crea un archivo de texto de base de datos con el siguiente formato: 

   Campo 1, Campo 2, Campo 3
   Valor 1, Valor 2, Valor 3
   Valor 4, Valor 5, Valor 6

2. Guarda el archivo como dbfile.txt.
3. Abre BarTender Designer y crea un documento nuevo.
4. Agrega una conexión de base de datos de texto para dbfile.txt. (Consulta este artículo para más información)
5. Asegúrate de que tu conexión de base de datos se llame dbfile:

1. Agrega 3 objetos de texto a la etiqueta y conéctalos a los campos de la base de datos.  
2. Guarda el archivo en C:\Docs\APITest.btw.

Prepara tu entorno

1. Exporta la configuración de tu conexión de base de datos: 

1. Guarda el archivo en C:\Docs\dbfolder\ConnectionSetup.xml.
2. Crea un archivo de datos con el siguiente contenido:

   Campo 1, Campo 2, Campo 3
   Valor 7, Valor 8, Valor 9
   Valor 10, Valor 11, Valor 12

3. Guárdalo en C:\Docs\dbfolder\datafile.txt.
4. Crea una carpeta llamada Output dentro de C:\Docs\.

Realiza tu llamada a la API

1. Abre el siguiente enlace en tu navegador:
   

   http://localhost:5159/swagger/index.html

2. En la parte superior de la página haz clic en el botón Try it out: 

1. Asegúrate de que el parámetro File esté vacío.
2. Para el cuerpo de la solicitud selecciona text/vnd.yaml.
3. En el cuerpo de tu solicitud, agrega las siguientes dos acciones: 
   1. TransformTextToRecordSetAction con los siguientes parámetros: 
      1. ConnctionSetup: el archivo xml exportado de la configuración de conexión de tu archivo btw. 
      2. Text: el archivo de texto que contiene los datos que se insertarán en tus etiquetas al imprimir. 
   2. PrintBTWAction con los siguientes parámetros:
      1. DocumentFile: la ruta a tu archivo btw que se va a imprimir.
      2. Printer: la impresora que se va a utilizar.
      3. PrintToFileFolder y PrintToFileFileName: la ubicación y el nombre del archivo de salida que usará la impresora PDF.
      4. DatabaseOverrides: la configuración para sobrescribir la base de datos. En este caso, la conexión de base de datos dbfile se sobrescribe desde la variable datum.  

ActionGroup:
   Actions:
      - TransformTextToRecordSetAction:
         ConnectionSetup: 
            File: C:\Docs\dbfolder\ConnectionSetup.xml
         Text:
            File: C:\Docs\dbfolder\datafile.txt
         RecordSetVariableName: datum 
      - PrintBTWAction:
         DocumentFile: C:\Docs\APITest.btw
         Printer: PDF
         PrintToFileFolder: C:\Docs\Output
         PrintToFileFileName: test.pdf
         DatabaseOverrides: 
            - Name: dbfile
              Type: VariableName
              DataSourceVariableName: datum 

También puedes probar esta alternativa más sencilla de la acción Print mostrada arriba:

      - PrintBTWAction:
         DocumentFile: C:\Docs\APITest.btw
         Printer: PDF
         PrintToFileFolder: C:\Docs\Output
         PrintToFileFileName: test.pdf
         DatabaseOverrides: 
            - Name: data
              FileTarget: C:\kit\databases\data.txt

Si la llamada fue exitosa deberías ver el siguiente mensaje: 

Recursos adicionales

Referencia de la clase TransformTextToRecordSetAction

Referencia de la clase PrintBTWAction