Doctorlink has joined HealthHerohealthheroLearn More
doctorlink

Question summary

The question summary endpoint (ReDoc) allows you to get a full list of questions the user has seen on their journey through the product. This will exclude questions that were Preanswered by injecting history.

curl ".../{tenantId}/Traversals/{traversalId}/questions" \
  -X "GET" \
  -H "Authorization: Bearer ACCESS_TOKEN" \

Using this data packet you can allow users to revisit questions they've seen, and re-answer them, with the exception of nodes that specifically request you not to allow it in the response's previousDisabled property. Once you've received a node with previousDisabled: true you should not allow the user to go back to any previous questions.

The summary could look something like this:

question-summary.png

This actionable summary was made using the below sample code. This sample contains all the seen questions and all the answers, including non-selected answers. This is because you may want to show the negatives (the answers not selected) as well the positives (the answers selected).

[
  {
    algoId: 2,
    nodeId: 163,
    assetId: 70,
    groupId: 200157,
    displayText: "Gender:",
    summaryText: "Gender",
    clinicalText: "Gender",
    nodeTypeId: 34,
    nodeType: "GenderCheck",
    state: "Permanent",
    answers: [
      {
        id: "8cd74ac9-77b8-4d5c-ab3b-a017a71b5cc6",
        traversalId: "34dd96f3-9fd7-4514-8587-1039de86039a",
        algoId: 2,
        groupId: 200157,
        nodeId: 163,
        assetId: 70,
        nodeTypeId: 34,
        nodeType: "GenderCheck",
        answerId: 88,
        nextNodeId: 160,
        value: null,
        counter: 0.0,
        previousCounter: 0.0,
        createdDateTime: "2020-07-16T14:24:57.0767514Z",
        displayText: "Male",
        summaryText: "Male",
        clinicalText: "Male",
        isAnswered: true,
      },
      {
        id: "1fdc4119-c007-4c16-98cc-e7076cb9e80d",
        traversalId: "34dd96f3-9fd7-4514-8587-1039de86039a",
        algoId: 2,
        groupId: 200157,
        nodeId: 163,
        assetId: 70,
        nodeTypeId: 34,
        nodeType: "GenderCheck",
        answerId: 89,
        nextNodeId: 160,
        value: null,
        counter: 0.0,
        previousCounter: 0.0,
        createdDateTime: "2020-07-16T14:24:57.0767514Z",
        displayText: "Female",
        summaryText: "Female",
        clinicalText: "Female",
        isAnswered: false,
      },
    ],
  },
  {
    algoId: 2,
    nodeId: 160,
    assetId: 19063,
    groupId: 200157,
    displayText: "Enter the patient's date of birth",
    summaryText: "Enter your date of birth",
    clinicalText: "Enter your date of birth",
    nodeTypeId: 35,
    nodeType: "AgeCheck",
    state: "Permanent",
    answers: [
      {
        id: "6efb2494-a1b5-46f1-9fe8-4781710be170",
        traversalId: "34dd96f3-9fd7-4514-8587-1039de86039a",
        algoId: 2,
        groupId: 200157,
        nodeId: 160,
        assetId: 19063,
        nodeTypeId: 35,
        nodeType: "AgeCheck",
        answerId: 19225,
        nextNodeId: 1000160,
        value: "1980-01-01",
        counter: 0.0,
        previousCounter: 0.0,
        createdDateTime: "2020-07-16T14:24:57.0767514Z",
        displayText: "DOB (dd/mm/yyyy).",
        summaryText: "*",
        clinicalText: "Age enter",
        isAnswered: true,
      },
    ],
  },
  {
    algoId: 2,
    nodeId: 2,
    assetId: 3200,
    groupId: 0,
    displayText: "What kind of health assessment would you like to complete?",
    summaryText: "",
    clinicalText: "Health assessment choice",
    nodeTypeId: 32,
    nodeType: "Exclusive",
    state: "Transient",
    answers: [
      {
        id: "4c12e16e-9058-46fc-90ed-55e6621c910e",
        traversalId: "34dd96f3-9fd7-4514-8587-1039de86039a",
        algoId: 2,
        groupId: 0,
        nodeId: 2,
        assetId: 3200,
        nodeTypeId: 32,
        nodeType: "Exclusive",
        answerId: 3810,
        nextNodeId: 42,
        value: null,
        counter: 0.0,
        previousCounter: 0.0,
        createdDateTime: "2020-07-16T14:25:06.6942046Z",
        displayText: "Full health risk and well-being assessment",
        summaryText: "Full health risk and well-being assessment",
        clinicalText: "Full health risk and well-being assessment",
        isAnswered: true,
      },
      {
        id: "fb37ff59-bda0-48b4-b053-473f5f65e498",
        traversalId: "34dd96f3-9fd7-4514-8587-1039de86039a",
        algoId: 2,
        groupId: 0,
        nodeId: 2,
        assetId: 3200,
        nodeTypeId: 32,
        nodeType: "Exclusive",
        answerId: 3813,
        nextNodeId: 8,
        value: null,
        counter: 0.0,
        previousCounter: 0.0,
        createdDateTime: "2020-07-16T14:25:06.6942046Z",
        displayText: "A specific well-being assessment",
        summaryText: "A specific well-being assessment",
        clinicalText: "A specific well-being assessment",
        isAnswered: false,
      },
      {
        id: "c0c12f4c-b5dc-46b6-b296-71a0e6dabab3",
        traversalId: "34dd96f3-9fd7-4514-8587-1039de86039a",
        algoId: 2,
        groupId: 0,
        nodeId: 2,
        assetId: 3200,
        nodeTypeId: 32,
        nodeType: "Exclusive",
        answerId: 3814,
        nextNodeId: 23,
        value: null,
        counter: 0.0,
        previousCounter: 0.0,
        createdDateTime: "2020-07-16T14:25:06.6942046Z",
        displayText: "A specific health risk assessment",
        summaryText: "A specific health risk assessment",
        clinicalText: "A specific health risk assessment",
        isAnswered: false,
      },
    ],
  },
  {
    algoId: 3865,
    nodeId: 343,
    assetId: 1508,
    groupId: 0,
    displayText:
      "In general, compared to other people your age, would you say your health is:",
    summaryText:
      "Compared to others of the same age, self-perceived health status is rated as",
    clinicalText:
      "Self-perceived health status compared to others the same age",
    nodeTypeId: 32,
    nodeType: "Exclusive",
    state: "Transient",
    answers: [
      {
        id: "62941f49-838d-4b20-9144-a15b20d2b631",
        traversalId: "34dd96f3-9fd7-4514-8587-1039de86039a",
        algoId: 3865,
        groupId: 0,
        nodeId: 343,
        assetId: 1508,
        nodeTypeId: 32,
        nodeType: "Exclusive",
        answerId: 4934,
        nextNodeId: 1598,
        value: null,
        counter: 0.0,
        previousCounter: 0.0,
        createdDateTime: "2020-07-16T14:25:10.2772843Z",
        displayText: "Excellent",
        summaryText: "Excellent",
        clinicalText: "Excellent",
        isAnswered: false,
      },
      {
        id: "2c2f712c-7587-4618-8fc3-22e85ef706de",
        traversalId: "34dd96f3-9fd7-4514-8587-1039de86039a",
        algoId: 3865,
        groupId: 0,
        nodeId: 343,
        assetId: 1508,
        nodeTypeId: 32,
        nodeType: "Exclusive",
        answerId: 10553,
        nextNodeId: 1598,
        value: null,
        counter: 0.0,
        previousCounter: 0.0,
        createdDateTime: "2020-07-16T14:25:10.2772843Z",
        displayText: "Very good",
        summaryText: "Very good",
        clinicalText: "Very Good",
        isAnswered: false,
      },
      {
        id: "9f24f86f-d168-42f9-96b2-92994aebc170",
        traversalId: "34dd96f3-9fd7-4514-8587-1039de86039a",
        algoId: 3865,
        groupId: 0,
        nodeId: 343,
        assetId: 1508,
        nodeTypeId: 32,
        nodeType: "Exclusive",
        answerId: 10554,
        nextNodeId: 1598,
        value: null,
        counter: 0.0,
        previousCounter: 0.0,
        createdDateTime: "2020-07-16T14:25:10.2772843Z",
        displayText: "Good",
        summaryText: "Good",
        clinicalText: "Good",
        isAnswered: true,
      },
      {
        id: "76253b66-35fe-44c2-8937-f66f7a70e474",
        traversalId: "34dd96f3-9fd7-4514-8587-1039de86039a",
        algoId: 3865,
        groupId: 0,
        nodeId: 343,
        assetId: 1508,
        nodeTypeId: 32,
        nodeType: "Exclusive",
        answerId: 10555,
        nextNodeId: 1598,
        value: null,
        counter: 0.0,
        previousCounter: 0.0,
        createdDateTime: "2020-07-16T14:25:10.2772843Z",
        displayText: "Fair",
        summaryText: "Fair",
        clinicalText: "Fair",
        isAnswered: false,
      },
      {
        id: "9d512f6d-7f5e-4c62-a3e4-75e895b9ca17",
        traversalId: "34dd96f3-9fd7-4514-8587-1039de86039a",
        algoId: 3865,
        groupId: 0,
        nodeId: 343,
        assetId: 1508,
        nodeTypeId: 32,
        nodeType: "Exclusive",
        answerId: 10556,
        nextNodeId: 1598,
        value: null,
        counter: 0.0,
        previousCounter: 0.0,
        createdDateTime: "2020-07-16T14:25:10.2772843Z",
        displayText: "Poor",
        summaryText: "Poor",
        clinicalText: "Poor",
        isAnswered: false,
      },
    ],
  },
];