Overview
The /1/assessment_report/iep endpoint returns the structure of the VB-Mapp IEP Assessment Report.
The response to this endpoint contains a list of paragraph descriptors.
Required Headers
Key | Value | Example |
---|---|---|
X-SystemDomain | <the system domain> | vbmapp |
X-LearnerId | <the learner id> | The DMTD-supplied identifier that identifies the learner (see REST API Guide) |
X-LearnerCode | <the learner code> | A REST-client-supplied identifier that identifies the learner (see REST API Guide) |
User-Agent | dmtd-rest-api | |
Authorization | Bearer <your token> | Bearer wV1MLk5+sFzioJw/3M5r9A== |
Accept | application/json |
Paragraph Descriptor Fields
Field | Type | Optional | Description |
---|---|---|---|
Style | String | Required | The paragraph style |
Condition | String | Optional | An expression that determines if the paragraph belongs in the report |
Condition_Comment | String | Optional | A free-form comment describing the Condition field |
Text | String | Required | The paragraph's text, which might contain %SUBSTITUTION_FIELD%s |
Paragraph Descriptor Styles
The following table lists the various styles that can be used to apply common styling across the generated document.
Value | Description |
---|---|
H1 | Heading #1 |
H1NB | Heading #1, but not emphasized (bold) |
H2 | Heading #2 |
H3 | Heading #3 |
Indent | Normal paragraph, but shifted to the right |
Intro | Normal paragraph style, in the introduction. Can have alternate styling, if needed. |
List | Bullet list |
Warn | Adds emphasis to highlight something to the user |
Normal | Normal paragraph style |
Condition Grammar
The grammar for conditions is very trivial. It's simply: "expr op expr".
The Flex lexical description looks as follows:
[ \t\n] { /* skip spaces */ }
\%([a-zA-Z_][a-zA-Z0-9_]*)\% { yylval.string = yytext; return IDENTIFIER; }
[0-9]* { yylval.string = yytext; return INTEGER_LITERAL; }
\<= { return LT; }
\<= { return LTE; }
== { return EQ; }
\>= { return GT; }
\>= { return GTE; }
. { yyerror("Unknown token: %s", yytext); yyterminate(); }
A Bison grammar looks as follows:
binary_expr
: /* empty */
| value LT value
| value LTE value
| value EQ value
| value GT value
| value GTE value
;
value
: IDENTIFIER
| INTEGER_LITERAL
;
- The list of IDENTIFIER (variable) definitions can be found in IEP - Variable Definitions
Example
curl -X GET \
-H 'Authorization: Bearer wV1MLk5+sFzioJw/3M5r9A==' \
-H "Accept: application/json" \
-H "X-SystemDomain: vbmapp" \
-H "X-LearnerId: 1" \
https://api-sandbox.datamtd.com/1/assessment_report/iep
Response
{ "response": [ { "Style": "H1", "Text": "VB-MAPP Language Milestones, Barriers and EESA Assessment" }, { "Style": "Intro", "Text": "Name: %STUDENT_FULL_NAME%" }, { "Style": "Intro", "Text": "Date of Birth: Jan 01, 2014" }, { "Style": "Intro", "Text": "Age: 1" }, { "Style": "Intro", "Text": "Assessment Date: %STUDENT_ASSESSMENT_DATES%" }, { "Style": "Intro", "Text": "Report Date: Dec 13, 2014" }, { "Style": "Intro", "Text": "Assessor: %STUDENT_ASSESSOR%" }, { "Style": "H1NB", "Text": "General Information" },
...
{ "Style": "Normal", "Condition_Comment": "If the highest milestone the child scores 1 point in Listener is milestone 1", "Condition": "%ASSESSMENT_MILESTONE_LISTENER_HIGHEST1POINTSCORE% == 1", "Text": "Once a child begins to attend to speech sounds, the next task is to get different responses under the control of different sounds. This, of course, is the main activity of standard listener discrimination (LD) training (also identified as receptive labeling). The focus for this child might be to just get him to attend to his own name, or the name of a favorite person, pet, or character (e.g., \"There's Big Bird!\"). A variety of additional activities for developing listener skills can be found in the VB-MAPP Listener Task Analysis." }, { "Style": "Normal", "Condition_Comment": "If the highest milestone the child scores 1 point in Listener is milestone 2", "Condition": "%ASSESSMENT_MILESTONE_LISTENER_HIGHEST1POINTSCORE% == 2", "Text": "The focus for a child who does attend to his own name and perhaps a few other verbal stimuli is to increase the number of listener discriminations that he is able to make. Again, procedures that establish attending to favorite items should be the focus of the intervention at this point. This child may also be ready for more intensive listener training, perhaps beginning with listener discriminations that involve only two stimuli in an array (e.g., responding to, \"Where's Cookie Monster?\" when shown Cookie Monster and a cat)." }, { "Style": "Normal", "Condition_Comment": "If the highest milestone the child scores 1 point in Listener is milestone 3", "Condition": "%ASSESSMENT_MILESTONE_LISTENER_HIGHEST1POINTSCORE% == 3", "Text": "Reaching this milestone means a child has begun to differentially respond to verbal stimuli as demonstrated by identifying specific items during testing. The focus should now be on (1) increasing the number of items the child is able to identify as a listener, (2) begin generalization to different people, settings, and materials, etc., (3) beginning work on emitting specific motor actions on command, and (4) increasing the number of items in a visual array." }, { "Style": "Normal", "Condition_Comment": "If the highest milestone the child scores 1 point in Listener is milestone 4", "Condition": "%ASSESSMENT_MILESTONE_LISTENER_HIGHEST1POINTSCORE% == 4", "Text": "A score at this level suggests that listener training should become a significant part of the child's daily intervention program, along with mands, tacts, and social behavior. The other skills are clearly important, but not as critical as these four skills are for a child whose scores begin to reach the top of Level 1. At this point in the intervention program the focus should be on (1) increasing the number of items the child is able to identify as a listener, (2) increasing the number of items in a visual array\u2014more extensive use of pictures and the use of picture books, (3) an increased effort to generalize to different materials, (4) an increase in training on actions, and (5) more LD training in the natural environment and in the context of social games and social interaction." },
...
{ "Style": "Normal", "Text": "Sundberg, M. L., & Partington, J. W. (1998). Teaching language to children with autism or other developmental disabilities. Concord, CA: AVB Press." } ], "count": 687 }