Company Setup

Navigation Path

Admin > Company Setup > Variance Codes

Notes

• Variance codes may be required to be selected during the creation of manual POs and or for schedule changes affecting the projected completion date.
• Variance codes settings are available to BTBuilder customers only.
• Samples of Variance Codes are provided in the Best Practice to the left

To Add a Variance Code

1. Click the Add Variance Code link
2. Enter the Number of the variance code for accounting code.
3. Enter the Name of the variance code.
4. Select the Type of Variance Code.
5. Select the Save button to add the variance code.

To Edit a Variance Code

1. Select the Edit link from the Actions column.
2. Edit the Number text field to edit the accounting code of the variance code.
3. Edit the Name text field to edit the name of the variance code.
4. Select the status of the Variance Code. If set to inactive the variance code will no longer be available for selection.
5. Select the Save button to save the changes and return to the Variance Codes screen, or, as appropriate, select the Cancel button to return to the Variance Codes screen without saving the changes.

Note

• Variance codes may be edited/modified at any time. If the variance code has been assigned to a purchase order or construction log and is then re-numbered or re-named in Company Setup, the new number and name will flow to all existing purchase orders and construction logs using the previous variance code, regardless of PO status. To avoid changing variance code status for existing purchase orders, Edit and select Inactive status drop down for the 'old' variance code and create a 'new' code using the Add a Variance Code link.

To Remove an unused Variance Code

If a variance code has not been used, it may be deleted.

1. As appropriate, select the Delete link from the Action column.  

To Make a Variance Code Inactive

1. Select the Edit link from the Action column.
2. Select Inactive in the Status field.
3. Click the Save Button.  

To Require Use of Variance Codes

1. As appropriate, select or de-select the Manual Purchase Orders or Schedule Changes checkbox to require the use of variance codes.
2. Select the Save button to save the changes.

Navigation Path

Admin > Company Setup > Salutations

Notes

• BuildTopia has provided a list of 5 common salutations. These system defined salutations are not available for deletion. (Dr., Hn.,Miss, Mr., Mrs., Ms.)

To Add a Salutation

1. Enter Salutation text field.
2. Select the Add button to add the salutation.

To Edit a Salutation

1. Select the Edit link from the Action column.
2. Use the New Salutation text field to edit the salutation.
3. Click the Save button.

To Remove a Salutation

If a salutation has been used is a prospect / buyer / owner record, it is not available to be deleted.  The Delete link will be inactive.

If a salutation has not been used, it may be deleted.

1. As appropriate, select the Hide or Delete link from the Action column.  If the salutation has been hidden, the Hide link will be replaced with a Show link.

Navigation Path

Admin > Company Setup > Budget Settings

Notes

Budget settings are used to determine how the template budget is updated, when the original/current budget is captured and how the original/current budget is calculated.

• Budget Settings are available to BT Builder and BT Sales customers only.
• In order to generate purchase orders prior to approving a schedule make sure the 2nd setting is set to 'Release to Production'

Setting the budget settings

1. Update Template Budgets with each Primary Contract Acceptance/Finalization.
1. Yes - When a primary contract is updated the cost information will automatically updated the template budget on the plan or activity. BEST PRACTICE .
2. No - The template budget will be manual maintained
2. When the Original/Current Budget will be captured.
1. Release to Production - the original/current budget on the unit will be captured when the lot is released to production . BEST PRACTICE This will create a snapshot of your budget at the time of the sale if the SM releases the lot to production shortly after the sale.
2. Schedule Approval - the original/current budget on the unit will be captured when the Schedule is approved on the Unit.
3. How the Original/Current Budget will be Calculated.
1. Pro-Forma Budget - Only the proforma budget will be used to capture the original/current budget.
2. Best Available - The primary contract for the trade will be used to capture the original/current budget.  If there is no primary contract, then the proforma budget will be used to capture the original/current budget. BEST PRACTICE
4. Select the Save button to save the changes.

NOTE: Any changes made to these settings will update future units.  Changes to these settings will not affect units already under construction.

