Upsert Objects activity
Use this activity to update existing objects or create new objects in ServiceMax.
About this task
The activity uses an external ID, usually a foreign key, to determine whether to update an existing object or create a new object in ServiceMax.
While the Salesforce.com API limits the number of objects that it can create in a single upsert call to 200 objects, the App Connect ServiceMax connector does not have such a limit. You can use the Upsert Objects activity to create an unlimited number of objects.
To use the Upsert Objects activity:Procedure
Results
Map the input of the Upsert Objects activity
- In the Checklist, select Map Inputs. The objects element is displayed in the To Activity panel.
- Right-click the default node and choose Show
Optional Parameters, to show the optional input parameters
for this activity:
- AssignmentRuleHeader
- MruHeader
- EmailHeader
- CallOptions
- connection
- sessionInfo
- Click Select Inputs... and select the input variable or variables for the map. For instructions about creating variables, see Creating variables.
- As appropriate, map the input parameters to the variable or variables. For mapping instructions, see Creating a map.
This activity supports the following optional input parameters:
- AssignmentRuleHeader
- EmailHeader
- MruHeader
Optional and nillable field elements have the following behavior:
- The Integration Appliance does not update an optional field, when the ServiceMax server does not provide a value for the field.
- If you set the xsi:nil attribute to true on a nillable field,
the Integration Appliance sets the field to null during an update.Note: Setting a field to an empty string does not set a field to null.
Map the output of the Upsert Objects activity
- In the Checklist, select Map Outputs. The upsertResults element is displayed in the From Activity panel.
- Click Select Outputs... and select the output variable or variables for the map. For instructions about creating variables, see Creating variables.
- As appropriate, map the output parameters to the variable or variables. For mapping instructions, see Creating a map.