Reference - Integration bus data types

This page describes the data types that you can work with when implementing integration connectors.

Classes

BaseInfo

Represents any site‑related or global data object in Xperience (for example a user).

TreeNode

Represents a page in the content tree of a website.

Interfaces

ICMSObject

An interface implemented by both BaseInfo and TreeNode objects. Allows you to identify Xperience data types.

Enumerations

TaskTypeEnum

Namespace: CMS.DataEngine

Always accompanies processed objects and pages. The value has a slightly different meaning for outgoing and incoming tasks:

• for outgoing tasks – used when creating subscriptions and determines which actions are handled as integration tasks. For example, when you subscribe to CreateObject, the integration bus logs synchronization tasks when objects inheriting from BaseInfo are created.
• for incoming task – determines what happens to the target object when processing tasks. For example, when you pass a page object and task type DeleteDocument, the integration bus deletes the page.

The most common values for objects are:

• CreateObject
• UpdateObject
• DeleteObject
• AddToSite (not applicable for global objects)
• RemoveFromSite (not applicable for global objects)
• All – only makes sense for the outbound direction (for subscriptions). Indicates that the integration bus creates tasks for all types of object operations and changes.

The most common values for pages are:

• CreateDocument
• UpdateDocument
• DeleteDocument
• PublishDocument
• ArchiveDocument
• All – only makes sense for the outbound direction (for subscriptions). Indicates that the integration bus creates tasks for all types of page operations and changes.

To see the whole list of values, explore the enumeration in Visual Studio.

TaskDataTypeEnum

Namespace: CMS.Synchronization

This enumeration determines the types of data which can be synchronized in the synchronization tasks:

• Simple – this option synchronizes only the main object.
• SimpleSnapshot – synchronizes the main object along with the translation information.
• Snapshot – synchronizes the main object with its child objects and bindings.

Translation information enables translation of foreign keys between Xperience and external systems. When using synchronous processing, the required data can be obtained directly within the context of the application.

Possible values and the data which they can synchronize:

Note: Simple and SimpleSnapshot options do not support synchronous processing.

TaskProcessTypeEnum

Namespace: CMS.Synchronization

Values of this enumeration represent all supported combinations of synchronization modes and data types. When the system searches for connectors with a subscription that matches an operation, and one connector has multiple subscriptions, the system selects the first subscription according to the following priority (highest to lowest):

• SyncSnapshot
• AsyncSnapshot
• AsyncSimpleSnapshot
• AsyncSimple

There is only one synchronous option – SyncSnapshot. This is given by the nature of synchronous processing, where you can always access related objects (parent, children, etc.) using the API.

IntegrationProcessResultEnum

Namespace: CMS.Synchronization

This enumeration stores possible results of outgoing tasks after being processed by external applications. The result determines what happens after the processing of each task. Possible values are:

IntegrationProcessTypeEnum

Namespace: CMS.Synchronization

Values of this enumeration are used during the processing of incoming tasks. The value determines whether to process the task immediately and how to proceed when an error occurs.