We're updating some of our product names. K2 Five will soon be Automation On-Prem. You may see both product names in our help pages while we make this change.

Smartfield Composer

Use the Smartfield Composer to configure nested inline functions and SmartObject methods, and to change values used in SmartField-enabled controls. Drag inline functions or SmartObjects from the Context Browser into a SmartField and the Smartfield Composer opens.

See the following resources for more information:

See How To: Save a Screenshot to PDF and Attach it to an Email for an example of using a Variable in a SmartField.
See How to: Use the All items as a collection option for information on how to use the All items as a collection option.
See SmartObject Get List Filter for information on how to configure a custom filter.
See How to: Use the custom SmartObject Get List Filter for information on how to use a custom filter on a SmartObject Get List method to return a list of items.

Navigate the Smartfield Composer

The table below describes the options available within the Smartfield Composer:

Area	Description
Tab Indicator	The color of the tab changes to a black background. This indicates that you are working with the Smartfield Composer in the highlighted area. In this example, you dragged a Function from the Context Browser into the On Date text box which opens the Smartfield Composer. This text box is located in the Due Date section on the Task tab.
Close the Composer	Use the X button to close the Smartfield Composer. In this example, click Close to return to the Task tab.
SmartField	This textbox contains the functions and SmartObjects dragged into the SmartfField. You can drag multiple items into the textbox. Double-click an added object to view the configure section. The arrow below the added object indicates the selected object and comes in handy when you've added several functions and SmartObjects to the textbox.
Configure Section	Use the configure section to construct your function. Here you can configure nested inline functions and SmartObjects. You can also see how chained functions and SmartObjects are linked together to get the data that you need in the right format.
Welcome to the Smartfield Composer	This is a Welcome message with short introduction to the Smartfield Composer. This message disappears when you start configuring the functions and SmartObjects. To remove it permanently, click the Got It button.

SmartFields are easy to spot by their Type / Drop watermark.

Drag the following items into SmartFields:

Inline Functions

Functions consist of building blocks that create operations and expressions. A function returns the result of operations performed on input values. An expression is built by combining operators and values that evaluate during a workflow. Function objects are displayed in gray.

Example of a nested Inline Function

The table below describes the options available within the Smartfield Composer:

Area	Description
Header	Click the header to enable editing. This header represents the title for the function.
Command Drawer Toggle	Click the ellipsis to expand the command drawer.
Command Drawer	The command drawer displays the function description. In this example, the command returns a Yes / No value.
Field Type	The type of field for the function is displayed to the left of the title. For more information on type of functions, see the Functions topic. In this example, the field type is numeric.
Close	Click this button to minimize the function. This does not close the Smartfield Composer, just the selected function. To expand it again, double click on the function.

SmartObjects

Use this to access data from your SmartObjects. SmartObject objects are displayed in green.

Example of a nested SmartObject

The table below describes the options available within the Smartfield Composer:

Area	Description
Command Drawer Toggle	Click the ellipsis to expand the command drawer.
SmartObject Properties	This section displays all available properties for the selected SmartObject. Configure the input / output values to get the data you need for your workflow.
Command Drawer	The command drawer displays filters and methods for the SmartObject. In this example, the command lists data from the Products table.
Close	Click this button to minimize the SmartObject. This does not close the Smartfield Composer, just the selected SmartObject. To expand it again, double-click the SmartObject.
Property Type	The property type for the SmartObject is displayed to the left of the title. For more information on SmartObjects, see the SmartObjects topic. In this example, the ProductName type is text.
Get List Method	In this example, the SmartObject Get List method for the ID property is used to configure the Loop step. With the Get List Method you can select how the interact with items in the SmartObject. You can select between three options: First Item Where... - use this option to perform an action on the first item contained in a selected SmartObject. All items as a collection - use this option to perform an action on all items contained in a selected SmartObject. For information on how to use this option, see How to: Use the All items as a collection option Custom - use this option to perform an action on specific items determined by a custom filter. For information on how to configure the custom filter, see SmartObject Get List Filter. For information on how to use the filter, see How to: Use the custom SmartObject Get List Filter
Load Method	In this example, the SmartObject Load method for the Company property is used to configure the Set Folio step. Drag a SmartObject Load method property from the Context Browser into a SmartField. All available and required properties for the Load method appear in the Configure Section. (In some cases, optional properties or parameters may not appear in the Configure Section, for example when you use SmartObject Load methods based on SharePoint or on SQL stored procedures. To use optional properties and parameters, click the Open Configuration Panel button, and then from the Properties tab, click Add for the properties or parameters you want to use. If there aren't any optional properties or parameters, the Open Configure Panel button is not available.)Example of a SharePoint based SmartObject In this example, you integrate a custom list with K2 for SharePoint and create a SmartObject and a workflow. Open the workflow and drag a Set Folio step onto the canvas. Open the Context Browser and select the SmartObject tab. Browse to the SharePoint site and the list you created. From Get List Item By Title, drag the Version property of a Get List Item By Title load method into the Set Folio field. The SmartField Composer opens. The required SmartObject properties show in the Configure Section. To add optional properties or parameters, click Open Configuration Panel followed by the Add icon as shown here.

For more information on SmartFields and how to use it in a working scenario, see the How to: An example of using the Context Browser topic.

For more information on how to use the All items as a collection option when configuring SmartObjects within the Smartfield Composer, see the How to: Use the All items as a collection option topic.