Navigation Path

Admin > Company Setup > Payment Terms

Note:For Non BTAccounting customers this fields is for information only.

To Add a Payment Term

1. Use the Name text field to enter the description of the payment term to appear in future screens.  Example: Enter "Within 30 days" to indicate that invoices are to be paid within 30 days of receipt.
2. As appropriate, use the text field to enter the Accounting Code.
3. Select the Add button.

To Edit an Existing Payment Term

1. Select the Edit link from the Actions column.
2. Use the Name text field to edit the description of the payment term to appear in future screens.
3. As appropriate, use the text field edit the Accounting Code.
4. Select the Save button to save the changes.

To Remove an Existing Payment Term

If a payment term has been attached to a Trade Partner, the payment term is not available to be deleted.  The Delete link will be inactive.

1. As appropriate, select the Hide or Delete link from the Action column.  If the payment term has been hidden, the Hide link will be replaced with a Show link.

Navigation Path

Admin > Company Setup > Purchasing Settings

Notes

Purchasing Settings are available to BT Builder customers only.

Setting the purchasing settings

Activity w/out Schedule Tasks - this setting is for primarily for Builders who are not utilizing Task-Activity Relationships. Additionally, for Builders who are utilizing Activity - Task Relationship, this setting decides how activities that DO NOT have a task associated will be handled when generating purchase orders. Note: BuildTopia strongly recommends that if you are utilizing the Task-Activity Relationship that you assign all activities to the appropriate task.

1. Select the Place on individual POs (default) or Consolidate to one PO radio button for Activity w/out Schedule Tasks
1. Place on individual POs - Generate one purchase order for each unassigned activity.
2. Consolidate to one PO - Generate one purchase order for each trade for all unassigned activities.

Breakout POs by base/option/NSO - this setting will group together Base, Option and/or NSO activities on one PO per trade per entity. How POs are generated with this setting will also depend on the Activity w/out Schedule Tasks setting and based on the Task-Activity Relationships. For example; The appliance trade has 4 activities

1. Base house stove
2. Base house dishwasher
3. Option refrigerator
4. NSO trash compactor

How many POs will be generated?

*This assumes that all tasks are associated to the same scheduled task

1. Select the Yes (default) or No radio button to Breakout POs by base/option/NSO.
1. Yes - Group activities by base house, option and NSO into different purchase order for each trade.
2. No - Group all activities into one purchase order for each trade with all activities.
2. Enter the Company default System Generated PO Prefix in the System Generated PO Prefix field.
3. Enter the Company default Manual PO Prefix in the Manual PO Prefix field.
4. Enter the starting PO Number in the Next PO Number field.
5. Select the Save button to save the changes

NOTE: Any changes made to these settings will update future generated purchase orders.  Changes to these settings will not affect existing purchase orders

1. Opt Out Rule - Select the Delete (default), Dismiss,  or No Opt Out radio button to .  Opt Out Rule selections determine how tasks are handled when a prospect / buyer / owner has selected to "opt-out" of contact through the contact method specified for the task.  Opt-out rules are applied to campaign tasks.
1. Delete - deletes the task without presenting to Sales staff and does not appear in the tally of tasks completed / dismissed in the SM > Follow-up screen.  This is the default selection.
2. Dismiss - dismisses the task without presenting to Sales staff, but the task is included in the tally of tasks in the SM > Follow-up screen.
3. No opt Out -  takes no action; the task is presented to Sales staff as usual.
2. Allow SR to edit buyer information - Select the Yes (default) or No radio button
1. Yes - Allows users with Sales Rep write permission to edit the buyer information.
2. No - Users with Sales Rep write permission can not edit buyer information.
3. Require a comment when Dismissing Tasks - Select Yes or No button to require a note when Sales Rep dismisses a To Do task.
4. Restrict Campaigns - Select the Yes or No button to restrict the campaign list to prospect type codes. Selecting Yes is functionality designed for users whose Campaigns are completely separate from project to project, and who do not want Sales Reps to be able to view campaigns active in other projects other than their associated project.
   1. Yes:
      1. Campaigns shown within SR > Prospects > Tasks > Add Campaign will be only those campaigns associated to the Project - Prospect Type Code relationship.
      2. Campaigns shown in On Demand reports when generating campaigns will be only those campaigns associated to the Project - Prospect Type Code relationship.
   2. No: Default campaign functionality displays all campaigns regardless of association to Project - Prospect Type Code.

