Specifying details for a Set Parameter element

For parameters of types integer and decimal you can specify an expression using these operators:

• ID() to get the ID of the current workflow instance.
• MAJORVERSION() to get the major version of the workflow definition.
• MINORVERSION() to get the minor version of the workflow definition.
• FROMSTRING(string, decimal separator) to convert a string to an integer or decimal. These are possible “decimal separator” values, without quotes:
  • DOT
  • COMMA

You can nest the integer/decimals operators. Use square brackets for parameter placeholders.

To select from a list of available parameters, press Ctrl+Spacebar. To select a parameter, use the arrow keys and press Enter, or use the mouse. To leave the list without selecting a parameter, press Esc.

The expression is validated when you leave the input field. If the calculation fails at runtime, the original parameter value, or the value set in the previous steps, is kept.

This table shows examples of expressions with integer and decimal parameters types:

For parameters of type string and hyperlink, an expression consists of these elements:

• String constants
• String parameters
• Parameters of type hyperlink, code, or integer
• Operators

The parameters of type hyperlink, code, and integer are automatically converted to strings when the expression is evaluated.

You can use these operators:

• Ampersand (&) to concatenate two or more strings.
• SUBSTRING(string, start index, length) to extract a substring.
• REPLACE (string, substring, replacement) to replace all occurrences of substring.
• TRIM(string) to trim beginning and ending white spaces. White spaces are Space, Tab, and Enter.
• GETLAST(string, length) to extract the last characters of a string.
• TOUPPERCASE(string) to convert the whole string to uppercase.
• TOLOWERCASE(string) to convert the whole string to lowercase.
• NAME() to get the workflow definition name for the current workflow.
• SOURCETYPE(string) to get the source type that started this workflow.

  Possible source types:

  • Manual
  • Alert
  • Process.Workflow BOD
  • Workflow
  • Activation Policy
    Note: When a workflow is started from a document flow, the source type is Process.Wokflow BOD.
• SOURCE(string) to get the identifier of the source that started this workflow instance. Depending on the source type, one of these identifiers is retrieved:
  • The user identifier
  • The alert ID
  • The logical ID of the Process.Workflow BOD
  • The Activation Policy name
  • The workflow definition name
• FROMNUMBER (integer/decimal, decimal separator, digit grouping symbol, decimal places) to convert a decimal/integer to a string.
  • Possible “decimal separator” values, without quotes, are:
    • DOT
    • COMMA
  • The "digit grouping symbol" value can be any string.
  • The value of "decimal places" can be a whole number from 0 to 9. Using parameters is not possible.

You can nest the string operators. Use square brackets for parameter placeholders and double quotes for constant string values.

To select from a list of available parameters, press Ctrl+Spacebar. To select a parameter, use the arrow keys and press Enter, or use the mouse. To leave the list without selecting a parameter, press Esc.

The expression is validated when you leave the input field. If valid expressions are defined that fail at runtime, the workflow execution fails in this set parameter step. These are examples of failures:

• A parameter used in an expression has not been initialized and has value NULL.
• The result of a concatenation is a string with more than 4000 characters.

This table shows examples of expressions with strings:

For parameters of type date you can specify an expression using these operators:

• PLUS(date, number, UNIT) to add several days, months, or years. Possible UNIT values,without quotes:
  • DAYS
  • MONTHS
  • YEARS
• MINUS(date, number, UNIT) to subtract several days, months, or years. Possible UNIT values, without quotes:
  • DAYS
  • MONTHS
  • YEARS
• TODAY() to receive the current date
• FROMDATETIME(date and time) to extract the “Date” part from the Date and Time parameter
• STARTOFMONTH(date) to receive the first day of the month
• ENDOFMONTH(date) to receive the last day of the month
• STARTOFYEAR(date) to receive the first day of the year
• ENDOFYEAR(date) to receive the last day of the year

You can nest the date operators. Use square brackets for parameter placeholders.

To select from a list of available parameters, press Ctrl+Spacebar. To select a parameter, use the arrow keys and press Enter, or use the mouse. To leave the list without selecting a parameter, press Esc.

The expression is validated when you leave the input field. If the calculation fails at runtime then the original parameter value, or the value set in the previous steps, is kept.

This table shows examples of expressions with dates:

For parameters of type date and time you can specify an expression using these operators:

• NOW() to receive the current date and time as UTC.
• STARTTIME() to receive the time when this workflow instance was started, as UTC time.
• PLUS(date and time, number, UNIT) to add several seconds, minutes, hours, days, months, or years. Possible UNIT values, without quotes:
  • SECONDS
  • MINUTES
  • HOURS
  • DAYS
  • MONTHS
  • YEARS
• MINUS(date and time, number, UNIT) to subtract several seconds, minutes, hours, days, months, or years. Possible UNIT values, without quotes:
  • SECONDS
  • MINUTES
  • HOURS
  • DAYS
  • MONTHS
  • YEARS
• STARTOFMONTH(date and time) to receive the start of the first day of the month
• ENDOFMONTH(date and time) to receive the end of the last day of the month
• STARTOFYEAR(date and time) to receive the start of the first day of the year
• ENDOFYEAR(date and time) to receive the end of the last day of the year

You can nest the date and time operators. Use square brackets for parameter placeholders.

To select from a list of available parameters, press Ctrl+Spacebar. To select a parameter, use the arrow keys and press Enter, or use the mouse. To leave the list without selecting a parameter, press Esc.

The expression is validated when you leave the input field. If the calculation fails at runtime then the original parameter value, or the value set in the previous steps, are kept.

This table shows examples of expressions with date and time parameters: