Skip to content

Add AI data mapping documentation and cross-link Auto Map references#399

Merged
MaryamZi merged 10 commits into
wso2:mainfrom
VellummyilumVinoth:ai-data-mapping
Jun 8, 2026
Merged

Add AI data mapping documentation and cross-link Auto Map references#399
MaryamZi merged 10 commits into
wso2:mainfrom
VellummyilumVinoth:ai-data-mapping

Conversation

@VellummyilumVinoth

@VellummyilumVinoth VellummyilumVinoth commented May 13, 2026

Copy link
Copy Markdown
Contributor

Description

  • Adds a new ai-data-mapper.md page documenting the AI data mapping feature, including a Visual designer tab with step-by-step screenshots (canvas, Copilot command, result) and a Ballerina code tab showing before/after transformation code.
  • Simplifies the Map with AI section in mapping-capabilities.md to a brief description with a link to the new page, removing duplicated content.
  • Removes the outdated ai-assisted-data-mapping.md file (stale references to Ballerina Copilot and deprecated UI behaviour) and replaces its inbound link in expressions-functions.md.
  • Adds three step-by-step screenshots extracted from the feature recording.

Goals

Describe the solutions that this feature/fix will introduce to resolve the problems described above

Approach

Describe how you are implementing the solutions. Include an animated GIF or screenshot if the change affects the UI (email documentation@wso2.com to review all UI text). Include a link to a Markdown file or Google doc if the feature write-up is too long to paste here.

User stories

Summary of user stories addressed by this change>

Release note

Brief description of the new feature or bug fix as it will appear in the release notes

Documentation

Link(s) to product documentation that addresses the changes of this PR. If no doc impact, enter �N/A� plus brief explanation of why there�s no doc impact

Training

Link to the PR for changes to the training content in https://github.com/wso2/WSO2-Training, if applicable

Certification

Type �Sent� when you have provided new/updated certification questions, plus four answers for each question (correct answer highlighted in bold), based on this change. Certification questions/answers should be sent to certification@wso2.com and NOT pasted in this PR. If there is no impact on certification exams, type �N/A� and explain why.

Marketing

Link to drafts of marketing content that will describe and promote this feature, including product page changes, technical articles, blog posts, videos, etc., if applicable

Automation tests

  • Unit tests

    Code coverage information

  • Integration tests

    Details about the test cases and coverage

Security checks

Samples

Provide high-level details about the samples related to this feature

Related PRs

List any other related PRs

Migrations (if applicable)

Describe migration steps and platforms on which migration has been tested

Test environment

List all JDK versions, operating systems, databases, and browser/versions on which this feature/fix was tested

Learning

Describe the research phase and any blog posts, patterns, libraries, or add-ons you used to solve the problem.

Summary by CodeRabbit

  • Documentation
    • Added comprehensive "AI Data Mapping" documentation page covering AI-powered mapping generation, step-by-step workflows for both UI and Ballerina code approaches, key capabilities, and responsible-use guidance.
    • Updated "Auto Map" documentation to clarify the new workflow using the WSO2 Integrator Copilot panel.
    • Reorganized Data Mapper documentation structure with improved navigation links.

@coderabbitai

coderabbitai Bot commented May 13, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

Note

Reviews paused

It looks like this branch is under active development. To avoid overwhelming you with review comments due to an influx of new commits, CodeRabbit has automatically paused this review. You can configure this behavior by changing the reviews.auto_review.auto_pause_after_reviewed_commits setting.

Use the following commands to manage reviews:

  • @coderabbitai resume to resume automatic reviews.
  • @coderabbitai review to trigger a single review.

Use the checkboxes below for quick actions:

  • ▶️ Resume reviews
  • 🔍 Trigger review

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 09431dea-86e6-4974-964d-6513dd13c9d9

📥 Commits

Reviewing files that changed from the base of the PR and between cf7227b and 19c5f38.

