Skip to main content

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:

  1. AddClientProblems
  2. GetClientProblemList
  3. GetDictionaryItems
  4. 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