Skip to content

Latest commit

 

History

History
77 lines (51 loc) · 3.87 KB

README.md

File metadata and controls

77 lines (51 loc) · 3.87 KB

MetaConfigurator

Description

MetaConfigurator is a form generator and schema editor for JSON schema, making editing configuration files, research data and schemas easier and more enjoyable.

Try it out: https://www.metaconfigurator.org

Experimental Web playground: https://metaconfigurator.github.io/meta-configurator/

Expand to see animated screen captures of MetaConfigurator.

Generated form for assisted editing of the JSON file

import_schema

graphical_editor

Schema Editor

schema_editor

Interactive Schema Diagram

schema_diagram

Motivation

Creating and managing files that have to conform to a specific format or structure can be a challenging task with a simple text editor, especially if you are not familiar with the specific file formats or syntax. For example, if you want to create a GitHub Actions workflow file, you have to follow the specified structure. This structure is defined in a JSON schema, which is a JSON document that describes the structure of another JSON document. But how to make sure that the file you created is valid and conforms to the schema?

Solution

The project offers a GUI-based solution that simplifies the creation and maintenance of configuration files and schemas. Users can interact with a user-friendly interface that provides intuitive controls and abstracts away the complexities of file formats and syntax, making it accessible to users with limited technical knowledge. Our tool has the following advantages:

  • It is easy to use and does not require knowledge of the underlying file schema
  • It is flexible and can be used for any JSON schema (we currently support draft-2020-12)
  • Less error-prone than manually editing configuration files

More details can be found in our paper and our user guide.

Development

Check out the documentation for developers.

Citing MetaConfigurator

To cite MetaConfigurator in your publications, please use the following BibTeX entry:

@article{metaconfigurator2024, 
year = {2024}, 
title = {{MetaConfigurator: A User-Friendly Tool for Editing Structured Data Files}}, 
author = {Neubauer, Felix and Bredl, Paul and Xu, Minye and Patel, Keyuriben and Pleiss, Jürgen and Uekermann, Benjamin}, 
journal = {Datenbank-Spektrum}, 
issn = {1618-2162}, 
doi = {10.1007/s13222-024-00472-7}, 
abstract = {{Textual formats to structure data, such as JSON, XML, and YAML, are widely used for structuring data in various domains, from configuration files to research data. However, manually editing data in these formats can be complex and time-consuming. Graphical user interfaces (GUIs) can significantly reduce manual efforts and assist the user in editing the files, but developing a file-format-specific GUI requires substantial development and maintenance efforts. To address this challenge, we introduce MetaConfigurator: an open-source web application that generates its GUI depending on a given schema. Our approach differs from other schema-to-UI approaches in three key ways: 1) It offers a unified view that combines the benefits of both GUIs and text editors, 2) it enables schema editing within the same tool, and 3) it supports advanced schema features, including conditions and constraints. In this paper, we discuss the design and implementation of MetaConfigurator, backed by insights from a small-scale qualitative user study. The results indicate the effectiveness of our approach in retrieving information from data and schemas and in editing them.}}, 
pages = {1--9}
}

License

This project is licensed under the MIT License. For more information, see the LICENSE file.