Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 5.3

...

GET /ssp/api/1/person/{id}/earlyAlert

Security

PERSON_EARLY_ALERT_READ

Parameters

status : ALL, ACTIVE, INACTIVE, DELETED<br>
start : First result (0-based index) to return<br>return
limit : Maximum number of results to return<br>return
sort : Property name<br>name
sortDirection : Ascending/descending keyword (ASC/DESC or ASCENDING/DESCENDING)

Returns

Code Block
{"success" : "true",
 "resultsmessage" : "","100results":1,
 "rows" : 
    [{"id" : "6201b18d84ace006-9d1d1a36-48d34acc-82d483a7-092e52ad676b2d87abfcf3c2",
        "createdBycreatedDate":1347964903568,
  :  "createdBy":
        {"id" : "91f46e39f02058a4-cea876e5-422b4d06-b21597d2-00f6bcf5d28097d13db0505e",
          "firstName" : "JohnDemo",
 
        "lastName" : "DoeCoach18"},
      "createdDatemodifiedDate" : "1332216000000",
 1348220503568,
    "modifiedBy" : 

        {"id" : "91f46e39f02058a4-cea876e5-422b4d06-b21597d2-00f6bcf5d28097d13db0505e",
 
        "firstName" : "JohnDemo",
          "lastName" : "DoeCoach18"},
 
    "modifiedDateobjectStatus" : "1332216000000ACTIVE",

     "objectStatuscourseName" : "ACTIVEENG055",
 
    "courseNamecourseTitle" :"College ReadingI"MTH-100",
 
    "courseTitlecourseTermCode" : "Introduction to MathFA12",
 
    "emailCC" : "john.smith@university.edu":null,
      "campusId" : "3435c2f30a640a2a-b3c9409d-4cdc1271-b35f8140-2f492557999cd10a51770117",
 
    "earlyAlertReasonIdsearlyAlertReasonOtherDescription" : null,
     "earlyAlertSuggestionOtherDescription":null,
   [{"id" : "e02521fc-53ca-4fe6-8de7-b2a1fb3d08f7"},
          {"id" : "216a272f-a457-447e-9bc2-72ee5436a8b1"}],
  "comment":"Do to lack of attendance and low test scores, he should consider withdrawing from this class.",
    "earlyAlertReasonOtherDescriptionpersonId" : null,
 :"284c2248-87cd-342e-0c77-d36444ea3b9b",
    "closedDate":null,
    "closedById":null,
    "earlyAlertSuggestionIdsclosedByName":null,
    "noOfResponses":1,
    "earlyAlertReasonIds":
        [{"id" : "b04b0b52b2d112b8-c0e85056-4cc5a51a-83ba8067-5252910f012a1fda2849c3e5"},
          {"id" : "d0719473-a17a-44e5-8d63-541870b9983e"}],"createdDate":1336003200000,
        "earlyAlertSuggestionOtherDescriptioncreatedBy":
: null,       {"commentid" : "Student is struggling in MTH class and frequently sleeps:"58ba5ee3-734e-4ae9-b9c5-943774b4de41",
        "firstName":"System",
      "closedDate" : "1332216000000",
      "closedById" : "91f46e39-cea8-422b-b215-00f6bcf5d280lastName":"Administrator"},

    {"idmodifiedDate" : "c57f11e1-7ef2-4989-9ac2-7b0690563995",
 :1336003200000,
    "createdBymodifiedBy" : 
         {"id" : "91f46e3958ba5ee3-cea8734e-422b4ae9-b215b9c5-00f6bcf5d280943774b4de41",
 "
        "firstName" : "JohnSystem",
          "lastName" : "DoeAdministrator"},
 
    "createdDateobjectStatus" : "1332216000000ACTIVE",
 
    "modifiedByname" : 
    "Excessive Absences",
    {"iddescription" :"Excessive "91f46e39-cea8-422b-b215-00f6bcf5d280"Absences",
     "sortOrder":2}],
    "firstNameearlyAlertSuggestionIds" :
"John",      [{"id":"b2d111ed-5056-a51a-8046-5291453e8720",
    "lastNamecreatedDate" : "Doe"},
 1336003200000,
    "modifiedDatecreatedBy":
: "1332216000000",       {"objectStatusid" : "ACTIVE"58ba5ee3-734e-4ae9-b9c5-943774b4de41",
        "courseNamefirstName" : "ENGL-100System",
        "courseTitle" : "Introduction to English",
 lastName":"Administrator"},
    "modifiedDate":1336003200000,
    "emailCCmodifiedBy":
: "john.smith@university.edu",       {"campusIdid" : "3435c2f358ba5ee3-b3c9734e-4cdc4ae9-b35fb9c5-2f492557999c943774b4de41",
        "earlyAlertReasonIdsfirstName" : 
:"System",
        [{"idlastName" : "839aee41-c882-482d-ba1c-695eae44976a"Administrator"},
    "objectStatus":"ACTIVE",
     {"idname" : "49300166-ff8a-4707-8c07-9c22d2f2e6d1"}]"Withdraw",
      "earlyAlertReasonOtherDescriptiondescription" : null"",
 
    "earlyAlertSuggestionIdssortOrder" : 8}],
    "sendEmailToStudent":false}
    [{"id" : "ecd3fd47-90e4-43de-87b6-6e28d4f09455"},
]
}

Get an Early Alert

GET /ssp/api/1/person/{id}/earlyAlert/{id}

Security

PERSON_EARLY_ALERT_READ

Returns

EarlyAlert

Code Block
{"id":"84ace006-1a36-4acc-83a7-2d87abfcf3c2",
         {"idcreatedDate":1347964903568,
: "dc35dd0a-5d21-4190-87b2-858bb5b505c9"}]    "createdBy":
        {"id":"f02058a4-76e5-4d06-97d2-97d13db0505e",
      "earlyAlertSuggestionOtherDescription" : null,  "firstName":"Demo",
        "commentlastName" : null,
 :"Coach18"},
    "closedDatemodifiedDate" : null1348220503568,
 
    "closedByIdmodifiedBy" : null}]
}

