i-effect Manual

Tasks from base

Within the tasks of base you can find more job categories. These include:

  • date

  • math

  • strings

  • time

Date

Within date there are a number of tasks that deal with Dati.

image2016-6-2 15:28:41.png

The following file formats are available:

Format Name

Syntax

Example Value

*YMD

yy-MM-dd

16-02-01

*YMD0

yyMMdd

160201

*YMD.

yy.MM.dd

16.02.01

*CYMD

yyyy-MM-dd

2016-02-01

*CYMD0

yyyyMMdd

20160201

*DMY

dd-MM-yy

01-02-16

*DMY0

ddMMyy

010216

*DMY.

dd.MM.yy

01.02.16

*DMCY

dd-MM-yyy

01-02-2016

*DMCY0

ddMMyyyy

01022016

*DMCY.

dd-MM-yyyy

01-02-2016

*DMCY0

ddMMyyy

01022016

*DMCY.

dd.MM.yyyy

01.02.2016

*ISO

yyyy-MM-dd

2016-02-01

*ISO0

yyyyMMdd

2016-02-01

*DATE7

CyMMd

1160201


Task

Description

convertDate

Converts a date of input with a specific input format in a specific output format.

image2016-6-2 9:56:53.png

Converts 20160201 (* according to ISO 0 → yyyy MM dd) in 2016-02-01 (* according to ISO → yyyy-MM-dd). The value is then stored back into §CURRENT.

getCurrentDate

Determines the current date in the specified format output.

image2016-6-2 10:21:53.png

getDayName

Returns the name of the current day.

image2016-6-2 10:22:20.png

getDayOfMonth

Returns the name of the currennt month.

image2016-6-2 10:22:29.png

getDayOfWeek

Returns the current day of the week.

image2016-6-2 10:22:51.png

getDayOfYear

Returns the current day of the year.

image2016-6-2 10:23:14.png

getDaysSince

Calculates the days between two dates:

image2016-6-2 10:24:4.png

getIso0FromMSExcelDay

Calculates an ISO 0 Date of Excel date (days since 01/01/1990).

image2016-6-2 10:25:25.png

 

getMonth

Returns the current month:

image2016-6-2 10:27:50.png

getMonthName

Returns the current month name.

image2016-6-2 10:27:50.png

getMSExcelDay

Is the MS Excel returns an integer value for an input ISO 0-date.

image2016-6-2 10:29:14.png

getWeekofYear

Returns the calendar week of the year for an ISO 0 date back:

image2016-6-2 10:30:16.png

getYear

Returns the current year:

image2016-6-2 10:30:56.png

2 - Without century

4 - With Century

Math

Within Math there are a number of tasks that deal with mathematical functions.

image2017-5-22 10:2:4.png

 

Tasks

Description

calc

Any mathematical calculation operations. For example: (7^4)-(2*3) +4

image2016-6-2 10:37:15.png

decrement

Decrease the counter by 1.

image2017-5-22 10:3:41.png

div

Divides the Input / Value.

image2016-6-2 10:38:36.png

increment

Increase the counter by 1.

image2017-5-22 10:3:41.png

max

Comparing Input and comparator and provides the higher value.

image2016-6-2 10:39:13.png

For example,  CURRENT = 1 and Comparator = 2. The function returns 2 back.

min

Comparing Input and comparator and provides the higher value.

image2016-6-2 10:39:13.png

For example,  CURRENT = 1 and Comparator = 2. The function returns 1.

modulo

Returns the remainder of the division (modulo).

image2016-6-2 10:40:55.png

For example,  CURRENT = 3 and divisor = 2. THe function returns 1.

mul

Multiplies two values.

image2016-6-2 10:41:52.png

negate

Changes the sign. E.g. +5 -> -5

image2016-6-2 10:43:55.png

round

Rounds the entered value to the desired decimal:

image2016-6-2 10:52:18.png

Count is the digits after the decimal point.

sub

Subtraction of input - value

image2016-6-2 10:53:8.png

subDouble

Subtracting double figures: input - value

image2016-6-2 10:53:8.png

sum

Summing input and value.

image2016-6-2 10:53:8.png

 sumDouble

Sums double figures: input + value.

image2016-6-2 10:55:16.png

sumFloat

Sums float numbers: input + add value

image2016-6-2 10:55:29.png

sumInt

Sums two integer values: input + add Value

image2016-6-2 10:55:53.png

sumLong

Sums two long values: input + add Value

image2016-6-2 10:56:16.png

toNegative

Negates the input value.

image2016-6-2 10:57:9.png

toPositive

Returns the magnitude of a negative value.

image2016-6-2 10:57:18.png

Strings

Within strings there are a number of tasks that deal with strings.

image2016-6-2 15:29:26.png

 

Tasks

Description

aTrim

Removes leading and terminal "White Spaces" such as tabs, spaces, and newline characters.

image2016-6-2 11:2:47.png

charAt

Is the character of a specified location within a string back.

image2016-6-2 11:5:8.png

Narrated by  CURRENT = test the character at position 1: Previous T

concatDelim

Concatenating two strings into a new string using the specified character as a delimiter.

image2016-6-2 11:6:23.png

Narrated by  CURRENT = test the new value test 01 back.

concatNospc

Direct concatenate two strings together into a new string. (Without delimiter)

image2016-6-2 11:10:20.png

concatSpc

Concatenating two strings into a new string with a space as a separator.

image2016-6-2 11:11:45.png

concatStringPart

Depends on the input string part of a second string. The new string is stored in the specified variable (default:  CURRENT).

image2016-6-2 11:18:27.png

At CURRENT = Test. Returns the value: Reset TEST TE.

contains

