TestIT:Guide

9. Guide

The guide service allows you to see the guide in setup. In the first section, a guide workflow is shown.

An overview of the guide:

Options:

Home - go back to the home page
Add guide - add a new guide

9.1 Guide workflow

The figure below shows the general guide workflow.

Workflow

Explanation of the steps:

Steps
START	Starting a guide can be done in two ways; - Internal - External
GUIDE STEP	There are different types of guide steps
OK	The OK step can be any step in the guide. The action can be: - OK button pressed - OK I/O set
NOK	The NOK step can be any step in the guide. The action can be: - NOK button pressed - NOK I/O set - Next validation fails
BACK	The back step can be any step in the guide. The action will be a Back button pressed.
GUIDE STEP (last)	The OK of the last guide step, depends on which guide is running. - Internal is going to close after the last step. Set the OK step to a guide number, NOT in the guide. - External is going to start over after the last step. Set the OK step to the appropriate guide step. - External is going to close after the last step. Set the OK step to a guide which tells the user to close the guide.

9.1.1 Guide step flow

The figure shows an overview of a guide step flow, like where the validation of the workflow is:

Guide step flow

Explanation of the flow:

Flow
INIT VALIDATION	Before opening the guide step, the init validation is running. - If the validation is OK, the guide step will open - If the validation is not ok, the init validation NOK step will be opened
GUIDE STEP	The actual guide step is opened
RELEASE VALIDATION	The release validation is running while the step is open. - If the validation is OK, the OK button will be released - If a next release I/O is selected, it will be set on validation OK - If a validation success message is set, this will be shown on validation OK
NEXT VALIDATION	If OK button is pressed or OK I/O set, the next validation will be running - If a timer is set, it will start - If the validation is OK, the next guide step will open - If not, the validation will keep running for the timeout period - If the timeout runs out, the timeout message will be shown or the timeout step will be opened

9.2 Add guide

Press Add guide
Write a guide name (maximum 100 characters)
Write a description (optional)
Press OK – or Cancel and the new guide will not be created

After the guide is created, it will be shown in the guide overview.

9.3 The guides

When a guide is selected, it will give an overview with details, and there are some options to choose from:

Run external
Edit guide
Copy guide
Delete guide
Language

Run external:

Press this button and it will run a guide external, which means that it will show how the guide will run in the production. When a guide is running it is using the configurated steps, which is added to the wanted guide.

Edit guide:

Select the wanted guide
Press Edit
Make the wanted changes (see some options below)
Press Save – or Close and the changes will not be saved

Options in edit:

Description – Write a description off the guide
Add step – Steps to the test

Copy guide:

Select the wanted guide
Press Copy
Write the new guide name
Press OK – or Cancel and the copy will not be saved

Delete guide:

Select the wanted guide
Press Delete
A box will be shown; press Yes to accept or No if not

Language – Add, edit, and delete:
Override the standard language, and add culture specific text and images – and still keep the functionality.

Select the wanted guide
Press Language; here it is possible to see the active language(s)
Now there are some options:
1. Add:
  1. Select Create on the wanted language
  2. Fill in the empty areas; what the new “name” is
  3. Press OK - or Cancel and the language will not be saved
2. Edit:
  1. Select edit on the wanted language
  2. Make the wanted changes
  3. Press OK - or Cancel and the changes will not be saved
3. Delete:
  1. Select Edit on the wanted language
  2. Press Delete and the language is deleted

9.4 How to run a guide

A guide in TestIT is a way to show a sequence of steps, including full TestIT functionality. This can be used for, for example:

Standard Operation Procedures (SOP)
Assembly lines
Step by step guidance
Leak tests

Starting a guide can be done internal and external.

9.4.1 Internal

Running a guide internally means that a window will be opened in front of the production view. This internal guide can only be started from a code.

How to run the internal guide?

Go to programming
Create a program or select an existing one
In the code window, write or select the code for the internal guide
Now there are more options:
1. Press Debug to test if it is working
2. Go to production
  1. Select a product
  2. Press Start and the production will run
  3. The guide will be shown in a window in front of the production window

For a code example and parameters, click here and look at "StartInternal".

9.4.2 External

Running a guide externally means that a new window will be opened in front of the production view. This external guide can be started from a code or from a button in the guide. When it is running from the button, it is used to show how the added steps work. NB! This guide can only run if a product is connected.

How to run the external guide?

Go to programming
Create a program or select an existing one
In the code window, write or select the code for the external guide
Go to production
1. Select a product
2. Press Start and the production will run
3. The guide will be shown in a new window in front of the production window

For a code example and parameters, click here and look at "StartExternal".

9.5 Guide steps

9.5.1 Step type

The step type is found in the first section named step. When a step is created, press Save – or Cancel and the step will not be saved.

9.5.1.1 Standard

This is the standard guide step with header, text, image, buttons, and all configuration options.

An example/Instruction:

Write the step number
Select the standard step type
Select an image
Write the value of the OK button text (e.g. OK), and the NOK button text (e.g. Cancel)
Press Save

9.5.1.2 Scan

This is the standard functionality and a scan section. If the step type is scan, the OK button is set to go to next.

Configuration:

Scanned value – select a symbol name from the list
Go to next on scan – select Yes or No

9.5.1.3 Unique ID

This is a step which runs in the background. It will use a unique ID device to set a string symbol. It will also have the option to set the value as object ID in the running guide. If object ID is selected, then max 50 characters.

