Reviews and Reflections

Review activities

Variants: PeerReview, InstructorReview, SelfReview

Rubrics: What makes a review?

A review activity consists of a rubric. Rubrics are a list of questions, some of which are scorable (Scale, Boolean questions) and others which are purely qualitative (Text questions)

An instructor will customize a rubric before students start reviewing (as editing will be locked after students begin reviewing)

If you want to have a score calculation, ensure that you have Scale and Boolean questions set, if there's only text questions in your rubric, scores will be empty.

API Example

Reviews are available via a pageable GraphQL Connection:

Paginating queries

Query

{
  activity(id: "ae8f3183-0fd0-48e1-b52d-2f455cd78db7") {
    ... on PeerReviewActivity {
      title
      reviews(first: 2) {
        edges {
          node {
            id
            reviewType
            createdAt
            receivers {
              name
              email
            }
            givers {
              name
              email
            }
            answers {
              textAnswer
              scaleAnswer
              scaleAnswerPercentage
              question {
                questionType
                htmlText
                negativeAnswerText
                positiveAnswerText
                isOptional
                minNumWords
              }
            }
          }
        }
      }
    }
  }
}

Response

{
  "data": {
    "activity": {
      "title": "Spot-check and team build",
      "reviews": {
        "edges": [
          {
            "node": {
              "id": "44888cf6-31da-49e2-a707-318e0d36a4bf",
              "reviewType": "PeerReview",
              "createdAt": "2021-02-08T17:40:06.629884",
              "receivers": [
                {
                  "name": "Ryan Howard",
                  "email": "[email protected]"
                }
              ],
              "givers": [
                {
                  "name": "Pam Beesley",
                  "email": "[email protected]"
                }
              ],
              "answers": [
                {
                  "textAnswer": "Some awesome answer for question \"Question of type Text\" (530ac85d-4729-490b-8ac5-9ca263bbebd1) Skill debate couple society fear war myself decade reality whether east similar here action system I those form ahead kind attorney former fund today who politics to too several lay region fund center perhaps month green college him exactly drive support eat order moment white single nature more responsibility throughout stop whether after hope suddenly they indeed free out employee because others positive song trip pick remember executive a south story spring magazine unit my enjoy where responsibility forget agreement support head represent whom country old instead environmental plan professional choose can prepare television allow billion bar senior mean.",
                  "scaleAnswer": null,
                  "scaleAnswerPercentage": null,
                  "question": {
                    "questionType": "Text",
                    "htmlText": "Question of type Text",
                    "negativeAnswerText": null,
                    "positiveAnswerText": null,
                    "isOptional": true,
                    "minNumWords": 6
                  }
                },
                {
                  "textAnswer": null,
                  "scaleAnswer": 4,
                  "scaleAnswerPercentage": 100,
                  "question": {
                    "questionType": "Scale",
                    "htmlText": "Question of type Scale",
                    "negativeAnswerText": null,
                    "positiveAnswerText": null,
                    "isOptional": false,
                    "minNumWords": null
                  }
                },
                {
                  "textAnswer": null,
                  "scaleAnswer": null,
                  "scaleAnswerPercentage": null,
                  "question": {
                    "questionType": "Boolean",
                    "htmlText": "Question of type Boolean",
                    "negativeAnswerText": "Nay",
                    "positiveAnswerText": "Yay",
                    "isOptional": false,
                    "minNumWords": null
                  }
                }
              ]
            }
          },
          {
            "node": {
              "id": "bc151c68-45a3-466e-aeb9-8695713148b1",
              "reviewType": "PeerReview",
              "createdAt": "2021-02-08T17:40:06.670883",
              "receivers": [
                {
                  "name": "Karen Filipelli",
                  "email": "[email protected]"
                }
              ],
              "givers": [
                {
                  "name": "Pam Beesley",
                  "email": "[email protected]"
                }
              ],
              "answers": [
                {
                  "textAnswer": "Some awesome answer for question \"Question of type Text\" (530ac85d-4729-490b-8ac5-9ca263bbebd1) In five sing yet alone issue shake stuff vote during far until into five behind full white suddenly big white produce full trouble short various and my save eight manage service medical lead eat nice audience manage they return building pattern green international follow a our pass amount stage pick traditional music different other view area child add south account teach participant necessary four perhaps training sea remain feeling minute assume success make myself where couple reality ball part growth politics suddenly cause people ago together draw audience future evening stock general how career provide improve word simple two whose wide challenge test though shoulder policy gas food firm security majority person traditional half rate soldier her seek hit Mrs.",
                  "scaleAnswer": null,
                  "scaleAnswerPercentage": null,
                  "question": {
                    "questionType": "Text",
                    "htmlText": "Question of type Text",
                    "negativeAnswerText": null,
                    "positiveAnswerText": null,
                    "isOptional": true,
                    "minNumWords": 6
                  }
                },
                {
                  "textAnswer": null,
                  "scaleAnswer": 3,
                  "scaleAnswerPercentage": 75,
                  "question": {
                    "questionType": "Scale",
                    "htmlText": "Question of type Scale",
                    "negativeAnswerText": null,
                    "positiveAnswerText": null,
                    "isOptional": false,
                    "minNumWords": null
                  }
                },
                {
                  "textAnswer": null,
                  "scaleAnswer": null,
                  "scaleAnswerPercentage": null,
                  "question": {
                    "questionType": "Boolean",
                    "htmlText": "Question of type Boolean",
                    "negativeAnswerText": "Nay",
                    "positiveAnswerText": "Yay",
                    "isOptional": false,
                    "minNumWords": null
                  }
                }
              ]
            }
          }
        ]
      }
    }
  }
}

