Field Customization

From RangerMSP Wiki - PSA software for MSPs and IT services providers
Jump to navigation Jump to search
Customization > Field Customization

CommitCRM is very flexible. You can customize reports, rename field labels, create new tabs and new data fields, and manage values for drop-down lists, etc.

Customizing Existing Fields

Fields in CommitCRM can be customized when needed. You should modify the default settings only when required; the system defaults are usually sufficient.

Fields in CommitCRM can be customized with the following settings:

  • The Name of the fields as displayed throughout the system where a field name is displayed
  • The field Label and Hint
  • The field title on data grids/tables – Column Title
  • The default value for new records
  • The drop-down list that will be displayed for drop-down selection list fields
  • Enabling the field to be updated in batch update (Accounts fields only)
  • Enabling lists to be sorted by this field

To modify the field settings, log in to CommitCRM as a user with full privileges, and double-click on the field label. The field's Settings window will open. All modifications will be saved when you confirm before closing the window.

Managing drop-down list values
You can also manage values for drop down lists throughout the system. For example, you can add values to the Ticket Types (e.g. Hardware, Installation, Software etc.). To add or modify values in the list, select [edit list...] from the drop down list.

There are pre-defined fields labeled Field (e.g. Field1, Field2) which can be customized as you see fit (you can also rename their label to your needs). For example, you can use Charge Field1, modify its label to "Status", and edit the values list to include possible values for the Status of a Charge.

Adding New Tabs

You can add new fields by going to each window, and under the window's menu, go to Tools > Tab Management (e.g. Accounts > Tools > Tab Management).

File:Commit setup guide tab management menu.zoom61.png

Create a new tab in the Tab Management window. You can also rename user-defined tab by selecting the relevant tab and clicking the Tab Properties icon. You can manage which tabs are displayed for the entity using the Tools > Tab Management window.

Notes:

  1. The 'General' tab cannot be removed from the display.
  2. Tabs order cannot be modified.


Creating New Fields

To add new fields to user-defined tabs you can use two options:

  1. Right-click the tab area and choose Add New Field to Tab.
  2. Go to Tools > Field Management and from the Field Management Window, click the New icon to add a new field.

You can either add existing fields to be displayed in your tab, or create totally new fields in the database that will be displayed in your tab.

File:Commit setup guide field new window.gif

When adding a new field (as opposed to an existing field), you should choose the field type from the field types list.

Field type can be a simple text or numeric field, or a selection field pointing to objects from your database, such as Account, Document, or when using the Linked Object Type, you can choose between Asset, Ticket, Opportunity or Contract.

You can create as many new tabs as needed and create as many new fields as needed. You can also design the layout of the tab page as best suits your needs.

In any case, it is always recommended to backup your CommitCRM installation before performing any customization!


Tab Management

Tabs can be shown or hidden as required in the List or the Tabs Bar & List, in either Simple layout mode or Advanced. Even tabs which are hidden can still be quickly accessed through the new drop-down All Tabs menu which appears at the top right corner of the displayed tabs.

To change the order of tabs:

  1. Open the Tab Management window (Tickets > Tools > Tab Management for example).
  2. Select the relevant tab in the list.
  3. Click the up or down arrows.

To set the tab visibility:

  1. Open the Tab Management window.
  2. Select the tab in the list.
  3. Click Edit tab settings.
  4. In the Tab Properties popup you can now define the name of the tab and you can specify whether to show or hide the tab in either Simple or Advanced layout modes and if shown then whether it should be in the tabs bar and list or just the tabs list.