Public Method Reports API

getData()

Retrieves a specific portion of raw score data that is available to the report, based on a given set of user and tag filters.

This method retrieves the data asynchronously, and returns a promise that resolves with the data.

Important Only applicable to the item-scores-by-tag-by-user report.

Arguments

  • params object

    A collection of required and optional parameters for selecting and filtering the data to be retrieved.

    • column_tag_types array[TagsV2|TagSearchByType]

      The hierarchy of column tags within which to limit the retrieved data.

      There are a number of distinct ways in which to use this parameter:

      • Pass [] to retrieve the overall total scores across all content in the report.
      • Pass an array containing a single TagSearchByType object to retrieve a breakdown of scores for all tag names within that tag type.
      • Pass an array containing one or more TagV2 objects and where the final element is a TagSearchByType object to retrieve a score breakdown for all tag names located at that tag path.
      • Pass an array containing TagV2 objects to retrieve the overall score for all content at that specific tag path (this is a more specific variant of the format above. Use the format above to retrieve scores for all nodes within a tag type, or this format to retrieve just one specific node).
    • row_tag_types array[TagsV2|TagSearchByType]

      (Optional) The hierarchy of row tags within which to limit the retrieved data.

      This parameter behaves similarly to the column_tag_types parameter; see above for details of usage.

    • user_ids array[string]
      The list of user_id entries in the report for which to specifically retrieve data.

Return value

Value object

Properties

Type definitions

tagsV2 object

Tags are used to improve searching for content while authoring and for reporting and analytics purposes.

See Understanding Tag Formats for Content Creation and Filtering for more information.

  • name string

    The Tag name.

    Maximum length is 255 characters.

  • type string

    The Tag type.

    Maximum length is 255 characters.

TagSearchByType object

  • type string
  • description string
  • label string

ItemScoresByTagByUserData object

  • item_tags object
  • scores object
    • user_id string
    • item_tags array[TagsV2]
      An array of tags describing the path through the hierarchy that this score belongs to. This includes column and row tags. An empty array represents the overall total score for the given user.
    • score float
      Sum of scores that has been calculated for the given user and combination of item tags.
    • max_score_of_attempted float
      For all attempted responses by the given user within the given combination of item tags, this is the sum of the highest scores that can be awarded.
    • max_score_of_unmarked float
      For all unmarked responses by the given user within the given combination of item tags, this is the sum of the highest scores that can be awarded.
    • max_score float
      Sum of the highest scores that can be awarded for the given user and combination of item tags.

TagMetadata object

  • sort_key string
  • description string
Was this article helpful?