Skip to content

External Comment Definitions

External Comment Definitions allow managers to create predefined customer-facing comments that can be quickly added to repair orders. This feature ensures consistency in customer communication and saves time by reusing standardized text across repair operations.

Overview

With External Comment Definitions, you can:

  • Create a library of predefined customer-facing comments for common repair scenarios
  • Categorize comments by type (Complaint Accepted, Complaint Rejected, No-repair Statement)
  • Maintain consistent professional communication with customers
  • Save time by reusing standardized text instead of typing manually
  • Ensure quality and accuracy of customer communications
  • Support multiple languages and localization requirements
  • Organize comments with custom ordering for prioritized selection

Understanding Comment Types

External Comment Definitions support categorization through comment types that help organize and filter predefined comments:

Available Comment Types

Blank (Default) - General-purpose comments that can be used in any context - Suitable for commonly used phrases or standard information - Appears in all comment selection scenarios

Complaint Accepted - Comments specifically for accepting customer complaints - Used when repairs are covered under warranty or goodwill - Professional acknowledgment of customer concerns

Complaint Rejected - Comments for situations where complaints cannot be accepted - Used when repairs fall outside warranty coverage or policy - Provides clear, professional explanations for rejection

No-repair Statement - Comments for items that cannot or should not be repaired - Used when repair is not economical or technically feasible - Explains alternative options or recommendations to customers

Setting Up External Comment Definitions

Prerequisites

Before setting up External Comment Definitions, ensure you have:

  • Appropriate permissions (Manager role recommended for full access)
  • Repair Management Setup completed
  • Understanding of your repair communication requirements
  • Knowledge of common customer scenarios requiring standardized responses

Accessing External Comment Definitions

  1. Open the Business Central client
  2. Use the search function (Alt+Q) and search for "External Comment Definitions"
  3. Select Repair External Comment Definitions from the search results
  4. The External Comment Definitions list page opens, showing existing definitions

Creating External Comment Definitions

  1. On the Repair External Comment Definitions page, select New to create a new definition

  2. Configure Basic Information:

  3. Code: Enter a unique identifier for the comment (up to 20 characters)
  4. Description: Enter the comment text (up to 250 characters)
  5. Comment Type: Select the appropriate type for categorization
  6. Order: Specify the display order (optional, lower numbers appear first)

!!! tip "Code Naming Convention" Use descriptive codes that clearly indicate the comment's purpose. Examples: WARRANTY-ACK, REPAIR-COMPLETE, NO-PARTS. This makes selection easier for technicians.

  1. Setting Comment Order:
  2. Use the Order field to control the sequence in which comments appear
  3. Comments with lower order numbers appear first in selection lists
  4. Comments with the same order are sorted alphabetically by Code

  5. Leave blank (0) for standard alphabetical sorting

  6. Preview Your Comment:

  7. Use the Preview Comment action to view the full comment text
  8. Verify the content is appropriate for customer communication
  9. Ensure professional language and correct spelling

Example External Comment Definitions

Here are examples of effective External Comment Definitions:

General Comments (Blank Type)

Code: REPAIR-COMPLETE
Description: Your item has been successfully repaired and tested. All functionality has been restored to manufacturer specifications.
Order: 10

Code: PICKUP-READY
Description: Your repair is complete and ready for pickup during business hours. Please bring your repair receipt when collecting your item.
Order: 20

Complaint Accepted Comments

Code: WARRANTY-HONOR
Description: We acknowledge your concern and will honor the warranty coverage for this repair at no charge to you.
Comment Type: Complaint Accepted
Order: 10

Code: GOODWILL-REPAIR
Description: While this repair falls outside standard warranty, we will complete it as a goodwill gesture to maintain your satisfaction.
Comment Type: Complaint Accepted
Order: 20

Complaint Rejected Comments

Code: OUT-OF-WARRANTY
Description: This repair falls outside the manufacturer warranty period. Repair charges will apply according to our standard service rates.
Comment Type: Complaint Rejected
Order: 10

Code: DAMAGE-EXCLUDED
Description: The damage observed is consistent with impact or misuse, which is not covered under warranty terms and conditions.
Comment Type: Complaint Rejected
Order: 20

Cr. Note Required Statement Comments

Code: UNECONOMICAL
Description: The repair cost exceeds the item's current value. A credit note will be issued for the original purchase price.
Comment Type: No-repair Statement
Order: 10

Code: PARTS-UNAVAILABLE
Description: Required parts are no longer available from the manufacturer. A credit note will be processed for replacement with a current model with similar features.
Comment Type: No-repair Statement
Order: 20

Using External Comments on Repair Orders

General Comment Selection

On the Repair Order Card, use the Add External Comments action to:

  1. Open Comment Selection: Click Add External Comments in the ribbon
  2. Select Multiple Comments: Use checkboxes to select desired comments
  3. Review Selection: Preview which comments will be added
  4. Confirm Addition: Click OK to append comments to the External Comments field

The system automatically: - Orders comments by the Order field, then by Code - Separates multiple comments with line breaks - Appends to existing content without overwriting - Validates the 1,024 character limit and warns if exceeded

Type-Specific Comment Actions

For faster access to categorized comments, use type-specific actions:

Add Accepted Comment - Quickly adds all "Complaint Accepted" type comments - Useful when honoring warranty claims or providing goodwill repairs - Automatically filters to show only relevant comments

