English

Getting Started withthe BarTender® Mobile App
USER GUIDEContents
Getting Started with the BarTender Mobile App
Requirements
Terminology
Downloading the BarTender Mobile App
Managing Your BarTender Sites
Adding a BarTender Site
Editing a BarTender Site
Deleting a BarTender Site
Switching to a Different BarTender Site
Managing Your Printers
Detecting and Adding Printers
Deleting Printers
Printing Documents
Selecting a Document to Print
Printing Your Document
Using Print Preview
Troubleshooting
Related Documentation

3334555667789910101213

Getting Started with the BarTender Mobile App
The BarTender® Mobile app makes professional printing as easy and flexible as using your mobile
handheld computer or device and as powerful and secure as printing with BarTender Cloud,BarTender 2022, and BarTender 2021 by Seagull Scientific.
The BarTender Mobile app works with BarTender Cloud; BarTender 2022 Enterprise, Professional,and Automation editions; and BarTender 2021 Enterprise edition. By using the app, you can do thefollowing:l

Automatically authenticate with a BarTender site and then browse to a specific document
folder within the site.

lUse your device to print to local Bluetooth-connected printers and IP-connected printers as wellas printers that are hosted on a BarTender site.

l

Add or edit data in real time by using in-app BarTender data entry forms and query prompts.

l

Use BarTender security features to monitor and access permissions to documents.

Requirements
The BarTender Mobile app requires that one of the following operating systems be installed on yourmobile device:l

Android (version 10 or newer)l

iOS (version 15 or newer)

The app connects remotely to a BarTender site, which is a BarTender Cloud or Print Portal server thathosts your BarTender documents. The app requires that at least one of the following versions ofBarTender be accessible from your network:l

BarTender Cloudl

BarTender 2022 Professional, Automation, or Enterprise edition with Print Portal installed andconfiguredl

BarTender 2021 Enterprise edition with Print Portal installed and configured

Terminology
The following terms appear in this document:l

BarTender Mobile app refers to the BarTender Mobile app that you download to your device.

l

BarTender Cloud refers to the BarTender software as a service (SaaS) product, which offers
click-and-print functionality in a cloud-based setting.

lPrint Portal refers to the Print Portal companion application that you can install with BarTender2022 and BarTender 2021. For more information, refer to Installing BarTender Print Portal inthe BarTender help system.

Getting Started with the BarTender Mobile App3l

BarTender site refers to the web service that hosts your BarTender documents, which might beBarTender Cloud or a Print Portal website or server. Collectively, these websites and servers
are called BarTender sites.
The app must be connected to a BarTender site to print the documents that are hosted on thesite. You can add more than one BarTender site to the app, and these sites can be connectedto the app simultaneously. However, the app can display only one BarTender site at a time.
Typically, a BarTender site is installed and configured by your BarTender administrator. When
this is the case, you do not need to configure the BarTender site to use the BarTender Mobile
app to print documents; you need only to connect to it.
For more information, refer to the Managing Your BarTender Sites section of this document.

Downloading the BarTender Mobile App
You can download the BarTender Mobile app from both the Google Play store and the Apple AppStore. Search for "BarTender by Seagull". The app is free to download and does not require aBarTender product key code.
The app interface includes a navigation menu at the bottom of the app window. This menu includes
the following options:lllll: Indicates whether an active connection to a BarTender site exists. When you tap thisicon, the BarTender site that you last connected to is displayed. Available when you havepreviously connected to a BarTender site.
: Refreshes the BarTender site that you are connected to. Available when you are
currently connected to a BarTender site.
: Opens the Manage Printer Settings page, which you can use to view, add, delete, andconfigure the printers that the app is connected to. Printers in your network are automaticallydetected, and you can manually add printers as needed. For more information, refer toManaging Your Printers.
: Opens the BarTender Sites page, which you can use to connect to a BarTender site, add
one or more BarTender sites to the app, and edit or delete a BarTender site. Use this option toswitch from one BarTender site to another. For more information, refer to Managing YourBarTender Sites.
: Opens the app information page, which displays version information and provides links
to the online help documentation and to a list of the open-source licenses that the BarTender
Mobile app uses. If a newer version of the app is available, you can click Install on this page toupdate the app.

Getting Started with the BarTender Mobile App4

Managing Your BarTender Sites
When you open the BarTender Mobile app for the first time, the BarTender Sites page is displayed.
This page has links to several BarTender Cloud sites already configured so that you can sign in to yourBarTender Cloud account if you have one. Tap the link for the BarTender Cloud site that hosts youraccount to connect to it and then locate and print your documents.
The BarTender Sites page also provides options to add more BarTender sites to the app and to edit
or delete sites that you have added. After you add one or more additional sites, tap a site to connect
to it and then locate and print your documents.
To open the BarTender Sites page if you have navigated away from it, tap.

