Size Operator

Overview                                                    

The Size operator  performs one of two functions in a Data Workflow:

• Returns the number of characters in a string.

• Returns the number of elements in an array.

You'll find the Size operator in the Table group to the left of the Data Workflow canvas.

About the Info Window

Here's a breakdown of the operator's Info window:

Adding  a Size Operator

First, configure a couple of Text Field components to collect your end-user's name and display the result of the Size operator. Then, set up a Data Workflow to return the number of characters in the entry.

These instructions assume that you have a new module open, saved, and with a title.

Configure the Text Field Components

Begin by configuring two Text Field components. The first Text Field component is an input field for your end-user. The second Text Field component displays the result after the data passes through the Data Workflow. To prevent the end-user from adjusting the value of the second Text Field component, you'll select Disable User Input from the Input Behavior setting.

1. In the Module Builder, drag and drop two Text Field components onto your canvas.

2. In the Property ID and Label Text fields, enter the following:

   Property ID	Label Text
   name	Name
   characters	Number of Characters

   From the Input Behavior drop-down, select Disable User Input for the characters Text Field component.

3. Click Save Component after configuring each component.

Configure the Data Workflow Component

Next, configure a Data Workflow component, to bring data from your name Text Field component into the Data Workflow using an Input operator. Then, add a Size operator to determine the number of characters in the name field. Lastly, you'll send the final result to the characters field using an Output operator.

1. Drag and drop a Data Workflow component onto your canvas, placing it  below your Text Field components.

2. In the Property ID field, enter dwfSize.

3. In the Canvas Label Text field, enter dwfSize.

Configure the Input Operator

1. Drag and drop an Input operator onto your Data Workflow canvas.

2. Configure the operator's Info window as follows:

   Info
   Category	Input
   Component	name
   Required	Yes
   Source	Default

Configure the Size Operator

1. Drag and drop a Size operator onto your Data Workflow canvas.

2. Configure the operator's Info window as follows:

   Info
   Category	Size
   Label	Number of Characters

3. Connect the output port (right) of the name Input operator to the input port (left) of the Number of Characters Size operator.

Configure the Output Operator

This operator sends the Size operator's value to the characters Text Field component.

1. Drag and drop an Output operator onto your Data Workflow canvas.

2. Configure the operator's Info window as follows:

   Info
   Category	Output
   Component	characters
   Action	value

3. Connect the output port (right) of the Number of Characters Size operator to the input port (left) of the characters  Output  operator.

4. Click Save Component.

5. Save your module.

Here's how the completed Data Workflow looks:

Your completed module looks like the following:

Preview your module in Express View and enter a name in the Name field. Notice how the Size operator returns the character count in the Number of Characters field.