# Class File

<span class="rvts53">The **Class file** is essential for creating and associating classes with teachers in the pickAtime event. Below are the detailed instructions for creating a valid **Class File**.</span>

#### **<span class="rvts0"><span class="rvts165">Required Columns</span></span>**

1. <span class="rvts184">ClassID</span>
- <span class="rvts53">A unique identifier for the class.</span>
- <span class="rvts170">Must be unique per teacher.</span><span class="rvts53"> For example, if one class has multiple sessions taught by different teachers, you’ll need distinct ClassIDs (e.g., "Eng9-869").</span>
- <span class="rvts53">Ensure the same ClassID is used in the Enrollment File.</span>

3. <span class="rvts184">TeacherID</span>
- <span class="rvts53">Links the class to the teacher.</span>
- <span class="rvts53">Must match the TeacherID listed in the Teacher File.</span>

5. <span class="rvts184">ClassName</span><span class="rvts53"> </span><span class="rvts89">(Optional)</span>
- <span class="rvts53">Provides a descriptive name for the class (e.g., "Math").</span>
- <span class="rvts53">Useful for display purposes on the CUI legend.</span>

7. <span class="rvts184">GroupName</span><span class="rvts53"> </span><span class="rvts89">(Optional)</span>
- <span class="rvts53">Categorizes teachers into groups (e.g., "Upper School" or "Lower School").</span>
- <span class="rvts53">Helpful for managing time slots for different teacher groups.</span>

9. <span class="rvts184">PTAN</span><span class="rvts53"> </span><span class="rvts89">(Optional)</span>
- <span class="rvts53">Specifies the number of allowed parent appointments per class. Default is 1 if absent.</span>


#### **<span class="rvts0"><span class="rvts165">File Format</span></span>**

- <span class="rvts184">File Type:</span><span class="rvts53"> Tab-delimited text file (</span><span class="rvts183">\*.txt</span><span class="rvts53"> or </span><span class="rvts183">\*.tsv</span><span class="rvts53">).</span>
- <span class="rvts184">First Row:</span><span class="rvts53"> Must contain column headers labeled exactly as specified.</span>
- <span class="rvts184">Example Tools:</span><span class="rvts53"> Export from Excel or Google Sheets as Tab-delimited Text.</span>

#### **<span class="rvts0"><span class="rvts165">TEMPLATE of a Simple Class File:</span></span>**

<div class="rvps10" id="bkmrk-classid-teacherid-cl"><table><tbody><tr><td>**<span class="rvts87">ClassID</span>**

</td><td>**<span class="rvts87">TeacherID</span>**

</td><td>**<span class="rvts87">ClassName</span>**

</td></tr><tr><td><span class="rvts53">Math-101</span>

</td><td><span class="rvts53">T001</span>

</td><td><span class="rvts53">Math</span>

</td></tr><tr><td><span class="rvts53">Science-102</span>

</td><td><span class="rvts53">T002</span>

</td><td><span class="rvts53">Science</span>

</td></tr></tbody></table>

</div>#### **<span class="rvts0"><span class="rvts165">TEMPLATE with Additional Columns:</span></span>**

<div class="rvps10" id="bkmrk-classid-teacherid-cl-1"><table><tbody><tr><td>**<span class="rvts87">ClassID</span>**

</td><td>**<span class="rvts87">TeacherID</span>**

</td><td>**<span class="rvts87">ClassName</span>**

</td><td>**<span class="rvts87">GroupName</span>**

</td><td>**<span class="rvts87">PTAN</span>**

</td></tr><tr><td><span class="rvts53">Math-101</span>

</td><td><span class="rvts53">T001</span>

</td><td><span class="rvts53">Math</span>

</td><td><span class="rvts53">Upper School</span>

</td><td><span class="rvts53">2</span>

</td></tr><tr><td><span class="rvts53">Science-102</span>

</td><td><span class="rvts53">T002</span>

</td><td><span class="rvts53">Science</span>

</td><td><span class="rvts53">Lower School</span>

</td><td><span class="rvts53">1</span>

</td></tr></tbody></table>

</div>**<span class="rvts184">PTAN</span>**<span class="rvts53"> **(parent teacher appointment number)** is the number of allowed appointments for each student's parent for that class. For example, some schools allow the parent 2 appointments with a home room teacher or an advisor. If the column is not present, 1 is assumed.</span>

<p class="callout info"><span class="rvts53">The </span><span class="rvts184">Class File</span><span class="rvts53"> assigns teachers to specific events and their associated classes. Each class must have a unique </span><span class="rvts183">ClassID</span><span class="rvts53">, and a </span><span class="rvts183">TeacherID</span><span class="rvts53"> must match an imported teacher.</span></p>

#### **<span class="rvts0"><span class="rvts165">Where to Check Imported Class Data in the Admin UI</span></span>**

- <span class="rvts53">Open the event in the Admin UI.</span>
- <span class="rvts53">Go to the </span><span class="rvts184">Class Editor</span><span class="rvts53"> tab.</span>
- <span class="rvts53">The list of teachers and their imported classes will be displayed.</span>
- <span class="rvts53">Verify that all expected classes are associated with the correct teachers.</span>

<p class="callout success">If you have older classes and enrollments, you can now delete the event’s existing classes and enrollments directly from the Import page before uploading new data. This option will also delete the classes’ associated teacher resources, making it easier to remove bad data without leaving the Importer page. To locate this feature on the Imports page, click the Class file option within the File Type drop-down menu.</p>