Marketing Activity

Marketing Activity Module - User Guide

1. Introduction 📝

The Marketing Activity module serves as a lightweight CRM (Customer Relationship Management) tool tailored for manufacturing sales teams. It allows for the systematic recording of every “touchpoint” with a customer or prospective lead, ensuring that commitments, follow-ups, and product interests are never lost.

â„šī¸

In the overall business flow:

  1. It captures pre-sales interactions that lead to enquiries and orders.
  2. It tracks Executive performance and client engagement levels.
  3. It links specific discussions to Product Groups for targeted marketing analysis.

Typically, this module is used by Sales Executives, Marketing Managers, and Business Development Teams.


2. Getting Started with Marketing Activity 🚀

Accessing the Module

Navigate to the Marketing Activity Index section via the main menu.

The Module Structure

The module consists of two interconnected areas:

  1. Marketing Activities Log: The main transactional records capturing interactions, time logs, product interests, and follow-ups.
  2. Activity Master (activitymstindex): Defines what activity occurred (e.g., Cold Call, Product Demo, Exhibition). Can be accessed directly via the “Activity Master” button on the Marketing Activities index page.
â„šī¸

Fixed Interaction Types: Unlike Activity Details which are configured via the Activity Master, the Interaction Type is a standardized system choice:

  • Call (1)
  • Visit (2)
  • Meeting (3)
  • Other (4)

Navigation

The main index (marketingactivityindex) provides a birds-eye view of all tasks, displaying Task No (clickable link to details), Party Short Name, Executive Name, Activity Details, and the current Status. It also provides buttons to Create New and manage the Activity Master.

Marketing Activity Index


3. Features ✨

The Marketing Activity module is built for speed and precision:

  • âąī¸ Precise Time Tracking: Records the exact Start and End date/time of each activity to measure interaction duration.
  • đŸ“Ļ Product-Linked Conversations: Directly link activities to specific Product Groups and Items to track which products are driving interest.
  • 👤 Executive Assignment: Assign tasks to specific sales personnel and track their individual activity logs.
  • 📊 Categorization Masters: Fully customizable Activity and Interaction types to match your company’s sales process.
  • 🔍 Smart Autocomplete: Quick-search functionality for Parties and Items using MudAutocomplete to minimize manual typing.
  • 🔐 Role-Based Security: Ensures that only authorized users can view, modify, or delete sensitive interaction logs.
  • 📜 Automated Audit Trail: Every add, edit, or delete action is automatically logged in the MFGLog for management review.

4. Complete Flow 🔄

Mapping an interaction from start to finish:

Configure Setup (One-time)

  • Ensure your Activity Master is populated with relevant interaction categories (e.g., “Product Demo”, “Service Inquiry”).
  • Confirm your Sales Executives are defined in the Salesmen Master.

Record an Activity (marketingactivitycreate)

  • Click “Create New” in the Marketing Activity index.
  • Select the Party (Customer/Lead).
  • Choose the Executive Name assigned to the activity.
  • Select the Interaction Type: Call, Visit, Meeting, or Other.
  • Pick the Activity Details (from Activity Master).
  • Set the Start Date & Time and End Date & Time.

Recording a Marketing Activity

Link Product Interest

  • Select the Product Group (ItemGroup) discussed.
  • Select the specific Product Name (Item Short Name) and enter the prospective Quantity.

Add Initial Notes & Submit

  • Enter Notes (By Sales Staff) summarizing the interaction (up to 300 characters).
  • Click Submit to generate the new Task No with an initial status of Pending.

Follow Up & Modify (marketingactivitymodify/{id})

  • Open the task from the index to view its Details.
  • Click “Modify” to record progress:
    • The core identity fields (Task No, Party, Executive, Interaction Type, Timestamps, Activity Details, and original Sales Notes) are permanently locked as read-only.
    • You can update the Product Group, Item, or Quantity.
    • Enter additional Follow Up Notes (up to 300 characters).
    • Update the Status: choose between Pending (1), Completed (2), or Cancelled (3).

5. Validations and Error Handling âš ī¸

The system ensures high-quality data through the following rules:

Validation TypeWhat is checked?Error Message / Action
Chronological LogicEnd Date/Time vs Start Date/Time.“End Date / Time must be after Start Date / Time.”
Duration CheckZero-length activities.“Start Date / Time and End Date / Time cannot be same.”
Mandatory FieldsMissing Party, Executive, Activity Details, or Dates.Displays validation message under respective input.
Deletion Status LockAttempting to delete a record when status is not Pending (1).“You may not delete this record as status is [StatusName]”
Activity Master LimitCapacity of the Activity Master table.“This table can hold a maximum of 99 records only.”
Field LengthCharacter limits for notes.“Notes can be upto 300 characters only.” (applies to both Initial Notes and Follow Up Notes)

6. Tools / Smart Features 🔧

  • 🔒 Immutable Initial Records: Once submitted, original conversation notes and timestamps cannot be altered in Modify mode, guaranteeing audit integrity while allowing subsequent “Follow Up Notes” to be appended.
  • đŸ›Ąī¸ Lifecycle Deletion Guard: Ensures that completed or cancelled activities cannot be accidentally or maliciously deleted from the system.
  • ⚡ Quick Access Activity Master: Jump directly to activitymstindex via the button on the main index to add new activity categories on the fly.

7. Related Reports 📊

  • 📈 Marketing Performance Report: Analyze executive productivity and engagement trends.
  • 🔍 CRM Lead Analysis: Detailed breakdown of leads generated by marketing activity (via Crm Lead Report Option).

8. Configuration Requirements âš™ī¸

  • đŸ‘Ĩ Party Master: Customers or leads must exist in the system.
  • đŸ›ī¸ Item Group & Item Masters: Products must be configured to link them to marketing interest.
  • 👨‍đŸ’ŧ Salesmen / Executive Master: Sales team members must be defined.
  • đŸˇī¸ Activity Master: Activity types (up to 99 records) must be defined.

9. Best Practices / Tips 💡

â„šī¸
  • Immediate Entry: Record interactions as soon as they happen to ensure “Notes” are accurate and timestamps reflect real interaction durations.
  • Separation of Notes: Use the initial Notes for the customer’s stated requirements and the subsequent Follow Up Notes (in Modify mode) for the executive’s action plan.
  • Consistent Statuses: Always mark activities as “Completed” once fulfilled to freeze the audit log and prevent deletion.

10. Technical Observations 🔍

âš ī¸
  • Deletion Constraint: You cannot delete an activity record once its status changes from Pending (1) to Completed (2) or Cancelled (3).
  • Interaction Types: Interaction types (Call, Visit, Meeting, Other) are static enum options and do not require master configuration.