Overview
Setting: Additional Properties in name format for entities of type Teacher
Setting ID: File_Name_Format_Additional_Properties_Teacher
Location: Main Settings > General Settings > Messaging & Notifications tab, Bulk Reporting Notification group
What This Setting Does
This setting controls which extra pieces of information are added to the file name of documents generated in bulk for _Teachers_. The file name always includes the _Teacher_’s name and their system code; here you choose whether to also add the generation date, the main _Period_, and/or the company name.
Where It Is Used
This setting runs automatically in the background whenever the institution generates documents in bulk for _Teachers_ (for example, through the Bulk Services area). There is no separate screen to preview file names; the setting simply shapes the file name of each generated document.
Business Logic / Behavior
- The file name always starts with the _Teacher_’s last name, first name, and _Teacher_ code.
- If Date is selected, the current date is appended to the file name.
- If Main _Period_ is selected, the main _Period_ information is appended to the file name.
- If Company Name is selected, the company name is appended to the file name.
- Basic _Group_ and _Location_ are not offered as options for _Teachers_, since those properties apply to _Students_, not to _Teachers_.
- You can select more than one of the available properties at the same time; each selected property is added to the file name in sequence.
- Any special characters in the appended values are stripped out so the resulting file name stays valid.
Example(s)
Alpha Institute bulk-generates workload certificates for all _Teachers_ at the end of the school year and wants each file dated for easy archiving.
They select Date in this setting. For a _Teacher_ named Marcus W., code 5021, generated on 6/20/2026, the resulting file name is Whitfield_Marcus_5021_06202026.
If they had left the option unselected, the same file would simply be named Whitfield_Marcus_5021.
When to Use
Use this setting to make bulk-generated _Teacher_ documents easier to identify, sort, or archive by adding useful identifying details directly into the file name, based on what staff typically need when handling large batches of files.
Notes
- Related settings:
- Additional Properties in name format (File_Name_Format_Additional_Properties in Messaging & Notifications > Bulk Reporting Notification)
- Message category for bulk requesting processes (Message_Category_For_Bulk_Request in Messaging & Notifications > Bulk Reporting Notification)
K-12 vs Higher Education: This setting behaves the same regardless of the type of institution.
