Plugins 〉Data Manipulation

Panel

community

Data Manipulation

Overview
Installation
Change log
Related content

Data Manipulation Panel for Grafana

Form Panel

Introduction

The Data Manipulation Panel is a conceptually new plugin for Grafana. It is the first plugin that allows inserting and updating application data, as well as modifying configuration directly from your Grafana dashboard.

Requirements

Grafana 9.2 and Grafana 10 are required for major version 3.
Grafana 8.5 and Grafana 9 are required for major version 2.
Grafana 8 is required for major version 1.

Getting Started

The Data Manipulation panel can be installed from the Grafana Catalog or utilizing the Grafana command line tool.

For the latter, use the following command.

grafana-cli plugins install volkovlabs-form-panel

Highlights

Provides functionality to create customizable forms.
Supports the Custom Code for the Initial and Update requests.
Allows specifying a GET request to get initial values and DELETE, PATCH, POST, and PUT requests to send values updated in the form.
Allows adding Header fields to the Initial and Update requests.
Allows customizing Submit, Reset buttons, and form layout.
Allows splitting form elements into sections.
Allows requesting confirmation before Update request.
Allows sending all or only updated elements in the Payload.
Allows displaying Success and Error notifications from the Custom Code.
Supports Code Editor suggestions for available parameters.

Documentation

Section	Description
Architecture	Explains the Architecture and how to use Grafana and API behind NGINX.
Data Flow	Explains the data flow and its specifics.
Form Elements	Explains the specifics of form elements.
REST API	Explains the REST API architecture and how to use NGINX.
Custom Code	Demonstrates how to access panel options, API responses, form elements, Grafana services.
Features	Demonstrates panel features.
Servers	Demonstrates various server API implementations
Release Notes	Stay up to date with the latest features and updates.

Feedback

We love to hear from you. There are various ways to get in touch with us.

Ask a question, request a new feature, and file a bug with GitHub issues.
Subscribe to our YouTube Channel and add a comment.
Sponsor our open-source plugins for Grafana with GitHub Sponsor.
Star the repository to show your support.

License

Apache License Version 2.0, see LICENSE.

Installing Data Manipulation on Grafana Cloud:

For more information, visit the docs on plugin installation.

Change Log

3.7.0 (2024-03-10)

Breaking changes

Requires Grafana 9.2 and Grafana 10

Features / Enhancements

Added update enabled option and variables examples, fix sync option (#356)
Added files upload examples and fix form data header (#357)
Added code parameters with builder and add initial request to element value changed code (#358)
Allowed to disable columns in confirmation modal (#360)
Updated dependencies and Actions (#368)
Added skipping elements hidden using Show If from update payload (#369)
Add multiple files option (#375)

3.6.0 (2023-01-10)

Features / Enhancements

Added backend service to custom code (#331)
Added support for file base64 encoding in payload (#331)
Added Context parameter to Payload (#331)

Bugfixes

Fixed element custom options source (#334)

3.5.0 (2023-01-04)

Features / Enhancements

Added disable if code (#321)
Updated reset request visibility if reset button is hidden (#322)
Added code options source for select element (#323)
Added value changed code (#324)
Updated to Node 20 (#326)
Added suggestions for code editors (#327)
Added reset button confirmation (#328)

3.4.0 (2023-12-14)

Features / Enhancements

Add ability to disable panel syncing (#298)
Update ESLint configuration and refactor (#299)
Update Collapse from @volkovlabs/components (#299)
Add EventBus and AppEvents to Context (#307)
Add replacing variables in Payload functions (#309)
Update to Grafana 10.2.2 and Volkov labs packages (#313)
Add options migration (#315)

Bugfixes

Fix draggable control to support upcoming Grafana changes (#314)

3.3.0 (2023-11-21)

Features / Enhancements

Add Disabled Text Area element type (#243)
Add Confirmation Window options (#242)
Add context object to the custom code (#255)
Add Select Options From Query (#254)
Add NumberInput component which allows to enter decimals (#291)
Update to Plugin Tools 2.1.1 (#292)
Use Grafana Access Policy to sign plugin (#292)
Update to Grafana 10.2.1 (#292)
Update ESLint configuration (#294)
Add Autosize Code Editor (#295)
Add Data Source option for Reset button (#296)
Add Link Element (#297)

Bugfixes

Allow to enter zero value in number field (#288)

3.2.1 (2023-09-07)

Features / Enhancements

Add backward compatibility for option id (#244)

3.2.0 (2023-09-06)

Features / Enhancements

Add min and max date for date time element (#225)
Map Data Source values to elements (#224)
Update element Show If to support variables (#230)
Add clearing errors before initial and update requests (#232)
Add URL encode to variables (#231)
Allow empty section name (#228)
Add Query Field Picker for Initial Request (#227)
Add File element type for File Upload (#229)
Add converting option value to string and number based on type (#233)
Add loading states for Initial, Update and Reset button actions (#234)
Add support for asynchronous custom code (#234)
Update Query and Data Source initial request (#237)
Add icons for radio and select options (#238)

3.1.0 (2023-08-13)

Features / Enhancements

Update jest selectors to use npm package (#209)
Add onChange to update elements in local state within custom code (#214)
Update ESLint configuration (#215)
Add Multi Select element (#217)
Add conditional element visibility (#219)
Add custom payload code editor (#220)
Add custom reset code editor (#221)
Add Data Source request (#222)

3.0.0 (2023-07-15)

Breaking changes

Requires Grafana 9 and Grafana 10.
Form Elements are kept in the local state and not saved in the dashboard by default.
Local states and elements refactoring may introduce breaking changes. Please test before using in Production.