feat(orchestrator): support nested objects in rjsf-widgets config - #4461
Merged
karthikjeeyar merged 4 commits intoSep 1, 2026
Conversation
- Update config schema to accept nested objects in orchestrator.rjsf-widgets
- Add tests for nested path resolution (flat, nested, mixed scenarios)
- Update documentation with nested configuration examples
- Maintain backward compatibility with existing flat string keys
Templates can now reference nested values using dot-path notation:
$${{rjsfConfig.widget-id.xParams.name}}
Resolves customer request for hierarchical widget parameter organization.
lokanandaprabhu
requested review from
a team,
christoph-jerolimov,
karthikjeeyar and
lholmquist
as code owners
August 25, 2026 05:43
|
Important This PR includes changes that affect public-facing API. Please ensure you are adding/updating documentation for new features or behavior. Changed Packages
|
Add jest.Mock type casts to fix TypeScript compilation errors: - mockImplementation expects parameters - mockReturnValue can accept undefined
Only orchestrator-common has published code changes (config.d.ts). orchestrator-form-widgets only has test changes which don't require a changeset.
Codecov Report✅ All modified and coverable lines are covered by tests. Additional details and impacted files@@ Coverage Diff @@
## main #4461 +/- ##
==========================================
- Coverage 61.62% 61.61% -0.01%
==========================================
Files 2541 2540 -1
Lines 101912 101875 -37
Branches 28555 28553 -2
==========================================
- Hits 62800 62775 -25
+ Misses 37308 37296 -12
Partials 1804 1804
*This pull request uses carry forward flags. Click here to find out more. Continue to review full report in Codecov by Harness.
🚀 New features to boost your workflow:
|
Member
|
I'm not sure if I'm missing something with the configuration, but this is what I'm seeing on the UI: 
Here is the workflow definition and the schema: 
and what i added to my app-config: 
|
Member
Author
|
@lholmquist The schema in the video demonstrates a more detailed example with grouped sections (4 objects with nested properties), while the PR description includes a simplified version (3 flat properties) to keep the testing instructions concise. Both schemas work correctly and demonstrate the same nested config capability. If you'd like to see the exact schema from the video, you can use: The key feature this PR enables is that orchestrator.rjsf-widgets now officially supports nested objects with proper TypeScript typing, testing, and documentation. Both schemas demonstrate this works correctly. |
karthikjeeyar
requested changes
Sep 1, 2026
Address review feedback from @karthikjeeyar: - Change type from 'any' to 'string | { [key: string]: any }' - Prevents misconfiguration errors when users accidentally use numbers - Provides better type safety while maintaining nested object support - Update JSDoc to document value type requirements
|
karthikjeeyar
approved these changes
Sep 1, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Story - https://redhat.atlassian.net/browse/RHIDP-16437
Summary
Adds support for nested objects in
orchestrator.rjsf-widgetsconfiguration, enabling Platform Engineers to organize widget parameters hierarchically.Changes
config.d.tsto accept[key: string]: anyinstead of[key: string]: stringorchestratorFormWidgets.mdwith nested configuration examplesVideo
Screen.Recording.2026-08-25.at.11.09.31.AM.mov
Example Configuration
How to Test
1. Add Configuration
Add to your
app-config.local.yaml:2. Create Test Workflow
Workflow:
test-nested-config.sw.yamlSchema:
schemas/test-nested-config__main-schema.json{ "$schema": "http://json-schema.org/draft-07/schema#", "title": "Test Nested Config", "type": "object", "properties": { "flatConfig": { "type": "string", "title": "Flat Config Value", "ui:widget": "ActiveText", "ui:props": { "ui:text": "**Environment:** $${{rjsfConfig.defaultEnvironment}}" } }, "nestedConfig": { "type": "string", "title": "Nested Config Values", "ui:widget": "ActiveText", "ui:props": { "ui:text": "## App Registration\n\n- **Name:** $${{rjsfConfig.app-registration.xParams.name}}\n- **Version:** $${{rjsfConfig.app-registration.xParams.version}}\n- **Env:** $${{rjsfConfig.app-registration.environment}}" } }, "mixedExample": { "type": "string", "title": "Mixed Config Summary", "ui:widget": "ActiveText", "ui:props": { "ui:text": "# Summary\n\nGlobal: **$${{rjsfConfig.defaultEnvironment}}**\n\nWidgets:\n- $${{rjsfConfig.app-registration.xParams.name}} v$${{rjsfConfig.app-registration.xParams.version}}\n- $${{rjsfConfig.cloud-run.xParams.name}} v$${{rjsfConfig.cloud-run.xParams.version}}" } } } }3. Run Tests
yarn workspace @red-hat-developer-hub/backstage-plugin-orchestrator-form-widgets test useTemplateUnitEvaluatorAll 10 tests should pass, including new tests for:
4. Test in UI
yarn devdefaultEnvironment→ "production"app-registration.xParams.name→ "app-registration"Customer Request
Resolves customer feature request for hierarchical widget parameter organization (xParams configuration).