Recommended Practice: If this setting is selected and the user wishes to use Marketing Campaigns (see Campaign Management for a discussion on marketing campaigns and their use), BuildTopia recommends you set up a 'dummy' Prospect Type Code, keyed to marketing campaigns only. Do NOT use this type code to assign to prospects, but to identify marketing campaigns only.

5. Select the Save button to save the changes.

NOTE: Any changes made to the opt out rule setting will update future prospect tasks.  Changes to the opt out rule setting will not affect existing prospect tasks.

Navigation Path

Admin > Co Setup > Sales > Prospect Type Codes

Notes

• Managed at the Admin level, a single Prospect Type Code can be used in one or multiple projects. This provides you with flexibility to manage your campaigns on a per project basis. You're 1-A lead in Project 1, might need a different campaign then your 1-A lead in Project 2. If not, you will associate all projects to all prospect type codes.
• When a new prospect type code is created:
  • It must be associated to a Project, creating a Prospect Type Code - Project association.
  • Then Campaigns can be associated to the Prospect Type Code - Project association.
  • When the type code is added to a Prospect, campaign tasks are automatically applied to that Prospect. (Campaigns added by this method are by their nature Follow Up Campaigns, with tasks assigned to Prospects in the SR module.)
• A Prospect Type Code cannot be deleted if it has been associated to a project, a prospect, or a campaign added.
• There are two system default Prospect Type Codes, which cannot be removed or edited:
  • Unassigned: this is the default type code for added Prospects. Campaigns can be added to this type code and tasks assigned.
  • All Prospects: this type code cannot be applied to Prospects. It is used to create campaigns that apply to all Prospect Type Codes.

Steps - Add/Edit a prospect Type Code

1. Select Add A Prospect Type Code, or Edit for an existing prospect type code
2. Enter the Prospect Type - this is an alphanumeric field
3. Enter in a description that defines the parameters of the prospect type
4. Select Save

Steps - Delete Prospect Code

Note: You can not delete a prospect type code if the code is in use by prospects OR associated to projects

1. See "Steps - Remove Project & Campaign Associations"
2. Select Delete for a prospect type code

Steps - Create Project Associations

To view campaigns already associated to a project, select

1. Select Project & Campaign Associations for a prospect type code
2. To Associate a project to a prospect type code - select Associate Project(s)
3. Select one or more projects
4. Select the Associate Selected Project(s) button

Steps - Create Campaign Associations

Note: You must create the Project/Prospect Association first AND define the campaign

1. Select Project & Campaign Associations for a prospect type code
2. Select Add Campaigns for each project
3. Select one or many campaigns to associate to this project
4. Select Associate Selected Campaign(s)

Steps - Remove Project & Campaign Associations

Note: You have to remove the campaigns prior to disassociating a prospect type code from a project

1. Select Project & Campaign Associations for a prospect type code
2. Confirm that there are no campaigns associated by selecting
3. Remove any associated campaigns by selecting the Remove link
4. Select the Remove link for a project

Admin > Company Setup > Campaigns

Suggested Reading for further understanding of campaigns See "Best Practice: Follow Up Campaigns (with Document Templates)"

All campaigns are managed at the company level and are distinguished by the method of generating the campaign:

• Marketing Campaigns are designed to address single or multiple groups of entities: prospects, buyers, broker agents, or mortgage companies. A Marketing Campaign can be directed to any number of these entities across multiple projects and prospect code types, regardless of other associations the entities might have.
• Follow Up Campaigns are differentiated from Marketing Campaigns by the method of launching them, but otherwise any campaign can be used for follow up tasks or for marketing tasks.