Adding a BarTender SiteTo add a BarTender site to the app, follow these steps:

1. On the BarTender Sites page, tap.

2. On the Add BarTender Site page, enter the following information for the BarTender site thatyou want to connect to:lA name for the BarTender sitel

The BarTender site URL (this is the URL for your installed instance of BarTender 2022 or
BarTender 2021 Print Portal)

Typically, the print router URL, which includes the port number that the print router uses, isdetected automatically, but you might be prompted to enter it if the app cannot detect it.
3. Tap Save.

Editing a BarTender Site
To edit the settings of a BarTender site that you added, follow these steps:
1. On the BarTender Sites page, tap Edit.
2. On the Edit BarTender Site page, tap the BarTender site that you want to edit.
3. On the Edit BarTender Site page, make the changes that you want.
4. Tap Save.

Getting Started with the BarTender Mobile App

5

Deleting a BarTender Site
To delete a BarTender site that you added from the app, follow these steps:
1. On the BarTender Sites page, tap Edit.
2. On the Edit BarTender Site page, tap

for the BarTender site that you want to delete.

Switching to a Different BarTender Site
If you have configured more than one BarTender site, you can switch to a different site at any time. Todo this, tap
to switch to.

to display the BarTender Sites page, and then tap the BarTender site that you want

Getting Started with the BarTender Mobile App

6

Managing Your Printers
Typically, printers are added to a BarTender site by your BarTender administrator. When this is thecase, you do not need to add printers to the BarTender Mobile app to print your documents; you need
only to connect to the BarTender site that hosts the printers. These printers appear in the BarTendersite's Printers list at print time so that you can select the printer that you want to use.
However, in some cases, you might need to add one or more local printers to the app. After you dothis, the printers that you add to the app are shared with the BarTender site at print time and appear
in the site's Printers list.
This topic describes how to manage printers that are added to the app, not the printers that are
hosted on a BarTender site. Use the Manage Printer Settings page to detect local printers, tomanually add a printer to the app, and to delete a printer from the app.

To open the Manage Printer Settings page, tap.

Detecting and Adding Printers
When you open the BarTender Mobile app, it automatically detects connected Bluetooth printers andconnected network printers that use an IP address. These printers are then listed on the Manage
Printer Settings page.

If the printer that you want is not listed, you can tap
to instruct the app to detect connected
printers and refresh the printer list. Or, you can manually add a printer to the list. When you do this,the added printer is shared with your BarTender site when you connect to it.
By default, after you add a printer, it appears in the list together with a check mark that indicates thatthe printer will be shared to the BarTender site and will appear in the site's Printers list. If you clear
this check mark, the printer will not be shared and will not appear in the list.
Adding a Bluetooth printerTo manually add a Bluetooth printer, use your device's Bluetooth connection settings to locate andpair with the printer that you want.
Adding a network IP printerTo manually add a network IP printer, follow these steps:

1. On the Manage Printer Settings page, tap.

2. In the Add Printer dialog, enter the following information:l

The IP address or host name for the printerl

The port number

Getting Started with the BarTender Mobile App

7l

The printer manufacturer name and model number

If the printer is an IPP printer, select Universal (IPP) inthe Manufacturer list.
l

The height and width of the labels to be printed, in inches or millimeters (this informationis required by most printers)

3. Tap Save.

Deleting Printers
If the BarTender Mobile app cannot identify, locate, or re-establish a connection with printers that you
manually added to the app, you can delete those printers. To do this, tap
you want to delete.

Getting Started with the BarTender Mobile App

next to the printer that8

Printing Documents
After you connect to a BarTender site, you can select documents that are hosted on the site andselect a printer to send the print job to. The BarTender Mobile app supports data entry forms andquery prompts, so you can add this data at print time.

Occasionally, the BarTender Mobile app might be unable to send a
print job to the selected printer. If this occurs, the app notifies you sothat you can contact your administrator and request that a driver be
added to the BarTender site server for the printer that you want.

To return to your BarTender site from a different page in the app, tap.

Selecting a Document to Print
To select the document that you want to print, follow these steps:
1. Open the BarTender Mobile app.
2. Connect to the BarTender site that you want to use.
3. Browse the displayed documents to find the document that you want. Alternatively, enter asearch term in the Search field.
4. Tap the document to begin the printing process. (If you are in the Manage Files view in a
BarTender Cloud site, tap next to the document, and then tap Print.)
The BarTender Mobile app supports BarTender Cloud and the BarTender 2022 and BarTender 2021
versions of Print Portal as BarTender sites. For more information about how to print a document inBarTender Cloud and in Print Portal, refer to the following topics in their help systems:l

For BarTender Cloud: Locating and Printing a Documentl

For Print Portal: Printing a Document

