Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Sap aem int day 3 - updated adapter import #335

Merged
merged 97 commits into from
Jul 16, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
97 commits
Select commit Hold shift + click to select a range
b67389a
Initial version of SAP AEM Integration - day 3
Oct 12, 2023
91ca113
Populating content for 3rd day
ChristianHoltfurth Oct 14, 2023
e25432e
Populating codelab for day 3 - configuration steps
ChristianHoltfurth Oct 14, 2023
dc0a296
Adjusted time estimates
ChristianHoltfurth Oct 14, 2023
9c3ffbd
Added Overall Duration estimate
ChristianHoltfurth Oct 14, 2023
c50414d
Finished AEMBusinessPartnerAddressCheck
ChristianHoltfurth Oct 14, 2023
337f42d
fixed typos and formatting
ChristianHoltfurth Oct 14, 2023
0bc492c
Added configuration and deployment for 2 more flows
ChristianHoltfurth Oct 14, 2023
8af976d
Added more details on the LegacyOutputAdapter
ChristianHoltfurth Oct 14, 2023
5d29bc5
Finished basic description of event flows
ChristianHoltfurth Oct 15, 2023
9a88436
Finished describing AEM related settings and processing steps
ChristianHoltfurth Oct 15, 2023
a91144c
Added takeaways
ChristianHoltfurth Oct 15, 2023
d86f133
Fixed formatting
ChristianHoltfurth Oct 15, 2023
d6650fc
Updated day-3 codelab
Oct 15, 2023
1c0d10b
Formatting updates
ChristianHoltfurth Oct 16, 2023
f2ab8ae
Merge branch 'sap-aem-int-day-3' of https://github.com/SolaceDev/sola…
ChristianHoltfurth Oct 16, 2023
8adb8f5
updated codelabs
Oct 16, 2023
2e0988c
Formatting
ChristianHoltfurth Oct 16, 2023
8fbc061
Merge branch 'sap-aem-int-day-3' of https://github.com/SolaceDev/sola…
ChristianHoltfurth Oct 16, 2023
e3d5591
Updated markdown and codelab to fix formatting
Oct 16, 2023
8a82e71
More formatting
ChristianHoltfurth Oct 16, 2023
f2ecf0a
Merge branch 'sap-aem-int-day-3' of https://github.com/SolaceDev/sola…
ChristianHoltfurth Oct 16, 2023
c351d93
Updated codelab
Oct 16, 2023
b58749b
Formatting and new AEM adapter version
ChristianHoltfurth Oct 16, 2023
25fd3f1
Merge branch 'sap-aem-int-day-3' of https://github.com/SolaceDev/sola…
ChristianHoltfurth Oct 16, 2023
1528667
Updated with latest codelab changes
Oct 17, 2023
0c79dd5
Fixed queue subs and more formatting
ChristianHoltfurth Oct 17, 2023
4e019ab
Merge remote-tracking branch 'origin/master' into sap-aem-int-day-3
Oct 17, 2023
88f77e8
Merge remote-tracking branch 'origin/sap-aem-int-day-3' into sap-aem-…
Oct 17, 2023
7e269f9
Updated codelabs
Oct 17, 2023
46203a1
Repush updated queue subs for Legacy adapter
ChristianHoltfurth Oct 17, 2023
a038b9b
Formatting
ChristianHoltfurth Oct 17, 2023
1d7431d
updated files
Oct 17, 2023
eabdb12
Updated section 3
ChristianHoltfurth Oct 20, 2023
3a36122
Merge remote-tracking branch 'origin/master' into sap-aem-int-day-3
Oct 20, 2023
775139d
Removed Unneeded artifacts
ChristianHoltfurth Oct 20, 2023
63bc172
More detailed steps
ChristianHoltfurth Oct 21, 2023
40dfd54
More improvements and details
ChristianHoltfurth Oct 21, 2023
2c96730
Hide Todos
ChristianHoltfurth Oct 21, 2023
d7e8de9
Merge remote-tracking branch 'origin/sap-aem-int-day-3' into sap-aem-…
Oct 23, 2023
eabe2ed
Updated links
ChristianHoltfurth Oct 24, 2023
e0806e5
Merge remote-tracking branch 'origin/sap-aem-int-day-3' into sap-aem-…
Oct 24, 2023
3792de2
Merge remote-tracking branch 'origin/master' into sap-aem-int-day-3
Oct 24, 2023
6bf4f7c
Removed downloadables
ChristianHoltfurth Oct 24, 2023
a3ed2a6
Merge remote-tracking branch 'origin/sap-aem-int-day-3' into sap-aem-…
Oct 24, 2023
68cd0c8
Updated codelabs for SAP AEM INT - Day 3
Oct 24, 2023
a8f8c70
Merge remote-tracking branch 'origin/master' into sap-aem-int-day-3
Oct 24, 2023
0a68fc7
Marked BP address checker optional
ChristianHoltfurth Nov 15, 2023
5b4772f
Merge branch 'master' into sap-aem-int-day-3
ChristianHoltfurth Nov 15, 2023
caabe5e
Updated codelabs for SAP AEM INT - Day 3
Nov 17, 2023
42db3c3
Merge remote-tracking branch 'origin/master' into sap-aem-int-day-3
Nov 17, 2023
a5564f6
Updated codelabs for SAP AEM INT - Day 3
Nov 17, 2023
ce32c93
Merge remote-tracking branch 'origin/master' into sap-aem-int-day-3
Nov 24, 2023
fcc6a64
Updated codelabs SAP AEM INT-Day-3 to remove old redundant artifacts
Nov 24, 2023
2732b9d
Merge branch 'master' into sap-aem-int-day-3
HariRangarajan-Solace Nov 24, 2023
7e5b15a
Restructured code lab
ChristianHoltfurth Jan 17, 2024
3abccae
Merge branch 'master' into sap-aem-int-day-3
HariRangarajan-Solace Jan 26, 2024
0860974
Restructured codelab
ChristianHoltfurth Feb 9, 2024
367ec01
Formatting
ChristianHoltfurth Feb 9, 2024
ad09f07
further formatting
ChristianHoltfurth Feb 9, 2024
b83b9a5
formatting titles
ChristianHoltfurth Feb 9, 2024
c7f3279
formatting
ChristianHoltfurth Feb 9, 2024
25ff6f1
Added section for CI/CD
ChristianHoltfurth Feb 9, 2024
724e1bc
Note for CI/CD users
ChristianHoltfurth Feb 9, 2024
02309fe
test
ChristianHoltfurth Feb 15, 2024
1458308
Updates to intro sections and scenario 1
ChristianHoltfurth Feb 16, 2024
6e161f0
Prepared scenario 2 for changes
ChristianHoltfurth Feb 16, 2024
633f89c
Updates to scenario 2
ChristianHoltfurth Feb 16, 2024
a68dcd4
Added troubleshooting guide
ChristianHoltfurth Feb 25, 2024
78b2e93
fixed link to CI tool
ChristianHoltfurth Feb 25, 2024
f2248bc
Updating time estimates
ChristianHoltfurth Feb 25, 2024
afd7b33
Added security module
ChristianHoltfurth Feb 27, 2024
d15f0d6
formatting
ChristianHoltfurth Feb 27, 2024
5ceb2f1
formatting
ChristianHoltfurth Feb 27, 2024
8b81907
more formatting
ChristianHoltfurth Feb 27, 2024
54f7d79
format, format
ChristianHoltfurth Feb 27, 2024
9eaa37a
more formatting testing
ChristianHoltfurth Feb 27, 2024
b31f2d0
Merge branch 'master' into sap-aem-int-day-3
HariRangarajan-Solace Feb 27, 2024
5458d99
Updating wording/rephrasing
ChristianHoltfurth Feb 27, 2024
7050526
Merge branch 'sap-aem-int-day-3' of https://github.com/SolaceDev/sola…
ChristianHoltfurth Feb 27, 2024
8147bfc
Rephrased prereqs
ChristianHoltfurth Feb 27, 2024
1d68706
Merge branch 'master' into sap-aem-int-day-3
ChristianHoltfurth Feb 27, 2024
fb1c437
Added clarifications
ChristianHoltfurth Feb 29, 2024
ca9aca7
Additional instructions for importing the AEM adapter
ChristianHoltfurth Feb 29, 2024
c3296f6
Created prereq codelab
ChristianHoltfurth Feb 29, 2024
b8f084e
Merge branch 'master' into sap-aem-int-day-3
HariRangarajan-Solace Feb 29, 2024
b98c07a
Merge branch 'sap-aem-int-day-3' of https://github.com/SolaceDev/sola…
ChristianHoltfurth Feb 29, 2024
f746ec9
building skeleton for prereq codelab
ChristianHoltfurth Feb 29, 2024
0c75036
Revert "building skeleton for prereq codelab"
ChristianHoltfurth Feb 29, 2024
5d7abba
Revert "Revert "building skeleton for prereq codelab""
ChristianHoltfurth Feb 29, 2024
894ece5
Revert "Revert "Revert "building skeleton for prereq codelab"""
ChristianHoltfurth Feb 29, 2024
1f34032
Removed prereqs lab in day 3 branch
ChristianHoltfurth Feb 29, 2024
36c893b
Updated AEM adapter import
ChristianHoltfurth Jul 16, 2024
4e56a71
Merge branch 'master' into sap-aem-int-day-3
TamimiGitHub Jul 16, 2024
2ab6045
Fixed typo and added duration
ChristianHoltfurth Jul 16, 2024
9caa559
Merge branch 'master' into sap-aem-int-day-3
TamimiGitHub Jul 16, 2024
1b2fb68
Merge branch 'sap-aem-int-day-3' of https://github.com/SolaceDev/sola…
ChristianHoltfurth Jul 16, 2024
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file added markdown/sap-aem-int-day-3/img/CIAEMPackage.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-3/img/CICopyAdapter.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.
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.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
54 changes: 16 additions & 38 deletions markdown/sap-aem-int-day-3/sap-aem-int-day-3.md
Original file line number Diff line number Diff line change
Expand Up @@ -47,43 +47,20 @@ Download [AEM-Rapid-Pilot-day3.zip](https://github.com/SolaceLabs/aem-sap-integr
### B) Importing the official SAP AdvancedEventMesh Adapter into your CI tenant
>aside negative A new Advanced Event Mesh specific adapter was made available in January 2024. If you haven't used this adatper in your CI tenant before, you may need to import it once. Follow these steps to get the official adapter from SAP. <br>

- Navigate to your newly imported package: AEM-Rapid-Pilot-day3.
- Take a copy of the AEMLegacyOutputAdapter flow.
![CI Copy flow](img/CICopyFlow.png)
- Choose a new name. (Accepting the default of `AEMLegacyOutputAdapter_copy` will do.)
- Then open and edit your copy named `AEMLegacyOutputAdapter_copy` or similar.
![CI Edit flow](img/CICopyflowEdit.png)
- Select the line named AdvancedEventMesh and delete it by clicking on the rubbish bin icon that appears.
![CI delete adapter](img/CICopyflowDeleteAdapter.png)
- After deletion, select the connector tool from the top and reconnect the Sender box to the Start icon.
![CI connector tool](img/CICopyFlowConnectorTool.png)
- You should see a pop up appear in which you can select the AdvancedEventMesh adapter. Selecting this should pull the SAP version of this adapter into your CI tenant.

That's it, we should now be good to proceed.
(You can cancel the changes in your copy `AEMLegacyOutputAdapter_copy` or similar and delete the copy of the flow now.)

>aside negative Skip over C) if you have successfully completed this step.

