| with | Index Level | without |
| Syntax |
list within file.reference 'item-id' {(options)}
count within file.reference 'item-id' {(options)} |
| Category | Access |
| Type | Modifier |
| Description |
retrieves a list of all the items which are sub-items of a specified item.
This is used to explode one attribute containing one or more multi-values that are item-ids within the same file, like in bill-of-material explosions. The file-defining item ("d-pointer") must contain a "v" code in attribute 8 in the form: v;;n where "n" indicates the attribute count to explode. The explosion may proceed up to 20 sub-levels. |
| Options | |
| See Also | options: v (within) count list |
| Example |
Suppose that in the dictionary of the hypothetical file, "parts", that the "correlative" attribute of the "d-pointer" to "parts" contains the processing code, "v;;1", which means to explode on attribute 1.
The sentence: list within parts 'car' Produces the following output: level Parts...... 1 car 2 engine 2 wheel 3 tire 3 rim 2 hood [405] 6 items listed out of 1 items. list parts parts...... wheel tire rim engine hood car [405] 6 items listed out of 6 items. The hypothetical data could be examined with the command: ct parts car Which produces the following output: car 001 engine]wheel]hood ct parts engine engine 001 flywheel]piston "flywheel" and "piston" items don't exist in "parts", so they don't get exploded. ct parts wheel wheel 001 tire]rim ct parts tire rim hood tire rim hood 001 001 001 002 $35.00 002 $60.00 002 $70.00 |
| Warnings | |
| Compatibility | D3 7.0 AP R83 |
| with | Index Level | without |