Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Overview


...

Update an entity record (HTTP PUT method) (template URL for each relevant API entity type)

CodeField
PUT https://{host}.edu.net.au/api/rest/v1/Program/{eduProgramId} Program/Course of Study
PUT https://{host}.edu.net.au/api/rest/v1/Unit/{eduUnitId}Unit of Study
PUT https://{host}.edu.net.au/api/rest/v1/ProgramUnitConstraint/{eduProgramUnitConstraintIdProgram-Unit Relationship
PUT https://{host}.edu.net.au/api/rest/v1/ScheduledUnit /{eduScheduledUnitId}Scheduled Unit of Study 
PUT https://{host}.edu.net.au/api/rest/v1/ScheduledUnitFee/{eduScheduledUnitId}Scheduled Unit Fee 
PUT https://{host}.edu.net.au/api/rest/v1/UnitAssessment /{eduAssessmentId}Unit of Study Assessment
PUT https://{host}.edu.net.au/api/rest/v1/UnitCompetency /{eduAssessmentId} Unit of Study Competency
PUT https://{host}.edu.net.au/api/rest/v1/Competency /{competencyId}Unit of Competency
PUT https://{host}.edu.net.au/api/rest/v1/CodeItem/{codeIdCode Item
PUT https://{host}.edu.net.au/api/rest/v1/StatusItem/{statusId}Status Item

...

CodeField
GET https://{host}.edu.net.au/api/rest/v1/Program?{fieldName}={value} &{fieldName}={value}&{fieldName}={value}&{fieldName}={value}&{fieldName}={value} Program/Course of Study
GET https://{host}.edu.net.au/api/rest/v1/Unit?{fieldName}={value} &{fieldName}={value}&{fieldName}={value}&{fieldName}={value}&{fieldName}={value} Unit of Study
GET https://{host}.edu.net.au/api/rest/v1/ProgramUnitConstraint?{fieldName}={value} &{fieldName}={value}&{fieldName}={value}&{fieldName}={value}&{fieldName}={value} Program-Unit Relationship
GET https://{host}.edu.net.au/api/rest/v1/ScheduledUnit?{fieldName}={value} &{fieldName}={value}&{fieldName}={value}&{fieldName}={value}&{fieldName}={value} Scheduled Unit of Study
GET https://{host}.edu.net.au/api/rest/v1/ScheduledUnitFee?{fieldName}={value} &{fieldName}={value}&{fieldName}={value}&{fieldName}={value}&{fieldName}={value} Scheduled Unit Fee 
GET https://{host}.edu.net.au/api/rest/v1/UnitAssessment ?{fieldName}={value} &{fieldName}={value}&{fieldName}={value}&{fieldName}={value}&{fieldName}={value} Unit of Study Assessment
GET https://{host}.edu.net.au/api/rest/v1/UnitCompetency ?{fieldName}={value} &{fieldName}={value}&{fieldName}={value}&{fieldName}={value}&{fieldName}={value} Unit of Study Competency
GET https://{host}.edu.net.au/api/rest/v1/Competency ?{fieldName}={value} &{fieldName}={value}&{fieldName}={value}&{fieldName}={value}&{fieldName}={value} Unit of Competency
GET https://{host}.edu.net.au/api/rest/v1/CodeItem?codeTypeId={codeTypeId} &{fieldName}={value}&{fieldName}={value}&{fieldName}={value}&{fieldName}={value} Code Item
GET https://{host}.edu.net.au/api/rest/v1/StatusItem? statusTypeId={ statusTypeId} &{fieldName}={value}&{fieldName}={value}&{fieldName}={value}&{fieldName}={value} Status Item

...

CodeField

POST https://{host}.edu.net.au/api/rest/v1/Unit 


{
"eduUnitId": "ICX1234"Unit Code (Primary key, fixed) 
"eduOtherUnitId": "ICX1234", Unit Code (required,updateable)
"eduProviderOtherUnitId": "ICX1234",External Unit Code (optional,updateable) 
"unitName": "Example Unit Name",Unit Name 
"unitCategory": "2", Unit Category (Code=UNIT_CATEGORY) 
"unitStatusId": "UNIT_ACTIVE",Status (ACTIVE/INACTIVE/ARCHIVED) 
"providerPartyId": "10000",Provider (DEFAULT=10000)
"creditStatement": "",Credit Statement (point/hours, optional) 
"pgradEftsuLoad": "0.0",Study Load (EFTSL) for Postgrad (NA) 
"ugradEftsuLoad": "0.0625",Study Load (EFTSL) for VET/Undergrad
"description": "Example Unit description ",Unit Description (optional) 
"requirements": "Example Unit requirements ",Unit Description (optional) 
"destDiscipline": "80300",HEIMS Discipline 
"destWorkExperienceIndicator": "0",HEIMS Work Experience Indicator 
"method": "ONLINE",Delivery Mode 
"avet018": "20",Delivery Mode Identifier
"avet040": "60",Nominal Hours 
"avet058": "60",Scheduled Hours 
"avet078": "N"VET in Schools program (Y/N) 
}

...

Code Block
languagexml
POST 
https://{host}.edu.net.au/api/rest/v1/Unit
{    
"eduUnitId": "ICX1234", Unit Code (Primary key, fixed)   
"eduOtherUnitId": "ICX1234", 
"eduProviderOtherUnitId": "ICX1234",   
"unitName": "Example Unit Name",   
"unitCategory": "2",  
"unitStatusId": "UNIT_ACTIVE",
"providerPartyId": "10000", 
"creditStatement": "",   
"pgradEftsuLoad": "0.0",
"ugradEftsuLoad": "0.0625",   
"description": "Example Unit description ",    
"requirements": "Example Unit requirements ",   
"destDiscipline": "80300",    
"destWorkExperienceIndicator": "0", 
"method": "ONLINE", 
"avet018": "20",    
"avet040": "60",
"avet058": "60",
"avet078": "N"
}