### C) Download and import the AEM adapter for Integration Suite

>aside negative A new Advanced Event Mesh specific adapter was made available in January 2024. <br>
**Only follow this step if you can't see the AdvancedEventMesh adapter in your Integration Suite tenant or if you want to use the preview version (provided) instead.** <br>
In that case, follow the steps in this section to get a preview of the AEM adapter:<br>
- Download the Integration Suite AEM Adapter<br>
- Import the AEM adapter into your Integration Suite tenant and deploy this adapter.

Import the adapter into your package.
![CI Adapter import](img/CIAdapterImport.png)

Extract the downloaded zip and select the .esa file in the upload dialog. Runtime Profile should be Cloud Integration. (You should not be seeing the warning message `Integration adapter with the ID 'AdvancedEventMesh' already exists`. If you do, then you can skip this step as the adapter has already been made available to you.)
![CI Adapter import](img/CIAdapterImportWizard.png)

Deploy the adapter after import.
![CI Adapter deploy](img/CIAdapterDeploy.png)


See [SAP documentation](https://help.sap.com/docs/integration-suite/sap-integration-suite/importing-custom-integration-adapter-in-cloud-foundry-environment#procedure) for more detailed instructions

- Navigate to "Discover" -> "Integrations" in the left hand menu:<br>
![CI Discover Integrations](img/CIDiscoverIntegrations.png)
- Search for “advanced” to find the “Advanced Event Mesh Adapter for SAP Integration Suite”:<br>
![CI Discover Adapter](img/CIDiscoverAdapter.png)
- Select the adapter package by clicking on it, then click on “Copy” on the top right.<br>
![CI Copy Adapter](img/CICopyAdapter.png)
- Go to “Design” -> “Integrations and APIs” in the left hand menu and click on the newly created “Advanced Event Mesh Adapter for SAP Integration Suite” package.<br>
![CI AEM package](img/CIAEMPackage.png)
- Navigate to “Artifacts” to see the Integration Adapter and click on and select “Deploy” from the “Actions” menu.<br>
![CI Deploy Adapter](img/CIDeployAdapter.png)
- Select the “Cloud Integration” Runtime Profile.<br>
![CI Deploy CI Runtime](img/CIDeployRuntime.png)
- You should now be able to see the AdvancedEventMesh Integration Adapter if you navigate to “Monitor” -> “Integrations and APIs” and click on the tile “All” under “Manage Integration Content” with a status of “Started” if everything went well:<br>
![CI Adapter Monitor](img/CIAdapterMonitor.png)

## Scenario 1 - SalesOrder: AEMLegacyOutputAdapter (mandatory)
Duration: 0:30:00
Expand Down Expand Up @@ -546,7 +523,7 @@ Lastly, the AEM Receiver adapter is configured to persistently (to avoid message


#### 2. Configuring and deploying the AEMBusinessPartnerAddressCheck iflow:
![DQM service configuration](img/CIDQMServiceConfiguration.png)You
![DQM service configuration](img/CIDQMServiceConfiguration.png)
- Populate the connection details for the DQM service call out with the ones for your own DQM service instance. (You don't need to change the address, if you are using our DQM service. If you are using your own DQM service, you'll need to take the API URL from your token and append `/dq/addressCleanse/batch` to the end of it. It should look something like `https://api.dqmmicro.cfapps.eu10.hana.ondemand.com/dq/addressCleanse/batch`).
- Hit configure at the top right and fill in the details to connect to your AEM broker service:

Expand Down Expand Up @@ -656,6 +633,7 @@ As you can see, broker ACLs are a quite powerful tool to tightly control access
In addition to topic ACLs, remember that queue access is controlled by the queue ownership model and the "other permission".

## Troubleshooting
Duration: 0:05:00

#### Checking that your flow was deployed successfully.
- Go to Monitor Artifacts -> Manage Integration Content -> All. <br>
Expand Down
Loading