Versions Compared
Key
- This line was added.
- This line was removed.
- Formatting was changed.
Overview
Provides access to the logged in User Account related data and Workbench User data.
Endpoints
The resources available in this module.
AccountApi
Provides API access to logged in user infoinformation.
/api/AccountApi | |||||
---|---|---|---|---|---|
Method | DescriptionPerformed As | Request Query | Request Body | Response | |
GET | Logged in User | - | - |
PeopleListApi
Provides API access to the “People“ List of People (#/General/PersonList.aspx) Web Workbench screen.
/api/PeopleListApi | |||||
---|---|---|---|---|---|
Method | DescriptionPerformed As | Request Query | Request Body | Response | |
POST | Logged in User | - | GridResult<GridResult<PersonLine> |
PeopleDetailApi
Provides API access to the “People“ People detail (#/General/PersonList.aspx) dialog Web Workbench screen.
/api/PeopleDetailApi | |||||
---|---|---|---|---|---|
Method | Description | Performed As | Request Query | Request Body | Response |
GET | Admin User | PersonId- | |||
POST | Admin User | - |
Models
The definitions of models specific to endpoints in this module.
AccountApiModel
Property | Type | Length | Description |
---|---|---|---|
PersonID | Integer | 50 | The unique Person ID of the Logged in User |
FullName * | String | 50 | The Full Name of the Logged in User |
FinCoCode | String | 50 | The Code of the Financial Company the Logged in User belongs to |
⬆️ Back to top
PersonKey
Property | Type | Length | Description |
---|---|---|---|
PersonID | Integer | 50 | The unique Person ID of the Person |
⬆️ Back to top
PersonLine
Property | Type | Length | CellData | Description |
---|---|---|---|---|
Key | The unique key for the line | |||
PersonId | Integer | 50 | PersonIdValue.CellValue | The unique ID of the Person |
DisplayName | String | 255 | ||
Surname | String | 50 | Surname.CellValue | Family name |
FirstName | String | 50 | FirstNameValue.CellValue | First name |
Company | String | CompanyValue.CellValue | The company nam of this person. | |
CompanyId | Integer | CompanyValue.CellId | The Company code of this person | |
Role | String | RoleValue.CellValue | The role of this person | |
JobTitle | String | 50 | JobTitleValue.CellValue | User's official title. |
EmailAddress | String | 250 | EmailAddressValue.CellValue | Email address . |
MobilePhone | String | 50 | MobilePhoneValue.CellValue | Mobile number |
BusinessPhone | String | 50 | BusinessPhone.CellValue | Working phone number |
IsEmployee | Boolean | The person is an employee or not. | ||
IsActive | Boolean | The account is active or not. | ||
IsInactive | Boolean | The account is inactive or not. | ||
IsBillingContact | Boolean | The person is the billing contact or not. | ||
IsSiteContact | Boolean | The person is the primary project contact or not. | ||
IsCommercialContact | Boolean | The person is the Site Contact or not. | ||
EmployeeNo | String | 50 | Employee code | |
Group1 | String | The Attribute Group of the first Attribute Category filter | ||
Group2 | String | The Attribute Group of the second Attribute Category filter | ||
Group3 | String | The Attribute Group of the third Attribute Category filter | ||
UpdatedDate | DateTime | The Date this record was last updated. | ||
Delete |
⬆️ Back to top
PeopleApiModel
Property | Type | Description |
---|---|---|
Key | The unique key of the Person. | |
Main | General data associated with the Person. | |
Attributes.Rows | Array<AttributeLine> | Attributes associated with the Person. |
Notes.Rows | Array<NoteLine> | Notes associated with the Person. |
ToDoItems.Rows | Array<ToDoLine> | To Do Items associated with the Person. |
⬆️ Back to top
PersonMainFields
Property | Type | Length | Description |
---|---|---|---|
Surname | 50 | Surname | |
FirstName | 50 | First name | |
FullName | 50 | Full name | |
PersonIdNum | 50 | The unique Person ID of the Person | |
Title | 50 | The name prefix for this user. | |
Company | 100 | Company of the person. | |
JobTitle | 50 | Official position of the person. | |
Salutation | 50 | how the person is addressed in correspondence. | |
EmailAddress | 250 | Email address. | |
EmailAddress2 | 250 | Second email address. | |
MobilePhone | 50 | Mobile Phone number. | |
BusinessPhone | 50 | Business Phone number. | |
CompanyPhone | 50 | Company phone number | |
HomePhone | 50 | Home phone number | |
Fax | 50 | Fax number | |
PersonalReference | 50 | Free text as reference | |
PersonalAddress | 200 | Person address | |
BillingContact | Indicate this person is the primary contact for billing purposes for the company. | ||
SiteContact | Indicate this person is the primary project contact. | ||
CommercialContact | Indicate this person is the primary contact for commercial purposes for the company. | ||
Inactive | Indicate the status of this account. |
⬆️ Back to top
Examples
Get the logged in user
Expand | |||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||
Request
Response
Response sample
|
Get a filtered and sorted list of people
Expand | |||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||
Request
Response
Response Sample
|
Create a new person
Expand | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||
Request
Response
Response Sample
|
⬆️ Back to top
On this page
Table of Contents | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Include Page | ||||
---|---|---|---|---|
|