The Essential Project Forum

Hi everyone! I’m sharing Essential Open One Page Editor, a set of standalone HTML editors that make it easier to collect data for the Essential Project.

What it does

• Import / export JSON
• Export .dup packages compatible with Essential Open Source, Docker, and Cloud
• Currently includes the Value Stream Editor, covering:
  • Value Stream Summary
  • Value Stream Canvas
  • Value Streams Application Mapping

Why a single page?
A one-page UI is friendlier and simpler than spreadsheets. IT and business users can enter information quickly without dealing with workbook structures or formulas. Each Value Stream can be saved as a JSON draft for later review by the architecture team and then exported as a .dup for import into Essential.

The editors do not check consistency against an Essential repository. Items are reconciled by name during .dup import. These one-page editors work directly with the information shown in the views; complementary details can be added later in Essential using Protégé (Open Source) or the web editor in the Docker/Cloud versions.

How to try

1. Clone the repo.
2. Open editors/value-stream-editor-en-standalone.html in a modern browser.
3. Fill in the form → Export JSON (draft) or Export .dup (for Essential).

Screenshots

• Value Stream Summary tab:
  
• Value Stream Canvas tab:
  

Roadmap

• Additional one-page editors (Capabilities, Applications, Processes)

Repository

• GitHub: https://github.com/terryvel/essential-o ... age-editor

Feedback and contributions are very welcome!

Terry,

This is great, are you OK for us to promote this and make people aware?

Regards

John

Hi John,

Absolutely! Please go ahead and promote it and help spread the word . It’ll be a pleasure to contribute to the community.

I’ve just published a new one-page editor for the Business Strategy Overview and Strategic Goals Model. If there are specific interfaces where Cloud/Docker customers need more help, I’m happy to try create those - suggestions are very welcome.

Regards,
Terry

Hi everyone,

I’ve just added a new Process Editor to the Essential Open One Page Editor repository.

With this editor you can quickly create processes in a hierarchical structure and capture the core attributes. It currently supports:

• Fields: ID, Name, Description

• Hierarchy: add processes and sub-processes with ease

• Embedded BPMN: an in-page BPMN 2.0 editor powered by bpmn-js

Screenshots



How it works (short version)

• Model your process tree (ID, Name, Description).

• Draw the BPMN2 diagram in the embedded editor.

• Export a [.dup] update pack from the tool.

• Import the [.dup] into Essential OS.

• Open a Business Process Flow the included report renders the BPMN diagram.

Important notes / current limitations

• For now, the BPMN2 diagram is stored entirely within a single Diagram instance.
  Edits made directly to diagram elements inside Essential after importing the [.dup] will not sync back to the diagram.

• I’m not a BPMN specialist. The BPMN2-to-Essential mapping used here is pragmatic and likely needs refinement. Contributions to validate and improve it are very welcome. Over time, we can evolve to render the diagram in the Viewer directly from registered components.

Viewer support
The repo also includes an Essential report adapted to display the BPMN diagram when opening a Business Process Flow.


Repository
https://github.com/terryvel/essential-o ... age-editor

Feedback, testing, and PRs are appreciated, especially around the BPMN mapping and round-trip editing approach.

Best,
Terry

Wow Terry, what a great job! The missing Editors for Essential_Viewer are really the biggest thing users miss to maintain data. Protegé is nice, but needs lots of training.

Hello everyone,

I just added a new editor to the Essential Open One Page Editor repository.

This one is for handling Business Domains and Business Capabilities. With it, you can easily manage the relationships and hierarchies between them.

I'm still open to suggestions

Screenshots





Repository
https://github.com/terryvel/essential-o ... age-editor

Regards,

Terry
https://terryvel.com.br/

Hi Terry,
cool stuff. Thanks for your brilliant ideas and contributions!
Holger