ExecuteChanges Operation

 

Client Declaration

Allows Content Engine objects to be created, updated, and deleted.

This operation supports one-at-a-time operations on non-repository objects and batch (atomic) operations on repository objects (with the restriction that all the objects in the batch must belong to the same object store).

 

Request

An ExecuteChangesRequest element, which specifies the following:

A typical structure of an ExecuteChanges request is as follows. Elements that are derived from their base element are in parenthesis:

ExecuteChangesRequest ExecuteChangesRequest
     ChangeRequestType ChangeRequestTypeArray[0]
          (CreateAction)ActionType Action[0]
          (CheckinAction)ActionType Action[1]
               .
               .
          (SingletonString)ModifiablePropertyType ActionProperties[0]       
          (SingletonInteger32)ModifiablePropertyType ActionProperties[1]
               .
               .   
          PropertyFilterType RefreshFilter
               FilterElementType IncludeProperties[0]
               FilterElementType IncludeProperties[1]
                    .
                    .
               FilterElementType IncludeTypes[0]
               FilterElementType IncludeTypes[1]
                    .
                    .
          ObjectReference(ObjectSpecification) TargetSpecification
     ChangeRequestType ChangeRequestTypeArray[1]
          .
          .

 

Response

ExecuteChanges has the following output, depending on whether it is successful or not:

A typical structure of an ExecuteChanges response is as follows. Elements that are derived from their base element are in parenthesis:

ChangeResponseType ChangeResponseTypeArray[0]
     PropertyType(SingletonString) Property[0]
     PropertyType(SingletonInteger32) Property[1]
               .
               .			   
ChangeResponseType ChangeResponseTypeArray[1]
     .
     .

 

Remarks

There is a practical, unfixed limit on the number of operations that can be successfully performed in an ExecuteChanges batch. If there are too many operations, a transaction timeout occurs and an exception is reported. The transaction timeout can be increased on the Content Engine server by running the Microsoft® Windows® Component Services administrative tool and following this procedure:

  1. Navigate to Component Services/Computers/My Computer/COM+ Applications/Content Engine Object Store Service/Components/FNCE.ObjStoreUpdate.1.
  2. Right-click FNCE.ObjStoreUpdate.1 and select Properties from the context menu.
  3. Select the Transactions tab.
  4. Select the Override global transaction timeout value checkbox and enter a value in the Transaction timeout (seconds) text box.
  5. Click OK to save and close the dialog.

 

XML Schema

<operation name="ExecuteChanges">
   <input message="tns:ExecuteChangesRequest"/>
   <output message="tns:ExecuteChangesResponse"/>
   <fault message="tns:FaultResponse" name="GeneralError"/>
</operation>