Returns TRUE and FALSE. Finds the in specified search string in input .

image2016-6-2 11:20:10.png

endsWith

Checks if a string to the value of, endstring 'ends. If the string ends with the specified value, TRUE is returned, otherwise FALSE.

image2016-6-2 11:21:1.png

fillToLength

Attaches a fill character to a given string until the desired length is reached. Based on the given direction, characters are attached to the character string on the left or right.
If the string is longer than the desired length, the method returns the original string back

image2016-6-2 11:21:33.png

getStringPart

Returns the substring at the specified index. For index 0, the last part is returned. is the position of the back track levels substring (index 0 is the last). splitchar is the separator to be used.

  image2016-6-2 11:23:5.png

indexOf

Returns the index to within the string of the first occurrence of the specified substring.

image2016-6-2 11:23:50.png

lastIndexOf

Returns the index within this string of the rightmost occurrence of the specified string.

image2016-6-2 11:23:50.png


 length

Returns the length of the input string.

image2016-6-2 11:24:37.png

Itrim

Removes leading "white spaces" such as tabs, spaces, and newline characters.

image2016-6-2 11:24:37.png

putString

A special task for merging several source strings that are to be mapped as a value in a target field. This task can only be used in conjunction with "additionals".

image2018-2-27_11-48-30.png

putSubString

The function inserts a character string into an existing one. The existing content is overwritten and filled to the specified length with blanks.

image2018-2-27_11-49-5.png

removeAll

Removes all occurrences of remove string in input.

image2016-6-2 11:27:35.png

removeFirst

Removes the first occurrence of string remove in input.

image2016-6-2 11:27:35.png

removeLineEndChars

Removes every occurrence of a newline character (CRLF) from the given string.

image2016-6-2 11:24:37.png


 replaceAll

Replace all occurrences of based on a passed regular expression found substring with the given replacement string.

image2016-6-2 11:30:3.png

replaceAllMap

This task takes in the string in the parameter "Input" values from the substitution list specified in the parameter "replacementMap" and replaces it with the listed replacement values. It will replace all occurrences found. The final string is stored in the parameter "StoreIn" In order to replace, for example, German umlauts in a string the following assignment list are used: 

image2016-6-2 11:30:44.png

replaceAllMap(„ö:oe,ä:ae,ü:ue,ß:ss,Ö:OE,Ä:AE,Ü:UE")

replaceFirst

Replaces the first occurrence of based a passed regular expression found substring with the given replacement string.

image2016-6-2 11:31:16.png

replaceFromMap

 This task compares the string in the parameter input with the comparison values from the Replace Map. When a comparison value matches, the associated replacement value in storeIn is stored.
Fits no comparison value, so the value Else in storeIn is written.

image2016-6-2 11:33:7.png

Example: replace = def Map: Hello, Abc: World, else value '[input = Abc store Add = World] [input = def storeIn = Hello] [input = aef storeIn = else_Value]

Replace the map is defined as follows:

(compare_value:replacement_value,compare_value2,replace_value2...,else_value)

rTrim

Removes terminal "white spaces" such as tabs, spaces, and newline characters.

image2016-6-2 11:24:37.png


startsWith

Checks if a string with the value of "start string" begins. If the string starts with the specified value, TRUE is returned, otherwise FALSE.

image2016-6-2 11:33:58.png

substring

Extracts a part string from the position set in 'start' to the end position of the input string.

image2016-6-2 11:34:33.png

substringLeft

Extracts the left part of the input string with a given length and returns it as a new substring.

image2016-6-2 11:38:50.png

substringRight

Extracts the right part of the input string with a given length and returns it as a new substring.

image2016-6-2 11:38:50.png


substringToEnd

Extracts a part of a string beginning with the in "start" you passed up to the specified end position of the input string.

image2016-6-2 11:39:21.png

 subStringToLength

Extracts a substring from a given string, beginning with the set start index in the specified length.

image2016-6-2 11:40:12.png

toLower

Converts string to lowercase.

image2016-6-2 11:24:37.png

toUpper

Converts string to uppercase.

image2016-6-2 11:24:37.png

 trimLeadingZeros

Removes leading zeros.

image2016-6-2 11:24:37.png

 trimTrailingZeros

Removes terminal zeros.

image2016-6-2 11:24:37.png

Time

Within Time there are a number of tasks that deal with time functions.

image2016-6-2 15:29:57.png

The following timeformats are available:

Format Name 

Syntax

Example Value

*HMS0

HHmmss

135026

*ISO0

HHmmss

135026

*HMS

HH:mm:ss

13:50:26

*ISO

HH:mm:ss

13:50:26

*HMS24

HH:mm:ss

13:50:26

*HMS12

HH:mm:ss a

01:50:26 PM

*HMS024

HHmmss

135026

*HMS012

HHmmss a

015026 PM

*HMS.24

HH.mm.ss

13.50.26

*HMS.12

HH.mm.ss

01.50.26 PM

*HMS-24

HH-mm-ss

13-50-26

*HMS-12

HH-mm-ss

01-50-26 PM

*HM24

HHmm

13:50

*HM12

HHmm a

01:50 PM

*HM024

HHmm

1350

*HM012

HHmm a

0150PM

*HM.24

HH.mm

13.50

*HM.12

HH.mm a

01.50 PM

*HM-24

HH-mm

13-50

*HM-12

HH-mm a

01-50 PM


Task

Description

convertTime

Converts an input to the corresponding output format.

image2016-6-2 11:56:43.png

getCurrentTime

Returns the current time back in the desired output format.

image2016-6-2 11:58:0.png

getCurrentTimestamp

Returns either a UNIX or a DB timestamp back.

image2016-6-2 11:59:45.png