Abstract :  This article aims at providing the detailed steps and information on why FileGatewayEventEmailNotification BP fails to send the email notifications when preferred language is set to non-english locale and the solution to overcome the problem.

NOTE:- In writing this article, all the configurations and tests were carried out on 5020500 version of SI.

Brief description of the problem occurrence :-

1. Login to myfilegateway UI with the any desired partner credentials.

2. Navigate to Profile menu and enable email notifications for any of the the event codes. In writing this article the even code of FG_0550 has been selected.

3. Set the preferred language to per say ‘Traditional Chinese’ and save the language.             

 
4. Route the file that results in FG_0550 event to be generated.                  

5. In SI UI check for the FilegatewayEmailEventNotification BP that results in failure.                   

The issue of FileGatewayEmailEventNotification BP failing at Mail Mime Service with the below exception in the wf.log files was resolved in SI version 525 via the RTC#184381/APAR#IC86843 and the fix was released in SI 525.

[2015-12-02 04:20:05.929] ERROR [1449048005929] Mail Mime Service fails to execute ...
 com.sterlingcommerce.woodstock.workflow.WorkFlowException: Failed to write the message into the Document OutputStream.
                         
[2015-12-02 04:20:05.949] ERRORDTL [1449048005929]com.sterlingcommerce.woodstock.workflow.WorkFlowException: Mail Mime Service fails to execute ...
com.sterlingcommerce.woodstock.workflow.WorkFlowException: Failed to write the message into the Document OutputStream.
at com.sterlingcommerce.woodstock.services.mailmime.MailMimeService.processData(MailMimeService.java:87)

It is to be noted that the defect fix of RTC#184381/APAR#IC86843 has introduced 4 other regressions in the product.
In order to eliminate the regression introduced by the fix of this issue is made parameter driven.


Fixing the current issue :-

Add the parameter 'base64encode' set to true to the out of box BP FileGatewayEventEmailNotification in the MailMimeService so that the Traditional Chinese contents will be encoded in base64 and that the BP will not fail to send the email contents in Traditional Chinese locale. Make this version of the BP as the default version.

       Example is as shown below :-

                <operation name="Mail Mime Service">
                       <participant name="MailMimeService"/>
                       <output message="MailMimeServiceInputMessage">
                                  <assign to="mail-mime-body">true</assign>
                                  <assign to="mail-mime-operation">build</assign>
                                  <assign to="mail-mime-subject" from="Evf/EmailSubject/text()" />
                                  <assign to="mail-mime-subject-encoding">UTF-8</assign>
                                  <assign to="mail-mime-recipient" from="Evf/EmailRecipient/text()"/>
                                  <assign to="mail-mime-sender" from="Evf/EmailSender/text()"/>
                                  <assign to="base64Encode">true</assign>
                                  <assign to="parse">false</assign>        
                                  <assign to="." from="*"></assign>
                         </output>
                         <input message="inmsg">
                                  <assign to="." from="*"></assign>
                          </input>
                     </operation>

Once the BP is modified and saved as the default version, route a file again when logged into myfilegateway that generated a FG_550 event code.

In SI UI search for the FilegatewayEmailEventNotification BP and see to that the BP has passed successfully.                   

Now check for the contents of the received mail which will be in traditional chinese locale.