Get an Early Alert

GET /ssp/api/1/person/{id}/earlyAlert/{id}

Returns

EarlyAlert

Code Block
{"id" : "6201b18d-9d1d-48d3-82d4-092e52ad676b",
 "createdBy" ::
        {"id":"f02058a4-76e5-4d06-97d2-97d13db0505e",
        {"idfirstName" : "91f46e39-cea8-422b-b215-00f6bcf5d280"Demo",
        "firstNamelastName" : "JohnCoach18"},

    "lastNameobjectStatus" : "DoeACTIVE"},
    "createdDatecourseName" : "1332216000000ENG055",
    "modifiedBycourseTitle" :"College ReadingI",
    {"idcourseTermCode" : "91f46e39-cea8-422b-b215-00f6bcf5d280"FA12",

    "firstNameemailCC" : "John"null,

    "lastNamecampusId" : "Doe"},
 "modifiedDate" : "1332216000000",
 "objectStatus" : "ACTIVE",
 "courseName" : "MTH-100",
 "courseTitle" : "Introduction to Math",
 "emailCC" : "john.smith@university.edu",
 "campusId" : "3435c2f3-b3c9-4cdc-b35f-2f492557999c",
 "earlyAlertReasonIds" : 
    [{"id" : "e02521fc-53ca-4fe6-8de7-b2a1fb3d08f7"},
     {"id" : "216a272f-a457-447e-9bc2-72ee5436a8b1"}],
 "earlyAlertReasonOtherDescription" : null,
 "earlyAlertSuggestionIds" : "0a640a2a-409d-1271-8140-d10a51770117",
    "earlyAlertReasonOtherDescription":null,
    "earlyAlertSuggestionOtherDescription":null,
    "comment":"Do to lack of attendance and low test scores, he should consider withdrawing from this class.",
    "personId":"284c2248-87cd-342e-0c77-d36444ea3b9b",
    "closedDate":null,
    "closedById":null,
    "closedByName":null,
    "noOfResponses":1,
    "earlyAlertReasonIds":
        [{"id" : "b04b0b52b2d112b8-c0e85056-4cc5a51a-83ba8067-5252910f012a1fda2849c3e5"},
        {"idcreatedDate" : "d0719473-a17a-44e5-8d63-541870b9983e"}],
 "earlyAlertSuggestionOtherDescription" : null,1336003200000,
        "commentcreatedBy" :
"Student is struggling in MTH class and frequently sleeps {"id":"58ba5ee3-734e-4ae9-b9c5-943774b4de41",
 "closedDate" : "1332216000000       "firstName":"System",
 "closedById" : "91f46e39-cea8-422b-b215-00f6bcf5d280"}

 

