In Synergist a 'view' is a saved query. The view ('settings') id is typically passed as a parameter to define which selection of records is returned (see 'models')
Views (settings)
Use this API endpoint to get a list of 'views' for a particular table. A view is essentially a saved query.
Example request:
Parameter | Description | Examples |
|---|---|---|
API | API endpoint | views.json |
Type | Specify table | type=activities |
General | Parameters described in overview | user=user&password=user&version=4 |
input optional | The company context | company=1 |
Note: to retrieve views saved by a user, the user name and password would need to be passed
Request for a list of views
http://<SERVER>/jsonapi/views.json?user=user&password=user&company=1&type=activities&version=4
OR
(listing special views used for creating jobs)
http://<SERVER>/jsonapi/views.json?user=user&password=user&company=1&type=jobcreate&version=4.0Example response:
{
"responsecode": 1,
"responsestatus": "OK",
"errorcode": 0,
"errormessage": "",
"totalrows": 10,
"totalpages": 1,
"responsemessage": "",
"pagerows": 0,
"pagenumber": 1,
"success": true,
"data": [
{
"settings_uuid": "8771237951EB5241A7457443688BA09B",
"settingsTimeStampModified": 1466508984,
"settingsRecordVersionNumber": 0,
"SettingsCompany": 0,
"SettingsDescription": "My open activities",
"SettingsDisplayOrder": "01",
"SettingsSettingsID": -1703,
"SettingsUserID": 0,
"SettingsDefault": false,
"settingsSort": "DATEREQUIRED",
"settingsSortDirection": "ASC"
}
]
}Parameters
- Type – The type of view list to return. Valid values are:
- “Organizations”
- “Contacts”
- “Activities”
- “Opportunities”
- “Jobs”
- “Phases”
- "Jobcreate" (this is a special type of view used for setting the options when copying a job)
- Company – The company number(s) which contain the view list required. If you omit this parameter or pass an empty string as the company number, all views will be returned. If passing multiple company numbers, they should be delimited with a carriage return.