Setting Default Values and Multi-Field Document Titles
Introduction
Efficient data entry and clear document identification are critical for productivity in iVendNext. This guide covers two powerful features:
Setting default values to automate repetitive inputs.
Creating multi-field document titles for better readability and searchability.
Part 1: Setting Default Values
1.1 Why Use Default Values?
Saves time: Auto-fills frequently used data (e.g., default country, tax codes).
Reduces errors: Ensures consistency for mandatory fields.
Supports conditional logic: Dynamic defaults based on other fields.
1.2 How to Configure Default Values
Step 1: Access Field Properties
Go to Customize Form → Select the target DocType (e.g., "Sales Invoice").
Locate the field → Expand its properties.
Step 2: Define the Default
Static Value: Enter directly in Default Value (e.g., "USD" for Currency).
Dynamic Reference: Use {field_name} syntax (e.g., {today} for current date).
Example:
Field: Posting Date
Default Value: {today}
Advanced: Conditional Defaults
Use Custom Scripts to set defaults based on dependencies:
# Set "Territory" to "North" if "Region" is "EMEA"
if doc.region == "EMEA":
doc.territory = "North"
Part 2: Multi-Field Document Titles
2.1 Benefits of Multi-Field Titles
Clarity: Combines key details (e.g., {customer_name} - {invoice_date}).
Searchability: Simplifies filtering in list views.
2.2 How to Configure
Step 1: Identify Title Fields
Ensure referenced fields exist (e.g., customer_name, invoice_date).
Step 2: Create a Consolidated Field
Add a Read Only or HTML field (e.g., "Consolidated Title").
In Options, enter the template:
{customer_name} - Invoice #{name} ({posting_date})
Note:
Step 3: Set as Document Title
In Customize Form, go to View Settings.
Under Title Field, select the consolidated field.
Output Example:
"Acme Corp - Invoice #INV-2024-001 (2024-06-20)"
3. Best Practices & Troubleshooting
3.1 For Default Values
Scenario | Recommendation |
---|
Date-dependent defaults | Use {today} or frappe.utils.nowdate(). |
User-specific defaults | Reference frappe.session.user. |
Mandatory fields | Combine with Is Mandatory flag. |
3.2 For Multi-Field Titles
Test Formatting: Ensure long fields don’t break layouts.
Avoid Circular References: E.g., {title} in a title field.
Use HTML for Rich Text: Add icons/colors via <span> tags.
Conclusion
Related Articles
Customizing Document Titles for Better Clarity
Introduction In iVendNext, document titles serve as the primary identifier for transactions, making it easier to locate and manage records. However, default titles (e.g., "QUO-0001") may not always provide meaningful context. Customizing titles—such ...
Understanding Field Types
Introduction In iVendNext, fields are the building blocks of forms and documents. They define how data is captured, displayed, and processed. Whether you're creating a sales order, tracking inventory, or managing customer records, selecting the right ...
Understanding Multi-Currency Accounting
In today’s globalized economy, businesses often engage in transactions across multiple currencies. Whether you’re dealing with international suppliers, customers, or foreign branches, managing multi-currency transactions is essential for accurate ...
Setting Up Your Retail Store
Introduction Setting up your retail store in iVendNext is a streamlined process that ensures your point-of-sale (POS) system is fully operational, inventory is tracked accurately, and pricing strategies are optimized. This guide provides a ...
Setting Up Your Company
Setting up your company in iVendNext is the first and most crucial step in ensuring that your financial and operational processes run smoothly. A well-configured company setup lays the foundation for accurate accounting, efficient inventory ...