Extension 3 Family data

Ext 3.1 Publish families

The term 'family' in LISS is called 'household' by some SIS's, for example 1 or 2 parents grouped by address.

Call

liss.publishFamilies(auth, data)

Parameters

auth: See authentication

data: An array of structs. Each struct is defined as follows:

FieldTypeNotesExample
Codestring mandatoryA short identifier which uniquely identifies this family.SMITH041
NamestringLISS does not give much guidance on how this field is to be used, but it could be something that you can put at the top of a letter sent to the parents.Mr & Mrs Smith Jenny & John Smith
EmailstringOne email address which will reach one or both parents.jenny.smith@gmail.com
PhonestringPhone number, mobile and/or landline.0488 888 888
AddressstringThe family's address.31 Denfort Rd, Liquorland 2251
Guid32 char hexadecimal string32 hexadecimal characters. They might be uppercase or lowercase, but we require that they do not contain punctuation.EF6E5950ED748E5A9D4997A8B7337099
Childrenarray of structsArray of structs defined below.

Each item in the Children array is defined as follows:

FieldTypeNotesExample
Codestring mandatoryA short identifier which uniquely identifies this student.SMI51235
FirstNamestringThe student's first name.Kenny
SurnamestringStudent's surname.Smith
CustodialstringPhone number, mobile and/or landline.0488 888 888
EmailstringThe student's email.studentSMI51235@denfort.edu.au

Returns

Nothing - an empty string "". If anything other than an error is returned it should be ignored. For error reporting see fault codes.

Example

Send

{
"method": "liss.publishFamilies",
"params": [
{
"School": "03014",
"UserName": "Jsmith",
"Password": "Password1",
"LissVersion": 10002,
"UserAgent": "Edval"
},
[
{
"Code": "SMITH041",
"Name": "Mr & Mrs Smith",
"Email": "jenny.smith@gmail.com",
"Phone": "0488 888 888",
"Address": "31 Denfort Rd, Liquorland 2251",
"Guid": "EF6E5950ED748E5A9D4997A8B7337099",
"Children": [
{
"Code": "SMI51235",
"FirstName": "Kenny",
"Surname": "Smith",
"Custodial": "0488 888 888",
"Email": "studentSMI51235@denfort.edu.au"
}
]
}
]
],
"id": 0
}

Return

{
"result": "",
"id": 0
}

Ext 3.2 Get families

Call

liss.getFamilies(auth)

Parameters

auth: See authentication

Returns

An array of structs. Each struct is defined as above liss.publishFamilies().

Example

Send

{
"method": "liss.publishFamilies",
"params": [
{
"School": "03014",
"UserName": "Jsmith",
"Password": "Password1",
"LissVersion": 10002,
"UserAgent": "Edval"
}
],
"id": 0
}

Return

{
"result": [
{
"Code": "SMITH041",
"Name": "Mr & Mrs Smith",
"Email": "jenny.smith@gmail.com",
"Phone": "0488 888 888",
"Address": "31 Denfort Rd, Liquorland 2251",
"Guid": "EF6E5950ED748E5A9D4997A8B7337099",
"Children": [
{
"Code": "SMI51235",
"FirstName": "Kenny",
"Surname": "Smith",
"Custodial": "0488 888 888",
"Email": "studentSMI51235@denfort.edu.au"
}
]
}
],
"id": 0
}