GETENVIRONMENTINFO

This function returns information about properties of the environment in which a report is displayed. This information can be used by report designers to ensure that reports are displayed optimally in different environments, such as dashboards and Apple Watch.

GETENVIRONMENTINFO is typically used in report load actions to configure variables that control report behavior.

This table describes the categories of environmental properties:

Category Property Description Value
Container

Refers to the area in which a report is displayed: for example, a dashboard widget, or a web browser

HasMargin Indicates whether the container has built-in margins TRUE or FALSE
Container HasTitle Indicates whether the container has its own title TRUE or FALSE
Container Width Width of the container in pixels Number
Container Height Height of the container Number
Container IsDialog Indicates whether the report opens as a dialog report TRUE or FALSE
Container IsMing.le

Indicates whether the report opens in Infor OS Portal

TRUE or FALSE
Container IsLocked Indicates whether the dashboard is locked to prevent modification by users TRUE or FALSE
Container Type Describes the type of container

HomepageWidget

AppleWatch

Dashboard Name Unique name of the dashboard Text
Dashboard Caption Name of the dashboard Text
Global IsService Indicates whether a report is displayed in a Infor EPM services environment TRUE or FALSE
Global FarmMode Mode of the farm OnPremise or Cloud
Global TenantMode Mode of the tenant Single, Multi, or Hybrid
Global FarmEnvironment Environment of the farm

Production, Test, or Development

Global IsGenAIAvailable Indicates whether you have the Infor GenAI available TRUE or FALSE
Application Name Unique name of the current application Text
Application Caption Caption of the current application Text
Application Description Description of the current application Text
Application Version Version of the current application Text
Application Vendor Vendor of the current application Text

Syntax

The category and property arguments of the function are optional but, in most cases, both are specified.

This syntax returns the value of a specified property:

=GETENVIRONMENTINFO("category","property")

For example:

GETENVIRONMENTINFO("Container","IsMing.le")

This syntax returns an XML table of all properties in a category, and their values:

=GETENVIRONMENTINFO("category")

This syntax returns an XML table of all categories and properties that have values:

=GETENVIRONMENTINFO()

The function ignores properties and categories that have no or empty values. For example, =GETENVIRONMENTINFO("Dashboard") returns no values unless the report which contains the function is displayed in a dashboard.