-
Notifications
You must be signed in to change notification settings - Fork 5
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Update from SAP DITA CMS (squashed):
commit 6f95a084be534b73c36b4175aadd37b824a81f9b Author: REDACTED Date: Mon Jun 17 08:21:42 2024 +0000 Update from SAP DITA CMS 2024-06-17 08:21:42 Project: dita-all/rqs1627049557344 Project map: eeb0d7e6335f4e73b4158bf8f2d82b8c.ditamap Output: loio2fb418ef35ea47f9ad0d99b3ed84b370 Language: en-US Builddable map: 11b78b7d7def4d739976a99060a8b676.ditamap commit 8e681288b9a6745ac1ecb8240beeb48040f8bb96 Author: REDACTED Date: Mon Jun 10 12:57:52 2024 +0000 Update from SAP DITA CMS 2024-06-10 12:57:52 Project: dita-all/rqs1627049557344 Project map: eeb0d7e6335f4e73b4158bf8f2d82b8c.ditamap Output: loio2fb418ef35ea47f9ad0d99b3ed84b370 Language: en-US Builddable map: 11b78b7d7def4d739976a99060a8b676.ditamap commit 60bfb6e65113c744182ef8c8708144b08b46040e Author: REDACTED Date: Mon Jun 10 12:51:44 2024 +0000 Update from SAP DITA CMS 2024-06-10 12:51:44 Project: dita-all/rqs1627049557344 Project map: eeb0d7e6335f4e73b4158bf8f2d82b8c.ditamap Output: loio2fb418ef35ea47f9ad0d99b3ed84b370 Language: en-US Builddable map: 11b78b7d7def4d739976a99060a8b676.ditamap ################################################## [Remaining squash message was removed before commit...]
- Loading branch information
1 parent
43a97a0
commit 2424da6
Showing
34 changed files
with
3,882 additions
and
14 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
57 changes: 57 additions & 0 deletions
57
docs/70-interface-migration/customizing-the-pipeline-concept-aeb106f.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,57 @@ | ||
<!-- loioaeb106f049144c71a0b7814a2ffedc3f --> | ||
|
||
# Customizing the Pipeline Concept | ||
|
||
You can apply the pipeline concept as a template and fit it to your custom needs. For example, implement your own exception handling, or define a different global maximum number of retries. | ||
|
||
Depending on your needs, you can customize the identification of scenarios, the status of ProcessDirect flow, and retry handling. | ||
|
||
|
||
|
||
<a name="loioaeb106f049144c71a0b7814a2ffedc3f__section_dfx_r1f_j1c"/> | ||
|
||
## Identifying a Scenario | ||
|
||
In SAP Process Orchestration, a scenario is uniquely defined via party, sender component, sender interface, namespace, and virtual receiver. In the pipeline concept, a scenario is identified using only sender component and sender interface. Depending on your specific requirements, you can extend the scenario definition. For example, change the partner ID to fetch the Partner Directory information accordingly. | ||
|
||
|
||
|
||
<a name="loioaeb106f049144c71a0b7814a2ffedc3f__section_wzs_t1f_j1c"/> | ||
|
||
## Status of ProcessDirect Integration Flows | ||
|
||
If a scenario-specific integration flow that's called via the ProcessDirect adapter fails, the exception is fetched in an exception subprocess. In this exception subprocess, the custom status is set and the integration flow ends with an error end event. This ensures that the generic integration flow calling the scenario-specific integration flow keeps the message in the inbound queue until it's eventually retried. Furthermore, in the message monitor, the message processing log of the scenario-specific flow turns into status *Failed* with custom status *RetryViaParentFlow*. | ||
|
||
If you prefer the scenario-specific integration flow \(or child flow\) to be set to *Completed* instead of *Failed* because the retry is handled by calling the generic integration flow \(or parent flow\) anyway, you can change the child flow's exception subprocess as follows: | ||
|
||
1. Switch the *error end event* with an *end event*. | ||
|
||
2. Set a header such as `error_occured` with value `true`. The header is then passed to the parent flow, showing that an error occurred in the child flow. | ||
|
||
3. In the parent flow, add a router after the request reply step that checks for the `error_occured` value, and, if `true`, raises an exception. Otherwise, the message in the parent flow isn't retried. | ||
|
||
|
||
For a similar scenario, see [Handle Exceptions in Dependent Integration Flows](https://help.sap.com/docs/integration-suite/sap-integration-suite/handle-exceptions-in-dependent-integration-flows). | ||
|
||
|
||
|
||
<a name="loioaeb106f049144c71a0b7814a2ffedc3f__section_sxr_51f_j1c"/> | ||
|
||
## Retry Handling | ||
|
||
For errors occurring in message processing, you can define a **scenario-specific maximum number of retries**. By default, if no such value is defined in the Partner Directory for the specific scenario, the number of retries is **unlimited**. | ||
|
||
You can change the global setting to any other value by adapting the Groovy script `readRetryHandlingFromPD`. In the following example, the default value is `10`. | ||
|
||
> ### Note: | ||
> Since the header `SAPJMSRetries` is incremented after the retry, you must increment the `maxJMSRetries` by 1 to achieve 10 retries. | ||
``` | ||
// read retry handling from the Partner Directory | ||
def maxJMSRetries = service.getParameter("MaxJMSRetries", Pid , String.class); | ||
// if the value exists in the Partner Directory, create a new header holding the max number of retries incremented by 1 | ||
// otherwise, set the header to default which is 10 | ||
message.setHeader("maxJMSRetries", maxJMSRetries ? maxJMSRetries.toInteger() - 1 : '9'); | ||
``` | ||
|
Binary file added
BIN
+193 KB
.../images/PipelineConcept_Example_of_a_failed_inbound_conversion_flow_55f131c.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added
BIN
+77.7 KB
...Example_of_a_receiver-specific_outbound_processing_integration_flow_b6f6c52.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added
BIN
+74.1 KB
...pelineConcept_Example_of_a_scenario-specific_receiver_determination_d69c366.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added
BIN
+51.6 KB
...-migration/images/PipelineConcept_Example_of_additional_information_0b9e0cc.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added
BIN
+179 KB
...eConcept_Example_where_maximum_number_of_retries_have_been_exceeded_94a1c33.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added
BIN
+115 KB
...gration/images/PipelineConcept_Generic_IDoc_inbound_processing_flow_77ffb5b.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added
BIN
+93.6 KB
...migration/images/PipelineConcept_Generic_XI_inbound_processing_flow_5735fe0.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added
BIN
+135 KB
...c_interface_determination_with_receiver-specific_JMS_outbound_queue_a2d8db1.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added
BIN
+143 KB
...c_receiver_determination_with_extended_receiver_determination_route_3949e7c.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added
BIN
+93 KB
docs/70-interface-migration/images/PipelineConcept_IntegrationFlow1_7bbf018.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added
BIN
+148 KB
docs/70-interface-migration/images/PipelineConcept_IntegrationFlow2_9f3b536.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added
BIN
+70.8 KB
docs/70-interface-migration/images/PipelineConcept_IntegrationFlow3_fbc903f.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added
BIN
+181 KB
docs/70-interface-migration/images/PipelineConcept_IntegrationFlow4_1eec61c.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added
BIN
+151 KB
docs/70-interface-migration/images/PipelineConcept_IntegrationFlow5_bad0522.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added
BIN
+118 KB
docs/70-interface-migration/images/PipelineConcept_IntegrationFlow6_dd21e15.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added
BIN
+76.5 KB
docs/70-interface-migration/images/PipelineConcept_IntegrationFlow7_3a02fda.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added
BIN
+82.3 KB
...ion/images/PipelineConcept_Reprocess_messages_in_dead_letter_queues_13eee24.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added
BIN
+44.1 KB
docs/70-interface-migration/images/PipelineConcept_RetryHandling_99dcda0.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added
BIN
+26.1 KB
.../PipelineConcept_Subprocess_to_call_extended_receiver_determination_035325a.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.