ePortfolio Template Usage Methods

The Digication API can be used by schools to obtain periodic usage statistics for the ePortfolio templates they have enabled for their users.  The available fields include counts of individual actions taken by each user, and tracking user activity over time can be a powerful tool for studying how the use of ePortfolios in the classroom impacts student participation and progress.

School wide templates can be configured by going to Administration > ePortfolios > Templates.  Contact support@digication.com to obtain the unique identifiers for the templates you would like to begin tracking.

The basic protocol and format of the Digication API are documented here: https://support.digication.com/entries/20887273-API-Basics

Available Methods

ePortfolio Template Methods

Method: portfolio.stats_by_template - List users who have created portfolios from a specific template, and information about the user's engagement.

Parameters:templateid - the id of the template

Returns:result[n].otherid - the syncid of the userresult[n].portfolios - the number of portfolios this user created from the template specifiedresult[n].hits - the total number of hits for the user's portfoliosresult[n].comments - the total number of comments received on the user's portfoliosresult[n].pages - the total number of pages in the user's portfoliosresult[n].modules - the total number of modules in the user's portfoliosresult[n].files - the total number of files uploaded by the userresult[n].logins - the total number of times the user has logged inresult[n].pagescreated - the total number of pages created by the user (in any portfolios)

Method: portfolio.settings_by_template - List users who have created portfolios from a specific template, and information about those portfolios.

Parameters:templateid - the id of the template

Returns:result[n].otherid - the syncid of the userresult[n].portfolios - the number of portfolios this user created from the template specifiedresult[n].customcss - the number of portfolios that have custom cssresult[n].shared - the number of portfolios that have more than one editorresult[n].public - the number of portfolios that are publicresult[n].schoolprivate - the number of portfolios that are private to the schoolresult[n].private - the number of portfolios that are private

Method: portfolio.modules_by_template - List users who have created portfolios from a specific template, and information about the modules within those portfolios.

Parameters:templateid - the id of the template

Returns:result[n].otherid - the syncid of the userresult[n].portfolios - the number of portfolios this user created from the template specifiedresult[n].modules[type] - the number of modules of this type in the user's portfoliosresult[n].galleryslides - the number of slides in galleries in the user's portfolios

Course Methods

Method: submissions.stats_by_course - List users in a specific course and information about the user's engagement.

Parameters:otherid - the syncid of the course

Returns:result[n].otherid - the syncid of the userresult[n].submitted - the number of completed evidence steps in the course for this userresult[n].text - the number of completed evidence steps with text for this userresult[n].files - the number of files attached to completed evidence steps for this userresult[n].portfolios - the number of portfolios attached to completed evidence steps for this user

Method: course.listusers - List users in a specific course and information about the users.

Parameters:otherid - the syncid of the course

Returns:result.users[userid].userid - the internal id of the userresult.users[userid].firstname - the firstname of the userresult.users[userid].lastname - the lastname of the userresult.users[userid].username - the username of the userresult.users[userid].otherid - the syncid of the userresult.users[userid].notify_email - the email of the userresult.users[userid].facultyf - 0 or 1 if the user is faculty

Have more questions? Submit a request

0 Comments

Please sign in to leave a comment.