{"id":1740,"date":"2010-08-10T10:36:15","date_gmt":"2010-08-10T15:36:15","guid":{"rendered":"http:\/\/jianmingli.com\/wp\/?p=1740"},"modified":"2012-02-08T12:13:42","modified_gmt":"2012-02-08T17:13:42","slug":"oracle-bpel-fault-policies","status":"publish","type":"post","link":"https:\/\/jianmingli.com\/wp\/?p=1740","title":{"rendered":"Oracle BPEL Fault Policies"},"content":{"rendered":"

* See this post<\/a> for SOA 11g<\/em> fault policy framework.<\/p>\n

Fault Policy Overview<\/h2><\/span>\n

* Since 10.1.3.3
\n* Catches all<\/strong> faults from an invoke activity (both run time and business faults)
\n* Important:<\/strong> overrides all catch<\/strong> activities in BPEL process.
\n* A fault policy defines conditions and their corresponding fault recovery actions.
\n* Fault policies are defined in multiple files under directory:
\n– bpel\\domains\\default\\config\\fault-policies
\n* XSD files are:
\n– bpel\\system\\xmllib\\fault-policy.xsd
\n– bpel\\system\\xmllib\\fault-policy-binding.xsd
\n* A fault policy can be associated at the following levels:
\n– Partner link
\n– Port type
\n– Process level via bpel.xml
\n– Domain level via fault-bindings.xml
\n* Fault policy binding order:
\n-> bpel.xml: partner link -> port type -> process
\n-> domain: partner link -> port type -> process
\n-> Catch blocks defined in bpel diagram.<\/p>\n

SOA Fault Types<\/h2><\/span>\n

Business Faults<\/h3><\/span>\n

* Programmer defined.
\n* Defined in WSDL.<\/p>\n

Runtime Faults<\/h3><\/span>\n

* Predefined, e.g.
\n– remoteFault
\n– bindingFault
\n* Infrastructure faults, e.g.
\n– Service down
\n– Network outage
\n* Data format errors<\/p>\n

Design a Fault Policy<\/h2><\/span>\n

Create a Fault Policy File<\/h3><\/span>\n

* Create policy file (e.g. my-policies.xml) in bpel\\domains\\domain_name\\config\\fault-policies directory<\/p>\n

<\/a><\/p>\n

Define conditions<\/h4><\/span>\n

* Conditions are based on faultName. e.g.<\/p>\n

\r\n\r\n<\/pre>\n
* Multiple conditions are allowed for a single faultName
\n– if so, conditions are evaluated sequentially<\/p>\n
\r\n  \r\n    $fault.code\/code=\"WSDLReadingError\"<\/test>\r\n    \r\n  <\/condition>\r\n  \r\n    \r\n  <\/condition>\r\n<\/pre>\n
* Each condition has
\n– one test section which is an XPath expression against fault variable<\/p>\n
\r\n    $fault.code\/code=\"WSDLReadingError\"<\/test>\r\n<\/pre>\n
– one action section which references to the action defined in the same file<\/p>\n
\r\n    \r\n<\/pre>\n
– No test condition catches all<\/p>\n
\r\n\r\n  \r\n<\/condition>\r\n<\/pre>\n
– No faultName catches all faults <\/p>\n
\r\n . . . <\/faultName>\r\n<\/pre>\n
<\/a><\/p>\n
Define actions<\/h4><\/span>\n
* See examples below.<\/p>\n
Fault Policy Examples<\/h3><\/span>\n
* Conditions<\/p>\n
\r\n\r\n  \r\n  \r\n    \r\n      \r\n    <\/condition>\r\n  <\/faultName>\r\n  \r\n  \r\n  \r\n    \r\n      \r\n    <\/condition>\r\n  <\/faultName>\r\n<\/Conditions>\r\n<\/pre>\n
* Actions<\/p>\n
\r\n\r\n\r\n  \r\n    8<\/retryCount>\r\n    2<\/retryInterval>\r\n    \r\n    \r\n  <\/retry>\r\n<\/Action>\r\n\r\n\r\n\r\n  \r\n<\/Action>\r\n\r\n\r\n\r\n  \r\n<\/Action>\r\n\r\n\r\n\r\n  \r\n<\/Action>\r\n\r\n\r\n\r\n  \r\n<\/Action>\r\n\r\n\r\n\r\n  \r\n    \r\n    \r\n  <\/javaAction>\r\n<\/Action><\/pre>\n
– Java class must implement IFaultRecoveryJavaClass interface<\/p>\n
\r\npublic interface IFaultRecoveryJavaClass {\r\n  public void handleRetrySuccess(IFaultRecoveryContext ctx );\r\n  public String handleBPELFault(IFaultRecoveryContext ctx );\r\n}<\/pre>\n
Associate a Fault Policy<\/h2><\/span>\n
* Process level
\n– Configured in bpel.xml file.
\n– Only one fault policy can be bound to a process, port type, or partner link.
\n– Multiple port types or partner links can be bound to a single fault policy.<\/p>\n
\r\n\r\n  \r\n  \r\n  \r\n\r\n  \r\n      \r\n      UnitedLoanService<\/name>\r\n      StarLoanService<\/name>\r\n\r\n    \r\n    credit:CreditRatingService<\/portType>\r\n    \r\n    united:UnitedLoanService<\/portType>\r\n  <\/partnerLink>\r\n\r\n  \r\n    \r\n    AnotherPartnerLink<\/name>\r\n  <\/partnerLink>\r\n<\/faultPolicyBindings>\r\n<\/pre>\n
* Domain level
\n– Configured in OracleAS_2\\bpel\\domains\\default\\config\\fault-bindings.xml file.<\/p>\n
\r\n  \r\n  \r\n<\/pre>\n
\r\n  \r\n    \r\n    creditRatingService<\/name>\r\n  <\/partnerLink>\r\n<\/pre>\n
\r\n  \r\n    \r\n    db:insert_plt<\/portType>\r\n  <\/partnerLink>\r\n<\/pre>\n
Human Intervention in Oracle BPEL Control<\/h2><\/span>\n
* Login BPEL console
\n* Click Activities tab
\n* Seach activities based on states
\n– All States: Displays all activities, regardless of their state.
\n– Open: Displays only open activities.
\n– Completed: Displays only completed activities.
\n– Cancelled: Displays only cancelled activities.
\n– Stale: Displays only stale activities.
\n– Pending: Displays only pending activities.
\n* Click the faulted activity
\n* Optionally change the variable values
\n* Select action to take
\n– Retry: Retries the activity with an option to provide a retry success action.
\n– Abort: Terminates the process instance of the faulted activity.
\n– Rethrow: Rethrows the exception and allows the BPEL fault handlers (catch branches) to handle the fault.
\n– Replay: Replays the scope in which the fault occurred.
\n– Continue: Skips the activity. The framework assumes the activity completed with no fault.
\n* Click the Recover button.<\/p>\n
References<\/h2><\/span>\n
* Fault Management Framework<\/a><\/del>
\n* http:\/\/www.oracle.com\/technology\/tech\/soa\/cab\/OracleSOACabWebinar03-25-08SOAExceptions.pdf<\/a><\/del>
\n* Oracle BPEL 10.1.3.3 Fault Policy Management<\/a><\/del><\/p>\n","protected":false},"excerpt":{"rendered":"
* See this post for SOA 11g fault policy framework. Fault Policy Overview * Since 10.1.3.3 * Catches all faults from an invoke activity (both run time and business faults) * Important: overrides all catch activities in BPEL process. * … Continue reading →<\/span><\/a><\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_exactmetrics_skip_tracking":false,"_exactmetrics_sitenote_active":false,"_exactmetrics_sitenote_note":"","_exactmetrics_sitenote_category":0,"jetpack_post_was_ever_published":false,"_jetpack_newsletter_access":"","_jetpack_dont_email_post_to_subs":false,"_jetpack_newsletter_tier_id":0,"_jetpack_memberships_contains_paywalled_content":false,"_jetpack_memberships_contains_paid_content":false,"footnotes":"","jetpack_publicize_message":"","jetpack_publicize_feature_enabled":true,"jetpack_social_post_already_shared":false,"jetpack_social_options":{"image_generator_settings":{"template":"highway","default_image_id":0,"font":"","enabled":false},"version":2}},"categories":[72,69],"tags":[],"class_list":["post-1740","post","type-post","status-publish","format-standard","hentry","category-bpel","category-oc4j"],"jetpack_publicize_connections":[],"jetpack_featured_media_url":"","jetpack_sharing_enabled":true,"jetpack_shortlink":"https:\/\/wp.me\/p8cRUO-s4","_links":{"self":[{"href":"https:\/\/jianmingli.com\/wp\/index.php?rest_route=\/wp\/v2\/posts\/1740","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/jianmingli.com\/wp\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/jianmingli.com\/wp\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/jianmingli.com\/wp\/index.php?rest_route=\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/jianmingli.com\/wp\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=1740"}],"version-history":[{"count":10,"href":"https:\/\/jianmingli.com\/wp\/index.php?rest_route=\/wp\/v2\/posts\/1740\/revisions"}],"predecessor-version":[{"id":4249,"href":"https:\/\/jianmingli.com\/wp\/index.php?rest_route=\/wp\/v2\/posts\/1740\/revisions\/4249"}],"wp:attachment":[{"href":"https:\/\/jianmingli.com\/wp\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=1740"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/jianmingli.com\/wp\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=1740"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/jianmingli.com\/wp\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=1740"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}