Client Declaration
public ChangeResponseType[] ExecuteChanges(ExecuteChangesRequest[] ExecuteChangesRequest)
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).
An ExecuteChangesRequest
element, which specifies the following:
ExecuteChanges
returns a refreshed object.ChangeRequestType
elements, each of which specifies an object and actions to act on that object and 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
ExecuteChangesRequestChangeRequestType
ChangeRequestTypeArray[0] (CreateAction
)ActionType
Action[0] (CheckinAction
)ActionType
Action[1] . . (SingletonString
)ModifiablePropertyType
ActionProperties[0] (SingletonInteger32
)ModifiablePropertyType
ActionProperties[1] . .PropertyFilterType
RefreshFilterFilterElementType
IncludeProperties[0]FilterElementType
IncludeProperties[1] . .FilterElementType
IncludeTypes[0]FilterElementType
IncludeTypes[1] . .ObjectReference
(ObjectSpecification
) TargetSpecificationChangeRequestType
ChangeRequestTypeArray[1] . .
ExecuteChanges
has the following output, depending on whether it is successful or not:
ExecuteChangesRequest
refresh
flag used for input:
false
: Output is empty.true
: Output is an array ofChangeResponseType
elements, which specify the latest state of created or updated objects resulting fromExecuteChanges
. EachChangeResponseType
element matches aChangeRequestType
element used in theExecuteChanges
input array and is composed of the following:
- A specified Content Engine object.
- An array of specified Content Engine properties and their current values.
- For a
ChangeRequestType
element containing aDelete
action, the correspondingChangeResponseType
element is empty; otherwise, it contains the properties values representing the up-to-date state of the created or modified object.
ErrorStackType
element is returned. 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:
<operation name="ExecuteChanges"> <input message="tns:ExecuteChangesRequest"/> <output message="tns:ExecuteChangesResponse"/> <fault message="tns:FaultResponse" name="GeneralError"/> </operation>