2021.1

Retrieving items/sets by ID
New print content items are automatically saved in the Connect database when the Create
Content task creates them. The task returns the IDs of those items, as well as the ID of the
content set, to the Workflow process via Metadata (see About Metadata).
In order to retrieve (sets of) items by ID later on, you will have to get the IDs from the Metadata
and store them somewhere else. Workflow's Data Repository would be a good place to store
them in; you can use the Push to Repository task to store the IDs there.
Retrieving items or sets using conditions
When the Retrieve Items task retrieves items or sets based upon conditions, the respective
database entities are matched against the values of data fields or by the values of properties
set on entities in the Connect database.
l Values:Print content items and sets don't contain data fields, but they do have a link to
the data record with which they were created, so selecting and sorting them by value is
still a possibility.
l Properties are key/value pairs that can be set on entities in the Connect database. There
are two ways to do that:
l Using the Set Properties task.
Ideally, the Set Properties task directly follows the Create Print Content task in a
Workflow process. The Create Print Content task returns the IDs of the content items
as well as the ID of the content set to the process via the Metadata. Using those IDs,
the Set Properties task can either set properties on all new Content Items or on the
Content Set that was just created.
Use two consecutive Set Properties tasks to set properties on both levels.
l Through a Post Pagination script in the template. (See "Post Pagination Scripts" on
page919 and "contentitem" on page1423.)
In order to retrieve (sets of) items by data values, you may have to adjust the data mapping
configuration (see "Data mapping configurations" on page197).
Note that a property can only be used to retrieve entities on the level on which the property
was explicitly set. For example, when you set a property on a content set, you can only use that
property to retrieve the content set in its entirety (i.e. all content items that belong to that content
set); it isn't possible to retrieve individual content items using that property. Properties added to
a content set are not propagated to the individual items in that content set.
To label both a set and the items in it, use the Set Properties task twice.
Page 192