Collapse AllExpand All

3.1. New Project

Projects can be created manually or automatically, depending on your needs. To have projects created automatically whenever a new sales order or quote is entered, choose the appropriate setting in your system-level configuration. Otherwise, projects will be created manually. Once created, projects can be linked to sales orders, work orders, and purchase orders.

To create a new project, go to CRM > Project > New. The following screen will appear:

Create new Project

When creating a new project, you are presented with the following options:

Number

Enter a code to identify the project.

Name

Enter a brief name to identify the project.

Project Type

Specify the project type.

Account

Enter the account associated with the project.

Owner

Specify the project owner.

Assigned to

Identify the user assigned to the project.

Department

Identify the department assigned to the project.

Status

Specify one of the following statuses to characterize the project:

New

Use this status to indicate that the project has been newly created.

Pending

Use this status to indicate the project has not yet begun.

In-Process

Use this status to indicate the project is in-process. Certain functions, like time and expense reporting, can only be performed against in-process projects.

Deferred

Use this status to indicate that the project has been deferred.

Complete

Use this status to indicate the project is complete.

Note

Projects generated automatically when a new sales order or quote is entered will be assigned the status Undefined at first. To remove this initial status, simply edit a project and assign an appropriate status to it.

Priority

Specify a user-defined priority for the project.

Due

Specify the date the project is due.

Started

Specify the start date for the project.

Assigned

Specify the date the project was assigned. The assigned date automatically populates when the a user other than the current user is assigned.

Completed

Enter the date the project was completed. The completed date automatically populates when the document status is changed to Complete.

Note

Subsequent changes to the above dates are tracked under the Comments tab as change log comments. The changelogs include user and time stamp information.

Percent Complete

Input the measurement of the project's completion.

Contact

Displays the contact currently attached to the project. You may manually override the displayed contact information in the fields below—or use the lookup feature to select another contact.

Name

Use the lookup feature to add a new contact or to select a pre-existing contact linked to the CRM account that the project is related to. Related contact information will display below the name.

On the Activity tab, the following options are available:

Show Types

Select which of the following project associations should be listed.

  • Sales orders

  • Work orders

  • Purchase orders

  • Incidents

Show Closed Tasks

Checking this box shows completed tasks in the activity list.

The following button is unique to this screen:

GANTT

Select to generate a Gantt chart bar chart to illustrate the project schedule. The Gantt chart presents the task completion time line in a graphical format.

To view additional information for the project, select the Additional tab. The following screen will appear:

Additional Project information

When viewing the additional information for a project, you are presented with the following options:

Assignable Orders

Specify which of the following order types can be linked to the project.

Sales Orders

Select to indicate sales orders may be linked to the project.

Work Orders

Select to indicate work orders may be linked to the project.

Purchase Orders

Select to indicate purchase orders may be linked to the project.

Summary

When viewing the time and expenses summary for a project, you are presented with the following information:

Total Hours Budgeted

Displays the total task hours budgeted for the project.

Total Hours Actual

Displays the actual task hours used for the project.

Balance

Displays the balance difference between budgeted and actual task hours for the project.

Total Expenses Budgeted

Displays the total task expenses budgeted for the project.

Total Expenses Actual

Displays the actual task expenses used for the project.

Balance

Displays the balance difference between budgeted and actual task expenses for the project.

You can specify customer and billing rate information by project. To specify the customer and billing rate information, select the Billing tab. The following screen will appear:

Project Billing

When specifying customer and billing rate information, you are presented with the following options:

Customer

Enter the customer you want to associate with the project.

Use specified billing rate

Select if you want to specify a customer billing rate for the project. If not selected, the rate may be entered manually on time sheets.

Rate

Specify the customer billing rate for the project.

To add a description of the project, select the Description tab. The following screen will appear:

Project Description

Notes entered here are displayed in the Description field when projects are listed.

To add characteristics to a project, select the Characteristics tab. The following screen will appear:

Project Characteristics

To create a new characteristic for your current context, select the NEW button from the characteristics list. The following screen will appear:

Create new Characteristic

When creating a new characteristic, you are presented with the following options:

Characteristic

Select a characteristic from the list of characteristics available for your current context. To learn more about how characteristics are linked to specific contexts, please see Section 9.2.2.1, “Characteristic”.

Value

Enter a value to associate with the characteristic.

Default

In some contexts, the Default option will appear. Select if the value entered is the default value for the specified characteristic. Default values will always be listed first where characteristics are used.

To add comments related to a project, select the Comments tab. The following screen will appear:

Comments added to Project

When adding or reviewing comments, you are presented with the following options:

Verbose Text

Select to display all comments in the list in an expanded view which includes the entire text of each comment. To edit a comment, simply select the EDIT link next to the comment. That link will not be shown for changelog comments, which can't be edited. If the Verbose Text option is not selected, the comment list will display only header level information for each comment.

Comments

Display lists comments related to the record.

The following buttons are available:

NEW

Opens screen for creating a new comment.

VIEW

