paste
Synopsis
string[] paste(SessionId sessionId,
BItemId fatherId,
BItemId beforeId,
string uri,
PasteOptions options)
throws BasketServiceFault;
See also: SessionId, BItemId, PasteOptions, BasketServiceFault
The paste operation of the basket web service is used to de-serialize the items contained in an OBX stream and insert them into the current basket at the position specified by the fatherId and beforeId parameters.
In general, OBX streams contain a forest of items. The root items are inserted as children of the parent item specified by fatherId, or the top folder if fatherId is the NIL ID.
If beforeId is the NIL ID, or if the item specified by beforeId is not a descendant of the parent item, they are inserted at the end the list of children of the parent item. Otherwise, they are inserted into the list of child items immediately before the child item which is either the item specified by beforeId, or one of its ancestors.
If the value of the uri parameter must be an URI returned by the copy operation, an URL returned by the getUploadURL operation of the session service, or a file URL for a local file that can be accessed by EAIWS (depends on the configuration of EAIWS).
The paste operation of the basket service returns the item IDs of all pasted items.
The operation operation paste fails with a basket service fault
-
if the BSK/OBX stream contains a set-article and the application license feature
egr.eai.basket.set_articlesis not enabled. -
if the number of items in the OBX stream, not counting basket sub-article items, is greater than one and the license feature
egr.eai.server.multiple_positionsis not enabled. -
if, after paste, the number of items, not counting the top folder and basket sub-article items, is greater than one and the license feature
egr.eai.server.multiple_positionsis not enabled.