Campaign fields can be edited to include campaign name, description, prospect type code and status [active or archived].

Independent from the prospect type code - project association, Marketing Campaigns can be launched across projects or prospect types. Tasks from Marketing Campaigns created at the report results screen are applied to the entities in the report. The data can also be exported to a Third Party Lead Management Tool which integrates with .CSV formatted files.

Steps - Add Campaign

1. Select Add A Campaign
2. Provide a Campaign name; e.g. "01-A - Campaign A The Deal"
3. Provide a description of the purpose of the campaign; e.g. "for the 01 - A Prospect"
4. Select the status of the campaign
   • The active status will make this campaign available for use
   • The archived status will discontinue the use of this campaign

Steps - Add Campaign Tasks

1. Select Add Tasks for any given campaign
2. Select Add A Campaign Task
3. Enter the task name and description
4. Select the Task Type
   • Email - will prompt you to select an email template
   • Email (Auto Send) - will prompt you to select an email template. This task is automatically sent by the system. The user is not required to take any action on this task type.
   • Letter - will prompt you to select a letter template
   • Meeting
   • Other
   • Phone Call
5. Select the default days. This will calculate the date of the task based on the date the prospect was added, or the prospect type code was modified.

Admin > Company Setup > Company Questions

The user has the ability to setup Company level survey questions at the Company Setup screen.  You have the option to add, edit, order, and delete. Company level questions are the first questions displayed in every project survey, and cannot be modified at the project level. Company level questions also apply to the WIK prospect import form.

Additionally, project level questions are managed in Admin > Projects, and apply to Surveys on a project-level basis only.

See "Manage Surveys" for step by step instructions on creating Company Questions.

Navigation Path

Admin > Company Setup > Sales > NSO Settings

Notes

NSO Settings define the company's process for creating and managing custom option requests. The General settings specify when an NSO can be submitted for approval, when the NSO is released to purchasing, if the Estimate Budget is visible to trade partners, and when the price of the NSO is added to the total price of the Purchase Agreement (PA).  The workflow settings allow the company to specify their NSO workflow.

• NSO Settings are available to BT Builder and BT Sales customers only.

Setting NSO Settings - General Settings

The default setting of No prevents the user from submitting NSOs against workups. The user will be able to create an NSO, but will be unable to submit the NSO for further processing until the workup has been submitted. The user should select Yes when the user wants the ability to submit against workups as though the NSO was submitted against a submitted (sales) agreement.

1. Select the Yes  or No (default) radio button
1. Yes - NSO can be submitted on a workup.
2. No -  NSO can only be submitted on an submitted sales agreement.

 

If set to Yes, once the buyer has accepted the NSO, it will be automatically released to purchasing, and provided the lot schedule has been applied and approved, will be available for purchase order generation.

2. Select the Yes  or No (default) radio button

1. Yes - The NSO will be automatically released to purchasing and available for purchase order generation.
2. No -  The NSO will manually be released to purchasing to generate purchase orders.

The default setting of No prevents the trade partner from viewing the Budget Amount entered for each cost code in the estimate. Changing this setting to Yes will display the Budget Amount field in the Trade Partner's Quote. When an NSO is added to the activity list, the budget amount is added to the original and current budgets.

NOTE: This setting applies to BTBuilder only.

3. Select theYes  or No (default) radio button

1. Yes - Allow the Company's Estimate Budget to be visible to online trade partners.
2. No -  The Company's Estimate Budget is not visible to the online trade partner.

4. Select the status when the price of the NSO is added to the Total Price of the Purchase Agreement

1. Buyer Accepted - When the Buyer Accepts the NSO, the total price of the purchase agreement will reflect the price of the NSO.
2. Released - When the NSO is released to purchasing, the total price of the purchase agreement will reflect the price of the NSO.

Setting NSO Settings - Workflow Settings

