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

Update the details of a Web Enrolment. 

A Client or Employer Web Enrolment must have previously been created, see AddClientWebEnrolment or AddEmployerWebEnrolment. This function updates the description and reason for study for the given Web Enrolment. 

A Web Enrolment ID (webEnrolId) is passed as a parameter. This should be the ID returned by the AddClientWebEnrolment or AddEmployerWebEnrolment function. 

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 webEnrolId. An empty string can be passed for the description, and null or 0 for the studyReasonId. 

An optional list of no more than 3 VIC Commencing Program Cohort Identifier Codes can be specified in the vicCohortCodes parameter. This is only applicable to enrolments in VIC, and will be ignored if the occurrence is not in VIC. Refer to GetVicCommencingProgramCohortList for a list of valid codes. The list specified will replace any existing list that was specified for the web enrolment in a previous call. You can also pass a special code of "@@" in the list - if "@@" is specified in the list, any other entries in the list are ignored and the value will be treated as "Not stated". Duplicate values in the list are ignored. 

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 = "Updates the details of the specified web enrolment ID")]
public TAuthenticate UpdateWebEnrolment(string token, int webEnrolId, string description, int? studyReasonId, string vetEnrolRegistrationId, List<string> vicCohortCodes);
Parameters 
Description 
string token 
String containing a token. 
int webEnrolId 
Integer ID of Web Enrolment. 
string description 
The new description to record against the web enrolment. This overrides any existing description. 
int? studyReasonId 
The ID of the reason for study for this enrolment. Pass null or 0 for none. 
string vetEnrolRegistrationId 
Optional VETenrol registration identifier for the web enrolment. 
List<string> vicCohortCodes 
List of VIC Commencing Program Cohort Identifiers for the web enrolment. 

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

Copyright (c) VETtrak 2022. All rights reserved.