Data flows into Watershed from all kinds of places. Whenever we’re involved, we make sure that data sources send complete, accurate and clear data, but we don’t always have that kind of control. xAPI courses published without following our best practice guidelines, translated data from SCORM, and apps with poorly designed tracking, can all result in data which is missing important information.
Watershed’s Activity Editor allows you to overwrite the Activity Definition portion of xAPI statements as they are represented in Watershed reports. This means, for example, that you can change the name, description and other data about an e-learning course, slide or question that’s been badly named. You can also use it to update definitions if you need to over time. This guide explains how in three sections:
This section explains some of the technical background of how the Activity Editor works. Feel free to skip to the next section if you’d prefer to just dive in and get started!
Data comes into Watershed in the form of xAPI interaction statements. These statements describe interactions with the structure ‘I did this’, or ‘actor verb object’; ‘Andrew completed an e-learning course’, ‘Brooks achieved a competency’, etc. The object part of these statements contains definition information about that object such as a name, description and type.
Learning Record Stores (LRSs) like Watershed store those definitions as part of xAPI statements, but they also store a ‘canonical definition’ for each unique object id. Different statements can have different definitions of an object due to an update or a bug but Watershed only displays the most to up to date definition in its reports.
If you don’t use the Activity Editor, then Watershed’s canonical definition will be based on the most recent statement received for each object. The Activity Editor enables you to take control of that process and set a correct definition that will not be overwritten by later incoming statements. It’s even possible to transmit these canonical definitions between LRSs because the Activity Editor creates an xAPI statement with a special extension each time a definition is updated.
Editing an Activity Definition
Access the Activity Editor by selecting the Activities then Edit Activities from the Data menu
Search for the name of the activity you want to edit and click the result you’re looking for. Edit the name and description then hit Save and you’re done!
The activity will now appear on your list of Recently Edited Activities so you can quickly re-edit if you made an error.
Please note: saving changes to this activity will change it everywhere it appears in Watershed. Reports are cached for performance and can take up to several hours to reflect updated definitions.
If you need to edit more than the name and description, advanced users can access and edit the full xAPI Activity Definition JSON by clicking on the Advanced tab. This editor allows you to add, remove and edit properties of the definition, within the requirements of the xAPI specification.
Please ask us if you need help with this.