You can also access the BarTender Cloud or Print Portal help system through the BarTender Mobileapp when the BarTender site is displayed, as follows:ll

In BarTender Cloud, tap.

In Print Portal, tap, and then tap Help.

Getting Started with the BarTender Mobile App9

Printing Your Document
To print a document, follow these steps:
1. Locate the document that you want, and then tap it to open the Print dialog. (If you are in theManage Files view in a BarTender Cloud site, tap next to the document, and then tap Print.)
2. In the Printer list, select the printer that you want.

If the printer that you want does not appear in the list, you canask your administrator to add the printer to the server that is
hosting the BarTender site.
Alternatively, you can add the printer locally to the BarTender
Mobile app. When you do this, you share the printer with theBarTender site when you connect to the site. For more
information, refer to Managing Your Printers.
3. In the Copies field, enter the number of copies that you want to print.
4. If your document contains serialized data, enter the number of serial numbers and the numberof copies per serial number that you want to print in the Serial Numbers and Copies per Serial
Number fields.
5. Tap Print.
lIf the Select Records dialog opens, select the records that you want to print, and thentap Print.

l

If a query prompt or data entry form is displayed, enter the required data, and then tapPrint.

The print job runs.
6. In the Print dialog, review the print job details, and then click Close to return to the Print dialog.
If you printed to a PDF, you can optionally tap Download to download a copy of the printed
items and/or tap Open and then select a PDF viewer to review the printed items.

Using Print Preview
You can view the document in Print Preview to verify that it is correct before you print it. Print Preview
displays the printed items exactly as they will appear, including any data that is pulled fromconnected databases or entered from query prompts or data entry forms.
To use Print Preview, follow these steps:
1. Locate the document that you want, and then tap it to open the Print dialog.
2. In the Printer list, select the printer that you want.

Getting Started with the BarTender Mobile App10

If the printer that you want does not appear in the list, you can
ask your administrator to add the printer to the server that ishosting the BarTender site.
Alternatively, you can add the printer locally to the BarTenderMobile app. When you do this, you share the printer with theBarTender site when you connect to the site. For more
information, refer to Managing Your Printers.
3. In the Copies field, enter the number of copies that you want to print.
4. If your document contains serialized data, enter the number of serial numbers and the numberof copies per serial number that you want to print in the Serial Numbers and Copies per Serial
Number fields.
5. Tap Preview.
lIf the Select Records dialog opens, select the records that you want to print, and thentap Preview.

l

If a query prompt or data entry form is displayed, enter the required data, and then tapPreview.

6. In the Print Preview dialog, a preview of your printed item is displayed. If your print job includes
more than one page, you can tap Page and then select the page that you want to view.
Tap Print to print the document, or tap Cancel to close Print Preview.

Getting Started with the BarTender Mobile App11Troubleshooting
The following answers to commonly asked questions provide solutions to help you troubleshoot yourBarTender Mobile app configuration.

Why doesn't my app connect to the BarTender site?
l

Make sure that a Wi-Fi connection is available and that you are connected to the internet.

l

Make sure that the Wi-Fi capabilities of your mobile device are enabled.

l

Make sure that the BarTender site that you are trying to connect to is turned on andfunctioning correctly.

l

If you still can't connect, turn off your device, turn it on again, open the BarTender Mobile
app, and then try to connect again.

Why can't I find a printer?
l

Make sure that one or more printers are available on Bluetooth or an IP port and areconnected to the BarTender site that you are using.

l

Make sure that the printer that you are trying to connect to is turned on and functioning
correctly.

l

If you are connected to a printer but the document still is not printed, refer toTroubleshooting printing problems on the BarTender Support Center website.

Why is my document displayed or printed incorrectly?
lVerify that the document's formatting and settings are correct in BarTender Designer. For
more information, refer to Modifying the Page Setup in the BarTender help system andthe "Template Design" articles on the BarTender Designer page of the BarTender SupportCenter website.

Getting Started with the BarTender Mobile App12

Related Documentation
Technical Documents
Getting Started with BarTender Cloud
BarTender 2022 Print Portall BarTender 2021 Print Portalll

To view and download technical documents, visit:https://www.seagullscientific.com/resources/white-papers/

Other Resourcesl

BarTender Software Website
https://www.seagullscientific.coml

BarTender Support Center
https://support.seagullscientific.coml

BarTender Online Help System
https://help.seagullscientific.com© 2023 Seagull Scientific, LLC. BarTender, BarTender Cloud, Intelligent Templates, Drivers bySeagull, the BarTender logo, the BarTender Cloud logo, and the Drivers by Seagull logo aretrademarks or registered trademarks of Seagull Scientific, LLC. All other trademarks are the propertyof their respective owners.

Version 4/6/2023 BarTender 2022 © 2023 Seagull Scientific, LLC