ASP.NET VETtrak API web services
ContentsIndexHome
PreviousUpNext
VT_API.UpdateClientWebWaitlist Method

Update the details of a Web Client attached to a waitlist entry. 

A Client Web Waitlist must have previously been created, see AddClientWebWaitlist. This function records Client details for the given Web Waitlist. 

A Web Waitlist ID (webWaitlistId) is passed as a parameter. This should be the ID returned by the AddClientWebWaitlist function. 

It is not possible to change the client's fundamental data which was used to create the enrolment. If it is necessary to change any of surname, given name, Date of Birth or Code, then it will be necessary to delete the waitlist and start again. 

This function should not be used to update details of clients who are part of a Client Web Enrolment. In these cases, use UpdateWebClient

A token is passed for authentication. If the authentication fails, or other errors occur, nothing is updated . The result of the authentication is represented by a TAuthenticate object. 

The only mandatory parameters are token and webWaitlistId. An empty string or null can be passed for any other parameters. 

Requires a valid registration key entry for the Short Courses feature. 

This function has security level "Protected", and can only be accessed by users that have explicitly been granted permission to the API.

C#
[WebMethod(Description = "Records the specified additional data against the client linked to the specified web waitlist ID")]
public TAuthenticate UpdateClientWebWaitlist(string token, int webWaitlistId, string otherName, string title, string gender, string residentialAddress, string residentialCity, string residentialPostcode, string residentialShortState, string homePhone, string workPhone, string mobilePhone, string email, string emergencyName, string emergencyPhone, string emergencyMobile, string postalAddr, string postalCity, string postalPostcode, string postalShortState, int? divisionId, string usi, TAddress usualAddress, TAddress postalAddress, string surveyContactStatusCode);
Parameters 
Description 
string token 
String containing a token. 
int webWaitlistId 
Integer ID of Web Waitlist. 
string otherName 
String containing the Client's Other Name. Maximum length 50 characters. 
string title 
String containing the Client's Title - eg. Mr, Mrs, Miss, Dr etc. Maximum length 10 characters. 
string gender 
String - Gender of Client.
Valid Gender Values are:
  • @ => Not Stated,
  • M => Male,
  • F => Female,
  • X => Indeterminate/Intersex/Unspecified. 
string residentialAddress 
WARNING: This field is deprecated and will be removed in a future version of the API. You should use usualAddress.Building, usualAddress.UnitDetails, usualAddress.StreetNumber and usualAddress.StreetName instead.
String - Residential Address for Client. Maximum length 100 characters. 
string residentialCity 
WARNING: This field is deprecated and will be removed in a future version of the API. You should use usualAddress.City instead.
String - City of Client's Residential Address. Maximum length 50 characters. 
string residentialPostcode 
WARNING: This field is deprecated and will be removed in a future version of the API. You should use usualAddress.Postcode instead.
String - Post Code of Client's Residential Address. Maximum length 4 characters. 
string residentialShortState 
WARNING: This field is deprecated and will be removed in a future version of the API. You should use usualAddress.State instead.
String - State Short Name for Client's Residential Address. See GetStateList.
Valid Short Names are:
  • NSW,
  • Vic,
  • Qld,
  • SA,
  • WA,
  • Tas,
  • NT,
  • ACT,
  • Other,
  • Overseas. 
string homePhone 
String - Home Phone Number of Client. Maximum length 20 characters. For AVETMISS compliance, this should include the area code (thus, contain at least 10 digits) 
string workPhone 
String - Work Phone Number of Client. Maximum length 20 characters. For AVETMISS compliance, this should include the area code (thus, contain at least 10 digits) 
string mobilePhone 
String - Mobile Phone Number of Client. Maximum length 20 characters. For AVETMISS compliance, this should include the area code (thus, contain at least 10 digits) 
string email 
String - Email Address of Client. Maximum length 100 characters. 
string emergencyName 
String - Emergency Contact Name for Client. Maximum length 100 characters. 
string emergencyPhone 
String - Phone Number for Client's Emergency Contact. Maximum length 20 characters. 
string emergencyMobile 
String - Mobile Phone Number for Client's Emergency Contact. Maximum length 20 characters. 
string postalAddr 
WARNING: This field is deprecated and will be removed in a future version of the API. You should use postalAddress.Building, postalAddress.UnitDetails, postalAddress.StreetNumber, postalAddress.StreetName and postalAddress.POBox instead.
String - Postal Address for Client. Maximum length 100 characters. 
string postalCity 
WARNING: This field is deprecated and will be removed in a future version of the API. You should use postalAddress.City instead.
String - City of Client's Postal Address. Maximum length 50 characters. 
string postalPostcode 
WARNING: This field is deprecated and will be removed in a future version of the API. You should use postalAddress.Postcode instead.
String - Post Code of Client's Postal Address. Maximum length 4 characters. 
string postalShortState 
WARNING: This field is deprecated and will be removed in a future version of the API. You should use postalAddress.State instead.
String - State Short Name for Client's Postal Address. See GetStateList.
Valid Short Names are:
  • NSW,
  • Vic,
  • Qld,
  • SA,
  • WA,
  • Tas,
  • NT,
  • ACT,
  • Other,
  • Overseas. 
int? divisionId 
Integer - ID of division to link the client to. Use functions such as GetDivisions to get a list of valid divisions. Specify null or 0 to link them to the same division as the occurrence they are enrolling into. 
string usi 
String - Optional Unique Student Identifier for the client. If specified, must be 10 characters, must be upper case (allowed characters are 2-9, and A-Z except I and O), and must have a valid Luhn Mod N check character. Use the ValidateUSI function to check whether a USI is valid. 
TAddress usualAddress 
TAddress : The usual/residential address of the client. This is the preferred way to specify the address. If this object is specified, the residentialAddress, residentialCity, residentialPostcode, and residentialShortState fields will be ignored. 
TAddress postalAddress 
TAddress : The postal address of the client. This is the preferred way to specify the address. If this object is specified, the postalAddr, postalCity, postalPostcode, and postalShortState fields will be ignored. 
string surveyContactStatusCode 
String : Optional NCVER survey contact status for the client. If not specified, it will be "A". Valid values are:
  • A : Available for survey use
  • C : Correctional facility (address or enrolment)
  • D : Deceased student
  • E : Excluded
  • I : Invalid address / Itinerant student (very low likelihood of response)
  • M : Minor - under age of 15 (not to be surveyed)
  • O : Overseas (address or enrolment)
 

TAuthenticate : an Authenticate Object containing the result of the update.

 

 

Copyright (c) VETtrak 2022. All rights reserved.