Form Instructions & Guidelines
1. Icard Detail Form
When creating or editing an Icard entry, please provide the following information:
- Icard Name: A unique and descriptive name for your Icard (e.g., "Batch 2024 Student ID", "Faculty Card 2023"). This name helps you identify the Icard later.
- Description: A brief explanation of the Icard's purpose or the group it's intended for (e.g., "Official ID for B.Tech CSE students, 2024 intake").
2. Student Data Excel Upload
To ensure accurate data processing for your Icards, please prepare your student information in an Excel file (.xlsx or .xls) following these critical guidelines:
- First Row as Headers: The very first row of your Excel sheet must contain unique column headers. These headers will act as the "keys" that link your data to the Icard template.
- Key Naming Convention: Use clear, concise, and consistent names for your headers (e.g., `studentName`, `rollNumber`, `dateOfBirth`, `course`, `address`). Avoid special characters like `@`, `#`, `$`, `!`, etc., and prefer camelCase or PascalCase, or use spaces as needed if your template will exactly match them.
- Required Data: Ensure all necessary fields are present and correctly populated for each student. If a key in your template does not find a corresponding column or data, it will appear blank.
- Data Types: The system supports text, numbers, and dates. For dates, maintain a consistent format (e.g., YYYY-MM-DD or DD/MM/YYYY) across all entries.
- Empty Rows/Columns: Avoid entirely empty rows or columns within the data range you intend to upload.
Example Excel Headers: `Student Name`, `Roll No`, `Program`, `Date of Birth`, `Contact No`, `Address`
3. Icard Template Upload
Upload your Icard template file (e.g., DOCX, PDF with editable fields, or a custom format if specified). This template will serve as the design blueprint for all generated Icards.
- Placeholder Syntax: To mark where student-specific data should be inserted, use double curly braces `{{ }}` around your Excel column headers (keys).
- Exact Match: The placeholder name within your template must *exactly* match the corresponding column header in your Excel file. This includes case-sensitivity and any spaces or special characters used.
- Image Placeholders: If your template supports dynamic image insertion (e.g., student photos), refer to specific system documentation for the correct image placeholder syntax and expected file naming conventions for images.
Example Template Content Snippet:
Name: {{Student Name}}
Roll Number: {{Roll No}}
Program: {{Program}}
D.O.B: {{Date of Birth}}
Contact: {{Contact No}}
4. Conversion Process
After successfully uploading both your Excel student data and your Icard template, click the "Convert" button. The system will then initiate the following process:
- The system will read and fetch all data records from your uploaded Excel sheet, row by row.
- For each student record, it will create a new Icard instance.
- Inside each Icard instance, it will iterate through your Icard template and automatically replace every `{{placeholder}}` with the corresponding data value from the current student's row in the Excel sheet.
- Finally, it will generate individual, personalized Icards for each student based on the processed data and template.
Important Tip: Always perform a quick check of your generated Icards to ensure all data has been correctly mapped and appears as expected. Discrepancies often stem from mismatched Excel headers and template placeholders.