DBSync Cloud Workflow (iPaaS)

2022

Page tree

Versions Compared

Old Version 75

changes.mady.by.user Anil Bhimineni

Saved on

compared with

New Version Current

changes.mady.by.user Tushar Singh

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Standard Functions, or built-in functions, refer to specific functions by name. Functions are available to all users of a project. If a project is imported, the same files and functions, from the original project, is available to the cloned project.


Info
titleNote
1) Functions are code sensitive.
2) When you use functions, the string objects must be enclosed in single quotes.

Function

Description

Examples

ADDXML(String xml)

This function adds XML structure to the present element. This function is used when the source application doesn't expose their fields in their API

then a

. A user can

do

map the

mapping for the field and parse the data via DBSync.

field by modifying the XML structure to post back. This will add the XML on the root node of the target XML structure.

Mapping: <TargetField> = { ADDXML("<xml element>" + VALUE("sourcefield") +

 "</xml element>");return "";}

Example: Database fields 
Trigger: select id,firstname from

contact

Contact.

The above query fetches id, firstname from

contact

the Contact table of the database.

The table also has

a field of

"contactaddress"

and so

field. As a result, the query will not populate the

"contactaddress" field in the target schema.

Name = {ADDXML("<address>" +VALUE("ContactAddress") + "</address>");return VALUE("Firstname");}

However

i can map

, the source field can be mapped and

the populate the

source field data

in to

populated

into contactaddress column of the database

and this

. The contactaddress field is then written to the target application.


ADDXML(String xPath, String xml)

This function appends the XML structure to the XPath passed. This function is used when the source application doesn't expose

their

fields through

their

API

then a

. A user can

do

map the

mapping for the

field and parse the data

via DBSync

.

Let us take an example of custom field SalesRep__c  on the Opportunity object in

SalesForce

Salesforce.

We have to map

Map this field to the SalesRep custom field on QuickBooks online.

To map this field, type custom field name(SalesRep) in the target area

(QuickBook online)

and add below given

. And then, add the following query in the source field.


Mapping: <TargetField> = { ADDXML("<CustomField><DefinitionId>2</DefinitionId><Name>SalesRep</Name><Type>StringType</Type><StringValue>"+VALUE("SalesRep__c")+"</StringValue></CustomField>");

return "";

}

Where

→ <DefinitionId>2<

:
<DefinitionId>2</DefinitionId> :Position of custom field in QuickBooks online.

              <Name>SalesRep<

<Name>SalesRep</Name> : The custom field name in QuickBooks online.

              <StringValue>

  <StringValue>"+VALUE("SalesRep__c")+"</StringValue> : The custom field in Salesforce.


AND (boolean booleanExp1, boolean booleanExp2)

This function is used to check more than one condition/expression at the same time
and
. It returns true only if both the conditions are
satisfied
met; or else, it returns false.

Mapping: <TargetField> = AND(booleanExp1,booleanExp2) 

Example :

Salesforce object fields 
Trigger: select Id, firstname, lastname from contact
The above query fetches Id, firstname, and lastname from the contact object of Salesforce. You can use AND() function to check whether firstname, lastname have same text value and Id of 123. If both the conditions are satisfied then AND() function returns true, else returns false. 

