New feature added in Joget DX 8:
- ERD
- X-Ray
- Screenshot
Introduction
Advanced Tools can be found inside the Form Builder, Datalist Builder, Userview Builder as well as the Process Mapper.
Addon Builder plugins also have access to this feature.
Get Started
The easiest way to see how to access the Advanced Tools is to use the existing built-in App Expenses Claims. Here are the steps:
- Start the Joget Server and open the App Center.
- Log in as admin and click on the pencil icon on the Expenses Claim to open the Design App. (see Figure 1)
Figure 1
3.Click on Expense Claim New and you will be directed to the Form Builder.
4.Click on Advanced Tools on the top right.
Figure 2
5.In Advanced Tools, you will find 6 tabs in all the builders mentioned with the exception of Form Builder and Process Mapper (see Figure 3).
- In Form Builder, the additional tabs are Table and Tooltip.
- In the Process Mapper, there is only one tab which is the i18n Internationalization
Figure 3
Advanced Tools Properties
Showing Advanced Tools
To reveal the advanced tools, the advanced tools button can be clicked.
Figure x : Show Advanced Tools
Hiding Advanced Tools
The > button can be clicked to hide the advanced tools.
Figure x : Hide Advanced Tools
Tree Viewer
The tree viewer in the first tab provides the app designer with the overall structure/definition view so that one can easily spot any anomaly and fixes it immediately without too much hassle and time spent. If the label of the element is empty, it will show the ID instead. Else, it will show label.
Figure 4 Tree Viewer
Clicking on the edit (pencil) icon on the right of the node allows one to configure/edit its properties right away. Upon saving the properties, the tree viewer will refresh itself.
Figure 5: Editing a node
X-Ray
The X-Ray is a feature that provides a overall view of what a structure consists of, what is the type and ID of the structure. For example, in Figure 1x, it is shown that there are 4 types of object in the section:
- Section
- Column
- Custom HTML
- Calculation Field
Figure x : X-Ray Feature
As the structure is top down, it can be translated as the Section being the parent of two Columns and the ID of the parent is section3. The first columns contains a Custom HTML type where the ID is field6_1 and the second columns contains a Calculation Field Type where the ID is total.
Permission
The Permission tab provides the app designer with fine-grain control over managing the permissions of each individual element in the builder.
Figure 6 Form Builder Permission
Clicking on the "Add Permission" button allows one to configure the permission rule for a role/group based on a permission type (see Figure 7).
Figure 7 Configure Permission
For each Permission rule added, determine which element will be visible for the selected role under the Authorized column.
Visibility controls differ based on Builder types (see Figure 6, 8 & 9)
Figure 8 Datalist Builder Permission
Figure 9 Userview Builder Permission
For the Form Builder, additional permission can be set at the Section element and determine whether they are hidden or read-only under the Unauthorized column on the right.
For the Datalist Builder, determine which column/filter is visible. Additionally, determine which columns is visible during export.
For the Userview Builder, additional permission can be set at the Userview Category element.
New Feature
Newly introduced in Joget DX
Usages
| Description |
|---|
In the second tab, the app designer can inspect where the current entity is being used. From the screenshot example above, we can tell that the form is being used in another form and also being part of a workflow process. With such a feature, the app designer will be able to manage the form design well within the scope of its usages. |
Table
| Description |
|---|
The table tab is available in the Form Builder. With this feature, the app designer can tell on which other entity is sharing/writing into the same database table the current form is currently pointing too. From the screenshot example above, we can see that the table is being accessed by multiple process tools and forms. We can also click on the Show Table Usage In Other Apps to check if there are other apps that are writing to the same table too. At the bottom of it, existing table columns are listed down for the app designer's reference. |
ERD
The ERD is a feature that fleshes out the relationship between the tables.
Figure x : ERD Feature Part 1
The diagrams can be clicked to reveal more detailed information about the table such as which forms uses the table and what part of the table is having a relationship with other tables.
Figure x : ERD Feature Part 2
Relationship Description
Describes what kind of relationship it is having with another entity.
Figure x : Relationship Description Feature
Existing Table Columns
The Existing Table Columns feature displays the existing table columns.
Figure X : Existing Table Columns feature
Table Usage
The Table Usage Feature displays the usage of the Table. Such as where it has been used.
Figure x : Table Usage Feature
i18n Internationalization
| Description |
|---|
Labels defined in the builder will be automatically listed down here for internationalization purposes. We can define in as many languages as we want to. |
Tooltip
| Description |
|---|
Labels defined in the builder will be automatically listed down here for tooltip purposes. We can define in as many languages as we want to. New Feature Newly introduced in Joget DX |
Diff Checker
| Description |
|---|
The Diff Checker capability makes collaborative works possible without losing the modifications done by other teammates who are working on the same entity at the same time. In this section, one can tell which are the changes that have been made since the initial first load of his/her builder against the copy in the server. Click on the Merge & Update button will ensure that all modifications are merged. Upon pulling the latest changes from the server, clicking on Merge & Update will merge the changes, but will NOT automatically save the form, to allow users to continue editing. Take note that the Diff Checker does NOT pull changes from the server in real-time. To see new changes, click into the Diff Checker tab again. |
JSON Definition
| Description |
|---|
We can inspect the actual definition of the entity that we are working on here. If required, we can amend the definition within the text editor itself and click on the Update button to commit. |
Screenshot
The screenshot is a feature that takes a screenshot of what it will look like in the Userview. The screenshot can be downloaded by clicking the Download button located at the top right corner. This is useful for instance, sharing the design or look and feel to a client or even an employer.
Figure x : Screenshot Feature