Versions Compared
Key
- This line was added.
- This line was removed.
- Formatting was changed.
Overview
Provides access to Account related data and Workbench User data.
Endpoints
The resources available in this module.
AccountApi
Provides access to logged in user info.
/api/AccountApi
Method
Description
Performed As
Request Query
Request Body
Response
GET
Retrieve current logged in user
Logged in User
-
-
PeopleListApi
Provides API access to the “People“ (#/General/PersonList.aspx) Web Workbench screen.
/api/PeopleListApi
Method
Description
Performed As
Request Query
Request Body
Response
POST
Retrieve a filtered list of people
Logged in User
-
GridRequestParametersApi
GridResult<PersonLine>
PeopleDetailApi
Provides API access to the “People“ (#/General/PersonList.aspx) dialog Web Workbench screen.
/api/PeopleDetailApi
Method
Description
Performed As
Request Query
Request Body
Response
GET
Retrieve a specific Person
Admin User
-
POST
Update a Person
Admin User
-
Models
The definitions of models specific to endpoints in this module.
AccountApiModel
Field
Type
Description
PersonID
Integer
The unique PersonID of the Logged in User
FullName
String
The full name of the Logged in User
FinCoCode
String
The Financial Company Code the Logged in User belongs to
PersonKey
Field
Type
Description
PersonID
Integer
The unique PersonID of the Person
PersonLine
Field
Type
CellData
Description
Key
The unique Key for the line
PersonId
Integer
PersonIdValue.CellValue
The unique ID of the Person
DisplayName
String
Surname
String
Surname.CellValue
FirstName
String
FirstNameValue.CellValue
Company
String
CompanyValue.CellValue
The name of the Company this Person belongs to
CompanyId
Integer
CompanyValue.CellId
The ID of the Company this Person belongs to
Role
String
RoleValue.CellValue
the Purchase Requisition Role of this Person
JobTitle
String
JobTitleValue.CellValue
EmailAddress
String
EmailAddressValue.CellValue
MobilePhone
String
MobilePhoneValue.CellValue
BusinessPhone
String
BusinessPhone.CellValue
IsEmployee
Boolean
IsActive
Boolean
IsInactive
Boolean
IsBillingContact
Boolean
Billing Contact of the Company
IsSiteContact
Boolean
Site Contact of the Company
IsCommercialContact
Boolean
Commercial Contact of the Company
EmployeeNo
String
Group1
String
The Attribute Group of the first Category filter
Group2
String
The Attribute Group of the second Category filter
Group3
String
The Attribute Group of the third Category filter
UpdatedDate
DateTime
The DateTime this record was last updated
Delete
CellData
PeopleApiModel
Field
Type
Description
PersonID
Integer
The unique PersonID of the Logged in User
FullName
String
The full name of the Logged in User
FinCoCode
String
Overview
Provides access to Account related data and Workbench User data.
Endpoints
The resources available in this module.
AccountApi
Provides API access to logged in user information.
/api/AccountApi | ||||
---|---|---|---|---|
Method | Performed As | Request Query | Request Body | Response |
GET | Logged in User | - | - |
PeopleListApi
Provides API access to the List of People (#/General/PersonList.aspx) Web Workbench screen.
/api/PeopleListApi | ||||
---|---|---|---|---|
Method | Performed As | Request Query | Request Body | Response |
POST | Logged in User | - |
PeopleDetailApi
Provides API access to the People detail (#/General/PersonList.aspx) dialog Web Workbench screen.
/api/PeopleDetailApi | ||||
---|---|---|---|---|
Method | Performed As | Request Query | Request Body | Response |
GET | Admin User | - | ||
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 | ||||
---|---|---|---|---|
|