⛔ Files ignored due to path filters (5)
  • en/static/img/develop/integration-artifacts/supporting/data-mapper/ai-data-mapper-canvas.png is excluded by !**/*.png
  • en/static/img/develop/integration-artifacts/supporting/data-mapper/ai-data-mapper-copilot-command.png is excluded by !**/*.png
  • en/static/img/develop/integration-artifacts/supporting/data-mapper/ai-data-mapper-create-form.png is excluded by !**/*.png
  • en/static/img/develop/integration-artifacts/supporting/data-mapper/ai-data-mapper-define-personal-profile.png is excluded by !**/*.png
  • en/static/img/develop/integration-artifacts/supporting/data-mapper/ai-data-mapper-result.png is excluded by !**/*.png
📒 Files selected for processing (6)
  • en/docs/develop/copilot/overview.md
  • en/docs/develop/integration-artifacts/supporting/data-mapper/ai-mapping.md
  • en/docs/develop/integration-artifacts/supporting/data-mapper/mapping-capabilities.md
  • en/docs/develop/understand-ide/editors/datamapper-editor.md
  • en/docs/develop/understand-ide/editors/flow-diagram-editor/statement.md
  • en/sidebars.ts
✅ Files skipped from review due to trivial changes (2)
  • en/docs/develop/integration-artifacts/supporting/data-mapper/mapping-capabilities.md
  • en/docs/develop/copilot/overview.md
🚧 Files skipped from review as they are similar to previous changes (1)
  • en/sidebars.ts

📝 Walkthrough

Walkthrough

This PR adds comprehensive AI Data Mapping documentation for WSO2 Integrator, introducing a new page explaining the feature, integrating it into navigation, and updating existing Data Mapper, Copilot, and Flow Diagram Editor documentation to reference it with appropriate links.

Changes

AI Data Mapping Documentation Suite

Layer / File(s) Summary
New AI Data Mapping documentation page
en/docs/develop/integration-artifacts/supporting/data-mapper/ai-mapping.md
New documentation page covering what AI Data Mapping does, UI and Ballerina-code walkthroughs with examples, feature capabilities (automated mapping, advanced expressions, sub-mapping reuse), responsible-use guidance, and related documentation links.
Navigation registration
en/sidebars.ts, en/docs/develop/copilot/overview.md
Sidebar adds AI Data Mapping entry under Data Mapper sub-items. Copilot overview updates /datamap command and "AI data mapper" See also links to point to the new ai-mapping page.
Data Mapper documentation integration
en/docs/develop/integration-artifacts/supporting/data-mapper/mapping-capabilities.md, en/docs/develop/understand-ide/editors/datamapper-editor.md
Mapping capabilities "Map with AI" section rewritten with concise Auto Map workflow and link to AI data mapping. "What's next" list adds AI data mapping entry. Datamapper editor Auto Map description updated to explain Copilot-driven generation and links to AI data mapping documentation.
Flow Diagram Editor statement updates
en/docs/develop/understand-ide/editors/flow-diagram-editor/statement.md
Map Data guidance updates Auto Map reference to link to AI data mapping documentation. Call Function section label formatting changed from code to literal.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~5 minutes

Poem

🐰 A rabbit's whisper through the forest tall,
"Auto Map now dances with the Copilot's call!"
New AI threads weave through docs with care,
From sidebars to flows, the guide is there.
bounces happily

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Description check ⚠️ Warning The description is mostly incomplete—only the first section contains substantive content; nearly all required template sections (Goals, Approach, User stories, Release note, etc.) are left as placeholder headings with no content filled in. Complete all required template sections with relevant details, such as goals, implementation approach, release notes, documentation links, and affected tests/samples.
✅ Passed checks (4 passed)
Check name Status Explanation
Title check ✅ Passed The title accurately and concisely summarizes the main changes: adding AI data mapping documentation and updating Auto Map references across the codebase.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In
`@en/docs/develop/integration-artifacts/supporting/data-mapper/ai-data-mapper.md`:
- Around line 93-96: Update the misspelled field name in the Accommodation
record and any generated mapping code: change numberOfRoomates to
numberOfRoommates in the type declaration (type Accommodation record { ... })
and update the corresponding mapping logic that references numberOfRoomates so
it uses numberOfRoommates instead; ensure all occurrences (type definition and
generated mapper) are renamed consistently to avoid breaking consumers.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 11d8519b-71d9-4277-8c99-8b62e79add45

📥 Commits

Reviewing files that changed from the base of the PR and between 8eb091c and d739163.

⛔ Files ignored due to path filters (3)
  • en/static/img/develop/integration-artifacts/supporting/data-mapper/ai-data-mapper-canvas.png is excluded by !**/*.png
  • en/static/img/develop/integration-artifacts/supporting/data-mapper/ai-data-mapper-copilot-command.png is excluded by !**/*.png
  • en/static/img/develop/integration-artifacts/supporting/data-mapper/ai-data-mapper-result.png is excluded by !**/*.png