...

CodeField
PUT https://{host}.edu.net.au/api/rest/v1/Unit/{eduUnitId}{eduUnitId} to be replaced by Unit Code (Primary key, fixed) 
{
"eduProviderOtherUnitId": "ICX1234",External Unit Code 
"unitName": "Example Unit Name",Unit Name 
"unitCategory": "2",Unit Category  
"unitStatusId": "UNIT_ACTIVE",Status  
  "pgradEftsuLoad": "0.0",Study Load (EFTSL) for Postgrad 
"ugradEftsuLoad": "0.0625",Study Load (EFTSL) for VET/Undergrad 
"description": "Example Unit description",Unit Description (optional) 
  "requirements": "Example Unit requirements",Unit Description (optional) 
"destDiscipline": "80300",HEIMS Discipline
"destWorkExperienceIndicator": "0",HEIMS Work Experience Indicator 
"method": "ONLINE",Delivery Mode 
 "avet018": "20",Delivery Mode Identifier
 "avet040": "60",Nominal Hours 
  "avet058": "60",Scheduled Hours 
  "avet078": "N"VET in Schools program (Y/N) 
}


Code Block
languagexml
PUT 
https://{host}.edu.net.au/api/rest/v1/Unit/{eduUnitId}
{
"eduProviderOtherUnitId": "ICX1234",
"unitName": "Example Unit Name",  
"unitCategory": "2", 
"unitStatusId": "UNIT_ACTIVE", 
"pgradEftsuLoad": "0.0",
"ugradEftsuLoad": "0.0625",  
"description": "Example Unit description ",   
"requirements": "Example Unit requirements ",  
"destDiscipline": "80300",
"destWorkExperienceIndicator": "0",
"method": "ONLINE",
"avet018": "20",
"avet040": "60",  
"avet058": "60",
"avet078": "N" 
}

...

Code Block
languagexml
POST 
https://{host}.edu.net.au/api/rest/v1/ScheduledUnitFee 
{     
"eduUnitId": "ICX1234",   
"eduOtherUnitId": "ICX1234",  
"eduProviderOtherUnitId": "ICX1234",   
"unitName": "Example Unit Name",   
"unitStatusId": "UNIT_ACTIVE",  
"providerPartyId": "10000",   
"startDate" : "20150101T00:00:00",   
"endDate" : "20151231T00:00:00",  
"fee": "1000.00", 
 "feeTypeId": "STANDARD_FEE",
"description": "Standard Fee",    
"modeOfDelivery": "ONLINE",   
"flexibleLearning": "Y",    
"maximumParticipants": "10000"  
}  

...

CodeField
PUT https://{host}.edu.net.au/api/rest/v1/ScheduledUnitFee/{eduScheduledUnitId} 
{
"eduProviderOtherUnitId": "ICX1234",Unit Code (optional) 
"unitName": "Example Unit Name",Unit Name (optional)
"unitStatusId": "UNIT_ACTIVE",Status (ACTIVE/INACTIVE) 
"providerPartyId": "10000",Provider (DEFAULT=10000) 
"startDate" : "20150101T00:00:00",Start Date  (YYYYMMDD) 
"endDate" : "20151231T00:00:00",End Date  (YYYYMMDD)
"fee": "1000.00",Unit Fee Amount (AUD) 
"feeTypeId": "STANDARD_FEE",Fee Type (Code=FEE_TYPE)
"description": "Standard Fee",Fee Description (optional) 
"modeOfDelivery": "ONLINE",Mode of Delivery (ONLINE)
"flexibleLearning": "Y",Flexible Learning (Y/N) 
"maximumParticipants": "10000"Maximum allowed enrolments 
}


Code Block
languagexml
PUT 
https://{host}.edu.net.au/api/rest/v1/ScheduledUnitFee/{eduScheduledUnitId} 
{     
"eduProviderOtherUnitId": "ICX1234",
"unitName": "Example Unit Name",
"unitStatusId": "UNIT_ACTIVE",
"providerPartyId": "10000",
"startDate" : "20150101T00:00:00", 
"endDate" : "20151231T00:00:00",
"fee": "1000.00", 
"feeTypeId": "STANDARD_FEE",  
"description": "Standard Fee", 
"modeOfDelivery": "ONLINE", 
"flexibleLearning": "Y", 
"maximumParticipants": "10000" 
}

...

Code Block
languagexml
POST 
https://{host}.edu.net.au/api/rest/v1/UnitAssessment
{
"eduUnitId":"ICX1234",
"assessmentTypeId":"COMPETENCY_UNIT",  
"assessmentName":"Example Assessment Name", 
"codeId":"ABC10203",   
"statusId":"ASSESSMENT_ACTIVE",  
"description":"Example Assessment Description",  
"maximumMark":"100", 
"passMark":"50",
"weighting":"1.0",
"startWeek":"5",
"endWeek":"7",
"avet058":"60",
"avet018":"20",  
"avet078":"N"
} 

...

CodeField
PUT https://{host}.edu.net.au/api/rest/v1/UnitAssessment/{assessmentId

"assessmentName": "Example Assessment Name",Name of the Assessment 
"codeId": "ABC10203",Code of the Assessment 
"statusId":"ASSESSMENT_ACTIVE",Status (ACTIVE/INACTIVE) 
"description":"Example Assessment Description",Description  of the Assessment 
"maximumMark":"100",Maximum Mark (“mark out of”) 
"passMark": "50",Pass Mark (“mark to pass”) 
"weighting": "1.0",Weighting (relative within Unit) 
"startWeek": "5",Start Week (of term schedule) 
"endWeek": "7",EndWeek (of term schedule)   
"avet058": "60",Scheduled Hours for Assessment 
"avet018": "20",Mode of Delivery (AVETMISS) 
"avet078": "N"VET in Schools flag (Y/N) 
}


