2203 Working With Records
Working with Records
Introduction
Understanding Records
What is a Record?
A record is a single entry in a table, similar to a row in a spreadsheet:
- Contains values for all fields in the table
- Has a unique ID
- Can be connected to records in other tables
- Stores metadata (creation date, created by, etc.)
Record Examples
- Customers Table: Each record is one customer
- Orders Table: Each record is one order
- Tasks Table: Each record is one task
- Products Table: Each record is one product
Record Lifecycle
- Creation: Record is added to table
- Active Use: Record is viewed, edited, connected to other records
- Updates: Field values change over time
- Archival/Deletion: Record is removed or archived
Creating Records
Method 1: Form Component
The most common method—users fill out a form:
When to Use
- User-facing data entry
- Applications or submissions
- Customer intake
- Order placement
- Event registration
Advantages
- User-friendly interface
- Validation and error checking
- Guided data entry
- Can include help text and instructions
- Supports file uploads
Setup Steps
- Create a page for the form
- Add Form component
- Select "Add Form" type
- Choose which fields to include
- Configure validation and defaults
- Set submission behavior
Method 2: Manual Creation in Builder
Create records directly in the Data Builder:
When to Use
- Administrative data entry
- Initial data setup
- Testing and development
- One-off record creation
- Quick data fixes
How to Create Manually
- Open Data Builder
- Select the table
- Click "Add Record"
- Fill in field values
- Click "Save"
Advantages
- Quick and direct
- Access to all fields
- No form setup required
- Good for admin tasks
Disadvantages
- Only available to builders
- Less user-friendly than forms
- No custom validation
- Not suitable for end users
Method 3: Inline Record Creation
Create records directly within table components:
When to Use
- Quick data entry
- List-based workflows
- Spreadsheet-like interaction
- Simple records without many fields
How to Enable
- Open table component settings
- Enable "Inline Add"
- Select which fields to show
- Configure permissions
Advantages
- Fast data entry
- No page navigation
- Familiar spreadsheet-like interface
- Good for bulk entry
Method 4: Duplicate Record
Create new record by copying an existing one:
When to Use
- Creating similar records
- Template-based creation
- Recurring events or orders
- Testing with sample data
How to Duplicate
- View existing record
- Click "Duplicate" action
- System copies all field values
- Edit as needed
- Save new record
Configuration Options
- Choose which fields to copy
- Exclude certain fields (e.g., dates, IDs)
- Copy or exclude connected records
- Set default values for duplicated records
Method 5: Import
Create multiple records from external data:
When to Use
- Migrating data from other systems
- Bulk data upload
- Regular data imports
- Integrating with spreadsheets
Import Sources
- CSV files
- Excel files
- Other Tadabase apps
- External databases (via API)
Method 6: API Creation
Create records via REST API:
When to Use
- Integration with external systems
- Automated record creation
- Mobile app integration
- Third-party service connections
Method 7: Automated Creation via Rules
Create records automatically based on triggers:
When to Use
- Workflow automation
- Creating related records automatically
- Scheduled record generation
- Business process automation
Examples
- New customer → Create welcome task
- Order placed → Create invoice record
- Event created → Create reminder records
- Weekly schedule → Create task records
Editing Records
Edit Form Method
Use a dedicated edit form:
Setup
- Create edit page
- Add Form component
- Select "Edit Form" type
- Choose fields to display
- Configure update behavior
User Flow
- User clicks "Edit" action link
- Edit form opens with current values
- User modifies fields
- User clicks "Save"
- Record updates, user redirects
Best For
- Complex records with many fields
- Guided editing process
- Validation requirements
- User-facing applications
Inline Editing Method
Edit directly in table components:
Setup
- Open table component settings
- Enable "Inline Edit"
- Select editable fields
- Configure save behavior
User Flow
- User clicks field to edit
- Field becomes editable
- User changes value
- Change saves automatically or on blur
Best For
- Quick edits
- Single field updates
- Spreadsheet-like workflows
- Frequent small changes
Popup Edit Method
Edit in modal popup:
Advantages
- No page navigation
- User stays in context
- Faster workflow
- Good for simple edits
Setup
- Configure action link to open in popup
- Create edit form
- Set form to display in modal
- Configure close behavior
Builder Edit Method
Edit records in Data Builder:
When to Use
- Administrative updates
- Data corrections
- Testing and development
- Bulk field updates
How to Edit
- Open Data Builder
- Select table
- Find record
- Click to edit
- Update fields
- Save changes
Edit Permissions
Control who can edit records:
- All Users: Anyone can edit any record
- Owner Only: Only record creator can edit
- Role-Based: Specific roles can edit
- Conditional: Edit based on field values or rules
Edit Tracking
Track who edited what and when:
- Modified Date field (auto-updates)
- Modified By field (tracks user)
- Record history log (detailed changes)
- Audit trail for compliance
Bulk Operations
Bulk Update
Update multiple records at once:
Use Cases
- Change status of multiple items
- Assign multiple tasks to user
- Update category for multiple products
- Change priority of multiple tickets
- Set dates for multiple events
How to Bulk Update
- View records in table component
- Enable bulk selection
- Select records to update
- Choose "Bulk Update" action
- Select field to update
- Set new value
- Confirm update
Configuration
- Enable bulk update in table settings
- Choose which fields can be bulk updated
- Set permissions
- Configure confirmation requirements
Bulk Delete
Delete multiple records at once:
Use Cases
- Clean up old records
- Remove test data
- Delete completed tasks
- Archive old orders
How to Bulk Delete
- Select multiple records
- Choose "Bulk Delete" action
- Confirm deletion
- Records deleted or archived
Safety Considerations
- Require confirmation
- Limit to specific roles
- Use soft delete when possible
- Enable undo functionality
- Maintain deletion log
Bulk Export
Export multiple records to file:
Use Cases
- Backup data
- Share data externally
- Import to other systems
- Generate reports
- Data analysis
Export Formats
- CSV (spreadsheet compatible)
- Excel
- PDF (formatted documents)
- JSON (for developers)
Export Options
- Select specific fields
- Apply filters before export
- Export all or selected records
- Include connected record data
Bulk Import
Import multiple records from file:
Use Cases
- Initial data load
- Migrate from other systems
- Regular data updates
- Restore from backup
Import Process
- Prepare data file (CSV/Excel)
- Map columns to fields
- Review mapping and sample data
- Run import
- Review results and errors
Import Options
- Create new records only
- Update existing records
- Create or update (upsert)
- Skip duplicates
- Validate data before import
Bulk Action Best Practices
- Always confirm before executing
- Test with small subset first
- Backup data before bulk operations
- Limit permissions to trusted users
- Log all bulk operations
- Provide undo functionality when possible
- Clear communication about what will happen
Record Logs and History
Types of Record Tracking
1. System Metadata
Automatically tracked information:
- Created Date: When record was created
- Created By: Who created the record
- Modified Date: When last updated
- Modified By: Who last updated
- Record ID: Unique identifier
2. Field History
Track changes to specific fields:
- Previous value
- New value
- Who changed it
- When it changed
- Why it changed (if comment provided)
3. Activity Log
Comprehensive record of all actions:
- Record views
- Field updates
- Status changes
- File uploads
- Related record changes
- Email sent
- Rules triggered
Enabling Record History
- Table Level
- Open table settings
- Enable "Track Record History"
- Select fields to track
- Configure retention period
- Field Level
- Open field settings
- Enable "Track Changes"
- Changes logged automatically
- Display History
- Add History component to detail page
- Configure display options
- Set permissions
Viewing Record History
Users can view record history through:
- History Tab: Dedicated tab on detail page
- Timeline View: Chronological activity feed
- Audit Report: Comprehensive change report
- Field-Specific History: Changes to one field
History Use Cases
Compliance & Auditing
- Prove who did what and when
- Meet regulatory requirements
- Internal audits
- Legal documentation
Troubleshooting
- Understand why data changed
- Identify when issues occurred
- Track down errors
- Debug workflows
Collaboration
- See what team members did
- Understand record evolution
- Coordinate handoffs
- Track progress
Analytics
- Analyze workflow patterns
- Measure process efficiency
- Identify bottlenecks
- Track user behavior
History Best Practices
- Track critical fields only (performance)
- Set appropriate retention periods
- Protect history from deletion
- Make history easily accessible
- Use history for process improvement
- Regular history backups
Delete Tracking and Recovery
Deletion Strategies
1. Hard Delete
Permanently remove record from database:
- Pros: Cleans up database, saves space
- Cons: Cannot recover, loses history
- When to Use: Test data, duplicates, truly unnecessary records
2. Soft Delete (Archive)
Mark record as deleted but keep in database:
- Pros: Can recover, maintains history, preserves relationships
- Cons: Clutters database over time
- When to Use: Important data, compliance requirements, uncertain about deletion
3. Status Change
Change status to "Inactive" or "Closed":
- Pros: Reversible, maintains full record, clear audit trail
- Cons: Records still appear in counts
- When to Use: Customers, accounts, anything that might reactivate
Implementing Soft Delete
- Add Status Field
- Add dropdown field: "Active", "Deleted", "Archived"
- Default to "Active"
- Configure Delete Action
- Instead of deleting, update status to "Deleted"
- Optionally set "Deleted Date" and "Deleted By"
- Filter Out Deleted Records
- Add filter to all components: Status ≠ "Deleted"
- Hide deleted records from users
- Maintain separate "Recycle Bin" view
- Enable Recovery
- Create "Restore" action
- Changes status back to "Active"
- Clears deleted date/user fields
Recycle Bin / Archive View
Create dedicated view for deleted records:
- Create "Archive" or "Recycle Bin" page
- Add table component
- Filter to: Status = "Deleted"
- Include restore and permanent delete actions
- Limit access to admins
Delete Permissions
Control who can delete records:
- No One: Disable delete entirely
- Admins Only: Restrict to admin role
- Owner Only: Only record creator
- Role-Based: Specific roles
- Conditional: Based on field values or rules
Deletion Confirmation
Always confirm before deleting:
- Show warning message
- Require explicit confirmation
- Display what will be deleted
- Warn about connected records
- Provide "Cancel" option
Connected Record Handling
Decide what happens to connected records:
- Cascade Delete: Delete all connected records too
- Prevent Delete: Don't allow if connections exist
- Orphan: Keep connected records, remove connection
- Reassign: Move connected records to another parent
Deletion Tracking
Maintain log of deletions:
- Who deleted the record
- When it was deleted
- Why (if reason provided)
- What was deleted (snapshot of data)
- Whether it was recovered
Record Duplication Prevention
Duplicate Prevention Strategies
1. Unique Field Constraints
- Mark fields as "unique"
- System prevents duplicate values
- Examples: Email, Order Number, SKU
2. Duplicate Checking Rules
- Check for existing records before creating
- Warn user if potential duplicate
- Require confirmation to proceed
3. Merge Duplicates
- Identify duplicate records
- Choose primary record
- Merge data from duplicates
- Update connections
- Delete duplicate records
4. Search Before Create
- Require users to search first
- Show potential matches
- Suggest existing records
- Only create if truly new
Record Management Best Practices
Data Quality
- Require essential fields
- Validate data on entry
- Provide clear field labels and help
- Use appropriate field types
- Prevent duplicate records
- Regular data cleanup
User Experience
- Make creation and editing intuitive
- Provide clear feedback
- Minimize required fields
- Use smart defaults
- Show progress indicators
- Enable quick actions
Performance
- Archive old records
- Use pagination for large datasets
- Optimize filters and searches
- Lazy load related data
- Regular database maintenance
Security
- Control who can create records
- Restrict editing permissions
- Limit delete access
- Track all changes
- Protect sensitive data
- Regular permission audits
Compliance
- Track record history
- Maintain audit logs
- Implement data retention policies
- Enable data export
- Support right to deletion
- Document processes
Real-World Examples
Creation:
- Users create via signup form
- Sales team creates manually
- Import from existing CRM
- API integration from website
Editing:
- Customers edit own profile
- Account managers edit details
- Inline edit for quick updates
- Bulk update for mass changes
Tracking:
- Track status changes (Lead → Customer)
- Log all interactions
- Monitor account value changes
- Track assigned rep changes
Deletion:
- Soft delete (mark inactive)
- Maintain for compliance
- Archive after 5 years
- Only admins can permanently delete
Creation:
- Users create from form
- Auto-create from project template
- Duplicate recurring tasks
- API creates from email
Editing:
- Inline edit status and priority
- Full edit form for details
- Bulk update assigned user
- Drag-drop status changes (Kanban)
Tracking:
- Log status transitions
- Track time spent
- Monitor reassignments
- Record completion date
Deletion:
- Hard delete allowed after completion
- Bulk delete old tasks
- Prevent delete if has sub-tasks
- Archive completed tasks after 6 months
Summary
- Multiple creation methods for different scenarios
- Flexible editing approaches from inline to full forms
- Bulk operations for efficient mass updates
- Record history tracking for compliance and debugging
- Smart deletion strategies with recovery options
- Best practices for data quality and security
Next: Continue to Introduction to Equations to learn how to perform calculations and transformations.
Hands-On Exercise (To Be Added)
Exercise placeholders will include practical activities such as:
- Create records using multiple methods
- Set up inline editing in a table component
- Configure bulk update operations
- Enable record history tracking
- Implement soft delete with recovery
Knowledge Check (To Be Added)
Quiz questions will test understanding of:
- Different record creation methods and when to use each
- Advantages of inline vs form editing
- Benefits of bulk operations
- Importance of record history tracking
- Difference between hard delete and soft delete

We'd love to hear your feedback.