📒 Files selected for processing (8)
  • en/docs/develop/integration-artifacts/supporting/data-mapper/ai-data-mapper.md
  • en/docs/develop/integration-artifacts/supporting/data-mapper/data-mapper.md
  • en/docs/develop/integration-artifacts/supporting/data-mapper/mapping-capabilities.md
  • en/docs/develop/transform/ai-assisted-data-mapping.md
  • en/docs/develop/transform/expressions-functions.md
  • en/docs/develop/understand-ide/editors/datamapper-editor.md
  • en/docs/develop/understand-ide/editors/flow-diagram-editor/statement.md
  • en/sidebars.ts
💤 Files with no reviewable changes (1)
  • en/docs/develop/transform/ai-assisted-data-mapping.md

@VellummyilumVinoth VellummyilumVinoth force-pushed the ai-data-mapping branch 3 times, most recently from 6f2bac1 to 34cc0d5 Compare May 13, 2026 10:20
Comment thread en/docs/develop/integration-artifacts/supporting/data-mapper/ai-data-mapper.md Outdated
Comment thread en/docs/develop/integration-artifacts/supporting/data-mapper/ai-data-mapper.md Outdated
Comment thread en/docs/develop/integration-artifacts/supporting/data-mapper/ai-data-mapper.md Outdated
Comment thread en/docs/develop/integration-artifacts/supporting/data-mapper/ai-data-mapper.md Outdated
Comment thread en/docs/develop/integration-artifacts/supporting/data-mapper/ai-data-mapper.md Outdated
Comment thread en/docs/develop/integration-artifacts/supporting/data-mapper/ai-data-mapper.md Outdated
Comment thread en/docs/develop/integration-artifacts/supporting/data-mapper/ai-data-mapper.md Outdated
Comment thread en/docs/develop/integration-artifacts/supporting/data-mapper/ai-data-mapper.md Outdated
Comment thread en/docs/develop/understand-ide/editors/datamapper-editor.md Outdated

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In
`@en/docs/develop/integration-artifacts/supporting/data-mapper/ai-data-mapper.md`:
- Around line 1-6: The page filename ai-data-mapper.md repeats the parent
directory keyword and doesn't align the slug with the title "AI Data Mapping";
rename the file to a shorter slug such as ai-mapping.md, update any inbound
links and sidebar references that point to the old ai-data-mapper path
(including sidebars, TOCs, and cross-doc links), and ensure the frontmatter
title remains "AI Data Mapping" so title and URL keywords match; also search for
occurrences of "ai-data-mapper" in the repo and update them to the new slug to
avoid broken links.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: c423180b-5205-4863-b6d6-314a0f65431e

📥 Commits

Reviewing files that changed from the base of the PR and between 6f2bac1 and 476f734.

