Namespace: PASI.ServiceContract
Assembly: PASI.ServiceContract (in PASI.ServiceContract.dll) Version: 9.25.26.0 (9.25.26.0)
Parameters
- request
- Type: PASI.DataContract.V2018SubmitNameRequest
Contains the name, the name Id to correct (for corrections only), the StateProvinceId and the Student's PASI core version. If an alias is to be deleted the flag to do so is also on this contract.
Return Value
Type: SubmitResponseThe Id returned in this service will be the RefId of the Student Alias. If a student alias could not be added the Id will be returned as zero. The PASICoreVersion is the new version for the student.
Service Validations
The following codes can be returned from the service operation. This list also shows core alerts that could be generated as a result calling this service. These codes are in addition to the standard set of codes that can be returned defined as in the Approach to Error Reporting. Click the link for the details.
9002, 9006, 9011, 9014, 9023, 9049, 9065, 11201, 11203, 11204, 11206, 11207, 11208, 11215, 11216, 11219, 11220, 11221, 11222, 11223, 11224, 11227School 1 creates the student alias as John Doe:
NameId | StateProvinceId | Name | NameType | Created By | Modified By |
1 | 123456789 | John Doe | Alias | School1 | School1 |
After submitting the name, School 1 realizes the alias was supposed to be "Johnny Doe" so they correct the alias:
NameId | StateProvinceId | Name | NameType | Created By | Modified By |
1 | 123456789 | Johnny Doe | Alias | School1 | School1 |
Next, Johnny Doe starts attending School2 and decides he would like to go by Mark Doe (Mark being his middle name) so School2 would create a second alias for this student.
NameId | StateProvinceId | Name | NameType | Created By | Modified By |
1 | 123456789 | Johnny Doe | Alias | School1 | School1 |
2 | 123456789 | MarkDoe | Alias | School2 | School2 |
Request and Response Class Diagram
Request Fields
Full Property Name | Type | Required | Other Attributes |
---|---|---|---|
CallerInfo | CallerInfo | Yes | |
CallerInfo.ClientMessageID | String | Yes | Value must be no more than 50 characters Value must not have control characters, leading, trailing or multiple embedded spaces. Content must not match regular expression: ^\s|\s{2,}|\s$|[\x00-\x19]|[\x7F-\x9F]|[^\x00-\xFF] |
CallerInfo.SentUtcTime | DateTime | Yes | |
CallerInfo.Software | Software | Yes | |
CallerInfo.Software.BuildNumber | String | Yes | Value must be no more than 30 characters Value must not have control characters, leading, trailing or multiple embedded spaces. Content must not match regular expression: ^\s|\s{2,}|\s$|[\x00-\x19]|[\x7F-\x9F]|[^\x00-\xFF] |
CallerInfo.Software.Manufacturer | String | Yes | Value must be no more than 100 characters Value must not have control characters, leading, trailing or multiple embedded spaces. Content must not match regular expression: ^\s|\s{2,}|\s$|[\x00-\x19]|[\x7F-\x9F]|[^\x00-\xFF] |
CallerInfo.Software.Product | String | Yes | Value must be no more than 100 characters Value must not have control characters, leading, trailing or multiple embedded spaces. Content must not match regular expression: ^\s|\s{2,}|\s$|[\x00-\x19]|[\x7F-\x9F]|[^\x00-\xFF] |
CallerInfo.Software.Version | String | Yes | Value must be no more than 30 characters Value must not have control characters, leading, trailing or multiple embedded spaces. Content must not match regular expression: ^\s|\s{2,}|\s$|[\x00-\x19]|[\x7F-\x9F]|[^\x00-\xFF] |
CallerInfo.User | User | Yes | |
CallerInfo.User.IPAddress | String | Yes | Value must be no more than 50 characters Value must not have control characters, leading, trailing or multiple embedded spaces. Content must not match regular expression: ^\s|\s{2,}|\s$|[\x00-\x19]|[\x7F-\x9F]|[^\x00-\xFF] |
CallerInfo.User.LocalID | String | Yes | Value must be no more than 50 characters Value must not have control characters, leading, trailing or multiple embedded spaces. Content must not match regular expression: ^\s|\s{2,}|\s$|[\x00-\x19]|[\x7F-\x9F]|[^\x00-\xFF] |
CallerInfo.User.Name | String | Yes | Value must be no more than 100 characters Value must not have control characters, leading, trailing or multiple embedded spaces. Content must not match regular expression: ^\s|\s{2,}|\s$|[\x00-\x19]|[\x7F-\x9F]|[^\x00-\xFF] |
CallerInfo.User.OrganizationCode | String | Yes | Value must be no more than 6 characters |
DeleteName | Boolean | Yes | |
IsPreferred | Boolean | No | |
Name | Name | Yes | |
Name.FirstName | String | Yes | Value must be no more than 50 characters Value must only contain letters (A-Z), hyphens (-), apostrophes ('), periods (.), spaces ( ), or accented letters (ÀÁÂÃÄÅÇÈÉÊËÌÍÎÏÑÒÓÔÕÖÙÚÛÜÝàáâãäåçèéêëìíîïñòóôõöùúûüýÿ) |
Name.LastName | String | Yes | Value must be no more than 50 characters Value must only contain letters (A-Z), hyphens (-), apostrophes ('), periods (.), spaces ( ), or accented letters (ÀÁÂÃÄÅÇÈÉÊËÌÍÎÏÑÒÓÔÕÖÙÚÛÜÝàáâãäåçèéêëìíîïñòóôõöùúûüýÿ) |
Name.LastUpdateUtcTime | DateTime | No | |
Name.MiddleName | String | No | Value must be no more than 50 characters Value must only contain letters (A-Z), hyphens (-), apostrophes ('), periods (.), spaces ( ), or accented letters (ÀÁÂÃÄÅÇÈÉÊËÌÍÎÏÑÒÓÔÕÖÙÚÛÜÝàáâãäåçèéêëìíîïñòóôõöùúûüýÿ) |
Name.RefId | Int32 | Yes | |
Name.Suffix | String | No | Value must be no more than 15 characters Value must only contain letters (A-Z), hyphens (-), apostrophes ('), periods (.), spaces ( ), or accented letters (ÀÁÂÃÄÅÇÈÉÊËÌÍÎÏÑÒÓÔÕÖÙÚÛÜÝàáâãäåçèéêëìíîïñòóôõöùúûüýÿ) |
PASICoreVersion | Int64 | Yes | |
SourceChangeCode | Int16 | No | |
StateProvinceId | String | Yes | Value must be in the form of a number between '000000001' and '999999999' |
Response Fields
Full Property Name | Type | Required | Other Attributes |
---|---|---|---|
SubmitResponse.Id | String | No | |
SubmitResponse.PASICoreVersion | Int64 | No | |
SubmitResponse.Rejections | List<Rejection> | No | |
SubmitResponse.Rejections.Code | String | Yes | |
SubmitResponse.Rejections.Description | String | Yes |