Code Block
languagexml
PUT 
https://{host}.edu.net.au/api/rest/v1/UnitAssessment/{assessmentId} 
{     
"assessmentName": "Example Assessment Name", 
"codeId": " ABC10203", 
"statusId": "ASSESSMENT_ACTIVE",
"description":" Example Assessment Description",  
"maximumMark": " 100",
"passMark": " 50",   "weighting": "1.0",   
"startWeek": "5", 
"endWeek": "7",   
"avet058": "60",  
"avet018": "20", 
"avet078": "N"
}   

...

CodeField
POST https://{host}.edu.net.au/api/rest/v1/UnitCompetency 
{
"eduUnitId": "ICX1234",Unit Code (FK to Unit.eduUnitId) 
"competencyId": "ABC10203",Code of the Assessment 
"competencyName": "Example Competency Name",Name of the Assessment 
"statusId": "ASSESSMENT_ACTIVE",Status (ACTIVE/INACTIVE) 
"description": "Example Competency Description",Description  of the Assessment 
"vetScheduledHours": "60",Scheduled Hours for Assessment 
"vetDeliveryMode": "20",Mode of Delivery (AVETMISS) 
"vetInSchoolsFlag": "N"VET in Schools flag (Y/N) 
}

UNIT COMPETENCY: When a POST call is made to the API to create a UnitCompetency entity it actually creates a Assessment entity record attached to the existing Unit (of study) record identified by the specified value of the eduUnitId field.

The new Assessment entity record will have data field values set as follows:

...



Code Block
POST 
https://{host}.edu.net.au/api/rest/v1/UnitCompetency 
{   
"eduUnitId": "ICX1234",  
"competencyId": "ABC10203",
"competencyName": "Example Competency Name", 
"statusId": "ASSESSMENT_ACTIVE",
"description": "Example Competency Description",  
"vetScheduledHours": "60",
"vetDeliveryMode": "20",
"vetInSchoolsFlag": "N"
}



UNIT COMPETENCY: When a POST call is made to the API to create a UnitCompetency entity it actually creates a Assessment entity record attached to the existing Unit (of study) record identified by the specified value of the eduUnitId field.

The new Assessment entity record will have data field values set as follows:

  1. assessmentId set to an auto-generated identifier
    • assessmentId MUST NOT be provided in the request
    • assessmentId SHOULD be used to identify the new record in other HTTP requests

  2.  assessmentTypeId set to COMPETENCY_UNIT
    • assessmentTypeId MAY be provided in the request
    • assessmentTypeId MUST be COMPETENCY_UNIT if provided in the request

  3. codeId set to the value of competencyId
    • competencyId MUST be provided in the request
    • competencyId MUST be a valid nationally recognised Unit of Competency identifier

  4.  assessmentName set to
    • the value of competencyName if provided in the request
    • the defined name of the identified Unit of Competency otherwise

  5.  description set to
    • the value of competencyName if provided in the request
    • the defined name of the identified Unit of Competency otherwise

  6.  statusId set to
    • the value of statusId if provided in the request
    • ASSESSMENT_ACTIVE otherwise
    • statusId MUST be a valid ASSESSMENT_STATUS if provided in the request

  7. avet058 set to
    • the value of vetScheduledHours if provided in the request
    • the defined “Nationally Agreed Hours” of the Unit of Competency otherwise

  8.  avet018 set to
    • the value of vetDeliveryMode if provided in the request
    • the value 20 (“Online”) otherwise

  9. avet078 set to
    • the value of vetInSchoolsFlag if provided in the request
    • the value N (“No”) otherwise - maximumMark set to the value 100
    • maximumMark MAY be provided in the request as a numeric value greater than 0
    • maximumMark MUST be less than or equal to 100 if provided in the request
  10. passMark set to the value 100
    • passMark MAY be provided in the request as a numeric value greater than 0
    • passMark MUST be less than or equal to maximumMark if provided in the request

...

CodeField
PUT https://{host}.edu.net.au/api/rest/v1/UnitCompetency/{assessmentId} 

"competencyId": "ABC10203",Code of the Assessment 
"competencyName": "Example Competency Name",Name of the Assessment
"statusId": "ASSESSMENT_ACTIVE",Status (ACTIVE/INACTIVE) 
"description": "Example Competency Description",Description  of the Assessment 
"vetScheduledHours": "60",Scheduled Hours for Assessment 
"vetDeliveryMode": "20",Mode of Delivery (AVETMISS)
"vetInSchoolsFlag": "N"VET in Schools flag (Y/N) 
}


Code Block
languagexml
PUT 
https://{host}.edu.net.au/api/rest/v1/UnitCompetency/{assessmentId} 
{     
"competencyId": "ABC10203",
"competencyName": "Example Competency Name",
"statusId": "ASSESSMENT_ACTIVE",  
"description": "Example Competency Description", 
"vetScheduledHours": "60",
"vetDeliveryMode": "20", 
"vetInSchoolsFlag": "N"
}  

...