Create an Early Alert

POST /ssp/api/1/person/{id}/earlyAlert

The {id} in the URL for Early Alert creation can either be an existing Person ID in UUID syntax, or it can be the school's legacy School ID (the school-assigned identifier for the student) for an existing Person.

Sample Post

Code Block
{"courseName" : "MTH-101",
 "courseTitle" : "Concepts of Math",
 "emailCC" : "john.smith@university.edu",
 "campusId" : "3435c2f3-b3c9-4cdc-b35f-2f492557999c",
 "earlyAlertReasonIds" : 
    [{"id" : "e02521fc-53ca-4fe6-8de7-b2a1fb3d08f7"},       "lastName":"Administrator"},
    "modifiedDate":1336003200000,
    "modifiedBy":
        {"id":"58ba5ee3-734e-4ae9-b9c5-943774b4de41","
        firstName":"System",
        "lastName":"Administrator"},
    "objectStatus":"ACTIVE",
    "name":"Excessive Absences",
    "description":"Excessive Absences",
    "sortOrder":2}],
    "earlyAlertSuggestionIds":
    [{"id":"b2d111ed-5056-a51a-8046-5291453e8720",
    "createdDate":1336003200000,
    "createdBy":
        {"id":"58ba5ee3-734e-4ae9-b9c5-943774b4de41",
        "firstName":"System",
        "lastName":"Administrator"},
    "modifiedDate":1336003200000,
    "modifiedBy":
        {"id":"58ba5ee3-734e-4ae9-b9c5-943774b4de41",
        "firstName":"System",
        "lastName":"Administrator"},
    "objectStatus":"ACTIVE",
    "name":"Withdraw",
    "description":"",
    "sortOrder":8}],
    "sendEmailToStudent":false}
}

 

Create an Early Alert

POST /ssp/api/1/person/{id}/earlyAlert

The {id} in the URL for Early Alert creation can either be an existing Person ID in UUID syntax, or it can be the school's legacy School ID (the school-assigned identifier for the student) for an existing Person.

Security

PERSON_EARLY_ALERT_WRITE

Sample Post

Code Block
{"courseName" : "MTH-101",
 "courseTitle" : "Concepts of Math",
 "courseTermCode" : "FA12",
 "emailCC" : "john.smith@university.edu",
 "campusId" : "3435c2f3-b3c9-4cdc-b35f-2f492557999c",
 "earlyAlertReasonId" : "e02521fc-53ca-4fe6-8de7-b2a1fb3d08f7",
 "earlyAlertReasonOtherDescription" : null,
 "earlyAlertSuggestionIds" : 
    [{"id" : "b04b0b52-c0e8-4cc5-83ba-5252910f012a"},
     {"id" : "d0719473-a17a-44e5-8d63-541870b9983e"}],
 "earlyAlertSuggestionOtherDescription" : null,
 "personId":"fa8d6aeb-7de8-11e2-b865-406c8f22c3ebc",
 "comment" : "Student is often late to class and isn't prepared.",
 "sendEmailToStudent" : true}

Returns

EarlyAlert