Add Rejected Comment - Adds all "Complaint Rejected" type comments - Used when declining warranty coverage or complaint requests - Provides professional explanation for rejection

Add Cr. Note Required Statement - Adds all "No-repair Statement" type comments - Used when repair is not feasible or economical and a credit note is required - Explains alternatives and credit note process to customers

Automatic Comment Collection

Type-specific actions automatically collect all comments of the selected type without requiring individual selection. This streamlines the process for common scenarios.

Managing External Comment Definitions

Viewing and Editing Comments

  1. View All Definitions: The list page shows Code, Description, Comment Type, and Order
  2. Edit Definition: Click on any row to modify the comment details
  3. Preview Long Comments: Use the Preview Comment action for full text display
  4. Sort by Type: Use column sorting to group comments by type or order

Organizing Your Comment Library

Grouping by Type - Use Comment Type consistently across similar scenarios - Create specific comments for each type of customer interaction - Maintain professional tone appropriate for each category

Ordering Strategy - Use increments of 10 for Order values (10, 20, 30) to allow easy insertion - Place most commonly used comments at lower order numbers - Group related comments with similar order ranges

Code Naming Best Practices - Use descriptive prefixes (WARRANTY-, REPAIR-, PICKUP-) - Keep codes short but meaningful - Maintain consistency across your comment library - Use uppercase for better readability

Maintenance and Updates

Regular Review - Periodically review comment accuracy and relevance - Update language to reflect current policies and procedures - Remove outdated or unused comment definitions

Quality Assurance - Ensure all comments maintain professional tone - Verify grammar and spelling accuracy - Test character limits for longer comments - Validate that comments align with current business policies

Best Practices

Content Guidelines

Professional Language - Use clear, professional language appropriate for customer communication - Avoid technical jargon that customers may not understand - Maintain a helpful and courteous tone throughout - Be specific about next steps or recommendations

Comprehensive Information - Include relevant details about repair status, warranty coverage, or next steps - Provide clear instructions for customer actions (pickup, contact, etc.) - Explain any limitations or conditions clearly - Set appropriate expectations for timing and outcomes

Consistency Standards - Maintain consistent formatting and style across all comments - Use similar phrasing for related scenarios - Ensure comments align with company policies and procedures - Standardize terminology and technical references

Organization Strategies

Logical Grouping - Group comments by repair outcome (completed, rejected, pending) - Organize by customer communication type (informational, instructional, explanatory) - Separate routine comments from exception handling - Create categories for different product lines or service types

Efficient Selection - Design comments for easy combination and flow - Avoid redundancy between frequently used comments - Consider comment length for space optimization - Plan for multi-comment scenarios and logical ordering

Usage Optimization

Technician Training - Train staff on appropriate comment selection for different scenarios - Establish guidelines for when to use type-specific vs. general comments - Provide examples of effective comment combinations - Review customer feedback to improve comment effectiveness

Performance Monitoring - Track which comments are used most frequently - Monitor customer satisfaction with standardized communications - Adjust comment library based on usage patterns and feedback - Regular review of comment effectiveness and relevance

Permissions

The External Comment Definitions feature requires specific permissions for different user roles:

Manager Role

  • Full Access (RMID): Create, read, modify, and delete external comment definitions
  • Page Access: Full access to External Comment Definitions list and API pages
  • Administrative Control: Complete management of the comment library

Technician Role

  • Read Access (R): View existing external comment definitions
  • Comment Selection: Access to comment selection dialogs on repair orders
  • Type-Specific Actions: Use type-specific comment insertion actions

Read Role

  • Read Access (R): View external comment definitions for reporting purposes
  • Limited Functionality: Cannot modify or create comment definitions
  • Reporting Access: Suitable for reporting and analysis purposes

Troubleshooting

Common Issues

Q: I can't see the External Comment Definitions page
A: Ensure you have the appropriate permissions. The feature requires at least read access to External Comment Definition objects. Contact your system administrator to verify permission assignments.

Q: Comments are not appearing in the correct order
A: Check the Order field values. Comments are sorted first by Order (ascending), then by Code (alphabetically). Use incremental values (10, 20, 30) for Order to maintain proper sequence.

Q: I get a character limit warning when adding comments
A: The External Comments field has a 1,024 character limit. When adding multiple predefined comments, the system checks the total length and truncates if necessary. Consider using shorter comment definitions or selecting fewer comments.

Q: Type-specific actions are not available on the Repair Order
A: Type-specific actions only appear when External Comment Definitions of that type exist in the system. Create appropriate comment definitions with the desired Comment Type to enable these actions.

Character Limit Management

Understanding the Limit - External Comments field supports up to 1,024 characters total - This includes existing content plus newly added comments - The system provides warnings when approaching the limit

Optimization Strategies - Design concise but informative comment definitions - Avoid redundant information between multiple comments - Use abbreviations appropriately while maintaining clarity - Consider breaking long information into separate, selectable comments

Setup Validation

Testing Your Configuration 1. Create test External Comment Definitions for each comment type 2. Verify comments appear in correct order on repair orders 3. Test type-specific actions with sample comments 4. Validate character limits with realistic comment combinations 5. Confirm API access if integration is required

For additional support or questions about External Comment Definitions, contact BC4All support or consult the community forums.