Notifications Are Failing to Send to Users with The Error 'Unable to Convert The Subject to Text for Notification 'Notification_name''

[KB-Sync1]

Article Number

000016997

Applies To

Product(s): Archer
Version(s): All Versions
Primary Deployment: On Premises/AWS Hosted/AWS SaaS

---

Description

Notifications are failing to send to users with the below errors in the ArcherTech.JobFramework logs:

<ApplicationData>
<TraceData>
<DataItem>
<TraceRecord Severity="Error" xmlns="http://schemas.microsoft.com/2004/10/E2ETraceEvent/TraceRecord">
<TraceIdentifier>ArcherTech.JobFramework</TraceIdentifier>
<Description>Unable to convert the subject to text, for notification 'NOTIFICATION NAME'</Description>
<AppDomain>ArcherTech.JobFramework.Job.exe</AppDomain>
<Exception>
<ExceptionType>System.InvalidOperationException, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089</ExceptionType>
<Message>Unable to convert the subject to text, for notification 'NOTIFICATION NAME'</Message>
<Source>ArcherTech.Notifications</Source>
<StackTrace> at ArcherTech.Notifications.xslt.NotificationXslExtensions.ConvertSubjectToText(Notification notification)
at ArcherTech.Notifications.Workflow.SendNotification.BucketsHelper.CreateEmailMessageWithoutRecipients(Notification notification, NotificationXslExtensions xslExtensions, Int32 fromAddressUserId)
at ArcherTech.Notifications.Workflow.SendNotification.BucketsHelper.BuildBucketsForRecipientsByRenderSettingsGroup(KeyValuePair`2 recipientsByRenderSettingsGroup, Int32 fromAddressUserId, NotificationXslExtensions xslExtensions, Notification notification)
at ArcherTech.Notifications.Workflow.SendNotification.BucketsHelper.BuildBucketsForRecipientsByRenderSettingsGroups(IEnumerable`1 recipientsByRenderSettingsGroups, Int32 fromAddressUserId, NotificationXslExtensions xslExtensions, Notification notification)
at ArcherTech.Notifications.Workflow.SendNotification.BucketsHelper.BuildSingleContentBuckets(IDictionary`2 recipientsByMultipleContentRenderSettingsGroups, Int32 fromAddressUserId, NotificationXslExtensions xslExtensions, Notification notification)
at ArcherTech.Notifications.Workflow.SendNotification.SendNotificationJobHandler.ProcessJob()
at ArcherTech.Notifications.Workflow.SendNotification.SendNotificationJob.RunWorkflow_ExecuteCode(Object sender, EventArgs e)
at System.Workflow.ComponentModel.Activity.RaiseEvent(DependencyProperty dependencyEvent, Object sender, EventArgs e)
at System.Workflow.Activities.CodeActivity.Execute(ActivityExecutionContext executionContext)
at System.Workflow.ComponentModel.ActivityExecutor`1.Execute(T activity, ActivityExecutionContext executionContext)
at System.Workflow.ComponentModel.ActivityExecutorOperation.Run(IWorkflowCoreRuntime workflowCoreRuntime)
at System.Workflow.Runtime.Scheduler.Run()</StackTrace>
<InnerException>
<ExceptionType>System.ArgumentNullException, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089</ExceptionType>
<Message>Value cannot be null. Parameter name: source</Message>
<Source>System.Core</Source>
<StackTrace> at System.Linq.Enumerable.FirstOrDefault[TSource](IEnumerable`1 source)
at ArcherTech.Notifications.ContentRender.GetFieldRaw(Int32 fieldId)
at ArcherTech.Notifications.Rendering.RenderEngine.GetFieldRaw(Int32 contentId, Int32 fieldId)
at ArcherTech.Notifications.Providers.Value.ArcherContentNotificationValueProvider.GetPlainTextReplacement(String objectId, ValuePlaceholder valuePlaceholder)
at ArcherTech.Notifications.xslt.NotificationXslExtensions.&lt;&gt;c__DisplayClass12.&lt;ConvertSubject&gt;b__11(Match match)
at System.Text.RegularExpressions.RegexReplacement.Replace(MatchEvaluator evaluator, Regex regex, String input, Int32 count, Int32 startat)
at System.Text.RegularExpressions.Regex.Replace(String input, MatchEvaluator evaluator)
at ArcherTech.Notifications.xslt.NotificationXslExtensions.ConvertSubject(Subject subject, String objectId)
at ArcherTech.Notifications.xslt.NotificationXslExtensions.ConvertSubjectToText(Notification notification)</StackTrace>
</InnerException>
</Exception>
</TraceRecord>
</DataItem>
</TraceData>
</ApplicationData>

Cause

One or more of the users assigned under the Notification's Recipients do not have access to a field used within the Application used in the Subject line. This causes the Notification to fail.
Note: This is one of many causes that can prevent Notifications from being received by end users. Use this KB for other potential issues.

Resolution

Ensure the following:

1. The user (Or the user's group) is assigned an Access Role that has at least the Read access to the application's content.
2. The user's permission to read the content associated with the notification, this is limited by Record Permissions fields. If there are any Record Permissions fields in the application, the user (or the user's group) must be selected in any of these fields for that specific record; otherwise, the user will not receive the notification.
3. The user's (or the user's group's) access to any Private field that is set to be displayed in the notification's content. If there is a private field that the user does not have access to, this will only limit the visibility of this field (not the entire record).