Standard Library
Inhaltsverzeichnis
- 1 Introduction
- 2 Numbers
- 3 Assertions, Exceptions & Logging
- 4 Collections
- 5 Compare
- 6 Data Generators
- 7 Data Types
- 8 Files & Directories
- 9 GUI-Dialogs
- 10 Images
- 11 Logic
- 12 Misc
- 13 Networking & Interfacing
- 14 OS
- 15 String Processing
- 16 Stream Input/Output
- 17 Time & Date
- 18 Tools
- 19 Type Conversion
- 20 Variables
Introduction[Bearbeiten]
The StandardLibrary contains general domain-independent function blocks. These are useful for any kind of test-development.
One of the features which make the StandardLibrary very flexible is the dynamic type system of the underlying implementation language. This allows for the blocks to handle a wide range of possible input values. For example, arithmetic blocks ("Arith [ * ]") all allow for Integers, Floats, LargeIntegers, Fractions, FixedPoint-Decimals and Measurement Values to be used as input (where appropriate). And most of the collection blocks ("Collection [ * ]") can deal with Strings, ByteArrays, Buffer-Data, Arrays, OrderedCollections, Tuples, SortedCollections, Sets, HashTables (Dictionaries) and other collection types. Without such a dynamic type system, many more blocks would be needed for a comparable set of functions (see IEC1131, for example, which uses a similar execution model, but a static type system).
The automatic type conversion between Integer and LargeInteger (whenever a value cannot be represented within 32bit) and vice versa, and the automatic conversion of a quotient to a Fraction and the reduction back to an Integer avoid rounding errors and loss of precision.
Numbers[Bearbeiten]
Arithmetic[Bearbeiten]
- Arith [ Sum ]
Sum of its numeric input values. - Arith [ SumN ]
Sum of its numeric input values (more input-pins available). - Arith [ Sum+ ]
Sum of its numeric input values (arbitrary number of input pins) (2.3.0) - Arith [ Distance ]
Absolute value of difference of its numeric input values. - Arith [ Difference ]
Difference of its numeric input values. - Arith [ Difference+ ]
Difference of its numeric input values (arbitrary number of input pins) (2.3.0). - Arith [ Product ]
Product of its numeric input values. - Arith [ Product+ ]
Product of its numeric input values (arbitrary number of input pins) (2.3.0). - Arith [ Quotient ]
Quotient of its numeric input values. - Arith [ Modulu ]
Remainder from dividing its numeric input values. - Arith [ Square Root ]
The square root. - Arith [ RaisedTo ]
Raising x to the n'th power. n max be a fraction (for roots). - Arith [ Ln ]
The natural logarithm (base e). - Arith [ Lg ]
The logarithm base 10. - Arith [ Ld ]
The logarithm base 2. This could also be computed as: ln(input) / ln(2) (1.7.2). - Arith [ Min ]
Minimum of its numeric input values. - Arith [ Max ]
Maximum of its numeric input values. - Arith [ MinMax ]
Both Minimum and Maximum of its numeric input values (1.7.1). - Arith [ Negated ]
Negates its numeric input value. - Arith [ Abs ]
Returns the absolute value of its numeric input value. - Arith [ IsEven? ]
True if the input is even (divisible by two) (1.7.1). - Arith [ IsEvenOrOdd? ]
Provides the input number at one of its two outputs, depending on the input's divisibility by two. - Arith [ IsPositive? ]
True if the input is >= 0 - Arith [ IsNegative? ]
True if the input is < 0 - Arith [ IsPositiveOrNegative? ]
Pass the input number to one of two outputs depending on wether it is >=0 or <0. - Arith [ Sign? ]
Pass the input number to one of three outputs depending on wether it is >0, =0 or <0. (1.7.2). - Arith [ Signum ]
The signum (-1, 0 or 1) of the incoming number. (1.7.2). - Arith [ Ceiling ]
The ceiling (integer above) of the incoming number. - Arith [ Floor ]
The floor (integer below) of the incoming number. - Arith [ Round ]
The incoming number rounded to the nearest integer. (1.7.1). - Arith [ RoundTo ]
The incoming number rounded to the nearest multiple of the rounding value. (1.7.1).
Bit Manipulation[Bearbeiten]
- Arith [ HighBit ]
The bitNumber of the highest bit (1.7.2). - Arith [ LowBit ]
The bitNumber of the lowest bit (1.7.2). - Arith [ LeftShift ]
BitShift to the left (1.7.2). - Arith [ RightShift ]
BitShift to the right (1.7.2). - Arith [ BitAnd ]
The bitwise AND of the two integral input values.(1.7.2). - Arith [ BitOr ]
The bitwise OR of the two integral input values. (1.7.2). - Arith [ BitXor ]
The bitwise XOR of the two integral input values. (1.7.2).
Trigonometric[Bearbeiten]
- Arith [ Sin ]
The sine of x. - Arith [ Cos ]
The cosine of x. - Arith [ Tan ]
The tanges of x. - Arith [ ArcSin ]
The arcsine of x. (1.7.1). - Arith [ ArcCos ]
The arccosine of x. (1.7.1). - Arith [ ArcTan ]
The arctangens of x.(1.7.1). - Arith [ E ]
The euler constant E. (2.71828...). - Arith [ Pi ]
The constant Pi. (3.14159...).
Misc Math[Bearbeiten]
- Arith [ IsPrime? ]
Provides the input number at one of its two outputs, depending on the primeness of the input. (1.7.2). - Arith [ IsPrimeOrNot? ]
Provides the input number at one of its two outputs, depending on the primeness of the input. (1.7.2). - Arith [ Binomial Coefficient ]
Return the number of choices to take k elements from a collection of n elements (Choose k from n). - Arith [ Fibonacci ]
Return the n'th fibonacci number (n >= 1).
- Arith [ Factorial ]
Factorial of its integral input value.
Modulu Arithmetic[Bearbeiten]
- Arith [ 32bit Sum ]
Sum in 32 bit number range (1.7.3) - Arith [ 32bit Difference ]
Difference in 32 bit number range (1.7.3) - Arith [ 32bit Product]
Product in 32 bit number range (1.7.3)
Assertions, Exceptions & Logging[Bearbeiten]
- FAIL
Report a Failure. This means, that the system under test failed a test. - FAIL2
Report a Failure. This means, that the system under test failed a test. Optionally decorate the failure-message with pre-/postFix string. - ERROR
Report an Error. This means, that something unexpected (an error) occured in the expecco test suite itself. The test suite must be fixed. - ERROR2
Report an Error. Optionally decorate the error-message with pre-/postFix string. - INCONCLUSIVE
Report an Inconclusive state. This means, that we cannot tell, what the test result is. - INCONCLUSIVE2
Report an Inconclusive state. Optionally decorate the message with pre-/postFix string. - PASS
Report a Successful Test. This means, that the system under test passed the test. - PASS2
Report a Successful Test. Optionally decorate the pass-message with pre-/postFix string. - OK
Finish the current Activity and mark it as successful. - OK2
Finish the current Activity and mark it as successful. Optionally decorate the success-message with pre-/postFix string. - HALT
Stop end enter the debugger, but only if halts are not ignored in the settings.(1.9.1). - PAUSE
Same effect as pressing the "Pause"-button: pauses the executor. Press "Run" or "Single Step", to continue (1.9.1).
Logging & Messages[Bearbeiten]
Adding Log Entries[Bearbeiten]
- Log [ Failure ]
Report a Failure Message in the Log AND set the outcome to FAILED - Log [ Failure & Details ]
Report a Failure Message with Details. - Log [ Warning ]
Report an Warning Message. Optionally decorate the failure-message with pre-/postFix string. - Log [ Warning & Details ]
Report an Warning Message with Details. - Log [ Info ]
Report an Info Message. Optionally decorate the failure-message with pre-/postFix string. - Log [ Info & Details ]
Report an Info Message with Details. - Log [ Screendump ]
Report an Info Message and attach a screen dump of the whole screen. - Log [ Screendump Area ]
Report an Info Message and attach a screen dump of a screen area. - Log [ Screendump to File]
Report an Info Message and save a screen dump of the whole screen at a given path. - Log [ Screendump Area to File]
Report an Info Message and save a screen dump of a screen area at a given path.
Info Messages[Bearbeiten]
- Information Message
Show some message in the browser's info area (at the bottom). Useful to provide some progress-feedback to the test-operator. Notice: these messages are not persistent in the generated log report. (in contrast to the Log* blocks) - Transcriber
Displays its input string as a line in the Transcript window. If there is no open Transcript window, a new one will be opened. Useful to provide some feedback to the test-operator. Notice: these messages are not persistent in the generated log report. (in contrast to the Log* blocks) - Transcriber without CR
Displays its input string in the Transcript window like the transcriber, but does not generate a newLine at the end. If there is no open Transcript window, a new one will be opened. Useful to provide some feedback to the test-operator. Notice: these messages are not persistent in the generated log report. (in contrast to the Log* blocks) - Show Transcript Window
Ensure that a transcript window is visible. If there is no existing Transcript window, a new one will be opened. - Hide Transcript Window
Ensure that a transcript window is invisible (iconified). If there is no existing Transcript window, this is a NO-Operation. - Clear Transcript Window
Clears the transcript window. If there is no existing Transcript window, this is a NO-Operation (1.9.1). - Contents of Transcript
Retrieves the contents of the transcript window as a collection of line-strings (1.9.1).
Assertions[Bearbeiten]
- Assert [ Equal ]
Fail if the two input values are not equal. Notice the difference between identity and equality. - Assert [ Not Equal ]
Fail if the two input values are equal. - Assert [ Identical ]
Fail if the two inputs are not identical (the same object). - Assert [ Not Identical ]
Fail if the two inputs are identical (the same object). - Assert [ True ]
Fail if the input value is not true. - Assert [ False ]
Fail if the input value is not false. - Assert [ Value is Less or Equal ]
Fail if the input value is above a given limit. - Assert [ Value is Less ]
Fail if the input value is not below a given limit. - Assert [ Value is Greater or Equal ]
Fail if the input value is less than a given limit. - Assert [ Value is Greater ]
Fail if the input value is not above a given limit. - Assert [ Value in Range ]
Fail if the input value is not in the given min..max range. - Assert [ Value NOT in Range ]
Fail if the input value is in the given min..max range. - Assert [ Value in Set ]
Fail if the input value is not in the given set of allowed values. - Assert [ Value NOT in Set ]
Fail if the input value is in the given set of allowed values. - Assert [ Value arrives at Pin1 ]
Fail if an input arrived at any other than pin1 (can be used that some value arrives definitely via s particular path). - Assert [ Same Collection Contents ]
Fail if the two input collections do not contain the same elements (in the same order) (1.8.1). - Assert [ File Exists ]
Fail if the given filename does not exist (as either file or directory) (1.9.1). - Assert [ File is Directory ]
Fail if the given filename does not refer to an existing folder (1.9.1).
Collections[Bearbeiten]
- Collection [ ElementAt ]
Retrieve an element by its key. - Collection [ ElementAt 0-based ]
Retrieve an element by its numeric key. - Collection [ AddElement ]
Add an element to the collection. - Collection [ RemoveElement ]
Remove an element from the collection. - Collection [ ElementAtPut ]
Store an element by key/value. - Collection [ ElementAtPut 0-based ]
Store an element by key/value. - Collection [ NewDictionary ]
Create a new Dictionary (aka HashTable). - Collection [ NewOrderedCollection ]
Create a new OrderedCollection (dynamic size Vector). - Collection [ NewSet ]
Create a new set. - Collection [ NewSortedCollection ]
Create a new sorted collection. - Collection [ Some Elements ]
Output a slice of some elements copied from the inCollection (1.7.1). - Collection [ First N Elements ]
Output the first N elements of the inCollection. - Collection [ First N existing Elements ]
Output the first N existing elements of the inCollection (1.7.1). - Collection [ All but first N Elements ]
Output inCollection without the first N elements. - Collection [ Last N Elements ]
Output the last N elements of the inCollection. - Collection [ Last N existing Elements ]
Output the last N existing elements of the inCollection (1.7.1). - Collection [ All but Last N Elements ]
Output inCollection without last N elements. - Collection [ Min ]
Get the minimum-element of the collection. - Collection [ Max ]
Get the maximum-element of the collection. - Collection [ MinMax ]
Get both the minimum and the maximum-element of the collection (1.7.1). - Collection [ Size ]
Get the size of the collection. - Collection [ IncludesAll ]
Checks if a collection includes ALL of the given elements. - Collection [ IncludesAny ]
Checks if a collection includes ANY of the given elements. - Collection [ Includes ]
Checks if a collection includes the given element. - Collection [ Copy ]
Passes a copy of the collection to the output pin. - Collection [ Select ElementsMatching ]
Generates a new collection containing all elements which match a given pattern. - Collection [ Select Columns ]
Generates a new collection containing elements with selected columns only. - Collection [ Select/Reject/Collect by ST Expression ]
Generates a new collection containing elements with items selected by Smalltalk expressions. - Collection [ Sort ]
Generates a sorted copy of the input collection. - Collection [ Sort Ignoring Case ]
Generates a sorted copy of the input collection, ignoring case differences when sorting. - Collection [ Enumerate ]
Enumerates the elements of a collection. - Collection [ Enumerate with EndMark]
Enumerates the elements of a collection with an end mark. - Collection [ Enumerate Keys & Values ]
Enumerates the elements of a collection as key & value pairs. - Collection [ Reverse Enumerate ]
Enumerates the elements of a collection in reverse order. - Collection [Average & Deviation]
Computes the average and standard deviation of the elements of a collection. - Data Collector [ OrderedCollection ]
Collects all incoming data and sends it as one OrderedCollection to the output pin. - Data Collector [ Set ]
Collects all incoming data and sends it as a Set to the output pin (1.9.1).
Compare[Bearbeiten]
Many compare blocks come in two versions: one which generates a true/false boolean value (the 1-way blocks) and another, which sends the result to one of two (or three) different outputs. The later are very useful to split the flow of control to different followup blocks (although that behaviour could also be simulated by using a 1-way compare followed by a pass-data block from the "misc" section).
Notice: these blocks allow for Numbers, Strings, Collections and some other types to be compared. However, for the order releation compare operations, the types must be compatible; you cannot mix Numbers with Strings or other there.
- Compare [ 3-Way ]
Sends a boolean "true" value to one of its three outputs: LESS, EQUAL or GREATER.
- Compare [ Equal 2-Way ]
Compare two values for equality; Send the first value to either the triggerYES or the triggerNO output.
- Compare [ Not Equal 2-Way ]
Compare two values for equality; Send the first value to either the triggerYES or the triggerNO output.
- Compare [ Less 2-Way ]
If the input at in1 is less than in2, send it to the triggerYES output. Otherwise, send it to triggerNO.
- Compare [ LessOrEqual 2-Way ]
If the input at in1 is less or equal than in2, send it to the triggerYES output. Otherwise, send it to triggerNO.
- Compare [ GreaterOrEqual 2-Way ]
If the input at in1 is greater or equal than in2, send it to the triggerYES output. Otherwise, send it to triggerNO.
- Compare [ Greater 2-Way ]
If the input at in1 is greater than in2, send it to the triggerYES output. Otherwise, send it to triggerNO.
- Compare [ Equal ]
Generate a true if in1 is qual to the input value2 in2; otherwise, generate a false.
- Compare [ Not Equal ]
Generate true if in1 is not equal to in2; otherwise, generate a false.
- Compare [ Less ]
Generate a true if in1 is less than the input value2 in2; otherwise, generate a false.
- Compare [ LessOrEqual ]
Generate a true if in1 is less or equal than the input value2 in2; otherwise, generate a false.
- Compare [ GreaterOrEqual ]
Generate a true if in1 is greater or equal than the input value2 in2; otherwise, generate a false.
- Compare [ Greater ]
Generate a true if in1 is greater than to the input value2 in2; otherwise, generate a false.
- Compare [ Identical 2-Way ]
Compare two values for identity; Send the first value to either the triggerYES or the triggerNO output.
- Compare [ Not Identical 2-Way ]
Compare two values for identity; Send the first value to either the triggerYES or the triggerNO output.
- Compare [ Same Collection Contents ]
Generate a true if the two input collections contain the same elements (in the same order); otherwise, generate a false (1.8.1).
Data Generators[Bearbeiten]
- Random [ Booleans ]
Produces a number (default: 1) of random booleans on its output. - Random [ Floats ]
Produces a number (default: 1) of random floats on its output. - Random [ Integers ]
Produces a number (default: 1) of random integers values on its output. - Random [ Time Deltas ]
Produces a number (default: 1) of random timeDeltas on its output. - Random [Permutation]
Produces a number (default: 1) of random permutations of the input-collection. - Generate all Permutations
Produces all permutaions of the collection given to its input. - Generate Series
Produces values from an arithmetic series. - Generate Geometric Series
Produces values from a geometric series. - Generate UUID
Generate a new Universally Unique ID (UUID) as defined in RFC4122 - Generate Prime Numbers
Produces a collection of prime numbers. (1.7.2) - Next Prime
Generates the next prime after some number. (1.7.2)
Data Types[Bearbeiten]
Additional Datatypes. No description yet.
Files & Directories[Bearbeiten]
Files[Bearbeiten]
- File [ Directory ]
Extract the directory. - File [ DirectoryName ]
Extract the directory name (i.e. a string). - File [ Contents ]
Get the contents of a file. - File [ BinaryContents ]
Get the binary contents of a file. - File [ ConstructFn ]
Construct a filename from the given components. - File [ ChangeSuffix ]
Construct a filename from the given fileName and a new suffix. - File [ Remove ]
Remove the file named fileToRemove. - File [ Recursive Remove ]
Remove the file/directory named fileToRemove. - File [ NewTempFn ]
Generate a new temporary filename. - File [ NewTempFnIn ]
Generate a new unique temporary filename within a parent directory. - File [ ReadCSV ]
Read a csv file. - File [ Read Key-Value Pairs ]
Read a file and return a dictionary with the keys and values. - File [ Read Key-Value TuplePairs ]
Read a file and return a dictionary with the keys and values.
Queries[Bearbeiten]
- File [ Exists ]
Check, if a file exists. - File [ IsDirectory ]
Check, if a file exists and is a directory. - File [ Basename ]
Extract the baseName (i.e. the name without directory prefix) - File [ Suffix ]
Extract a filename's suffix (i.e. the extension). - File [ FileSize ]
Get the number of bytes in a file. - File [ Size ]
Retrieve a file's size.
Creation[Bearbeiten]
- File [ Copy ]
Copy a sourcePath to a destinationPath. - File [ CreateEmpty ]
Create an empty file. - File [ Create ]
Creates a file, taking the contents from the content input pin.
Directories[Bearbeiten]
- Directory [ Create ]
Creates a directory based on the given filepath. - Directory [ DirectoryName ]
Get the name of a directory. - Directory [ TempDir ]
Get the temp directory (as filename). - Directory [ TempDir Name ]
Get the name of the default temporary directory (as path-string). - Directory [ NewTempDir ]
Create a new temporary directory and provide its name. - Directory [ NewTempDirIn ]
Create a new temporary directory in a given parent directory and provide its name (as Filename). - Directory [ Root ]
Provide the name of the root directory (as Filename). - Directory [ Home ]
Provide the name of the user's home directory (as Filename). - Directory [ Documents ]
Provide the name of the user's documents directory (as Filename). - Directory [ Enumerate ]
Get the contents of a directory - that is all the names found there (non-recursive).
GUI-Dialogs[Bearbeiten]
- Dialog [ Request String ]
Requests a string from the user (via a dialog). - Dialog [ Request Password ]
Requests a password from the user (via a dialog). - Dialog [ Request Filename ]
Requests a filename from the user (via a file-dialog). - Dialog [ Confirm ]
Requests a confirmation (true / false) from the user (via a dialog). - Dialog [ Confirm 2 Way ]
Like above, but provides two separate outputs. - Dialog [ Confirm with Cancel ]
Requests a confirmation (true / false) from the user with an additional "Cancel"-Button. - Dialog [ Confirm with Cancel 2 Way ]
Like above, but provides two separate outputs. - Dialog [ Confirm with Cancel 3 Way ]
Like above, but provides three separate outputs. - Dialog [ Information ]
Show a Dialog with the informationString. - Dialog [ Warning ]
Show a Warn-Dialog with the informationString. - Dialog [ Colored Warning ]
Show a Warn-Dialog with the informationString. - Dialog [ Show Value ]
Show an Information-Dialog to display a value. - Dialog [ Show Table ]
Show a Dialog to display a table.
Inspecting & Debugging[Bearbeiten]
- Inspect
Open an inspector window to show some datums contents. - Show Image
Open an image viewer to show some image. - Edit Image
Open a bitmap editor to allow some limited image manipulations. - Edit Color
Open a color editor (useful to inspect picked web-page colors).
Support[Bearbeiten]
- Color [ By Name ]
Return a color object, given a color name (such as 'red', 'green' or 'blue') - Color [ By RGB ]
Return a color object, given a rgb bytes (red, green, blue) - Color [ By HLS ]
Return a color object, given hue (in degrees from 0..360), light (0..1) and saturation (0..1). - Color [ Get RGB ]
Return a colors red/green/blue byte values. - Color [ Get HLS ]
Return a colors hue/light/saturation byte values. - Color [ Brighter ]
Return a brightened color (blended with white). - Color [ Darker ]
Return a darkened color (blended with black).
Images[Bearbeiten]
- Image [ Screendump ]
Take a snapshot of the screen (1.7.2) - Image [ Screendump Area ]
Take a snapshot of a part of the screen (1.7.2) - Image [ From File ]
Read a Bitmap Image File (1.7.2) - Image [ From Data ]
Read a Bitmap Image from Data (1.7.2) - Image [ Save as File ]
Save a Bitmap Image File (1.7.2) - Image [ Get Attributes ]
Get Attributes of a Bitmap Image File (1.7.2) - Image [ Magnify ]
Magnify or Shrink an Image (1.7.2) - Image [ Rotate ]
Rotate an Image (1.7.2) - Image [ Convert to Greyscale ]
Convert an Image to Greyscale (1.7.2) - Image [ Convert to Depth24 ]
Convert an Image to a depth-24 image (1.9.1) - Image [ Fetch via HTTP ]
Fetch a Bitmap Image via HTTP (1.7.2)
Logic[Bearbeiten]
- Logic [ Not ]
Output the negated boolean input value. - Logic [ IfTrueIfFalse ]
If the boolean input value is true, trigger triggerTrue, else trigger triggerFalse - Logic [ And ]
Output TRUE if both boolean inputs are true. - Logic [ Or ]
Output TRUE if one of the boolean inputs is TRUE. - Logic [ Xor ]
Output TRUE if both boolean inputs have different values.
Misc[Bearbeiten]
- START
Does nothing, can be used with autostart as a trigger.
- JOIN
When ALL inputs are available, continue.
- Data Sink
Consume (and throw away) any data from the input pin.
- Data Source
Pass its input to its output. Can be used to start a dataflow, if the input is frozen and the block is triggered via autoStart or the START node above.
- Which Pin has Data
Delivers info from where some datum came (1.9.1).
- Got at least one Value?
To check if some data arrived at a pin (1.9.1).
- Input Pin has Value?
To check if some data arrived at a pin (1.9.1).
- Pass Data if True
Used to conditionally pass data along a connection or to block/throw it away in other situations.
- Pass Data if False
Used to conditionally pass data along a connection or to block/throw it away in other situations.
- Pass Data if True/False
Used to conditionally pass data along one of two alternative connection pathes.
- If True/False (2 way)
Passes the incoming boolean to one of two outputs (split execution path) (1.9.1).
- Either - Or
Passes one of two input values to the output (1.9.1).
- Distribute (Load Balancer)
Sends the incoming value to the output with the smallest waiting queue size (1.9.1).
- Wait Forever
Simply waits forever.
Expecco Reflection[Bearbeiten]
These provide info about the state of the tool and execution engine.
- Directory [ Projects Directory ]
Provides the project directory (that is the root of where attachments, temporary files etc. are located)
- Directory [ Attachment Directory ]
Provides the attachment directory (that is where attachments are located)
- Directory [ Executors Directory ]
Provides the execution directory (that is where temporary files are created)
- Directory [ ProjectFile Path]
Retrieves the pathname to the current projectfile (the ".ets"-file) (1.7.4)
- Control Window [ IsOpen ]
This block returns true, if a Control & Monitoring window is currently open.
- Name of Current Testplan
This block provides the name of the currently executing testplan (1.7.3).
- Name of Current Testcase
This block provides the name of the currently executing testcase (1.7.3).
- Start Time of Current Testplan
This block provides the startTime of the currently executing testplan (Timestamp) (1.9.1).
- Start Time of Current Testcase
This block provides the startTime of the currently executing testcase (Timestamp) (1.7.3).
- Current Testplan
This block provides a handle to the currently executing testplan (1.9.1).
- Current Testcase
This block provides a handle to the currently executing testcase (1.9.1).
Reporting[Bearbeiten]
- Report [ Generate ]
Generates a report in a specified format for the currently running test execution (1.7.2).
- Report [ Generate PDF File ]
Generates a report in PDF format for the currently running test execution (1.7.2).
- Report [ Generate HTML File ]
Generates a report in HTML format for the currently running test execution (1.7.2).
Virtual to Concrete Mapping[Bearbeiten]
- Local Specify Concrete Block
Setup a local Virtual-to-Concrete mapping for a single virtual block (1.7.4).
- Local Specify Concrete Library
Setup a local Virtual-to-Concrete mapping for a complete virtual library (1.7.4).
- Global Specify Concrete Block
Setup a global Virtual-to-Concrete mapping for a single virtual block (1.7.4).
- Global Specify Concrete Library
Setup a global Virtual-to-Concrete mapping for a complete virtual library (1.7.4).
- Executor Specify Concrete Block
Setup a Virtual-to-Concrete mapping for a single virtual block which is valid in the current testCase only (1.7.4).
- Executor Specify Concrete Library
Setup a Virtual-to-Concrete mapping for a complete virtual library which is valid in the current testCase only (1.7.4).
Resources[Bearbeiten]
- Get Resource by ID
Retrieve an already aquired resource, given a skill-id (1.7.4).
- Get Name from Resource
Retrieve a resource's name (1.7.4).
- Get Skill Attribute from Resource
Retrieve a skillAttribute's value from a resource (1.7.4).
- Get all Resources from Top Inventory
Retrieve the collection of all available resources (1.9.1).
Networking & Interfacing[Bearbeiten]
- Net [ IPAdress ]
Retrieve a hosts TCP/IP address. - Net [ LocalIPAdress ]
Retrive the machines own IP Address.
Checksums & Cryptography[Bearbeiten]
- Hash [ MD5 ]
Computes the MD5 checksum of a block of bytes (1.7.2) - Hash [ SHA1 ]
Computes the SHA1 checksum of a block of bytes (1.7.2) - HASH [ CRC32 ]
Computes a crc32 checksum (1.7.2)
FTP[Bearbeiten]
- T_FTPLink
This datatype represents the ftp-client object. - FTP [ Connect-E]
Crate a ftp-connection. - FTP [ Get-E ]
Get a file via ftp, and store it local. - FTP [ Put-E ]
Put a local file via ftp to the remote destination. - FTP [ Close-E ]
Close a ftp-connection. - FTP [ Delete-E ]
Delete a file via ftp on the remote site. - FTP [ Put ]
Create ftp-connection - Put file - Close connection. - FTP [ Get ]
Create ftp-connection - Get file - Close connection.
HTTP[Bearbeiten]
- HTTP [ FetchPage ]
Fetches a page and provides the fetched document both as text and (optionally, if the output is connected) a tree of HTML-element nodes. - HTTP [ Get ]
Same as above, for readability. - HTTP [ Post ]
Generates a POST request (form submit). - HTTP [ ParseDocument ]
Parse a string to an html-document. - HTTP [ Extract by Tag ]
Extracts specified nodes from a parsed document. - HTTP [ ExtractLinks ]
Extracts all anchor nodes (<A>-links) from a parsed document. - HTTP [ ExtractImages ]
Extracts all image nodes (<IMG>) from a parsed document. - A [ HREF ]
Extracts the HREF-url from an anchor element. - IMG [ SOURCE ]
Extracts the IMG-source from an img element.
Server[Bearbeiten]
- HTTP [ StartServer ]
Start an HTTP server on a given port. - HTTP [ StopServer ]
Stop an HTTP server. - HTTP [ Add Default Home Service ]
Add a default service to an HTTP server. - HTTP [ Add File Service ]
Add a file service to an HTTP server.
IMAP[Bearbeiten]
- IMAP [ CreateConnection ]
Connect to an IMAP mail server. - IMAP [ FetchUnreadMails ]
Fetch mails from an IMAP mail server.
JSON[Bearbeiten]
- JSON [ Encode]
Encode an Object into JSON format (1.7.2) - JSON [ Decode ]
Decode an Object from JSON format (1.7.2)
SMTP[Bearbeiten]
- SMTP [ send email ]
Send an email via SMTP server
Source Code Management[Bearbeiten]
- CVS [ Checkout ]
Check out a tree from the CVS-repository. - CVS [ Version ]
Get the CVS-commands version string.
OS[Bearbeiten]
- OS [ CPUType ]
Retrieve the CPU family type (i386, sparc,...). - OS [ DomainName ]
Retrieve the machine's (network-) domain name (could be empty or nil). - OS [ HostName ]
Retrieve the machine's host name. - OS [ Language ]
Retrieve the machine's language setting. - OS [ MACAddresses ]
Retrive the machine's MAC (network-adapter/ethernet) addresses. - OS [ Type ]
Get the type of OperatingSystem (win32, linux, etc.) we are running on. - OS [ Is Windows ]
Check if running on Windows (1.8.3). - OS [ Is Unix ]
Check if running on Unix (1.8.3). - OS [ SystemInfo ]
Get info about the OS and hardware we are running on. - OS [ DriveList ]
Retrieve the list of drives in the machine (C:, D:, ...) - OS [ LoginName ]
Retrieve the user's login name. - OS [ FullUserName ]
Retrive the user's full name. - OS [ DefaultSystemPath ]
Retrieve the default system path.
String Processing[Bearbeiten]
- String [ Concatenation ]
Concatenate the string input values. - String [ CollectionOfStrings To String ]
Generate a concatenated string from the input string collection; individual strings are joined using the optional separator. - String [ CollectionOfLines To String ]
Generate a concatenated string from the input string collection without an optional seperator. - String [ AsCollectionOfWords ]
Returns a collection of words. - String [ AsCollectionOfLines ]
Returns a collection of lines. - String [ AsCollectionOfSubstrings ]
Returns a collection of substrings.
Comparing & Matching[Bearbeiten]
- String [ Caseless Compare? ]
Do a caseless string compare. - String [ Simple PatternMatch? ]
Do a pattern match similar to that used in the unix filename match algorithm. - String [ Regular Expression Match? ]
Do a regular expression pattern match. - String [ Regular Expression Match for Subexpressions? ]
Do a regular expression pattern match, provide matched subexpressions (1.8.3).
- String [ Extract All Regex Matches]
Given a string and a regex pattern, provide a collection of ALL matching elements. - String [ Extract ONE Regex Matches]
Given a string and a regex pattern, provide the first matching elements. - String [ Compare Switch ]
Compares a string with six other strings and triggers the first corresponding output-pin. - String [ IncludesString? ]
If the given string is contained in another string (substring) send the original string to the triggerYES output. Otherwise send it to the triggerNO output. - String [ IndexOfSubstrings? ]
Find a substring in a string starting at startIndex. - String [ StartsWith? ]
If the given string starts with another string (prefix string) send the original string to the triggerYES output. Otherwise send it to the triggerNO output. - String [ EndsWith? ]
If the given string ends with another string (suffix string) send the original string to the triggerYES output. Otherwise send it to the triggerNO output. - String [ Soundex ]
Generates a soundex string (see Knuth, for example) - String [ MySQLSoundex ]
Generates a mySQL soundex string (see Knuth, for example) - String [ KölnerPhonetic ]
Generates a kölnerPhonetic code string. - String [ EditDistance ]
Generates a value for the edit distance (actually levenshtein), which is a measure for how many edit operations are needed to get from string1 to string2.
Copying[Bearbeiten]
- String [ Substring Copy 0-based ]
Return a substring starting at the 0-based index startIndex up to (and including) the 0 based index endIndex. - String [ Substring Copy 1-based ]
Return a substring starting at the 0-based index startIndex up to (and including) the 1 based index endIndex. - String [ CopyFrom 0-based ]
Return a substring starting at the 0-based index startIndex up to the end of the string. - String [ CopyFrom 1-based ]
Return a substring starting at the 1-based index startIndex up to the end of the string. - String [ CopyTo 0-based ]
Return a substring ending at the 0-based index endIndex. - String [ CopyTo 1-based ]
Return a substring ending at the 1-based index endIndex. - String [ RemoveFromTo 0-based ]
Return a new string, where the substring starting at the 0-based index startIndex up to (and including) the 0-based index endIndex has been removed. - String [ RemoveFromTo 1-based ]
Return a new string, where the substring starting at the 1-based index startIndex up to (and including) the 1-based index endIndex has been removed. - String [ ReplaceFromTo 0-based ]
Return a new string, where the substring starting at the 0-based index startIndex up to (and including) the 0-based index endIndex has been replaced by another string. - String [ ReplaceFromTo 1-based ]
Return a new string, where the substring starting at the 1-based index startIndex up to (and including) the 1-based index endIndex has been replaced by another string.
Encoding[Bearbeiten]
- Base 64 Encode [ String to Base64String ]
Converts a string to its base64 encoding. - Base 64 Encode [ Base64String to String ]
Decodes a base64 encoded string. - Rot13 [ String to String ]
Apply a simple Caesar rot13 cypher. - UTF8 Encode [ String to UTF8String ]
Converts a string to its utf8 encoding. - UTF8 Decode [ UTF8String to String ]
Decodes an utf8 encoded string. - ASCIIString[ Convert to HexString]
Converts a String to a string containing the original strings characters as hex-encoded pairs. - HexString [ Convert to ASCIIString ]
Converts a twoByte HexString to its ascii representation.
Padding & Formatting[Bearbeiten]
- String [ Formatting ]
generate a formatted string for printing. - String [ LeftContracted ]
Do a string contraction (at the left). - String [ RightContracted ]
Do a string contraction (at the right). - String [ Contracted ]
Do a string contraction (in the middle). - String [ LeftPadded ]
Do a string padding. - String [ RightPadded ]
Do a string padding (on the right). - String [ Without Leading Whitespace ]
Return a copy of a string with leading whitespace (space, tab and newlines) removed. - String [ Without Trailing Whitespace ]
Return a copy of a string with trailing whitespace (space, tab and newlines) removed. - String [ Without Surrounding Whitespace ]
Return a copy of a string with leading and trailing whitespace (space, tab and newlines) removed. - String [ AsUppercase ]
Return the string converted to uppercase. - String [ AsLowercase ]
Return the string converted to lowercase. - String [ AsUppercaseFirst ]
Return a new string with the first character converted to uppercase.
Queries[Bearbeiten]
- String [ Length ]
Count the number of characters in a string. - String [ BitsPerCharacters ]
Return the number of bits in a character. - String [ IsSingleByteString? ]
Return true, if the number of bits in the strings characters are 8.
Stream Input/Output[Bearbeiten]
- Stream [ Close ]
Close a stream-handle. No further read operations are possible. - Stream [ EOF?]
Check if end-of-file has been reached. (1.7.2)
File Streams[Bearbeiten]
- FileStream [ Open for Reading ]
Open a file for reading. Provide a stream-handle for further read operations. - FileStream [ Open for Reading Error at EOF ]
Open a file for reading. The stream will report an error if a read after EOF is attempted. - FileStream [ Open for Writing ]
Open a file for writing. Provide a stream-handle for further write operations. - FileStream [ Open for Appending ]
Open a file for append-writing. Provide a stream-handle for further write operations. (1.7.1) - FileStream [ Create TempFile ]
Create a new temporary file.
Stream Reading[Bearbeiten]
- Stream [ ReadLine ]
Read a line from a read-stream (up to CR or NL). - Stream [ Contents ]
Read the whole content from a stream and return the content as string-collection. - Stream [ ReadByte ]
Read a single byte from a read-stream. - Stream [ ReadBytes ]
Read a number of bytes from a read-stream. - Stream [ ReadCharacters ]
Read a number of characters from a read-stream. - Stream [ ReadAlphaNumericWord ]
Read an alphanumeric word from a read-stream. - Stream [ ReadThrough ]
Read characters up to and including a delimiting string. (1.7.2) - Stream [ ReadUpTo ]
Read characters up to a delimiting string. (1.7.2) - Stream [ ReadInt16 ]
Read a two-byte (16bit) signed integer from a read-stream. - Stream [ ReadInt32 ]
Read a four-byte (32bit) signed integer from a read-stream. - Stream [ ReadInt64 ]
Read an eight-byte (64bit) unsigned integer from a read-stream. - Stream [ ReadUInt16 ]
Read a two-byte (16bit) unsigned integer from a read-stream. - Stream [ ReadUInt32 ]
Read a four-byte (32bit) unsigned integer from a read-stream. - Stream [ ReadUInt64 ]
Read an eight-byte (64bit) unsigned integer from a read-stream. - Stream [ Skip ]
Skip a number of bytes. (1.7.2) - Stream [ SkipWhitespace ]
Skip all whiteSpace (blanks, tabs and linebreaks).
Socket Streams[Bearbeiten]
- Socket [ Connect ]
Create a new TCP connection to a port on a host. (1.7.1) - Socket [ Wait For Connection ]
Listen on a TCP-socket identified by its port number. (1.7.1)
Internal Streams[Bearbeiten]
- Stream [ Reading from String ]
Create a stream for reading characters from a String. (1.8.1) - Stream [ Writing into String ]
Create a stream for writing characters. (1.8.1) - Stream [ Collected Contents ]
Get a writeStream's collected contents.(1.8.1)
Stream Writing[Bearbeiten]
- Stream [ WriteLine ]
Write a text-line to a write-stream. - Stream [ WriteString ]
Write a string to a write-stream. - Stream [ WriteBytes ]
Write a number of bytes to a write-stream. - Stream [ WriteByte ]
Write a single byte to a write-stream. - Stream [ WriteInt16 ]
Write an int16 to a write-stream. - Stream [ WriteInt32 ]
Write an int32 to a write-stream. - Stream [ WriteInt64 ]
Write an int64 to a write-stream. - Stream [ NL ]
Write a newline character to the writeStream. - Stream [ CR ]
Write a return character to the writeStream. - Stream [ CRNL ]
Write a cr-lf sequence to the writeStream. - Stream [ TAB ]
Write a tabulator character to the writeStream.
Time & Date[Bearbeiten]
- Delay [ Seconds ]
Sleeps for a while (delay).
- Delay [ Signal ]
Send in-value to the out pin after a delay.
- Delay [ Duration ]
The delay time is given as a timeDuration object.
- Delay [ with Dialog ]
Send the value of inValue to outValue after delayMilliseconds milliseconds.
- Delay [ Basic ]
A private helper for the Delay Action.
- Time [ GetTimestamp ]
Get the current time and date (a timeStamp).
- Time [ GetTime ]
Get the current time of day.
- Time [ DeltaTime ]
Returns the duration between two timestamps as a TimeDuration.
- Time [ Add seconds]
Add some seconds to a DateTime (timeStamp).
- Time [ Add minutes ]
Add some minutes to a DateTime (timeStamp).
- Time [ Add hours ]
Add some hours to a DateTime (timeStamp).
- Time [ Add Duration ]
Add some timeDuration to a DateTime (timeStamp).
- Time [ Substract Time ]
Substract two TimeStamps and returns an integer-value in seconds.
- Time [ Substract Time Delta in MS ]
Substract two TimeStamps and returns an integer-value in milliseconds.
- Time [ Substract Duration ]
Substract a predefined timeduration in seconds from a DateTime.
- Time [ Compute Duration ]
Returns delta of two DateTimes in TimeDuration.
- Time [ ToString ]
Convert to String using an optional format string.
- Time [ To ISO8601 Format String]
Convert to String to the ISO8601 format
- Time [ To RFC1123 Format String]
Convert to String to the RFC1123 format
- Time [ To Generalized Format String ]
Convert to String to the universal generalized format (includes timezone information)
- Time [ From ISO8601 Format String]
Convert a String in ISO8601 format into a TimeAndDate
- Time [ From Generalized Format String ]
Convert a String in universal generalized format into a TimeAndDate
- Time [ GetHour ]
Get a timestamp's hour (0..23)
- Time [ GetMinute ]
Get a timestamp's minute (0..59)
- Time [ GetSecond ]
Get a timestamp's second (0..59)
- Time [ Today ]
Get the current timestamp.
- Date [ GetYear ]
Get a timestamp's year (2007, 2008,...).
- Date [ GetMonth ]
Get a timestamp's month (1..12).
- Date [ GetDay ]
Get a timestamp's day (1..31).
- Date [ GetWeekDay ]
Get a timestamp's weekday (1..7) 1==monday; 7==sunday
- Date [ GetDayInYear ]
Get a timestamp's day in year (1..365/366)
- Date [ GetNameOfDay]
Get a timestamp's weekday name in the system language as a string.
- Date [ GetDaysInMonth]
Get the number of days in the month which is represented by the given timestamp (29, 30 or 31).
- Date [ GetDaysInYear]
Get the number of days in the year which is represented by the given timestamp (365 or 366).
- Date [ GetDaysLeftInMonth]
Get the number of days which are left in the month which is represented by the given timestamp.
- Date [ GetDaysLeftInYear]
Get the number of days which are left in the year which is represented by the given timestamp.
- Timeduration [ Sum ]
Add two timeDurations.
- Timeduration [ Difference ]
Substract two timeDurations.
- Timeduration [ Scale ]
Scale a timeDuration.
- Timeduration [ To Seconds ]
Scale a timeDuration.
Tools[Bearbeiten]
- Windows [ Open Document ]
Ask the windows shell, to open a document. Will start the application which is associated to the file-type (1.9.1).
Type Conversion[Bearbeiten]
- Convert [ Any To PrintedString ]
Convert the value of the inputString to its printed string-representation.
- Convert [ Any To String ]
Convert the value of the inputString to its string-representation
- Convert [ Any To PaddedString ]
Convert the value of the input to a right-padded string-representation
- Convert [ Any To LeftPaddedString ]
Convert the value of the input to a left-padded string-representation
- Convert [ Integer To RadixString ]
Convert the value of a number to a radix-string (i.e. hex, octal, binary etc.)
- Convert [ Number To Float ]
Convert the value of a number to a float.
- Convert [ Collection To OrderedCollection ]
Convert a string to a string-collection.
- Convert [ StringCollection to Strings ]
Read a string-collection from the input and write each line separately to the output.
- Convert [ StringCollection to String ]
Convert a collection of strings to a string.
- Convert [ String To URL ]
Convert a string to an URL-Object
- Convert [ String To UUID ]
Convert a string to a UUID-Object (1.7.1)
- Convert [ String To TimeDuration]
Convert a string to a TimeDuration-Object (1.7.1)
- Convert [String To Filename ]
Convert the value of a string to a filename.
- Convert [ String To StringCollection ]
Convert a string to a collection of strings.
- Convert [ String To Number ]
Convert a string to a number
- Convert [ String To ByteArray ]
Convert a string to a byteArray (1.7.2)
- Convert [ ByteArray To String ]
Convert a bytearray to a string (1.7.2)
- Convert [ RadixString To Integer ]
Convert the value of the inputString to a number. The input may be in any base (i.e. hex, octal, binary etc.)
- Cast [ Any To Any ]
Can be inserted between type-incompatible pins. Does no real conversion.
- Cast [ Any To Any with Check ]
Can be inserted between type-incompatible pins. This block reports an error, if the values are incompatible.
- Cast [ String To Any ]
Convert a string-input to an any-output. Actually, no conversion is done here, this is a simple type cast.
Variables[Bearbeiten]
- Environment [ Get by Name ]
Get a value from a surrounding expecco environment.
- Environment [ Set by Name ]
Set an Environment-variable.
- Environment [ Clear by Name ]
Clear (unset) an environment variable.
- Environment [ Set Variable ]
Set an Environment-variable (1.7.1).
- Environment [ Create with Name ]
Create a new environment variable in the containing block's environment (1.7.1).
- Environment [ Create with Name and Value ]
Create a new environment variable in the containing block's environment (1.8.0).
- Environment [ Create in Executor Environment ]
Create a new environment variable in the executor's environment (1.8.0).
- Environment [ Remove by Name ]
Remove an environment variable from the containing block's environment (1.7.1).
- Environment [ Watch by Name for Changes ]
Watch a variable (1.7.1).
- Environment [ Wait by Name for Changes ]
Wait for a variable to change (1.7.1).
- Environment [ Watch Variable for Changes ]
Watch the variable from which my input is frozen. (1.7.1).
- Environment [ Wait for Variable to Change ]
Wait for the variable from which my input is frozen, to change (1.7.1).
- Environment [ Initialize Project Environment ]
Reinitialize all project variables (1.7.2).
Go to Release Notes