⛔ Files ignored due to path filters (3)
  • en/static/img/develop/integration-artifacts/supporting/data-mapper/ai-data-mapper-canvas.png is excluded by !**/*.png
  • en/static/img/develop/integration-artifacts/supporting/data-mapper/ai-data-mapper-copilot-command.png is excluded by !**/*.png
  • en/static/img/develop/integration-artifacts/supporting/data-mapper/ai-data-mapper-result.png is excluded by !**/*.png
📒 Files selected for processing (7)
  • en/docs/develop/integration-artifacts/supporting/data-mapper/ai-data-mapper.md
  • en/docs/develop/integration-artifacts/supporting/data-mapper/data-mapper.md
  • en/docs/develop/integration-artifacts/supporting/data-mapper/mapping-capabilities.md
  • en/docs/develop/transform/ai-assisted-data-mapping.md
  • en/docs/develop/understand-ide/editors/datamapper-editor.md
  • en/docs/develop/understand-ide/editors/flow-diagram-editor/statement.md
  • en/sidebars.ts
💤 Files with no reviewable changes (1)
  • en/docs/develop/transform/ai-assisted-data-mapping.md
✅ Files skipped from review due to trivial changes (3)
  • en/docs/develop/understand-ide/editors/datamapper-editor.md
  • en/docs/develop/integration-artifacts/supporting/data-mapper/mapping-capabilities.md
  • en/sidebars.ts
🚧 Files skipped from review as they are similar to previous changes (2)
  • en/docs/develop/integration-artifacts/supporting/data-mapper/data-mapper.md
  • en/docs/develop/understand-ide/editors/flow-diagram-editor/statement.md

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

♻️ Duplicate comments (1)
en/docs/develop/integration-artifacts/supporting/data-mapper/ai-data-mapper.md (1)

1-6: 🛠️ Refactor suggestion | 🟠 Major | ⚡ Quick win

Filename still violates hierarchy redundancy rule.

The filename ai-data-mapper.md repeats the parent directory keyword data-mapper, violating the coding guideline: "If a keyword exists in the parent directory, do not repeat it in the URL slug." Rename this file to a shorter slug such as ai-mapping.md and update the inbound link in statement.md (line 56) accordingly.

As per coding guidelines: "Check the file path/hierarchy. If a keyword exists in the parent directory, do not repeat it in the URL slug."

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In
`@en/docs/develop/integration-artifacts/supporting/data-mapper/ai-data-mapper.md`
around lines 1 - 6, The file ai-data-mapper.md repeats the parent directory
keyword and should be renamed to ai-mapping.md; rename the document slug/file
from ai-data-mapper.md to ai-mapping.md and update the inbound link in
statement.md to point to the new slug (replace any references to
"ai-data-mapper" with "ai-mapping") so the URL hierarchy no longer repeats the
parent directory keyword.
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Duplicate comments:
In
`@en/docs/develop/integration-artifacts/supporting/data-mapper/ai-data-mapper.md`:
- Around line 1-6: The file ai-data-mapper.md repeats the parent directory
keyword and should be renamed to ai-mapping.md; rename the document slug/file
from ai-data-mapper.md to ai-mapping.md and update the inbound link in
statement.md to point to the new slug (replace any references to
"ai-data-mapper" with "ai-mapping") so the URL hierarchy no longer repeats the
parent directory keyword.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: b84650a5-2879-4166-940b-0232b36efc6e

📥 Commits

Reviewing files that changed from the base of the PR and between 476f734 and cf7227b.

📒 Files selected for processing (5)
  • en/docs/develop/integration-artifacts/supporting/data-mapper/ai-data-mapper.md
  • en/docs/develop/integration-artifacts/supporting/data-mapper/data-mapper.md
  • en/docs/develop/integration-artifacts/supporting/data-mapper/mapping-capabilities.md
  • en/docs/develop/understand-ide/editors/datamapper-editor.md
  • en/docs/develop/understand-ide/editors/flow-diagram-editor/statement.md
✅ Files skipped from review due to trivial changes (3)
  • en/docs/develop/integration-artifacts/supporting/data-mapper/data-mapper.md
  • en/docs/develop/understand-ide/editors/datamapper-editor.md
  • en/docs/develop/integration-artifacts/supporting/data-mapper/mapping-capabilities.md

Comment thread en/docs/develop/integration-artifacts/supporting/data-mapper/ai-mapping.md Outdated
Comment thread en/docs/develop/integration-artifacts/supporting/data-mapper/ai-mapping.md Outdated
Comment thread en/docs/develop/integration-artifacts/supporting/data-mapper/ai-mapping.md Outdated
Comment thread en/docs/develop/integration-artifacts/supporting/data-mapper/ai-mapping.md Outdated
Comment thread en/docs/develop/integration-artifacts/supporting/data-mapper/ai-data-mapper.md Outdated
Comment thread en/docs/develop/integration-artifacts/supporting/data-mapper/ai-mapping.md Outdated
Comment thread en/docs/develop/integration-artifacts/supporting/data-mapper/ai-mapping.md Outdated
Comment thread en/docs/develop/integration-artifacts/supporting/data-mapper/ai-mapping.md Outdated
Comment thread en/docs/develop/integration-artifacts/supporting/data-mapper/data-mapper.md Outdated
Comment thread en/docs/develop/understand-ide/editors/datamapper-editor.md Outdated
@NipunaRanasinghe

Copy link
Copy Markdown
Contributor

@coderabbitai review

@coderabbitai

coderabbitai Bot commented Jun 8, 2026

Copy link
Copy Markdown
Contributor
✅ Action performed

Review finished.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

@MaryamZi MaryamZi merged commit 80cd851 into wso2:main Jun 8, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants