Quality inspection workflow notifications not sent to inspectors in Quality Control

[timothy_tech]

We’re having a critical issue with our quality inspection workflow where notification emails are not being sent to quality inspectors when new inspection tasks are assigned. The workflow creates the inspection tasks successfully in the BPM worklist, but inspectors aren’t receiving email notifications, causing significant delays in our inspection process.

I’ve verified that the workflow notification configuration appears correct in the workflow designer, and I can see the tasks in the BPM worklist application. However, no emails are being delivered. When I check the inspector user profiles, email addresses are populated correctly.

This is impacting our production schedule because inspectors aren’t aware of pending tasks unless they manually check the worklist. Has anyone experienced similar notification delivery issues with quality workflows?

I’ll provide a comprehensive solution covering all aspects of the notification configuration issue.

1. Workflow Notification Configuration:

The workflow notification activity needs proper configuration:

a) Access the workflow designer:

• Navigate to: Application Composer > Quality Management
• Select: Quality Inspection Workflow
• Open workflow in edit mode

b) Configure notification activity:

• Locate the ‘Assign Inspection Task’ activity
• Open properties panel
• Notification Settings:
  • Send Email: Yes
  • Notification Type: Task Assignment
  • Recipient Source: Task Assignee
  • Include Worklist Link: Yes
  • Priority: Normal

c) Recipient resolution:

Recipient Type: User
Resolution Method: From Task Assignment
Fallback: Role (QualityInspector)
Email Field: Primary Email Address

This ensures the notification resolves to the specific inspector assigned to the task.

2. Email Template Setup:

Create or validate the notification email template:

a) Navigate to: Setup and Maintenance > Manage Notification Templates

b) Search for: ‘Quality Inspection Task Assignment’

c) If not found, create new template:

• Template Name: Quality Inspection Task Assignment
• Template Type: Workflow Notification
• Subject: New Quality Inspection Required - {InspectionNumber}
• Body:

Dear {AssigneeName},

A new quality inspection has been assigned to you:

Inspection Number: {InspectionNumber}
Item: {ItemDescription}
Quantity: {InspectionQuantity}
Priority: {InspectionPriority}
Due Date: {DueDate}

Please access your worklist to complete this inspection:
{WorklistLink}

Thank you,
Quality Management System

d) Configure template attributes:

• Map workflow data attributes to template variables
• Ensure all referenced attributes exist in workflow context

e) Associate template with workflow:

• In workflow designer, notification activity
• Template: Select ‘Quality Inspection Task Assignment’
• Save and deploy workflow

3. Notification Service Validation:

Verify the notification infrastructure:

a) Check notification mailer status:

• Navigate to: Setup and Maintenance > Manage Workflow Notification Mailers
• Status should be: Running
• Last Run Time: Recent (within last hour)

b) Validate SMTP configuration:

SMTP Server: mail.company.com
Port: 587 (or 25)
Authentication: Enabled
From Address: noreply@company.com
TLS/SSL: As required by mail server

c) Test SMTP connectivity:

• Use ‘Test Connection’ button in mailer configuration
• Should return: ‘Connection Successful’
• If fails, check firewall rules and mail server settings

d) Review notification processing:

• Navigate to: Tools > Workflow Administrator
• Select: Notification Log
• Filter: Last 24 hours, Status = Failed
• Identify patterns in failures

4. User Profile Email Verification:

Ensure inspector profiles are correctly configured:

a) Validate email addresses:

• Navigate to: Setup and Maintenance > Manage Users
• Search for each quality inspector
• Open user profile

b) Check contact information:

• Email Address: Must be populated
• Primary Email: Should be checked/selected
• Email Type: Business (not Personal)
• Verified: Should show as verified

c) Notification preferences:

• Navigate to user profile > Preferences
• Notification Settings:
  • Enable Email Notifications: Yes
  • Workflow Notifications: Enabled
  • Notification Frequency: Immediate
  • Notification Format: HTML

d) Bulk update for multiple users:

-- Diagnostic query to find users with disabled notifications
SELECT user_name, email_address, notification_preference
FROM per_users
WHERE user_name IN (SELECT member_user_name
                    FROM per_role_members
                    WHERE role_name = 'QualityInspector')
AND notification_preference != 'ENABLED';

Use this to identify which inspectors need preference updates.

e) Enable notifications programmatically:

• Navigate to: Setup and Maintenance > Manage User Preferences
• Select: Bulk Update
• Filter: Role = Quality Inspector
• Update: Email Notifications = Enabled
• Apply changes

5. Role and Assignment Configuration:

Ensure proper role-to-user mapping:

a) Verify role membership:

• Navigate to: Setup and Maintenance > Manage Roles
• Search: QualityInspector
• View Members tab
• Confirm all active inspectors are listed

b) Check role notification settings:

• Role properties > Notification Settings
• Email Distribution: Individual (not role email)
• This ensures each inspector gets individual notifications

c) Validate assignment logic:

• In workflow, task assignment should be:

Assignment Type: User (specific inspector)
NOT: Role (inspector group)

• Role-based assignments often fail to send individual emails

6. Testing and Validation:

a) Create test inspection:

• Navigate to: Quality Management
• Create new inspection order
• Assign to specific test inspector
• Submit for workflow

b) Monitor notification delivery:

