Send External Object

Last modified: December 1, 2023

1 Introduction

The Send external object activity can be used to persist changes to an external object. It can be used to send objects that have been first retrieved and then changed, or to send newly created objects.

2 Using This Activity

Use this activity with updatable external entities to send objects that have been first retrieved and then changed, or with creatable external entities to send newly created objects.

2.1 Updatable External Entities

External entities may have updatable attributes. The values of these attributes can change; for example, in a widget, or by using the change object activity. Associations between two external entities from the same OData service may be updatable as well.

Use the Send External Object activity to send the changed attributes and the changed associations that the entity owns to the app that publishes the entity. That app will persist the changes, overwriting the previous values of the attributes and associations.

Only the changes are sent. If two users make changes to different attributes or associations, these changes are applied separately. For changed associations, this activity sends only the object identifiers of the objects that have been added to or removed from the association.

2.2 Creatable External Entities

This activity sends new objects and their attributes and owned associations to be inserted in the external app.

3 Activity Properties

To manage the properties of the activity, double-click the Send external object activity, or right-click the activity and select Properties.

Single-clicking on the activity displays the properties in the Properties pane.

3.1 Object

Choose a variable that contains a single insertable or updatable external object.

3.2 Refresh in Client

This setting defines how changes are reflected in the pages presented to the end-user. The default for this setting is No.

4 After the Activity

After this activity, the $latestHttpResponse variable (of the HttpResponse type) is available to inspect the response returned by the service.

After this activity, an external object is updated based on the received response.

Persistable objects are persisted by using the commit activity. External entities cannot be committed. Use this activity instead.

The Save button does not work for external entities, either. To persist changes to an external object on a page, use a microflow that has this activity.