Custom Form entity
A Custom Form is a form for which the code remains free.
Examples of custom forms include:
- A non-database form, such as a login form.
- A database form with only a single operation, such as an insert-only form.
- A form that serves as the user interface for JSON calls.
A Custom Form entity is represented as a 4fdc file which can be opened and edited in Form Designer.
When a Custom Form entity is implemented from the diagram, the 4fdc file is
created as well the following generated code:
- The PUBLIC TYPE definition related to the records of the custom form.
- The
uiOpenForm
function used by incoming relations to open the custom form (anduiOpenFormByKey
if the records of the custom form contain a unique key). - The functions related to the outgoing relations.
Important: If you create a non-database custom form and involve it in a relation
with a form that specifies a database, update the non-database custom form to specify the
name of the database in its databaseName property.
The generated code can be customized.
Custom forms provide features not supported by CRUD forms:
- Multiple master records are supported.
- A form without any record is supported. This is typically a form with a static field.
Right-click the Custom Form entity in the diagram to display a context menu of options.
Menu Option | Description |
---|---|
Open | Opens form in Form Designer. |
Implement Custom Form | Creates a new blank Custom Form definition file (4fdc) to design from scratch. |
Implement Custom Form from Database | Provides a wizard to create a Custom Form definition file (4fdc), allowing you to pick the columns and general display of your form. This option is generally preferred. The form can be modified after it is created. |
Convert to | Converts entity from one type to another. |
Add Relation To | Add a relation starting from the select form. |
Locate in Project | Locates and highlights the selected item in the project. |
Filter Items... | The Filter View dialog allows you to hide and show items on a diagram. |