1. Allow Sales to Approve NSO without Production Acceptance - Allows the production approval step to be bypassed, allowing estimate creation and additional NSO processing without Production approval.  The link for Production Acceptance is still displayed and may be utilized, but is not required to complete the NSO process.
2. Allow Sales to Approve NSO with Production Acceptance but without a Completed Estimate - Sales must approve the NSO, followed by Production approval. The estimate with this setting is optional. The user may choose this setting if their business practice does not utilize estimates for NSOs.
3. Allow Sales to Approve NSO with Production Acceptance and require a Completed Estimate - Production approval and the completed estimate are required to complete the NSO process.  

5. Select the Save button to save the changes.

NOTE: Any changes made to the NSO settings will update future NSOs.  Changes to the NSO settings will not affect existing NSOs.

Navigation Path

Admin > Company Setup > Document Settings

Notes

The Document Settings screen allows the company to see their current usage, set the number of revisions to maintain and the default document settings for trade partners.

Setting Document Settings

1. Select the number of revisions to a document to be stored in the system in the Keep X Revisions. The system allows up to 5 revisions of each uploaded document.
2. Select the trade partner default role for documents accessible to trade partners in the Default Permission. This role is established is Admin > Company Setup > TP  Document Roles. Learn more about defining trade partner roles here.
3. Select the default document status for new documents added to Document Management in the Default Setting. This will determine the default status for trade partners accessibility to documents. The status can be changed on a document by document basis.
1. Hidden - Document added will be hidden from online trade partners
2. View - Document added will be visible for online trade partners.
3. Edit - Document added will be visible and editable for online trade partners. The trade partner will have a Replace hyperlink that allows them to upload a new document.
4. Select the Save button to save the changes.

NOTE: Any changes made to the Document settings will update future documents.  Changes to the Document settings will not affect existing documents.

Navigation Path

Admin > Company Setup > Document Folders

Notes

Each document in BuildTopia will now be associated with a document folder.  

There are 2 system defined folders in the system:  

• General Access Folder - All users will have access to documents in this folder. This is also the default folder when uploading a document.
• Personal Folder -  Only the user of the account has access to documents in this folder.

A company will be able to add up to 100 additional folders (i.e. lots, prospects, options, bids, etc.). Utilize folders to control permissions.

In the Document Roles settings the user can assign different permission levels such as None, View, Add, Edit, and Admin to control the access to the documents within each folder.

Add Document Folders

1. Select Add Folder link.
2. Enter the Folder Name in the text box.
3. Select Status of Document Folder
• Active - Documents can be filed into the Folder.
• Archived - Documents can not be filed in the Folder.
4. Select the Save button to save the changes.

Navigation Path

Admin > Company Setup > Data Upload Wizard

Notes

The Data Upload wizard is the centralized location for the company to upload data into the application.  Data Upload templates include explicit instructions which must be followed for your upload to be successful.

Templates are available for uploading the following data:

• Trade Partners
• Option Categories
• Activity Codes
• Cost Codes
• Option Codes
• Lots
• Schedule Templates
• Broker Agents
• Mortgage Companies
• Prospects

The data imports wizard reads hidden and visible columns.  If you don't want to include a column in your data, you need to delete the column from the excel spreadsheet before attempting to import the records.

BuildTopia does not support files saved as Excel 2007 files or with an extension of .docx. If using Excel 2007 the user should save the document as an Excel 2003 document for data upload purposes.

Do not enter Dates into the Data Upload Wizard Excel file [dates are stored as serial numbers and BuildTopia does not recognize them]. The Wizard will not populate this field. User must enter or update each date field after upload is successful at the individual record.

Data Upload Steps

1. Choose the Upload type.
2. Download the Instruction Manual/Template if you have not done so already.
3. Select the Next button
4. Chose the columns to be imported.
5. Select the Next button
6. Select the order of the Columns
7. Select the Next button
8. Select the file with the data.
9. Select the worksheet number in the Sheet Number field.  The default is 1.
10. Enter the row that the data starts on in the First Row Number field.
11. Select the Next button.

Navigation Path

