Collapse AllExpand All

10.1.1. Configure CRM

To configure the CRM module, go to CRM > Setup > Configure > CRM. The following screen will appear:

Configure CRM module

When configuring the CRM module, you are presented with the following options:

Account # Generation

Select one of the available CRM account number generation methods:

Manual

CRM account numbers must be entered manually whenever you create a new CRM account.

Automatic

CRM account numbers will be automatically incremented by 1 each time a new CRM account is created. These automatically-generated numbers may not be edited. They are read-only.

Automatic, Allow Override

CRM account numbers will be automatically generated and incremented, as under the Automatic option described above. However, this option also allows you to manually override the CRM account number at the time of CRM account creation.

Next #

Specify the next available CRM account number. The next CRM account created will use the number specified here. Leave this field blank if you will be creating CRM account numbers manually.

Incident # Generation

By default, incident numbers are generated automatically. However, you have the ability to specify the next available number.

Next #

Specify the next available incident number. The next incident created will use the number specified here.

Use Projects

Select to enable project functionality. This option must be enabled for project accounting to be enabled.

Enable Project Accounting

Select to enable the features related to the project accounting package. When project accounting is enabled, all G/L accounts are eligible to have transactions performed against them—and to have an extra dynamic segment for the project number appended to the G/L account number. Project accounts are created on the fly as transactions are performed against them, eliminating the need for users having to create G/L accounts for every possible G/L account and project combination. Financial statement and transaction reporting will display project-specific transactions just as though the project number were the last segment of the G/L account. Various reports can be filtered by project transaction.

Project Labor And Overhead

Enter a G/L account to be used when approving time sheets for employees who record time against projects. For this account to be used, the employee must have a rate defined on their employee record—and they must also not be a contractor.

Automatically create Projects for sales Orders

Select to create a project for every sales order when a new sales order is created.

Post Opportunity Changes to the Change Log

Select to have the system automatically log changes made to opportunity records under the Comments tab for each opportunity where the changes are made. If not selected, opportunity changes will not be tracked automatically.

Show Incident Public checkbox

Select if you want to show the Public checkbox option on the Incidents screen. In not selected, the Public checkbox will not be shown. This option applies primarily to sites where the xTuple Web Portal has been implemented. With the web portal, xTuple incidents may be viewed by customers, vendors, and others on your website. Depending on your website rules, private incidents may be hidden from most website users.

Incidents Public by Default

If you are showing the Public checkbox on incidents, select this option to make incidents publicly viewable by default. Incidents will be private by default if this option is not selected. Regardless of the setting you make here, the Public flag can be overridden on the Incident screen.

Require SO/PO/WO assignment to Project

If selected, you will be required to link a project before saving sales orders, purchase orders, or work orders. If not selected, the project association won't be required at order entry.

Warning Period for Project Due Dates

Specify how far in advance you want to be notified of a project's approaching due date. The warning consists of a color-coded alert on the order activity by project report.

Default Incident Email Delivery Profile

Specify the default EDI email delivery profile you want to use when emailing incidents.

Email Delivery when Incident

Select the options below to trigger email notifications when incident events occur.

Created

When incident is created, email notification is sent.

Assigned

When user is assigned to incident, email notification is sent.

Status Changed

When status of an incident is changed, email notification is sent.

Updated

When incident is updated, email notification is sent.

Comments Added

When comments are added to an incident, email notification is sent.

Note

The following tokens are supported in EDI profile for CRM incidents:

  • </email1> = incident owner email address

  • </email2> = incident assignee email address

  • </email3> = incident contact email address

  • </description> = incident description

  • </docnumber> = incident number

  • </doctype> = "INCDT"

  • </docid> = incident primary key id

  • </docbody> = builds text of fields, notes and history of incident record

  • </comments> = incident comments

Incident Status Colors

The incident color configuration option supports simple color names (e.g., red, blue, green, etc.), as well as the full range of hexadecimal codes (e.g., #FFA0A0, #FF50A8, etc.). Specify how you want incidents on the Incident workbench to appear according to their various statuses:

New

Specify the color for incidents whose status is New. The default color is set to white. Setting no value in this field will cause new incident rows to be rendered all black.

Feedback

Specify the color for incidents whose status is Feedback. The default color is set to white. Setting no value in this field will cause new incident rows to be rendered all black.

Confirmed

Specify the color for incidents whose status is Confirmed. The default color is set to white. Setting no value in this field will cause new incident rows to be rendered all black.

Assigned

Specify the color for incidents whose status is Assigned. The default color is set to white. Setting no value in this field will cause new incident rows to be rendered all black.

Resolved

Specify the color for incidents whose status is Resolved. The default color is set to white. Setting no value in this field will cause new incident rows to be rendered all black.

Closed

Specify the color for incidents whose status is Closed. The default color is set to white. Setting no value in this field will cause new incident rows to be rendered all black.

Default Country for Addresses

Select if you want a default country (e.g., United States) to be used whenever new addresses are created. While a default address will be set, the choice can be overridden manually when creating or editing addresses. If not selected, users will need to manually select a country when entering addresses.

Enforce Valid Country Names

If selected, users will be required to select from a list of valid countries when creating or editing addresses. Once this box is checked and you save the configuration, it will be disabled and you cannot uncheck it. If not selected, users will be permitted to enter ad hoc country names.

Warning

When you select this option, the application will warn you if it finds you have addresses with invalid country names. This includes addresses themselves and also documents which use addresses—namely, sales orders, invoices, etc. The warning message refers to a fixCountry.gz extension package, which can be downloaded for free from the xTuple xChange.

Tip

To learn more about editing the list of country names, please see Section 13.2.4, “Countries”.

Invalid Countries warning message