Block Properties
Last updated
Was this helpful?
XMPro Platform
Last updated
Was this helpful?
Block Properties are properties that define the appearance and behavior of the Block. This allows you to customize the block's content such as the heading text, or configure any data you would like to display on your application.
Each block type has different properties. To access the Block Properties tab, double-click a Block in the canvas or click on a Block in the canvas and click the Block Properties command.
Properties are split into several common categories. Click on a category to expand the accordion and see the Properties in that category.
The common categories are as follows:
Appearance
Properties that define how a Block looks.
Behavior
Properties that define how a Block behaves.
Value
Properties that define what value a Block has.
Data Source
Properties that define what Data Source the Block has (applies to Blocks that allow a Data Source to be attached).
Data, Columns, Items
Properties that define what the Data Source properties are mapped to, or allow a static data set to be created (applies when relevant to the Block).
Grouping
Properties that define how the Data Source is grouped (applies when relevant to the Block).
Action
Properties that define what action, and validation to perform, and what Data Source to update when it or items inside the Block are clicked (applies to Blocks that allow an action).
Validation
Properties that define what validation should be performed on the value of the Block before allowing an action (applies to Blocks that allow user input).
Some properties have the option of being a Dynamic or Expression property. If the property has a button on the left with an A icon and "Static Value" when you hover it, it can be a Dynamic or Expression Property. Press the button to cycle through the modes.
Dynamic properties allow you to select a value for the property from the Page Parameters, Variables, User Details, Device Details, and from a column or expression of the current row of a parent Block's Data Source.
Username
Returns the Username of the user that is signed in.
First Name
Returns the First Name of the user that is signed in.
Last Name
Returns the Last Name of the user that is signed in.
Full Name
Returns the Full Name of the user that is signed in, using the format "[First Name] [Last Name]".
Returns the Email of the user that is signed in.
Preferred Language
Returns the regional language tag of the logged in user's preferred language. Use this to adjust text when an App will be used in multiple languages: Iif(userPreferredLanguage == "en-US", "Hello world", "Oi Worldo")
English (United States)
en-US
svenska
sv-SE
Português (Brasil)
pt-BR
Русский
ru-RU
Español
es-ES
Nederlands
nl-NL
Deutsch
de-DE
français
fr-FR
中文 (Zhōngwén)
zh-CN
ελληνικά
el-GR
Türkçe
tr-TR
čeština
cs-CZ
suomi
fi-FI
Italiano
it-IT
Magyar
hu-HU
日本語 (にほんご)
ja-JP
slovenski jezik
sl-SI
Tiếng Việt
vi-VN
Language
Tag
English (United States)
en-US
svenska
sv-SE
Português (Brasil)
pt-BR
Русский
ru-RU
Español
es-ES
Nederlands
nl-NL
Deutsch
de-DE
français
fr-FR
中文 (Zhōngwén)
zh-CN
ελληνικά
el-GR
Türkçe
tr-TR
čeština
cs-CZ
suomi
fi-FI
Italiano
it-IT
Magyar
hu-HU
日本語 (にほんご)
ja-JP
slovenski jezik
sl-SI
Tiếng Việt
vi-VN
IsMobile
Returns True boolean value if the App is open on a mobile device.
Example: For Mobiles and/or Tablets will be True.
IsDesktop
Returns True boolean value if the App is open on a desktop device.
Example: For Laptops and/or Desktops will be True.
Culture
Returns the Device culture/language.
Example: If the language is set to US English will return en-US.
Expression properties allow you to create short scripts to create a custom value from all the above options. See the Variable and Expressions article to learn more about Expressions.
The Dynamic and Expression properties will have all the Block's ancestor's Data Sources displayed in the order of closest ancestor to furthest. For example, in the following images, the bottom-most Text Block in the Page Layers has two ancestors that have a Data Source: the Data Repeater Box and the Templated List. Therefore the two data sources are listed in the Text Block's Dynamic and Expression property dropdowns.
.
