There could be occasions where an alert and/or email needs to be sent to a Dynamics AX user informing them of something that has taken place in the system that cannot be set up using the standard Dynamics AX alert such as generating an alert while running custom X++ code. To perform this function the following two snippets of code can be utilized to create pop-up alerts and/or email alerts that will be sent by Dynamics AX using the existing alert processing batch jobs.
The following example would send a pop up alert to a user notifying them that a customer record has changed:
static void create_alert( … parms if needed …)
{
EventNotificationSource source;
EventNotification event = EventNotification::construct(EventNotificationSource::Sync);
… Any Tables or variables that may be needed …
CustTable custTable = CustTable::find(’1000′);
;
event.parmRecord(custTable);
event.parmUserId(curuserid()); //this is the user that will receive the alert.
event.parmDataSourceName(‘CustTable’);
event.parmMenuFunction(new MenuFunction(‘CustTable’, MenuItemType::Display)); //this will link to the customer form
event.parmSubject(‘Customer Changed’);
event.parmMessage(‘Customer has changed, please verify’); //This message can be a single str value or you can use strfmt()
event.create();
}
The following code could be used to send an email alert to a user via the Dynamics AX alert system if ANY field in the VendTable is changed:
void generateUpdateAlert()
{
SysOutgoingEmailTable outgoingEmailTable;
SysEmailItemId nextEmailItemId;
Map map;
str SenderName, SenderEmail, To, Subject, Body;
;
SenderName = “System Administrator”;
SenderEmail = “axadmin@contoso.com”;
To = SysUserInfo::find(vendParameters::find().VendAlertUser).Email; //User ID is stored in AP parameters as to who should receive the email
Subject = “Vendor Master Record Changed”;
Body = strfmt(“Vendor %1 – %2 has been changed by %3 ”, this.AccountNum, this.Name, xUserInfo::find(false,SysUserInfo::find().Id).name);
nextEmailItemId = EventInbox::nextEventId();
outgoingEmailTable.EmailItemId = nextEmailItemId;
outgoingEmailTable.IsSystemEmail = NoYes::No;
outgoingEmailTable.Sender = SenderEmail;
outgoingEmailTable.SenderName = SenderName;
outgoingEmailTable.Recipient = To;
outgoingEmailTable.Subject = SysEmailMessage::stringExpand(Subject, map);
outgoingEmailTable.Priority = eMailPriority::Normal ;
outgoingEmailTable.WithRetries = false;
outgoingEmailTable.RetryNum = 0;
outgoingEmailTable.UserId = curUserId();
outgoingEmailTable.Status = SysEmailStatus::Unsent;
outgoingEmailTable.Message = Body;
outgoingEmailTable.LatestStatusChangeDateTime = DateTimeUtil::getSystemDateTime();
outgoingEmailTable.insert();
}
Using these two snippets of code, you can be creative as to how you go about sending alerts. These code snippets can be placed in methods of reports, forms, tables, etc. The possibilities are endless.
The following example would send a pop up alert to a user notifying them that a customer record has changed:
static void create_alert( … parms if needed …)
{
EventNotificationSource source;
EventNotification event = EventNotification::construct(EventNotificationSource::Sync);
… Any Tables or variables that may be needed …
CustTable custTable = CustTable::find(’1000′);
;
event.parmRecord(custTable);
event.parmUserId(curuserid()); //this is the user that will receive the alert.
event.parmDataSourceName(‘CustTable’);
event.parmMenuFunction(new MenuFunction(‘CustTable’, MenuItemType::Display)); //this will link to the customer form
event.parmSubject(‘Customer Changed’);
event.parmMessage(‘Customer has changed, please verify’); //This message can be a single str value or you can use strfmt()
event.create();
}
The following code could be used to send an email alert to a user via the Dynamics AX alert system if ANY field in the VendTable is changed:
void generateUpdateAlert()
{
SysOutgoingEmailTable outgoingEmailTable;
SysEmailItemId nextEmailItemId;
Map map;
str SenderName, SenderEmail, To, Subject, Body;
;
SenderName = “System Administrator”;
SenderEmail = “axadmin@contoso.com”;
To = SysUserInfo::find(vendParameters::find().VendAlertUser).Email; //User ID is stored in AP parameters as to who should receive the email
Subject = “Vendor Master Record Changed”;
Body = strfmt(“Vendor %1 – %2 has been changed by %3 ”, this.AccountNum, this.Name, xUserInfo::find(false,SysUserInfo::find().Id).name);
nextEmailItemId = EventInbox::nextEventId();
outgoingEmailTable.EmailItemId = nextEmailItemId;
outgoingEmailTable.IsSystemEmail = NoYes::No;
outgoingEmailTable.Sender = SenderEmail;
outgoingEmailTable.SenderName = SenderName;
outgoingEmailTable.Recipient = To;
outgoingEmailTable.Subject = SysEmailMessage::stringExpand(Subject, map);
outgoingEmailTable.Priority = eMailPriority::Normal ;
outgoingEmailTable.WithRetries = false;
outgoingEmailTable.RetryNum = 0;
outgoingEmailTable.UserId = curUserId();
outgoingEmailTable.Status = SysEmailStatus::Unsent;
outgoingEmailTable.Message = Body;
outgoingEmailTable.LatestStatusChangeDateTime = DateTimeUtil::getSystemDateTime();
outgoingEmailTable.insert();
}
Using these two snippets of code, you can be creative as to how you go about sending alerts. These code snippets can be placed in methods of reports, forms, tables, etc. The possibilities are endless.