Code Block
languagexml
POST 
https://{host}.edu.net.au/api/rest/v1/Program  
{    
"eduProgramId" : "DipBus",  
"programName" : Diploma of Business",  
"programStatusId" : "PROGRAM_ACTIVE",
"programType" : "COURSEWORK", 
"programLevel" : "VET", 
"programDuration" : "52.0",  
"programLevelInt" : "5",    
"providerPartyId" : "33594",  
"studyArea" : "BUS",  
"standardCourseFee" : "12600.0",  
"standardUnitFee" : "1575.0",  
"destCourseCode" : "BSB50207",
"destE533" : " BSB50207", 
"destCourseLoad" : "0.75"
"destCourseType" : "21",
"destEduField" : "080300",
"destSpecialCourseCode" : "00",
"destCombinedCourseCode" : "0",
"destLoanFeePostgrad" : "0.0", 
"destLoanFeeUndergrad" : "20.0", 
"avet052" : "803",   
"avet053" : "BSB50207", 
"avet054" : "421",
"avet056" : "11", 
"avet005" : "511112",
"avet040" : "480",
"avet077" : "Y", 
"accredited" : "YES", 
"accreditationDate" : "20150101T00:00:00",
"accreditationDateDue" : "20161231T00:00:00",
"allowInternationalStudent" : "NO",
"allowOnlineApplication" : "YES",
"aqfRegistered" : "Y",
"ecafApproved" : "Y",  
"fundingType" : "'UPFRONT_FEES','FEE_HELP'",
"unitGradeType" : "UNIT_GRADE",  
"assessmentGradeType" : "ASSESSMENT_GRADE",  
"requirements" : "To enrol in this course, you will need to speak and write in English to at least Year 12 level. \\\nYou will also need to have one of the following:\\\n    Australian Year 12 or equivalent; OR\\\n    a Certificate IV; OR\\\n    be aged over 20 and have demonstrated skills acquired through work experience; OR\\\n    within the Admissions Interview be able to demonstrate that you have the skills and capability to succeed in the course." 
}

...

CodeField
POST https://{host}.edu.net.au/api/rest/v1/ProgramUnitConstraint 
{
"constraintTypeId": "CORE_UNIT",Core Unit Rule 
"eduProgramId": "DipBus",Course Code 
"eduUnitId": "ICX1234",Core Unit Code
"displayCode": "A1",Stage (A1/B1/C1/D1/etc)
"description": "Business Core Unit"Rule Description (optional)
}


Code Block
POST 
https://{host}.edu.net.au/api/rest/v1/ProgramUnitConstraint  
{   
"constraintTypeId": "CORE_UNIT",
"eduProgramId": "DipBus",
"eduUnitId": "ICX1234",
"displayCode": "A1",
"description": "Business Core Unit" 
} 

...

CodeField
POST https://{host}.edu.net.au/api/rest/v1/Program 
{
"eduProgramId" : "DipBusBeTh",Course Code (PK,fixed) 
"programName" : "Double Diploma of Business and Beauty Therapy",Course Name
"programStatusId" : "PROGRAM_ACTIVE",Status (ACTIVE/INACTIVE/ARCHIVED) 
"programType" : "COURSEWORK",Course Type 
"programLevel" : "VET",Course Level 
"programDuration" : "52.0",Duration (weeks) 
"programLevelInt" : "5",Program Level No (Dip=5, AdvDip=6) 
"providerPartyId" : "33594",Provider (SGA=33594,ACA=39114)   
"studyArea" : "BUS",Course Study Area (optional)
"standardCourseFee" : "12600.0",Course Fee (full-course total unit fees) 
"standardUnitFee" : "1575.0",Standard Unit Fee 
"destCourseLoad" : "0.75"HEIMS Course Load 
"destCourseType" : "21",HEIMS Course Type 
"destEduField" : "080300",HEIMS Education Field 
"destLoanFeePostgrad" : "0.0",HEIMS Postgraduate Loan Fee (%)
"destLoanFeeUndergrad" : "20.0",HEIMS VET/Undergraduate Loan Fee (%)
"accredited" : "YES",Accreditation Flag (Y/N) 
"accreditationDate" : "20150101T00:00:00",Accreditation Date (YYYYMMDD) 
"accreditationDateDue" : "20161231T00:00:00",Accreditation Date Due (YYYYMMDD) 
"allowInternationalStudent" : "NO",Allow International Students  (YES/NO) 
"allowOnlineApplication" : "YES",Allow Online Application  (YES/NO) 
"aqfRegistered" : "N",AQF Registered  (Y/N)
"ecafApproved" : "Y",ECAF Approved  (Y/N) 
"fundingType" : "'UPFRONT_FEES','FEE_HELP'",Funding Type (multiple select) 
"unitGradeType" : "UNIT_GRADE",Unit Grade Type 
"assessmentGradeType" : "ASSESSMENT_GRADE",Assessment Grade Type
  "requirements" : "To enrol in this course, you will need to speak and write in English to at least Year 12 level. \\\nYou will also need to have one of the following:\\\n    Australian Year 12 or equivalent; OR\\\n    a Certificate IV; OR\\\n    be aged over 20 and have demonstrated skills acquired through work experience; OR\\\n    within the Admissions Interview be able to demonstrate that you have the skills and capability to succeed in the course." Entry Requirements  (optional description)
}


Code Block
POST 
https://{host}.edu.net.au/api/rest/v1/Program  
{
"eduProgramId" : "DipBusBeTh",
"programName" : "Double Diploma of Business and Beauty Therapy",
"programStatusId" : "PROGRAM_ACTIVE",
"programType" : "COURSEWORK",
"programLevel" : "VET",
"programDuration" : "52.0",
"programLevelInt" : "5",
"providerPartyId" : "33594",
"studyArea" : "BUS",
"standardCourseFee" : "12600.0",
"standardUnitFee" : "1575.0",
"destCourseLoad" : "0.75"
"destCourseType" : "21",
"destEduField" : "080300",
"destLoanFeePostgrad" : "0.0",
"destLoanFeeUndergrad" : "20.0",
"accredited" : "YES",
"accreditationDate" : "20150101T00:00:00", 
"accreditationDateDue" : "20161231T00:00:00",
"allowInternationalStudent" : "NO",
"allowOnlineApplication" : "YES",
"aqfRegistered" : "N",
"ecafApproved" : "Y",
"fundingType" : "'UPFRONT_FEES','FEE_HELP'",
"unitGradeType" : "UNIT_GRADE",
"assessmentGradeType" : "ASSESSMENT_GRADE",
"requirements" : "To enrol in this course, you will need to speak and write in English to at least Year 12 level. \\\nYou will also need to have one of the following:\\\n    Australian Year 12 or equivalent; OR\\\n    a Certificate IV; OR\\\n    be aged over 20 and have demonstrated skills acquired through work experience; OR\\\n    within the Admissions Interview be able to demonstrate that you have the skills and capability to succeed in the course."
}

