Smart documents
Smart documents are templates for letters, contracts, and certificates written in the TipTap editor and filled with real data — managed in Settings and generated from user profiles, in bulk, or by self-service.
Smart documents are templates for letters, contracts, and certificates that Fuxam fills with real data. You manage them on Settings → Communication & Documents → Documents and generate them from Campus Management → User Management.
Why it matters
Official paperwork is repetitive and error-prone. With smart documents you write it once in a visual editor, insert variables for names, dates, and program data, and generate a correct version for each person. Changes are versioned, so you can see and restore earlier states.
How this fits
Smart documents use data from User Management, Study programs and cohorts, and Time tracking. Students can see their self-service documents from the Management tab.
Before you start
| Requirement | Detail |
|---|---|
| Feature | Smart Documents in the FuxamCMS package. See Permissions and features. |
| Permission | read-write:settings-service-contracts to create, edit, and manage templates. |
| Location | Settings → Communication & Documents → Documents. The page title is "Smart Documents". |
Key concepts
| Concept | Meaning |
|---|---|
| Template | A document design with text, variables, and form fields. |
| Object Type | The kind of record a template uses: User, Module, Curriculum, Room, or Certificate. |
| Variable | A placeholder replaced with real data when the document is generated. |
| Form field | An input someone fills in when completing the document. Counted in the Form Fields column. |
| Version | A saved, published state of a template. Visible under Versions in the editor. |
| Default | The template preselected when you add a document. |
| PDF template | An older template type. It still works and appears in the same table. New templates use the TipTap editor. |
Ways to generate documents
| Route | Who | Where |
|---|---|---|
| Single | Staff | Campus Management → User Management → [User] → Documents → Smart Document |
| Bulk | Staff | Users table → Smart Document action |
| Self-service | Eligible users | Set up in the Self-Service Documents section |
| Study contract | Applicants | Assigned to application forms in Study Contracts |
| Certificate | Students | Certificate template chosen in the course |
In this section
Create a document
Add a template, optionally from a Word file.
Edit a document
Use the editor, preview, and versions.
Use a document template
Generate for one user or through self-service.
Document variables and data sources
What data fills a document.
Generate documents in bulk
Add a document to many users.
Study contracts and certificates
Contracts for applicants, certificates for students.
Manage documents
Templates table and user documents.
Examples
Practical how-tos for typical documents:
Example: Create an enrollment certificate
A one-page User document.
Example: Create a course certificate
A Certificate template used in a course.
Example: Create a transcript of records
A grades table from the study plan.
Example: Create a module handbook (Modulhandbuch)
A Module template for module description sheets.
Who does what
| Role | Typical tasks |
|---|---|
Administrators with read-write:settings-service-contracts |
Create and edit templates, set defaults, configure self-service and study contracts. |
| Registrars and staff | Add documents to users, request completion, use the Smart Document action. |
| Students and applicants | Generate self-service documents, complete requested documents, sign contracts. |
Data protection
Documents can contain personal data. Only insert variables the reader is allowed to see, limit self-service to the roles that need it, and restrict who can delete user documents (write:user-documents).
Where to start
- Create a document.
- Edit a document and preview it.
- Use a document template.
- For many users, read Generate documents in bulk.