What data can be printed through Printing Services?

This article enumerates all data supported by each type of document you can print using Printing Services.

When should I read this article?

If you're creating or editing a label for a Printing Service, check this article to understand the variables you can use, and how they are configured.

Contents

1. What variables can I use with Loftware Cloud/Nicelabel?
   1. Recipe Data Package (from a Recipe)
   2. Nutritional Macro Nutrients (from Recipe)
   3. Nutritional Micro Nutrients (from Recipe)
   4. Menu Item Data (from Menu Items)
   5. Menu Data (from Menus)
   6. Printing tags
2. How can I work with the data? Which Functions can I use?
   1. ParseIngredients
   2. ConvertUnitTemplate
3. Where can I find templates for the data and functions?
   1. Default Variables
   2. Default Functions

What variables can I use with Loftware Cloud/Nicelabel?

When printing from Loftware Cloud/Nicelabel, you can use variables with data from:

• Recipes
• Menus
• Menu Items

Each source has different packages. Let's take a look at the different supported packages in the following sections.

Recipe Data Package (from a Recipe)

Nutritional Macro Nutrients (from Recipe)

How can I work with the data? Which Functions can I use?

ParseIngredients

Depends on

Recipe data being printed from a Menu Item or a Recipe label

Description

The ingredient list has a standard format where the ingredients are separated by 2 semicolons, e.g. "Salt;;Onion". This function parses the ingredient list by separating the ingredients by simple commas and allows you to control the capitalization of the output.

Inputs

1. capitalization: Tell the system if you want the output to keep the original format or if you want to change it to be lowercase or uppercase.
   
   1. Input type: string
   2. Input options: "original", "lowerCase", ", or "upperCase"

Outputs

1. String with the list of items, separated by commas and capitalized based on your selection. Check the examples below for an ingredient list of "Salt;;Onion"
   1. original: "Salt, Onion"
   2. lowerCase: "salt, onion"
   3. upperCase: "SALT, ONION"

Usage

1. Download and add the function to your label
2. Change the capitalization if needed
3. Change the function name to fit your use best, e.g., name it "OriginalIngredientsList" or IngredientsListUpper"
4. Use the function as the source for a label object, e.g. Text box

ConvertUnitTemplate

Depends on

Recipe data being printed from a Menu Item or a Recipe label

Description

The conversions you get from Galley are a structured list that needs to be parsed in order to be used. This function takes a unit and quantity and converts the data into a target unit using the conversions described in the variable conversions.

Inputs

1. quantity: The quantity you want to convert. You can type a number or use a different variable as the source.
   
   1. Input type: quantity variable or number
   2. Input examples: totalYield.Value, 150.50
2. fromUnit: The source unit. You can type the unit name or use a different variable as the source.
   1. Input type: unit variable or string
   2. Input examples: yieldUnit.Value, "each"
3. ToUnit: The output unit. You can type the unit name or use a different variable as the source.
   1. Input type: unit variable or string
   2. Input examples: nutritionalUnit.Value, "ml"
4. decimals: The number of decimal places after conversion
   1. Input type: number (integer)
   2. Input examples: 2, 0
5. showToUnitInResult: Select if you want to have the unit or just the value in the output
   1. Input type: boolean
   2. Input Example: True, False
      1. If set to True, the result will show the unit you're parsing to. e.g. "10g".
      2. If set to False, the result will show only the quantity number, e.g. "10"
6. addSpace:  select if you want to add a blank space between the quantity and the unit
   1. Input type: boolean
   2. Input Example: True, False
      1. If set to True, e.g. "10 g".
      2. If set to False, e.g. "10g".

Outputs

1. String with the converted value and unit, depending on your configuration
   1. decimals=4, showToUnitInResult=false: "12.2234"
   2. decimals=2, showToUnitInResult=true, addSpace=true: "12.22 each"
   3. decimals=0, showToUnitInResult=true, addSpace=true: "12 each"
   4. decimals=0, showToUnitInResult=true, addSpace=false: "12each"

Usage

1. Download and add the function to your label
2. Change the configurations as you see fit
3. Change the function name to fit your use best, e.g., name it "ConvertYieldToFLOZ" or "ConvertNutritionalToEACH"
4. Use the function as the source for a label object, e.g. Text box
5. If you want to have more than one conversion, use multiple copies of this function and rename them

Where can I find templates for the data and functions?

Galley provides you all this data directly to your Loftware Cloud Control Center.

In your Control Center, in the page Documents, you'll see a folder called !Galley Default Files. Inside this folder, you'll see folders for Default Variables and Default Functions. Let's take a look at each.

Default Variables

The variables are separated into several different data sets, each containing a subset of variables:

• All Menu Data: Contains all the variables defined in
  • Recipe Data Package (from a Recipe)
  • Nutritional Macro Nutrients (from Recipe)
  • Nutritional Micro Nutrients (from Recipe)
  • Menu Item Data (from Menu Items)
  • Menu Data (from Menus)
• All Recipe Data: Contains all the variables defined in
  • Recipe Data Package (from a Recipe)
  • Nutritional Macro Nutrients (from Recipe)
  • Nutritional Micro Nutrients (from Recipe)
• Menu Data: Contains all the variables defined in
  • Menu Item Data (from Menu Items)
• Menu Item Data: Contains all the variables defined in
  • Menu Item Data (from Menu Items)
• Nutritional Macro Nutrients: Contains all the variables defined in
  • Nutritional Macro Nutrients (from Recipe)
• Nutritional Micro Nutrients: Contains all the variables defined in
  • Nutritional Micro Nutrients (from Recipe)
• Recipe Data: Contains all the variables defined in
  • Recipe Data Package (from a Recipe)
• Tag Examples:  Contains examples for using tags

Default Functions

In this section, you'll find files for all functions described in section above

Back to 🔝