Code Block
{"id":"84ace006-1a36-4acc-83a7-2d87abfcf3c2",
        "createdDate":1347964903568,
    "createdBy":
        {"id":"f02058a4-76e5-4d06-97d2-97d13db0505e",
        "firstName":"Demo",
        "lastName":"Coach18"},
    "modifiedDate":1348220503568,
    "modifiedBy":
        {"id":"f02058a4-76e5-4d06-97d2-97d13db0505e",
        "firstName":"Demo",
        "lastName":"Coach18"},
    "objectStatus":"ACTIVE",
    "courseName":"ENG055",
    "courseTitle":"College ReadingI",
    "courseTermCode":"FA12",
    "emailCC":null,
    "campusId":"0a640a2a-409d-1271-8140-d10a51770117",
    "earlyAlertReasonOtherDescription":null,
    "earlyAlertSuggestionOtherDescription":null,
    "comment":"Do to lack of attendance and low test scores, he should consider withdrawing from this class.",
    "personId":"284c2248-87cd-342e-0c77-d36444ea3b9b",
    "closedDate":null,
    "closedById":null,
    "closedByName":null,
    "noOfResponses":1,
    "earlyAlertReasonIds":
        [{"id":"b2d112b8-5056-a51a-8067-1fda2849c3e5",
        "createdDate":1336003200000,
        "createdBy":
        {"id":"58ba5ee3-734e-4ae9-b9c5-943774b4de41",
        "firstName":"System",
        "lastName":"Administrator"},
    "modifiedDate":1336003200000,
    "modifiedBy":
        {"id":"58ba5ee3-734e-4ae9-b9c5-943774b4de41","
        firstName":"System",
        "lastName":"Administrator"},
    "objectStatus":"ACTIVE",
    "name":"Excessive Absences",
    "description":"Excessive Absences",
    "sortOrder":2}],
    "earlyAlertSuggestionIds":
    [{"id":"b2d111ed-5056-a51a-8046-5291453e8720",
    "createdDate":1336003200000,
    "createdBy":
        {"id":"58ba5ee3-734e-4ae9-b9c5-943774b4de41",
        "firstName":"System",
        "lastName":"Administrator"},
    "modifiedDate":1336003200000,
    "modifiedBy":
        {"id":"58ba5ee3-734e-4ae9-b9c5-943774b4de41",
        "firstName":"System",
        "lastName":"Administrator"},
    "objectStatus":"ACTIVE",
    "name":"Withdraw",
    "description":"",
    "sortOrder":8}],
    "sendEmailToStudent":false}
}

 

Save an Early Alert

PUT /ssp/api/1/person/{id}/earlyAlert/{id}

Security

PERSON_EARLY_ALERT_WRITE

Sample Post

Code Block
{"id":"84ace006-1a36-4acc-83a7-2d87abfcf3c2",
        "createdDate":1347964903568,
    "createdBy":
        {"id":"f02058a4-76e5-4d06-97d2-97d13db0505e",
        "firstName":"Demo",
        "lastName":"Coach18"},
    "modifiedDate":1348220503568,
    "modifiedBy":
        {"id":"f02058a4-76e5-4d06-97d2-97d13db0505e",
        "firstName":"Demo",
        "lastName":"Coach18"},
    "objectStatus":"ACTIVE",
    "courseName":"ENG055",
    "courseTitle":"College ReadingI",
    "courseTermCode":"FA12",
    "emailCC":null,
    "campusId":"0a640a2a-409d-1271-8140-d10a51770117",
    "earlyAlertReasonOtherDescription":null,
    "earlyAlertSuggestionOtherDescription":null,
    "comment":"Do to lack of attendance and low test scores, he should consider withdrawing from this class.",
    "personId":"284c2248-87cd-342e-0c77-d36444ea3b9b",
    "closedDate":null,
    "closedById":null,
    "closedByName":null,
    "noOfResponses":1,
    "earlyAlertReasonIds":
        [{"id":"b2d112b8-5056-a51a-8067-1fda2849c3e5",
        "createdDate":1336003200000,
        "createdBy":
        {"id":"58ba5ee3-734e-4ae9-b9c5-943774b4de41",
        "firstName":"System",
        "lastName":"Administrator"},
    "modifiedDate":1336003200000,
    "modifiedBy":
        {"id" : "216a272f58ba5ee3-a457734e-447e4ae9-9bc2b9c5-72ee5436a8b1943774b4de41"}],"
    "earlyAlertReasonOtherDescription" : null,  firstName":"earlyAlertSuggestionIdsSystem",
  :      [{"idlastName" : "b04b0b52-c0e8-4cc5-83ba-5252910f012a"Administrator"},

    {"idobjectStatus" : "d0719473-a17a-44e5-8d63-541870b9983e"}]"ACTIVE",
 "earlyAlertSuggestionOtherDescription" : null,
 "commentname" :"Excessive Absences"Student,
is often late to class and isn't prepared. "description":"Excessive Absences",
 "closedDate"  : "1332216000000sortOrder":2}],
    "closedByIdearlyAlertSuggestionIds" : "91f46e39-cea8-422b-b215-00f6bcf5d280"}

