CRITERIA

CRITERIA
Prev	6.7.3. Reference Pages	Next

CRITERIA — record selection criteria for the batch

Synopsis

Content model

CRITERIA ::=
((IDRF| (ID | PLATE | VISIT | CREATE | MODIFY | LEVEL | STATUS)*), EDIT*)

Attributes

Name Type Default Description

sort

CDATA

Name	Type	Default	Description
sort	CDATA	None	The sort method to be applied to the selected records before processing the edit checks. The value for the attribute contains one or more (semi-colon delimited) words from the list: `id`, `visit`, `plate`, `img`, and each word allows an optional leading `+` or `-` symbol. Each word indicates what key the sort is on, the first word has the highest priority, the last word has the lowest, and the optional symbol indicates ascending sort order (`+`) or descending sort order (`-`). If a sort key is omitted, the sort order on that key in the selection set of records is arbitrary. Example 6.34. Use of the sort attribute Sort by ascending subject ID, and then descending visit identifier within subject. sort="+id;-visit"

None

The sort method to be applied to the selected records before processing the edit checks.

The value for the attribute contains one or more (semi-colon delimited) words from the list: id, visit, plate, img, and each word allows an optional leading + or - symbol. Each word indicates what key the sort is on, the first word has the highest priority, the last word has the lowest, and the optional symbol indicates ascending sort order (+) or descending sort order (-).

If a sort key is omitted, the sort order on that key in the selection set of records is arbitrary.

Example 6.34. Use of the sort attribute

Sort by ascending subject ID, and then descending visit identifier within subject.

sort="+id;-visit"

Description

The CRITERIA specifies the record selection criteria for the current batch. Records can be selected by:

a previously created DRF file using the IDRF child element,
key fields using the ID, VISIT, PLATE, CREATE, MODIFY, LEVEL, and STATUS child elements,
edit checks that they reference using the EDIT child element,
a combination of DRF and edit check names, or
a combination of key fields and edit check names.

Parents

These elements contain CRITERIA: BATCH

Children

The following elements occur in CRITERIA: IDRF , ID , PLATE , VISIT , CREATE , MODIFY , LEVEL , STATUS , EDIT .

Examples

Example 6.35. Select records from plate 5, modified on or after January 1, 2000, at validation level 3, for subjects 1000 to 4999 inclusive, and for visits 1 through 10, inclusive, and 14

<CRITERIA>
        <PLATE include="5" />
        <MODIFY include="00/01/01-today" />
        <LEVEL include="3" />
        <ID include="1000-4999" />
        <VISIT include="1-10,14" />
</CRITERIA>