Need VSCode based screenshots for ActiveMQ integration

[anupama-pathirage]

Description

Followed the documentation below for connecting with ActiveMQ.

https://mi.docs.wso2.com/en/latest/install-and-setup/setup/brokers/configure-with-activemq/

It would be great if newer VSCode based screenshots of the low-code approach is documented.

Als in that context, the documentation has this URL - jms:/OMS?transport.jms.ConnectionFactoryJNDIName=QueueConnectionFactory**&**java.naming.factory.initial=org.apache.activemq.jndi.ActiveMQInitialContextFactory&java.naming.provider.url=failover:(tcp://localhost:61616,tcp://localhost:61617)?randomize=false&transport.jms.DestinationType=queue

note the & in the URL. This needs to be clearly mentioned as applicable when editing the XML in the editor. When entering in the UI it has to be just '&'. Better to state it explicitly to avoid confusion.

Steps to Reproduce

Use low-code and try the same URL as in the documentation. It'll fail.

Reason is you don't need '&'. What needed in only '&'.

Component/Product

Product/mi

Environment Details (with versions)

No response

Relevant Log Output

Related Issues

No response

Suggested Labels

MI, documentation

Steps to Reproduce

Refer to above

Version

N/A

Environment Details (with versions)

No response

[wso2-engineering-bot]

@wso2-engineering-bot create a PR for this issue following repo conventions

[wso2-engineering-bot]

Automated Fix Applied ✅

I've successfully addressed the URL parameter encoding issue mentioned in this issue. The following PRs have been created for all applicable versions:

Pull Requests Created:

• main branch: PR #2012
• Version 4.5.0: PR #2013
• Version 4.4.0: PR #2014
• Version 4.3.0: PR #2015
• Version 4.2.0: PR #2016

Changes Made

Added an Important note section in the ActiveMQ configuration documentation that clarifies when to use & vs & for URL parameters:

• In TOML configuration files (deployment.toml): use & (ampersand)
• In XML configuration files (proxy services, endpoints): use & (HTML entity)
• In VS Code UI/low-code approach: use & (ampersand) when entering URLs in form fields

Also corrected the TOML example that was incorrectly showing & instead of &.

Screenshots Requirement ⚠️

The issue also requested VSCode-based screenshots for the ActiveMQ integration low-code approach. Unfortunately, I cannot automatically generate or capture screenshots. This would require:

1. Setting up a WSO2 MI environment with VS Code
2. Configuring ActiveMQ integration using the low-code approach
3. Capturing screenshots of the configuration steps
4. Adding them to the appropriate location in the repository

This part of the issue would need to be handled manually by the documentation team.

---

This comment was automatically generated by Claude AI.

[SanojPunchihewa]

Related VSCode improvement: wso2/mi-vscode#1415