How Can We Help?

Custom Fields

 
Deepser allows you to create dynamically fields into the DataBase, to customize the forms and the set of data to meet every organizations’ need.
To give an example, think about the need of some organizations to insert a text field with the address of a building to notify an operator that has to go to a customers’ office. Or think about if we wanted to implement a specific counter for all the reminders of a certain type of operations.
To create a new cusotm field go to the menu: System > CustomFields.

 

The first grid displayed lists all the modules installed in Deepser.
To see the custom fields of an entity (we will use the Service module, entity Operations, as an example) click on the row of that grid.

 

We can now see the main screen with the data of the model we are editing (Module / Entitiy).
The tab “Model” is not relevant as it lists the main data for the entity we are editing.

 

The Fields tab is the most important: it contains all the custom fields for that Model.

 

Here we can see al the fields that are not the “default” fields of Deepser.
To create a new custom field, click on Add Field.
Now we can define a new field, that will be then displayed on the available fields in the Form Templates.

 


The fields have the following meaning:

 

Field Meaning
Column Name Name of the column in the DataBase.
Column Type Type of the column in the DataBase: text, long text, integer number, decimal, date or don’t create a column if we need only a field to display information not stored in the DB.
Element Type HTML element diplayed on the form. The values are:
  • Activity: it will display an element to insert or update Activities.
  • Attachment: it will display an element to insert or update Attachments.
  • Category: it will display an element to change the Categories of the record.
  • Date / Datetime: an element to insert Dates (or Date/Time).
  • RelationGrid: a grid to insert relations between records (see relations).
  • Select: a select-box.
  • Text: a textbox.
  • TextArea: a text-area element.
Label Label of the element.
Element Name Name of the HTML element (attribute name inthe HTML code).
Class CSS class for the element.
After Element HTML HTML code appended to the element.
Default HTML If we want to overwrite the default HTML code of an element we can use this field. For example, if we have a text-area element that we want to use to display a map we can customize here the HTML code.
On Click Javascript event triggered when clicking the element.
On Change Javascript code triggered when the element value changes.
Values For the Select fields, we can insert a list of values passing a PHP array (key/value pair).
Custom Element Data An external source to populate the field, passed as a PHP array. If we wanted to implement a REST API integration with an external software we could use this field to populate, for example, a select-box.
Status
  • Enabled: the field is enabled and created in the DataBase.
  • Disabled: the field is not active.
  • Pending: the field has just been created in the interface, but not in the DataBase. Use this setting when creating a field, before adding it to the DB. This option is useful to create the field in the Deepser interface, but to tell the system that has to add it to the DB structure in a second moment. For example, if we create the field when there is a huge activity on the database (during the working hours), we can keep the field with status = “Pending” and then create it in the DataBase only when the DB activity is lower (after the working hours, to let us check all the configurations and the backups).
Next Custom Events
Table of Contents