ProblemList - CWS web service
Avatar CWS Problem List web service.
This functionality enables the filing of problems into a client's 'Problem List'. Client problems may be added, edited, or deleted via the web service. Following a successful filing of the web service, changes will be viewable via the web service itself and via the 'Problem List' myAvatar form. The myAvatar Web Services module is required to use this functionality.
This web service request has the following operations:
- AddClientProblems
- GetClientProblemList
- GetDictionaryItems
- SearchProblems
This web service has the following object classes:
- WEBSVC.ProblemCodeObject
- WEBSVC.ListOfProblemCodeObjects
- WEBSVC.ProblemListObject
- WEBSVC.ListOfProblemListObjects
- WEBSVC.ListOfProblemListObjectsContainer
AddClientProblems Call
Adds to and/or edits a client’s list of problems.
When adding to a client's problem list, if a cached 'SYSTEM.RADplus_IMO_results' table row exists, and either 'IMOCacheCode' or 'IMOCode' and 'IMODesc' (in combination) is provided, many other properties do not need to be provided, since data will come directly from the cached table row. Alternatively, all of the same properties returned from either the 'SearchProblems' or 'GetClientProblemList' call can be filled out, including the internal hash. This hash will be validated against all other properties provided, and hash validation will fail if any of these properties are different or missing. This prevents users from making modifications to data returned by the 'SearchProblems' or 'GetGlientProblemList' call.
Data validation can fail for a number of reasons. If data validation fails, no data will be filed. Reasons for validation failure may include missing required fields, providing an invalid 'UniqueID', attempting to file duplicate active problem codes, filing conflicting problem data that already exists for the client, etc.. When validation fails, the response will contain errors. These errors will detail the nature of the error and the web service object which caused the error. If validation succeeds, the response will indicate a successful filing, and will include the 'UniqueID's of the added/edited problems. It is recommended that a 'GetClientProblemList' call is performed before performing a 'AddClientProblems' call in order to anticipate and resolve these validation errors.
The following tables list the AddClientProblems parameters, properties, accepted values, and associated dictionaries.
Parameters with no Properties
| Parameter | Property | Value Accepted | Notes |
|---|---|---|---|
| SystemCode | N/A | Avatar System Code | Examples: SAMPLE, LIVE, etc. |
| UserName | N/A | Avatar User ID | |
| Password | N/A | Avatar Password | |
| ClientID | N/A | Avatar Client ID |
Parameters with Properties
| Parameter | Property | Value Accepted | Notes |
|---|---|---|---|
| ProblemListForm | WEBSVC.ListOfProblemListObjectsContainer | WEBSVC.ListOfProblemListObjectsContainer | This parameter is itself a web service object -- see below for its properties |
GetClientProblemList Call
Gets a client’s current list of problems. This list will include all of the data displayed in the 'Problem List' myAvatar form, as well as a 'UniqueID' for each item (which can be used by the 'AddClientProblem' call to select the problem to be modified).
When retrieving existing client problems that use IMO problem codes, the results will contain a number of properties, including 'IMOCode', 'IMODesc', 'IMOLastUpdated', etc.. The property 'IMOCacheCode' is a value that is returned if a cached 'SYSTEM.RADplus_IMO_results' table row exists for the problem code.The property 'InternalHash' is a value that is generated from other returned properties. See the 'AddClientProblems' call for more information on how these properties are used.
The following tables list the GetClientProblemList parameters, properties, accepted values, and associated dictionaries.
Parameters with no Properties
| Parameter | Property | Value Accepted | Notes |
|---|---|---|---|
| SystemCode | N/A | Avatar System Code | Examples: SAMPLE, LIVE, etc. |
| UserName | N/A | Avatar User ID | |
| Password | N/A | Avatar Password | |
| ClientID | N/A | Avatar Client ID |
GetDictionaryItems Call
Gets the dictionary codes and values from the myAvatar 'Problem List' form and grid.
The following tables list the GetDictionaryItems parameters, properties, accepted values, and associated dictionaries.
Parameters with no Properties
| Parameter | Property | Value Accepted | Notes |
|---|---|---|---|
| SystemCode | N/A | Avatar System Code | Examples: SAMPLE, LIVE, etc. |
| UserName | N/A | Avatar User ID | |
| Password | N/A | Avatar Password |
SearchProblems Call
Search for valid problem codes/descriptions using the IMO problem search (if available), as well as any user defined problems defined in myAvatar . The data returned can be used when adding/editing a client’s problem list.
When searching for problems via the IMO web search, the results will contain a number of properties, including 'IMOCode', 'IMODesc', 'IMOLastUpdated', etc.. The property 'IMOCacheCode' is a value that is returned if a cached 'SYSTEM.RADplus_IMO_results' table row exists for the problem code.The property 'InternalHash' is a value that is generated from other returned properties. See the 'AddClientProblems' call for more information on how these properties are used.
The following tables list the SearchProblems parameters, properties, accepted values, and associated dictionaries.
Parameters with no Properties
| Parameter | Property | Value Accepted | Notes |
|---|---|---|---|
| SystemCode | N/A | Avatar System Code | Examples: SAMPLE, LIVE, etc. |
| UserName | N/A | Avatar User ID | |
| Password | N/A | Avatar Password | |
| SearchTerm | N/A | Free Text |
Object class: ListOfProblemListObjectsContainer
| Parameter | Property | Value Accepted | Notes |
|---|---|---|---|
| ListOfProblemListObjectsContainer | ProblemsToRecord | Dictionary Code | |
| SkipDuplicateProblems | Boolean (true/false) | If set to true, duplicate problem codes will be skipped when filing. | |
| ProblemList | WEBSVC.ListOfProblemListObjects | This property is itself an Object -- see below for its properties |
Object class: ListOfProblemListObjects
| Parameter | Property | Value Accepted | Notes |
|---|---|---|---|
| ListOfProblemListObjects | N/A | List of WEBSVC.ProblemListObject | This property is itself an Object -- see below for its properties |
Object class: ProblemListObject
| Parameter | Property | Value Accepted | Notes |
|---|---|---|---|
| ProblemListObject | UniqueId | Avatar Problem ID | |
| ProblemCode | WEBSVC.ProblemCodeObject | This property is itself an Object -- see below for its properties | |
| SystemNotes | Scrolling Free Text | ||
| Other | Dictionary Code | From CWS File, data element 16221 | |
| Type | Dictionary Code | From CWS File, data element 16211 | |
| DateIdentified | Date | ||
| DateOfOnset | Date | ||
| TimeOfOnset | Time | ||
| DateResolved | Date | ||
| Status | Dictionary Code | From CWS File, data element 16214 | |
| Severity | Dictionary Code | From CWS File, data element 16215 | |
| Chronicity | Dictionary Code | From CWS File, data element 16216 | |
| Action | Dictionary Code | From CWS File, data element 16219 | |
| Comment | Scrolling Free Text | ||
| GAINICP | Boolean |
Object class: ListOfProblemCodeObjects
| Parameter | Property | Value Accepted | Notes |
|---|---|---|---|
| ListOfProblemCodeObjects | N/A | List of WEBSVC.ProblemCodeObject | This property is itself an Object -- see below for its properties |
Object class: ProblemCodeObject
| Parameter | Property | Value Accepted | Notes |
|---|---|---|---|
| ProblemCodeObject | IMOCacheCode | Avatar IMO Results ID | |
| InternalHash | Free Text | ||
| IMOCode | Free Text | ||
| IMODesc | Free Text | ||
| LastUpdated | Date | ||
| SNOMEDCode | Free Text | ||
| SNOMEDDesc | Free Text | ||
| ICD10Code | Free Text | ||
| ICD10Desc | Free Text | ||
| ICD9Code | Free Text | ||
| ICD9Desc | Free Text | ||
| DSM4Code | Free Text | ||
| DSM4Desc | Free Text | ||
| DSM5Code | Free Text | ||
| DSM5Desc | Free Text | ||
| NTSTTableId | Free Text |
