|
1 | 1 | # WxPCATargetRuntimeClient |
2 | | -this is for fun, ain't it grand! |
| 2 | +WxPCATargetRuntimeClient is webMethods Integration package for webMethods.io Integration to support [WxPackageCompatibilityAnalyzer](https://github.com/IBM/WxPackageCompatibilityAnalyzer.git) to analyze package dependencies against webMethods.io Integration Cloud runtime and webMethods Edge Runtime. |
| 3 | + |
| 4 | +**Pre-requisites** |
| 5 | +* webMethods.io Integration tenant |
| 6 | +* GitHub account |
| 7 | + |
| 8 | +## Installation & Configuration |
| 9 | + |
| 10 | +### Add WxPCATargetRuntimeClient package |
| 11 | +1. Login to the webMethods.io Integration tenant. |
| 12 | +2. Select the **Projects** tab. |
| 13 | +3. Create a new project or select an existing project. |
| 14 | +4. Select the **Packages** tab in the project. |
| 15 | +5. Click on **Add package** button and select **GIT**. |
| 16 | + * Provide **Git URL** as https://github.com/IBM/WxPCATargetRuntimeClient.git. |
| 17 | + * Select the **Source Control** or add new Git account if doesn't exist already. |
| 18 | +6. Click **Next** button. |
| 19 | +7. Select **Git branch/tag** as **main** branch. |
| 20 | +8. Click the **Pull** button. |
| 21 | + |
| 22 | +Now you can see **WxPCATargetRuntimeClient** package in the packages list. |
| 23 | + |
| 24 | +### Import Flow-services |
| 25 | +9. Download **executeAction.zip** file from the **Releases** section of this GitHub repository. |
| 26 | +10. Select **Integrations** tab in webMethods.io Integration project. |
| 27 | +11. Select **Flow Services** tab in the left-hand side navigation. |
| 28 | +12. Click **Import** button. |
| 29 | +13. Choose **executeAction.zip** file and click **Open** button. |
| 30 | + |
| 31 | +### Import Workflows |
| 32 | +14. Download **Execute_Action.zip** files from the **Releases** section of this GitHub repository. |
| 33 | +15. Select the **Workflows** tab in the left-hand side navigation in webMethods.io Integration project. |
| 34 | +16. Click **Import** button. |
| 35 | +17. Choose **Execute_Action.zip** file and click **Open** button. |
| 36 | + |
| 37 | +### Configure API |
| 38 | +18. Select the **APIs** tab. |
| 39 | +19. Click on **Create API** button. |
| 40 | +20. Select **Create from Scratch / Design new API** and click **Next** button. |
| 41 | + * Provide a **Name**. Example: **WxPCATargetRuntimeClient**. |
| 42 | + * Provide a **Version**. Example: **1.0**. |
| 43 | +21. Click **Save** button. |
| 44 | +22. Click **Add resource** button. |
| 45 | + * Provide **Path** value as **/execute**. |
| 46 | + * Select **HTTP Method** as **POST**. |
| 47 | + * In **Select Workflow/Flow service** dropdown, choose **Execute_Action** workflow. |
| 48 | + * Click **Done** button and then click **Save** button. |
| 49 | + |
| 50 | +## Cloud Runtime Compatibility |
| 51 | +For Cloud Runtime, no additional changes required in the workflow or flowservice imported. You can proceed to [this section](https://github.com/IBM/WxPCATargetRuntimeClient/tree/main?tab=readme-ov-file#get-url-to-configure-target-runtime-in-wxpackagecompatibilityanalyzer). |
| 52 | + |
| 53 | +## Edge Runtime Compatibility |
| 54 | +For Edge Runtime, you need to select your **Integration/Edge Runtime** in the workflow. Follow the below steps: |
| 55 | + |
| 56 | +23. Select **Integrations** tab in webMethods.io Integration project. |
| 57 | +24. Select the **Workflows** tab in the left-hand side navigation. |
| 58 | +25. Open the **Execute_Action** workflow in **Edit** mode. |
| 59 | +26. Hover over **Invoke executeAction Flowservice** step and click on **Settings** icon. |
| 60 | +27. Under **Select Integration Runtime** dropdown, select your Integration/Edge Runtime against which you want to check the compatibility. |
| 61 | +28. Click **Next** button. |
| 62 | +29. Click **Next** button. |
| 63 | +30. On **Test this action** page, make sure **"The runtime Your_Runtime_Name is up to date"** message is displayed at the left side of "Sync" and "Test" button. If not, |
| 64 | + * click on **Sync** button. |
| 65 | + * On "Successfully synced" message, click **Close** button. |
| 66 | +31. Click **Test** button. |
| 67 | +32. Click **Done** button after successful response. |
| 68 | +33. Click on **Save** button at the top-right corner to save the workflow. |
| 69 | + |
| 70 | +## Get URL to Configure Target Runtime in WxPackageCompatibilityAnalyzer |
| 71 | +1. Login to the webMethods.io Integration tenant. |
| 72 | +2. In the **Projects** tab, open the project created earlier using the steps above. |
| 73 | +3. Select the **APIs** tab. |
| 74 | +4. Click on the API to open it. |
| 75 | +5. In the **Basic Info** section of the API, click the **Copy** icon for **Public URL** corresponding to **API Endpoint**. An example copied URL will be "https://somewmiotenant.int-aws-de.webmethods.io/integration/restv2/development/flec1bd19aa493d26689ccc0/WxPCACloudRuntimeClient". |
0 commit comments