# Records of learning {% hint style="info" %} Records of learning require Business or Enterprise plans {% endhint %} All attempts done on Synap are stored against exams and users, and if you're using assignments there is a record of all the users progress and certifications on Synap. However some things are done off platform and with Synap's records of learning you can import and recreate these records and store them on Synap. **Examples of Record of learning use** * Storing person interview assessments scores * Additional qualifications * Importing previous attempts from another LMS / platform * Storing certifications and certificate files * Recreating qualifications which have expiry dates

### Navigating to the Records of learning table To find a user's Record of learning, select a user through a group and navigate to their **Overview** then under the management section go to their individual **Record of learning** page.

### Record fields There are 3 default fields when creating a record: * `Record name` which is required for every record * `Score` is not required but we do recommend inputting it where possible, stored as a percentage * `Record date` this is the date of the record activity, not the date you are creating the record on You can create your own additional custom record attributes which will show as additional columns on the record table.

Default fields and custom record attributes

Records of learning come with an additional `File` type attribute which can be used to attach files to a particular record row | Attribute type | Expected value on CSV | | --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Checkbox | `TRUE` or `FALSE` | | Long answer | `string` | | Short answer | `string` | | Multiple choice | One of defined `options` | | Checkboxes | defined `options` separated by commas | | Number | Any numerical value | | Date | `DD/MM/YYYY` | | Link | Choose whether to display as text or as a button. The link can be typed as an absolute URL (opens in new tab), or a root-relative URL (open in the same tab) | | File | Only `.pdf` files are accepted on platform or through the API. Files uploaded through the API are limited to 5mb each, or 10mb per request. | ### Custom Record of learning attributes To make custom record attributes to store extra information against your Records of learning go to **Settings** > **Data management** > **Attributes** > **Records of learning.** From here you can create new record attributes the same way as other attributes on platform

Creating new Record of learning attributes

{% content-ref url="attributes" %} [attributes](https://academy.synap.ac/doc/portal-settings/data-management/attributes) {% endcontent-ref %} ### Creating a new Record of learning From the records table click the **Add record** button, a modal will open with all the available fields to add a new record

### Student side Record of learning Enable the student side record of learning by navigating to **Settings** > **User Access** > **Students** > **Student Insights** > **Enable Records of learning tab**

Enable Record of learning to show to students

Once enabled students will be able to navigate to their Insights page and to a Records of learning tab to view all the records set to them. Note if any record attributes have been hidden from student users they won't see any values for these fields.

### Advanced permissions for Records of learning {% hint style="info" %} Advanced global and specific permissions required, available on Pro and Enterprise plans - get in touch with support to discuss upgrading and enabling {% endhint %} All admins and managers will be able to create, delete, and edit Records of learning. You can create custom roles using advanced permissions on specific educator groups to allow certain educators to edit/delete/create Records of learning for a specific user group. To do this you'll need to have or make a custom educator group

Go to the specific user group's access page to give a specific educator group permissions related to Records of learning. In the example below the **'💿 Record makers'** is allowed to view and edit existing records for the **'👨‍🚀 Astronauts'** group, they can't create or delete new ones but this could be configured.

Advanced permissions for Records of learning

*** ### Record of learning API Use Synap's API for Records of learning to automate workflows. [API Docs](https://docs.synap.ac/#ce7d0f9f-d634-4998-8260-167acc9a54d7)

Record of learning API

* **GET** all Records of learning for user a `https://api-org.synap.ac/learning-records/?userId=id1234&page[limit]=2&page[offset]=0` ``` page limit - max number of learning record to return page offset - point at which to start returning learning records ``` * **DELETE** a Record of learning `https://api-org.synap.ac/learning-records/:learningRecordId` * **POST** a Record of learning `https://api-org.synap.ac/learning-records` * **PATCH** an existing Record of learning `https://api-org.synap.ac/learning-records/:learningRecordId` When creating your request bodies with form data. Please ensure that values are JSON spec compliant, eg using double not single quotes: `"["foo","bar"]"` not `"['foo', 'bar']`

--- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://academy.synap.ac/doc/portal-settings/data-management/records-of-learning.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.