///<summary>Converts any raw email message (encrypted or not) into an EmailMessage object, and saves any email attachments to the emailattach table in the db.
///The emailMessageNum will be used to set EmailMessage.EmailMessageNum. If emailMessageNum is 0, then the EmailMessage will be inserted into the db, otherwise the EmailMessage will be updated in the db.
///If the raw message is encrypted, then will attempt to decrypt. If decryption fails, then the EmailMessage SentOrReceived will be ReceivedEncrypted and the EmailMessage body will be set to the entire contents of the raw email. If decryption succeeds, then EmailMessage SentOrReceived will be set to ReceivedDirect, the EmailMessage body will contain the decrypted body text, and a Direct Ack "processed" message will be sent back to the sender using the email settings from emailAddressReceiver.</summary>
public static EmailMessage ProcessRawEmailMessage(string strRawEmail,long emailMessageNum,EmailAddress emailAddressReceiver) {
//No need to check RemotingRole; no call to db.
Health.Direct.Agent.IncomingMessage inMsg=null;
try {
inMsg=new Health.Direct.Agent.IncomingMessage(strRawEmail);//Used to parse all email (encrypted or not).
}
catch(Exception ex) {
throw new ApplicationException("Failed to parse raw email message.\r\n"+ex.Message);
}
bool isEncrypted=false;
if(inMsg.Message.ContentType.ToLower().Contains("application/pkcs7-mime")) {//The email MIME/body is encrypted (known as S/MIME). Treated as a Direct message.
isEncrypted=true;
}
EmailMessage emailMessage=null;
if(isEncrypted) {
emailMessage=ConvertMessageToEmailMessage(inMsg.Message,false);//Exclude attachments until we decrypt.
emailMessage.RawEmailIn=strRawEmail;//This raw email is encrypted.
emailMessage.EmailMessageNum=emailMessageNum;
emailMessage.SentOrReceived=EmailSentOrReceived.ReceivedEncrypted;
//The entire contents of the email are saved in the emailMessage.BodyText field, so that if decryption fails, the email will still be saved to the db for decryption later if possible.
emailMessage.BodyText=strRawEmail;
emailMessage.RecipientAddress=emailAddressReceiver.EmailUsername.Trim();
try {
Health.Direct.Agent.DirectAgent directAgent=GetDirectAgentForEmailAddress(inMsg.Message.ToValue.Trim());
//throw new ApplicationException("test decryption failure");
inMsg=directAgent.ProcessIncoming(inMsg);//Decrypts, valudates trust, etc.
emailMessage=ConvertMessageToEmailMessage(inMsg.Message,true);//If the message was wrapped, then the To, From, Subject and Date can change after decyption. We also need to create the attachments for the decrypted message.
emailMessage.RawEmailIn=inMsg.SerializeMessage();//Now that we have decrypted, we must get the raw email contents differently (cannot use strRawEmail).
emailMessage.EmailMessageNum=emailMessageNum;
emailMessage.SentOrReceived=EmailSentOrReceived.ReceivedDirect;
emailMessage.RecipientAddress=emailAddressReceiver.EmailUsername.Trim();
}
catch(Exception ex) {
//SentOrReceived will be ReceivedEncrypted, indicating to the calling code that decryption failed.
if(emailMessageNum==0) {
EmailMessages.Insert(emailMessage);
return emailMessage;//If the message was just downloaded, then this function was called from the inbox, simply return the inserted email without an exception (it can be decypted later manually by the user).
}
//Do not update if emailMessageNum<>0, because nothing changed (was encrypted and still is).
throw ex;//Throw an exception if trying to decrypt an email that was already in the database, so the user can see the error message in the UI.
}
}
else {//Unencrypted
emailMessage=ConvertMessageToEmailMessage(inMsg.Message,true);
emailMessage.RawEmailIn=strRawEmail;
emailMessage.EmailMessageNum=emailMessageNum;
emailMessage.SentOrReceived=EmailSentOrReceived.Received;
emailMessage.RecipientAddress=emailAddressReceiver.EmailUsername.Trim();
}
EhrSummaryCcd ehrSummaryCcd=null;
if(isEncrypted) {
for(int i=0;i<emailMessage.Attachments.Count;i++) {
if(Path.GetExtension(emailMessage.Attachments[i].ActualFileName).ToLower()!=".xml") {
continue;
}
string strAttachPath=GetEmailAttachPath();
string strAttachFile=ODFileUtils.CombinePaths(strAttachPath,emailMessage.Attachments[i].ActualFileName);
string strAttachText=File.ReadAllText(strAttachFile);
if(EhrCCD.IsCCD(strAttachText)) {
if(emailMessage.PatNum==0) {
try {
XmlDocument xmlDocCcd=new XmlDocument();
xmlDocCcd.LoadXml(strAttachText);
emailMessage.PatNum=EhrCCD.GetCCDpat(xmlDocCcd);// A match is not guaranteed, which is why we have a button to allow the user to change the patient.
}
catch {
//Invalid XML. Cannot match patient.
}
}
ehrSummaryCcd=new EhrSummaryCcd();
ehrSummaryCcd.ContentSummary=strAttachText;
ehrSummaryCcd.DateSummary=DateTime.Today;
ehrSummaryCcd.EmailAttachNum=i;//Temporary value, so we can locate the FK down below.
ehrSummaryCcd.PatNum=emailMessage.PatNum;
break;//We can only handle one CCD message per email, because we only have one patnum field per email record and the ehrsummaryccd record requires a patnum.
}
}
}
if(emailMessageNum==0) {
EmailMessages.Insert(emailMessage);//Also inserts all of the attachments in emailMessage.Attachments after setting each attachment EmailMessageNum properly.
}
else {
EmailMessages.Update(emailMessage);//Also deletes all previous attachments, then recreates all of the attachments in emailMessage.Attachments after setting each attachment EmailMessageNum properly.
}
if(ehrSummaryCcd!=null) {
ehrSummaryCcd.EmailAttachNum=emailMessage.Attachments[(int)ehrSummaryCcd.EmailAttachNum].EmailAttachNum;
EhrSummaryCcds.Insert(ehrSummaryCcd);
}
if(isEncrypted) {
//Send a Message Disposition Notification (MDN) message to the sender, as required by the Direct messaging specifications.
//The MDN will be attached to the same patient as the incoming message.
SendAckDirect(inMsg,emailAddressReceiver,emailMessage.PatNum);
}
return emailMessage;
}
///<summary>Parses a raw email into a usable object.</summary>
private static Health.Direct.Agent.IncomingMessage RawEmailToIncomingMessage(string strRawEmailIn) {
//No need to check RemotingRole; no call to db.
Health.Direct.Agent.IncomingMessage inMsg=null;
try {
inMsg=new Health.Direct.Agent.IncomingMessage(strRawEmailIn);//Used to parse all email (encrypted or not).
}
catch(Exception ex) {
if(ex.Message=="Error=MissingHeaderValue") {
//The "Welcome to Email" message from GoDaddy has a blank CC field which causes the IncomingMessage() constructor to throw an exception.
//The TO header can be blank because it is not required, since the user could put all destination addresses in either CC or BCC alone. We tested this.
strRawEmailIn=Regex.Replace(strRawEmailIn,@"TO:[ \t]*\r\n","",RegexOptions.IgnoreCase);//Remove the TO header if it is any number of spaces or tabs followed by exactly one newline.
strRawEmailIn=Regex.Replace(strRawEmailIn,@"CC:[ \t]*\r\n","",RegexOptions.IgnoreCase);//Remove the CC header if it is any number of spaces or tabs followed by exactly one newline.
strRawEmailIn=Regex.Replace(strRawEmailIn,@"BCC:[ \t]*\r\n","",RegexOptions.IgnoreCase);//Probably overkill, but does not hurt.
inMsg=new Health.Direct.Agent.IncomingMessage(strRawEmailIn);
}
else {
throw new ApplicationException("Failed to parse raw email message.\r\n"+ex.Message);
}
}
return inMsg;
}