Data Library > Company Setup > Lot Custom Fields

Notes

• There are 20 custom lot fields already created. There are 5 date fields, 5 drop down fields, 5 long text fields and 5 number fields. All you need to do is activate and customize each field. These fields will appear in all projects.
• The long text fields allow a maximum of 4000 characters.
• Custom fields do not show up to Trade Partners

Steps

1. Select the type of field that you want to customize, e.g. Date or Drop Down.
2. Select Define or Edit under the Actions column
3. Enter the Lot Custom Field Name to describe the information required
4. Edit the Status field as appropriate.
   1. Active is selected by default. Active means that this custom field will be available for data input.
   2. Required can be used if you want to make this field required. If you make a new field required, next time you edit an existing lot you will be required to enter the field information prior to saving.
   3. If you are not ready to make this field active, select Archived. Archived can also be used to 'retire' fields that are no longer needed.

Note

Once you have begun to capture information in these fields, you want to consider the impact of changing the Field Name. The information captured prior to changing the Field Name might not match the information you are seeking in the new field.

Steps

Navigation Path

Admin > Company Setup > Permission Roles > Administrator Roles

Notes

The administrator roles allows the user access to the Data Library and Administrator screens in the application. The permissions in this section allow access to edit within various setup areas.  If the role has access to a tab, the role can edit any of the functions on the section.

To Add an Administrator Role

1. Select the Add Administrator Role link.
2. Enter the name of the role in the Role Name field.
3. Use the checkboxes to select all appropriate permissions for the role:
4. Select the Save button to save changes.

To Edit an Administrator Role

The Company Administrator role is not editable.

1. Select the View/Edit link from the Actions column for the role to be edited.
2. Use the checkboxes to select all appropriate permissions for the role. See Step 3 in the To Add a Administrator Role section
3. Select the Save button to save the changes.

To Archive an Administrator Role

Archiving a role does not affect users assigned to that role; it prevents selection of the role in the future.

1. Select the Archive link from the Action column.
2. To reactivate an archived role, select the Re-Activate link from the Action column for the role to be reactivated.

Compare

The compare feature allow the user to view all of the roles side by side to see the selections.

Navigation Path

Admin > Company Setup > Permission Roles > Bidding Roles

Notes

The bidding & contracting roles and permissions are defined by the company, exclusive of the system defined Administrator role.   The Bidding/Contracting Administrator role has full permissions on all functionality within the BC module. This role is not editable.

• Bidding Roles are available to BT Builder customers only  

To Add a Bidding & Contracting Role

1. Select the Add Bidding Role link.
2. Enter the name of the role in the Role Name field.
3. Use the checkboxes to select all appropriate permissions for the role:
1. View Bidding & Contracting Permissions for a complete description of the permissions

To Edit a Bidding & Contracting Role

The Bidding/Contracting Administrator role is not editable.

1. Select the View/Edit link from the Action column for the role to be edited.
2. Use the checkboxes to select all appropriate permissions for the role. See Step 3 in the To Add a Bidding & Contracting Role section
3. Select the Save button to save the changes.

To Archive a Bidding & Contracting Role

Archiving a role does not affect users assigned to that role; it prevents selection of the role in the future.

1. Select the Archive link from the Action column.
2. To reactivate an archived role, select the Re-Activate link from the Action column for the role to be reactivated.

Compare

The compare feature allow the user to view all of the roles side by side to see the selections.

Navigation Path

Admin > Company Setup > Permission Roles > Project Mgmt. Roles

Notes

The project management  roles and permissions are defined by the company, exclusive of the system defined Administrator role.   The Project Management Administrator role has full permissions on all functionality within the Project Management module. This role is not editable.

• Roles control the functionality and messaging that a user will have access to.
• Purchasing Permissions are available to BTBuilder customers only  

To Add a Project Management Role

1. Select the Add Project Mgmt. link.
2. Enter the name of the role in the Role Name field.
3. Use the checkboxes to select all appropriate permissions for the role:
1. Download Project Management  Permissions for a complete description of the permissions
4. Select the Save button to save changes.

