Design a label
The design of labels is configured in the Label Editor tab.
Prerequisite
Procedure
-
Open the Packaging Control > Label Management menu entry.
-
Click on
in the row of the label to be designed.
The Label Editor tab opens.
-
Design or modify the label layout using the available tools and options.
-
In the header, click on
to apply the changes made to the label design.
The changes are saved.
Label editor
Please always use this reference website here: developer.mescius.com/activereportsnet/docs for future updates about the Label Editor tool.
Always check for the latest version of: "ActiveReports XX Web Designer". XX means the version number. If there is no newer version number, always use the latest number of "ActiveReports XX Web Designer".
If you click on the text: "Online Help" you will navigate to visual Quick Guide for the Label Editor Interface.
This section below outlines how to configure PageSize and Value settings within the system.
Value configuration
This section details how to configure values, including dynamic values and array elements.
Default demo JSON (for preview)
This section would typically include an example JSON structure for preview purposes. Please check the default demo JSON file here.
Details
{
"packagingOrder": {
"id": "b964b927-e635-460f-89c7-b3badf41c5e1",
"created": "2024-07-18T09:05:39.3711058+00:00",
"modified": "2024-07-18T09:18:55.9590573+00:00",
"orderNumber": "10251",
"packagingSetupId": "db59d646-b9cc-4577-b090-efdf663dc66d",
"packagingSetup": {
"id": "db59d646-b9cc-4577-b090-efdf663dc66d",
"created": "2024-07-09T15:32:14.9607894+00:00",
"modified": "2024-07-09T15:32:14.9608209+00:00",
"name": "Canister purge valve",
"materialNumber": "028014250267E",
"hash": "7aa8abf7a9f3e22ab94fcf13749c41ff",
"packagingSetupMaterials": [
{
"id": "78ae053e-c297-4798-81f6-1ae23c348814",
"created": "2024-07-09T15:32:14.9608531+00:00",
"modified": "2024-07-09T15:32:14.9608532+00:00",
"name": "Corrugated board bla",
"materialNumber": "6000735627",
"position": 3,
"level": 1,
"type": "Auxiliary",
"packagingLevelIdentifier": "028014250267EPV1",
"quantity": {
"amount": 4,
"unit": "NAR"
},
"parentPackagingSetupMaterialId": "2721dc7e-8c73-4404-b001-901ae6a6ecf0"
},
{
"id": "df43c664-851c-4178-8805-aed24b78021a",
"created": "2024-07-09T15:32:14.9608526+00:00",
"modified": "2024-07-09T15:32:14.9608528+00:00",
"name": "Cardboard Box",
"materialNumber": "6000735627",
"position": 2,
"level": 1,
"type": "Auxiliary",
"packagingLevelIdentifier": "028014250267EPV1",
"quantity": {
"amount": 1,
"unit": "NAR"
},
"parentPackagingSetupMaterialId": "2721dc7e-8c73-4404-b001-901ae6a6ecf0"
},
{
"id": "51e5b37c-5b3a-4253-b541-8b235a148695",
"created": "2024-07-09T15:32:14.9608535+00:00",
"modified": "2024-07-09T15:32:14.9608537+00:00",
"name": "connector-399*29",
"materialNumber": "6099736108",
"position": 4,
"level": 1,
"type": "LoadCarrier",
"packagingLevelIdentifier": "028014250267EPV2",
"quantity": {
"amount": 10,
"unit": "NAR"
},
"parentPackagingSetupMaterialId": "2721dc7e-8c73-4404-b001-901ae6a6ecf0"
},
{
"id": "2721dc7e-8c73-4404-b001-901ae6a6ecf0",
"created": "2024-07-09T15:32:14.9608325+00:00",
"modified": "2024-07-09T15:32:14.9608362+00:00",
"name": "Nox Sensor-pallet(400/pallet1)",
"materialNumber": "6099100058",
"position": 1,
"level": 0,
"type": "LoadCarrier",
"packagingLevelIdentifier": "028014250267EPV1",
"quantity": {
"amount": 1,
"unit": "NAR"
},
"parentPackagingSetupMaterialId": null
},
{
"id": "651d47d3-646a-4bca-971e-8d6e5da60afe",
"created": "2024-07-09T15:32:14.9608539+00:00",
"modified": "2024-07-09T15:32:14.9608541+00:00",
"name": "Plastic Bag - 400X30",
"materialNumber": "6000803402",
"position": 4,
"level": 2,
"type": "Auxiliary",
"packagingLevelIdentifier": "028014250267EPV2",
"quantity": {
"amount": 1,
"unit": "NAR"
},
"parentPackagingSetupMaterialId": "51e5b37c-5b3a-4253-b541-8b235a148695"
},
{
"id": "eaf218fd-901f-409a-bdc2-7f35997509c8",
"created": "2024-07-09T15:32:14.9608521+00:00",
"modified": "2024-07-09T15:32:14.9608523+00:00",
"name": "corrug.cover(1133*95",
"materialNumber": "6099611213",
"position": 1,
"level": 1,
"type": "Auxiliary",
"packagingLevelIdentifier": "028014250267EPV1",
"quantity": {
"amount": 1,
"unit": "NAR"
},
"parentPackagingSetupMaterialId": "2721dc7e-8c73-4404-b001-901ae6a6ecf0"
},
{
"id": "38464eff-31bb-4316-867d-1ee1d073bc0e",
"created": "2024-07-09T15:32:14.9608543+00:00",
"modified": "2024-07-09T15:32:14.9608545+00:00",
"name": "Canister purge valve",
"materialNumber": "028014250267E",
"position": 5,
"level": 2,
"type": "Material",
"packagingLevelIdentifier": "028014250267EPV2",
"quantity": {
"amount": 10,
"unit": "NAR"
},
"parentPackagingSetupMaterialId": "51e5b37c-5b3a-4253-b541-8b235a148695"
}
]
},
"productSetupId": "3116b70b-c123-4bfc-8792-ffe05c0b05ac",
"productSetup": null,
"targetPackagingLevel": 0,
"numberOfPackingUnits": 0,
"status": "Finished",
"quantity": 11,
"lineNumber": 32,
"additionalData": [
{
"id": "b1608543-8278-47ab-8f23-fa386a952944",
"name": null,
"value": "0101",
"classification": "ExternalErpSystemProductionVersion"
},
{
"id": "b2f5e8d5-babb-4841-8c98-0f3ea8436ac6",
"name": null,
"value": "07/18/2024 09:18:22 +00:00",
"classification": "PackagingOrderManufacturingDate"
},
{
"id": "45b458e3-683d-4a9a-926f-7e92469263f9",
"name": null,
"value": "00000500",
"classification": "ExternalErpSystemProductSetupExplosionNumber"
}
],
"materialNumber": "028014250267E",
"shortDesc": null,
"packagingUnits": [
{
"id": "4fafb9bc-1fa8-41d8-9440-362b6bb62b00",
"parentPackagingUnitId": null,
"packagingOrderId": "b964b927-e635-460f-89c7-b3badf41c5e1",
"packagingUnitIdentifier": "IAS0000009466",
"level": 0,
"loadCarrierMaterialNumber": "6099100058",
"status": "InProgress",
"contentType": "Homogenous",
"contents": [],
"auxiliaries": [],
"created": "2024-07-18T09:05:58.1676267+00:00",
"modified": "2024-07-18T09:18:23.4237752+00:00",
"packed": null,
"additionalData": [
{
"id": "9ee12fc8-ff18-4a9b-946f-613e4f180b31",
"name": null,
"value": "0000286675",
"classification": "ExternalErpSystemBatchNumber"
},
{
"id": "c31495d1-73b6-45c1-8220-124c500beadf",
"name": "PackagingUnitTargetQuantity",
"value": "2",
"classification": "Internal"
},
{
"id": "191764fe-fb03-4e58-aff5-47c47adf791e",
"name": "PackagingUnitSequence",
"value": "1",
"classification": "Internal"
}
],
"targetQuantityParts": 11,
"targetQuantityPackagingUnits": 2,
"partCount": 11,
"subPackagingUnits": [
{
"id": "cfb419b9-42f4-4b8d-b464-cf080657cc7c",
"parentPackagingUnitId": "4fafb9bc-1fa8-41d8-9440-362b6bb62b00",
"packagingOrderId": "b964b927-e635-460f-89c7-b3badf41c5e1",
"packagingUnitIdentifier": "IAS0000009464",
"level": 1,
"loadCarrierMaterialNumber": "6099736108",
"status": "Delivered",
"contentType": "Homogenous",
"contents": [
{
"productIdentifier": "10",
"labels": [],
"materialNumber": "028014250267E",
"id": "d7c10d2a-122a-4c10-a163-23442054c827",
"created": "2024-07-18T09:18:36.2902325+00:00",
"modified": "2024-07-18T09:18:36.2902333+00:00"
},
{
"productIdentifier": "9",
"labels": [],
"materialNumber": "028014250267E",
"id": "c61cd033-b5e7-4fcc-9277-1168b6a3825d",
"created": "2024-07-18T09:18:33.4563243+00:00",
"modified": "2024-07-18T09:18:33.4563255+00:00"
},
{
"productIdentifier": "1",
"labels": [],
"materialNumber": "028014250267E",
"id": "493de433-c0a9-4a14-be07-7d1e34c38284",
"created": "2024-07-18T09:18:27.0660352+00:00",
"modified": "2024-07-18T09:18:27.0660377+00:00"
},
{
"productIdentifier": "2",
"labels": [],
"materialNumber": "028014250267E",
"id": "ba121c34-c5e8-4368-a17d-a8a3bd537806",
"created": "2024-07-18T09:18:27.9091835+00:00",
"modified": "2024-07-18T09:18:27.9091849+00:00"
},
{
"productIdentifier": "3",
"labels": [],
"materialNumber": "028014250267E",
"id": "b30f1145-3f08-4ccb-870b-8901d317890e",
"created": "2024-07-18T09:18:28.7323615+00:00",
"modified": "2024-07-18T09:18:28.7323632+00:00"
},
{
"productIdentifier": "6",
"labels": [],
"materialNumber": "028014250267E",
"id": "94f33d5d-6103-4b57-bbbd-43b019f77b5e",
"created": "2024-07-18T09:18:31.2291134+00:00",
"modified": "2024-07-18T09:18:31.2291144+00:00"
},
{
"productIdentifier": "4",
"labels": [],
"materialNumber": "028014250267E",
"id": "76032d6e-ce54-40cd-9ba9-1d8093653ab7",
"created": "2024-07-18T09:18:29.5888262+00:00",
"modified": "2024-07-18T09:18:29.5888274+00:00"
},
{
"productIdentifier": "5",
"labels": [],
"materialNumber": "028014250267E",
"id": "43a1fa7d-3cdd-4741-8c9f-063bfef29165",
"created": "2024-07-18T09:18:30.4958417+00:00",
"modified": "2024-07-18T09:18:30.4958433+00:00"
},
{
"productIdentifier": "11",
"labels": [],
"materialNumber": "028014250267E",
"id": "2e8d38b4-8b14-441f-a14e-fcea1bfeac1f",
"created": "2024-07-18T09:18:45.8144024+00:00",
"modified": "2024-07-18T09:18:45.8144046+00:00"
},
{
"productIdentifier": "7",
"labels": [],
"materialNumber": "028014250267E",
"id": "fe4708bc-2cbd-4b8e-a567-6cad6c8766b3",
"created": "2024-07-18T09:18:32.0446107+00:00",
"modified": "2024-07-18T09:18:32.0446124+00:00"
}
],
"auxiliaries": [],
"created": "2024-07-18T09:05:58.1292115+00:00",
"modified": "2024-07-18T09:18:52.2635468+00:00",
"packed": null,
"additionalData": [
{
"id": "d51b7706-f9fb-42d9-b46b-9c82b32c8f6b",
"name": null,
"value": "UN940470238000103855",
"classification": "ExternalErpSystemPackagingUnitIdentifier"
},
{
"id": "7d81db88-191c-4ef6-ba45-304915a3dcec",
"name": "PackagingUnitTargetQuantity",
"value": "10",
"classification": "Internal"
},
{
"id": "d3ec1b98-3e1a-43ee-b282-c50099c6bf86",
"name": "PackagingUnitSequence",
"value": "1",
"classification": "Internal"
},
{
"id": "5deee8dc-98f9-4e37-9bcd-224f604fe048",
"name": null,
"value": "0000286675",
"classification": "ExternalErpSystemBatchNumber"
}
],
"targetQuantityParts": 10,
"targetQuantityPackagingUnits": 0,
"partCount": 10,
"subPackagingUnits": []
},
{
"id": "d302af37-bb80-4f28-8ec1-6d6465151f12",
"parentPackagingUnitId": "4fafb9bc-1fa8-41d8-9440-362b6bb62b00",
"packagingOrderId": "b964b927-e635-460f-89c7-b3badf41c5e1",
"packagingUnitIdentifier": "IAS0000009465",
"level": 1,
"loadCarrierMaterialNumber": "6099736108",
"status": "Delivered",
"contentType": "Homogenous",
"contents": [
{
"productIdentifier": "12",
"labels": [],
"materialNumber": "028014250267E",
"id": "51ddd523-7352-460e-85aa-fe7bd3c9c57e",
"created": "2024-07-18T09:18:55.9046736+00:00",
"modified": "2024-07-18T09:18:55.9046751+00:00"
}
],
"auxiliaries": [],
"created": "2024-07-18T09:05:58.129216+00:00",
"modified": "2024-07-18T09:19:01.4091826+00:00",
"packed": null,
"additionalData": [
{
"id": "bb28ba46-3f44-4469-9773-6f4357264ba9",
"name": null,
"value": "UN940470238000103856",
"classification": "ExternalErpSystemPackagingUnitIdentifier"
},
{
"id": "51f9437b-7b27-4bf1-a24d-b165f6cc490c",
"name": null,
"value": "0000286675",
"classification": "ExternalErpSystemBatchNumber"
},
{
"id": "72f41ebc-2ed1-4d78-8a6c-39cc09ac5f98",
"name": "PackagingUnitSequence",
"value": "2",
"classification": "Internal"
},
{
"id": "d9f0c0fb-67e7-454e-89ea-2b7e790b0ef6",
"name": "PackagingUnitTargetQuantity",
"value": "1",
"classification": "Internal"
}
],
"targetQuantityParts": 1,
"targetQuantityPackagingUnits": 0,
"partCount": 1,
"subPackagingUnits": []
}
]
}
],
"activePackagingUnitId": "4fafb9bc-1fa8-41d8-9440-362b6bb62b00"
},
"packagingUnit": {
"id": "b15bef65-53e8-49ac-9afb-bf3e5ee26a6a",
"parentPackagingUnitId": "fe11bb95-9920-4baa-ab0e-4684e1aca1e4",
"packagingOrderId": "ca158cc7-5e2a-4273-9196-da8f930b905c",
"packagingUnitIdentifier": "IAS0000009542",
"level": 1,
"loadCarrierMaterialNumber": "6099736108",
"status": "InProgress",
"contentType": "Homogenous",
"contents": [],
"auxiliaries": [],
"subPackagingUnits": [],
"created": "2024-08-06T06:50:48.6879728+00:00",
"modified": "2024-08-08T01:30:22.3204404+00:00",
"packed": null,
"additionalData": [
{
"id": "4a826d46-2bf8-4ebf-ab25-a9c2664a4e12",
"name": "PackagingUnitTargetQuantity",
"value": "4",
"classification": "Internal"
},
{
"id": "cbf2176f-4918-4af2-a662-b5868ccfaae5",
"name": "PackagingUnitSequence",
"value": "1",
"classification": "Internal"
},
{
"id": "3941cac0-a4b4-48dd-8a81-cb2e06070d9c",
"name": null,
"value": "IAS0000009542",
"classification": "ExternalErpSystemBatchNumber"
}
],
"packagingSetup": {
"id": "db59d646-b9cc-4577-b090-efdf663dc66d",
"created": "2024-07-09T15:32:14.9607894+00:00",
"modified": "2024-07-09T15:32:14.9608209+00:00",
"name": "Canister purge valve",
"materialNumber": "028014250267E",
"hash": "7aa8abf7a9f3e22ab94fcf13749c41ff",
"packagingSetupMaterials": [
{
"id": "78ae053e-c297-4798-81f6-1ae23c348814",
"created": "2024-07-09T15:32:14.9608531+00:00",
"modified": "2024-07-09T15:32:14.9608532+00:00",
"name": "Corrugated board bla",
"materialNumber": "6000735627",
"position": 3,
"level": 1,
"type": "Auxiliary",
"packagingLevelIdentifier": "028014250267EPV1",
"quantity": {
"amount": 4,
"unit": "NAR"
},
"parentPackagingSetupMaterialId": "2721dc7e-8c73-4404-b001-901ae6a6ecf0"
},
{
"id": "df43c664-851c-4178-8805-aed24b78021a",
"created": "2024-07-09T15:32:14.9608526+00:00",
"modified": "2024-07-09T15:32:14.9608528+00:00",
"name": "Cardboard Box",
"materialNumber": "6099739753",
"position": 2,
"level": 1,
"type": "Auxiliary",
"packagingLevelIdentifier": "028014250267EPV1",
"quantity": {
"amount": 1,
"unit": "NAR"
},
"parentPackagingSetupMaterialId": "2721dc7e-8c73-4404-b001-901ae6a6ecf0"
},
{
"id": "51e5b37c-5b3a-4253-b541-8b235a148695",
"created": "2024-07-09T15:32:14.9608535+00:00",
"modified": "2024-07-09T15:32:14.9608537+00:00",
"name": "connector-box(399*29",
"materialNumber": "6099736108",
"position": 4,
"level": 1,
"type": "LoadCarrier",
"packagingLevelIdentifier": "028014250267EPV2",
"quantity": {
"amount": 10,
"unit": "NAR"
},
"parentPackagingSetupMaterialId": "2721dc7e-8c73-4404-b001-901ae6a6ecf0"
},
{
"id": "2721dc7e-8c73-4404-b001-901ae6a6ecf0",
"created": "2024-07-09T15:32:14.9608325+00:00",
"modified": "2024-07-09T15:32:14.9608362+00:00",
"name": "Nox Sensor-pallet(400/pallet1",
"materialNumber": "6099100058",
"position": 1,
"level": 0,
"type": "LoadCarrier",
"packagingLevelIdentifier": "028014250267EPV1",
"quantity": {
"amount": 1,
"unit": "NAR"
},
"parentPackagingSetupMaterialId": null
},
{
"id": "651d47d3-646a-4bca-971e-8d6e5da60afe",
"created": "2024-07-09T15:32:14.9608539+00:00",
"modified": "2024-07-09T15:32:14.9608541+00:00",
"name": "Plastic Bag - 400X30",
"materialNumber": "6000803402",
"position": 4,
"level": 2,
"type": "Auxiliary",
"packagingLevelIdentifier": "028014250267EPV2",
"quantity": {
"amount": 1,
"unit": "NAR"
},
"parentPackagingSetupMaterialId": "51e5b37c-5b3a-4253-b541-8b235a148695"
},
{
"id": "eaf218fd-901f-409a-bdc2-7f35997509c8",
"created": "2024-07-09T15:32:14.9608521+00:00",
"modified": "2024-07-09T15:32:14.9608523+00:00",
"name": "corrug.cover(1133*95",
"materialNumber": "6099611213",
"position": 1,
"level": 1,
"type": "Auxiliary",
"packagingLevelIdentifier": "028014250267EPV1",
"quantity": {
"amount": 1,
"unit": "NAR"
},
"parentPackagingSetupMaterialId": "2721dc7e-8c73-4404-b001-901ae6a6ecf0"
},
{
"id": "38464eff-31bb-4316-867d-1ee1d073bc0e",
"created": "2024-07-09T15:32:14.9608543+00:00",
"modified": "2024-07-09T15:32:14.9608545+00:00",
"name": "Canister purge valve",
"materialNumber": "028014250267E",
"position": 5,
"level": 2,
"type": "Material",
"packagingLevelIdentifier": "028014250267EPV2",
"quantity": {
"amount": 10,
"unit": "NAR"
},
"parentPackagingSetupMaterialId": "51e5b37c-5b3a-4253-b541-8b235a148695"
}
]
}
}
}
Rule: dynamic value wrapping
For dynamically generated values, always wrap them within curly brackets {}.
Common object (non-array) configuration
For common objects (non-array), you can use an underscore _ to combine different levels of nested properties. There is no limit to the nesting level.
Examples:

