How to add and use a Custom Field

XTRF Platform provides you with a number of fields that allow you to add as many pieces of information as you need to easily control the operations of your company. However, it sometimes happens that you might need some non-standard fields to add a particular piece of information. XTRF Platform is fully customizable, and therefore it allows you to add non-standard fields. The custom fields you can add come in a variety o types and can be added in various areas of the Home Portal. There is an article explaining the role of custom fields in XTRF that we recommend reading before this one:

You can learn how to add a custom field to the selected area of the Home Portal by following the steps provided below.

Adding a new Custom Field

First of all you need to add your own Custom Field in the configuration of the Home Portal. To do so, perform the following steps:

  1. When in the XTRF Home Portal, click the gear icon in the top bar.
  2. In the configuration accordion menu click on Custom Fields and Columns.
  3. Click the Add Custom Field button in the upper right corner. You are directed to the Add Custom Field page.
  4. In the Name field provide the name for the new custom field.
  5. From the Preferences drop-down menu select whether the custom field should be:
    • Visible and accessible both on user interface and from API (default),
    • Visible on user interface but accessible only from API,
    • Visible and accessible only from API.
  6. (Optional) Provide a short description of the purpose of the custom field.
  7. From the Scope drop-down menu select the area of the Home Portal in which the custom field is to appear.
  8. From the Type drop-down menu select the type of the custom field. Note, that the limit is 10 custom fields of one type within a scope.
  9. (Optional) If you select Multiple Selection or Selection type, Items section appears. Click Add... to add a new item. You can add as many items as you need.
  10. In the Default Value section select what will be selected by default in the custom field.

  11. Click the Add button to save the settings of the custom field and add it to the system.

Set up the Order of the Custom Fields

If you have prepared multiple custom fields, you might need to prepare an order in which the custom fields are displayed. To change the order of custom fields, follow the steps below:

  1. In the configuration accordion menu click on Custom Fields and Columns.
  2. Click the Order tab.

  3. From the Scope drop-down menu select the Home Portal's area in which you wish to manage the order of custom fields.
  4. (Optional) In Client and Vendor sections you can add groups to categorize your custom fields. To add a group:
    1. Select the Identification Data or other default tab.
    2. Click the Add Group button. A new group appears under the tab.
    3. Add a name for the new group.
    4. You can now move your custom fields to the new group. To move the custom fields to the group simply click and hold them and then drag and drop in the proper group.
  5. In the custom fields list click the proper custom field, drag it and drop in the location of your choosing. You can drop the custom field in different groups, if there are any, and change it's place in relation to other custom fields.

Use of the Custom Field

Now, when you have prepared some custom fields and configured their order, you might want to know how to find them in the interface. The following steps describe how to find a custom field added to the vendor's main data tab. To do so, perform the steps:

  1. Go to the Vendors view.
  2. Select a vendor.
  3. Click the Main Data tab.
  4. You can find your custom fields in the Identification Data sub-tab. The custom fields are at the bottom of the table. The custom fields are displayed in the order prepared in the configuration.

  5. Click the Edit button to provide information in the custom fields.
  6. Click the Save button to save all the changes.

This article was helpful for 1 person. Is this article helpful for you?