To Edit a Project Management Role

The Project Management Administrator role is not editable.

1. Select the View/Edit link from the Action column for the role to be edited.
2. Use the checkboxes to select all appropriate permissions for the role. See Step 3 in the To Add a Project Management Role section
3. Select the Save button to save the changes.

To Archive a Project Management Role

Archiving a role does not affect users assigned to that role; it prevents selection of the role in the future.

1. Select the Archive link from the Action column.
2. To reactivate an archived role, select the Archive tab and select the Re-Activate link from the Action column for the role to be reactivated.

Compare

The compare feature allow the user to view all of the roles side by side to see the selections.

Navigation Path

Admin > Company Setup > NSO Roles

Notes

The NSO roles and permissions are defined by the company.   The NSO Administrator role has full permissions on all functionality within the NSO module. This role is not editable.

• Roles control the functionality and messaging that a user will have access to.
• NSO Roles are available to BT Builder and BT Sales customers only.  

To Add a NSO Role

1. Select the Add NSO Role link.
2. Enter the name of the role in the Role Name field.
3. Use the checkboxes to select all appropriate permissions for the role:
1. Download NSO Permissions for a complete description of the permissions
4. Select the Save button to save changes

To Edit a NSO Role

The NSO Administrator role is not editable.

1. Select the View/Edit link from the Action column for the role to be edited.
2. Use the checkboxes to select all appropriate permissions for the role. See Step 3 in the To Add a NSO Role section
3. Select the Save button to save the changes.

To Archive a NSO Role

Archiving a role does not affect users assigned to that role; it prevents selection of the role in the future.

1. Select the Archive link from the Action column.
2. To reactivate an archived role, select the Re-Activate link from the Action column for the role to be reactivated.

Compare

The compare feature allows the user to view all of the roles side by side to compare the roles.

Navigation Path

Admin > Company Setup > Permission Roles > Document Roles

Notes

The document roles and permissions are defined by the company, exclusive of the system defined Administrator role.   The Document Administrator role has full permissions on all functionality within the Document module. This role is not editable.

To Add a Document Role

1. Select the Add Document Role link.
2. Enter the name of the role in the Role Name field.
3. Use the checkboxes to select all appropriate permissions for the role:
1. View Document Permissions for a complete description of the permissions
4. Select the Save button to save changes

To Edit a Document Role

The Document Administrator role is not editable.

1. Select the View/Edit link from the Action column for the role to be edited.
2. Use the checkboxes to select all appropriate permissions for the role. See Step 3 in the To Add a Document Role section
3. Select the Save button to save the changes.

To Archive a Document Role

Archiving a role does not affect users assigned to that role; it prevents selection of the role in the future.

1. Select the Archive link from the Action column.
2. To reactivate an archived role, select the Re-Activate link from the Action column for the role to be reactivated.

Navigation Path

Admin > Company Setup > Permission Roles > TP Document Roles

Notes

• The document roles and permissions are defined by the company, exclusive of the system defined Administrator role.   These roles are for online trade partners.  
• Trade Partner's can upload documents to folders that they have edit roles on, however, they cant delete any documents including the ones that they upload.  Trade Partner's are not able to edit the name, descriptions or attributes on any documents including the ones that they upload.

To Add a Document Role

1. Select the Add Document Role link.
2. Enter the name of the role in the Role Name field.
3. Use the checkboxes to select all appropriate permissions for the role:
1. Click Document Permissions for a complete description of the permissions
4. Select the Save button to save changes

To Edit a Document Role

The Document Administrator role is not editable.

1. Select the View/Edit link from the Action column for the role to be edited.
2. Use the checkboxes to select all appropriate permissions for the role. See Step 3 in the To Add a Document Role section
3. Select the Save button to save the changes.

To Archive a Document Role

Archiving a role does not affect users assigned to that role; it prevents selection of the role in the future.

1. Select the Archive link from the Action column.
2. To reactivate an archived role, select the Re-Activate link from the Action column for the role to be reactivated.