Returns

EarlyAlert

Code Block
:
    [{"id" : "6201b18db2d111ed-9d1d5056-48d3a51a-82d48046-092e52ad676b5291453e8720",
    "createdBycreatedDate" : 1336003200000,
    {"idcreatedBy":
: "91f46e39-cea8-422b-b215-00f6bcf5d280",        {"firstNameid" : "John"58ba5ee3-734e-4ae9-b9c5-943774b4de41",

    "lastName" : "Doe"},  "createdDatefirstName" : "1332216000000System",
 "modifiedBy" :      {"idlastName" : "91f46e39-cea8-422b-b215-00f6bcf5d280""Administrator"},
     "firstNamemodifiedDate" ::1336003200000,
    "John",modifiedBy":
        {"lastNameid" : "Doe"}:"58ba5ee3-734e-4ae9-b9c5-943774b4de41",
 "modifiedDate" : "1332216000000",  "objectStatus" : "ACTIVE",
 "courseNamefirstName" : "MTH-101System",
  "courseTitle" : "Concepts of Math",  "emailCClastName" : "john.smith@university.eduAdministrator"},
    "campusIdobjectStatus" : "3435c2f3-b3c9-4cdc-b35f-2f492557999c:"ACTIVE",
    "earlyAlertReasonIdsname" :"Withdraw",
     [{"id" : "e02521fc-53ca-4fe6-8de7-b2a1fb3d08f7"}"description":"",
    "sortOrder":8}],
    "sendEmailToStudent":false}
}

Returns

EarlyAlert

Code Block
{"id" : "216a272f84ace006-a4571a36-447e4acc-9bc283a7-72ee5436a8b12d87abfcf3c2"}],
 "earlyAlertReasonOtherDescription" : null,       "earlyAlertSuggestionIdscreatedDate" :1347964903568,
     [{"idcreatedBy":
 : "b04b0b52-c0e8-4cc5-83ba-5252910f012a"},      {"id" : "d0719473f02058a4-a17a76e5-44e54d06-8d6397d2-541870b9983e97d13db0505e"}],
    "earlyAlertSuggestionOtherDescription" : null,  "commentfirstName" :"Demo",
"Student is often late to class and isn't prepared.",
 "closedDate" : "1332216000000",
 "closedById" : "91f46e39-cea8-422b-b215-00f6bcf5d280"}

 

Save an Early Alert

PUT /ssp/api/1/person/{id}/earlyAlert/{id}

Sample Post