Create a new ProgramUnitContraint entity record

(only valid for double diploma course outline to define a child single diploma course under the double diploma)  Double Diploma COMPONENT PROGRAM 

...

Code Block
POST through work experience; OR\\\n    within the Admissions Interview be able to demonstrate that you have the skills and capability to succeed in the course."
}


Create a new ProgramUnitContraint entity record

(only valid for double diploma course outline to define a child single diploma course under the double diploma)  Double Diploma COMPONENT PROGRAM 

CodeField name
POST https://{host}.edu.net.au/api/rest/v1/ProgramUnitConstraint 
{
"constraintTypeId": "COMPONENT_PROGRAM", Parent-Child Course Rule 
"eduProgramId": "DipBusBeTh",Parent Course Code
"constraintProgramId": "DipBus",Child Course Code 
"description": "Business and Beauty Therapy Component Program"Rule Description (optional) 
}


Code Block
POST 
https://{host}.edu.net.au/api/rest/v1/ProgramUnitConstraint  
{
"constraintTypeId": "COMPONENT_PROGRAM",
"eduProgramId": "DipBusBeTh",
"constraintProgramId": "DipBus",
"description": "Business and Beauty Therapy Component Program"
} 


Create a new ProgramUnitContraint entity record

(only valid for double diploma course outline to define an exemption unit equivalent to a matching core unit) 

CodeField
POST https://{host}.edu.net.au/api/rest/v1/ProgramUnitConstraint 
{
"constraintTypeId": "SUBSTITUTE_UNIT",Equivalent Child Unit Rule 
"eduProgramId": "DipBusBeTh",Parent Course Code 
"constraintProgramId": "DipBeTh",Child Course Code
"eduUnitId": "ICB1233",Exempted Child Unit Code
"constraintEduUnitId": "ICX1234",Equivalent Core Unit Code
"displayCode": "",Stage (blank for no stage)
"description": "Business and Beauty Therapy Equivalent Unit"Rule Description (optional)
}


Code Block
POST 
https://{host}.edu.net.au/api/rest/v1/ProgramUnitConstraint  
{    
"constraintTypeId": "SUBSTITUTE_UNIT", 
"eduProgramId": "DipBusBeTh",
"constraintProgramId": "DipBeTh",
"eduUnitId": "ICB1233",
"constraintEduUnitId": "ICX1234",
"displayCode": "",
"description": "Business and Beauty Therapy Equivalent Unit"
}  


Create a new ProgramUnitContraint entity record

(example for double diploma course outline core unit) 

