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 Cast Iron® 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

  1. In the Activities tab, open the ServiceMax directory to find the Upsert Objects activity.
  2. Add the activity to an orchestration. The Checklist and Summary for the activity are displayed beneath the orchestration.
  3. Select a ServiceMax endpoint. For instructions on creating or editing a ServiceMax endpoint, see Creating or editing a ServiceMax endpoint.
  4. Configure the activity, by choosing a ServiceMax object type and object field preferences.
    Note: You can only choose object types that the Integration Appliance can update or create and contain at least one External ID field. When you select the object type, Studio displays the external IDs defined on the object type in the External ID field of the Configure pane. You cannot edit the IDs listed in the External ID list. The external ID that you select becomes a required field, you cannot clear this field from the Object Field Preferences table. If only one external ID is available, Studio automatically selects this field in the Object Field Preferences table.
  5. Specify the Retry and Time out parameters for the activity.
  6. Map the input of the activity.
  7. Map the output of the activity.

Results

Map the input of the Upsert Objects activity

  1. In the Checklist, select Map Inputs. The objects element is displayed in the To Activity panel.
  2. 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
  3. Click Select Inputs... and select the input variable or variables for the map. For instructions about creating variables, see Creating variables.
  4. 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

  1. In the Checklist, select Map Outputs. The upsertResults element is displayed in the From Activity panel.
  2. Click Select Outputs... and select the output variable or variables for the map. For instructions about creating variables, see Creating variables.
  3. As appropriate, map the output parameters to the variable or variables. For mapping instructions, see Creating a map.



Feedback | Notices


Timestamp icon Last updated: Wednesday, 15 June 2016


http://pic.dhe.ibm.com/infocenter/wci/v7r0m0/topic/com.ibm.wci.doc/SerMax_Upsert_Objects_Activity.html