Compare

The compare feature allow the user to view all of the roles side by side to see the selections.

Description

The following Messages are auto-generated from the BuildTopia system and sent to Trade Partners:

Bidding & Contracting:

• Bid Request – New TK bid sent by builder
• Bid Revised – Any TK bid other than a new bid sent by builder
• Bid Closed – TK bid closed
• Bid Sheet Created –New UM bid sent by builder
• Bid Sheet Sent – Any UM bid other than a new bid sent by builder
• Bid Sheet Closed – UM bid closed
• Contract Awarded – New TK contract created
• Contract Finalized – TK contract finalized
• Contract Changes Accepted – Changes accepted on a TK contract
• Contract Expired – TK contract expired
• Bid Sheet Applied to Contract – New UM contract created
• Project Contract Promoted – UM contract promoted
• Project Contract Demoted – UM contract demoted
• Project Contract Terminate – UM contract terminated

Purchase Orders:

• PO Generated – System PO generated
• POs Generated – System POs generated
• PO Modified – PO edited/modified
• PO Approved – PO approved
• PO Reopened – PO reopened
• PO Partial Receipt – Partial quantity received on a PO
• PO Voided – PO voided
• Manual PO Opened – Manual PO opened

DM Messages (with permissions):

• Document Added – DL
• Document Added – Entity
• Document Added – Multiple Associations
• Document Edited
• Document Replaced
• Document Deleted
• Document Comment Added – Builder
• Document Comment Added – TP

Customer Service:

• CS Service Order Opened – CS SO opened/re-opened
• CS Service Order Approved – CS SO approved

Change Orders:

• Change Order Approval – Change order approved

Navigation Path

Admin > Company Setup > Permission Roles > Reporting Roles

Notes

Reporting roles and permissions allow the company to define the roles associated with certain access to reports and the permissions granted to each role. Roles are defined by the company, exclusive of the system defined Administrator role. Once roles are created with permissions, they may be associated to users in the Users tab.

To Add a Reporting Role

1. Select the Add Reporting Role link.
2. Enter the name of the role in the Role Name field.
3. Use the checkboxes to select all appropriate permissions for the role.
4. Select the Save button to save changes

To Edit a Reporting Role

The Reporting Administrator role is not editable.

1. Select the View/Edit link from the Action column for the role to be edited.
2. Use the checkboxes to select all appropriate permissions for the role.
3. Select the Save button to save changes.

To Archive a Reporting Role

Archiving a role does not affect users assigned to that role; it prevents selection of the role in the future.

1. Select the Archive link from the Action column.
2. To reactivate an archived role, select the Re-Activate link from the Action column for the role to be reactivated.

Compare

The Compare link allows the user to view all of the roles side by side to compare which fields are accessible by the different roles.

Navigation Path

Admin > Company Setup > Permission Roles > BT Mobile Roles

Notes

• If BTMobile Roles do not appear in the list of Permission Roles, the company account does not have access to the BTMobile product.  Contact your account owner or Customer Support to add the BTMobile product to your account.
• For step by step instructions in setting up your handheld PDA for BTMobile access, Download BTMobile User Guide and Setup PDF.

To Add a BTMobile Role

1. Select the Add Wireless Role link.
2. Use the text field to enter the Role Name.
3. Use the checkboxes to select all appropriate permissions for the role
4. Select the Save button to save the changes.

To Edit a BTMobile Role

The BTMobile Administrator role is not editable.

1. Select the View/Edit link from the Action column for the role to be edited.
2. Use the checkboxes to select all appropriate permissions for the role. See Step 3 in the To Add a BTMobile Role section
3. Select the Save button to save the changes.

To Archive A BTMobile Role

Archiving a role does not affect users assigned to that role; it prevents selection of the role in the future.

1. Select the Archive link from the Action column.
2. To reactivate an archived role, select the Re-Activate link from the Action column for the role to be reactivated.

Compare

The Compare feature allows the user to view all of the roles side by side to see the selections.