CodeField
POST https://{host}.edu.net.au/api/rest/v1/ProgramUnitConstraint 
{
"constraintTypeId": "CORE_UNIT",Core Child Unit Rule 
"eduProgramId": "DipBusBeTh", Parent Course Code 
"constraintProgramId": "DipBus",Child Course Code 
"eduUnitId": "ICX1234",Core Unit Code 
"displayCode": "A1",Stage (A1/B1/C1/D1/etc
"description": "Business and Beauty Therapy Core Unit"Rule Description (optional) 
}


Code Block
POST 
https://{host}.edu.net.au/api/rest/v1/ProgramUnitConstraint  
{   
"constraintTypeId": "CORE_UNIT", 
"eduProgramId": "DipBusBeTh",
"constraintProgramId": "DipBus",
"eduUnitId": "ICX1234",
"displayCode": "A1",
"description": "Business and Beauty Therapy Core Unit"
}


Examples for retrieving listings of entity records

Each example for retrieving a list of entity records using the HTTP GET method with URL parameters to specify search criteria. Any text in highlighted in green (at least) should be reviewed and edited per HTTP call to retrieve a list of records. 


Find entity records matching criteria (HTTP GET  method)

(template URL for each relevant API entity type) 


CodeField
GET https://{host}.edu.net.au/api/rest/v1/Program?{fieldName}={value}Program
GET https://{host}.edu.net.au/api/rest/v1/Unit?{fieldName}={valueUnit
GET https://{host}.edu.net.au/api/rest/v1/ProgramUnitConstraint?{fieldName}={value}Program Unit Contraint
GET https://{host}.edu.net.au/api/rest/v1/ScheduledUnit?{fieldName}={value}Scheduled Unit
GET https://{host}.edu.net.au/api/rest/v1/ScheduledUnitFee?{fieldName}={valueScheduled unit Fee
GET https://{host}.edu.net.au/api/rest/v1/UnitAssessment?{fieldName}={value} Unit Assessment
GET https://{host}.edu.net.au/api/rest/v1/UnitCompetency?{fieldName}={value} Unit Competency
GET https://{host}.edu.net.au/api/rest/v1/Competency?{fieldName}={value} Comptetency



Code Block
GET https://{host}.edu.net.au/api/rest/v1/Program?{fieldName}={value} 
GET https://{host}.edu.net.au/api/rest/v1/Unit?{fieldName}={value} 
GET https://{host}.edu.net.au/api/rest/v1/ProgramUnitConstraint?{fieldName}={value} 
GET https://{host}.edu.net.au/api/rest/v1/ScheduledUnit?{fieldName}={value} 
GET https://{host}.edu.net.au/api/rest/v1/ScheduledUnitFee?{fieldName}={value} 
GET https://{host}.edu.net.au/api/rest/v1/UnitAssessment ?{fieldName}={value} 
GET https://{host}.edu.net.au/api/rest/v1/UnitCompetency ?{fieldName}={value} 
GET https://{host}.edu.net.au/api/rest/v1/Competency ?{fieldName}={value} 


Find Program entity records

Replace {value} with text, join criteria with “&”

CodeField
GET https://{host}.edu.net.au/api/rest/v1/Program
eduProgramId={value}Program Code (full/partial)
programName ={value}Program Name (full/partial)
programStatusId ={value}Program Status (status id) 
keywords ={value}Keywords (partial match)


Example URL query CriteriaField
?programStatusId=PROGRAM_ACTIVEAll ACTIVE Programs 
?programStatusId=PROGRAM_INACTIVEAll INACTIVE Programs 
?programStatusId=PROGRAM_ACTIVE&programName=DiplomaACTIVE Diploma Programs 


Code Block
GET 
https://{host}.edu.net.au/api/rest/v1/Program
eduProgramId={value}
programName ={value}
programStatusId ={value}
keywords ={value}


Find ProgramUnitConstraint entity records

Replace {value} with text, join criteria with “&” 

CodeField
GET https://{host}.edu.net.au/api/rest/v1/ ProgramUnitConstraint
constraintTypeId={value}Constraint Type ID 
eduProgramId={value}Program Code (full/partial) 
eduUnitId={value}Unit Code (full/partial) 
constraintEduUnitId={value}Constraint Unit Code 
description={value}Description (partial match) 


Example URL query CriteriaField
?constraintTypeId=COMPONENT_PROGRAM&eduProgramId=DipBusMgt Component Programs for a double diploma course 
?constraintTypeId=CORE_UNIT&eduProgramId=DipBusMgt Core units for a program 
?constraintTypeId=SUBSTITUTE_UNIT&eduProgramId=DipBusMgt Substitute units for single programs under a double diploma course 
?constraintTypeId=_UNIT&eduProgramId=DipBusMgt All related units of any type for a program 


Code Block
GET 
https://{host}.edu.net.au/api/rest/v1/ ProgramUnitConstraint
constraintTypeId={value}
eduProgramId={value}
eduUnitId={value}
constraintEduUnitId={value}
description={value}


Find Unit entity records

Replace {value} with text, join criteria with “&” 

CodeField
GET https://{host}.edu.net.au/api/rest/v1/Unit
eduUnitId={value} Unit Identifier 
unitName={value} Unit Name (full/partial) 
eduOtherUnitId={value} Unit Code (full/partial
unitStatusId={value}Unit Status (status identifier) 
providerPartyId={value} Provider (party identifier)
keywords={value} Keywords text (partial match)


Example URL query Criteria
?unitStatusId=UNIT_INACTIVEAll INACTIVE units 
?unitStatusId=UNIT_ACTIVEAll ACTIVE units 
?unitStatusId=UNIT_ARCHIVEDAll ARCHIVED units 
?unitStatusId=UNIT_ACTIVE&eduOtherUnitId=ICBACTIVE Units for a Unit Code prefix 
?unitStatusId=UNIT_ACTIVE&providerPartyId=10000ACTIVE Units for a specific Provider 


Code Block
GET 
https://{host}.edu.net.au/api/rest/v1/Unit  
eduUnitId={value}Eaxmple URL nitName={value}
eduOtherUnitId={value}
unitStatusId={value}
providerPartyId={value}
keywords={value}


Find UnitAssessment entity records 

Replace {value} with text, join criteria with “&”

CodeField
GET https://{host}.edu.net.au/api/rest/v1/UnitAssessment
assessmentId={value} Unit Assessment Identifier
assessmentTypeId={value}Type of Unit Assessment 
eduUnitId={value} Unit Code of related Unit 
assessmentName={value}Name of a Unit Assessment 
statusId={value}Unit Assessment Status 


Example URL query criteriaField
?statusId= ASSESSMENT_ARCHIVEDAll ARCHIVED Unit Assessments 
?statusId= ASSESSMENT_ACTIVEAll ACTIVE Unit Assessments 
?statusId= ASSESSMENT _ACTIVE&eduUnitId=ICB1233ACTIVE Unit Assessments for a Unit Code (whole or prefix) 
?assessmentTypeId=COMPETENCY_UNIT&statusId= ASSESSMENT _ACTIVE

All ACTIVE Unit Competencies

?assessmentTypeId=COMPETENCY_UNIT&statusId= ASSESSMENT _ACTIVE&eduUnitId=ICB1233ACTIVE Unit Competencies  for a Unit Code (whole or prefix) 


Code Block
GET 
https://{host}.edu.net.au/api/rest/v1/UnitAssessment
assessmentId={value}
assessmentTypeId={value}
eduUnitId={value}
assessmentName={value}
statusId={value}


Find UnitCompetency entity records 

Replace {value} with text, join criteria with “&” 

CodeField
GET https://{host}.edu.net.au/api/rest/v1/UnitCompetency
competencyId={value}Unit Assessment Identifier
competencyName={value}Name of a Unit Competency 
eduUnitId={value}Unit Code of related Unit 
statusId={value}Unit Assessment Status 


Example URL query criteriaField
?statusId= ASSESSMENT_ARCHIVEDAll ARCHIVED Unit Competencies 
?statusId= ASSESSMENT_ACTIVEAll ACTIVE Unit Assessments 
?statusId=ASSESSMENT _ACTIVEAll ACTIVE Unit Competencies 
?statusId= ASSESSMENT _ACTIVE&eduUnitId=ICB1233ACTIVE Unit Competencies  for a Unit Code (whole or prefix) 


Code Block
GET 
https://{host}.edu.net.au/api/rest/v1/ProgramUnitConstraintUnitCompetency
competencyId={value}
competencyName={value}
eduUnitId={
"constraintTypeId": "COMPONENT_PROGRAM",
"eduProgramId": "DipBusBeTh",
"constraintProgramId": "DipBus",
"description": "Business and Beauty Therapy Component Program"
} 

Create a new ProgramUnitContraint entity record

...

value}
statusId={value}


Find ScheduledUnit entity records 

Replace {value} with text, join criteria with “&” 

CodeField
POST
GET https://{host}.edu.net.au/api/rest/v1/
ProgramUnitConstraint 
ScheduledUnit
eduScheduledUnitId={
"constraintTypeId": "SUBSTITUTE_UNIT",Equivalent Child Unit Rule "eduProgramId": "DipBusBeTh",Parent Course Code "constraintProgramId": "DipBeTh",Child Course Code"eduUnitId": "ICB1233",Exempted Child Unit Code"constraintEduUnitId": "ICX1234",Equivalent Core Unit Code"displayCode": "",Stage (blank for no stage)"description": "Business and Beauty Therapy Equivalent Unit"Rule Description (optional)}
Code Block
POST https://{host}.edu.net.au/api/rest/v1/ProgramUnitConstraint  
{    
"constraintTypeId": "SUBSTITUTE_UNIT", 
"eduProgramId": "DipBusBeTh",
"constraintProgramId": "DipBeTh",
"eduUnitId": "ICB1233",
"constraintEduUnitId": "ICX1234",
"displayCode": "",
"description": "Business and Beauty Therapy Equivalent Unit"
}  

Create a new ProgramUnitContraint entity record

(example for double diploma course outline core unit) 

...

value} Scheduled Unit Identifier 
eduUnitId={value} Unit Identifier
unitName={value} Unit Name (scheduled) 
unitStatusId={value} Unit Status (scheduled) 
eduOtherUnitId ={value} Unit Code (scheduled)
providerPartyId ={value} Provider (party identifier) 
startDate={value} Start Date (scheduled) 
endDate={value} End Date (scheduled)
destCensusDate={value} Census Date (scheduled) 


