{set:set_id}

Description

Returns the dash-joined item IDs of a saved Item Set. An Item Set is a named, reusable query stored per slice in Admin under Slice Admin, Sets of Items (the se_sets page): you give it a name, one or more slices, conditions, and a sort, and AA stores it as an object with its own 32-character ID. The set ID is shown in that admin form next to each set. set takes that object ID and runs the stored query, returning the matching IDs separated by dashes, in the set sort order, exactly the same id-list that the equivalent ids command would produce. Use it to keep a complex or shared selection in one named place instead of repeating the same conditions in many templates. The output is a plain id list, so feed it to count, foreach, loop, view, or any command that consumes dash-separated IDs. An empty or unknown set ID returns an empty string. Active items only, unless the set itself is configured for other bins.

Parameters

set_id required default (none)

The 32-character object ID of a saved Item Set. Find it in Admin under Slice Admin, Sets of Items (se_sets), where each set lists its ID next to the set name. set loads that set and runs its stored query.

Examples

test{set:e271ebb684367b7b1b224820779e4852}

Expecteda65d19971986e750761f0efcd9a16b1b

Actuala65d19971986e750761f0efcd9a16b1b

The set Alphaonly is saved on the AA Test Data - Stable slice and selects the one item named Alpha. {set:} returns that item's long ID. The 32-character argument is the set's object ID, copied from Admin, Slice Admin, Sets of Items.

test{set:12709c04934d55309fced69171f4f702}

Expectedae1da231f3e5bc16496834a0711aa042-fb3df1343ef9a7d789af1f26aa5f8849-5726c2c6b035d7aab450d1794e9e90d7-3b615788d96378c28e368d7fb3d7a44a

Actualae1da231f3e5bc16496834a0711aa042-fb3df1343ef9a7d789af1f26aa5f8849-5726c2c6b035d7aab450d1794e9e90d7-3b615788d96378c28e368d7fb3d7a44a

The set Bignumbers selects Stable items whose number is over 50, sorted by number descending. {set:} returns their IDs dash-joined in that stored order: Kappa (1000), Theta (255), Gamma (100), Eta (99).

test{count:{set:12709c04934d55309fced69171f4f702}}

Expected4

Actual4

{set:} returns a plain dash-separated id list, so any id-consuming command can wrap it. Here {count:} reports how many items the Bignumbers set holds.

test{foreach:{set:12709c04934d55309fced69171f4f702}:{({item:_##1:_#HEADLINE})}::, }

ExpectedKappa, Theta, Gamma, Eta

ActualKappa, Theta, Gamma, Eta

Feed {set:} straight into {foreach:} to walk the items. Each iteration's id is available as _##1 inside the deferred-eval braces {(...)}, so {item:_##1:_#HEADLINE} prints each headline. The output keeps the set's sort order.

test{set:e27ac9f9da198e5f50cd2920bb77aadc}

Expecteda65d19971986e750761f0efcd9a16b1b-4f3362a62847fe1f8c59ba28a92d42c0-aa89ddc95136b966e6ec1419a2963741-968af6a9749d42bffb3045e75e3f7a11-3b615788d96378c28e368d7fb3d7a44a-5726c2c6b035d7aab450d1794e9e90d7-3f6939e68470a2dbafdadf9a626a9dbf-ae1da231f3e5bc16496834a0711aa042-fb3df1343ef9a7d789af1f26aa5f8849-ce4ac95c48c3bbe590b80794e47c3e7b

Actuala65d19971986e750761f0efcd9a16b1b-4f3362a62847fe1f8c59ba28a92d42c0-aa89ddc95136b966e6ec1419a2963741-968af6a9749d42bffb3045e75e3f7a11-3b615788d96378c28e368d7fb3d7a44a-5726c2c6b035d7aab450d1794e9e90d7-3f6939e68470a2dbafdadf9a626a9dbf-ae1da231f3e5bc16496834a0711aa042-fb3df1343ef9a7d789af1f26aa5f8849-ce4ac95c48c3bbe590b80794e47c3e7b

The set Allstable matches every active item on the Stable slice (number not below zero), sorted by headline. {set:} returns all ten IDs in alphabetical order: Alpha, Beta, Delta, Epsilon, Eta, Gamma, Iota, Kappa, Theta, Zeta.

test[{set:00000000000000000000000000000000}]

Expected[]

Actual[]

If no set exists with the given object ID, the set cannot be loaded and {set:} returns an empty string. The square brackets are literal text here, added only to make the empty result visible.

test[{set:}]

Expected[]

Actual[]

Called with no argument, {set:} also returns an empty string. The brackets are literal, shown only to reveal the empty output.

← All expressions