A quick article to assist in resolving a common error message when creating a map to Salesforce.
First, we should address how SmartConnect sends data to Salesforce. SmartConnect connects to Salesforce using the SOAP API. For every record SmartConnect makes two calls to the web service. The first call is a SOQL query to check if the record exists, and the second call will create or update the record.
The SOQL Query
SmartConnect will run a query in Salesforce to return the Id of any existing records. The query will search using one of two logics. The first option, is a query with a where clause for each record used in the grouping of the destination. The second option is a query with a where clause using an External Id field.
*Note that if you map a field that is setup in Salesforce as an External Id, that field will be used in the lookup, and not the fields used in the grouping.
Trailing Spaces
We commonly see an issue with trailing spaces when the data source is GP. GP will put trailing spaces into fields which will cause a mismatch when mapping to Salesforce.
The workaround is to use a trim in your data source such as the following.
RTrim(RM00101.CUSTCLAS) As CUSTCLASS
Case Sensitivity
Salesforce Ids are case sensitive, so if you have saved the Salesforce Id to another system, make sure it has not changed the case.
External Id
If the issue isn’t one of the other two, then it is likely you have mapped a field that is setup in Salesforce as an External Id. Check in Salesforce to verify if there are any External Id fields on that object.