Feedback Reflections

Peergrade user? These are the Eduflow counterpart for Reactions

These are responses to reviews. They have a similar internal structure to reviews, since they're both answers submitted against questions in a rubric.

API Example

The same as Review activities, except using reflections (FeedbackReflectionConnection) instead of reviews:

Query

{
  activity(id: "b59a7ae2-eeac-45ae-99b2-898f201c0955") {
    ... on FeedbackReflectionActivity {
      title
      reflections(first: 2) {
        edges {
          node {
            id
            reviewType
            createdAt
            receivers {
              name
              email
            }
            givers {
              name
              email
            }
            answers {
              textAnswer
              scaleAnswer
              scaleAnswerPercentage
              question {
                questionType
                htmlText
                negativeAnswerText
                positiveAnswerText
                isOptional
                minNumWords
              }
            }
          }
        }
      }
    }
  }
}

Response

{
  "data": {
    "activity": {
      "title": "Introspect and reflect",
      "reflections": {
        "edges": [
          {
            "node": {
              "id": "d521373e-c36b-40f3-bdbd-e6f2b85e5927",
              "reviewType": "FeedbackReflection",
              "createdAt": "2021-02-08T17:40:08.877703",
              "receivers": [
                {
                  "name": "Pam Beesley",
                  "email": "[email protected]"
                }
              ],
              "givers": [
                {
                  "name": "Phyllis Vance",
                  "email": "[email protected]"
                },
                {
                  "name": "Andy Bernard",
                  "email": "[email protected]"
                },
                {
                  "name": "Meredith Palmer",
                  "email": "[email protected]"
                },
                {
                  "name": "Karen Filipelli",
                  "email": "[email protected]"
                },
                {
                  "name": "Creed Bratton",
                  "email": "[email protected]"
                },
                {
                  "name": "Jim Halpert",
                  "email": "[email protected]"
                },
                {
                  "name": "Ryan Howard",
                  "email": "[email protected]"
                },
                {
                  "name": "Erin Hannon",
                  "email": "[email protected]"
                },
                {
                  "name": "Oscar Martinez",
                  "email": "[email protected]"
                },
                {
                  "name": "Kelly Kapoor",
                  "email": "[email protected]"
                },
                {
                  "name": "Kevin Mallone",
                  "email": "[email protected]"
                },
                {
                  "name": "Stanley Hudson",
                  "email": "[email protected]"
                },
                {
                  "name": "Toby Flenderson",
                  "email": "[email protected]"
                },
                {
                  "name": "Angela Martin",
                  "email": "[email protected]"
                },
                {
                  "name": "Pam Beesley",
                  "email": "[email protected]"
                }
              ],
              "answers": []
            }
          },
          {
            "node": {
              "id": "4c3d4d7c-205c-4f55-8fc1-c138576c2929",
              "reviewType": "FeedbackReflection",
              "createdAt": "2021-02-08T17:40:08.894052",
              "receivers": [
                {
                  "name": "Pam Beesley",
                  "email": "[email protected]"
                }
              ],
              "givers": [
                {
                  "name": "Karen Filipelli",
                  "email": "[email protected]"
                }
              ],
              "answers": [
                {
                  "textAnswer": "Some awesome answer for question \"What did you learn from the feedback you received?\" (2f7c267b-209a-49a3-8368-1a4dffe03050) Song none now author know sit growth experience left care leave much parent grow might various assume debate listen heavy table perhaps table probably drug weight tree strategy study respond rule throw set new least space last personal fine since at because evidence increase song memory buy will out mother more treat or machine section manage air by police identify Mr remember something compare order himself wrong political on animal would event pretty teach yourself put check his admit space start company conference let fill lay center chance space information carry Congress usually never politics his edge old author person sing bill political civil professor who yourself option among chair culture factor recent out about summer involve ago anything course every just nothing spend notice stop tax speak reason mention her team catch radio think administration.",
                  "scaleAnswer": null,
                  "scaleAnswerPercentage": null,
                  "question": {
                    "questionType": "Text",
                    "htmlText": "What did you learn from the feedback you received?",
                    "negativeAnswerText": null,
                    "positiveAnswerText": null,
                    "isOptional": false,
                    "minNumWords": 1
                  }
                },
                {
                  "textAnswer": "Some awesome answer for question \"How do you plan on using that feedback to improve?\" (4a02627a-c77a-4801-87ab-0fc8a9b00330) Forward happen season floor market kid follow prove describe late method yes return policy particular off need out last happen great foreign student section recently real wide key seven house her hand fine let tree myself worry then garden Congress maintain first quite data building style leader at nearly well continue free upon from dark sport authority follow drive step serious keep discussion huge something back start east first perform guy moment garden student her ready sure feel little deal develop industry run cell prepare much run thought watch four personal face prove two your class later.",
                  "scaleAnswer": null,
                  "scaleAnswerPercentage": null,
                  "question": {
                    "questionType": "Text",
                    "htmlText": "How do you plan on using that feedback to improve?",
                    "negativeAnswerText": null,
                    "positiveAnswerText": null,
                    "isOptional": false,
                    "minNumWords": 1
                  }
                },
                {
                  "textAnswer": null,
                  "scaleAnswer": 2,
                  "scaleAnswerPercentage": 50,
                  "question": {
                    "questionType": "Scale",
                    "htmlText": "How useful is the feedback?",
                    "negativeAnswerText": null,
                    "positiveAnswerText": null,
                    "isOptional": false,
                    "minNumWords": null
                  }
                }
              ]
            }
          }
        ]
      }
    }
  }
}