12.01.2014 Views

Software Manual Freedom EVOware Standard 2.3 Freedom ...

Software Manual Freedom EVOware Standard 2.3 Freedom ...

Software Manual Freedom EVOware Standard 2.3 Freedom ...

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

15 - Script Commands<br />

Import Variable Command<br />

To read a value for one of these variables from the import file, select the variable<br />

and click Add. This moves the variable to the Import list. Repeat this process to<br />

import more variables.<br />

Import list<br />

This list shows all of the variables whose values you want to import. Make sure<br />

that the import file contains values for all of the variables which you want to<br />

import. Select an entry and click Up or Down to re-arrange the order of the<br />

variables in the list. The order of the variables in the list must match the order of<br />

the fields in the import file (see below).<br />

To remove a variable from the import list, select the variable and click Remove. If<br />

the variable is a pre-defined variable, it is moved back to the Currently defined<br />

variables list. If the variable is a newly created variable, it is deleted.<br />

Select file to import<br />

Specify the name and full path of the import file or click Browse and choose an<br />

existing file. The import file can be either a comma-separated text file (.txt or<br />

.csv) or an Excel file (.xls). The import file type is determined automatically<br />

from the filename extension which you specify.<br />

Read specified line<br />

Check this checkbox and specify a line number to import the values from a<br />

specified line of the import file. By default, the values will be imported from line<br />

1. If the import file has a header, the header is not included in the line count.<br />

Start in specified column<br />

Check this checkbox and specify a column number to import the values<br />

starting at a specified column of the import file. By default, the values will be<br />

imported starting at column 1.<br />

File contains header<br />

Check this checkbox if the file contains a header with the names of the<br />

variables to import.<br />

Import file examples with and without header<br />

Text file without header and values for one string variable and one numeric<br />

variable:<br />

“myprompt”,2<br />

Text file with header and values for one string variable and two numeric variables:<br />

prompt2,counter1,counter_2<br />

“myprompt”,2,50<br />

Text file with header and three sets of values for one string variable and one<br />

numeric variable:<br />

prompt2,counter1<br />

“myprompt”,2<br />

“hello”,25<br />

“goodbye”,42<br />

If the import file has a header, it is used to determine which value should be<br />

imported to which variable. An error message will be output during script runtime if<br />

any of the variable names in the import list cannot be found in the header.<br />

If the import file does not have a header, the values are processed from left to<br />

right. The value in the first field (Excel: column) is written to the first variable in the<br />

import list and the value in the second field is written to the second variable in the<br />

import list, etc.<br />

<strong>Freedom</strong> <strong>EVOware</strong> <strong>Software</strong> <strong>Manual</strong>, 393172, en, V<strong>2.3</strong> 15 - 105

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!