Architect 3.10 – Ribbon & Docking Documentation
Version: 3.10
Scope: Ribbon UI, Ribbon commands, Modern Docking
1. Introduction
The Architect 3.10 introduces a major UI/UX modernization aimed at improving discoverability and consistency of the application. This update focuses primarily on the command surface and window management.
The most visible changes are:
-
A fully reorganized Ribbon interface
-
Introduction of Modern Docking, enabling flexible and user-controlled layouts
-
A new visual foundation using FlatLaf, integrated with Radiance for the Ribbon
-
Updated iconography based on Microsoft Fluent UI icons
-
Improved font rendering quality and font-sizing
This document explains what has changed, how users can work with the new UI, where to find the right commands
If some things are unclear or if you would like to have some extra information on certain functionality, please ask for this in the comments.
2. Ribbon Overview
2.1 What is the Ribbon?
The Ribbon is the primary command surface in the Architect. It is located as the top bar in the application. Commands are organized by:
-
Tasks – top‑level tabs such as Home and View
-
Bands – logical groups of related actions within a task
Design goals of the Ribbon:
-
Group related commands by user intent instead of technical origin
-
Reduce duplicate entry points for the same action
-
Improve discoverability of frequently used actions
-
Support contextual behavior without hiding functionality
2.2 Old Ribbon (3.9) vs New Ribbon (3.10)
Old Ribbon (3.9)
-
Home – clipboard, properties, input, rules
-
Insert – favorites, advanced actions, trash
-
Review – compare, translate, work items, notes, trace
-
View – views, indicators, layout actions
-
Help – online help and version info
Problems with the old Ribbon:
-
Overlapping responsibilities
-
Many always-visible commands
-
Ribbon used for things better handled as panels
-
Visual style
New Ribbon (3.10)
-
Fewer, clearer tasks
-
Home focuses on modeling
-
View focuses on layout and modes
-
Favorites and Trash moved to dockables
Key improvements:
-
Less clutter
-
Better context awareness
-
Alignment with Modern Docking
Notable command changes
| Old location (≤ 3.9) | Feature / Band | New location (3.10) | Remarks (3.10) |
|---|---|---|---|
| Home → Default / Function | Expressions | Home → Expression | Split out in three options |
| View → User page | Settings | Moved to General model page | This is the page shown when you select the model node in the tree, User page settings is now just above the Model settings link |
| Review → Trace | Trace component | Home → Trace | Only visible for integrated components |
| Review → Mode | Compare | View → Compare | |
| Review → Mode / Translate | Translate | View → Translate | |
| Review → Work items (Add/Link/View & Edit/Remove) | Work items | View → Work item | Consolidated into one Work item button |
| Insert → Favorites | Favorites | Favorites dockable | Moved to its own dockable |
| Insert → Trash | Trash | Trash dockable | Moved to its own dockable |
| Help → About / Show version | About / Version information | File menu → About | About moved into File menu |
If something seems missing, check View → Show panel and check the available dockables.
2.3 Contextual bands in Architect 3.10
The following table summarizes all contextual bands shown in the Home task and the conditions under which they appear.
| Contextual band | Visible when… | Description |
|---|---|---|
| Trace | An integrated model is opened | Navigate and inspect integrated components |
| Grid settings | A grid is selected | Configure visible rows & details page |
| Function settings | A function is selected | Configure function parameters & caching |
| Process option | A process is selected | Open the selected process component |
| Layout options | The process or expression editor is active | Set automatic and manual layout behavior |
| Panel tab settings | A panel tab is selected | Configure default behavior for panel tabs |
3. Ribbon Feature Description (Architect 3.10)
3.1 Home Task
The Home task contains the most frequently used actions when working with components.
Clipboard
- Paste – insert copied element
- Paste is also a dropdown list with clipboard elements
- Drag and drop from the Paste dropdown
- Same functionality is within the Clipboard Dockable
- Cut – remove element to clipboard
- Copy – copy element to clipboard
Settings
- Name – element name
- Width / Height – dimensions
- Page state – formerly Dummy. Set if a field should be in the page state.
- Plugin – Opens the plugin configuration for an element.
- Process – Open or enable a process for the element
- Functions – Show and add functions of the currently selected records type.
Data Type
- Type – Show and select type
- Decimals – increase / decrease decimals precision for the number or float type.
Expressions
The Expressions band groups all rule‑based behavior of an element in one place.
Each command in this band opens a dropdown with predefined rule options, allowing you to quickly define common behavior without immediately entering advanced rule editors.
This structure is consistent across all expression types, making rules easier to understand and maintain.
Visibility
Controls when an element is shown.
Typical options include:
-
Always visible – the default behavior
-
Never visible – hides the element entirely
-
Visible if … equal to / not equal to …
-
Visible if … is empty / is not empty
-
Manage rules – open the rule editor for more complex conditions
-
Advanced – opens the expression editor directly to create the expression yourself
Editability
Controls when an element can be edited by a user.
Typical options include:
-
Always editable
-
Never editable
-
Editable if … equal to / not equal to …
-
Editable if … is empty / is not empty
-
Manage rules
-
Advanced
Expression
Controls how the value of an element is provided.
The options include:
-
Has default value: the value which the field automatically gets when adding a record in add mode or the value which is used when a record is added with a process or import and the field is not explicitly set.
-
Show value from expression: the value which is shown in the field based on an expression. This makes the field now purely a display field and the field is not added to the database.
-
Show value from function: the value which is shown in the field based on a function of the record type. This makes the field now purely a display field and the field is not added to the database.
Validation
Controls when a value is considered valid.
Typical options include:
-
Always valid
-
Valid if not empty
-
Valid if equal to / not equal to …
-
Valid if not empty
-
Manage rules
-
Advanced
Validation rules are used to enforce correctness before saving data.
Filter
Controls what a grid, dropdown or search link shows or has as options.
Typical options include:
-
Always show
-
Never show
-
Show if … equal to / not equal to …
-
Show if … is empty / is not empty
-
Manage rules
-
Advanced
Trace (contextual band)
The Trace band is shown in the Home task only when an integrated model is opened.
Use Trace component to:
-
Find the component where the element is created
-
Open this component in edit mode
-
Open this component in view mode
This band is dynamically rendered and is not visible for non‑integrated models.
Grid settings (contextual band)
The Grid settings band is shown in the Home task when a grid is selected.
Available settings are:
- Visible rows – control how many rows are displayed in the grid
- Details page – select or show the page set
These settings apply only to grid components and are hidden for other selections.
Function settings (contextual band)
The Function settings band is shown in the Home task only when a function is selected
Available actions:
- Parameters – open and edit the parameters of the selected function
- Enable cache – enable or disable caching for the function
This band is dynamically rendered and hidden when no function context is active.
Process option (contextual band)
The Process option band is shown in the Home task only when a process is selected or when working within a process context.
Available action:
- Edit component – open the selected process component
This band appears only for process-related selections and is hidden otherwise.
Layout options (contextual band)
The Layout options band is shown in the Home task when you are working in a graphical editor, such as while editing functions or processes.
Available actions:
- Autolayout – automatically arrange the graphical elements
- Layout now – immediately apply the automatic layout configuration
These options are context-sensitive and are not shown outside graphical editing contexts.
Panel tab settings (contextual band)
The Panel tab settings band is shown in the Home task only when a panel tab is selected in the page editor.
Available settings:
- Default on dashboard – mark the panel tab as default on the dashboard
- Default on metro – mark the panel tab as default on the metro
This band is hidden unless a panel tab is actively selected.
3.2 View Task
The View task controls view modes, layout, translation options and work items.
Views
The Views band allows switching between different working modes. Each view focuses on a specific aspect of the model or workflow.
Views: Design Tree
Design Tree is the default working mode used for modeling and navigation.
Use this view to:
-
Navigate through modules, pages, processes, and components
-
Edit and structure the application model
Views: Data Model
The Data Model view shows the underlying data model structure of the component.
Use this view to:
-
Inspect entities and attributes
-
Understand data relationships
-
Verify model structure
-
Add indexes
Views: Compare
The Compare view is used to compare different revisions of a model.
How it works:
- Click Compare in the View task
- A dialog opens where you select the revision to compare with
After selecting a revision:
- The application switches into Compare mode
- Differences between revisions are visualized side by side
Views: Translate
The Translate view is used to work with translations.
How it works:
- Click Translate in the View task
- Click Choose to open the language selection dialog
- Select the source and target language
In this mode:
-
Translation-related structures become visible in the Explorer
-
Ribbon controls adapt to support translation actions
Window
-
Show panel - See and enable the available panels to use in the Architect
-
Reset layout - Sets the panel layout back to the start settings.
Translate
-
Language selection (set translation of the selected element)
-
Set language - sets the language in which the component is shown in the Architect and what the primary language of the component is. Let it be English unless you know you need to change it to another language.
-
Export - Create a csv file of all the elements and their translations. The languages used are based on the languages set in the language selection part. Use this csv file in an external application.
-
Import - Import an exported csv file of all the elements and their translations. The csv file is interpreted that the first language column is only for display purposes in an external application, the values of the second language column is used to import those values for that element and language in your component.
Work Item
-
Add new item
-
Edit item (if there is one)
-
Remove item (if there is one)
Adding a new work item
When the selected element does not have a work item, the Work item button shows a single action.
A dialog opens where you can enter the work item details.
Element already has a work item
When the selected element already has a work item, the Work item button changes behavior and offers two actions.
- Main button (Edit item) – opens the existing work item for editing
- Remove item – via dropdown
When editing, the same dialog opens, allowing you to change the work item details:
Viewing all work items
All active work items of the selected element are also visible in the Work items dockable:
4. File Menu
The Architect 3.10 introduces a redesigned File menu. While the functional scope remains largely the same, the structure, presentation, and feedback to the user have been significantly improved.
Notable changes:
-
Support for recent models and components directly from the Open action
-
Build was renamed to Generate, reflecting its actual purpose more clearly
-
About Architect was moved from the former Help task into the File menu
5. Modern Docking
Architect 3.10 introduces Modern Docking, replacing the legacy docking system.
It allows users to rearrange panels (dockables) to create a workspace that fits their workflow, while enforcing a consistent and supported layout model.
Dockables include panels such as Explorer, Properties, Log, Clipboard, and others.
5.1 Docking Concepts
Modern Docking in Architect 3.10 is based on three core interactions:
-
Drag – move a dockable
-
Drop – place it in a new position
-
Stack – group dockables together as tabs
You can also close the dockable by pressing the X in the top-right corner
5.2 Dragging a Dockable
To move a dockable:
-
Place the mouse cursor on the header of the dockable
-
Click and hold the mouse button
-
Drag the dockable
While dragging:
-
Docking indicators appear on screen
-
These indicators show all valid drop locations within the main window
5.3 Dropping a Dockable
When dragging a dockable, you can drop it in the following supported locations:
-
Left / Right / Bottom – dock the panel to that side of the window
-
Center – dock the panel as a tab within another dockable group
The interface shows a live preview of the resulting layout before you release the mouse button.
5.4 Stacking Dockables (Tabs)
Dockables can be stacked together to form tabbed panels.
To stack dockables:
-
Drag one dockable onto the center docking indicator of another dockable
-
Release the mouse button
Result:
-
Multiple dockables are grouped as tabs
-
You can switch between them by clicking the tab headers
Stacking is useful to reduce screen clutter while keeping related panels easily accessible.
5.5 Resetting the Layout
If the workspace becomes cluttered or confusing, you can always restore the default layout.
To reset the layout:
- Open the View task in the Ribbon
- Go to the Window band
- Click Reset Layout
The layout is restored to the default configuration defined by Architect.
Resetting the layout does not affect your model or data and is always safe to use.
5.6. Dockable Toolbars
In Architect 3.10, dockables use a unified toolbar design wherever applicable.
These toolbars appear at the top of dockable panels (such as Explorer, Problems, Favorites, Clipboard, Page Editor etc.) and contain actions that are specific to the purpose of the dockable.
6. View Mode (Read‑Only Models)
Architect supports opening models in View Mode. In this mode, the model can be inspected and changed but cannot be saved.
In the Architect 3.10, View Mode is indicated explicitly using a disclaimer message:
