Creating and Editing Steps

Navigate to VoiceForm Editor > VoiceForms page.
Click the appropriate action link.
- For a new step, click Create new step.
- To create a new step from an existing step, select the step and click Copy selected step.
- For an existing step, select the step and click Edit selected step.
Complete the required fields, and click Create step or Save changes.

The prompt type of a step cannot be modified if that step is referenced by another step's condition statement or display options. Also, the list item group (Items Key field) of a multiple list selection step cannot be changed if that step is referenced elsewhere.

Create Step Window

Step ID

Unique identifier for the step.

Description

Description of the step used to identify it for GUI users. Enter up to 90 characters.

Define a key within the help message text that acts as a variable for specific values that you define for each instance of the step in a plan. Use the format: {keyname}

Prompt

Phrase that is spoken to the technician to prompt for an inspection response.

Define a key within the prompt text that acts as a variable for specific values that you define for each instance of the step in a plan. Use the format: {keyname}

Help Message

Phrase that is spoken by the device when the technician issues the "details" command.

Prompt Type Tab

Prompt Type

A selection that determines which kind of prompt is used for the step.

Choose a prompt type from the drop-down menu based on the nature of the expected response from the technician.

Prompt Template

Allows you to select a prompt template. If None, enter the Prompt Type and Parameters.

If you choose Prompt Template, the Prompt Type and Parameters will be viewable but can not be edited from this screen.

Parameters

Each prompt type has a set of parameters that define aspects of the allowed responses for the step.

See Building Prompts for details on each prompt type and associated parameters.

Conditions Tab

From the Conditions tab, condition statements can be created or associated with an inspection step. A condition or combination of conditions determines if that step should be performed. The system evaluates multiple condition statements by combining them logically with AND operators.

If all conditions are true, the device prompts the technician for a response to the step.
If any condition is false, the device skips this step.
If step conditions cannot be evaluated, the device prompts the technician.
Note that the same step in different VoiceForms can be defined with different conditions.

See Defining Conditions for guidance on building condition statements. See also Rules for Step Dependencies for more rules affecting condition statements.

Conditions

Conditions are one or more selections that determine if the step should be performed.

Choose a condition from the drop-down menu. The selected condition displays above the menu. Select additional conditions in the same manner.

Condition statements that reference the current step do not appear in the drop-down menu.

To delete a condition statement from the step definition, click on the condition then click the button to the right of the entry.

Display Options Tab

VoiceCheck offers a web-based display for voice prompts so that technicians can view step details like items in multiple list selection prompts, as well as images associated with the inspection material or additional messages for that specific step. When building prompts and setting conditions for a step, also set additional display options.

Display ID

This field is typically used to display the details of a step referenced in a condition statement.

Select the step ID of a reference step to display that step while the technician is performing the dependent step.

Image URL

This field contains a file path selection that enables you to select images uploaded from Managing Images to the step.

Click Choose File and navigate to the file you want to attach to the image.

The file names cannot have spaces.

Cloud customers cannot access the file system and will have to request that Honeywell upload images for them.

Additional Display Message

A text message that is displayed during the current step if a display device is used while processing the inspection assignment. Enter the free-form text in this field.

This message is not spoken by the device to the technician.

Example:

Device: "Check windshield washer fluid level"

Display: [Showing Check Washer Fluid step]

Technician: "Fail"

Device: "Fill washer fluid reservoir"

Display: [Still showing Check Washer Fluid step] Shows additional display message, "Fill with Super Tech Washer Fluid to just below top edge of reservoir."

Technician: [after filling reservoir] "Ready"

Reference Link

This is the label text to be displayed when a step is to contain a URL. Add the URL in the Reference URL text box.

Reference URL

This is the URL that is to be displayed as a link in the step. The URL can be a link that provides the user additional information to complete the step. Use the Reference Link text box for a descriptive label for the URL.

How URLs work:

The URL is displayed as a link in the app.
When a user clicks on the URL, the URL is opened in the default browser. If there is no browser on the device, the app remains on the screen and work can continue.
The application continues to listen for voice commands. If the user would like to suspend the application while reviewing the reference link, the user should raise their microphone.

Dependent Steps Tab

The Step ID field on this tab lists any steps that have been configured with conditions or display options that reference the step you are editing.

Deleting Steps

Authorized users can delete VoiceForm steps by selecting one or more steps in the bottom table on the VoiceForms page and clicking the Delete selected steps action link.

A step cannot be deleted if it is referenced by another step in a condition statement or display ID.