Example URL query criteriaField
?unitStatusId=UNIT_INACTIVEAll INACTIVE Scheduled Units 
?unitStatusId=UNIT_ACTIVEAll ACTIVE Scheduled Units 
?unitStatusId=UNIT_ARCHIVEDAll ARCHIVED Scheduled Units 
?unitStatusId=UNIT_ACTIVE&eduOtherUnitId=ICBACTIVE Scheduled Units for a Unit Code prefix 
?unitStatusId=UNIT_ACTIVE&providerPartyId=10000ACTIVE Scheduled Units for a specific Provider 
?unitStatusId=UNIT_ACTIVE&startDate=2015-01-01ACTIVE Scheduled Units for a specific Start Date 
?unitStatusId=UNIT_ACTIVE&startDate=2015-0101&endDate=2015-12-31

ACTIVE Scheduled Units for specific Start and End Date


Code Block
GET 
https://{host}.edu.net.au/api/rest/v1/ProgramUnitConstraintScheduledUnit
 
eduScheduledUnitId={   
"constraintTypeId": "CORE_UNIT", 
"eduProgramId": "DipBusBeTh",
"constraintProgramId": "DipBus",
"eduUnitId": "ICX1234",
"displayCode": "A1",
"description": "Business and Beauty Therapy Core Unit"
}

Examples for retrieving listings of entity records

Each example for retrieving a list of entity records using the HTTP GET method with URL parameters to specify search criteria. Any text in highlighted in green (at least) should be reviewed and edited per HTTP call to retrieve a list of records. 

Find entity records matching criteria (HTTP GET  method)

...

value}
eduUnitId={value}
Identifier unitName={value}
unitStatusId={value}
eduOtherUnitId ={value}
providerPartyId ={value}
startDate={value}
endDate={value}
destCensusDate={value}


Find ScheduledAssessment entity records 

Replace {value} with text, join criteria with “&” 

CodeField
GET https://{host}.edu.net.au/api/rest/v1/
Program?{fieldName}
ScheduledAssessment
eduScheduledUnitId={value}Scheduled Unit Identifier
assessmentId={value}
ProgramGET https://{host}.edu.net.au/api/rest/v1/Unit?{fieldName}
Unit Assessment Identifier
assessmentTypeId={value}Type of Unit Assessment
scheduledAssessmentId={value}Scheduled Unit Assessment Identifier 
scheduledAssessmentStatusId={value}
 
Unit
GET https://{host}.edu.net.au/api/rest/v1/ProgramUnitConstraint?{fieldName}
Assessment Status 
scheduledAssessmentName={value}
Program Unit ContraintGET https://{host}.edu.net.au/api/rest/v1/ScheduledUnit?{fieldName}={value}Scheduled UnitGET https://{host}.edu.net.au/api/rest/v1/ScheduledUnitFee?{fieldName}={valueScheduled unit FeeGET https://{host}.edu.net.au/api/rest/v1/UnitAssessment?{fieldName}={value} Unit AssessmentGET https://{host}.edu.net.au/api/rest/v1/UnitCompetency?{fieldName}={value} Unit CompetencyGET https://{host}.edu.net.au/api/rest/v1/Competency?{fieldName}={value} Comptetency

...

Name of a Unit Assessment


Example URL query criteriaField
?statusId= ASSESSMENT_ARCHIVEDAll ARCHIVED Scheduled Unit Assessments
?statusId= ASSESSMENT_ACTIVEAll ACTIVE Scheduled Unit Assessments 
?statusId= ASSESSMENT _ACTIVE&eduScheduledUnitId=10123 ACTIVE Scheduled Unit Assessments for a specific Scheduled Unit
?assessmentTypeId=COMPETENCY_UNIT&statusId= ASSESSMENT _ACTIVE All ACTIVE Scheduled Unit Competencies 
?assessmentTypeId=COMPETENCY_UNIT&statusId= ASSESSMENT _ACTIVE&eduScheduledUnitId=10123 ACTIVE Scheduled Unit Competencies  for a specific Scheduled Unit


Code Block
GET 
https://{host}.edu.net.au/api/rest/v1/

...

ScheduledAssessment
eduScheduledUnitId={value} 

...

assessmentId={value}

...

assessmentTypeId={value}
scheduledAssessmentId={value}
scheduledAssessmentStatusId={value}

...

