There are different approaches available for integration for data input and output as follows:
Data Input to LRW
- ▪ Managed Integration: via Jisc's tools, including UDDSync, uXAPI and VLE plugins.
- ▪ Direct integration: via the Learning Records Warehouse APIs
Data Output from LRW:
- ▪ Direct integration: via Learning Records Warehouse APIs
- ▪ Simplified integration: via Data Explorer APIs
Data Input to LRW
Data Input: Managed Integration:
This is the preferred approach to data integration, and has slightly different approaches for UDD and xAPI data.
Data Input: Managed Integration: UDD Data
The institution provides UDD data in JSON format to Jisc's secure servers on daily basis, and Jisc synchronise this to the LRW.
Data Input: Managed Integration : xAPI Data
Jisc provides two sets of tools for pushing xAPI data to the LRW
- ▪ VLE Plugins
- ▪ Universal xAPI translator
VLE plugins are currently available for Moodle and Blackboard. Canvas and Google Classrooms are currently being developed.
Universal xAPI translator allows data to be provided in text format (TSV) via SFTP, where the Jisc Universal xAPI Translator will convert the data to xAPI.The translator currently covers:
- ▪ Attendance DataThe follow formats are under development:
- ▪ Library Data
- ▪ Intervention Data
Data Input: Direct Integration
Data Input: Direct Integration: UDD Data
Institutions and suppliers can also integrate directly with LRW, via it's RESTful API. If institutions take this route then they take responsibility for data integrity. If this is handled by a supplier then a maintenance contract for the integration should be considered.
Data Input: Direct Integration: xAPI Data
Suppliers and Institutions can also write xAPI data direct to LRW.
All data should confirm to Jisc xAPI standards. Institutions and suppliers are welcome to propose new recipes and templates, and can send to the LRW as development versions as long as core elements confirm to Jisc vocabulary.
Data Output from LRW
Data Output: Direct Integration:
Data can be read from LRW using RESTful APIs. Currently this is direct to the LRW, although in future managed integration via Jisc' DataExplorer API will provide simplified integration.
Data Output: Direct Integration: UDD Data
Jisc provides a Restful API for reading UDD data.
Data Output: Direct Integration: xAPI Data
LRW supports two methods for reading data:
- ▪ xAPI
- ▪ Aggregation based queries
Aggregation based queries are the recommended approach, as this approach provides far more flexibility and power than xAPI query.
Linking UDD data and xAPI
Applications will typically want to link UDD data to xAPI. For example, and application may wish to find a given students modules, which is held in UDD, and then query to find their activity on those modules. This is a three step process, with fields being provides to link UDD data to VLE data.
Step 1 : Query the Student on a Module Instance element to find the modules a student is on.
Step 2 : Query the ModuleVLEMap to find the vle module Id's
Step 3 : Query xAPI using context.extensions.http://xapi.jisc.ac.uk/courseArea.http://xapi.jisc.ac.uk/vlemodid to match the module instance to VLE statements.