Supply chain | Supply Chain Management, Commerce

Document Routing Labels, ZPL, and field substitution

(1) Share

Report

Posted on by SL-13051731-0

I'm maintaining some Label in Document Routing that a previous developer coded, and I see that they used $itemfieldname$ coding to insert a value from a table during real time printing of labels.

Is there any documentation on how this substitution functionality works? Specifically, are they any parameters to this function? For example, are the parameters that allow me to specify which part of the value I wish to print? If, for example, the field/variable was an item number and you only wanted to print the first three characters, could you do something line $itemfieldname$:1-3?

Any light that can be shared on this function would be greatly appreciated.

Scott Lineberger

Coastal Industries, Inc.

Categories:

Dynamics 365 Supply Chain Management

I have the same question (0)

All responses (3)

Answers (0)

Laurens vd Tang 4,012 Super User 2025 Season 2 on at

Like (0)

Report
Good day Scott,

Which layout do you use? There are few options:

Document routing layout

Label layout

Wave label layout

I believe it is not possible print only the first three or two characters of a value.

Best regards,

Laurens van der Tang

Was this reply helpful? Yes No
Suggested answer

Danny Bilodeau 4,918 Super User 2025 Season 2 on at

Like (0)

Report

Hi SL,

Here is an old post that explains the mechanics of it all: https://kashperuk.blogspot.com/2016/10/tutorial-extending-label-printing.html

Back then the table used to generate Labels was the WHSLicensePlateTable so you will see several mention of that table. Now, with customs labels you can use pretty much any table as the source of the data. The principles would have remained the same, just replace your table's name as the source of your License Plate / Container / Customs label and you can understand the general mechanics.

The %fieldname% is simply a placeholder (or variable) that you insert in the zpl code and that is being replaced by the real value at the time of label printing. That variable can't just be anything, it must be an available field from the table you are using.

On the question of the existence of a parameter to truncate a string value, there is no such parameter and there is no zpl instruction that will do so. For this to occur will require pre-processing before the coded label is sent to the label printer; a developer would be able to assess the feasibility and effort required for that pre-processing.

Was this reply helpful? Yes No
Uzair Siddiqui 32 on at

Like (0)

Report

Simple solution would be to created a method to populate the with the limited characters and then replace the ZPL placeholder.

Was this reply helpful? Yes No

Join the conversation

Community site session details

Document Routing Labels, ZPL, and field substitution

Helpful resources

Quick Links

Responsible AI policies

Neeraj Kumar – Community Spotlight

Congratulations to the November Top 10 Community Leaders!

Leaderboard > Supply chain | Supply Chain Management, Commerce

Featured topics

Product updates

Community site session details

Document Routing Labels, ZPL, and field substitution

Helpful resources

Quick Links

Responsible AI policies

Neeraj Kumar – Community Spotlight

Congratulations to the November Top 10 Community Leaders!

Subscribe to this forum!

Select categories

Leaderboard > Supply chain | Supply Chain Management, Commerce

Featured topics

Product updates