For Developers

Supported Functionality

Edlink's direct CSV upload functionality enables schools and systems to upload roster files directly through the Edlink dashboard. This document outlines the supported functionality, key features, and limitations of direct CSV uploads as a data source.

The CSV integration enables Edlink to generate roster data, including people, classes, and enrollments, from regular flat file uploads (even if the files do not conform to a data standard). Unlike other integrations, CSV does not interact with an API or platform, and therefore does not support features like coursework or grade syncing.

Single Sign-On (SSO)

If your files include emails and passwords, Edlink can enable Single Sign-On (SSO) functionality. This allows users to log in to connected platforms using the credentials provided in your flat files.

Rostering

Edlink processes uploaded CSV files to produce core rostering data:

  • Users: Includes teachers and students.
  • Classes: Course or class-level data.
  • Enrollments: Relationships between users and classes.

Extended Rostering

For more complex use cases, Edlink supports extended rostering, which includes data models like attendance, incidents, etc. These can be synced with the custom file format if present in your files.

File Formats

Edlink supports standard CSV file formats for roster uploads. To upload multiple files, they must be zipped together into a single archive before uploading to the dashboard. Please ensure all files in the archive are in CSV format and follow consistent naming conventions for easier processing.

Limitations

These are some limitations that are important to consider when planning your implementation.

No Coursework or Grade Syncing

Direct CSV uploads only support the production of roster data. Features such as assignment creation, coursework management, or grade synchronization are not supported.

Static Data

Roster data generated through CSV uploads is static and reflects the content of the uploaded files. Updates to rosters require uploading a new CSV file or archive.

Recommendations for Successful Implementation

  • File Formatting: Ensure files adhere to the expected format (e.g., CSV) to prevent processing errors.
  • Consistent Naming: Use consistent naming conventions for files, especially when zipping multiple files together.

If you have additional questions or require help setting up your direct CSV uploads, please contact Edlink support or your Customer Success Manager.