Using Error Notifications 15-5
AggrCountTot field is reached, the count is reset to 0 and another error notification email is issued.
The date and time values used to track the time interval are derived from the database. The date and time displayed in the fields are derived from your
browser time. Hover over the field values to view the database time.
For more information about the options on the Error Notifications page, see Section 14.5, How to Set Up AIA Error Handling Configuration Details.
15.3 Customizing Error Notification Emails
This section includes the following topics:
■
Section 15.3.1, Introduction to Error Notification Customization
■
Section 15.3.2, How to Customize the Subject Line of Error Notification Emails
■
Section 15.3.3, How to Customize the Body Text of Error Notification Emails
■
Section 15.3.4, How to Customize Additional URLs Provided in Error Notification Email Body Text
15.3.1 Introduction to Error Notification Customization
You can customize the subject line and body text of emails issued by error notification functionality by editing the AIAEHNotifications.xml file located in AIA_
HOMEaia_instancesINSTANCE_NAMEAIAMetaDataconfig. The text of the file is shown in
Example 15–1 .
Example 15–1 AIAEHNotifications.xml
?xml version=1.0 encoding=UTF-8? AIAEHNotification xmlns=http:schemas.oracle.comaianotify version=1.0
EMAIL SUBJECTError in AIAXPATH.{default:Faultdefault:FaultNotificationdefault:
FaultingServicedefault:ID}ProcessSUBJECT BODYAn error has occurred during the processing of AIA Integration Error in AIAXPATH.
{default:Faultdefault:FaultNotificationdefault:FaultingServicedefault:ID} Process requires your attention. Please access the details from the url mentioned below.BODY
EMAIL FYI_EMAIL
SUBJECTError in AIAXPATH.{default:Faultdefault:FaultNotificationdefault: FaultingServicedefault:ID} Process FYISUBJECT
BODYAn error has occurred during the processing of AIA Integration Error in AIAXPATH. {default:Faultdefault:FaultNotificationdefault:FaultingServicedefault:ID}
Process requires your attention. Please access the details from the url mentioned below.BODY
FYI_EMAIL URL
================================================================================= Please click on the following URL To view the instance details in the em console :
================================================================================= http:adminHost:adminPortemfacesaisoamessageFlow?target=Farm_domainName
domainNametargetServerPROPS.{compositeName}+[PROPS.{composite Revision}]26type=oracle_soa_composite26soaContext=PROPS.{compositeDN}PROPS.
{compositeInstanceID}
Note: These customizations will apply to all emails issued by error
notification functionality.
15-6 Infrastructure Components and Utilities Users Guide
================================================================================= URL
EXT_URL ============================================================
Please access the task in the Worklist Application : ==============================================================
http:managedHost:managedPortintegrationworklistappfaceshome.jspx ==============================================================
EXT_URL AIAEHNotification
All elements can be customized. All elements shown are required for error notifications to work as designed, even if you choose to leave some of them blank.
15.3.1.1 EMAIL Element
Example 15–2 is an example of how you can customize the EMAIL element in
AIAEHNotifications.xml to provide content that appears in error notification emails to Actor roles.
Example 15–2 EMAIL Element in AIAEHNotifications.xml
EMAIL SUBJECTError in AIA XPATH.{default:Faultdefault:FaultNotification
default:FaultingServicedefault:ID}Process SUBJECT
BODYAn error has occurred during the processing of AIA Integration Error in AIAXPATH.{default:Faultdefault:FaultNotificationdefault:Faulting
Servicedefault:ID}Process requires your attention. Please access the details from the url mentioned below.
BODY EMAIL
The SUBJECT element provides the subject line of the error notification email. As delivered, the subject line is set to reference the ID of the service that experienced the
error.
The BODY element provides the body text of the error notification email. As delivered, the body text is set to reference the ID of the service that experienced the error.
15.3.1.2 FYI_EMAIL Element
Example 15–3 is an example of how you can customize the FYI_EMAIL element in
AIAEHNotifications.xml to provide content that appears in error notification emails to FYI roles.
Example 15–3 FYI_EMAIL Element in AIAEHNotifications.xml
FYI_EMAIL SUBJECTError in AIA XPATH.{default:Faultdefault:FaultNotification
default:FaultingServicedefault:ID}Process FYI SUBJECT
BODYAn error has occurred during the processing of AIA Integration Error in AIA XPATH.{default:Faultdefault:FaultNotificationdefault:Faulting
Servicedefault:ID}Process requires your attention. Please access the details from the url mentioned below.
BODY FYI_EMAIL
Using Error Notifications 15-7
The SUBJECT element provides the subject line of the error notification email. As delivered, the subject line is set to reference the ID of the service that experienced the
error.
The BODY element provides the body text of the error notification email. As delivered, the body text is set to reference the ID of the service that experienced the error.
15.3.1.3 URL Element
As delivered, the URL element in AIAEHNotification.xml is used to provide a link to the composite instance flow trace details in the Oracle Enterprise Manager Console for
your AIA implementation. You can customize this element to suit your implementation needs.
hostname, adminport, and domain tokens shown in Example 15–4
are populated with implementation-specific values by the Oracle AIA Installer upon
installation of Foundation Pack.
Example 15–4 URL Element in AIAEHNotification.xml
URL ============================================================================
Please click on the following URL to view instancedetails in the em console: ============================================================================
http:adminHost:adminPortemfacesaisoamessageFlow?target=Farm_ domainNamedomainNametargetServerPROPS.{compositeName}
+[PROPS.{composite Revision}]26type=oracle_soa_ composite26soaContext=PROPS.{compositeDN}PROPS.{composite
InstanceID} ==============================================================================
URL
15.3.1.4 EXT_URL Element
As delivered, the EXT_URL external system URL element in AIAEHNotifications.xml is used to provide a link to the Oracle BPM Worklist application, where, if enabled for
AIA, the user can view their assigned AIA error-related tasks. You can customize this element to suit your implementation s needs.
hostname and port tokens shown in Example 15–5
are populated with implementation-specific values by the Oracle AIA Installer upon installation of
Foundation Pack.
Example 15–5 EXT_URL Element in AIAEHNotifications.xml
EXT_URL ==============================================================
Please access the task in the Worklist Application : ==============================================================
http:managedHost:managedPortintegrationworklistappfaceshome.jspx ==============================================================
EXT_URL
For more information about enabling Oracle BPM Worklist functionality, see Section 16.2, How to Enable the Oracle BPM Worklist.
15-8 Infrastructure Components and Utilities Users Guide
15.3.2 How to Customize the Subject Line of Error Notification Emails