Configuration:

Write the unique ID
Select the symbol
Mark ‘set as object ID’, if it is wanted

9.5.1.4 Scan Object ID

This is the standard functionality and a scan section. The scanned value will be set as object ID in the running guide, so max 50 characters

Configuration:

Scanned value – select a symbol name from the list
Go to next on scan – select Yes or No

9.5.1.5 Action

This is a step which runs in the background. It will execute commands from the top down. If the order should be changed, just drag the command up or down. Add action steps on the green plus or delete them on the red cross.

Commands:

Commands
Set	Value A will be set
Reset	Value A will be reset
Move	Value C will be moved to Value A (only numbers)
StringMove	Value C will be moved to Value A (only strings)

9.5.1.6 Print

This is a step which runs in the background and will use a printer device. Just select a printer.

9.5.1.7 Stored procedure

This is a step which runs in the background and will use a MSSQL device. Just select a stored procedure.

9.5.1.8 Multi edit

The multi edit step uses a text file to generate several buttons or text areas.

Configuration:

Select:
1. Number of columns
2. File device (folder device)
3. Element type (see element type)
4. File name
5. Input front size
6. Input max width
7. If textbox is only for reading – Yes or No
8. Element height
9. Press load text file
10. Now it is possible to add, edit, and remove elements (see element configuration below)

Element type:


Single Select	Hide textbox, but show button on/off (only number symbols). It will go to next when button is selected.
Multi Select	Hide textbox, but show button on/off (only number symbols).
Multi Edit	Show the textbox, with options to enter text.
Button add	Show the textbox, with option to add (only number symbols).
Button minus	Show the textbox, with option to subtract (only number symbols).
Button add/minus	Show the textbox, with option to add or subtract (only number symbols).

Element configuration:

Enter
1. A value to use in the element
2. A text to use in the element
3. A tooltip to use in the element
Select a symbol to (NB! If a symbol is selected, it will override the element)
1. The value
2. The text
3. The tooltip

9.5.1.9 Leak device

It is a specialized step to run a leak test device. Currently supported is Nolek S9 and Nolek S10.
It will use a leak test device and execute a defined recipe, and will show the entire measurement on the screen.

Configuration:

Setup section
1. Select the leak testing device to use
2. Select a symbol with recipe name – a sting symbol which will contain the recipe name
Run section
1. Select the start action
  1. If automatic, the leak device will start as soon as the step is loaded
  2. If not, wait for a button to be selected in TestIT
2. Select timeout – An INT symbol containing the number of seconds to set as timeout for the measurement
3. Select activate control leak, which means it will show if it will be possible to show a mistake
Done section
1. Select yes or no if it should continue when it is done
  1. If yes, the guide will continue to the next step when the measurement is done
  2. If no, the step will wait for an OK action

9.5.1.10 Standard with symbols

The same as the standard setup, but with this step type it is possible to select a symbol which makes it possible to change the text while the production is running.

9.5.1.11 Password scan

This is the same as the step type scan, but this is with a password. The text written in the space is not shown while it is written.

9.5.2 Step configuration

9.5.2.1 Step


Configuration name	Description
Step number	The ID number of the step. Must be unique within the guide
Step type	Select a step type
Image	Select between the images in the assigned image folder

9.5.2.2 Next step


Configuration name	Description
OK	Enter the step number of the next step if the OK action is run
OK button text	The text on the OK button. If no text, the button is hidden
OK I/O	Select a symbol to use in the OK action
OK I/O value	Select a symbol, wich value will be used in the validation of the OK action
OK Validation type	Select the OK validation types
NOK	Enter the step number of the next step if the NOK action is run
NOK button text	The text on the NOK button. If no text, the button is hidden
NOK I/O	Select a symbol to use in the NOK action
NOK I/O value	Select a symbol, wich value will be used in the validation of the NOK action
NOK Validation type	Select the NOK validation types

9.5.2.3 Go back


Configuration name	Description
Can go back	Select if the step will be able to go back to a specified step
Go back step	Step to go back to
Back button text	Text on the back button. If no text, the button is hidden
Go Back I/O	Select a symbol to use in the Go Back action
Go Back I/O value	Select a symbol, wich value will be used in the validation of the Go Back action
Go Back Validation type	Select the Go Back validation types \|

9.5.2.4 Init validation

9.5.2.5 Release validation

9.5.2.6 Next validation

9.5.2.7 Scan

9.5.2.8 Timer

9.5.3 Validation types

TestIT:Guide

Contents

9. Guide

9.1 Guide workflow

9.1.1 Guide step flow

9.2 Add guide

9.3 The guides

9.4 How to run a guide

9.4.1 Internal

9.4.2 External

9.5 Guide steps

9.5.1 Step type

9.5.1.1 Standard

9.5.1.2 Scan

9.5.1.3 Unique ID

9.5.1.4 Scan Object ID

9.5.1.5 Action

9.5.1.6 Print

9.5.1.7 Stored procedure

9.5.1.8 Multi edit

9.5.1.9 Leak device

9.5.1.10 Standard with symbols

9.5.1.11 Password scan

9.5.2 Step configuration

9.5.2.1 Step

9.5.2.2 Next step

9.5.2.3 Go back

9.5.2.4 Init validation

9.5.2.5 Release validation

9.5.2.6 Next validation

9.5.2.7 Scan

9.5.2.8 Timer

9.5.3 Validation types

Navigation menu

Search