Overview
DemandFlow includes two row types for working with raw structured data: JSON Editor (for editing) and JSON Viewer (for read-only viewing). These are advanced tools primarily used for configuration, data management, and scenarios where the full data structure needs to be visible.
JSON Editor
The JSON Editor row type provides a full-featured editor for viewing and modifying structured data stored on the record. It offers tree view, code view, and form-based editing modes.
JSON Editor Properties
| Property | Required | Description |
|---|---|---|
| Type | Yes | Must be set to jsoneditor |
| Header | No | A heading displayed above the editor. |
| Visibility | No | A condition controlling when this editor is visible. |
JSON Viewer
The JSON Viewer row type displays structured data in a read-only format, allowing users to inspect data without the ability to modify it.
JSON Viewer Properties
| Property | Required | Description |
|---|---|---|
| Type | Yes | Must be set to jsonviewer |
| Header | No | A heading displayed above the viewer. |
When to Use
These row types are typically used in advanced or administrative contexts:
- Entity definition editing — the DEFINITION entity uses JSON Editor for editing row configurations
- Integration configuration — editing structured configuration data for external system integrations
- Data inspection — viewing the raw data structure of a record for debugging or verification
- Advanced settings — managing complex configuration that does not fit neatly into standard form fields
Best Practices
- Use JSON Viewer (read-only) for informational displays where editing should not be permitted
- Use JSON Editor only on panels or tabs intended for advanced users or administrators
- Consider whether a form-based interface would be more appropriate for most users, reserving the JSON Editor for power users
- Place JSON editors on a dedicated "Advanced" or "Configuration" panel to keep the main interface simple