Quick reference
Wholechain Labels: quick reference. For everyone.
For: everyone.
Where this fits. Labels has three working levels: label designers lay out templates in the Design Editor, label managers link a Trade Item and set which inputs are editable in the Field Editor, and operators fill in and print from Label Entry.
Who does what
| Task | Where | Role |
|---|---|---|
| Lay out a template and set value sources | Design Editor | Designer |
| Create, clone, publish and delete templates | Template Manager | Manager |
| Add, duplicate, share and delete labels | Label List | Manager |
| Link a Trade Item and unlock inputs | Field Editor | Manager |
| Fill in values and print | Label Entry, Print Label | Operator |
Value source order
- GS1 Primary (AI with a GS1 Value Input)
- KDE Fallback (Trade Item value)
- Manual Fallback (fixed text)
Locks
| Where | Locked means | Tooltips |
|---|---|---|
| Design Editor | The setting is fixed in the template. | Lock field / Unlock field |
| Field Editor | Operators cannot see the input in Label Entry. | Lock in form view / Unlock in form view |
Template status
| Status | Can be used for new labels | Row menu |
|---|---|---|
| Draft | No | Edit, Publish, Delete |
| Published | Yes | Edit, View Published, Delete |
| Published with the information icon | Yes (published version) | Edit, Publish, View Published, Delete |
Rules to remember
- Only published templates can be chosen when adding a label.
- A label cannot be renamed after it is created.
- Publishing changes to your own template does not change labels already created from it. Labels made from a Wholechain template are updated when Wholechain updates that template.
- Values entered in Label Entry are used for that print run only.
- Deleting a shared label also deletes it from your Trade Partners' accounts.
- Serialization needs both Start and End; each page replaces the AI 21 value with its number.
Messages
| Message | When |
|---|---|
| Label duplicated successfully | After Duplicate. |
| Linked product updated | After choosing a Linked Product. |
| Label updated successfully | After closing the Design Editor. |
| Version published successfully | After Publish. |
| Please enter a template name | Create with an empty Template Name. |
| There is a newer edit version that has not been published yet. | Hovering the information icon on a published template. |
| Provide both start and end to enable serialization. | Print Label, until both numbers are entered. |
| No GS1 Value Input | An AI is chosen with no value yet. |
| Selected KDE has no value on this product | The chosen KDE is empty on the Trade Item. |
Field and action reference
Rules and restrictions
| Rule | Applies to | Behavior |
|---|---|---|
| Published templates only | Add Label | Only published templates can be chosen for a new label. |
| One Trade Item per label | Labels | A label links to one Trade Item at a time; choose another in Linked Product to change it. |
| Operators see unlocked inputs only | Label Entry | Operators see and change only the inputs unlocked in the Field Editor, for everyone. |
| Locks are saved per label | Field Editor | Lock choices persist after closing and carry over to duplicates. |
| Source order | Design Editor | An element uses GS1 Primary first, then KDE Fallback, then Manual Fallback. |
| Collector or Custom | Barcode element | Encoded Barcode Items is available only in Collector mode; Content only in Custom mode. |
| Autosave | Design Editor, Field Editor | Changes save as you work; closing with X returns you to the list. |
| Editing a published template | Template Manager | Opens a new version, flagged by the information icon until you choose Publish. |
| Deleting a shared label | Labels | A label shared with Trade Partners is also deleted from their accounts. |
| Unsaved entry values | Label Entry | Values typed in Label Entry are not stored on the label. |
| Deleting a template | Template Manager | You must type the template's name to confirm. |
Messages
| Message | When it appears |
|---|---|
| Label duplicated successfully | After Duplicate. |
| Linked product updated | After choosing a Linked Product. |
| Added text element | After Add Text. |
| Label updated successfully | After closing the Design Editor. |
| Version published successfully | After Publish. |
| Please enter a template name | Creating a template with no Template Name. |
| There is a newer edit version that has not been published yet. | Hovering the information icon on a published template. |
| Delete Label — Are you sure you want to delete this label? This action cannot be undone. | Choosing Delete on a label. Buttons: Cancel, Delete. |
| Delete "<template name>" — This template isn't used by any labels. This cannot be undone. Type the template name to confirm. | Choosing Delete on an unused template. Delete stays disabled until the name matches. |
| Provide both start and end to enable serialization. | Print Label, until both numbers are entered. |
| No elements added yet. Right-click on the canvas to add elements. | An empty Design Editor canvas. |
| No GS1 Value Input | An AI is chosen with no value. |
| Selected KDE has no value on this product | The chosen KDE is empty for the previewed Trade Item. |
| No results found for these filters. | The Legacy Labels page when no labels match. |
Glossary
| Term | Meaning |
|---|---|
| AI | GS1 Application Identifier: a number that says what a barcode value means (for example 10 is batch or lot). |
| Collector | Barcode mode that builds the barcode from a list of AIs. |
| Design Editor | Where templates are laid out. |
| Field Editor | Where a label is linked to a Trade Item and filled in. |
| GTIN | Global Trade Item Number. |
| KDE | Key Data Element: a value stored on a Trade Item or event. |
| Label Entry | The operator form used to fill in and print a label. |
| Serialization | Printing a run of labels with an incrementing AI 21 value. |
| Template | A reusable label design. |
Was this page helpful?