Errors in filtering examples (OneRoster v1.1 3.4.3)
Errors in filtering examples (OneRoster v1.1 3.4.3)
Hello all, thanks so much for the v1.1 spec.
The example in section 3.4.3 illustrating the ~
operator appears to have a mistake:
So in the case of filtering on the 'subjects' field when the value of the field is "subject1,subject2,subject3" the following filters would return:
• ?filter="subject1" - record not returned;
• ?filter="subject1,subject2" - record not returned;
• ?filter="subject1,subject2,subject3" - record returned;
• ?filter~"subject1" - record returned;
• ?filter~"subject1,subject2" - record returned;
• ?filter~"subject1,subject2,subject3" - record returned.
The field name ('subjects') is missing from the example. Also, contrary to the spec, the value is enclosed in double quotes, rather than single quotes.
So I think that example is intended to be:
So in the case of filtering on the 'subjects' field when the value of the field is "subject1,subject2,subject3" the following filters would return:
• ?filter=subjects='subject1' - record not returned;
• ?filter=subjects='subject1,subject2' - record not returned;
• ?filter=subjects='subject1,subject2,subject3' - record returned;
• ?filter=subjects~'subject1' - record returned;
• ?filter=subjects~'subject1,subject2' - record returned;
• ?filter=subjects~'subject1,subject2,subject3' - record returned.
Is that correct?
Thanks,
Aaron Harnly
Amplify Education