Overview

An unlimited number of projects can be supported in Tracker. When defining a project, you choose the forms (fields), workflow and user groups that will be involved.

Because you can limit which user groups are able to access each project, it allows you to create separate and secure areas for different processes, departments or activities.

Examples:

• Create separate projects for each process or organization. In a product development environment, you might have a project for product development and another for customer support.
• Create separate projects for each product, customer or company.

The actions that can be performed by a user in a project are based on user group privileges. For example, the QA group is allowed to edit records they reported. The Developers group can edit any record in the In Development state. QA has access to Projects A and B. Developers has access to Project B. A user who is a member of both QA and Developers will be able to edit records they reported in Projects A and B, but will only be able to edit records in the In Development state in Project B.

A Default Project is created in each workgroup. The name of the default project depends on the template that was used to create the workgroup. For example, the Product Development template has the "Product Development Project" created by default and the Help Desk template has the "Help Desk Project" created by default. Information about the default settings in a particular template can be found in the Putting It All Together section.

If only one Project is defined in Tracker, users will not see the Project field on any of the pages (Add, Edit, Task, Query, Home, etc.) until additional projects are added. Only users that are members of the Admin group (or are members of a user group with the Admin privilege) will see the Project field in the Admin section.

The following sections explain the different aspects involved in Projects:

• Projects - general operations such as adding, editing and deleting projects
• Project Visibility - setting which user groups have access to each project
• Forms in a Project - how to choose which forms are associated with a project and set the properties for each
• Form Workflow - how to select which workflow will be applied to each form in a project
• Form State Managers - configuring the automatic assignment table applied to each form in a project
• Incoming Email Settings - how to configure the settings for the Submit via Email feature for a project

Topics Covered In This Section

• Managing Projects - describes the information available in the Projects page.
• Global Project Properties - allows you to rename the Project field and customize its Help description.
• Adding a Project - how to create a new project.
• Editing a Project - how to modify an existing project.
• Deleting a Project - how to delete a project.
• Setting a Default Project - how to set which project will be displayed by default when you view the Projects page.
• Project Visibility - how to configure which user groups can see a project.

Multiple projects can be created and managed in the Projects section.

To view the properties of a project:

1. Login to the workgroup as Admin
2. Click on the Admin icon
3. Click on the Projects link
4. The properties of the project listed in the Projects (<Projects>) pulldown at the top will be displayed. To view the properties of another project, select a project in the Projects field. The page will be refreshed to display the properties of the selected project.

   Click on the Expand All link to the right of project name to expand all of the sub-sections in the project. The project properties include the associated forms and their respective workflows, state managers and user group visibility. Or, or use the a "+" icon for expanding sub-sections and the "-" icon is for collapsing sub-sections.

Return to Topics List

Global Project Properties

Global Project Properties allow you to choose the name of the Project field and the Help Description displayed in Tracker pages such as Add, Edit and Task. The Help Description is the text that appears when the user places the cursor over the Help Description icon (yellow question mark to the left of the field).

To set the Global Properties of the Project field:

1. Login to the workgroup as Admin
2. Click on the Admin icon
3. Click on the Projects link
4. Click on the Edit Global Properties link in the upper right corner
5. Enter a name in the Project Label field
6. Enter a description in the Help Description field
7. Click OK to save the changes

Return to Topics List

Adding a Project

To add a project:

1. Login to the workgroup as Admin
2. Click on the Admin icon
3. Click on the Projects link
4. Click on the Add Project button
5. Enter a name for the project in the Name field.

   Enter an order for the project with respect to other projects in the Order field. This will determine in what order the projects are listed in the Project field on the Add, Edit and Submit pages. Projects with the same order will be displayed alphabetically.

   Select a form that can be used to submit records for this project in the Form field. The forms available for selection are the forms that have been created in the Forms section. If you have not yet added the form you wish to use with the project, you can select "<None>" for Form. Selecting <None> for Form will also select "<None>" for Workflow.

   Select a workflow that will be applied to records submitted using the selected form for this project in the Workflow field or select "Empty Workflow" if you do not wish to have a workflow applied to records submitted using the selected form in this project. The workflows available for selection are the workflows created in the Workflows section and have been associated with the form selected in the Form field above.

6. Click Continue to proceed
7. The Project, Form and Workflow selected will be displayed.

   Enter an order for the Form with respect to other forms associated with this project in the Project Form Order field. This will determine in what order the forms are listed in the Form field on the Add, Edit and Submit pages. Forms with the same order will be displayed alphabetically.

   Select which user group(s) should be able to add and access records that belong to the new project in the Make Visible (Available) To These User Groups field. Keep in mind that each user needs to be a member of a user group that has access to at least one project in order to be able to login to Tracker. The Admins user group is not available for selection because that user group is given visibility to all projects.

8. Click OK to save the project
9. Click OK to return to the Projects section or click on the Add another Form to this Project button to select another form to be available for this new project.
10. If you clicked on the Add another Form to this Project button:
    1. Select a form that can be used to submit records for this project in the Form field. The forms available for selection are the forms that have been created in the Forms section.

       Select a workflow that will be applied to records submitted using the selected form for this project in the Workflow field or select "Empty Workflow" if you do not wish to have a workflow applied to records submitted using the selected form in this project. The workflows available for selection are the workflows created in the Workflows section and have been associated with the form selected in the Form field above. Or, if you would like to add a new workflow to be used with the selected form, select <Create New Workflow>.

    2. Click Continue to proceed
    3. Enter an order for the Form with respect to other forms associated with this project in the Project Form Order field. This will determine in what order the forms are listed in the Form field on the Add, Edit and Submit pages. Forms with the same order will be displayed alphabetically.

       Select which user group(s) should be able to add and access records that belong to the new project in the Make Visible (Available) To These User Groups field. Keep in mind that each user needs to be a member of a user group that has access to at least one project in order to be able to login to Tracker. The Admins user group is not available for selection because that user group is given visibility to all projects.

       If you selected <Create New Workflow>, you will be prompted to enter a name for the new workflow in the Workflow Name field. You will also need to select the states that should be part of the new workflow in the Include These States field. The states available are the states that have been created in the Global States section.

       Select a state group in the Form's Allowed Add States field. The Allowed Add States are the group of states that will be available in the Status field on the Add page when adding a record for the selected Project and Form.

       Select a state in the Form's Default Add State field. The Default Add State is the state selected in the Status field by default when adding a record for the selected Project and Form.

    4. Click OK to finishing adding another form to the project. Click OK to return to the Forms section for the selected project or click on the Add another Form to this Project button.

