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 (see Implement a form), 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 (and uiOpenFormByKey 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; see Adding custom code.

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.