Flow Control Actions

Flow Control Actions

break

Skip to the end of enclosing loop or section.

# Should stop logging after 4
a = createArray()
i = 0
while (i > 10) {
i = i + 1
if (i == 5) {
break ()
} else {}
log(i)
}

clearLastError

Clears the last error message and code, setting them to undefined, otherwise the last error message and code are available until another error occurs. This action does not include any properties.

# The beginning of the Action Set
clearLastError()
forEach(record, records) {
# Iteration logic
}
# The remainder of the Action Set

close

Close a closeable resource (e.g. connection or iterator.)

inputText = openDelimitedTextInput(...)
forEach(input,inputText) {
log("The first name for this record is: " + input["fname"])
}
close(inputText)

comment

Comment.

# This is a comment
if(a == b) {
# Comments can be placed anywhere in your Action Set
log(a)
} else {
# Even here
log(b)
}

continue

Go to the top of the enclosing loop

a = createArray()
i = 0
while(i > 10) {
i = i + 1
if(i == 5) {
continue()
} else {
log(i)
}
}

forEach

Iterate through each item in a collection.

inputText = openDelimitedTextInput(...)
forEach(input,inputText) {
log("The first name for this record is: " + input["fname"])
}
close(inputText)

getLastErrorCode

If available, returns the numeric error code associated with the last error message. Currently, only the Database, LDAP, and AD adapters provide numeric error codes.

code = getLastErrorCode()

getLastErrorMessage

Returns the last error message sent to the log of the currently running Action Set (including messages sent by log() with a level of "ERROR").

message = getLastErrorMessage()

getNext

Get the next item in this iterator.

iterator = openGoogleAppsUserIterator(conn, true)
hasNext = hasNext(iterator)
while(hasNext) {
next = getNext(iterator)
log("next:" + next);
hasNext = hasNext(iterator)
}
close(iterator)

hasNext

Check if there are more items in this iterator.

iterator = openGoogleAppsUserIterator(conn, true)
hasNext = hasNext(iterator)
while(hasNext) {
next = getNext(iterator)
log("next:" + next);
hasNext = hasNext(iterator)
}
close(iterator)

if

Conditionally perform actions.

outputText = openDelimitedTextOutput(...)
myRecord = createRecord()
setRecordValue(myRecord,"fname","Troy")
setRecordValue(myRecord,"lname","Moreland")
putResult = putTextOutputRecord(outputText,myRecord)
if(putResult) {
log("Text record output successful!")
} else {
log("Text record output failed!")
}
close(outputText)

return

End the action and return a value.

return "Hello,World!"

section

A way to group multiple actions together.

# Open Connections
{
sessionAD = openADConnection(Global.adHost, Global.adPort,
Global.adSSL, Global.adUser,<Password>)
sessionGoogle = defineGoogleAppsConnection(Global.googleDomain,
Global.googleUser,<Password>)
if(!sessionAD || !sessionGoogle) {
# --- Error making connections. Terminating process.
return null
} else {
}
}

while

Loop while the condition is true.

i = 0
while(i < 10) {
i = i + 1
}