Code Block
{"id" : "6201b18d-9d1d-48d3-82d4-092e52ad676b",
 "createdBy" : 
    {"id" : "91f46e39-cea8-422b-b215-00f6bcf5d280",
 "lastName":"Coach18"},
    "modifiedDate":1348220503568,
    "modifiedBy":
        {"id":"f02058a4-76e5-4d06-97d2-97d13db0505e",
        "firstName":"Demo",
        "lastName":"Coach18"},
    "objectStatus":"ACTIVE",
    "firstNamecourseName" : "JohnENG055",

    "lastNamecourseTitle" :"College ReadingI"Doe"},
    "createdDatecourseTermCode" : "1332216000000FA12",
    "modifiedByemailCC" : null,
    {"idcampusId" : "91f46e390a640a2a-cea8409d-422b1271-b2158140-00f6bcf5d280d10a51770117",

    "firstName" :earlyAlertReasonOtherDescription":null,
    "JohnearlyAlertSuggestionOtherDescription":null,
     "comment"lastName:"Do to lack : "Doe"},
 "modifiedDate" : "1332216000000",
 "objectStatus" : "ACTIVEof attendance and low test scores, he should consider withdrawing from this class.",
    "courseNamepersonId" : "MTH-100","284c2248-87cd-342e-0c77-d36444ea3b9b",
    "courseTitleclosedDate":null,
 : "Introduction to Math"closedById":null,
 "emailCC"  : "john.smith@university.edu"closedByName":null,
 "campusId"  : "3435c2f3-b3c9-4cdc-b35f-2f492557999c",
 noOfResponses":1,
    "earlyAlertReasonIds":
:        [{"id" : "e02521fcb2d112b8-53ca5056-4fe6a51a-8de78067-b2a1fb3d08f71fda2849c3e5"},

    {"id" : "216a272f-a457-447e-9bc2-72ee5436a8b1"}],  "earlyAlertReasonOtherDescriptioncreatedDate" : null1336003200000,
 "earlyAlertSuggestionIds" :      [{"id" : "b04b0b52-c0e8-4cc5-83ba-5252910f012a"},"createdBy":
        {"id" : "d071947358ba5ee3-a17a734e-44e54ae9-8d63b9c5-541870b9983e943774b4de41"}],
    "earlyAlertSuggestionOtherDescription" : null,  "commentfirstName" : "System"Student,
is struggling in MTH class and frequently sleeps",
 "closedDate" : "1332216000000",
 "closedById" : "91f46e39-cea8-422b-b215-00f6bcf5d280"}

Returns

EarlyAlert

Code Block
{"id" : "6201b18d-9d1d-48d3-82d4-092e52ad676b",
 "createdBy" :lastName":"Administrator"},
    "modifiedDate":1336003200000,
    "modifiedBy":
        {"id" : "91f46e3958ba5ee3-cea8734e-422b4ae9-b215-00f6bcf5d280",b9c5-943774b4de41","
        "firstName" : "JohnSystem",
        "lastName" : "DoeAdministrator"},
    "createdDateobjectStatus" : "1332216000000ACTIVE",
 "modifiedBy" : 
    {"idname" :"Excessive "91f46e39-cea8-422b-b215-00f6bcf5d280"Absences",
     "firstNamedescription" :"Excessive "JohnAbsences",

    "lastNamesortOrder" : "Doe"2}],
    "modifiedDateearlyAlertSuggestionIds":
:  "1332216000000",  [{"objectStatusid" : "ACTIVE"b2d111ed-5056-a51a-8046-5291453e8720",
  "courseName" : "MTH-100createdDate":1336003200000,
    "courseTitlecreatedBy" :
"Introduction to Math",  "emailCC" : "john.smith@university.edu",  {"campusIdid" : "3435c2f358ba5ee3-b3c9734e-4cdc4ae9-b35fb9c5-2f492557999c943774b4de41",
 "earlyAlertReasonIds" :      [{"idfirstName" : "e02521fc-53ca-4fe6-8de7-b2a1fb3d08f7"}"System",
     {   "idlastName" : "216a272f-a457-447e-9bc2-72ee5436a8b1"Administrator"}],
    "earlyAlertReasonOtherDescriptionmodifiedDate":1336003200000,
 : null,  "earlyAlertSuggestionIdsmodifiedBy":
:        [{"id" : "b04b0b5258ba5ee3-c0e8734e-4cc54ae9-83bab9c5-5252910f012a943774b4de41"},
        {"id" : "d0719473-a17a-44e5-8d63-541870b9983e"}],
 "earlyAlertSuggestionOtherDescription" : null,
 "comment" : "Student is struggling in MTH class and frequently sleeps",
 "closedDate" : "1332216000000",
 "closedById" : "91f46e39-cea8-422b-b215-00f6bcf5d280""firstName":"System",
        "lastName":"Administrator"},
    "objectStatus":"ACTIVE",
    "name":"Withdraw",
    "description":"",
    "sortOrder":8}],
    "sendEmailToStudent":false}
}

 

Delete an Early Alert

DELETE /ssp/api/1/person/{id}/earlyAlert/{id}

Security

PERSON_EARLY_ALERT_DELETE

Returns

Code Block
{"success" : "true"}

...