Using Data Fields in Expressions

Using Data Fields in Expressions

Expressions can contain values from data sources. A string representation of the field is used to reference that field from the data source. The proper syntax for the reference is the name of the data source and the field name with a full-stop character or decimal point separating them, surrounded by curly braces:

{DataSource.Column}
It is possible to drag and drop from the data dictionary to the page of a report or the expression editor, and the information will be inserted with the correct syntax automatically.

Parent Relationships

In cases where the data source has a parent relationship with another data source, you can reference other fields from the parent data source. The proper syntax, in this scenario, is the name of the data source, followed by the relation name, and then the field name. Each name should be separated by a full-stop character or a decimal point, and the entire thing should be surrounded by curly braces, as before.

{DataSource.Relation.Field}

If you have a set of information like the following:

  1. Cabinets - the name of a data source. 
  2. ParentCategories - the name of the relation. 
  3. Cabinets is a list of cabinets, and Categories is a list of categories of these products. 
  4. CategoryName is a column name in the Categories data source. 
{Cabinets.ParentCategories.CategoryName}

The above expression will yield the name of a category for a cabinet in the report.

A column can be called through multiple relationships. For example:

  1. OrdersDetail - the name of a data source. 
  2. ParentCabinets - the name of the relation between OrdersDetail and Cabinets. 
  3. ParentCategory is the name of the relation between Cabinets and Categories.
  4.  CatName is a field in the Categories data source. 
{OrdersDetail.ParentCabinets.ParentCategory.CatName}

The above expression will yield the name of a category for a cabinet in the report. This is has been done without a direct call to the Categories data source.

If VB.NET is used as the reporting language, the names will not be case sensitive. However, if the reporting language is C#, the names are case sensitive.

All data items are converted to the type that is specified in the options column. This dynamic conversion helps to accelerate the development of reports. To acquire data from a column without conversion, specify the data source directly.

In C#:

{Cabinets[“CabinetName”]}

The above expression will return data from the Cabinets data source without conversion.

In VB.NET:

{Cabinets.Item(“CabinetName”)}

    • Related Articles

    • Using Functions in Expressions

      Built-in Functions There is a variety of built-in functions available in the Report Designer. These functions can be accessed directly from the data dictionary, or from within the Expression Editor. Here is an example of a built-in function: ...

    • Using Aliases in Expressions

      Aliases can make it easier to understand expressions in reports. If you have a variable called “VariableA” and you have set an alias for it to “VA,” the variable can be referenced by Name OR Alias. By Name: {VariableA} By Alias: {[VA]} Syntax – ...

    • Using Expressions in the Rich Text Editor of Report Designer

      The articles in this section of the Knowledge Base involve working with Rich Text for display in your reports. To learn more about the Rich Text editor, and how to access this section within the Report Designer, see An Introduction to the Rich Text ...

    • Applying a Sort to a Data Band in Report Designer

      The articles in this section of the Knowledge Base involve working with Lists for display in your reports. To learn more about Lists and how to access the Report Designer, see Creating Lists in Report Designer. This article provides information for ...

    • Creating Lists in Report Designer

      The articles in this section of the Knowledge Base involve working with Lists for display in your reports. To access the Report Designer, select Toolbox Setup > Design Reports > Design (Report Type) Report. Select New Report to design a report from ...

    • Recent Articles

    • Microvellum Release Notes | Build 25.2.0206.641

      The following release notes apply to Microvellum build 25.2.0206.641. Item Number Fix An issue was reported regarding item numbers in composite drawings. Users who processed work orders with multiple products reported that the item numbers would ...

    • Microvellum Release Notes | Build 25.2.0204.641

      The following release notes apply to Microvellum build 25.2.0204.641. Toolbox Brand Retirement As part of Microvellum’s ongoing alignment with the values and catalog of INNERGY, and to improve user experience, clarity, and consistency, we have ...

    • MDF Door Profile Guide

      Door Wizard The Door Wizard is a Microvellum feature that enables users to interact with and control the specifics of door related variables, prompts, and available settings. The options available in the door wizard vary depending on the specific ...

    • Microvellum Foundation Library Release Notes | Build 26.0112

      Additions In accordance with Microvellum's new subscription changes, all Face Frame Expansion products and subassemblies, as well as the Range Hood Master product have been added to the full library install and library update zips (now included with ...

    • Toolbox Release Notes | Build 25.2.0114.641

      The following release notes apply to Toolbox build 25.2.0114.641 Processing Center Message Fix Fig. 1: An error message running in the background of the software. An issue was reported within the Processing Center. When processing an order, there ...