getMultiArticleFeatures
Synopsis
ArticleFeatures[] getMultiArticleFeatures
(SessionId sessionId,
UUID[] itemIds, GetMultiArticleFeaturesOptions? Options)
throws BasketServiceFault;
See also: ArticleFeatures, SessionId, GetMultiArticleFeaturesOptions, BasketServiceFault, UUID
Operation getMultiArticleFeatures is a more powerful variant of operation getArticleFeatures (§getArticleFeatures). It allows the client
-
to query features of multiple articles in one go, and
-
to use view item IDs instead of basket item IDs (if field
viewIdof parameteroptionsis set accordingly).
The selection of items whose article features are to be returned is performed as usual using the basket or view item IDs specified with parameter itemIds and the subset of ItemSelectionOptions passed with parameter options. Once the initial set of selected items has been determined, non-article items are removed from the set (user- and set-article items are retained even though they always report an empty list of article features (at least with the current implementation)).
It is not an error to explicitly specify the ID of a non-article item, regardless of the set of item selection options being used. In particular, specification of the top folder ID in combination with item selection option subItems set to true may be used to fetch the features of all article items.
Once the set of article items has been determined, the operation fetches the article features of each article item and returns them using one element of type ArticleFeatures (§ArticleFeatures) for each article item, with field itemId holding the basket or view item ID of the corresponding article item, and field features holding the list of individual article features as they would be returned by operation getArticleFeatures.
The order of ArticleFeatures elements in the return value is unspecified.
Note: Fields description and noInternal of type GetMultiArticleFeaturesOptions (§GetMultiArticleFeaturesOptions) are encoded as attributes, even though the same fields of type GetArticleFeaturesOptions (§GetArticleFeaturesOptions) are encoded as elements.