How to Send Student Activity Data in CSV to Woolf

Colleges can report verified academic activity by submitting structured CSV files to Woolf. These files are used to record student submissions, grades, feedback, meeting participation, and general learning activity. This guide outlines the correct formats for each type of data, with downloadable templates to help you get started.

⚠️ Important Notes:

• Submissions using CSVs are not related to the primary workflow and should only be used in exceptional cases. It is not a valid alternative for standard activity syncing.

• Sometimes there is evidence not captured by Woolf’s SDK. In such cases, Woolf may evaluate it for inclusion in a student’s academic record (back accreditation since it is not real-time).

• Woolf does not guarantee accreditation of CSV learning. We will evaluate and say how much can potentially be included in the accreditation record.

• All CSV imports require a valid SOW contract.

• CSV imports must be completed within 60 days of kickoff. After 60 days, accreditation by CSV is not allowed (partial enrollments are required).

• Back accreditation by CSV can only be applied to a maximum of 50% of a student’s degree progress.

• Woolf only supports CSV imports for three activity types: assignment submissions (regular assignments only, not summative), grades, and meeting attendance (only if there is a recording).

• For assignment submissions, the Woolf can only accept evidence containing either the actual submission content (HTML/Markdown) or meaningful files that can be stored on the AMS.

• Meeting attendance requires evidence. A recording must be attached to the resource (via Airlock API or CSV import). Do not include unrecorded meetings.

• Before submitting, ensure that all students and resources referenced in the CSV exist in Woolf. The resource_id and student_id must match Woolf’s system to allow successful processing.

• Submit one file per activity type via Slack or email. Do not combine different activity types in a single CSV.

How to Send CSV Data to Woolf

1. Create resources in Woolf. The resource_id generated will be used in the CSV. (API Docs)

2. Add students as StudyTrack students in Woolf. The student_id generated will be used in the CSV. (API Docs)

3. Send CSV files via Slack or email. Each CSV should only contain one activity type.

📄 CSV Format for Student Submissions

Use this format to report assignment submissions. Include either written content or a file URL. Submissions must contain text/HTML/Markdown, or if a file-based submission, please notify Woolf in advance.

• resource_id

• student_id

• submission_text

• submission_content (alias for text/HTML/Markdown)

• submission_url

• assets (optional file attachments: PDF, video, audio)

• timestamp

📄 CSV Format for Grades

Use this format to record final or interim grades assigned to student work. Make sure grades are only submitted for resources where a submission exists, to avoid inconsistencies (grades without matching submissions).

• resource_id

• student_id

• grade (0–100)

• timestamp

• teacher_id (optional)

📄 CSV Format for Feedback

Use this format to provide instructor feedback on student submissions. Note: Feedback is not part of back accreditation imports, but may be logged for reference.

• resource_id

• student_id

• feedback_content

• feedback_url

• timestamp

• teacher_id (optional)

📄 CSV Format for Meeting Attendances

Use this format to record student attendance in scheduled meetings or live sessions. Only include meetings where a recording exists, as evidence must be provided and linked to the resource (e.g., via Airlock API).

• resource_id

• student_id

• timestamp

📄 CSV Format for Meeting Recordings

Use this format to submit URLs to meeting recordings for auditing or archival purposes. Note: Recording submissions are supportive evidence but not counted as part of back accreditation.

• resource_id

• recording_url

📄 CSV Format for General Resource Consumption

Use this format to log access to course materials, such as reading a document or watching a video. Note: These logs are not part of CSV back accreditation and are for tracking only.

• resource_id

• student_id

• timestamp

Column Reference

<html>
  <body><h1>My Bubble Sort Implementation</h1></body>
</html>

Related Links

• Resource Submission Guide

• Resources Basics

• How to Import Meeting Recordings and Attendance in CSV

• Resources Management in Canvas

• Submitting Degree Students for Graduation Approval

• Managing Meeting Resources