scheduledAssessmentName={value}


Find ScheduledFee entity records 

Replace {value} with text, join criteria with “&” 

CodeField
GET https://{host}.edu.net.au/api/rest/v1/

...

ScheduledFee
eduScheduledUnitId={value}Scheduled Unit Identifier 
eduScheduledFeeSeqId={value}Scheduled Feee Identifier
eduProgramId={value}

...

Program Code (full/partial) 
description={value}Fee Description (full/partial)


Example URL query CriteriaField
?eduScheduledUnitId=10123All Fees for a Scheduled Unit 
?eduProgramId=DipBusAll Fees for a Program/Course 
?eduScheduledUnitId=10123&eduProgramId=DipBusAll Fees for a Scheduled Unit for a specific Program/Course 


Code Block
GET 
https://{host}.edu.net.au/api/rest/v1/

...

ScheduledFee
eduScheduledUnitId={value}

...

eduScheduledFeeSeqId={value}
eduProgramId={value}

...

description={value}

...


Find

...

ScheduledUnitFee entity records 

(new API entity to simplify unit fee management) Replace {value} with text, join criteria with “&” 

CodeField
GET https://{host}.edu.net.au/api/rest/v1/ProgramScheduledUnitFee
eduProgramIdeduScheduledUnitId={value}Program Code (full/partial)programName Scheduled Unit Identifier 
eduUnitId={value}Program Name (full/partial)programStatusId Unit Identifier 
unitName={value}Program Status (status idUnit Name (scheduled
keywords unitStatusId={value}Keywords Unit Status (partial matchscheduled)
Example URL query CriteriaField
?programStatusId=PROGRAM_ACTIVEAll ACTIVE Programs 
?programStatusId=PROGRAM_INACTIVEAll INACTIVE Programs 
?programStatusId=PROGRAM_ACTIVE&programName=DiplomaACTIVE Diploma Programs 
Code Block
GET https://{host}.edu.net.au/api/rest/v1/Program
eduProgramId={value}
programName ={value}
programStatusId ={value}
keywords ={value}

Find ProgramUnitConstraint entity records

Replace {value} with text, join criteria with “&” 

...

eduOtherUnitId ={value}Unit Code (scheduled)
providerPartyId ={value}Provider (party identifier)
startDate={value}Start Date (scheduled) 
endDate={value}End Date (scheduled)
destCensusDate={value}Census Date (scheduled)
feeTypeId={value}

Fee Type (Code=FEE_TYPE) 


Example URL Query criteriaField
?unitStatusId=UNIT_INACTIVEAll INACTIVE Scheduled Unit Fees 
?unitStatusId=UNIT_ACTIVEAll ACTIVE Scheduled Unit Fees 
?unitStatusId=UNIT_ARCHIVEDAll ARCHIVED Scheduled Unit Fees
?unitStatusId=UNIT_ACTIVE&eduOtherUnitId=ICBACTIVE Scheduled Unit Fees for a Unit Code prefix
?unitStatusId=UNIT_ACTIVE&providerPartyId=10000ACTIVE Scheduled Unit Fees for a specific Provider 
?unitStatusId=UNIT_ACTIVE&startDate=2015-01-01ACTIVE Scheduled Unit Fees for a specific Start Date
?unitStatusId=UNIT_ACTIVE&eduUnitId=ICB1233&startDate=201501-01&endDate=2015-12-31 ACTIVE Scheduled Unit Fees for a specific Unit and specific Start and End Dates
?unitStatusId=UNIT_ACTIVE&eduUnitId=ICB1233&startDate=201501-01&endDate=2015-12-31&feeTypeId= STANDARD_FEEACTIVE Scheduled Unit Fees for a specific Unit and Fee Type and specific Start and End Dates 
?unitStatusId=UNIT_ACTIVE&eduUnitId=ICB1233&feeTypeId= STANDARD_FEEACTIVE Scheduled Unit Fees for a specific Unit and Fee Type (multiple dates may be returned) 


Code Block
GET 
https://{host}.edu.net.au/api/rest/v1/ ProgramUnitConstraint
constraintTypeIdScheduledUnitFee
eduScheduledUnitId={value}
eduUnitId={value}
unitName={value}
unitStatusId={value}
eduOtherUnitId ={value}
providerPartyId ={value} 
eduProgramIdstartDate={value}
eduUnitIdendDate={value}
constraintEduUnitIddestCensusDate={value}
descriptionfeeTypeId={value} 


Find

...

Entity entity

...

Replace {value} with text, join criteria with “&” 

...

records 

Code
GET https://{hostsitename}.edu.net.au/api/rest/v1/UniteduUnitId={valueEntityName} Unit Identifier 
unitName={value} Unit Name (full/partial) 
eduOtherUnitId
name1={value} Unit Code (full/partial
unitStatusId={value}Unit Status (status identifier) 
providerPartyId
name2={value} Provider (party identifier)keywords
name3={value}
name4={value} Keywords text (partial match)


Example URL query Criteriacriteria
?unitStatusId=UNIT_INACTIVEAll INACTIVE units 
?unitStatusId=UNIT_ACTIVEAll ACTIVE units 
?unitStatusId=UNIT_ARCHIVEDAll ARCHIVED units 
?unitStatusId=UNIT_ACTIVE&eduOtherUnitId=ICBACTIVE Units for a Unit Code prefix 
?unitStatusId=UNIT_ACTIVE&providerPartyId=10000ACTIVE Units for a specific Provider name1=value&name2=value&name3=value&name4=value&


Code Block
GET 
https://{hostsitename}.edu.net.au/api/rest/v1/Unit  
eduUnitId={value{EntityName}
unitNamename1={value} eduOtherUnitId 
name2={value} 
unitStatusIdname3={value} providerPartyId={value}
keywords 
name4={value}




Further reading

This section of the KB contains links to any further related information that would be helpful for the purpose  understanding this topic.