Discover. Learn. Grow.

Introduction

Field Settings is the base from which available Filters, Import fields and field labels are being pulled from. The field settings allows you to manage which fields exist in CustomerGauge, and how they're called. You can add fields to various "Objects" (types of data) that exist within CustomerGauge.

Good to Know

• Field Settings is only available to Admin users without Data Access Restriction
• Fields can not be moved between objects
• Fields can not be removed
• Field Settings currently apply to the following areas:
  • Reporting Filters
  • Account and Account Alias Imports
• Your CSM will need to manage fields used in the following places:
  • "Legacy Import Data" (Legacy Survey import and Revenue)
  • Export Engine

Using the Field Settings

You can find the Field Settings by navigating to Settings → System Admin → System Settings → Field Settings.

1. Navigate the tabs to the objects you'd like to interact with.
2. In the Accounts column, you can find all the properties configured on the Account level. Hover over the existing fields to access Edit.
3. Adding fields in Accounts creates a copy of that field on Survey Records in Field Settings. You can upload data on survey imports once your CSM also adds it in the backend for you - please tell them the "Classic Label" name for the field (visible while in Edit).
   1. This allows you to upload a snapshot in time. E.g. the Account Manager for the survey sent now is "John", but a year from now it might be "Jane". When you look back to "now", a year from now, you'd still want to see the survey attached to "John", while the account belongs to Jane now.
4. In the Contacts column, you can find all the properties configured on the Contact level. Hover over the existing fields to access Edit.
5. Adding fields in Contacts creates a copy of that field on Survey Records in Field Settings. You can upload data on survey imports once your CSM also adds it in the backend for you - please tell them the "Classic Label" name for the field (visible while in Edit).
   1. This allows you to upload a snapshot in time. E.g. the Job Level for the survey sent now is "B", but a year from now it might be "A". When you look back to "now", a year from now, you'd still want to see the survey attached to "B", while the contact is belongs to A now.
6. In the Survey Records column, you can find all the properties configured on the Survey level. Hover over the existing fields to access Edit.
   1. Making changes in Field Settings do not directly impact data. Do note that changing the context of a field (e.g. changing the field label to something completely different) is ill advised.
7. Adding fields in Survey Records enables it to be turned into a filter. You can upload data on survey imports once your CSM also adds it in the backend for you - please tell them the "Classic Label" (visible while in Edit).

Editing Fields

While editing a field you are able to update its Label, Field type, the max amount of characters allowed, enable a blockage of new values when uploading and also make it a mandatory field.

Field details

Field: shows the field being edited.

Label: update the label of the selected field.

Upload validations

Field type: determines the type of data that must be uploaded for this field.
Types:

Date (2023-09-15 00:00:00);

Email (simple.way@example.com);

Numeric (numbers from 0 to 9);

Text (letters, numbers, symbols).

Max character amount: this determines the amount of characters are allowed when uploading data into this field.

Example: setting it to 2 will only allow uploads that have up to two characters like AA or BB.

Restrict new values on upload: this option will block any uploads in case a value for that field is not already available. This function blocks the creation of new values for a specific field.

Mandatory field on upload: this option turns the field a required field when uploading data, in case the field is not present  or doesn't have data the upload will fail.

Please note: All fields validation are only applicable in the new Imports, v7 APIs, Webhooks and Microsoft Dynamics. It's NOT available in Salesforce Integration, SFTP or v4 APIs.

Asking CSM to Update

Your CSM will need to manage fields in a couple of places that are not controlled by Field Settings yet. Each scenario is listed below.

Legacy Import Data

Your CSM can help with the following actions:

• Add or Remove a Survey field to be available to be imported

Emphasis: If you have added a field to Survey Records in Field Settings, and would like to use it in legacy imports, make sure to ask your Account Manager to update the Import Settings of your platform!

• Re-label an existing field or change its technical name

Export Engine

Your CSM can help with the following actions:

• Add or Remove a Survey field to be available to be exported
• Re-label an existing field or change its technical name

Additional "Custom" Properties

The Survey Record object allows you to add fields called "custom_0" through "custom_9". These are additional properties that you can use to store data, which can be extracted using our Widget Exports.

• These custom fields can hold up to 180 characters per field.

Classic Labels

Accounts

Survey Records