getConfNotes.md

getConfNotes

Returns an array of all structured student medical notes details data in JSON format.

• Version History:

  TASS v52.3 - Method Added

  TASS v54.0 - Add a new conditional field currentstatus, change the required field studcode to a conditional field. Add new validations for studcode and currentstatus.

• Version:

  3

• Permission:

  Student Records > Students > Confidential Notes tab > View

• Method:

  GET | POST

• Params:

  Required:

  None

  Optional:

  None

  Conditional:

  currentstatus [string] - Required if studcode is not supplied. Must be 'current' or 'future' or 'past' or 'noncurrent'.

  studcode [string] - Required if currentstatus is not supplied. Contains Only One Student Code if supplied.

• Success Response:

  when currentstatus is supplied

  {
      "data":[
          {
              "studcode":"0009130",
              "studnotes":[
                  {
                      "note_date":"2017-03-17 08:45:00.0",
                      "ncat_desc":"General",
                      "note_text":"Test",
                      "entry_code":"tsloman",
                      "entry_date":"2017-03-17 00:00:00.0",
                      "attach_url":"",
                      "attach_id":"",
                      "note_cat":"GEN"
                  },
                  {
                      "note_date":"2017-03-14 11:12:30.0",
                      "ncat_desc":"Student Information",
                      "note_text":"JPW is here",
                      "entry_code":1000029,
                      "entry_date":"2017-03-14 00:00:00.0",
                      "attach_url":"",
                      "attach_id":"",
                      "note_cat":"STU"
                  }
              ]
          },
          {
              "studcode":"0009134",
              "studnotes":[
                  
              ]
          }
      ],
      "__tassversion":"01.000.043.0",
      "token":{
          "timestamp":"{ts '2020-11-12 10:08:57'}",
          "currentstatus":"current"
      }
  }

  when only studcode is supplied

  {
      "data":[
          {
              "note_date":"2017-03-17 08:45:00.0",
              "ncat_desc":"General",
              "note_text":"Test",
              "entry_code":"tsloman",
              "entry_date":"2017-03-17 00:00:00.0",
              "attach_url":"",
              "attach_id":"",
              "note_cat":"GEN"
          },
          {
              "note_date":"2017-03-14 11:12:30.0",
              "ncat_desc":"Student Information",
              "note_text":"JPW is here",
              "entry_code":1000029,
              "entry_date":"2017-03-14 00:00:00.0",
              "attach_url":"",
              "attach_id":"",
              "note_cat":"STU"
          }
      ],
      "__tassversion":"01.000.043.0",
      "token":{
          "timestamp":"{ts '2020-11-12 10:09:13'}",
          "studcode":"0009130"
      }
  }

• Error Response:

  studcode and currentstatus are both not supplied

    "error": "studcode or currentstatus is required."

  studcode contains more than one student code

    "error": "Only one studcode can be processed at a time."

  studcode does not exist in currentstatus student list

    "error": "[studcode] is not a valid [currentstatus] student."

  currentstatus does not match 'current' or 'future' or 'past' or 'noncurrent'

    "error": "[currentstatus] must be 'current' or 'future' or 'past' or 'noncurrent'."

• Sample Parameters:

  when currentstatus is supplied

    {
      "currentstatus":"current"
    }

  when only studcode is supplied

    {
      "studcode":"0009130"
    }

• Sample GET: (With URL Encoded token)

    http://api.tasscloud.com.au/tassweb/api/?method=getConfNotes&appcode=API12&company=10&v=3&token=l1D8owEn111IHcXLRwXTB0oU2GX6rj%2BISqa9zXA8We3J3mwgjW5pdUvFK3%2FIZ4mJ4bMyfKTmEoup%2B3tTE9GeLQ%3D%3D

• Sample POST:

    <form id="postForm" name="postForm" method="POST" action="http://api.tasscloud.com.au/tassweb/api/">
       <input type="hidden" name="method" value="getConfNotes">
       <input type="hidden" name="appcode" value="API12">
       <input type="hidden" name="company" value="10">
       <input type="hidden" name="v" value="3">
       <textarea name="token">l1D8owEn111IHcXLRwXTB0oU2GX6rj+ISqa9zXA8We3J3mwgjW5pdUvFK3/IZ4mJ4bMyfKTmEoup+3tTE9GeLQ==</textarea>
    </form>