Return to Topics List

Editing a Project

A project's name or order can be edited from the Projects page.

To edit a project:

1. Login to the workgroup as Admin
2. Click on the Admin icon
3. Click on the Projects link
4. Select a project in the Projects pulldown at the top. The page will be refreshed with the properties of the selected project
5. Click on the Edit link to the right of the Project Name
6. Make any desired changes to the project's Name or Order fields
7. Click OK to save the changes
8. Click OK to return to the Projects section

Return to Topics List

Deleting a Project

Before attempting to delete a project, you must remove any forms from the project (and, as a result, remove any records added using the combination of Project and Form).

To delete a project:

1. Login to the workgroup as Admin
2. Click on the Admin icon
3. Click on the Projects link
4. Select a project in the Projects pulldown at the top
5. Click on the Manage link to the right of the Forms section
6. If there are any forms in the "Forms In Use" column, click on a form and click on the Remove button. Click OK to confirm the operation. A warning will be displayed to note that removing the form from the project will remove all its records (with related information such as History, Attachments, Record Security, Source Code Files, Alerts, Discussion Threads, etc.) as well as permanently remove any related State Manager and Incoming Email settings. Click OK to remove the form from the project. Click OK again when the confirmation is displayed. Click OK to return to the Projects section.
7. Click on the Delete button to the right of the Projects pulldown
8. Click OK and OK again to confirm the operation
9. Click OK to return to the Projects section

Return to Topics List

Setting a Default Project

You can select which project you would like to see by default when you go to the Projects page in the Admin section.

To set the default project:

1. Login to the workgroup as Admin
2. Click on the Admin icon
3. Click on the Projects link
4. Select the project you wish to make the default in the Projects pulldown at the top
5. Click on the Set as Default button to the right of the Project pulldown. If the Set as Default button is not available, this indicates that the project is already set as the default project.

Return to Topics List

A project can be made visible to certain user groups and forms. This allows you to select which projects and forms a user groups can access such that users can only see projects and forms that are applicable to their role in the project. Each user must be a member of a user group with visibility to at least one Project in order to login to Tracker. Users who do not have visibility to at least one project will be prevented from logging into Tracker.

To add user groups or forms to the list of groups/forms to which the project is visible:

1. Login to the workgroup as Admin
2. Click on the Admin icon
3. Click on the Projects link
4. Select a project in the Projects pulldown at the top. The page will be refreshed with the properties of the selected project.
5. A list of user groups to which the project is currently visible will be displayed under the Visible to User Groups heading. Click on the Add button to the right of the Visible to User Groups heading.
6. All available forms will be displayed in the Make These Forms field. The forms that are available are the forms that have been previously associated with this project. Additional forms can be made available to this project in the Forms section. To select a form, click on the form. To select multiple forms, hold down the Ctrl button on your keyboard while selecting forms. To select all forms, click on the All button to the right of the form list.

   All user groups available in the workgroup will be displayed in the Available To These User Groups field. To select a user group, click on the user group. To select multiple user groups, hold down the Ctrl button on your keyboard while selecting user groups. To select all user groups, click on the All button to the right of the user group list.

7. Click OK to save the changes, then click OK to confirm the operation
8. Click OK to return to the Projects section

To remove user groups or forms from the list of groups/forms to which the project is visible:

1. Login to the workgroup as Admin
2. Click on the Admin icon
3. Click on the Projects link
4. Select a project in the Projects pulldown at the top. The page will be refreshed with the properties of the selected project.
5. A list of user groups to which the project is currently visible will be displayed under the Visible to User Groups heading. Click on the Remove button to the right of the Visible to User Groups heading.
6. All available forms will be displayed in the Make These Forms field. The forms that are available are the forms that have been previously associated with this project. To select a form, click on the form. To select multiple forms, hold down the Ctrl button on your keyboard while selecting forms. To select all forms, click on the All button to the right of the form list.

   All user groups available in the workgroup will be displayed in the Unavailable To These User Groups field. To select a user group, click on the user group. To select multiple user groups, hold down the Ctrl button on your keyboard while selecting user groups. To select all user groups, click on the All button to the right of the user group list.

7. Click OK to save the changes, then click OK to confirm the operation. When removing user groups, fields that are only visible to the groups that were removed will also be removed from any saved queries, report layouts or charts where this project is selected.

   If there are any saved queries or charts created for the user group being removed (or created by users that are members of that user group) and the saved queries/charts only have this combination of project and form selected, those saved queries/charts will be deleted. Saved queries that have this project and form selected in addition to others will be modified to remove the project and form from the query criteria.

   If the Users group is being de-selected (removed), any system defined queries that only have this combination of project and form selected must be edited to select * or another combination of Project and Form. Similarly, if the Users group is being de-selected (removed), any system defined charts that only have this combination of project and form selected must be edited to select * or another combination of Project and Form.

8. Click OK to return to the Projects section

Return to Topics List