• Check notification log immediately after submission
• Expected log entry:

Notification ID: [new ID]
Recipient: test_inspector@company.com
Status: SENT
Timestamp: [current time]

c) Verify email receipt:

• Check test inspector’s email inbox
• Expected delivery time: 1-5 minutes
• Verify email content matches template
• Test worklist link functionality

d) Check worklist task:

• Login as test inspector
• Navigate to BPM Worklist
• Verify task appears with correct details
• Confirm task and worklist are synchronized

7. Troubleshooting Failed Notifications:

If notifications still fail:

a) Enable detailed logging:

• Navigate to: Setup and Maintenance > Manage Diagnostic Logging
• Component: oracle.apps.fnd.workflow.notification
• Log Level: FINEST
• Duration: 1 hour

b) Review detailed logs:

• After triggering test notification
• Download diagnostic logs
• Search for notification ID
• Identify specific failure point

c) Common issues and fixes:

Issue: “Recipient address not verified”

• Fix: Update user profile, set email as primary, save
• Run: Synchronize User Data scheduled process

Issue: “Template not found”

• Fix: Verify template name matches workflow configuration exactly
• Case-sensitive match required

Issue: “SMTP connection failed”

• Fix: Check network connectivity to mail server
• Verify authentication credentials
• Test from same server/network as Fusion instance

Issue: “Notification queued but not sent”

• Fix: Restart notification mailer service
• Check for processing backlog
• Increase concurrent mailer threads if needed

8. Performance Optimization:

For high-volume inspection workflows:

a) Configure bulk notification processing:

• Navigate to: Manage Notification Mailer Parameters
• Batch Size: 50 notifications per batch
• Processing Interval: 2 minutes
• This prevents email server overload

b) Set up notification priorities:

• High Priority: Urgent inspections (immediate send)
• Normal Priority: Standard inspections (5-minute delay acceptable)
• Low Priority: Routine inspections (15-minute delay acceptable)

c) Monitor notification queue:

• Create dashboard showing:
  • Pending notifications count
  • Average delivery time
  • Failed notification rate
• Set alert if queue exceeds 100 pending

9. Preventive Measures:

a) Regular validation:

• Schedule monthly: “User Email Verification Report”
• Identifies users with invalid/missing emails
• Proactive correction before issues arise

b) Onboarding checklist:

• New inspector setup must include:
  • Valid email address in profile
  • Email marked as primary
  • Notification preferences enabled
  • Test notification sent and confirmed

c) Documentation:

• Maintain runbook for notification troubleshooting
• Document all configuration settings
• Include contact info for mail server admin

After implementing these configurations, your quality inspection workflow should reliably deliver email notifications to inspectors when tasks are assigned, while maintaining the tasks in the BPM worklist for tracking and management.

---

This draft is based on general Oracle Fusion Cloud knowledge. It has not been verified against your specific version and environment. Practitioners: verify the steps and share your experience below.

[david_engineer]

First thing to check is whether the notification service is actually running. Navigate to Setup and Maintenance > Manage Workflow Notification Mailers. Verify that the notification mailer is active and the SMTP configuration is correct. Also check the notification log for any error messages related to email delivery failures.

[brendaengineer]

I checked the notification mailer status and it shows as ‘Running’. The SMTP configuration looks correct with our mail server details. However, when I looked at the notification log, I found these entries:

Notification ID: 12345
Recipient: inspector_team@company.com
Status: FAILED
Error: Recipient address not verified

What does ‘Recipient address not verified’ mean? The email address is definitely valid and correct in the user profiles.

Confirmed this resolves the issue — configuring the ‘Assign Inspection Task’ notification activity with Recipient Source set to Task Assignee in Oracle Quality Inspection Workflow triggered inspector emails immediately.

[james_ninja]

That error indicates the workflow notification system can’t validate the recipient’s email address in the user profile. This often happens when the email address in the user profile isn’t marked as the primary contact method or when the user’s notification preferences aren’t configured correctly. Check each inspector’s user profile under ‘Contact Information’ and ensure their email is set as the primary email address and that notification preferences allow workflow emails.

[arjun_builder]

I reviewed several inspector profiles and found that while email addresses are present, the ‘Email Notifications’ preference was set to ‘Disabled’ for most users. I changed this to ‘Enabled’ for a test user, but I’m still not seeing notifications being sent. Are there additional configuration steps needed at the workflow level to enable email notifications? Also, should the email template be configured somewhere?

[akash_builder]

Yes, you need to configure the email template for quality inspection notifications. Go to Setup and Maintenance > Manage Workflow Notification Templates. Look for the ‘Quality Inspection Task Assignment’ template. If it doesn’t exist, you’ll need to create one. The template defines the email subject, body, and which workflow attributes to include. Make sure the template is associated with the correct workflow task type in your quality inspection workflow.

[katherine_guru]

Beyond the template configuration, verify that the notification activity in your workflow is properly configured. In the workflow designer, check the notification activity properties and ensure ‘Send Email Notification’ is set to true. Also verify that the recipient resolution is configured correctly - it should resolve to the task assignee’s email address from their user profile. Sometimes the workflow uses a role-based assignment but doesn’t properly resolve role members to individual email addresses.

I checked the notification mailer status and it shows as ‘Running’.