Overview
A Labels Mobile Document is the label definition at the centre of the app. It ties together three things: a data collector that decides which data the label contains, a printing method that decides how the label leaves Business Central, and a layout that decides how the label looks. Every label has a unique Label Code and is maintained on the Labels Mobile Documents page.
Once a label is certified, a Print Label action becomes available on the Business Central pages that match the label's source table, and the label appears in the label selection list and on the Labels Mobile role center.
Fields on the Label Document
| Field | Purpose |
|---|---|
| Label Code | The unique identifier of the label. |
| Description | The label name shown to users. Mandatory before the label can be certified. |
| Label Group Code | An optional grouping used to organise labels in lists. |
| Data Collector (Flow) | The Mobile Flow that collects the data set for the label. Only normal flows in the Label area group are valid; internal activation flows are rejected. |
| Printing Method | The delivery channel used when the label is printed. |
| Label Report Layout Code | The Word report layout to run when printing through the Report integration type. |
| Layout File Name | The layout file name passed to external label software. |
| Pass Full Data Set | When enabled, the data collector receives all records in the user's current view instead of only the selected record. |
| Hide on Role Center | Hides the label from the Labels Mobile role center. |
| Hide on Selection List | Hides the label from the label selection list. |
| Status | New, Certified, Under Development, or Closed. |
The Source Table, Table Caption, Data Transfer Format, and Printer Name fields are calculated automatically from the data collector, the printing method, and the printer relations, and are shown for reference.
Status Lifecycle
A label document moves through four statuses:
| Status | Meaning |
|---|---|
| New | The label has been created but is not yet available to users. |
| Under Development | The label is being worked on and is not offered to users. |
| Certified | The label is complete and available. A description is required, and certifying the label creates its activation flow so it appears on the role center and in the selection list. |
| Closed | The label is retired. |
Note: A label must have a description before it can be certified. Changing the Hide on Role Center option on a certified label updates the activation flow so the change takes effect immediately.
Actions on the Labels Mobile Documents Page
| Action | What it does |
|---|---|
| Create Data Collector | Starts the Label Flow Wizard to build a new data collector for the label. |
| Test Data Collector | Runs the data collector so you can verify the collected data set. |
| Mobile Flow Setup | Opens the underlying Mobile Flow for advanced configuration. |
| Test Print | Prints a test label using the current setup. |
| Download files | Downloads the generated files, useful while designing a label. |
| Run Table Print Test | Runs a print test directly against the source table. |
Deleting a Label
When a label document is deleted, its printer relations and its activation flow are removed automatically, so no orphaned setup is left behind.