Introduction
Kepion's editing experience spans the Modeler, from configuring forms to writing rules to designing dashboards. This article explains everything application modelers need to know about Kepion's editing experience.
Edit Bar
The Edit Bar makes common editor actions easily accessible, notifies users of new versions, and shows other active users. The Edit Bar appears above the ribbons across our various editors (e.g., dashboard, form, data rules).
The Edit Bar has three components:
Actions
Actions allow users to interact with and manage an item (e.g., dashboard, form, rule, etc.). Different actions are available depending on which mode the editor is in.
View mode
View mode is enabled by default when you open one of Kepion's editors. This mode is equivalent to read-only, i.e., application modelers cannot make any changes.
| Action | Function |
|---|---|
| Edit | Changes the Editor to Edit Mode |
| Remove (also in Edit Mode) | Deletes the item |
Edit mode
Edit mode allows application modelers to make changes to the item.
| Action | Function |
|---|---|
| Revert | Reverts the Editor back to View Mode and discards changes |
| Save | Saves the current changes |
| Save as | Saves a copy of the updated item as a new item and discards changes |
| Remove (also in view mode) | Deletes the item |
Save/Save As
Kepion's saving process was designed with the understanding that multiple Modelers could be working on different items in the same application. Without proper protections in place, users could be saving over each other's work, erasing valuable progress.
Kepion supports concurrent editing as follows:
- Checks for changes every few seconds and notifies users with the New Version Indicator.
- Provides ample notice of the result of saving changes.
Note: Kepion does not support concurrent editing on a single item. For example, when two users are working on the same Dashboard, only one version can be saved at a time. Concurrent editing is supported only for individual savable items; it will be supported for items that affect an application's structure (i.e., Dimensions and Models).
Save
Selecting Save will apply changes to the original item.
If there are no new versions available upon save, you will see the standard prompt for confirmation:
If there are new versions available upon save, you will see the following prompt:
Select the action as desired:
- Save As - Saves a copy of the updated item as a new item and discards changes.
- Overwrite - Saves over the existing item. Be careful as this action could overwrite other users' work.
Save as
Selecting Save As creates a copy of the updated item as a new item and discards changes.
Enter a name for the new item and select Save.
The new item will appear under the original, in the left navigation.
New Version Indicator
The New Version Indicator appears when a new version of an item is available.
Select A new version is available to retrieve the new version of the item.
Note: When you retrieve a new version, changes to your current version will be lost.
Active users
Active users displays the other users who are currently in edit mode on an item.
The user icon shows the first letter of the user's ID. You can hover over the icon to see the user's full ID. Hover over the +n icon to see the full IDs of additional active users.
Note: You will not see yourself listed as an active user.
Save All
Selecting Save All will apply changes in bulk to original items across the application.
If there are no newer versions of items in the application, selecting Save All will take you through the standard saving process.
If there are newer versions of items in the application, selecting Save All will trigger the following warning:
In this case, no items will be saved. You need to go to each listed item and address them individually.