Questionnaires data

Client questionnaires can be manually run by care teams and a client's Completed questionnaires can be sent and received between Watson Care Manager and third-party applications (through the Questionnaires API).

Common patterns for questionnaires data

By sending questionnaires between Watson Care Manager and third-party applications, the latest version of the client's questionnaire information becomes available in all applications so that care teams do not need to manually record it. Watson Care Manager sends and receives questionnaires for active and inactive clients. Watson Care Manager does not send or receive a client's in progress questionnaires or questionnaires for deleted clients.

Note: Before Watson Care Manager can send and receive client questionnaire data from third-party applications, the questionnaire must be configured, activated, and associated with one or more programs. Questionnaires that are received from other applications are applied to a client's record only if each questionnaire is associated with a program and the client is associated with that program. Then, your administrator must share the questionnaire by completing the tasks in Sharing questionnaires with external systems.

Completed questionnaires that are sent to Watson Care Manager through the API can optionally be associated with a program. Assuming the client is associated with that program, care teams can run new instances of the questionnaires and repeat those questionnaires.

Table 1. Questionnaire behavior when associated with a program
Is the received questionnaire associated with program? Questionnaire behavior
Yes Watson Care Manager matches the program external system reference (ESR) that is sent via the API with a configured program and checks if the client is associated with the program.
  • If the program ESR does not match a configured program, Watson Care Manager does not receive the questionnaire.
  • If the program ESR matches a configured program and the client is associated with the program, Watson Care Manager completes or repeats the questionnaire in the context of each program. Note: The program must be in the Assigned, Enrolled, or Pending status.
  • If the program ESR matches a configured program, but the client is not associated with the program in Watson Care Manager, Watson Care Manager does not receive the questionnaire.
No
  • Watson Care Manager checks if the client has one or more programs that are already associated with the questionnaire in the application. Depending on the program status (Assigned, Enrolled, or Pending), Watson Care Manager completes or repeats the received questionnaire for the most recent program.
  • If the client has no programs to associate the questionnaire with, Watson Care Manager does not receive questionnaire.

If a received questionnaire already exists for the client in Watson Care Manager, Watson Care Manager repeats the existing questionnaire when received through the API. Watson Care Manager appends the repeated questionnaire to the original questionnaire. If no questionnaire exists for the client, Watson Care Manager adds the new questionnaire.

If an in progress questionnaire of the same type already exists, Watson Care Manager adds the new questionnaire and the in progress questionnaire remains unaffected.

When Watson Care Manager receives a questionnaire, any care plan activities, tasks, and suggestions that are configured for the questionnaire are automatically added and linked to the most recently updated program. In addition, when received from an external application, historical versions of questionnaires are displayed in Watson Care Manager based on the Display History in Program (Days) setting that is configured for the questionnaire by your Administrator.

To see the questionnaire data that is sent from Watson Care Manager to third-party applications for a configured questionnaire through the Questionnaires API, your Administrator must download its API document by Sharing the API document for a questionnaire.

Questionnaire data view

You can view a client's questionnaire from their Summary view.
  1. Click Programs > Programs > <program name>. You see the contents of the program. Related questionnaires are grouped into modules.
  2. Click a module, then click the name of a questionnaire to display it on page.
  3. Click Details to see the full details of the questionnaire.
The table lists the data that displays for a questionnaire record.
Data Mandatory When manually created When received from integrated systems
Questionnaire name Yes Displays the name of the questionnaire. As per manually created records. The third-party application identifies the questionnaire name by its external system reference.
Assessed Not applicable This data is automatically populated by Watson Care Manager

Displays the date and time that the questionnaire was started or completed.

 Displays the date and time that the questionnaire was completed in the third-party application, and the name or username of the person who completed the questionnaire (as received via the API).
Started Not applicable This field is automatically populated by Watson Care Manager.

Displays the date and time that the questionnaire was started and the name of the user who started the questionnaire.

 Displays the date and time that the questionnaire was completed in the third-party application, and the name or username of the person who completed the questionnaire (as received via the API).
Completed Not applicable This field is automatically populated by Watson Care Manager.

Displays the date and time that the questionnaire was completed and the name of the user who completed the questionnaire.

Note: If the questionnaire is in progress, no value displays.

 Displays the date and time that the questionnaire was completed in the third-party application, and the name or username of the person who completed the questionnaire (as received via the API).
Description Not applicable This field is automatically populated by Watson Care Manager Displays a description of the questionnaire (if configured in Administration). As per manually created.
Original Source System No Displays the original source system where the questionnaire originated that was selected from the preconfigured list of original source systems. Displays the original source system where the questionnaire originated. The third-party application identifies the source system by its external system reference.
Source Yes Displays the source of the questionnaire that was selected from the preconfigured list of sources. Displays the source of the questionnaire that was received from the third-party application. The third-party application identifies the source by its external system reference.
Question Yes Displays a question asked in the questionnaire. As per manually created.
Answer Yes Displays the client's answer to the question asked. As per manually created.