Examples:
-
{packagingOrder_orderNumber} -
{packagingOrder_packagingSetup_materialNumber}

Preview:

Array element configuration
For array elements, you can only use the GetValue grammar.
-
Bracket Notation
[]: This indicates that the current node is an array. -
Conditions within
[]: You can include conditions inside the brackets, supportingequal (=)andnot equal (!=)operators.
Behavior for arrays:
-
Array with Filter: If a filter is applied and the result contains more than one value, it will always return the first value that fits the condition.
-
Array without Filter: If no filter is applied, it will always return all values that fit the condition, separated by a comma (
,).
Examples:
-
\{GetValue("PackagingUnit_AdditionalData[Classification=ExternalErpSystemBatchNumber]_Value")}-
Result:
IAS0000009542(Returns the first additional data value whereClassificationequalsExternalErpSystemBatchNumber).
-
-
\{GetValue("PackagingUnit_AdditionalData[Classification!=Internal]_Value")}-
Result:
IAS0000009542(Uses thenot equaloperator).
-
-
\{GetValue("PackagingUnit_AdditionalData[]_Value")}-
Result:
e.g., 4,1,IAS0000009542(Returns all values when no filter is applied).
-
-
\{GetValue("PackagingUnit_AdditionalData[]_Count()")}-
Result:
3(Returns the count of array elements).
-
-
\{GetValue("packagingOrder_packagingSetup_packagingSetupMaterials[materialNumber=6000735627&level=1]_packagingLevelIdentifier")}-
Result:
028014250267EPV1(Returns the first match).
-
-
\{GetValue("packagingOrder_packagingSetup_packagingSetupMaterials[materialNumber=6000735627&level=1]_quantity_amount")}-
Result:
4(Returns the first match).
-
Array nested array cases:
-
\{GetValue("packagingOrder_packagingUnits[status=InProgress&packed=null]_additionalData[Classification=ExternalErpSystemBatchNumber]_value")}-
Result:
0000286675
-
-
\{GetValue("packagingOrder_packagingUnits[status=InProgress&packed=null]_additionalData[]_Value")}-
Result:
e.g., 0000286675,2,1
-
-
\{GetValue("packagingOrder_packagingUnits[status=InProgress&packed=null]_additionalData[]_Count()")}-
Result:
3(Count of array elements).
-
Important note on case sensitivity
The only part of the whole expression that is case-sensitive is the condition value. All other characters in the expression are case-insensitive.
Examples of Equal Expressions:
The following expressions are considered equal:
-
\{GetValue("packagingOrder_orderNumber")} -
\{GETVALUE("PACKAGINGORDER_ORDERNUMBER")} -
\{getvalue("packagingorder_ordernumber")} -
\{getValue("Packagingorder_ordernumber")}
Examples of Unequal Expressions (due to case-sensitive condition value):
The following expressions are not equal:
-
\{GetValue("PackagingUnit_AdditionalData[Classification=Internal]_Value")} -
\{GetValue("PackagingUnit_AdditionalData[Classification=INTERNAL]_Value")}
Possible errors
unexpected character while parsing path query
Description: This error indicates that the data type provided for a condition value is incorrect.
Example Scenario:
Consider the expression:
\{GetValue("packagingOrder_packagingUnits[level=Test]_packagingUnitIdentifier")}
If level is expected to be a numeric value, but you provide a string like "Test", the system will flag an error. The T in the error message refers to the first letter of "Test" (or whatever the incorrect value is).
Resolution: Ensure that the value provided for a condition matches the expected data type. For instance, if level should be a number, pass a numeric value (e.g., level=1).



