Skip to content

Commit

Permalink
Sap aem int day 4 (#298)
Browse files Browse the repository at this point in the history
* Initial version of SAP AEM Integration - day 4

* Add files via upload

* Update sap-aem-int-day-4.md

* updated codelabs folder

* Update sap-aem-int-day-4.md

* Add files via upload

* Update sap-aem-int-day-4.md

* updated exported codelabs

* updated exported codelabs

* Update sap-aem-int-day-4.md

* Add files via upload

* Update sap-aem-int-day-4.md

* Add files via upload

* Update sap-aem-int-day-4.md

* Add files via upload

* Add files via upload

* updated files

* Update sap-aem-int-day-4.md

* Add files via upload

* Update sap-aem-int-day-4.md

* Update sap-aem-int-day-4.md

* Add files via upload

* Update sap-aem-int-day-4.md

* Updated codelabs based on Scott's changes

* Update sap-aem-int-day-4.md

* Add files via upload

* Update sap-aem-int-day-4.md

* Add files via upload

* Updated codelabs with latest content

* Update sap-aem-int-day-4.md

* Add files via upload

* Add files via upload

* Update sap-aem-int-day-4.md

* Update sap-aem-int-day-4.md

* Add files via upload

* Update sap-aem-int-day-4.md

* Updated codelabs based on Scott's changes

* Update sap-aem-int-day-4.md

* Updated codelabs based on Scott's changes

* Updated codelabs for SAP AEM INT-Day-4 to include Neha's changes

* Updated codelabs for SAP AEM INT-Day-4 to include Neha's changes

* Updated codelabs for SAP AEM INT-Day-4 to include Neha's changes

* Add files via upload

* Update sap-aem-int-day-4.md

* Add files via upload

* Add files via upload

* Update sap-aem-int-day-4.md

* Updated codelabs SAP AEM INT-Day-4 to include Scott's changes

* Add files via upload

* Updating Day-4 with Master (#296)

* Sap aem int day 4 (#286)

* Initial version of SAP AEM Integration - day 4

* Add files via upload

* Update sap-aem-int-day-4.md

* updated codelabs folder

* Update sap-aem-int-day-4.md

* Add files via upload

* Update sap-aem-int-day-4.md

* updated exported codelabs

* updated exported codelabs

* Update sap-aem-int-day-4.md

* Add files via upload

* Update sap-aem-int-day-4.md

* Add files via upload

* Update sap-aem-int-day-4.md

* Add files via upload

* Add files via upload

* updated files

* Update sap-aem-int-day-4.md

* Add files via upload

* Update sap-aem-int-day-4.md

* Update sap-aem-int-day-4.md

* Add files via upload

* Update sap-aem-int-day-4.md

* Updated codelabs based on Scott's changes

* Update sap-aem-int-day-4.md

* Add files via upload

* Update sap-aem-int-day-4.md

* Add files via upload

* Updated codelabs with latest content

* Update sap-aem-int-day-4.md

* Add files via upload

* Add files via upload

* Update sap-aem-int-day-4.md

* Update sap-aem-int-day-4.md

* Add files via upload

* Update sap-aem-int-day-4.md

* Updated codelabs based on Scott's changes

* Update sap-aem-int-day-4.md

* Updated codelabs based on Scott's changes

* Updated codelabs for SAP AEM INT-Day-4 to include Neha's changes

* Updated codelabs for SAP AEM INT-Day-4 to include Neha's changes

* Updated codelabs for SAP AEM INT-Day-4 to include Neha's changes

* Add files via upload

* Update sap-aem-int-day-4.md

* Add files via upload

* Add files via upload

* Update sap-aem-int-day-4.md

* Updated codelabs SAP AEM INT-Day-4 to include Scott's changes

---------

Co-authored-by: HariRangarajan-Solace <[email protected]>
Co-authored-by: ScottDillonSol <[email protected]>
Co-authored-by: Tamimi Ahmad <[email protected]>

* minor modification (#287)

* update dt codelab (#288)

* update github user on main

* update dt codelab steps (#289)

* test git config users

* remove test file

* update workflow

* update dt codelab (#290)

* update PAT

* update dt codelab (#291)

* Adding  dt-otel html files

* update wokrflow

* minor update (#292)

* Adding  dt-otel html files

* Adding a test file

* update workflow file

* update workflow file

* Minor modifications to the DT codelab (#293)

* update secrets in workflow

* minor modification (#294)

* Adding  dt-otel html files

* Update netlify Badge

Update netlify Badge

* fix broken links

* Adding  boomi-v2-getting-started html files

* Remove export scripts. Not needed anymore

* Sap aem int day 1 (#295)

* Initial version of SAP AEM Integration - day 1

* Update sap-aem-int-day-1.md

* Updated day-1 for intro/takeaways

* fixed takeaway step formatting

* updated takeaways step codelab folder

* Finalized Day-1 codelab

* Removed steps setting cluster and vpn name

Removed steps setting cluster and vpn name as this is causing issues with Mesh Manager.

* SAP AEM Integration workshop - Day 3 (#264)

* Initial version of SAP AEM Integration - day 3

* Populating content for 3rd day

Populating content for 3rd day, prereqs mostly done, AEM configuration done, importing iflows done, configuring and deploying iflows in progress

* Populating codelab for day 3 - configuration steps

Added more steps for setting up Integration Suite with security credentials etc.

* Adjusted time estimates

Adjusted time estimates

* Added Overall Duration estimate

Added Overall Duration estimate

* Finished AEMBusinessPartnerAddressCheck

Finished description and configuration and deployment steps for AEMBusinessPartnerAddressCheck iflow.

* fixed typos and formatting

fixed typos and formatting

* Added configuration and deployment for 2 more flows

Added configuration and deployment for 2 more flows

* Added more details on the LegacyOutputAdapter

Added more details on the LegacyOutputAdapter

* Finished basic description of event flows

Finished basic description of event flows

* Finished describing AEM related settings and processing steps

Finished describing AEM related settings and processing steps

* Added takeaways

Added takeaways

* Fixed formatting

Fixed formatting

* Updated day-3 codelab

---------

Co-authored-by: HariRangarajan-Solace <[email protected]>
Co-authored-by: Christian <[email protected]>

* SAP AEM Integration workshop - Day 2 (#263)

* Initial version of SAP AEM Integration - day 2

* Initial version of SAP AEM Integration - day 2

* Update sap-aem-int-day-2.md

* updated codelabs folder

* Add files via upload

* Add files via upload

* Updated Day-2 codelab with final changes

---------

Co-authored-by: HariRangarajan-Solace <[email protected]>
Co-authored-by: bradcaldwell88 <[email protected]>

* Updated codelabs for SAP AEM INT - Day 1

* Updated codelabs for SAP AEM INT - Day 1

* Updated codelabs for SAP AEM INT - Day 1 to fix cluster names

* Updated codelabs SAP AEM INT-Day-1 to fix the CF push command.

---------

Co-authored-by: HariRangarajan-Solace <[email protected]>
Co-authored-by: Christian <[email protected]>
Co-authored-by: bradcaldwell88 <[email protected]>

* Adding  sap-aem-int-day-1 html files

---------

Co-authored-by: HariRangarajan-Solace <[email protected]>
Co-authored-by: ScottDillonSol <[email protected]>
Co-authored-by: Tamimi Ahmad <[email protected]>
Co-authored-by: Tamimi <[email protected]>
Co-authored-by: solacecommunity-bot <[email protected]>
Co-authored-by: Christian <[email protected]>
Co-authored-by: bradcaldwell88 <[email protected]>

* Update sap-aem-int-day-4.md

* Add files via upload

* Add files via upload

* Add files via upload

* Update sap-aem-int-day-4.md

* Add files via upload

* Update sap-aem-int-day-4.md

* Update sap-aem-int-day-4.md

---------

Co-authored-by: HariRangarajan-Solace <[email protected]>
Co-authored-by: ScottDillonSol <[email protected]>
Co-authored-by: Tamimi Ahmad <[email protected]>
Co-authored-by: Tamimi <[email protected]>
Co-authored-by: solacecommunity-bot <[email protected]>
Co-authored-by: Christian <[email protected]>
Co-authored-by: bradcaldwell88 <[email protected]>
  • Loading branch information
8 people authored Dec 7, 2023
1 parent 8bc8170 commit aaa6248
Show file tree
Hide file tree
Showing 7 changed files with 18 additions and 14 deletions.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
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 markdown/sap-aem-int-day-4/img/BPA_LOBBY.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
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 markdown/sap-aem-int-day-4/img/BPA_monitor.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 modified markdown/sap-aem-int-day-4/img/SPA-BPA-11.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
32 changes: 18 additions & 14 deletions markdown/sap-aem-int-day-4/sap-aem-int-day-4.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,11 +26,11 @@ Topics covered :

## Using SAP BPA to handle event exceptions

In the world of Event Driven Asynchronous messaging, sometimes events cannot be successfully processed by a consumer and as a result, they need to be dealt with on an exception basis. As a result, there is built in capability within the broker referred to a Dead Messages Queue. Essentially, messages can be placed into a special queue where they can later be reviewed and properly dealt with. Should you wish to read more on the concept of Dead Message Queues, please refer to the following link.
In the world of Event Driven Asynchronous messaging, sometimes events cannot be successfully processed by a consumer and as a result, they need to be dealt with on an exception basis. As a result, there is built in capability within the broker referred to as a Dead Messages Queue. Essentially, messages can be placed into a special queue where they can later be reviewed and properly dealt with. Should you wish to read more on the concept of Dead Message Queues, please refer to the following link.

[Link to Blog](https://solace.com/blog/pubsub-message-handling-features-dead-message-queues/)

In our scenario, we will artificially create a situation where messages cannot be delivered to the endpoint. As a result, they end up in the Dead Message Queue and the application shown below has an integration card on it called "Dead Message Queue". This card is a very simple Queue browser. It displays the messages without removing them from the Queue unless you hit the submit button. Hitting the submit button will release the message from the Queue and it will be sent to the broker with a special topic. A special topic that will result in the message being placed into a Queue that is being actively monitored by Cloud Integration. The message will be transformed by Cloud Integration and the message will be placed back into the mesh. The broker will act upon this new message and instantiate a new business process for each message.
In our scenario, we will artificially create a situation where messages cannot be delivered to the endpoint. As a result, they end up in the Dead Message Queue and the application shown below has an integration card on it called "Dead Message Queue". This card is a very simple Queue browser. It displays the messages without removing them from the Queue unless you hit the submit button. The steps and diagram below walk through the exact flow you will be implementing.

In the following diagram, you can see the flow you are about to implement.
- Step 1 -> The user decides to investigate the item displayed in the dead message queue so they hit the submit button which causes the message to be published on the topic shown.
Expand Down Expand Up @@ -130,42 +130,46 @@ The business process that we will deploy is activated by an API Trigger which ca

![SAP BPA Image 1](img/SPA-BPA-1.jpg)

The "Action" component needs to be associatd with a destination. In order to create the destination, you will need "REST" connectivity information from your broker. Navigate to your AEM Cloud Console, you will select the Cluster Manager and then you will select your broker. From there, you will select the “Connect” option at the top. On this screen, make sure that the “View By” is set to Protocol as the first step. From there, expand the REST protocol and everything you need to create the destination will be visible.
The "Action" component needs to be associated with a destination. In order to create the destination, you will need "REST" connectivity information from your broker. Navigate to your AEM Cloud Console, you will select the Cluster Manager and then you will select your broker. From there, you will select the “Connect” option at the top. On this screen, make sure that the “View By” is set to Protocol as the first step. From there, expand the REST protocol and everything you need to create the destination will be visible.

![SAP BPA Image 2](img/AEM-2.jpg)

### Navigate to the BTP Cloud Cockpit
Once you have the connectivity information, Navigate to the Destinatios Section within the BTP Cockpit, Select the “New Destination” option. You will be creating a destination called “AEMBROKERREST”.
Once you have the connectivity information, Navigate to the Destinations Section within the BTP Cockpit, Select the “New Destination” option. You will be creating a destination called “AEMBROKERREST”.

![BPA Image 20](img/BPA-20.jpg)

You will populate the Destination information as shown below and you will add two properties that are both set to true.
- sap.applicationdevelopment.actions.enabled – true
- sap.processautomation.enabled – true

When your destination is finished and saved, double check to make sure both properties are there.
When your destination is created, double check to make sure both properties are there.


![BPA Image 21](img/BPA-21.jpg)

## Creating the SAP BPA Project

For the SAP BPA setup, we will be importing 1 File that contains 2 projects:
- a project of type “Actions”
For the SAP BPA setup, we will be importing 1 File that contains several components:
- 11 Artifacts
- 1 Trigger
- 1 Dependency for the Action Group that represents the action group
- a project of type “Process Automation”

We will import the SAPAEMSO.mtar file. Select the import option which is highlighted by the red square. When prompted, select the SAPAEMSO.mtar file for import. Once it’s successfully imported, you will see 2 projects listed as per the screenshot below
We will import the SAPAEMSO.mtar file. Select the import option which is highlighted by the red square. When prompted, select the SAPAEMSO.mtar file for import. Once it’s successfully imported, you will see 1 project listed as per the screenshot below

![SPA BPA Image 11](img/SPA-BPA-11.jpg)

In order to deploy the BPA project, you need to asociate the project with a Destination that you have already created in BTP. The deployment process will ask you to select a Destination so you need to register the destination with the BPA tooling. Navigate to the “Settings” tab from the BPA environment.
In this example, we are not really creating a destination but more referencing an already existing Destination. When you click “New Destination”, you should see the Destination you created in BTP called “AEMBROKERREST”, if you don’t, you have not specified the properties correctly and you will need to investigate. Select the Destination and you should see it populate in the UI. Now, we can deploy the project.
In order to deploy the BPA project, you need to associate the project with the Destination that you have already created in BTP. The deployment process will ask you to select a Destination so you need to register the destination with the BPA tooling. Expand the menu options on the top left.
![SPA BPA LOBBY](img/BPA_LOBBY.png)
Click on the Control Tower and Select Destinations
![SPA BPA ControlTower](img/BPA_ControlTower.png)
When you click “New Destination”, you should see the Destination you created in BTP called “AEMBROKERREST”, if you don’t, you have not specified the properties correctly and you will need to investigate. Select the Destination and you should see it populate in the UI. Now, we can deploy the project.
![SPA BPA Destination](img/BPA_Destination.png)

From the SAP BPA Environment, select the "Settings" option at the top.
![SPA BPA Image 12](img/SPA-BPA-12.jpg)

Now we will deploy the SAPAEMSO project. Click on the project to open it in the designer.
![SPA BPA Image 13](img/SPA-BPA-13.jpg)
Head back to the Lobby and Click on the SAPAEMSO project.
![SPA BPA LOBBY](img/BPA_LOBBY.png)

Prior to releasing the project, we have to make a small change to the project. Lets start by clicking on the "Sales Order Review" Process.

Expand Down

0 comments on commit aaa6248

Please sign in to comment.