<TargetField> = AND(VALUE("

firstNname

Stage")==

VALUE(

"

lastname

Closed Won"

)

,

VALUE("

Id

Type")=="

123

Key Account") 

From the above example, the function returns true for all the records where

the "Stage" is "Closed Won" and, the Type is "Key Account".


ASNUMBER(String value)

This function checks if a supplied value is a number

and

. And then, it returns the actual number passed; or else, it returns zero.

MAPPING: <TargetField> =

NUMBER

ASNUMBER("String")

Example: Salesforce object fields
Trigger: select name, numberofemployees from lead
The above query will select name and number of employees from the lead object of Salesforce. You can use ASNUMBER() function to convert the number of employees into integer format of a target field.


<TargetField> = ASNUMBER(

VALUE(

"

numberofemployees

123")

)

If the value for the number of employees is null, or empty

it
Trigger: select Id, name from account
The above query will select Id and name from the account object of Salesforce. You can use the CLEAN() function to get the first character of the name field and set it to the target field.
<TargetField> = CLEAN (VALUE("Name"))

, the function will return

a value zero. In this example, the value of the number of employees is '123' so

the function will return 123.


CLEAN(String s1, String s2)

This function removes all non-printable characters from a supplied string value.


Note: The clean function removes the first 32 (non-printable) characters in the 7-bit ASCII code from the text.


Mapping: <TargetField> = CLEAN("String VALUE")

Example:

Salesforce object fields
Trigger: select Id, name from account
The above query will select Id and name from the account object of Salesforce. You can use CODE () function to get the first character of the name field and set it to the target field.<TargetField> = CODE(VALUE("Name"))
Example 2: <TargetField> = CODE("Salesforce")
The above mapping will put 'S' in the target field

<TargetField> = CLEAN (Aºlan)

In the above example, the function removes the non-printable character

and returns the output as "Alan".

CONCATENATE(String... strings )

This function allows you to join two or more text strings together.

Mapping: <TargetField> = CONCATENATE("String1", "string2", "string3")

Example: passing text values

<TargetField> = CONCATENATE("It's", "raining ", "heavily ", "outside.")

The value returned by the function from the above example is "It's raining heavily outside."


CODE(String s)

This function returns the numeric code of the first character of a supplied text value.

Mapping: <TargetField> = CODE("text value")

Example :

Salesforce object fields

<TargetField> = CODE("Alan Musk")

In the above example the function returns the numeric code of the first character

in the supplied text - namely, "Alan Musk". The numeric value of character

"A" is returned as 65.


DATE(String dateString)This function reads a date string and returns it in the format of "yyyyMMdd-HHmmssZ".

Mapping: <TargetField> = DATE("date string")


Example : <TargetField> = DATE("03-12-2010 12:33:21")

The value returned would be transformed as "20101203-123321".

DATE (String dateString, String inputFormat)

This function reads a date string and returns the date string as per user-specified date format.

If the user-specified date format is not passed then, it passes date string as "yyyyMMdd-HHmmssZ".

Mapping: <TargetField> = DATE(VALUE("source field"), "format string")

Example :

Salesforce object fields
Trigger: select company, createdby, lasttransferdate from lead
The above query will select company, created by and last transfer date field from the lead object of Salesforce. You can use DATE() function to format the passed date string to a specified date format.

<TargetField> = DATE(VALUE("lasttransferdate"),"MM-DD-YYYY HH:MM:SS")

The value of lasttransferdate is Mar-12-2010 12:33:21. As a result,

then

the DATE() function will return value as 03-12-2010 12:33:21.


DATE(String dateString, String inputFormat, String outputFormat)

This function reads a date string and returns the date string as per user-specified date output format.

If the user-specified date input format is not passed then it returns date string as "yyyyMMdd-HHmmssZ".

Example: database query
Trigger: select contactname, createddate from dbcontact
The above query will select contactname, createddate field from dbcontact table of the specified database.

Mapping: <TargetField> = DATE(VALUE("source field"), "source format", "target format string")


Example : <TargetField>= DATE(DATE(VALUE("

CreatedDate

createddate"),"yyyy-MM-ddhh:mm:ss"),

"yyyy-MM-dd'T'HH:mm:ss'Z'")

The value of createddate is 03-12-2010 12:33:21, then the DATE()

function will return value as 2010-12-03'T'12:33:21.


DOLLAR(Arg 0)

Not implemented yet

This function is currently not supported.


EQUALS(String v1, String v2)

This function compares two

given

string values and returns true if both the values are an exact match; otherwise, it returns false(case-insensitive).

Mapping: <TargetField> = EQUALS(VALUE("

CurrencyISO

sourcefield"),"

USD

text")

This function compares USD in CurrencyISO field for USD value and if found then it returns true; else false

Example: <TargetField> = EQUALS("she is beautiful","He is beautiful")

From the above example the function returns false as the first passed string

and the second string does not match.


ERROR()

This function can be used to

print error messages to the DBSync console. The function when applied to a target field, returns error messages from the stack trace due to integration failure in user readable format

get the error message for errors during writing to target. This is used in status write back, once an attempt has been made to write the record to the target.

Mapping: <TargetField> = ERROR()

Example:

Error while processing the state

There is an invalid reference to QuickBooks Customer

"Dialysis Center of NW Arkansas: Hidden Springs Dialysis Center" in the

SalesOrder. QuickBooks error message: Invalid argument.

The specified record does not exist in the list.

From the above example, there is an error while writing to

QuickBooks sales order and this error message is written back to the source application.


EXACT(String str1, String str2)

This function compares two

given
Trigger: select Id, firstname, lastname from contact
The above query retrieve Id, firstname and lastname from contacts object of Salesforce. You can use the EXACT() function to compare the values of firstname and lastname fields. If both the fields are having same values then the function returns true, else returns false.

string values and returns true if both the values are an exact match; otherwise, it returns false(case-sensitive).


Mapping: <TargetField> = EXACT(VALUE("SourceField1"), VALUE("SourceField2"))

Example :

Salesforce object fields

<TargetField> = EXACT(VALUE("FirstName"),VALUE("

LastName

FirstName"))

The above example will return true as the value of first attribute is "Chris" and the

value of second attribute is also "Chris".


FAST_TLOOKUP(String query)


This function looks up a given Id from a passed query and returns the corresponding value. This function is the same as the TLOOKUP function. However, the function executes based on writer batch size for faster execution.


Note: You shouldn't use the special character on the function.The return value of FAST_TLOOKUP

1. should not start with a hyphen
2. should not end with hyphen and 
3. should not be Null.

Mapping: <TargetField> = FAST_TLOOKUP(

"select id from account where writer_name = { reader_name } and writer_code = { reader_code }")

@return value of the return_col based on the where_clause, else it would return empty value

stringQuery)

Example: QuickBooks Invoice to Salesforce opportunity

AccountID = FAST_TLOOKUP("Select Id from Account where AVSFQuickBooks__Quickbooks_Id__c={CustomerRef/FullName/CustomerRet/ListID}")

In the above example, we are updating the Opportunity object of Salesforce

by reading invoice records from QuickBooks. The query passed inside the function

will fetch the customer List ID (in this case the value of List id is "12345") from QuickBooks.

If a match is found between List id and Salesforce's Account ID then, this will indicate

that the customer's record exists in Salesforce. As a result, related invoice record information from QuickBooks will update information in the related Opportunity object.

FIND(String findText, String withinText)

This function returns the position of the first string parameter, within the supplied second string parameter.


Mapping: <TargetField> = Find(VALUE("SourceField1"), VALUE("SourceField2"))

Example 1: TargetField = FIND(VALUE("lastname"), VALUE("firstname"))


<TargetField>= FIND("arch","search")

In this example, pass the first string as "arch" and the second string as "search".

The FIND() function will return the position of "arch" in "search".

The FIND() function will return 3 as the value.

Example 2: Salesforce object fields

Trigger: Select Id,firstname,lastname from contact

The above query will retrieve Id, firstnameandlastnamefieldsfromcontactsobjectofSalesforce. You can use FIND() function to check whether lastNamefieldshasvaluesinfirstname. Ifthefunctionfindsthelastnamevalueinfirstname field then the function returns zero; else itreturnsthepositionofthelastnameinfirstname.


Note: If the

findText

find text parameter finds value in

withinText

within-text parameter more than once then,

then

the function returns the position of the very first

existence

instance.


FIND(String findText, String withinText, int startNum)

This function returns the position of the first string parameter within the supplied second string parameter from the passed start index.

Mapping: TargetField = FIND(VALUE("SourceField1"), VALUE("SourceField2"), "Start Position")

Example1:


TargetField = FIND("arch","search",2)

In this example, pass the first string as "arch" and the second string as "search".

The FIND() function will search the string "arch" in "search" starting from

the

second

2nd position of the "search" string and return the position of "arch" in "search".

The function return 3 and first two characters of the string "Search" i.e. 's' and 'e' are ignored.

Example 2: Salesforce object fields
Trigger: select Id, firstname, lastname from contact
The above query retrieves Id, firstname and lastname fields from contacts object of Salesforce. You can use FIND() function to check for lastname field values in firstname field. If the function finds the lastname value in firstname field then the function returns zero; else it returns the position of the lastname in firstname.
<TargetField> = FIND (VALUE("FirstName"), VALUE("LastName"),1)


Note: If the findText parameter finds value

within Text

withinText parameter more than once,

then the function returns the position of the very first

existence

instance.


FIXED (Double)This function rounds the decimal values up to two digits and returns the round off value.

Mapping: <TargetField> = FIXED("

sourcefield1

sourcefield")

Example: Database query
Trigger: select orderno,vendorname, price from order
The above query retrieves orderno, vendorname and price from order table of the specified database.


<TargetField> = FIXED(

VALUE("price"))

12.6789)

In the price field the value passed is 12.6789 so the FIXED() function

will return the price value as 12.68.


FIXED (Double, Integer)

This function rounds a supplied number to a specified number of decimal places.

Mapping: <TargetField> = FIXED("

sourcefield1

sourcefield"

)
Example: Database query
Trigger: select orderno,vendorname, price from order
The above query retrieves orderno, vendorname and price from order table of the specified database.

,1)

<TargetField> = FIXED(

VALUE("price")

14.789,1)

In the

pricefieldthe

price field the value passed is 14.789 so the FIXED() function will return the price value as 14.8.


FIXED (Double, Integer, Boolean)

Not

This function is currently not supported


FORMAT(String value, String format)

This function transforms the numeric string passed in the first parameter based
upon
on the format passed in the second parameter
and
. Then, it returns the transformed number as a string.

Mapping: <TargetField> = FORMAT("

SourceField1

SourceField", "Format String")

Example: Database query
Trigger: select orderno,vendorname, price from order
The above query retrieves orderno, vendorname and price from order table of the specified database.

<TargetField> = FORMAT(

VALUE(

"

price

12"

)

,"

#,##0

0.

00

00##")

In the

price field the value passed is 210.6 so the FORMAT() function will return the price value as 210.60

above example, pass the first parameter 12 as string and the second parameter as specified decimal format of "0.00##"". The function returns the result string as "12.00".



GETROOTVALUE(String elementName)

This function returns the immediate parent node of XML element.

Mapping: <TargetField> = GETROOTVALUE("

SourceField1

SourceField")

Example : <TargetField> = GETROOTVALUE(

VALUE(

"Name")

)

<Contact>
<Name>John</Name>
</Contact>

The "Name"

value

attribute will be compared in the XML and if found

returns the parent node contents as a String.

, it will return the name value - i.e. "John".


GETSOURCEXML2STRING()

This function returns the string formatted XML structure of the row.

Mapping: <TargetField> = GETSOURCEXML2STRING()

<TargetField> = GETSOURCEXML2STRING()

<items> <item id="0001" type="donut"> <name>Cake</name> <ppu>0.55</ppu>

</item> ... </items>

The XML elements are returned as a string. In the above example, the input is taken as XML having element has items and returned it as string.


GETSOURCEXML2STRING(String elementName)


This function returns the string formatted XML structure of the row, for the element name passed.

Mapping: <TargetField> = GETSOURCEXML2STRING("

InvoiceRet

elementname")

Example : <TargetField> = GETSOURCEXML2STRING(

VALUE(

"

Id

batters")

)The "Id

<items> <item id="0001" type="donut"> <name>Cake</name> <ppu>0.55</ppu> <batters> <batter id="1001">Regular</batter> <batter id="1002">Chocolate</batter> </batters> <topping id="5001">None</topping> <topping id="5002">Glazed</topping> </item> ... </items>

The "batters" node element is found in the xml and returned as a string in the following format.

<batters> <batter id="1001">Regular</batter> <batter id="1002">Chocolate</batter> <batter id="1003">Blueberry</batter> </batters>


IF(Boolean condition, String trueValue, String falseValue)

This function tests the user-defined condition and returns one result if the condition is true, and another

result <TargetField> = IF(

if the condition is false.

Mapping : <TargetField> = IF(String,Integer,String)

Example: Salesforce object fields
Trigger: select unitprice, quantity from Product2
The above query retrieves fields unitprice and quantity from Product2 object of Salesforce. You can use IF function to check if either unitprice or quantity is returning '0' and add a validation accordingly.
<TargetField> = IF(LEN(VALUE("Quantity"))==0,"1",VALUE("Quantity"))

In this case the IF function checks the value of quantiy to be zero then it returns 1 or else it returns the original quantity value from the Salesforce.


<TargetField> = IF(ISEMPTY(VALUE("Rate")),"0.00",VALUE("Rate"))

In this case, the IF function checks for the value of

rate

Rate and finds it to be empty

then

. Then, it returns 0.00 or else it returns original rate value from the

Salesforce

Rate field.


ISEMPTY(String s)

This function returns true if the variable is unintialized or explicity set to empty; otherwise, it returns false.

Mapping: <TargetField> = ISEMPTY(

String)
Example: Salesforce object field
Trigger: Select Id, firstname, lastname from contact
The above query retrieves Id, firstname and lastname from contact object of Salesforce. You can use ISEMPTY() function to check whether the first name is empty or not. If the value of first name field is empty then the function return true, else return false.

"sourcefield")

<TargetField> = ISEMPTY(VALUE("FirstName"))

In the above example, the first name field has a value of "Alan" so the function ISEMPTY() returns true.


ISNULL(String s)

This function checks if the passed value is null then, it returns true; or else, it returns false.

Mapping: <TargetField> = ISEMPTY(

String) Example: Salesforce object field
Trigger: Select Id, firstname, lastname from contact
The above query retrieves Id, firstname and lastname from contact object of Salesforce. You can use ISNULL() function to check whether the lastname is null or not. If the value of lastname field is null then the function return true, else return false.

"sourcefield")

<TargetField> = ISNULL(VALUE("lastname"))

In the above example, the first name field has a value of "Alan" so the function ISNULL() returns false.


LEFT (String var)

This function returns the first character of the supplied string which is on left hand side.

Mapping: <TargetField> = LEFT(VALUE("

SourceField1

SourceField"))

Example1


Example: passing a string

<TargetField> = LEFT("search")

In this example, pass a string as "search". The LEFT() function returns the value as "s"

. Example2: Salesforce object fields
READER: Select Id, firstname, lastname from contact
The above query retrieves Id, firstname and lastname from contacts object of Salesforce. You can use LEFT() function to getthefirstcharacterofthefirstname field.

<TargetField> = LEFT(VALUE("FirstName"))

so the firstnamefieldhasavalueof"Salesforce" and the function will return 'S' which is the first character of string from the left

which is on the extreme left of the string "search".


LEFT(String var, int count)

This function returns the specified number of characters from the left of the given string.

Mapping: <TargetField> = LEFT(VALUE("SourceField1"),

noofcharacter

noofcharacters)

Example1


Example: passing a string

<TargetField> = LEFT("search",3)

In this example, pass the first parameter as "search" and the second parameter as 3. The LEFT() function will return three characters from the left of the parameter "search" and the function returns "sea".

Example2: Salesforce object fieldsTrigger: select Id, firstname, lastname from contact
The above query retrieves Id, firstname and lastname from contact object in Salesforce. You can use LEFT() function to get five characters of firstname field from the left side.

<TargetField> = LEFT(VALUE("FirstName"), 5)

so the firstname field has a value of "Salesforce" and the function will return 'Sales' which are the five character of string from the left.

Note: If the length of the passed string is less than the second parameter then the function will return a full string as a result.


LEN(String var)

This function returns the length of

the

a given string.

Mapping: <TargetField> = LEN(String)

Example1


Example : passing a string

<TargetField> = LEN("search")

In this example, pass the string as "search". The LEN() function will

return value

returns result as '6' which is the length of string "search".

Example2: Salesforce object fields
Trigger: select Id, firstname, lastname from contact
The above query will retrieve Id, firstname and lastname from contacts object of Salesforce. You can use LEN() function to get the lengthofeitherfieldfirstnameorlastname.

<TargetField> = LEN(VALUE("FirstName"))

The value in the firstname field has a value "mydbsync" and hence the LEN() function returns '7'.


LINK(String colName, String value)


Note: This function is deprecated and an alternative function could be MEMLOOKUP orTLOOKUP functions.


This function reads the second parameter passed through this function and sets it as an attribute to the column name which is passed through the first parameter.

Mapping: <TargetField> = LINK(VALUE("SourceField1"), VALUE("SourceField2"))

<TargetField>


<TargetField> = LINK(VALUE("Name"), VALUE("Id"))

In the "Name" node, the "Id" value will be
added as "sql" attribute's
assigned as a default value and the returned value is an object.

LINK(String colName, String query, String fieldName, String refValue, String objectName)


Note: This function is deprecated and an alternative function could be MEMLOOKUP orTLOOKUP functions.

The Link function is used to update Salesforce (Target) field with a source value based on the source identifier that remains unique across Salesforce (Target) as well as Source (Ex: Quickbooks) application.

The function creates an internally cached table querying the target (Salesforce) database with two columns

,

- the first column being the primary key for the table; and, the second for the other column name.
 
It then looks for a string that is the same across both the Source and Target system before updating the Target LOOK-UP(Salesforce) field with the Source field value.

Example: 


Mapping:

No Format
AVSFQB
AVSFQuickBooks__Opportunity__c = LINK("
AVSFQB
AVSFQuickBooks__Opportunity__c",
"Select id,
AVSFQB
AVSFQuickBooks__Quickbooks_Id__c from Opportunity",
"
AVSFQB
AVSFQuickBooks__Quickbooks_Id__c",LSPLIT(VALUE("TxnID"),"-"),
"Opportunity")
No Format
In the above example, we are trying to update Salesforce
look-up field
AVSFQB
AVSFQuickBooks__Opportunity__cbased on the condition
where
AVSFQB
AVSFQuickBooks__Quickbooks_Id__c is equal to Quickbooks
transaction Id "TxnID" as they both are same across both
Salesforce as well as Quickbooks.
No Format
In order to update Salesforce look-up field Opportunity
we are creating a cached table with the above query.
Then it does a lookup for all Opportunity records whose
Salesforce field
AVSFQB
AVSFQuickBooks__Quickbooks_Id__c value matches
with that of Quickbooks field "TxnID".

LINK(String colName, String query, String fieldName, String refValue, String objectName, String valueField)

Note: This function is deprecated and an alternative function could be MEMLOOKUP orTLOOKUP functions.


The function creates an internally cached table querying the target (Salesforce) database with two columns - first column being the primary key for the table; and, the second for the other column name.

Mapping: <TargetField> = LINK(VALUE("SourceField1"), VALUE("SourceField2"), VALUE("SourceField3"), VALUE("SourceField4"),VALUE("SourceField5"),VALUE("SourceField6"))

<TargetField>


Example : <TargetField> = LINK(VALUE("Name"), VALUE("Id"), VALUE("Phone"), VALUE("Id"), VALUE("Website"), VALUE("PhotoUrl"))

In "Name" node, default attribute values are set in order as "Id" value for "sql", "Phone" for "KeyField", "Website" for "ObjectIs", "PhotoUrl" for "ValueField". The last but second attribute refValue, here it is "Id", will be returned back.

LOG()


This
is not in function2baseThis
function is used to print the value of a parameter passed to the DBSync console. It can be used for debugging
purpose
.

Mapping: <TargetField> = LOG(VALUE("SourceField"))


Example : <TargetField> = {LOG("********ChainId"+LEFT(VALUE("Udf_Pa_Pricing"),20));return LEFT(VALUE("Udf_Pa_Pricing"),20);}


The log function

prints

gets the value of the target field "udf_pa_pricing"

to DBSync console whenever the process is run

while performing write operation and can be viewed in the logs section for debugging whenever there is an error.


LOOP

This function is different from the conventional '=' operator to map source and target.

<SourceField "loop" TargetField> is used in


scenarios where

a

grouping the Line Items are required based on the target identifier. It can also be used when the identifier is unique and the same across both source and target systems.

Example1:  Salesforce

OppotunityLineItems to InvoiceLineItems

Opportunity LineItems to QuickBooks Invoice LineItems

Mapping <TargetField> : InvoiceAddRq/InvoiceAdd/

InvoiceLineAdd

InvoiceLine Add [dbsync:loop] "OpportunityLineItems/records"

In the above example, for every opportunity Line Item, the loop will create a corresponding Invoice Line Item.

Example2:  Source - Database ; Target - Quickbooks
Database Query : select invoice_no,customerid,item,itemdesc from InvoiceTable
Mapping : InvoiceAddRq/InvoiceAdd/InvoiceLineAdd [dbsync:loop]  "invoice_no/list"

In the above example, we are using the "invoice_no" column from the database as an identifier. Based on this identifier, we are grouping each row as a line item and then mapping it with Quickbooks Invoice Line Item.


For instance, if the database Invoice table has four rows with "invoice_no" - being the same for all the four rows - then,

then

the mapping will create one Invoice in Quickbooks with four Line Items - rather than, creating one Invoice for each row.


LOOKUP(String adapterName, String queryString)


This function searches for a specific value in the source connector where the condition is passed in the form of a query to be searched on the first parameter.

Mapping: <TargetField> = LOOKUP("sourceconnector" , "querystring")

Example:<TargetField> = LOOKUP("Salesforce","select Id from Account where Name='Test'")

Theabove example with fetch the Id from

account

Account object of Salesforce from the source application and

assigns

assign it to the target field whenever the name field has a value of "Test".


LOWER (String var)

This function converts all

character

characters in a given string to lowercase.

Mapping: <TargetField> = LOWER(String)

Example1


Example: passing a string

In this example, pass a string as "SEARCH". The LOWER() function will return the string converted to lowercase.

<TargetField> = LOWER("SEARCH")

The function will return "SEARCH" as "search".

Example2: Salesforce object fields
Trigger: Select Id, firstname, lastname from contacts
The above query retrieves Id, firstname and lastname from contacts object of Salesforce. You can use LOWER() function to convert the FirstName and LastName to lower case.
<TargetField> = LOWER(VALUE("FirstName"))

The function will return the value of field firstname for "Avankia" as "avankia".


LPAD(String text, String pattern, int pad)

This function is used to pad the left side of a string with

the

a specific set of characters. The integer is the total length of the string returned after padding.

Mapping: <TargetField> = LPAD(VALUE("

SourceField1

SourceField"), "string", Int)

Example1: <TargetField> = LPAD("tech on the net", "0", 15)

The function

would

will return

reuslt

result as "tech on the net".

Example2: <TargetField> = LPAD("tech on the net", "0", 18)


The function

would

will return the result as "000tech on the net".


LSPLIT(String text, String splitter)

This function returns the split value of the string starting from the left side of a string till the splitter value.

Mapping: <TargetField> = LSPLIT(VALUE("SourceField"), "string")

Example: <TargetField> = LSPLIT ("tech-on-the-net", "-")


The LSPLIT() would return the result as "tech".


MAP(String key, String...mapEntries)

This function returns the value against the key passed from the key-value pair(s) passed via the second parameter of the function.

Mapping: <TargetField> = MAP(VALUE("string1", "string2", string3, string4)


Example: <TargetField> = MAP("myKey", "a=b", "c=d", "myKey=myValue")


The MAP function will return "myValue". If the key is not present in any of the key-value pairs then, the function will return an empty string.

MEMLOOKUP


MEMTABLE(String cacheIdentifier, String query)

This function

uses unique identifier of a query i.e cacheIdentifier which would load up the dataset for a lookup.This function creates a table in memory for returning the value of a lookup.Mapping: <TargetField> = MEMLOOKUP(StringCacheIdentifier, StringKey)
Example1: SALESFORCE OBJECT 
In this example, AccountID is the memory table created on Account object of Salesforce using MEMTABLE() function. 
<TargetField> = MEMLOOKUP("AccountID",VALUE("SourceField") ) 
Example2: DATABASE TABLE
In this example, AccountID is the memory table created on dbAccount table of database using MEMTABLE() function.
 
<TargetField> = MEMLOOKUP("AccountID", VALUE("SourceField") )

creates a data cache in the system. This data cache will be referred to using cacheIdentifier.
Once MEMTABLE function is called, the cacheIdentifier passed can be used to search data in the query (executed against the target connector).


MAPPING: MEMTABLE(StringCacheIdentifier, StringQuery)

Example: Database Table

MEMTABLE("AccountID","Select ID, Name from dbAccount")

In this example, a cache with the name "AccountId" will be created in the system. It will hold all the id's and names from dbAccount table as key-value pairs.

Assuming we have a_01→Name1, b_01→Name2 as data in dbAccount table, this function will create a map with these key-value pairs in the cache.


MEMLOOKUP(String cacheIdentifier, String key)

This function returns value against the key in the dataset referred by the cacheIdentifier.

Mapping: <TargetField> = MEMLOOKUP(cacheIdentifier, Key)

Example:

<TargetField> = MEMLOOKUP("AccountID", "a_01" ) 


In this example, AccountID is the name of the cache created using MEMTABLE function as explained in the previous example.

This function call will return "Name1" as the value as we have passed "a_01" as the key. Since in the previous example, a map was created as a_01→Name1, b_01→Name2, against the AccountId as cacheIdentifier.

In ideal scenarios, second parameter will not be hardcoded value like in the previous example but some other variable like VALUE("account_id").


For MEMLOOKUP to work, we need to make sure we have created a correct data set using MEMTABLE function.


MEMLOOKUPREGEX(String cacheIdentifier, String key, String regex)

A variant of the

This function is similar to MEMLOOKUP function

which takes an additional parameter i.e. regex, returns the value of only those key which matches with regex.

The value whose key starts with prefix, or null if not available

MEMTABLE(String cacheIdentifier, String query)

This function creates a memory table in DBSync with key -value pair of the query passed through this function.
You can append the MEMTABLE() at the end of any other mapping.MAPPING: <TargetField> = VALUE("SourceField") + MEMTABLE(StringCacheIdentifier, StringQuery)
Example1: SALESFORCE OBJECT 
Trigger: select Id, name from account
The above query retrieves Id, name from accounts object of Salesforce
<TargetField> = VALUE("SourceField") +MEMTABLE("AccountID","Select Id, name from Account") 
Example2: DATABASE TABLE
In this example, select ID and name value from dbAccount table for all records in dbAccount Table.
 
<TargetField> = VALUE("SourceField") +MEMTABLE("AccountID","Select ID, Name from dbAccount")

with an additional check of a regular expression against the key name.

If the passed key matches the pattern passed in the regex, it will return the corresponding value; otherwise, it will return an empty string.

Mapping: <TargetField> = MEMLOOKUP(cacheIdentifier, key, regex)

Example:

<TargetField> = MEMLOOKUP("AccountID", VALUE("account_id"), "^a_" ) 

The above adds an additional regex parameter. It states that the function will match only keys starting with "a_". In this example, the function will not return any value from VALUE("account_id") that doesn't start with "a_".


MID(String text, Int startNum, Int numChars)

This function extracts a substring from the string and returns the substring.

Mapping: <TargetField> = MID(VALUE("sourcefield"), startnum, numchars)

Example :
SALESFORCE OBJECT 
Trigger: Select Id, firstname, lastname from contacts
The above query retrieves Id, firstname and lastname from contacts object of Salesforce.
<TargetField> = MID(VALUE("Firstname"), 6, 5)
The functions return the

In this example, the value of "Firstname" is "christopher". So, the function returns the five characters of the
name field
"christopher" beginning with the sixth character from the left. The result is "tophe".
NOTEQUALS(String v1, String v2)This function compares the value with another value and returns true if it is not
equals
equal; or else, it returns false.

Mapping: <TargetField> = NOTEQUALS("string1","string2")


Example : <TargetField> = NOTEQUALS(VALUE("CurrencyISO"),"USD")


This function compares

USD in CuurencyISO field and if USD is not found then it returns as true else false.

NUMBER(String text)

This is not in UI

This function returns an integer value of the string passed to it.

MAPPING: <TargetField> = NUMBER("String")
Example: Salesforce object fields
Trigger: Select name, numberofemployees from lead
The above query will retrieve name and number of employees from leads object of Salesforce. You can use NUMBER() function to convert the values of the number of employees field to integer format.
<TargetField> = NUMBER(*VALUE("NumberOfEmployees"))*If the value for Number of Employees is null or empty then the function will return Zero

"USD" against all the values of "CurrencyISO" field. If the function finds there is a value "USD" then, it returns true.


OR(boolean exp1, boolean exp2)

This function evaluates the conditions passed through the function and returns true if any one of the condition evaluates to true; otherwise, it returns false.

Mapping: <TargetField> = OR(Boolean, Boolean)

Example :

Salesforce object fields
Trigger: select Id, firstname, lastname from contact
The above query will retrieve Id, firstname and lastname from contacts object of Salesforce. You can use OR() function to check whether the fields of first name and last name are having same values or Id equals to 123.TargetField If both the conditions are false then the function will return false

<TargetField> = OR(VALUE("FirstName")==VALUE("LastName"), VALUE("Id")=="123")

  • If both the conditions are true then the function will return true.
  • If the first condition is true and second condition is false then the function will return true.
  • If the first condition is false and second condition is true then the function will return true.

    • In the above function, the 'firstname' has a value "Alan"; the last name has a value "Chris"; and, the Id field has a value of 456. The value of 456 is not equivalent to 123 and hence, the function returns false.


    PARAM(String name)

    This function PARAM

    extract

    extracts the values from the session which is in the format PARAM.SOURCE_Object.Variable=PARAM.TARGET_Object.Variable and returns the variable value.

    Mapping: <TargetField> = PARAM(''string'')


    Example :<TargetField> = PARAM(VALUE("Description"))

    If the value of "Description" starts with "PARAM" and the value is present in the session then,
    then
    the third text literal is extracted and returned.
    PARAM_PARENT(String name)This function PARAM
    extract
    extracts the values from the session which is in the format PARAM.SOURCE_Object.Variable=PARAM.TARGET_Object/Variable and
    return
    returns the parent value.

    Mapping: <TargetField> = PARAM_PARENT(''string'')

    Example: <TargetField> = PARAM_PARENT(VALUE("Description"))

    If the value of "Description" starts with "PARAM" and the value is present in the session then,

    then

    the second text literal is concatenated with "/" and third text literal and returned.


    PARENTVALUE(String name)This function reads any node
    element
    elements and returns the immediate parent value of the node element passed.

    Mapping: <TargetField> = PARENTVALUE("

    SourceField1

    sourcefield")

    Example : Salesforce object fields


    Trigger: select Id, name, account.name from opportunity.


    The above query will retrieve ID, Name and Account name from Opportunity object of Salesforce.

    <TargetField> = PARENTVALUE("Account/Name")

    This function retrieves the value of the Account Name - which is a lookup against each Opportunity - and returns to the assigned target field.

    PARENTVALUEATTR(String path, String attr)This function reads the passed node element and returns attributes of the immediate parent node.

    Mapping: <TargetField> = PARENTVALUEATTR("stringpath","attr")

    Example : <TargetField> = PARENTVALUE("CustomerRef","Name")

    <CustomerRef>

    <Name>Alan</Name>

    </CustomerRef>

    In this example the CustomerRef object has a Name field in the form of XML. It will return the value as "Alan".


    PROPER(String text)This function reads a string and converts the first letter of a word to upper case and rest of the alphabets in a word to lower case. This is used to represent camel notation.

    Mapping: <TargetField> = PROPER("SourceField1")


    Example: <TargetField> = PROPER("search")

    In this example,

    I will pass

    since Pass string has "search" as the parameter

    then

    , the function returns the result as "Search".


    REPLACE (String oldText, Int startNum, Int numChars, String newText)

    This function replaces a full string, or a part of string text, with another text string from the position sent through parameter i.e. startNum.


    Mapping: <TargetField> = REPLACE(VALUE("

    SourceField1

    SourceField"), 1, 5, "replace string")

    Example1


    Example: Pass a string

    <TargetField> = REPLACE("search",3,3,"a")

    In this example,

    I will pass string

    Pass string has - (1) "search" as the first parameter

    ,

    ; (2) 3 as start number for the second parameter

    ,

    ; (3) 3 as a number of characters to be replaced for the third parameter; and, (4) "a" as the

    replace

    replacement string. The REPLACE() function will replace three characters from

    3rd

    the third character to

    5th

    the fifth character in the string. The resulting string returned by the function will be "search".

    TargetField = REPLACE("seaaarch",3,3,"a")
    Example2: salesforce object field
    READER: Select Id, FirstName, LastName from Contacts
    The above query will select Id, FirstName and Last Name from contacts object in Salesforce. You can use REPLACE() function to replace specified number of characters of FirstName with specified string. If the VALUE for FirstName is "salesforce" as first parameter, VALUE of start number is 2 as second parameter, VALUE for number of characters is 4 for third parameter, and VALUE of Replace String is "f-", then function REPLACE() will return string "sf-force".
    TargetField = REPLACE(VALUE("FirstName"),2,4,"f")
    Note: VALUE() function is used inside REPLACE() to convert the FirstName VALUE to string.


    REPT(String text, Int numberOfTimes)This function returns a string consisting of a supplied text string, repeated specified number of times.

    Mapping: <TargetField> = REPT(VALUE("

    SourceField1

    sourcefield"), 2)

    Example:

     

    <TargetField> = REPT("tech", 2) 


    In the above example, the function REPT() would return result string as "techtech".


    RIGHT(String var)

    This function returns a

    right most

    rightmost character of the string value passed.

    Mapping:

    TargetField

    <TargetField> = RIGHT(String)

    Example1


    Example:

    STRING PARAMETER

    String Parameter

    In this example,

    I will pass string as

    the Pass string is "search". The RIGHT() function will return the first character from the right of the string "search". So string returned by the function will be "h".

    TargetField


    <TargetField> = RIGHT("search",1)

    Example2: SALESFORCE OBJECT FIELDS
    READER: Select Id, FirstName, LastName from Contacts
    The above query will select Id, FirstName and Last Name from contacts object in Salesforce. You can use


    RIGHT(

    ) function to get last last characters of FirstName. If the VALUE for FirstName is "salesforce" the resulting string will be "e".
    <TargetField> = RIGHT(VALUE("FirstName"))
    Example 3: DATABASE FIELDS
    READER: Select Id, FirstName, LastName from dbContacts
    The above query will select Id, FirstName and Last Name from contacts in database. You can use RIGHT() function to get last last characters of FirstName. If the VALUE for FirstName is "salesforce" the resulting string will be "e".
    <TargetField> = RIGHT(VALUE("FirstName"))RIGHT(

    String var, Int count)

    This function returns a specified number of characters from the end of a supplied text string.

    Mapping: <TargetField> = RIGHT(VALUE("SourceField1"), NoOfCharacters)

    Example1


    Example:

    STRING PARAMETER

    String parameter

    In this example,

    I will pass

    Pass first string

    as

    is "search" and, the second parameter

    as

    is 5. The RIGHT() function will return

    5

    five characters from the right of the string "search". So, the string returned by the function will be "earch".

    <TargetField> = RIGHT("search",5)

    Example2: SALESFORCE OBJECT FIELDS
    READER: Select Id, FirstName, LastName from Contacts
    The above query will select Id, FirstName and Last Name from contacts object in Salesforce. You can use RIGHT() function to get last 5 characters of FirstName. If the VALUE for FirstName is "salesforce" the resulting string will be "force".
    <TargetField> = RIGHT(VALUE("FirstName"), 5)
    Example 3: DATABASE FIELDS
    READER: Select Id, FirstName, LastName from dbContacts
    The above query will select Id, FirstName and Last Name from contacts in database. You can use RIGHT() function to get last last characters of FirstName. If the VALUE for FirstName is "avankia" the resulting string will be "a".
    <TargetField> = RIGHT(VALUE("FirstName"),1)
    Note: If


    Note: If a number of characters in the string

    is

    are less than the number of characters requested from the function, it will return the full string.

    VALUE() function is used to convert the FirstName to string.


    RPAD(String var, String value, Int size)This function returns a string after padding the input string with extra characters from the right side. The user can pass the size of the input string
    till which
    until where the padding should be done.

    Mapping: <TargetField> = RPAD(VALUE("SourceField1"), "string", Int)

    Example1


    Example 1:


    <TargetField> = RPAD("tech on the net", "0", 15)

    would return

    The function will return result string as "tech on the net".

    Example2


    Example 2:


    <TargetField> = RPAD("tech on the net", "0", 18)

    would

    The function will return result as "tech on the net000".


    RSPLIT(String var, String splitter)This function takes splitter text and compares it with the variable text
    and
    . The function splits
    the
    variable text
    basing
    based on the splitter text and returns
    character
    the number of characters after the splitter text to the right.

    Mapping: TargetField = RSPLIT(VALUE("SourceField"), "string")

    Example:


    <TargetField> = RSPLIT ("tech-on-the-net", "-")

    would return

    This function will return result string as return "net".


    SEARCH(String findText, String withinText)

    This function returns the position of a supplied text string from within a supplied text string.

    Mapping: <TargetField> = SEARCH(VALUE("SourceField1"), VALUE("SourceField2"))

    Example1


    Example: String parameters

    In this example,

    I will pass

    Pass the first string

    as

    is "arch"; and, the second string

    as

    is "search". The SEARCH() function will return the place value of "arch" in "search". So it will return 3 as the place value.

    <TargetField> = SEARCH("arch","search")

    Example2: Salesforce object fields
    READER: Select Id, firstname, lastname from Contacts
    The above query will retrieve Id, firstname and lastname from contacts object of Salesforce. You can use SEARCH() function to check whether LastName is already existing in FirstName and If it is not existing in the FirstName it will return 0 else it will return the place VALUE of the LastName in FirstName.
    <TargetField> = SEARCH(VALUE("LastName"), VALUE("FirstName"))


    Note: If the search string exists more than once in the

    Second

    second string, the function returns the place

    VALUE

    value of the first

    existence

    instance.


    SEARCH(String findText, String withinText, int startNum)

    This function returns the position of a supplied text string from within a supplied text string for which starting position can be specified.

    Mapping: <TargetField> = SEARCH(VALUE("SourceField1"), VALUE("SourceField2"), "Start Position")

    Example : String parameters

    <TargetField> = SEARCH("arch","search",2)

    In this example,

    I will pass

    Pass the first string

    as

    is "arch"; and, the second string

    as

    is "search". The SEARCH() function will search the string "arch" in "search" from the second position in the string and will return the place value of "arch" in "search". So it will return 3 as the place value. So the character 's' will be ignored.

    <TargetField> = SEARCH("arch","search",2)
    Example2: Salesforce object field
    Trigger: select Id, firstname, lastname from contact
    The above query retrieves Id, firstname and lastname from contacts object of Salesforce. You can use SEARCH() function to check whether lastname is already existing in firsnName and If it is not existing in the firstname it will return 0 else it will return the position of the lastname in firstname.
    <TargetField> = SEARCH(VALUE("FirstName"), VALUE("LastName"),1)


    Note: If the search string exists more than once in the second string, the function returns the position of the first

    existence

    instance.


    SESSION_GET(String name)This function returns the value of the key stored in the session of that particular process or workflow.

    Mapping: <TargetField> = SESSION_GET("KEY")

    Example: Retrieving the "key" stored in the session.

    Mapping :

    CustomerAddRq/CustomerAdd/Name = SESSION_GET("Account_Name")

    In the above example, we are retrieving the KEY

    ie.

    , "Account_Name", of the Salesforce

    opportunity

    Opportunity object stored in the session

    and

    . The value

    that

    is being parsed internally

    in

    that

    of what

    was stored in the session

    ,

    - "Avankia".


    SESSION_PUT(String name, String value)

    This function stores the key/value pair in the session of

    that particular

    an active process or workflow

    which is active

    . This function

    can

    will only work

    activeworkflowswithinDBSync

    with active workflows within DBSync.

    Mapping:

    out

    <TargetField> = SESSION_PUT("KEY","VALUE")

    Example1

    Example: Storing a static value (Account_Name) in the session

    Trigger: Salesforce
    Writer : ConsoleAdapter
    Mapping :


    out

    (target field)

    = SESSION_PUT("Account_Name","Avankia")

    In the above example we are storing


    The example stores a static key/value pair for an "AccountName". This assigns the value "Avankia" to the key "Account_Name" - which can be retrieved using SESSION_

    GET variable

    PUT variable and printed to the console.


    SETATTR(String colName, String attName, String attValue, String colVal)

    This function sets the column with an attribute of name and value as specified. The column value would be set as specified in the colVal.

    Eg: SETATTR("Name","priceBook","Standard PriceBook",VALUE("Name"))

    Example :

    This function can only be applied when writing to Salesforce for the Pricebook object.


    Mapping: <TargetField> = SETATTR(TargetField, TargetobjectName, Targetobjecttype, sourcefield1)

    Example :SETATTR("PricebookEntryId","pricebook","Standard Price Book",VALUE("ItemRef/FullName"))

    This function is used to query Pricebook object i.e.( select pricebookentryid where name=standardpricebook and itemref/fullname = pricebookentryid) and if the condition is satisfied it returns the value of pricebookentry id and assigns it to the mapped target field.


    SUBSTITUTE(String str, String oldStr, String newStr)This function replaces all occurrences of a string, within an old string, with the passed new string.

    Mapping: <TargetField> = SUBSTITUTE("sourcefield", "string1", "string2")

    Example: <TargetField> = SUBSTITUTE(VALUE("FirstName"), "John" "Alan")

    In the above example all of "firstname" field records - that are having a value as "John" - will be replaced with "Alan".


    SUBSTITUTE(String str, String oldStr, String newStr, int occurrences)This function replaces the specified number of occurrences of a string, within an old string, with the passed new string.

    Mapping: <TargetField> = SUBSTITUTE("sourcefield", "string1", "string2", occurences)

    Example : TargetField = SUBSTITUTE(VALUE("FirstName"), "John" "Alan",2)

    In the above example, the firstname field will have values "John" with "Alan" respectively, for the first two occurrences only.

    TEXT(Arg 0, Arg1)
    Not Currently ImplementedTargetField
    This function is not currently supported.

    TLOOKUP(String queryString)

    		Returns the value for the column in the query. In the query, only one column can be specified.

    Mapping: <TargetField> = TLOOKUP(stringQuery)

    Example1: SALESFORCE OBJECT
    In this example, I will select ID value for Account with name as ABC.


    Example: QuickBooks Invoice to Salesforce opportunity

    AccountID = TLOOKUP("Select Id from Account where

    Name

    AVSFQuickBooks__Quickbooks_Id__c='"+

    "ABC"

    VALUE("CustomerRef/FullName/CustomerRet/ListID")+"'")

    Example2: DATABASE TABLE
    In this example, I will select ID value for Account from dbAccount table with name as ABC.
     
    <TargetField> = TLOOKUP("Select Id from dbAccount where Name ='" + VALUE("NAME") +"'")
    Here assumption is that NAME field contains value ABC.

    In the above example, we are updating the Opportunity object of Salesforce by reading invoice records from the QuickBooks. The query passed inside the function will fetch the customer List ID (in this case, the value of List id is "12345") from the QuickBooks and match it with the Account ID of Salesforce - which, in this case, is also "12345". This means the customer record exists in Salesforce. As a result, related invoice records from QuickBooks will update information in the related Opportunity object.


    TODAY()

    This function returns Today's date

    Mapping: <TargetField> = TODAY()

    .Format returned from TODAY() is "Day Mon DD HH:MM:SS TTT YYYY"

    Mapping: <TargetField> = TODAY()

    Example: Fri May 06 07:10:58 CDT 2011.


    TRIM(String value)This function returns a text value with the leading and trailing, spaces removed.

    Mapping: <TargetField> = TRIM(VALUE("sourcefield"))

    Example : <TargetField> = TRIM(VALUE("

    sourcefield1

    FirstName"))

    In the above example the field of "firstname" has a value " John" so the TRIM() function will remove the leading space and will return the result as "John".


    UNIQUEFIELD(String colName, String value, String colValue)

    This function sets the column with the column value and

    attribute

    attributes with the unique field value and returns as an object.

    <Object>
    Mapping: <TargetField> = UNIQUEFIELD(sourcefield, stringvalue, sourcefield value)

    Exmaple : <TargetField> = UNIQUEFIELD(VALUE("Name"), VALUE("Id"), VALUE("Phone"))

    In "Name" node, the "Id" value will be added as "uniquefield" attribute
    's
    value and the last attribute is returned as an object.

    UPPER(String text)

    This function converts all the

    character

    characters in a passed string to the upper case.

    Mapping: <TargetField> = UPPER(String)

    Example1: STRING PARAMETER


    Example: <TargetField> = UPPER("search")

    In this example,

    I will pass

    Pass string

    as

    is "search". The UPPER() function will

    return

    convert the lowercase string

    converted to lowercase

    . So "search" string will be returned as "SEARCH"

    and that VALUE will be placed in target field

    .

    <TargetField> = UPPER("search")
    Example2: SALESFORCE OBJECT FIELDS
    READER: Select Id, FirstName, LastName from Contacts
    The above query will select Id, FirstName and Last Name from contacts object in Salesforce. You can use UPPER() function to get length of FirstName or LastName. If the VALUE for FirstName is "Avankia" the resulting string returned by function will be "AVANKIA".
    <TargetField> = UPPER(VALUE("FirstName"))
    Example 3: DATABASE FIELDS
    READER: Select Id, FirstName, LastName from dbContacts
    The above query will select Id, FirstName and Last Name from contacts in the database. You can use an UPPER() function to get the length of FirstName or LastName. If the VALUE for FirstName is "Dbsync" the resulting string will be "DBSYNC".
    TargetField = UPPER(VALUE("FirstName")


    VALIDATEROW()This function returns true and is used only for validation of a rule section to check whether any
    conditon
    condition is satisfied.

    Mapping: <TargetField> = Conditional Statement

    Example:

    <VALIDATEROW> = IF(ISEMPTY(VALUE("OpportunityId")),"true","false")

    This condition will execute a row only if the field of "opportunityid" has a value and returns true; or else, it returns false. In the above example, the opportunitydid has a value of null and returns false.


    VALUE(String xPath)

    This function converts the input parameter to be read as string and returns the passed value as string.

    MAPPING: TargetField = VALUE("SourceField")

    Example

    1: Salesforce object field
    Trigger: Select Id, name from account
    The above query will select ID and Name from Account object in Salesforce. You can use VALUE () function to map the VALUE of name field to target field.
    TargetField = VALUE("Name")

    : <TargetField> = VALUE("Name")

    In the above example the "Name" field is read as string by the system. The "Name" field has a value of "John" which in itself is returned as string.

    VALUE(String xPath, boolean treatAsEmpty)This function converts the input parameter to be read as string and returns the passed values as string.
    Example : Salesforce object fields
    Trigger : select Id, name, account.name from opportunity
    The above query will select ID, name and account name from opportunity object of Salesforce. You can use VALUE () function to map the lookup field account name to the target field.
    <TargetField> = VALUE("Account/Name")
    The function returns empty string if the parameter has no value in it.

    MAPPING: TargetField = VALUE("SourceField", true)

    XML Sample :

    <person gender = "female">

    <firstname>Alan</firstname>

    </person>

    <TargetField> = VALUE("person/firstname", true)

    In the above example, as the "firstname" attribute has a value of "Alan" so the function will return "Alan". To understand better, let us assume the firstname has no value in the attribute so the function returns the string as empty string as, the second parameter is set to true.


    VALUEATTR(String xPath, String attr)This function takes a path and attribute name
    on
    . And, it
    and
    returns the actual value of the attribute.

    Mapping: TargetField = VALUEATTR("

    CustomerRef

    xpath","name")

    XML Sample :

    <person gender = "female">

    <firstname>Alan</firstname>

    </person>

    <TargetField> = VALUEATTR("person", "gender")

    In the above example, the function returns second passed attribute value i.e. female from the xml sample.