Highlight a comment and then select this button to reach a read-only view of the Edit screen.

EDIT

Enables you to edit highlighted comments—as long as the comments are not changelog comments. ChangeLog comments are system-generated and may not be edited. The Edit screen is the same as that for creating a new comment—except that when editing, the fields will contain comment information. Double-clicking on a comment will also bring you to the editing screen.

To enter a new comment, select the NEW button. The following screen will appear:

Create new Comment
Comment Type

Select a comment type from the drop-down list to classify the comment. This is a required step. Comment types may be system-defined (i.e., changelog and general) or user-defined, as described in Section 13.2.3, “Comment Types”. Once you have specified a comment type, begin typing your comment in the main text area. The text area features word-wrapping and scroll-bar support for longer comments.

The following buttons are unique to this screen:

MORE

Select to show the complete list (i.e., thread) of comments associated with the record. To hide the list, simply select the MORE button again. The comment thread will show the most recent comment first.

To view the documents associated with a project, select the Documents tab. The following screen will appear:

Project Documents

When associating documents, you are presented with the following options:

NEW

Select to create a new document and associate it with the current record. You may create the following document types:

Image

Select to create a new image association.

Fixed Asset

Select to create a new fixed asset association.

Maintenance Order

Select to create a new maintenance order association.

Incident

Select to create a new incident and associate it.

Project

Select to create a new project and associate it.

Opportunity

Select to create a new opportunity and associate it.

Task

Select to create a new task and associate it.

EDIT

Enables you to edit associated documents. The Edit screen is the same as that for creating a new document—except that when editing, the fields will contain document information. Double-clicking on a document will also bring you to the editing screen.

VIEW

Highlight a document and then select this button to reach a read-only view of the Edit screen.

ATTACH

Select to associate already-existing documents. The following document types may be attached: contact, account, customer, employee, file, image, incident, item, opportunity, project, purchase order, sales order, vendor, web site, work order.

DETACH

Highlight a document and then select this button to remove the association.

To associate already-existing documents, select the ATTACH button. The following screen will appear:

Attach a Document

When associating already-existing documents, you are presented with the following options:

Relationship

Indicate how the document is related to the current record. The following relationship options are available: related to, parent of, child of, duplicate of.

Type

Specify the kind of document you want to associate. The following document types may be attached: contact, account, customer, employee, file, image, incident, item, opportunity, project, purchase order, sales order, vendor, web site, work order. When associating files, you will also be given the option to save the file to the database.

Tip

There is no file size restriction when saving files to the database. However, excessively large files could cause storage and performance issues.

Notes

Leave any notes on the document file as needed.

Document

Use the lookup tool to identify the specific document you want to attach. The data entry options will vary depending on the document type you select.

To create recurring projects, select the Advanced tab. The following screen will appear:

Create recurring event

When creating a recurring event, you are presented with the following options:

Recurring

Check this box if you want the event to repeat itself at regular intervals, using the frequency settings you specify below. Recurring events are generated when you run the Recurring Items utility, which is described in more detail here: Section 10.2, “Create Recurring Items”.

Every

Enter a number and select a unit of time to describe how frequently you want the event to occur. You can choose any regular schedule, ranging from once every 1 minute to once every 99 years.

From

Enter a date and time at which to start the first event. The default value is the time the screen opened. The From option only appears on some screens.

Until

Enter a date and time after which the event should no longer occur.

Create no more than

Enter the maximum number of future copies of this event you want the system to maintain. Whenever the Create Recurring Items screen is run, it will create up to the number you enter here.

Warning

If you delete all copies of a recurring event, the event will stop repeating even if the until date has not yet been reached. xTuple recommends setting this to at least 2 to reduce the likelihood of deleting all copies of the event.

Keep None

Select to make the next job catch up if work was missed.

Keep One

Select to create one catch-up job if work was missed.

Keep All

Select to create any missed jobs.

To view email associated with a project, select the Email tab. The following screen will appear:

Email

When viewing associated emails, you are presented with the following options:

Email list

Display lists associated emails.

Email body

The content of a highlighted email will be displayed here.

Limit to

Specify the maximum number of associated emails you want to be displayed in the email list. If the list is extremely long, you may experience some slowness when opening the screen.

Load All

Select to load all associated emails into the list.

Search

Enter a string of letters or complete words to search for matches in the list of associated emails. The search will scan through subject lines, To addresses, and From addresses.

The following buttons are unique to this screen:

NEW

Select to send a new email, using the default email program on your computer.

PRINT

Highlight an email and then select this button to print a copy of the email.

REPLY

Highlight an email and then select this button to reply to the email's sender, using the default email program on your computer.

REPLY ALL

Highlight an email and then select this button to reply to everyone associated with the email, using the default email program on your computer.

FORWARD

Highlight an email and then select this button to forward the email to another person(s), using the default email program on your computer.

ATTACH

Highlight an email and then select this button to attach an email associated with a contact in your contact list.

DETACH

Highlight an email and then select this button to remove the associated email from the list.