AtTask Administrator Course Book
AtTask Administrator Course Book
AtTask Administrator Course Book
Copyright 2011 AtTask, Inc. All rights reserved. No part of this publication may be reproduced, stored in any retrieval system, or transmitted, in any form, or by any means, whether electronic, mechanical, photocopying, sound recording, or otherwise, without the prior written consent of AtTask, Inc., except as permitted by law. Printed in the United States of America. Third Edition, October 2011 (rev. 20111012) 2
Table of Contents
CHAPTER 1 ORGANIZING REQUIREMENTS ........................................................................................................................................... 9
Lesson 1.1 Gathering Requirements................................................................................................................................................................................................ 10
CHAPTER 2 SYSTEM PREFERENCES IMPACTING USER SETUP ........................................................................................................ 15
Lesson 2.1 Customer Preferences.................................................................................................................................................................................................... 16
Lesson 2.2 General Preferences......................................................................................................................................................................................................... 18
Lesson 2.3 Email Preferences............................................................................................................................................................................................................... 23
CHAPTER 3 ORGANIZATIONAL SETUP.................................................................................................................................................. 31
Lesson 3.1 User Companies................................................................................................................................................................................................................. 32
Lesson 3.2 User Groups......................................................................................................................................................................................................................... 34
Lesson 3.3 Teams ....................................................................................................................................................................................................................................... 37
Lesson 3.4 Roles.......................................................................................................................................................................................................................................... 41
Lesson 3.5 Portal Profiles ....................................................................................................................................................................................................................... 48
Lesson 3.6 Access Levels ....................................................................................................................................................................................................................... 50
Lesson 3.7 Schedule Setup.................................................................................................................................................................................................................... 52
CHAPTER 4 USER SETUP................................................................................................................................................................................ 59
Lesson 4.1 Inviting Users and Adding User Accounts........................................................................................................................................................... 60
Lesson 4.2 Updating User Profiles: User Worksheet ............................................................................................................................................................ 66
Lesson 4.3 Updating User Profiles: Bulk Edit .............................................................................................................................................................................. 69
Lesson 4.4 Updating User Profiles: Individual Edit................................................................................................................................................................... 71
Lesson 4.5 Company Assignments and Org Charts............................................................................................................................................................... 75
Lesson 4.6 Personal Notifications ..................................................................................................................................................................................................... 78
Lesson 4.7 Resetting Passwords......................................................................................................................................................................................................... 84
Lesson 4.8 Deactivating Users ............................................................................................................................................................................................................ 86
CHAPTER 5 SYSTEM PREFERENCES IMPACTING WORK SETUP .................................................................................................... 91
Lesson 5.1 Project Management Preferences ............................................................................................................................................................................ 92
Lesson 5.2 Portfolio Management Preferences.......................................................................................................................................................................101
Lesson 5.3 Business Rules ....................................................................................................................................................................................................................103
CHAPTER 6 WORKFLOW SETUP.............................................................................................................................................................107
Lesson 6.1 Custom Statuses...............................................................................................................................................................................................................108
Lesson 6.2 Approval Processes ........................................................................................................................................................................................................114
CHAPTER 7 ORGANIZING PROJECTS....................................................................................................................................................127
Lesson 7.1 Project Companies .........................................................................................................................................................................................................128
Lesson 7.2 Project Groups..................................................................................................................................................................................................................132
Lesson 7.3 Project Schedules.............................................................................................................................................................................................................134
Lesson 7.4 Portfolios and Programs...............................................................................................................................................................................................136
CHAPTER 8 CUSTOMIZATION.................................................................................................................................................................141
Lesson 8.1 Custom Data Setup .......................................................................................................................................................................................................142
Lesson 8.2 Dashboards and External Pages ..............................................................................................................................................................................158
Lesson 8.3 Global Reports and List Controls...........................................................................................................................................................................167
Lesson 8.4 Modifying Portal Profiles ..............................................................................................................................................................................................173
Lesson 8.5 Modifying Access Levels ..............................................................................................................................................................................................179
CHAPTER 9 TIMESHEET AND HOUR SETUP........................................................................................................................................187
Lesson 9.1 Recurring Timesheet Profiles ....................................................................................................................................................................................188
Lesson 9.2 Timesheet Preferences.................................................................................................................................................................................................192
Lesson 9.3 Hour Types .........................................................................................................................................................................................................................200
Lesson 9.4 Expense Types ..................................................................................................................................................................................................................206
CHAPTER 10 HELP DESK AND INTERNAL SUPPORT SYSTEMS ....................................................................................................211
Lesson 10.1 Issue Management Overview.................................................................................................................................................................................212
Lesson 10.2 Queue Properties.........................................................................................................................................................................................................215
Lesson 10.3 Routing Rules and Queue Topics........................................................................................................................................................................222
WHATS NEXT?...............................................................................................................................................................................................229 Course Feedback ......................................................................................................................................................................................................................................229 AtTask Global Services Options ......................................................................................................................................................................................................229 AtTask Standard Courses ....................................................................................................................................................................................................................229 APPENDIX A ATTASK REQUIREMENTS QUESTIONNAIRE ............................................................................................................231 APPENDIX B REMINDER NOTIFICATIONS AND EMAIL TEMPLATES .........................................................................................237 Lesson 1 Reminder Notifications ....................................................................................................................................................................................................238 Lesson 2 Email Templates ...................................................................................................................................................................................................................240 Lesson 3 Applying Reminder Notifications To Tasks ..........................................................................................................................................................243 APPENDIX C STEPS TO BUILDING ADDITIONAL APPROVAL PROCESSES..............................................................................247 APPENDIX D KICK-START DATA IMPORTER......................................................................................................................................253 Lesson 1 Creating a Kick-Start Template....................................................................................................................................................................................254 Lesson 2 Simple Group and User Imports ................................................................................................................................................................................258 Lesson 3 Simple Project and Task Imports................................................................................................................................................................................261 Lesson 4 Importing Projects with Custom Data ....................................................................................................................................................................264 APPENDIX E ATTASK INTEGRATIONS ..................................................................................................................................................267 Lesson 1 Who Can Integrate?...........................................................................................................................................................................................................268 Lesson 2 Packaged Integrations........................................................................................................................................................................................................269 Lesson 3 Shelving Old Systems ........................................................................................................................................................................................................270 APPENDIX F ONPREMISE CONFIGURATION ACTIVITIES ..............................................................................................................273 Lesson 1 AtTask Installation Overview........................................................................................................................................................................................273 Lesson 2 OnPremise Configuration Steps .................................................................................................................................................................................278
Introduction
We would like to welcome you to the AtTask Administrator education course. It is our honor to have you as a guest to our education center. The intention of our education program is to provide you with a world-class education experience and assist you with obtaining a comprehensive understanding of the full potential of the AtTask solution. The value of AtTask education courses is to provide the opportunity for you to increase your product knowledge depth and reduce your implementation time. Whether you are a part of the Core Team implementing and maintaining the AtTask solution, or an end user, the skills you will learn during your education experience will be applicable to your daily responsibilities and add value to your organization. You will then be able to share your new knowledge with fellow team members to create a highly effective implementation team. Thank you for your time and dedication to making AtTask a standard part of improving your organizations value and efficiency. If you have any questions, feel free to contact anyone on the AtTask Global Services team. In Service to you,
NOTE It is almost always necessary to complete each scenario as you progress through the course. Future lesson scenarios are often be dependent on earlier scenarios.
Practice Exercises Some lessons may contain Practice Exercises that present slightly different use cases from the primary scenario of the lesson. The Practice Exercises are not usually demonstrated during the presentation of course material, but time should be provided for each participant to complete these exercises. The primary purposes of the Practice Exercises are: 1) To present additional ways of thinking about solutions, and 2) To create muscle memory as you repeat the steps from the scenario. The Practice Exercises are meant to stimulate questions you would not have otherwise. If you have questions about the steps you are prompted to follow, please bring them up to your instructor. You will find solutions for the Practice Exercises contained in the exercise steps provided.
Summary Lessons present a summary of material covered to remind you of the objectives. If you feel you the course presentation have not met the objectives of the lesson, ask the instructor to review topics that were not addressed or that are unclear. Exercises Exercises appear at the conclusion of most lessons. When a lesson is primarily informational you will not have Lesson Exercises. Additionally, when several lessons are very closely related, the Lesson Exercises may be presented as Chapter Exercises. The purpose of Lesson Exercises is to measure whether you have learned the material well enough to complete common activities on your own. For the most part, you will not receive step-by-step instructions for completing each exercise. Instead, you will be given general directions and be expected to complete the steps on your own. You may find it necessary to refer back to lesson materials. Likewise, if you find you are stumped on an exercise it is appropriate to ask the instructor for help.
NOTE Like Scenarios, it is always necessary to complete each exercise as you progress through the course. Future lesson exercises are often dependent on earlier exercises.
On more advanced courses, Lesson Exercises may be followed by Exercise Solutions. Exercise Solutions do not appear in primer courses because, in general, each lesson should fully prepare you to complete the steps to satisfy each exercise. If you are not sure you completed an exercise correctly, please ask your instructor to review the exercise.
DISCOVER
Sponsor / Stakeholder Project Manager Business Users AtTask Design Lead AtTask Customer Success Rep
CONFIGURE
Project Manager Implementation Team AtTask Solution Expert AtTask Design Lead AtTask Customer Success Rep
PILOT TEST
Project Manager Pilot Team AtTask Solution Expert AtTask Customer Success Rep
DEPLOY
Project Manager IT Support Customer Support Deployment Team All @task users AtTask Solution Expert AtTask Customer Success Rep Execute Deployment Strategy Team member Training System Readiness Transition to Customer Support Issue Resolution
MAINTAIN
Sponsor / Stakeholder Project Managers @task Administrators AtTask Customer Support AtTask Customer Success Rep
PEOPLE
PROCESS
Business Model Review Business Process Flows System Data Flows Determine Strategic Alignment
Design Session Dene Repeatable Processes Dene Reporting Metrics and Standards Educate Implementation Team Solution Requirements Mapping Environment and Software Setup / Validation Dene Test Procedures Data Readiness
Knowledge Transfer Unit Test Pilot Test Preparation Review/Establish Best Practices Congure @task to design specs
Execute Test Plan Strategy Success Criteria Validation Issue Resolution Evaluate Production Readiness
TECHNOLOGY
This course is not designed to make you experts in each facet of the methodology. Instead it will focus primarily on some of the Design and Configuration activities you will do. As an abbreviated summary of what you will hope to accomplish in your initial implementation, the following outlines what you will be doing during your implementation period in three steps. 1. Identify a single existing process or a few key projects you wish to map into AtTask. Create a flowchart to illustrate process. Provide definitions of each step, containing key players, skill sets, and a verbose description of the step. Identify necessary reports to support this process. 2. 3. Define success criteria for your AtTask implementation. Configure AtTask to support this process, perform user acceptance tests to validate your success criteria are met, and roll out generally (to users involved in this process).
After your initial implementation, repeat these steps to bring additional processes and group into the software.
10
Nearly everything in the system can be directly connected to one or both of these components. In AtTask-speak, you usually refer to these two objects as Users and Projects (and tasks, issues, hours, approvals, etc.).
This is not meant to illustrate a comprehensive diagram of all the relationships to AtTask objects for the user profile.
11
This is not meant to illustrate a comprehensive diagram of all the relationships to AtTask objects for the project object.
As you begin implementing AtTask, you can usually categorize each security, process, or other requirement as a User or Work requirement.
12
Initiative Review
What problems you are trying to solve that prompted this initiative? What are the strategic questions you hope to answer through purchasing AtTask? What metrics have been established to determine the success of implementing AtTask?
Business Processes
Project Management How are Projects managed today? Include any documentation or illustrations for clarification. With regards to project management, what does the ideal future state entail? What constitutes a successful Project Management implementation? Identify the current projects you will be migrating into AtTask. What application or tool or they currently stored in? Do you have a diagram or documented workflow for each project that includes the process, tasks, resources, and workflows defined? Resource Management How are Resources managed today? Please include any documentation or illustrations for clarification. What constitutes a successful Resource Management implementation? Issue Management Will you be tracking issues against projects in the system? Please describe the desired process of how project issues should be handled in the system. Will you be using AtTask as a help desk or issue management system outside of projects? Please describe the requirements of how you would like this process handled in the system. Business Users Which departments/divisions will be involved in the initial rollout? Which additional departments will be involved in the final rollout? How many unique processes will be involved in the initial rollout? Final rollout? When are you expecting to roll your first process to the implementation team? Each additional process? How many users will be needed to trained in the initial rollout? Final rollout? (Please segment users into the following groups, Administrators, Project/Program Managers, End Users, and Executives) Can you provide an org chart that defines the user community with locations?
Reporting
Describe in detail all the reports you plan to generate in AtTask by group/department. What dashboards are required for the Executive team to improve visibility and management capabilities?
Other
Describe additional requirements determined by your desired workflow and/or corporate culture that may impact your AtTask configuration.
13
Once you become familiar with AtTask objects you are prepared to answer requirement questions through other means, such as the checklist shown below. See Appendix A for full versions of these questionnaires.
NOTE Throughout this course, you will be presented with sample requirements and see a demonstration of the steps necessary to satisfy the requirments.
14
15
The Customer object represents your organization, an AtTask, Inc. customer. There are a number of global options that appear in this area of the application. System Administrators can access and make modifications to their Customer profile by going to Setup Organizational Setup Customer Info. Once in the Customer Info area, click the Edit Customer link in the left-hand navigation. The primary fields of importance are the Time Zone, Locale, and Currency fields.
Time Zone Represents the default time zone for the implementation. It will be the selected time zone as new user resources are created. Locale The Locale field controls the date and number format used in outgoing email messages. The value selected here acts as a default for new user creation, but can be modified on a user-by-user basis so individuals in remote offices can view dates and numbers in conventional formats familiar to their countrys language. The Locale also controls the language format of outgoing emails. The list of supported languages is provided below: Supported Languages English (US) Spanish French Japanese German Chinese (Traditional and Simplified)
Currency The Currency field controls the currency symbol that will be used in financial reporting.
16
Lesson Notes
17
System preferences dealing with system security are located in the General Preferences area. Project Managers and other people in your organization will be impacted by the selections made on this screen. This lesson will highlight some of the more relevant options in this area. The General Preferences area is only accessible to users with System Administrator access. An administrator will access this page by going to Setup System Settings Preferences General Preferences.
Passwords
Password Complexity Requirement As the system administrator, you have the ability to set the Password Complexity Requirements.
NOTE If using LDAP or SSO, password requirements will be dictated by your active directory configuration.
High Complexity Passwords must be at least eight (8) characters in length. Passwords should include at least three of the four character types. Users will be prompted to change their password every 90 days. Character Types Uppercase letters Lowercase letters Numbers Special characters (such as ?, &, %, etc.)
Medium Complexity Passwords must be at least six (6) characters in length. Passwords should include at least two of the four character types.
NOTE When the Low option is selected no requirements are imposed on the password.
18
Password Timeout Incorrect Password Timeout This field indicates the amount of time that must lapse when an incorrect password is entered. The timeout is triggered if there are five consecutive login failures.
SCENARIO Your IT department informs you that all web-based applications must automatically log people out after 15 minutes of inactivity. Use the Session Timeout field to set a preference to meet this security requirement.
Time Out
Session Time Out This field allows OnDemand customers to define the duration of browser sessions. For OnPremise customers, note that AtTask will use the smallest value from this field or the Session Time Out field on the system configuration pages.
NOTE In the absence of a strict security policy, be sure to balance your security preference against what will make the application easier for users to interact with.
19
The remainder of the material in this lesson is provided for reference only. It describes the other fields presented on the General Preferences form that are not necessary to meet the requirements outlined. You can also review further detailed material on these topics on the AtTask Help site help.attask.com.
URL Configuration
Use External Path Setting for Flash Applications The Use External Path Setting for Flash Applications field is only set to Yes under certain situations, such as using a security certificate in your AtTask connection, in which applying the certificate breaks Flash functionality (Gantt Chart, Resource Grid, Team Builder, and Capacity Planner). Do not set to Yes except as a troubleshooting step if the Flash applications never load. Help URL It is common in large implementations for the core team to create a custom help site, portal, or Wiki to distribute training material, videos, and customized documentation. By inputting the URL to the custom webpage into the Help URL field, the Help link in the upper right corner of the interface will direct users to that page instead of the AtTask Community. It is common to reference AtTask material on your organizations custom help page or provide a link back to the AtTask Community.
Report Configuration
20
Prompt Security Allows the ability to show drop-down, checkboxes, radio buttons, and multi-select fields on a prompt screen when running reports for non-static fields. Aggregate report caching Allows for faster load time on Aggregate Reports, which typically requires querying large datasets.
21
Lesson Notes
22
NOTE The following scenarios discuss only the settings of fields common to both on-demand and on-premise customers. On-premise customers will want to review Appendix F for specific email configuration steps unique to installed instances of AtTask.
SCENARIO It has been decided that all system-generated emails should come from the following email address: attask@yourcompanydomainname.com. The expectation is this email address will communicate to individuals receiving emails that the message is from your account of AtTask and can be trusted. Update the System Email Address field to use the above address.
To change the From Address of outbound emails 1. 2. 3. Open the Email Preferences page. Locate the System Email Address field in the Mail Setup section. Change the value from noreply@attask.com to attask@yourcompanydomainname.com.
4.
Click Save.
System Email Address This is the From address for most emails sent from AtTask. It is suggested that you change this to something your end users will recognize as coming from your account of AtTask. Suggested Value: attask@companydomainname.com
23
SCENARIO Project managers plan on placing Reminder Notifications on high-priority tasks. These timed notifications, by default, are sent once a day. Project managers want them to be sent out on an hourly basis. Update the Reminder Notifications field to reflect this requirement.
To change the frequency of outbound timed notifications 1. 2. 3. 4. Open the Email Preferences page. Locate the Reminder Notifications field in the Notes and Messaging Options section. Change the value from Daily to Hourly. Click Save.
Reminder Notifications This field controls how frequently AtTask will send reminder notifications to your user base.
24
SCENARIO Both project managers and team members want to be able to reply to emails sent from AtTask and have their responses captured as notes on the project, task, or issue related to the original email they received. Enable inbound emails by populating the fields in the POP Configuration section of the Email Preferences page.
To convert inbound emails to notes 1. Outside of AtTask, setup a POP email account on your internal mail server. This needs to be an email account use solely for routing AtTask notes. Otherwise, you will either get unwanted messages in your AtTask account; or people sending email to this account that are not licensed AtTask users will receive an email saying their email could not be received, and the message will be lost. Open the Email Preferences page. Locate the POP Configuration section. In the POP Time dropdown, select the frequency you want AtTask to check for new mail. Change the POP Enabled radio button to Yes.
2. 3. 4. 5.
6. 7.
Input the full address for the POP account you created previously in the POP Email Address field. Input the username and password for the email account in the POP Username and POP Password fields respectively.
8.
Input the server address where the POP account was setup into the POP Server field. Depending on your mail server configuration, update the Enforce SSL/TLS and Port Number fields.
9.
25
POP Time This represents the frequency that AtTask will check for new email in the POP email account designated for replies to system emails and notes.
POP Enabled If the POP Enabled is set to Yes, AtTask will query the POP email account setup for new note creation and pull replied-to emails into the system as notes. POP Email Address This is the full email address for the designated POP email account. It will be inserted into the header for outgoing emails as the Reply-To address. POP Username This is the username for the POP email account. POP Password This is the password for the POP email account. POP Server This is the server where the POP email account exists. Enforce SSL/TLS If your POP server only accepts secure connections, change this value to Yes, then input a Port number in the following field. Port Number Identifies the secure port used by your SSL/TLS connection to the POP server.
26
SCENARIO By default, to route inbound messages to the correct work item or note thread, AtTask appends the subject line with the records object code and unique ID.
You want to hide the object code and ID because it causes confusion and messages are not getting routed when people remove that portion of the subject in their replies.
To hide the object code and ID in subjects of emails sent from AtTask 1. 2. 3. 4. 5. Outside of AtTask, configure your mail server to support Reply-To Plus Addressing. Open the Email Preferences page. Locate the Use Reply-To Addressing field in the POP Configuration section. Update the field to Yes. Click Save.
Use Reply-To Addressing Mail servers that support reply-to plus addressing will store the data needed in an email to reply and post messages to AtTask in the reply-to header. Otherwise, this data will be stored in the email subject.
27
The remainder of the material in this lesson is provided for reference only. It describes the other fields available when defining Email Preferences that are not necessary to meet the requirements outlined in the scenarios. You can also review further detailed material on these topics on the AtTask Help site help.attask.com.
Mail Server Hostname This specifies the mail server through which email from AtTask will relay on its way to the recipient. OnDemand Value: OnPremise Value: mail your corporate mail server
Bounce Email Message The value input into this field is the message that unauthorized senders will receive as they attempt to submit an issue via email. If it is left empty the message indicates that a non-licensed resource does not have access to submit an issue to a queue. Use Generic From Address Emails sent as notes are not considered system-level emails. As a user enters a note and sends it to selected recipients as an email, the default from address for the email will be set to the email address associated with the senders user profile.
Sometimes, the receiving mail server will reject the emailed note because it appears to be spam. In cases where system emails are being received, but note emails are not, the first solution is to set the Use Generic From Address field to Yes. Generic From Address Normally the Generic From Address is set to match the System Email Address field above. Alternatively, your email administrator can white list emails being sent from the AtTask server and/or turn off the anti-spoofing utility for emails sent from AtTask. Default Message Email Setting When set to Yes, the Email Recipients checkbox will automatically be marked on the New Notes interface and the Optional Comment box, and the selected recipients will receive the recorded note via email and through the messaging system.
Default Comment Box Visibility The default setting is to have the Optional Comment box appear Automatically once a change is made on the project, task, or issue. Alternatively, you may set the Optional Comment box to display immediately on the Edit or Update project, task or issue screens. This is done by setting the value for this field to Always Visible.
28
Exercise 2
Will your team members be able to reply to AtTask emails to generate notes in the system? If so, gather the following information to issue a request to your IT department to provision the POP email account: Prefered Reply-To Email Address Prefered Email Account Username Prefered Email Account Password Be sure to include in your request that the email account must be a POP account. Also find out if: Your POP server supports Reply-To Plus addressing Your POP server requires a secure connection
Lesson Notes
29
30
31
SCENARIO Create a Company to represent your organization so during user creation you can make managersubordinate relationships.
System administrators can create or modify Companies by going to the Create menu and selecting Company.
Company On the New Company form, locate the Company field and input your companys name. Inputting company billing rates and assigning companies to users is addressed in future chapters. NOTE If additional fields are necessary, you can create a Custom Data form to expand the information stored at the company level.
32
Exercise 2
If you plan on creating user accounts for people outside of your company (e.g., vendors, subcontractors, clients), make a list of those organizations you will need to add to your account. This will allow you to associate the external users with the appropriate companies.
Lesson Notes
33
SCENARIO The following departments will be using AtTask to manage their unique projects: Development Marketing Professional Services Review the groups already created in your demo account of AtTask and add the missing groups.
System Administrators access the Groups are by going to Setup Organizational Setup Groups. Once you are in the Groups area, you can create a new Group by clicking on the New Group link in the left-hand navigation menu. 34
Group Input the name of the group in the Group field. Add a description if desired.
NOTE Group membership impacts what people can see. Most default access levels do not allow project collaborators to view work items on projects associated with other groups unless they are specifically assigned to the project team.
35
Exercise 2
Identify the departments that will be utilizing AtTask.
Lesson Notes
36
To Create the Product Management Team 1. 2. 3. Expand the Create menu and select the Team option. Enter a name descriptive enough for others to recognize what the Team represents. Click the Add Team Member link to assign resources to the team. Repeat this step until you have entered all team members. Click save when you are finished.
PRACTICE EXERCISE Follow the same steps provided above to build out the Creative team.
It is strongly recommended you always discuss your organizations team needs with all stakeholders before creating teams.
38
The remainder of the material in this lesson is provided for reference only. It describes the other options available when defining a team that are not necessary to meet the requirements outlined. You can also review further detailed material on these topics on the AtTask Help site help.attask.com.
2.
From the Team Home list, select the name of the team you want to alter.
3. 4.
Click the Done Button tab. From the list below, select the status you want to appear when your team members finish a task. You may select more than one option if you want a variety of statuses to apply to a finished task or issue. Be sure to save your changes.
39
Exercise 2
Refer to the scenario for Lesson 3.3 and create the remaining Marketing teams with the respective user assignments.
Exercise 3
Build out a list of teams you will be creating in your AtTask account:
Lesson Notes
40
Review the existing roles and create only those that are not already in the sytem.
An Administrator can create new jobs by going to the Resource Management Job Roles area. To create the roles for this exercise 1. Go to Resource Management Job Roles. Notice the Consultant role already exists in this environment, so you will not need to create that role. Click the Add Role icon. Input Associate Consultant in the name field. Input Associate Consultant in the Job Role field. Provide a description, as needed. Input the Cost Per Hour and Billing Per Hour for this role.
2. 3.
4. 5. 6.
41
Cost Per Hour When a task has a role-based cost rate and a role is assigned to the task, this is the value that will be used to estimate a planned cost and the actual cost of the task. Billing Per Hour When a task has a role-based revenue rate and a role is assigned to the task, this is the value that will be used to estimate a planned billing amount and the actual revenue of the task.
PRACTICE EXERCISE Repeat steps 2 through 6 to create the Solutions Architect and Technical Consultant roles.
PRACTICE EXERCISE Locate and click into the Consultant Role provided with your account. Try editing it and updating the Cost and Billing rates.
42
SCENARIO Project managers in the Accounting group need significantly more roles added to the system. You decide it would be more beneficial to import them instead of manually entering the names on the New Job Role page. Accounting Roles Accountant Accounts Payable Accounts Receivable Auditor Business Analyst Controller GL Accountant Intern Revenue Accountant Cost Rate $30 $25 $35 $55 $40 $70 $30 $13 $30 Billing Rate $60 $50 $70 $90 $80 $110 $60 $26 $60
Download the role import template from the AtTask Help site https://community.attask.com/sites/default/files/Job_Roles_Import_Sample.xls and update it to include the above roles.
To import a list of job roles 1. Download the import template, fill in at least the Name field, and save it as a comma-separate or tabseparated text file (*.csv or *.tsv).
2. 3.
Navigate to Resource Management Job Roles. Click the Import Job Roles link in the lefthand navigation menu.
43
4. 5.
Browse for and select the file you have already prepared for import. Click the Next button.
NOTE The file must be either a comma separated or tab delimited text file. Normally these are created in Excel (or equivalent) and then saved as a *.csv file.
6.
Map the AtTask fields from the Field Name column to the data from the import file, which shows up in the series of drop down fields. Click the Finish button.
NOTE If your import file contains a header row, be sure to mark the First Row Is Header checkbox.
7.
44
NOTE If you are planning on completing several imports that will use the same file structure, you may want to go on to the Next step where you can save your mapping for future use.
NOTE The Job Role name must be unique. If you are attempting to import a role that already exists in the system you will receive a message indicating you should check for duplicates.
45
You do not want to click into each role to make these modifications. Use the Roles Worksheet to make the necessary updates.
To edit job roles 1. 2. Select the checkboxes for the roles you wish to edit. Click the Role Worksheet action link icon toolbar.
3.
Make any changes you might need to make and click the Save button.
Associating roles with users will be discussed in the User Setup lesson.
46
Exercise 2
Identify the job roles you will need to add to your account of AtTask:
Lesson Notes
47
NOTE Administrators cannot modify built-in profiles, but they can copy these profiles and make adjustments to the copies. The process for customizing Portal Profiles will be discuss later.
48
NOTE For a complete breakdown of the reports each portal profile provides see the Help Article on this topic https://help.attask.com/#url=/index.php/node/load/694.
Lesson Notes
49
NOTE For a complete breakdown of what permissions each access level provides see the Help Articles that describe each access level https://help.attask.com/#url=/index.php/node/load/171.
50
Lesson Notes
51
52
To edit the Default Schedule 1. 2. 3. 4. 5. Navigate to Resource Management Schedules. Click the Schedule named Default Schedule. Click the Edit Schedule link in the left-hand menu. Rename the Schedule and make other changes, as needed. Go to the Schedule Exceptions tab and select each day of the year that represents a corporate holiday.
6. 7. 8. 9.
Click the Edit icon to the right of the November 21, 2012 entry. Deselect the Entire day off checkbox and set the start and end range to reflect the time that people will be working. Repeat step 5 to 7 for the next three to five years. Click Save to store the change to the date.
NOTE Generally, you will want to update the Default Schedule to match your system requirements as early as possible. As you have need for additional schedules you can then copy the schedule and make fewer adjustments over all.
53
To Create the US West Coast Schedule 1. 2. 3. Navigate to the Schedules area. Click on the New Schedule link on the left navigation menu. Input a name for the schedule, identify the groups that should have access to modify it, and select the timezone the schedule supports. DO NOT mark it as the default schedule; this will automatically assign it to new users as they are created.
4.
54
5. 6. 7.
Click the Monday 9 AM cell and drag to the Monday 12:30 PM cell. Click the Monday 2 PM cell and drag to the Monday 5:30 PM cell. Repeat steps 7 and 8 for each weekday.
8. 9.
Navigate to the Scheduel Exceptions tab. Click each day of the year where project work will not be done because of corporate holidays.
10. Repeat step 9 for the next three to five years. 11. Click Save to submit the schedule. 12. Click Save again to save the user profile.
55
Precedence of Schedules
Schedule User Description Whenever a user is assigned to a task, the schedule assigned to the user, combined with the users PTO schedule, will be used for the given task. Exception: When multiple users are assigned to the same task, and if any of the user schedules conflict, AtTask will either: 1) Use the schedule assigned to the project where the task resides 2) Use the schedule assigned to the default assignee of the task The behavior described in this exception depends on the preference set on the Project Management Preferences page. Project The project schedule is utilized when any of the following conditions are met: A user has not been assigned to the task Several users with differing schedules are assigned to the same task Default Schedule The system default schedule will be used if the schedule has not been set for the project and when the conditions for using the project schedule are met.
56
Exercise 2
Identify the standard corporate holidays your company observes that will apply to all Schedules.
Exercise 3
If you have an international implementation of AtTask, repeat Exercise 2 for each region you have people accessing AtTask from.
Lesson Notes
57
58
59
Additional requirements for these user accounts will be provided in the subsequent lessons.
NOTE Usernames must be unique; if you have a duplicate entry no users will be imported until the duplicate is removed. For this course only, because you are working in a shared environment, append each username entry with your assigned account number your invitations will not be sent otherwise.
To invite these user accounts 1. Navigate to Resource Management User Management Add & Invite Users Add Users & Manage Invitations.
2.
Fill in the First Name, Last Name, Email Address, Access Level, and Home Group fields for Adam Michaelson.
60
3.
Click the New User button for each additional user and input their information.
4.
AtTask will create user profiles for each person you input into the form and send invitations to those individuals.
You can manage the invitations sent from AtTask by clicking back into Add Users & Manage Invitations, and then selecting the Invited Users tab.
From this tool, you have the ability to delete a user profile if you needed to revoke an invitation or to send the invitation again if the invitation has expired. Preferences for user invitations are found at Resource Management User Management Add & Invite Users Preferences. The image on the following page shows what this preferences page looks like.
61
62
2. 3. 4.
NOTE There are five required fields for every user profile: First Name Last Name Email Username Password
63
5.
This file appears as a series of drop down fields. Map the AtTask fields from the Field Name column to the data from the import file.
6.
Click Finish.
At the top of the import-mapping page, you will notice fields for the users Home Group, Company, Access Level, and Job Role. At the time of import, the values in these fields will be used if no mapping is provided in your worksheet. When importing users with Home Group, Company, Access Level, and Job Role associations, AtTask does a name match for these user attributes you do not need to reference the object IDs.
NOTE If your import file contains a header row, be sure to mark the First Row Is Header checkbox.
64
Lesson Notes
65
SCENARIO The Development users you imported in the last lesson require the following Access Level and Company associations, which can be done through the User Worksheet. User Names Adam Michaelson Jason Waters Jesse Dowdle Sean Stephenson Access Level Project Manager Team Member Individual Contributor Team Member Company Goal Sports Zen Imports Goal Sports AtTask, Inc.
To edit users in the User Worksheet 1. 2. Navigate to the User Management report by going to Resource Management User Management and then clicking the User Management tab. (Or do a search for users.) Select the checkboxes to the left of the users you wish to view in the User Worksheet.
3.
66
4.
67
Lesson Notes
68
SCENARIO The Development users you imported were all imported with the incorrect Job Role. They should all be Engineers. Additionally, all of these users should have their Home Team set as Product Development. Finally, each of these resources should use the TeamHome page as their primary interface. Do a bulk edit for these four resources to make the above adjustments.
To edit users in a Bulk Edit 1. Select the checkboxes to the left of the users you wish to view in the Edit Users interface.
2. 3.
Click the Edit action from the icon toolbar. Click the checkbox to the left of the fields you want to edit, and select the appropriate option. Marking the checkbox to the left of a field activates the field. Only activiate fields can be modified and are included in the edit when you click Save.
4.
Click the Save button to record the changes. NOTE If you need to modify the values of Custom Data fields you created previously, change them on the Custom Data tab.
69
Exercise 2
Do a bulk edit for all resources to use the Default Schedule.
Lesson Notes
70
To update Rays profile 1. Use the quick search field in the top right of the interface to search for Ray Andrews. Click on Rays name in the search results.
2.
3.
4. 5. 6. 7.
Go to the Related Information tab. Change Rays home team association. Change Rays default job role. Change Rays timezone to Pacific Standard Time.
NOTE When a person is given a default job role, the role is also assigned as one of the selected options in the Job Roles field, which shows all roles the individual can fulfill. In Rays case he should have never been assigned as a Support Engineer, so he needs this option to be deselected in the Job Roles field.
8. 9.
Expand the Schedule field and select the US West Coast schedule. Click Save. 71
The following images provide brief explanations of each field on the New/Edit User forms. Full descriptions of fields are provided on the AtTask Help Site help.attask.com. Contact Information Tab
72
73
Lesson Notes
74
SCENARIO There are a number of resources already associated with the Goal Sports company, but they do not necessarily have the correct Org Chart relationships. Chris Manning should report directly to Jack Oliver (his functional manager), not Jennifer Campbell (the project manager he typically works with). Edit Chriss profile to make this adjustment.
To update Chriss manager assignment 1. 2. 3. Access Chris Mannings profile either by searching for him or using the Recent menu. Once you are viewing the user profile, click the Edit User link on the left navigation. Navigate to the Org Chart tab.
4. 5.
Expand the Reports To dropdown, and select Jack Oliver. Click Save.
Resources can only be associated with other individuals that share the same company assignment. It is recommended you do a bulk edit to make company associations prior to building the Org Chart. This will speed up the process of assigning managers and direct reports.
75
NOTE Typically, resources are associated with their actual managers, not project managers they work with. In many cases, team members work with several project managers at once. To leverage the AtTask org chart to its fullest, you will not want to relate resources to project managers.
TIP The fastest way to build Org Chart relationships is from the top down. Starting with people filling management positions allows you to use the Direct Reports field, which results in fewer user profiles to edit.
76
Option 1 Steps 1. 2. 3. 4. 5. Navigate to Ray Andrews user profile. Click Edit User. Navigate to the Org Chart tab. In the Direct Reports field, Ctrl-click Erin Davis and Marshall Thompson. Click Save.
Lesson Notes
77
SCENARIO Go into your user profile and deactivate the following notifications: Help Desk Request Status Change to Issue Assigned To Help Desk Request Status Change to Issue Primary Contact Help Desk Request Document Add to Issue Primary Contact Help Desk Request Document Add to Issue Assigned To
To update your personal Notifications preferences 1. 2. 3. 4. 5. Click on your name in the upper right of the interface. Click the Edit User link in the left navigation. Navigate to the Notifications tab. Deselect the identified notifications. Click Save.
NOTE Additional notifications are automatically added to the Email Me When list and enabled as system administrators enable Event Handlers. See the section on Event Handlers for more information.
78
Notification
Help Desk Request Add to Issue Primary Contact Help Desk Request Assignment to Issue Primary Contact Help Desk Request Closed to Issue Primary Contact Help Desk Request Document Add to Issue Assigned To Help Desk Request Document Add to Issue Primary Contact Help Desk Request Note Add to Issue Primary Contact Help Desk Request Status Change to Issue Assigned To Help Desk Request Status Change to Issue Primary Contact Issue Commit Date Change to Project Owner Task Commit Date Change to Project Owner Task Completion Date Changed to Assigned To Work Item Comment to Thread Participants Work Item Comment to Work Item Assignee Work Item Request to Team Work Item Request to Work Item Assignee Work Request Completion Date Changed to Assigned To Work Request Reply To Work Requester
Description
Emails the individual identified as the Primary Contact for new issues submitted to a Help Desk queue. This is especially useful if it is common to submit issues on behalf of other people. Emails the individual identified as the Primary Contact when a user resource is assigned to their request. Emails the individual identified as the Primary Contact when the status of the request is changed to Closed. Emails the individual assigned to an issue when a document is attached. Emails the individual identified as the Primary Contact when a document is attached to their request. Emails the individual identified as the Primary Contact when another user adds a note to their request. The email contains the content of the note. Emails the individual assigned to an issue when another user updates the status of an issue. Emails the individual identified as the Primary Contact when the status of their issue changes. Emails the individual identified as the Primary Contact when the commit date of their issue is adjusted. Emails the project owner when the commit date of a task on one of their projects is adjusted. Emails the individual assigned to a task when the planned completion date has been adjusted. Emails all individuals on a note thread when additional comments are made. Emails the individual assigned to a task or issue when others make comments on their work item. Emails members of a team (not the project team) when an issue is assigned to the team. Emails the individual assigned to a work request. Emails the individual assigned to a work request when the planned date is adjusted. Emails the person initiating a work request when the assigned individual replies to the request.
NOTE Some notifications are redundant. For example, if Help Desk Request Status Change to Issue Primary Contact is enabled is not necessary to enable Help Desk Request Closed to Issue Primary Contact. However, do spend too much time making sure redundant emails are accounted for. When redundant notifications could be sent the application is smart enough to only send one. 79
Event Handlers
Event Handlers allow administrators to turn on additional notifications. When Event Handlers are enabled AtTask adds the notification to the Personal Notifications list (in an enabled state). Each person has the ability to turn them off individually to match their preference for emails they receive from AtTask. You will want to consult with Project Managers and Executives to identify which of the email notifications make the most sense for your organization. The Event Handlers area is accessible to users with the System Administrator access by going to Setup Workflow Setup Event Handlers.
SCENARIO As an implementation team (in discussion with your project managers) you decide project managers should receive an email when Issues are added Milestones task are completed Tasks progress status changes from On Time to Late to the projects they own.
To activate the Event Handlers 1. 2. Navigate to the Event Handlers page Locate and select the checkboxes to the left of the Event Handler name(s) you wish to enable Issue Add to Project Owner Milestone task Completion to Project Owner Task Progress Change to Project Owner 3. Then click the On light bulb ( ) from the action icons a red checkmark ( newly activated Event Handler(s). ) will appear next to the
To deactivate an Event Handler 1. 2. Select the checkboxes to the left of the Event Handler name(s) you wish to disable. Then click on the Off light bulb ( from next to the Event Handler(s). ) from the action icons the red checkmark ( ) will disappear
NOTE You can select multiple Event Handlers using the Shift key to select a range, or use the Ctrl (PC) or Command (Mac) key to select multiple options outside of a range.
81
NOTE Some Event Handlers can be redundant. For example, if you enable the Issue Completion to Project Team email, you likely do not need to enable the other Issue Completion to emails. Review the full list of Event Handlers in your account of AtTask and discuss which ones should be enabled to best facilitate communication and not be a nuisance to recipients.
82
Exercise 2
Go into your user profile and disable the Current Project Status Change to Project Team email. Afterall, you are the one who will likely be changing the status of the projects you belong to.
Exercise 3
Identify the Event Handlers you plan on enabling in your account:
Then discuss this list with other stakeholders to get their opinions.
Lesson Notes
83
4.
As an administrator, you can reset passwords for any user in the system by navigating to a user profile and then clicking the Reset Password link.
NOTE A System Administrator does not need to input the current password in order to reset the password.
NOTE Once the LDAP or SSO integration is enabled the ability to reset passwords through AtTask is deactivated.
84
Lesson Notes
85
To deactivate a user account 1. 2. Navigate to Rays user profile. Click the Edit User link on the left navigation.
3.
4. 5. 6.
Expand the Access Level dropdown and select the N/A option. Deselect the Is Active checkbox. Click Save.
You will likely need to make other adjustments as well. You may want to: Change any Org Chart relationships. Do a search for incomplete tasks assigned to Ray to reassign to his replacement (using a bulk edit). Do a search for incomplete issues assigned to Ray to reassign to his replacement (using a bulk edit). Do a search for active projects where Ray was assigned as the project owner to reassign. Update templates, routing rules, and approval processes.
86
Deleting Users
It is generally not a good idea to delete a resource that has been an active user in AtTask. Deleting users results in a loss of information. AtTask does provide the option to identify a replacement user when you do attempt to delete a resource; however, even this has its drawbacks.
When you identify a replacement user, AtTask reassociates all task assignments, notes, hour entries, etc. with the replacement user. The result is that historical and current utilization of the replacement user becomes inflated; their time entries are potentially doubled; and notes they did not write are ascribed to them. It is recommended the only time the Delete User option is used is when you create a user profile and soon after realize that the profile is not needed.
SCENARIO The user account you imported for Jason Waters is not necessary. Jason has never logged in and has not been assigned to any work yet. Instead of keeping the profile in your AtTask account creating clutter, you decide it is appropriate to delete the profile.
87
To delete Jasons user account 1. 2. 3. Search for Jason Waters profile. Once viewing the profile, click the Delete User link on the left navigation. You will be presented with a confirmation screen to verify you actually want to delete the user account.
4.
Click Delete.
NOTE The Replacement User step only appears if the user account you are deleting has been assigned work of some format or to a team.
88
Lesson Notes
89
90
91
92
SCENARIO Projects in the Current status are generally considered to be active or executable projects. This means they appear on reports, people receive notifications of new assignments, etc. According to the project management requirements you have identified, all new projects should have an approved work breakdown structure (WBS) before the project becomes active. Project managers have requested that all new projects use Planning as the initial status.
To set the default Status of new projects 1. 2. 3. Open the Project Management Preferences. Locate and expand the Status field in the Project Creation Defaults section. Select the Planning option.
Status Indicates the default status displayed on the New Project form. This does not impact the New Project Request form.
SCENARIO Project managers are required to have formal close out steps built into the work breakdown structure (WBS) of their project plans. Once the last task is completed on the project plan, project managers want the project to automatically complete itself. Update the Completion Mode field to support this request from project managers.
To set the default Completion Mode of new projects 1. 2. 3. Open the Project Management Preferences. Locate and expand the Completion Mode field in the Project Creation Defaults section. Select the Automatic option.
Completion Mode When set , AtTask changes the status of the project from Current to Complete as the last task or issue is completed. When set to Manual, the project manager must manually change the status of the project upon noticing the completion of all work for the project to be Complete.
93
SCENARIO As already identified, projects will be created in the Planning status. While in this phase the WBS will be planned. When the project status is changed to Current, you want the system to create a baseline automatically. The baseline will be used to measure current progress and scope creep against the originally approved plan.
To enable Automatic Baseline Creation 1. 2. 3. Open the Project Management Preferences. Locate and expand the Create Baselines Automatically field in the Project Creation Defaults section. Select the Yes option.
Create Baseline Automatically When projects are created from a template or when the status changes to Current, AtTask will automatically create a baseline snapshot of certain task and project details.
94
SCENARIO A tasks Duration Type controls the relationship between the number of resources (and their percent allocation), the duration, and the total effort for the task. Your project managers have indicated that when they create tasks they want to quickly assign a resource and independently control the duration and effort required to complete the task. Change the Duration Type preference to Calculated Assignment to facilitate this request.
To change the default Duration Type for all new task 1. 2. 3. Open the Project Management Preferences. Locate and expand the Duration Type field in the Task Creation Defaults section. Select the Calculated Work option.
95
SCENARIO Business analysts need to produce financial estimates based on the amount of effort planned for tasks and the number of hours actually recorded. Specifically, business analysts want to derive revenue and cost estimates from the rates defined on the user profile. Change the Revenue Type field to User Hourly.
To set the default Revenue and Cost Types for new tasks 1. 2. 3. 4. Open the Project Management Preferences. Locate and expand the Revenue Type field in the Task Creation Defaults section. Select the User Hourly option. Notice the default Cost Type is already set to User Hourly.
Revenue Type This is used to calculate planned and actual revenue estimates for a task. When the Revenue Type is set to Not Billable, the hours planned and the actual hours recorded will not generate a revenue estimate for the task, and the work on the task will not contribute to project-level revenue. Cost Type This is used to calculate planned and actual cost estimates for a task. When set to No Cost, the hours planned and the actual hours recorded will not generate a cost estimate for the task, and the work on the task will not contribute to project-level costs.
96
To enable automated system notes for Issues, Tasks, and Projects 1. 2. 3. Open the Project Management Preferences. Locate the Record Change Defaults section. Select the Status Change, Scope Change, and General Edit checkboxes for each work item type.
97
98
Descriptions of Other Task Creation Defaults Default Start Date Controls the default task constraint for new tasks. Project Planned Date: Defaults new tasks to the As Soon As Possible (ASAP) or As Late As Possible (ALAP) task constraints, depending on the projects Schedule Mode. Today: Defaults new tasks to the Start No Earlier Than (SNET) or Start No Later Than (SNLT) task constraints, depending on the projects Schedule Mode. Tracking Mode Controls how and when task-level progress status indicators will be displayed. Library Task Mode Library Tasks are used in environments where team members are given the ability to add tasks to a project. However, if this is enabled, team members can only create tasks from a library. When enabled with either the Optional or Enforced options, the system administrator has to create a catalog of Library Tasks that can then be brought into a project plan. This feature is very rarely enabled.
99
Descriptions of Update Status Tab Preferences and Time Entry Show Document Upload Displays a Browse Document field on the Task or Issue update tabs. This is enabled when the completion of tasks commonly results in the production of a document or file that needs to be attached to the completed task. Show Custom Data If a category is attached, this displays the Update Custom Data form on the Update Status tab. This is ideal if the completion of task work requires changes to the custom data values. Hide hours section on Task and Issue Updates Status tabs Organizations not interested in tracking actual time spent working on tasks or issues may hide the Hours field from the Update Status tabs. This does not prevent users from recording time through the Complete Status Worksheet, or the Timesheet. This setting is meant to remove unnecessary fields from the Update Status tabs only. Allow Time Entry Against Completed Projects Organizations that wish to prevent time entry toward projects with the Complete status should change this value to No. Allow Time Entry Against Dead Projects Organizations that wish to prevent time entry toward projects with the Dead status should change this value to No.
Lesson Notes
100
SCENARIO Individuals initiating Project Requests want a simple interface that does not include unnecessary tabs. According to the project management best practices you have adopted, project initiators will not be using the Goals component of the Business Case, but they will be need to access the Custom Data form. Update the Portfolio Management Preferences to reflect these requirements.
To enable/disable tabs displayed on the New Project Request and Business Case forms 1. 2. 3. 4. 5. Open the Portfolio Management Preferences. Locate the Default Business Case Sections field. Deselect the Goals checkbox. Select the Custom Data checkbox. Click Save.
101
SCENARIO Management decided it would be useful to have the system record notes when general changes and documents are attached to portfolios and programs. Update the Portfolio Preferences to reflect this requirement.
To enable automated system notes for Portfolios and Programs 1. 2. 3. 4. Open the Portfolio Management Preferences. Locate and Record Change Defaults section. Select the General Edit and Attachment Action checkboxes for both portfolios and programs. Click Save.
Lesson Notes
102
103
SCENARIO Generally, people approving work on a project are part of the project team. For example, a task may need to be approved by the project manger or sponsor. However, sometimes work items need to be reviewed and approved by individuals in different departments. When this is the case, the approving individuals should not have access to the project except to approve something; this can cause a security problem. After some discovery, you find out that people in the Marketing department will be approving work done on projects run by other groups. The Marketing staff needs to approve some tasks, but does not need to have access to all the tasks on non-departmental projects. Update the Approvers field on the Business Rules page to reflect this requirement.
To allow approvals by individuals not on the project team 1. 2. 3. Open the Business Rules page. Locate the Approvers field in the Approval Process section. Select the checkbox for the Approvers field.
4.
Click Save.
SCENARIO By default, AtTask does not allow individuals to change task or issue details once the project has been completed. In your organization, some of the tasks on certain projects may need to have custom data fields updated even after the project has been closed. Update the What users can do when the Project is Complete or Dead field to allow individuals to update tasks regardless of the project status.
To allow people to update task details on completed projects 1. 2. 3. 4. Open the Business Rules page. Locate the What users can do when the Project is Complete or Dead field in the Project section. Select the Add/Edit Tasks option. Click Save.
104
The remainder of the material in this lesson is provided for reference only. It describes the other fields available when defining Business Rules that are not necessary to meet the requirements outlined in the scenarios. You can also review further detailed material on these topics on the AtTask Help site help.attask.com.
When an email notification is sent after adding a note, link to This field is usually only used by customers accustomed to legacy versions of AtTask in which notes were viewed on the Recent Notes Tab. When a task or issue goes from 'New' to 'In Progress', set the actual start date to The default is always to set the actual start date of a work item to the time a person changes the status to In Progress. However, if the majority of your work items are completed without the assigned resources changing the status to In Progress, you may want to select the Planned Start Date option here because it may represent a more accurate commencement date.
Neither option inhibits the person updating the work from manually changing the actual start date if the automated value is not accurate.
When a task or issue is completed, set the actual completion date to The default is to set the actual completion date to the time a person marks a work item as complete. However, if the majority of your work items are marked Complete a significant period of time after they are actually completed, the planned completion date may represent a more accurate actual completion date. For example, if users tend to wait to the end of the week to update their completed work, the Planned Completion Date may be a more realistic representation of when the work was actually completed. What users can do when the Project is Complete This field controls whether or not people can remove work items from projects in the Complete status. When the options for this field are deselected, you cannot delete or move work items from Complete projects.
Neither option inhibits the person updating the work from manually changing the actual completion date if the automated value is not accurate. In fact, team members should be encouraged to set an accurate Actual Completion Date regardless of how this preference is set.
Lesson Notes
105
Chapter 5 Exercises
Exercise 1
In your actual account of AtTask, go to the Project Mangement Preferences page to enable the Recorded Changes on the Project, Task, and Issue levels.
Exercise 2
If your organization plans on using AtTask to do portfolio management, log in to your actual account of AtTask, go to the Portfolio Preferences page to enable the Recorded Changes on the Portfolio and Program levels.
Exercise 3
Schedule a meeting with the rest of your implementation team to discuss how to set the values on the Project Management Preferences, Portfolio Preferences, and Business Rules pages. Be sure to include a sample of project managers in this discussion, as they are key stakeholders for these preferences.
106
107
SCENARIO Your organization has decided to re-label some of the task status options and add two additional task options. The hope is to translate this part of AtTask into terminology your team members are already familiar with and to support your unique process for identifying tasks that wont be completed. Modify the task statuses to reflect the requirements shown below. Previous Statuses New In Progress Complete New Names Not Started Started Complete New Statuses On Hold Cancelled Equates With New In Progress Complete In Progress Complete
108
To rename and add new task statuses 1. 2. 3. 4. 5. 6. Navigate to the Custom Statuses page and click on the Task Statuses button. Click into the cell that reads New, and input Not Started. Click into the cell that reads In Progress, and input Started. Click into the cell that read Add a new status, and input On Hold. Select a color that will appear in chart reports that display statuses. In the Key column, input ONH and change the Equates With value to In Progress.
7. 8. 9.
Click into the cell that read Add a new status, and input Cancelled. Select a color that will appear in chart reports that display statuses. In the Key column, input CAN and change the Equates With value to Complete.
109
Requirements for Custom Statuses The Status Name field must be populated for each status option. A three-letter Key value must be input for each new status option. Each new status option must equate with the functionality of a predefined status option.
NOTE The color selected from the color palette for each status option will be used in all predefined and custom chart reports.
110
Primary Status In cases where there are multiple statuses associated with an Equates With option, in the Primary Status section you should select the primary option that will be used for the functionality. For example, at the task level when you set the Percent Complete field to 100%, AtTask will automatically change the status value to Complete. In the scenario above, you will now have two options that equate with the Complete functionality. You must select which of all the Complete status options will be used when statuses automatically change based on your percent complete inputs. Setting up project and issue statuses are done the same way for tasks; however, on the issue statuses you have the option to identify which Issue Type each status should apply to.
If you click on any issue type tab, you will be presented with a tool that allows you to sort the options.
NOTE All predefined functionality must be represented in at least one status option. Notice in the image above certain options cannot be deleted or hidden.
111
Additionally, on the issue types tabs, you have the ability to re-label the Issue Type Names to reflect terminology your organization is familiar with.
112
Exercise 2
If not done previously, create new Task-level status options for On Hold and Cancelled.
Lesson Notes
113
114
Issue
Issue Approval by the Issue Primary Contact on Issue Closed, Resolved, Wont Resolve, and Cannot Duplicate. Approval of Document Creation Tasks on Task Completion by the Project Manager.
Task
Task
Task Approval by the Assigned Resources Manager on Task Start, and By the Project Manager on Task Completion.
The two issue Approval Processes could be combined as unique steps on a single Approval Path so the QA representative reviews a completed issue and then the originator provides a final check.
115
SCENARIO Create a new Project Approval Process that satisfies the requirements of Process 1 in the Table of Approval Requirements. The Approval Process will allow the assigned resources manager an opportunity to approve the work when the status of the project changes.
To Define Process 1: Multi-Part, Multi-Step Project Approval Processes 1. 2. 3. Go to Setup Workflow Setup Approval Setup Project Approvals Setup. Click on the New Approval Process link in the contextual menu. Name and describe the Approval Process.
NOTE Be as descriptive as possible in naming the process so other resources can properly apply the Approval Process from the issue interface.
4. 5. 6. 7.
8. 9.
Click the New Approval Path button. Select the Current option from Target Status dropdown.
10. Select the User option from the Approval Type dropdown. 11. From the Approvers dropdown, select the Portfolio Owner option. 12. Click the Add Approver button or link.
116
13. From the second Approvers drop down, select the Project Sponsor option. 14. Set the radio button on the right to the All approvers option.
15. Click the New Approval Path button. 16. Select the Complete option from the Target Status dropdown. 17. Select the User option from the Approval Type dropdown. 18. From the Approvers dropdown, select the Project Owner option. 19. Click on the Add Approval Step button. 20. Select the User option from the Approval Type dropdown. 21. From the Approvers dropdown, select the Project Sponsor option.
117
NOTE In any of the cases above, you may select a specific user resource instead of the wildcard options. However, you only do this if it is always going to be the same person performing the approval on all projects using this Approval Process.
NOTE If a Project Owner, Project Sponsor, Portfolio Owner, etc. has not been assigned, or if a Portfolio and/or Program has not been assigned to the project, then the wildcards will indicate no user is available to approve the task, project, or issue. If this is the case, you will have unnecessary delays on your project, so either make the appropriate Project Owner, Project Sponsor, or Portfolio Owner assignment, or change the approval to utilize a specific, named resource.
118
SCENARIO The Cruzer Web Site project (and others) needs approvals as different statuses are achieved. Attach the approval process you created in the previous section to the Cruzer Web Site project.
To attach an Approval Process to a project 1. 2. 3. Navigate to the Cruzer Web Site. Click the Edit Project link in the left-hand menu. Navigate to the Approvals tab.
4. 5. 6.
Click on the Use An Existing Approval Process button. Select the Standard Project Approval process (or whatever you named your approval process). Click the Save button.
The Approval Process has now been attached to the project and will become active once the task status is changed to complete. Users who have access to assign Approval Processes also have the ability to create ad hoc Approval Processes to manage the one-off approval needs. This is done by navigating to the Approvals tab and clicking the Create a Single-Use Approval Process button. The remaining steps in this activity are identical to those used to create a global Approval Process.
119
NOTE Single-use processes will not appear in the global list of approval processes. The single-use process cannot be reused unless it is part of a template or template task definition.
If you select an existing approval process first and click Submit to save the preference, you can then select the Create a Single-Use Approval Process button to make deviations to the predefined process. If you with to change the process, you must make the modifications before any of the approval steps become active.
You can tell when an approval process has been attached to an object because the approval indicator becomes illuminated.
120
Additionally, users can review the entire Approval Process attached to a task by going to the Approvals tab through the More Tabs menu.
121
122
123
2.
3. 4.
You will be taken to the Update Project/Task/Issue Status tab; make your approval decision from the Approval drop down. Click Save.
NOTE If you reject an approval task, AtTask will create an issue on the task, revert it back to the previous status, or revert to another status identified in the Approval Path. If an issue is created, the issue will be assigned to the default resource assigned to the task. The task status will change to Complete Pending Issues. Once the issue is resolved, the task will appear in the approvers My Approvals report again.
124
Exercise 2
Search for the New Product Development template and apply the approval process to the template.
Exercise 3
Identify the approvals you know you are going to need at this point. Project Status
Requested Planning Current Complete On Hold Dead
Approvers
Task Status
In Progress Complete
Approvers
Issue Status
In Progress Reopened On Hold Closed Resolved
Approvers
125
Lesson Notes
126
127
SCENARIO You have several customers your organization completes project for and you want to associate an external customer with each project. Create Companies for each of the following customers: Acme Co. Widgets of New York XYZ, Inc.
You already learned how to create companies, so this should be easy for you. To create the Acme Co. company profile 1. Go to the Create menu and select the Company option.
2. 3.
128
SCENARIO Two of your customers have special contract rates. When you add the following companies to the system, use the Company Billing Rates tab to override the default role rates. Company Widgets of New York Role Rates Associate Consultant Consultant Solutions Architect Technical Consultant XYZ, Inc. Associate Consultant Consultant Solutions Architect Technical Consultant $40 $80 $72 $100 $45 $90 $81 $113
Add a company profile for Widgets of New York with the unique billing rates.
To create the Widgets of New York company profile 1. Go to the Create menu and select the Company option.
2. 3.
Input the name of the company (Widgets of New York). Navigate to the Company Billing Rates tab.
129
4.
Expand the Job Role drop down. Only recently accessed roles will appear in this field. Use the search icon if you do not see the roles you are looking for.
5. 6. 7. 8.
Select the Associate Consultant role. Input the contracted rate in the Override field for this role. Repeat steps 4 to 6 for each role that requires a contracted rate. Click Save.
When you apply this company to projects, these rates will apply to all tasks set to calculate revenue using rolebased revenue.
NOTE Company-level override rates only apply at the project level. They do not override the rates for users associated with a company.
130
Exercise 2
Customer Contract Rates Apply
List the customers you will be completing projects for. Identify whether they have contract rates you will need to apply. Customer Contract Rates Apply
Where contract rates need to be applied, create an action item to your calendar to compile those rates.
Lesson Notes
131
To satisfy the requirement in this scenario, no action is needed. Default access levels only allow visibility across department (group) lines when people are specifically added to the project team.
SCENARIO The Marketing department is not as concerned with the privacy of their projects. In fact, they prefer people knowing what is happening and when things will go live.
The purpose of this lesson is not to show you how to reconfigure access levels to support varying security requirements. Rather, the point is for you to understand the security implications of group associations. As different departments have conflicting security requirements your job will be to balance each requirement and provide a solution. Consider the following options: Change access levels to allow visibility into all groups you belong to and add the Marketing group as one of the Other Groups for each user. Keep group security tight and create a report to increase visibility into Marketings projects.
132
Lesson Notes
133
There is a preference on the Project Management Preferences page to change this behavior. When this preference is changed, AtTask will use the schedules associated with the tasks default assignee instead of the project schedule when multiple users (with differing schedules) are assigned to the same task.
134
Lesson Notes
135
What is a Portfolio?
A portfolio is a collection of projects competing for the same resources, budget, and schedule slot. The projects in a portfolio are similar enough that they would use the same Resource Pool and be measured against the same scorecard. This often means there is a one-to-one relationship between Portfolios and Resource Pools. General Examples: By product line, by division, by department, by company, or other business units often group into Portfolios.
What is a Program?
A program is essentially a subdivision of projects in a Portfolio. Programs allow Portfolio Managers to delegate certain responsibilities (i.e., Business Case completion, or Business Case approvals) to Program Managers. General Examples: Programs are based on projects grouped by a common goal, such as increasing customer base, product improvement, client retention, decreasing costs, etc.
NOTE Projects in Programs are not prioritized solely against each other; instead, the projects are optimized against all projects in the Portfolio. It is sometimes necessary to create the Resource Pool relationship with Programs instead of doing it at the Portfolio level.
136
SCENARIO Your company plans on creating Portfolios along business unit lines. Within each Portfolio, Programs will be created to identify strategic goals that apply across Portfolio divisions. This will allow individuals filling a Program Manager role to keep a pulse on the projects that deal with the strategies they focus on. Create the Marketing portfolio and programs according to the diagram below.
NOTE Across the top of the diagram the dark blue boxes (IT, Finance, Sales and Marketing) represent Portfolios. Beneath the portfolios are the light blue boxes representing various programs. Some of these programs are managed across multiple portfolios, depending on the goals and purposes of the projects within those portfolios and programs. Notice Client Retention is a program applicable to the Finance, Sales and Marketing portfolios, while Systems Stability is solely associated with the IT portfolio. This is just one example of how programs and portfolios can be utilized.
137
Portfolio Creation
To create the Marketing Portfolio 1. 2. Go to the Create menu and click the Portfolio option. Give the Portfolio a name and a description. NOTE Enabling these options will only record changes to the portfolio definition. It will not record changes to the project in the portfolio notes.
3.
Select a Portfolio Manager from the Portfolio Manager drop-down field. The names in this drop-down field will populate with the five most recent users viewed in AtTask. If you do not see a desired user, click the search icon to locate and add a user to the field.
4.
The scorecard drop-down allows you to select which scorecard to use in this portfolio to evaluate your projects. Make sure Is Active is checked. If the portfolio is not active, it will not be available in the Portfolio field on the New Project form. If you wish to turn on the audit trail for the portfolio, check the type of changes you want AtTask to record as system notes for the portfolio.
5.
6.
138
Program Creation
To add Programs to the Marketing portfolio 1. 2. 3. 4. 5. 6. Click the portfolio you want to add the program to (Marketing). Click the New Program area button. Give the program a name (Client Retention). Select a program manager from the Program Manager drop-down menu. Click Save. Repeat steps 2 to 5 for each program.
NOTE When creating a program that crosses portfolio lines, you must add the program to each portfolio.
139
Exercise 2
Identify the portfolios and programs you need to add to your account of AtTask. Portfolios
Programs
Lesson Notes
140
Chapter 8 Customization
Everything up to this point is considered essential for any implementation of AtTask. This chapter starts to introduce optional configuration topics. While the topics in this chapter are optional, every implementation team should consider how best to use these features the same way you have researched and considered how to implement essential AtTask features. In this chapter you will learn how to: Create and Apply Custom Data Create Dashboards and External Pages Distribute Reports and Reporting Elements Customize Portal Profiles Customize Access Levels There are a myriad of ways to configure and customize objects to support your unique needs. Implementing these features optimally can do a greate deal to reduce the training burden, simplify the interface and navigation, and provide a level of detail on work items AtTask cannot anticipate for all its customers at once.
141
142
Because parameters and parameter groups will be added to a category or form, it is generally recommended you create these elements in the following order: 1) Parameters, 2) Parameter Groups, and 3) Categories.
NOTE Parameters you create as an administrator are usually dictated to you by the reporting needs defined by Project Managers and Executives.
143
SCENARIO Project managers need three custom fields on the project level to help them track and manage their projects. Field Name Capital Budget Non-Capital Budget Is Capital Expense? Market Display Type Text Field Text Field Radio Button Checkbox Data Type Currency Currency Text Text No (default) Yes Asia Pacific EMEA North America (default) South America Options
To create the Capital Budget field 1. 2. 3. 4. 5. Navigate to the Parameters area and click New Parameter on the left-hand menu. Input the name into the Parameter field (Capital Budget). Keep the Display Type value as Text Field. Change the Data Type to Currency. Click Save.
PRACTICE EXERCISE Follow the steps above generally to create the Non-Capital Budget field.
144
To create the Is Capital Expense? radio buttons 1. 2. 3. 4. Navigate to the Parameters area and click New Parameter on the left-hand menu. Input the name into the Parameter field (Is Capital Expense?). Change the Display Type to Radio Buttons. Keep the Data Type value as Text.
5.
Navigate to the Parameter Options tab. This is where you define the picklist options for the field. Input No into the Label and Value fields. Input Yes into the Label and Value fields. Mark the Default checkbox for the No option. Click Save.
When the Display Type is set to Radio Buttons, Checkboxes, Drop Down, or Multi-Select Drop Down, the Parameter Options tab becomes active.
6. 7. 8. 9.
PRACTICE EXERCISE Follow the steps above generally to create the Market checkboxes.
145
146
NOTE If the Text Field, Text Area, or Calculated display type is set, you will receive the following message indicating that no further setup for the field is necessary.
147
SCENARIO When you add these fields to the category, you want to separate the finance-related fields from the Market checkboxes. Create two parameter groups called Project Financials and Project Information.
To create a new parameter group 1. 2. 3. 4. Navigate to Setup Custom Data Parameter Groups. Click the New Parameter Group link on the left-hand navigation. Name the Parameter Group. Click Save.
Parameter Group This value will be the name of the Parameter Group and will also be the value displayed as the header of a section of fields within a category. Description The description field provides additional information about the Parameter Group and is used to identify the parameter group at a later time. Is Default Each category must have at least one parameter group. If no parameter group is selected before a parameter is added to the category, the default parameter group will be used as the header for that section of the category.
148
Configuring Categories
A Category is the collection of parameters and parameter groups that need to be added to a specific object type. To create a category, go to Setup Custom Data Categories and click on the New Category option. To create the project-level custom data form 1. 2. 3. 4. 5. 6. 7. Navigate to the Categories area and click New Category on the left-hand menu. Input a name into the Category field. Change the Category Type to Project. Identify the Groups that should have access to use this form. Click Continue. On the Parameters tab, scroll through the Available Parameter Groups to locate and select the Project Financials parameter group. Scroll through the Available Parameters list to locate and select: Is Capital Expense? Capital Budget Non-Capital Budget 8. 9. Locate and select the Project Information parameter group. Locate and select the Market field.
149
Category This is the name of the category displayed on the Custom Data tab in the Category dropdown. Description This field provides additional information about the category. Category Type The Category Type identifies the object where the category or form may be attached.
Group Some organizations require restricting access to categories through group membership.
150
Category Parameters
On the Parameters tab of the New or Edit Category form, you will note three major sections. Available Parameter Groups This lists all the available parameter groups already been defined in the system. Available Parameters Identifies the available parameters not already in use on the category. Selected Parameter Groups and Parameters Shows the selected parameters and groups for the current category.
151
Attaching Categories
To assign a category to a project 1. 2. 3. 4. 5. Go to a project where the additional fields are necessary. Click the Edit Project link in the left-hand navigation. Navigate to the Custom Data tab. Select the custom form from the Category drop down. Populate the values for the custom fields on the form and click the Submit button.
NOTE While it is possible to have several categories for an object type, an object can only have a single category attached at a single time. Toggling between categories at the project level will result in data loss; only parameters present on both categories will be retained.
152
Custom Data can also be updated by selecting the Edit Custom Data button found on the Updates Tab.
153
When you edit Custom Data, you will be presented with screen options allowing you to update the information included on the Custom Data tab. This option allows a user to update custom values without the ability to make changes to the scheduling portions of the project, task or issue. In the Reporting and Interface Setup chapter you will learn how to customize project, task, and issue tabs. Keep this tab in mind as something you may want to distribute as a fixed tab to users who would benefit from this interface.
154
155
Exercise 2
Associate the category created in Exercise 1 with the Widgets of New York company.
Exercise 3
Review the native fields provided for each object and then identify the categories and parameters you know you will need to add to your account of AtTask for each object type. Project Category: Task Category: Issue Category:
Company Category:
User Category:
Expense Category:
Only a few of the objects that custom data can be applied to are listed here. You may want to make similar lists for each object and schedule a meeting with the implementation team and project stakeholders to gather a comprehensive list of custom data requirements.
156
Lesson Notes
157
Dashboards Review
Dashboards provide a way for individuals to customize their workspace tabs. Dashboards are a collection of reports presented on a single tab at the Home, Project, Task, and Issue landing pages. Dashboards are called Custom Tabs when used in the following areas: Project Task Issue Portfolio Program
SCENARIO A project manager needs to supplement the default reports provided on the AtTask Home page with the following reports. The project manager wants to see the reports in a multi-column layout and has drawn the dashboard on a white-board to keep things straight while creating the dashboard. My Dashboard My Projects Trouble Tasks Projects By Progress Status Tasks By Progress Status
158
Creating Dashboards
To create a new dashboard, do any of the following options 1. 2. Go to My Profile My Dashboards and click on the New Dashboard link. Go to the Create menu and select Dashboard.
3.
Expand the More (Tabs) menu on the AtTask Home page and select the New Dashboard option.
159
NOTE Dashboards allow up to 12 reports per dashboard, and you can create as many tabs as you want.
After defining the Dashboard, click Save. You will be taken back to the AtTask Home page to review the dashboard contents.
160
NOTE This is an individual option. A system administrator cannot place dashboards on other resources AtTask Home pages.
To do this from the Home page 1. Click the Dashboard Setup icon ( ).
NOTE Only dashboards created by me and those that are available to other users will appear in the list of available dashboards.
2.
Select the Add Dashboard icon ( ) to the left of the name of the dashboard(s) you would like to appear as a fixed tab when the Home page loads. NOTE You can add up to 6 dashboard tabs as fixed AtTask Home tabs. Other dashboards not displayed are accessible through the More (Tabs) menu and the My Dashboards page.
161
On the AtTask Home page you will see your tab(s) appear without having to toggle through the More Dashboards tab ( ). Once the dashboard tab is added to the Home page, you can pin the tab using the Make this tab the default icon ( ) in the upper right of the workspace.
NOTE Each user has the option to set a Custom Tab as a permanent fixture on their project, task, etc. landing page by clicking the Tab Setup icon ( ).
162
SCENARIO During your AtTask implementation you have come to rely on the Help Articles and videos found on the help.attask.com site. While it is convenient enough to click the Help link, you decided it would be more convenient to embed it on a dashboard on your AtTask Home page.
To create the external page displaying the AtTask Help site 1. 2. 3. 4. 5. Go to the Create menu and select the External Page option. Input a name (AtTask Help) and description. Select a location where the External Page will be accessible (Home). Input https://help.attask.com into the URL field. Click the Save button.
NOTE No information is actually passed between the two systems unless the page you are embedding uses the AtTask API to make updates to your account.
163
SCENARIO Your project managers have requested a report you cannot create through the AtTask reporting framework. They want to see a list of Personal Time Off and how it impacts their projects. You have contracted a developer to use the API to create the report and want to display it within AtTask, so the project managers dont have to go to two locations to view project-related reports. Create an external page that pulls information from: http://agssolutions.attask.com/education/sample/ptoimpact.php
To create the external page displaying the external PTO Impact report 1. 2. 3. Go to the Create menu and select the External Page option. Input a name (PTO Impact) and description. Select a location where the External Page will be accessible (Home). Input http://agssolutions.attask.com/education/sample/ptoimpact.php into the URL field. Click the Calculator icon to access the advanced URL settings. There are a couple of variables that AtTask has to pass through to the external page for this simple integration to work. These are: AtTaskSession this allows the external page to log into AtTask and access data from your account. serverURL this tells the external page where to login to for AtTask data. 1. 2. Following the URL, type: ?AtTaskSession= Expand the Other dropdown and select Other. This will present a number of variables that are useful when embedding integrated pages into AtTask. Double-click the Session ID option. This will place {!$$SESSION} wherever your cursor is located in the URL field. If it does not get placed at the end of the URL, move it into the correct position. Following the session information, type: &serverURL=https://testdrive.attask-ondemand.com Be sure to substitute the # sign for the testdrive number you are currently using.
4. 5. 6.
3.
4. 7. 8. 9.
Click Submit to store the updated URL. Click Save to create the external page. Add the external page to a new dashboard.
164
165
Lesson Notes
166
Definitions
Report Reporting Element View Filter Grouping A report is the combination of a view and filter (and sometimes a grouping) that is saved for future use and can be distributed to other individuals. Reporting elements are the building blocks of reports. They include: View, Filters, and Groupings. A view usually refers to the columns that appear across the top of a list of records. It can also refer to the chart displayed for a report. The filter controls the results included in a report. Groupings are the horizontal dividers used to organize results based on common criteria. Groupings are also used to determine the axes of Matrix reports and the axes of aggregate chart reports.
Once you create a report or reporting element report creation is discussed fully in the AtTask Reporting Essentials course the next step is to distribute them to others that may benefit from them. This lesson provides options for distributing these elements to other resources.
Global Reports
While each person has the ability to search for and review the contents of any report keep in mind, their access rights will control which results will appear on the report it is the best practice to distribute high traffic reports to the general public. This is done by adding the report to the Global Reports area. After a report is added to the Global Reports list, the report will appear on the Global Reports tab when anybody reviews the Global Reports tab in the My Reports area of the tool. Only system administrators can access the Global Reports tool by going to Setup Interface Setup Global Reports.
SCENARIO Add the Project Milestones report created by the Admin User to the Global List so all resources have access to the report.
167
To add a report to the global list 1. 2. 3. Navigate to the Manage Global Reports page. Click the action icon.
4. 5.
Select the checkboxes to the left of each report you want to add to the global list. Click the action icon.
The report is now added to the Global List, which means anybody can access it through the Reports area of AtTask. It is also available in the list of reports that can be added to a Dashboard. If you know that people in your organization will not use a report shipped with AtTask, you can remove it from the Global List. This will limit the number of reports people have to choose from as they create Dashboards and thereby reduce confusion by not displaying irrelevant reports in the My Reports area. Adding and removing reports from the Global List is especially recommended when you, as a part of your configuation, create a number of custom reports that are similar to shipped reports.
NOTE You do not have to remove all financial reports or other reports that may contain sensitive information from the global list. Each report may return different results for each user depending on their access privileges and group affiliations. By default, access levels with lower ranks (Individual Contributors and lower) do not have access to financial data. When a financial report is run, the columns containing monetary figures are empty.
168
Linked Users
Sometimes a report does not need to be added to the global list, but it should be shared with specific users. This is done by using the Linked Users option for each report. After linking a report to a user, the report will appear for that resource on the My Reports tab when they go to the My Reports area. When viewing the report, any resource with edit access to the report can link other users to a report. To link other resources 1. Click the Linked Users link on the left-hand navigation. The individual who created the report will appear in the list of linked users, along with others that have already been subscribed to the report.
2. 3.
Click the
action icon
Use the search fields to bring up a list of users that need access to the report, and click Search.
4.
Select the checkboxes to the left of each resources name that you wish to add and click the Add Users action icon.
Alternatively, a user can link themselves to several reports at once simply by doing a search for reports and clicking the action icon from the icon toolbar.
This will add the selected report(s) to the My Reports list for the logged in user. 169
List Controls
The List Controls determine which filters, views, and groupings are displayed in the corresponding dropdowns at the top of each report. The List Controls area gives you, as the System Administrator, the option to share reporting elements you may have created with all other resources in the system. There are two levels of list controls. You use the Global List Controls to determine which reporting elements should be common to all users. Then you use the Portal Profile List Controls to distribute specific report elements to subsets of users.
SCENARIO After some discovery and interviews with stakeholders throughout the organization, you have found that people in different departments and roles have very different reporting requirements. Team members think there are too many options in the view and filter dropdowns for task reports. Their managers want additional views and filters in their list menus. The following table shows the results of your findings for the Task object and only two of your many implementation roles. For your convenience, the common reporting elements for the two roles are in bold text. Team Members Filters Active Tasks Incomplete Tasks My Current Tasks My Tasks Unassigned Tasks in My Role Upcoming Tasks Project Managers Filters Active Tasks All Unassigned Tasks Approval Tasks Incomplete Tasks Milestone Tasks My Current Tasks My Tasks Upcoming Tasks
Views All Dates Condition Cost Breakdown Detail Information Project Outline Revenue Standard Status Task Summary * Work Breakdown
Groupings Assigned To Condition Job Role Progress Status Project Start Date By Week Status Team
Modify the Global List Controls to distribute the common reporting elements. The unique elements will be distributed through the Portal Profile list controls. * This is a custom view created by the Admin User that will not appear in the default list of distributed views. 170
Only the Global List Controls will be discussed at this time. Portal Profile list controls will be discussed fully in the following lesson. A System Administrator can access and modify the Global List Controls by going to Setup Interface Setup List Controls. To set the common task-level reporting elements 1. 2. Go to the List Controls screen. Select the Task option from the object type drop-down.
3. 4.
Click the Delete icon for each reporting element not common across all roles. Click the option to search for the Task Summary view.
5.
You will be presented with a Search Views screen. Input Task Summary to limit the number of views returned and then click Search.
6. 7.
).
8. 9.
Repeat steps 4 to 6 for other views, filters, and groupings you want to distribute. Click the Save button on the List Controls screen the filters, views, and groupings you selected will be distributed to all other users in the system.
171
Exercise 2
Set aside time on your calendar to review the existing reports. Identify those reports you want to remove from the global list. Also make note of the reports you want to modify. Add these notes to other reporting requirements you are gathering.
Exercise 3
Set aside time on your calendar to review the existing reporting elements to become familiar with each view, filter, and grouping for the primary objects in AtTask projects, tasks, and issues. Also, meet with representatives for each role to discuss whether or not the default reporting elements would provide value in completing their day-to-day work.
Lesson Notes
172
NOTE Administrators cannot modify built-in profiles, but they can copy these profiles and make adjustments to the copies.
173
To make a copy of the Full User License portal profile 1. 2. Navigate to the Portal Profiles page. Click into the Full User License profile.
3.
4. 5.
174
To edit a custom Portal Profile 1. Click the Edit Portal Profile link in the lefthand navigation.
2.
Across the top of the workspace, you will note there is a tab for each area where the tab structure may be modified; click on the Home tab.
3.
In the upper right of the workspace, notice a rectangle representing each of the tabs available on the Home page; click on the Add Tab icon ( ).
4.
Scroll through the list of Reports and click the Add Report icon to the left of the report you want on this tab. Following the scenario, choose My Issues, My Unassigned Issues, and My Submitted Issues.
NOTE Only reports that are global, linked to me, or entered by me will appear in this list.
NOTE If you do not name the tab before adding a report to it, AtTask will set the name of the tab to the name of the first report added. 175
5.
Navigate to the My Tasks tab, remove the My Issues report from this tab using the Remove Report icon ( ), and then add the My Late Tasks report or another tab to fill the third available slot.
6.
Using the drag option for the My Late Tasks row, move the report into the second position.
7.
When the reports you need to distribute are in place, click the Save button.
TIP It is a good idea to test new Portal Profiles before distributing them to actual resources. To do this, assign the Portal Profile to your own user account and verify it meets the requirements for the profile.
SCENARIO Team Members need the following unique reporting elements added to the Portal Profile List Controls for the profile that will be assigned to their user profiles. Team Members Filters Unassigned Tasks in My Role Views Gantt Groupings (none)
176
When viewing the Details tab of a custom portal profile, click the Portal Profile List Controls link on the lefthand navigation.
Once here, follow the same steps identified in the List Controls lesson.
177
Exercise 2
Update the Portal Profile List Controls for this new profile to include the unique reporting elements needed for project manager profiles. Project Managers Filters All Unassigned Tasks Approval Tasks Milestone Tasks
Views All Dates Condition Cost Breakdown Revenue Status Work Breakdown
Exercise 3
Schedule time to review the existing Portal Profiles with your implementation team and map out which reports you want to distribute through Portal Profiles, Global Reports, and Linked Reports.
Lesson Notes
178
179
System Administrators navigate to the Access Levels area by going to Setup Organizational Setup Access Levels.
Access Levels can be created from scratch by clicking on the New Access Level link, or by using the Create menu. However, it is always recommended you create a copy of an existing access level and make changes as necessary. To make a copy of an access level, decide which of the existing access levels most closely meets the permissions for the resources that will be assigned to the access level.
SCENARIO The implementation team has determined that the default Project Manager access level is too strong. It gives the project managers the ability to add tasks and modify task details on any project where they are member of the project team. You need to create a Project Owner access level that only allows a project manager to add and edit tasks on projects where he/she is the project owner.
180
To create a copy of the Project Manager access level 1. 2. Navigate to the Access Levels area. Click the Project Manager access level.
3.
Make a copy of the Project Manager access level; rename it Project Owner. Click Save.
4.
181
Access Levels are defined on two tabs. The Access Level Details tab contains general access permissions that can be granted or restricted. The Access Scopes tab identifies individual Add, Delete, Edit, and View rights for each object.
Definitions
Access Area Access Areas allow administrators to review the permissions for an Access Level on an object-by-object basis. Help Article Link: https://help.attask.com/#url=/index.php/node/load/107 Access Action Combined with the Access Scope, Access Actions determines the activities a person can perform. The actions common to most Access Areas are: Add Delete Edit View Some Access Areas provide addition activities, such as: Change Status Custom Data Request Update Help Article Link: https://help.attask.com/#url=/index.php/node/load/106 Access Scopes Combined with Access Actions, Access Scopes determine the criteria for permissions assigned. Help Article Link: https://help.attask.com/#url=/index.php/node/load/119 182
SCENARIO (REMINDER) The implementation team has determined that the default Project Manager access level is too strong. It gives the project managers the ability to add tasks to and modify task details on any project where they are member of the project team. You need to create a Project Owner access level that only allows a project manager to add and edit tasks on projects where he/she is the project owner.
To edit the Project Owner access level 1. Edit the Project Owner access level.
2. 3.
4. 5.
Change the Add, Edit, and Delete actions to the Owned By Me Project Tasks access scope. Change the Change Status and Custom Data actions to Project, Assigned To Me, or Entered By Me Tasks. Click Save.
6.
NOTE According to the scenario, the View action can remain on the Home Group, Project, or Entered By Me Tasks scope. This access scope allows users to view any project in their Home Group, any project they are assigned to as a project team member, and any project they created.
183
NOTE Group associations and project team membership impact what users can see and do more than any other user profile conditions. Individuals using the same access level may see different results or totals on reports because of the groups and/or projects they belong to.
PRACTICE EXERCISE After creating the Project Owner access level, you decide you also want to restrict which projects the users with this access level are allowed to edit. Go to the Project access area and reduce the access to edit only those projects where they are set as the project owner.
Steps 1. 2. 3. 4. Through the Recent menu, select the Project Owner access level. Click the Edit Access Level link on the left-hand menu. Go to the Access Scopes tab and select the Project access area. Make the necessary change and click Save.
184
Lesson Notes
185
186
187
SCENARIO Users in the Marketing department need a timesheet profile to generate timesheets on a weekly basis. These timesheets should be approved by Jennifer Campbell. Users in the IT department need a timesheet profile to generate monthly timesheets. As a cost center, ITs work does not need to have the same degree of oversight, so no approver is necessary.
To create the Marketing Timesheet Profile 1. 2. Navigate to the Recurring Timesheet Setup page. Click the Add action icon from the toolbar.
3. 4. 5.
Provide a name for the profile (Marketing Timesheet Profile). Select the Weekly option from the Pay Period Type field. Select the date you want the system to begin generating timesheets. (Select last Saturdays date). Search for and select Jennifer Campbell in the Approver field. Click Save.
6. 7.
Adding the Recurring Timsheet Profile to user profiles can be done either through individual edits or through a bulk edit.
188
Name Enter the name of the profile in the Name field. This is a required field. Description Enter a description to describe to other administrators the purpose of this recurring timesheet profile. Pay Period Type Choose a pay period type from the Pay Period Type menu. The default is Monthly. However, you can also choose Weekly, Bi-weekly, and Semi-monthly.
Pay Period Starts On The Period Starts On will change depending on the pay period type.
Semi-monthly
Monthly
189
Effective Start Date Enter an Effective Start Date in the field, or click the calendar icon ( Approver Choose an approver from the Approver dropdown. An approver has the authority to approve or reject a timesheet after it is submitted. Click the search icon ( ) to find an approver that does not appear on the list. Select General Hours From the Select General Hours menu, you can select one or more general hour types you want to appear on the timesheet. Use the Control (Windows) or Command (Mac), and Shift keys to select multiple hour types.
) to choose a date.
NOTE Generally approvers are not project managers. They are typically a users function manager or an HR/Payroll representative.
NOTE Selecting no hour types is the same as selecting all general hour types.
190
Lesson Notes
191
NOTE These preferences are global in scope, meaning they apply to all resources, projects, and timesheets.
SCENARIO People accessing timesheets need the ability to: Record time at the project level Change the status of task and issue work items Record expenses toward work items Some of these options are set by default for AtTask accounts. Review the options in Hour Type Preferences and Timesheet Layout sections of the Timesheet and Hour Preferences page. Where it the option is not set according to the requirements listed above, update the setting.
192
To update these Timesheet and Hour Preferences 1. 2. Navigate to the Timesheet and Hour Preferences page. In the Hour Type Preferences section, locate the Enable Project Entry field. Make an update if necessary.
3.
In the Timesheet Layout section, locate the Display Completion Fields setting. Make an update if necessary. Locate the Display Expense Links field. Make an update if necessary. Click Save.
4. 5.
SCENARIO When a person opens a timesheet, all the work items he/she has recorded hours towards automatically appear. In the Timesheet Auto-Population Prefernces section, you can control which other work items will also appear on the timesheet when it is opened. Timesheets should be populated with task that meet the following criteria: Tasks that are actually active during the period of the timesheet (+/- 1 week) Tasks that are planned to be active during the period of the timesheet (+/- 1 week) Tasks that are projected to be active during the period of the timesheet (+/- 1 week) Additionally, the total number of auto-populated items should be set to the highest value: 45.
NOTE Auto-populated items are always limited to work items assigned directly to the individual the timesheet belongs to.
193
To update these Timesheet and Hour Preferences 1. 2. Navigate to the Timesheet and Hour Preferences page. In the Timesheet Auto-Population Preferences section, locate the Maximum Additional Items field. Change this value to 45. Locate the Extended Date Range field and make sure it is set to 1 Week. Locate the Include Tasks with Actual Dates in Range field. Change the value if it is not already set to Yes. Locate the Include Tasks with Planned Dates in Range field. Change the value if it is not already set to Yes. Locate the Include Tasks with Projected Dates in Range field. Change the value if it is not already set to Yes. Click Save.
3. 4.
5.
6.
7.
194
Enable Project Specific Hour Types Changing this value to Yes will allow a system administrator (and any others with appropriate access) to create new hour types to be used at the project, task, and issue levels. Enable Project Hour Entry Changing this value to No will hide project-level time entry both in the timesheet and on each project. As long as this value is set to Yes, any resource with the ability to record time will be able to record project-level effort. Enabled:
Disabled:
195
Timesheet Layout
This section provides a system administrator the ability to show or hide specific attributes of all timesheets.
General Hours Placement Organizations that will be recording General Hours (General Overhead, Vacation, Sick, or others you might create) more frequently than time on tasks and projects, may elect to show the General Hours section of the timesheet at the top of the page. Display Project Specific Hour Types Organizations that require hour entries to be tied to a specific hour type (or label) may want to display these on the timesheet to streamline time entry for team members. However, implementations where these labels are not necessary will likely want to leave this off the timesheet to reduce confusion and provide a cleaner interface. Display Completion Fields Organizations that do not wish their project contributors to provide status updates through the timesheet may want to remove the completion fields to clean up the timesheet interface. Display Expense Links If your end users will be recording non-labor expenses on tasks they are assigned to, you may want to enable this field. Doing so will allow your resources to complete expense updates to tasks they are assigned to from within the timesheet.
196
Maximum Additional Items Resources accessing a timesheet have the option to add projects, tasks, and issues that may not appear on their timesheet (as defined by the parameters below). The value in this dropdown field represents the total number of added and pinned items allowed on the timesheet for each resource. Extended Date Range Normally, the timesheet will only display tasks and issues that are planned during the timeframe of the timesheet. However, through this drop down you can extend the time frame to include tasks and issues planned to be active up to four weeks in either direction from the timesheet date range.
197
Include Tasks with Actual Dates in Range When set to Yes the timesheet will include tasks that have either an Actual Start Date or Completion Date that falls within the timeframe of the project, even if the planned date of the task falls outside of the timesheet date range. Include Issues with Actual Dates in Range When set to Yes the timesheet will include issues that have either an Actual Start Date or Completion Date that falls within the timeframe of the project, even if the planned date of the issue falls outside of the timesheet date range. Include Tasks with Planned Dates in Range When set to Yes the timesheet will include tasks that have either a Planned Start Date or Completion Date that falls within the timeframe of the project. Include Issues with Planned Dates in Range When set to Yes the timesheet will include issues that have either a Planned Start Date or Completion Date that falls within the timeframe of the project. Include Tasks with Projected Dates in Range When set to Yes the timesheet will include issues that have either a Projected Start Date or Completion Date that falls within the timeframe of the project, even if the planned date of the issue falls outside of the timesheet date range. Include Completed Tasks If multiple resources are typically assigned to a single task, it is recommended this value be set to Yes. This means when one resource records time against the task and marks it as complete, the other resources assigned to the task will still be able to view it through the timesheet when they decide to record hours. Include Completed Issues If it is common to reopen or record time toward completed issues, set this value to Yes.
198
Lesson Notes
199
SCENARIO Your team of business analysts want more information about the hour-based reports generated from AtTask. Specifically, they want to know how people are spending their time. They have requested the following project-level hour types be added to the system so they can look for trends of what people are doing to complete tasks: Meeting Time Research Time Travel Time They want to use the default Task Time hour type shipped with AtTask to collect work that cannot be tied to Meetings, Research, or Travel time.
Before you can create project specific hour types, they have to be enabled first. To enable project specific hour types 1. 2. 3. 4. Navigate to the Timesheet and Hour Preferences page. Locate the Enable Project Specific Hour Types field and change the value to Yes. Locate the Display Project Specific Hour Types field. Change its value to Yes. Click Save.
These two preferences will 1) make it so that cutom project specific hour types can be created, and 2) display the project specific hour type in the timesheet interface. Regardless of the Display Project Specific Hour Types setting, a field to select project specific hour types will always appear on the Update Task Status and Completion Status Worksheet (if the feature has been enabled).
200
Custom hour types (both project-specific and general) are created and managed by going to Resource Management Timesheet and Hour Management Hour Types. To create the Meeting Time hour type 1. 2. Navigate to the Hour Types page. Click the Add action icon from the toolbar.
3. 4. 5. 6.
Input the Hour Type name (Meeting Time). Change the Scope value to Project Specific. Change the Count As Revenue to No. Click Save.
PRACTICE EXERCISE Follow the steps above generally to create the Research Time and Travel Time hour types. Set Research Time to be count as revenue and Travel Time to not count as revenue.
201
Explanation of Fields
Hour Type Enter the name of the hour type in the Hour Type field (this is required). The value entered here is the value displayed as the hour type label on the hour entry screens and hour reports. Description Enter a description, as needed. Scope The Scope field controls whether the hour type you are creating will be used in the General Hours section of the timesheet, or if the hour type is project specific. This means label will be available at the project, task, and issue hour-entry screens. Count As Revenue The Count As Revenue radio button allows you to indicate if the revenue preferences defined on a task should be ignored when the hour type is coupled with the hour entry. Is Active Checking the Is Active checkbox will make the hour type active. This provides the same result as clicking the Enable light bulb icon from a list of hour types.
202
203
NOTE The option to display the Hour Type column in the timesheet must be enabled in the Timesheet and Hour Preferences.
204
Lesson Notes
205
The following image displays the Manage Expenses tool on the same project.
One of the fields on the New Expense form is the Expense Type. 206
The Expense Type is a label that is used in reporting. It will allow managers to look for patterns and consistently see how money is being spent from project to project, or across projects. AtTask ships with six (6) expense types built in, which cannot be modified or deleted.
You also have the ability to create additional expenxe types to support your financial reporting needs. Custom expense types can be managed and created by going to Project Management Expense Type.
SCENARIO You have a number of individuals that need to travel to complete project-related activities. In order to capture the full cost of the project, you have asked them to record expenses to capture costs of mileage reimbursement.
To create the Mileage expense type 1. 2. Navigate to the Expense Types page. Click the Add action icon from the toolbar.
3. 4. 5. 6.
Input the name for the expense type. Select the Miles option from the Calculated Units field. Input the rate per mile. Click Save.
207
Expense Type Provide a name for the Expense Type. Normally, expense labels are defined by the implementation team or by your Finance department. Calculated: Units and Rate When set to the Miles, Kilometers, or Other the expense form will prompt you for a numeric unit that will be multiplied by the rate specified.
208
Lesson Notes
209
210
211
212
To record an issue to a service queue 1. From the Home page, click into the Help Desk area.
2. 3. 4.
Click on the name of the queue where the issue is to be added. Name the issue and input the values you need. Click the Save button to upload the document and submit the issue.
213
Lesson Notes
214
SCENARIO Your users need a place to submit issues, requests, and questions about AtTask. Create a queue called AtTask Help where end users in your environment can submit support and change requests for AtTask.
To create the AtTask Help request queue 1. 2. 3. Go to the Create dropdown menu and select the Project option. Provide a name for the project (AtTask Help) and brief description. Navigate to the Queue Properties tab.
4. 5.
In the Is Public section, change the radio button to Public. Navigate to the Queue Properties tab.
215
6.
In the Queue Properties section, identify the types of issues you will allow on this project (Issue, Request, and Change Order). Input the amount of time you expect requests to this queue will take to resolve in the Default Duration field. In the New Issue Fields section, identify the fields you want displayed on the New Issue page. Change the Show All Fields option to No Users.
7.
8.
9.
216
Publish as Help Desk You have three choices for the projects Help Desk setting: None, Public, or Private. None. This is a default option. When this option is selected, the project will not be published as a help desk. Public. When this option is selected, the project is published as a Help Desk and any user in the system can submit issues to the Help Desk. Private. When this option is selected, only users who have access to the project can use the help desk. Company. When this option is selected, the project is published as a Help Desk; however, only users associated with the company the project is assigned to can see it on the Help Desk page. Group. When this option is selected, the project is published as a Help Desk; however, only users associated with the group the project is assigned to can see it on the Help Desk page.
NOTE The group of the project must match any of the groups the assigned to the user.
217
Queue Properties
Types of Issues You can choose one or more issue types. The Issue issue type is selected by default. Other options include: Bug Report, Request, or Change Order. When multiple types are selected, users can pick one of these issue types when they are submitting an issue. The labels for these issue types can be modified when creating custom issue statuses. Closure Threshold This identifies the amount of time users have to confirm the satisfactory completion of the issue before it is removed from their recently resolved issues. After the closure threshold has lapsed, the issue is considered closed. Default Duration Here you set the default duration for incoming issues. Default Category In this dropdown you select a custom data category to be attached to all issues submitted to the Help Desk. Use this option if you want your users to enter custom information when they are submitting an issue. Default Route This identifies the routing rule that will be used when new issues are added to the project. Default Approval This identifies the approval process that should be attached to new issues when they are added to this project. NOTE If no issue categories exist then the Default Category field will not appear on the form.
NOTE If no routing rules are present on the project then the Default Route field will not appear on the form.
NOTE If no approval processes are present in the system, the Default Approval field will not appear on the form.
218
New Issue Fields You can choose any of the 12 fields to appear on the New Issue form. Description, Priority, and Document Upload are selected by default. Show All Fields You can choose which users can see all issue fields when they create a new issue. You have three choices: Members on the project (Full License) All Users (Full License) No Users Selecting the No Users option does not allow any user to see non-selected fields.
219
Email Settings
Enabling and populating the Email Settings fields provides end users with the option to submit issues via email. When configured, AtTask will query a POP email account you setup on your email server every 30 minutes (by default). If new, unread messages are found in the account, AtTask imports the subject of the email as the issue name and the body of the email as the description of the issue. Attachments on the email will even be included as part of the issue. However, only emails sent from AtTask users will be imported from the email account. AtTask will verify the From address of the sender matches the email address for a licensed AtTask user. The following requirements must be met for AtTask to receive emailed issues The email account on your server is POP enabled. AtTask can only interface with POP email accounts. A POP account is associated with a single project. The email account is not a users personal email account.
NOTE The Queue Properties can be defined on templates, which reduces the time spent defining new issue preferences as part of project planning activities. Additionally, setting Queue Properties on a template provides consistency in how new issues are defined on each project.
220
Lesson Notes
221
SCENARIO Create the following Routing Rules and Queue Topics to support an internal AtTask Help queue. Topic Access Level Change General Support Process Change Report Request System Settings Jennifer Campbell Chris Manning User Assignment Route Admin User Project Manager Project Manager Role Assignment Route
NOTE When multiple Topics are routed to the same person or role, you only need to create the Routing Rule once for the project.
222
Routing Rules
To create the Routing Rule for the Admin User 1. 2. 3. Go to a target help desk project. In the contextual menu, click Issues Setup. Click the New Routing Rule link.
4.
Input Route to Admin User in the Name field. NOTE It is recommended you provide a clear name so others who may look at the routing rule will know what it does. It is a good idea to identify it by the Assignee or the Topic it will eventually be added to.
5. 6.
Select the Admin User from the Default Assignee drop down. Click Save.
PRACTICE EXERCISE Follow the steps above generally to create the other Routing Rules for Jennifer Campbell and Chris Manning.
223
Name It is recommend you provide a clear name so others who use the routing rule will know what it does. It is a good idea to identify it by the Assignee or the Topic where it will eventually be added. Description Give the rule a description, if needed. Default Assignee From the Default Assignee, choose the name of the user you want to assign the incoming issues. If you dont see the person you want to assign, use the search icon ( ) to find a user. Default Job Role If you select a Default Job Role, the assignee is cleared. You can select one or the other, not both. You would select a job role if you want to route new issues to a job role rather than a specific individual. When using the Default Job Role field it is strongly recommended add the My Unassigned Issues report to portal profiles. Default Team You can make team assignments for new issues by selecting a default team in the Default Team field. Route to Project Usually if an issue is submitted to a help desk, you want that issue to be routed to the Help Desk project. So, from the Route to Project drop-down, you select that project; however, it is possible to route the issue to some other project using this drop-down menu.
224
Queue Topics
As mentioned above, Queue Topics are used to designate which route and which category will be used on the new issue form. Additionally, topics can be used for reporting purposes. For example, if you create a IT problem help desk, and you want users to indicate whether its a software related problem or hardware related problem, you can create queue topics called Software Problems and Hardware Problems. Then, when a user submits an issue, they select one of these topics. Based on the topic choosen, the New Issue form will display different custom data and issue types, and the new issue will be assigned different duration and routing rules. The case described above has been built into your test environment. To create the Access Level Change queue topic 1. 2. 3. Navigate to a target AtTask Help project. In the left-hand menu, expand the Issues Setup sub menu. Click the New Queue Topic link.
4.
Input a Name for the topic (Access Level Change). This is the value displayed in the Topic drop down on the New Issue form. No categories have been created to support this queue yet, so leave the Default Category value as N/A. If you completed the Issue Approval exercises, select an approval process from the Default Approval field. Input an appropriate duration for this type of request into the Default Duration field. Select the appropriate Routing Rule for the Default Route drop-down. Deselect the Issue and Request issue types.
5.
6.
7.
8. 9.
10. Click the Save button. PRACTICE EXERCISE Follow the steps above generally to create the other Queue Topics for the scenario at the beginning of this lesson.
225
Name and Description Enter a name for the topic. This is a required field. Enter a description to explain to others whom access this area what the topic is meant to do. Default Category Next you can select a Default Category. This will add custom data fields to your queue topic. This category and its parameters must be set up before the topic is defined. Parent Topic Your queue topics can be hierarchical. If you already have topics in the system, and you want to make this queue topic a subtopic to one of those topics, you can do so with the Parent Topic menu. Default Duration The Default Duration sets an automatic duration period for each incoming issue. Default Route The Default Route comes from routing rules that have been set up earlier, as you did in the previous section. Issue Types Finally, you must choose one or more issue types for the topic. The Issues option is selected by default. You can also choose Bug Report, Request, or Change Order.
226
Lesson Notes
227
228
Whats Next?
Course Feedback
We need your help to improve this course. You will be receiving an email shortly inviting you to complete a survey to help us measure the course value, material, and instructor. We rely on your input as we plan changes to curriculum and presentation materials. Thank you.
229
230
231
User Requirements
System Default Information Default Timezone Default Locale Currency Pasword Security High Medium Low
People work in the following roles Cost Rate Cost Rate Cost Rate Cost Rate Cost Rate People work on the following teams Billing Rate Billing Rate Billing Rate Billing Rate Billing Rate
232
Executives should be able to View Projects Tasks Issues Users Other: Add Edit Delete Notes
Portfolio Managers should be able to View Projects Tasks Issues Users Other: Add Edit Delete Notes
Project Managers should be able to View Projects Tasks Issues Users Other: Add Edit Delete Notes
Team Members should be able to View Projects Tasks Issues Users Other: Add Edit Delete Notes
(Other) __________ should be able to View Projects Tasks Issues Users Other: Add Edit Delete Notes
233
Are you more interested in Cost or Time to measure the performance of your projects? Revenue estimates are generated from User-based Rates Role-based Rates Fixed Rates None Cost estimates are generated from User-based Rates Role-based Rates Fixed Rates None
Confugiration
Core and custom statuses needed for Projects, Tasks, and Issues Project Task Issue
234
Customers you do projects for Requires Custom Role Rates Requires Custom Role Rates Requires Custom Role Rates Requires Custom Role Rates Requires Custom Role Rates Requires Custom Role Rates Requires Custom Role Rates Yes No Yes No Yes No Yes No Yes No Yes No Yes No
Portfolios
Progams
235
Reporting Needs
Report Name
Example: My Portfolios Example: My Resource Pools
Description/Purpose
Portfolios where Im the owner, located on a dashboard on the AtTask Home page so I dont have to click into Portfolio Management A report displaying the Resource Pools I have to view on a regular basis with links directly into the Capacity Planner
Audience
Portfolio Managers (Owners) Me
236
237
Name Be sure to name the notification clearly so that you, and others that will apply the notification to tasks, issues, and projects, will know what functionality they are adding to the object. Input the name of the notification into the Reminder Notification field: Task Due to Start in 5 Days. Object Type Select the Task option from the Object Type drop down field to identify what object the Reminder Notification will be applied to. Duration Represents the threshold that must be met for the notification to be sent. In the Duration field input 5 days as the value. Timing Along with the Duration field, will be used to determine when the notification should be sent. Select the Before option from the Timing drop down. Date Field Determines which date fields will be used on the threshold for the notification. Use the Planned Start Date option from the Date Field drop down. Criteria Use the Incomplete in Current Projects option from the Criteria drop down. 238
NOTE The All in Current Projects is only needed when using the Actual Completion Date option from the Date Field drop down.
Recipients Indicate which recipient(s) you want to receive emails when the criteria above are met in this case, select the Assigned To option. Email Template If an Email Template exists for the object type selected, then the Email Template drop down will also appear on the form. Our next step is to create an Email Template and then apply it to this Reminder Notification.
Lesson Notes
239
Email Template The name of the template normally matches the name of the Reminder Notification it will be associated with. Input the name of the template in the Template Name field: Task Due to Start in 5 Days. Description Provide a Description as needed. Object Type Select the Task option from the Object Type drop down. Subject Input the subject of your email into the Subject field. Content Input the body of your email into the Content field.
240
The following tables provide some basic HTML instruction and samples of how to reference values from the AtTask databases. Name HTML Syntax Description Formatting the email can be done through basic HTML tags. Below are some basic formatting tips: Bold Text <b></b> Italic Text Underline Text Line Break Paragraph <i></i> <u></u> <br /> <p></p>
Other HTML tags, such as tables and image references, are allowed. Referencing Database Values A database field reference must start and end with $$. If referencing data outside of the selected object type you must declare the object followed by a colon ( : ). See the example below. The object is assumed, so when referencing the project name on a project notification the value is $$name$$. However, when referencing the project name on a task notification the value is $$project:name$$. For a full list of database fields, refer to the Power Search Guide on the AtTask Community.
Content Sample
Content <p>$$assignedTo:firstName$$,</p> <p>You are assigned to the following task; it is due to start within the next 5 days.</p> <p><i><b>Name:</b> $$name$$</i><br /> <b>Task ID:</b> $$ID$$<br /> <b>Planned Start Date:</b> $$plannedStartDate$$<br /> <b>Planned Completion Date:</b> $$plannedCompletionDate$$<br /> <b>Planned Work Required:</b> $$workRequired$$<br/> <b>Project Name:</b> $$project:name$$</p> <p>Thank you for your hard work.</p> Now that you have created an Email Template, you can apply the template to the Reminder Notification already created. Chris, You are assigned to the following task; it is due to start within the next 5 days. Name: Sample Task Task ID: 1234 Planned Start Date: 12/03/2010 Planned Completion Date: 12/14/2010 Planned Work Required: 10 hours Project Name: Sample Project Thank you for your hard work.
NOTE The AtTask Community contains a number of useful examples of email templates. Review the library at the following URL: https://community.attask.com/email-templates.
241
Lesson Notes
242
You will be presented with a search screen identify the Reminder Notification by name or simply click the Submit button to pull up a list of all Reminder Notification. Select the checkboxes to the left of the Reminder Notification(s) you wish to attach to the task.
6.
Click the
NOTE If according to the criteria of the notification the email should have already been sent, the delivery status of the notification will be listed as Expired.
243
2.
3.
This will present you with a bulk edit screen where you will activate the Reminder Notifications field by marking the check box to the fields left. Using the Ctrl (PC) or Command (Mac) select the notifications that apply to the selected tasks. Click the Save button to commit the change.
4.
5.
244
NOTE New tasks created after the template is applied will not have Reminder Notifications applied to them unless the Project Manager manually adds them after task creation. Likewise, Issues added to the project must have them added manually, either individually or in bulk.
Lesson Notes
245
Appendix B Exercises
Exercise 1
Create a task Email Template that based on the content from the Late Project Notification email templates example on the Community https://community.attask.com/email-templates.
Exercise 2
In the Reminder Notification area, create a new notification that will let assigned users know when they are 3 days late on tasks.
Exercise 3
Assign your Reminder Notification to several tasks through a bulk edit.
246
Issue
Issue Approval by the Issue Primary Contact on Issue Closed, Resolved, Wont Resolve, and Cannot Duplicate. Approval of Document Creation Tasks on Task Completion by the Project Manager.
Task
Task
Task Approval by the Assigned Resources Manager on Task Start, and By the Project Manager on Task Completion.
247
SCENARIO Your organization decides to utilize the Help Desk feature within AtTask to support your Quality Assurance processes. You need to create the second Approval Process identified in the Table of Approval Requirements.
Steps 1. 2. 3. 4. 5. 6. 7. 8. 9. Go to Setup Workflow Setup Approval Setup Issue Approvals Setup. Click on the New Approval Process link in the contextual menu. Name and describe the Approval Process. Click the New Approval Path button. Select the Closed option from Target Status drop down. Change the value in the Approval Step Name (optional). Select the Job Role option from the Approval Type drop down. A list of recently accessed roles will appear in the Approvers drop down. If the QA Engineer is present, select it; otherwise, use the inline search option by clicking on the search icon to browse for the role. Click on the New Approval Path button once again, and repeat steps 4 through 7 for the Resolved target status.
248
SCENARIO Edit the Approval Process created in the above scenario and add process 3 from the Table of Approval Requirements as additional Approval Paths. The initiator of the issue should be able to verify the issue is completed satisfactorily upon completion or if the issue is set to a Wont Resolve or Cannot Duplicate status. It will be necessary to add two new Approval Paths for the Wont Resolve and Cannot Duplicate statuses, and you need to add two new Approval Steps to the existing Approval Paths.
Steps 1. 2. 3. 4. 5. 6. 7. 8. 9. Go to the Issue Approvals Setup area. Click the name of the Approval Process you want to edit. Click the Edit Approval Process link from the left-hand navigation. For the Approval Path with the Closed status, click the Add Approval Step button. Name the Approval Step. Select the User option from the Approval Type drop-down. Select the Primary Contact wildcard from the Approvers drop-down. Repeat steps 4 to 7 for a Resolved approval. Click the Add Approval Path button and select User, Primary Contact approval for the Wont Resolve status.
10. Click the Add Approval Path button and select User: Primary Contact approval for the Cannot Duplicate status. 11. Click the Save button to submit the Approval Process.
249
SCENARIO Create a new Task Approval Process to be associated with tasks that require the submission of a document upon completion of the task, as described in Process 4 in the Table of Approval Requirements. This Approval Process requires that when a task is completed the Project Owner will approve the task.
Steps 1. 2. 3. 4. 5. 6. 7. 8. Go to the Task Approvals Setup area. Click the New Approval Process Link in the left-hand menu. Name and describe the Approval Process, then click the New Approval Path button. Select the Complete option from the Target Status drop-down. Select the User option from the Approval Type drop-down. From the Approvers drop-down, select the Project Owner option. In this case, change the If Path is rejected option to Create an Issue. Click the Save button to submit the Approval Process.
250
SCENARIO Create a new Task Approval Process that satisfies the requirements of process 5 in the Table of Approval Requirements. The Approval Process will allow the assigned resources manager an opportunity to approve the work when the status changes to In Progress, and it gives the Project Owner approval on task completion.
Steps 1. 2. 3. 4. 5. 6. 7. 8. 9. Go to the Task Approvals Setup area. Click the New Approval Process Link in the left-hand menu. Name and describe the Approval Process, then click the New Approval Path button. Select the In Progress option from the Target Status drop-down. Select the User option from the Approval Type drop-down. From the Approvers drop-down, select the Assigned To Manager option. In this case, use the If Path is rejected option to Set Status to New or Previous Status. Click the New Approval Path button. Select the Complete option from the Target Status drop-down.
10. Select the User option from the Approval Type drop-down. 11. From the Approvers drop-down, select the Project Owner option. 12. In this case, change the If Path is rejected option to Create an Issue. 13. Click the Save button to submit the Approval Process.
Lesson Notes
251
252
253
254
255
As mentioned above, each checked item will be represented in the Excel file as sheets at the bottom of the spreadsheet, and each tab will contain the importable fields from the database.
NOTE The project, task, issue, templates, and template tasks sheets are not populated with production data because the primary purpose of the Kick-Start importer is to create new projects, tasks, etc. it cannot be used to provide updates to existing projects, tasks, etc.
256
There are several common fields to most sheets. They are identified below: isNew There are two acceptable values for this column TRUE or FALSE. When set to TRUE, AtTask will read and attempt to import the data stored in the row. When set to FALSE, AtTask will not attempt to import the data stored in the row, but the values can be referenced when building data in other sheets. ID The ID must be a unique value within the column. It is recommended that values exported in the template are not changed or reused to ensure accuracy during import. setName As when creating all objects through the interface, a name is a required value in order to successfully import data. You will notice the column header is bold. This indicates that a value must be present in this column for the row to import.
Lesson Notes
257
SCENARIO Create the following groups: Product Development Finance Professional Services Operations Create the following users accounts referencing data from the appropriate sheets: Name Marc Lewis Jennifer Campbell Chris Manning Donna Hyde Group Finance Product Development Product Development Default Group Access Level Executive Program Manager Individual Contributor Individual Contributor Email mlewis@foo.com jcampbell@foo.com cmanning@foo.com dhyde@foo.com Role N/A Project Manager Consultant Designer
258
To do this 1. You will create a Kick-Start template with the following sheets: Access Level, Group, Job Role, and User 2. On the group sheet: Input TRUE into the first four empty rows in the isNew column. Provide unique IDs in the ID column for each new row. It does not matter what values you input as long as they are not used on the sheet you are viewing on import AtTask will assign new IDs. Input the name in the setName column. 3. On the User sheet: Input TRUE into the first four empty rows in the isNew column. Provide unique IDs in the ID column for each new row. Input the corresponding access level IDs into the setAccessLevelID column, referencing values from the Access Level sheet. Input the email addresses in the setEmailAddr column for each user. Input the corresponding group IDs into the setHomeGroupID column, referencing values from the Group sheet. When referencing groups that have not been created yet, simply input the ID you assigned. Input a password into the setPassword column for each user. Input a unique value in the setUsername column. Keep in mind that usernames must be unique across the entire database. Input the users first name in the setFirstName column and the users last name in the setLastName column. Input the corresponding role IDs into the setRoleID column, referencing values from the Job Role sheet. NOTE The same fields that are required when create a user through the interface are required through the Kick-Start importer. NOTE You can hide or remove non-required columns any sheet to make it easier to use. However, do not remove the empty row at the top of each sheet.
4. 5. 6.
Save the Excel file. Go into the Kick-Starts area to perform a test import of your Excel spreadsheet. Resolve any conflicts and perform an actual import of your Excel spreadsheet.
NOTE Conflicts are described in a message at the top of the AtTask interface. The message indicates the sheet, column, and row where the first instance of the conflict occurs.
259
Lesson Notes
260
On each of the above projects, include the following task information: Name Task 1 Task 2 Task 3 Task 4 Assigned To Chris Manning Donna Hyde Donna Hyde Jennifer Campbell Duration 4 days 2 days 5 days 20 days Work Required 10 hours 10 hours 40 hours 20 hours Duration Type Calculated Assignment Calculated Assignment Calculated Work Calculated Assignment Predecessor N/A Task 1 Task 2 Task 3
Using the principles learned in the previous scenario and the assistance provided below, complete the import through the following steps: 1. Create a Kick-Start template with the following information: Groups, Projects, Tasks, Users 2. On the Project sheet: Input TRUE in the first two empty rows in the isNew column. Provide IDs for the two new projects. Input the corresponding group IDs into the setGroupID column, referencing values from the Group sheet. Input the name for each project in the setName column. Input a planned start date for the project in the setPlannedStartDate column. NOTE AtTask can read any Excel date format. However, be aware if the date in the spreadsheet cell does not contain a time value, then AtTask will import the date with a time of 12:00 am for the date provided. It is suggested you select a column format that shows both date and time (i.e., 7/6/2010 5:00 pm or 7/6/2010 17:00)
Input the corresponding user IDs into the setOwnerID column, referencing values from the User sheet.
261
3.
On the Task sheet: Input TRUE into the first eight empty rows in the isNew column. Input eight unique IDs in the ID column. Input the names for your tasks in the setName column keep in mind you are creating the same tasks into each project, so you will have to input each task twice. Input the corresponding project IDs into the setProjectID column, referencing values from the Project sheet. Input the duration integer into the setDuration column and the duration unit into the setDurationUnit column. Available duration units are in the User Manual and below: o M = Minutes o H = Hours o D = Days o W = Weeks o T = Months Input the work required integer for each task into the setWork column and the work required unit into the setWorkUnit column. Input the duration type into the setDurationType field. Possible values are listed in the User Manual and below: o A = Calculated Assignment o W = Calculated Work o D = Effort Driven Input the corresponding user IDs into the setAssignedToID column, referencing values from the User sheet. Input the ID for the predecessor task into the setPredecessorString column
NOTE Other fields you may want to use on the Task sheet may include: setTaskConstraint and setConstraintDate if no value is input AtTask will assume an As Soon As Possible (ASAP) constraint. setTaskNumber this will identify the order the tasks should appear in on the project; if no value AtTask may rearrange the sort of your tasks during import. setParentID this will create parent/child relationships in the task work breakdown structure. Be sure to verify that you are not creating dependency loops if you are creating predecessor relationships during the import.
4. 5. 6.
Save the Excel file. Go into the Kick-Starts area to perform a test import of your Excel spreadsheet. Resolve any conflicts and perform an actual import of your Excel spreadsheet.
262
Lesson Notes
263
SCENARIO Import a single project with Portfolio and Project Metrics category, populating the Business Unit dropdown field and Objectives text box.
To do this Create a Kick-Start template with the following information: Groups, Projects, Categories, Parameters, and Parameter Options On the Project sheet: 1. 2. 3. 4. 5. 6. 7. 8. 9. Input TRUE in the first empty row in the isNew column. Provide a unique ID for the new project. Input a group ID into the setGroupID column, referencing values from the Group sheet. Input the name for the project in the setName column. Input a planned start date for the project in the setPlannedStartDate column. Input the category ID into the setCategoryID column, referencing the value from the Category sheet. In row 2 for the first empty column input DE:Business Unit In the next empty column input DE:Objectives Because the Business Unit field is a drop down, you must input a value defined in for the field on the Parameter Options sheet. Go to the Parameters sheet first to find the parameter ID, and then go to the Parameter Options sheet to view the allowed values. Input one of these values in row 3 for this column.
10. Input a value into the col dumn with the DE:Objectives header as well. This is a text area field and does not require a specific value from the Parameter Options sheet. 11. Save the Excel file. 12. Go into the Kick-Starts area to perform a test import of your Excel spreadsheet. 13. Resolve any conflicts and perform an actual import of your Excel spreadsheet.
264
Lesson Notes
265
Appendix D Exercises
Exercise 1
Search for the Cruzer Web Site Project and through the Import/Export menu on the left-hand navigation, export the data to MS Project.
Exercise 2
Select the Project option from the Create menu and then select Import MS Project from the left-hand navigation. Browse for the project plan that was just exported and import it as a new project.
Exercise 3
In the Kick-Starts area, export the following data: Categories Parameters Parameter Groups Parameter Options
Exercise 4
Add a new text field parameter called New Parameter to the Excel file.
Exercise 5
Add a new task category called New Category to the Excel file that contains the New Parameter.
Exercise 6
In the Kick-Starts area, import the Excel file (not in test mode).
Exercise 7
Edit any task and on the Custom Data tab, select New Category from the dropdown to verify the category was created with the parameter in place.
266
267
Lesson Notes
268
269
Discussion Points
Timing of Data Migration
The successful rollout of AtTask to your end users is dependant on having production-quality data in your account at the time of rollout to allow them to do work immediately on logging in the first time. Migrating data prematurely will result in stale data that needs to be updated before it is of use to project managers and collaborators. Importing necessary data following rollout normally results in a loss of momentum for collaborators. When they first login, they do not have assignments, nor can they provide the updates and perform the AtTask-related work you will ask from them. In short, it is important to gauge how long the data migration will take (given the quantity and quality of existing datasets). This needs to be timed appropriately so internal training for project management and team member activities allow you to move directly into the production rollout of the software. Additionally, your implementation team should discuss whether or not there will be an overlap of existing systems of AtTask, or if once AtTask is launched it is the sole system for project information.
Reporting Requirements
A key factor in determining what data will be transferred into AtTask is deciding whether or not it is necessary for reporting. Many organizations find the reports they have been using contain elements that no longer provide value to business decisions. It is usually not necessary to carry over data points that will not be used for reporting. It is recommended that you identify what specific reports are needed to allow resources to do their jobs and executives to make critical decisions. Many times the reports are already in use in weekly, monthly, or quarterly status meetings. If this is the case in your organization, then it is simply a matter of verifying the relevance of each data point by speaking to the stakeholders who review the reports on a regular basis.
270
Data Warehousing
One way to preserve historical data and simplify your migration requirements is to create a data warehouse external to AtTask to store legacy data and reports. It is not uncommon that the data warehouse is a living database in which AtTask provides updates to the dataset from time to time. However, this approach usually requires a custom integration, which you will have to create and maintain.
Integration
If AtTask was introduced into your organization to supplement an already existing system and not to replace a dataset, you may consider building integration between the different software. For example, if you wish to use AtTask data in your financial system, it may not make sense to store financial data in AtTask, nor would it be worthwhile to store project information in the financial software. It may make even less sense to ask resources to do double entry. You will want to consider the feasibility of creating and maintaining this integration. Your first step would be to identify the business and technical requirements, integration points, reporting impact, the system of record, and availability of internal resources to perform the customization.
Lesson Notes
271
Appendix E Exercises
Exercise 1
Make a list of possible integrations your organization may need to create to share information between AtTask and other systems.
Exercise 2
If your organization typically uses LDAP or another external authentication server, send the URL provided in Lesson 8.2 to the normal IT resource that configures these integrations.
272
NOTE This Appendix is provided in this course book because it is sometimes the AtTask administrators responsibility to perform upgrades when AtTask is installed on your own servers. You will also want to refer to the official Installation Guide located on the AtTask Community.
273
274
Installation Steps
The following events must take place 1. 2. Create database on your database server (assuming the database instance is already configured). Contact AtTask for your license.key file. This contains: o IP Address or Hostname of the database server. o 3. 4. 5. 6. Database name usually, attask. Download the AtTask installation file from http://www.attask.com/update/. With your license.key and installer in hand, start the installation process by executing the install-attask.* file, and work through the installation wizard. At the conclusion of the installation, you will launch the service by accessing the Run AtTask 4 script in the AtTask directory that was added to your application server. You can then access the AtTask application through your web browser by typing in the hostname of your application server into the address bar of the browser.
The AtTask installation adds two directories to your application server: The AtTask directory, and The AtTaskDoc directory
275
1. 2. 3.
Make a database backup of your production environment (or use your most recent backup). Restore the data dump to your development environment database. Copy the following portions of the AtTaskDoc directory. o AtTaskDoc/01 o o AtTaskDoc/global AtTaskDoc/opensso (if SSO or LDAP is installed) though in most cases you will want to disable SSO in your development environment so that you can login as different resources to test your custom code.
Assuming you have migrated the data stored in the database, you must also move these folders in the AtTaskDoc directory; otherwise views, filters, etc. will be missing in the development environment. Transferring Data from Development to Production Normally, you do not want to move data from your development instance into the production environment by restoring a backup of the development data. The assumption is that several days, weeks, or months may have lapsed since your last data migration from production to development, which means that hundreds of man-hours of work have been recorded in production. Instead, any integration file added to the development environment needs to be copied into the correct directory inside the production installation files. Likewise, any object modified or added through the development interface needs to be recreated in the production instance. These might include new custom data fields, external pages, templates, hour types, job roles, views, filters, reports or whatever it is that was necessary to add to ensure your customization works. Any system preferences should be manually modified to ensure the systems are in synch prior to applying your custom code. The files identified in the AtTaskDoc directory should NOT be moved back for the same reason the data stored in the development database will not be migrated back.
Other Recommendations
Regardless of the complexity of your installation of AtTask, if you have multiple environments, customizations, etc., it is strongly recommended that you create regular backups of your database and AtTaskDoc directory.
Lesson Notes
277
278
Most of the fields in the Database Setup section will never be modified. The only exceptions would be if you were to change your database user credentials or TCP/IP settings. 279
The fields in the External Login and External Sign-on sections are provided for backwards compatibility and should not be used; instead it is suggested that you would use the LDAP and/or SSO options discussed in Help Article entitle Single Sign-On Overview on help.attask.com.
AtTask IT staff use the Enable Domain Authentication field to restrict access to AtTask OnDemand to specific URLs.
280
If unexpected errors are being displayed in the interface, it is suggested that you make the following changes; otherwise, the default logging preferences are satisfactory for most organizations. Logging Level: Database Activity Logging: Debug Yes
Making these changes and providing the log file may be necessary when working to resolve errors with AtTask support.
281
Time Out
The Time Out section controls when login sessions will expire.
The default Session Time Out is set to 8 Hours a normal business day and can be set to as low as 15 minutes or to have No Timeout. Depending on your organizations security protocols, you may need to force the session to close at a smaller duration of inactivity and on closing the web browser. If you have to restart the AtTask service for one reason or another, the Preserve Session on Restart field, if set to Yes, will not require users to re-login when the service becomes active again.
282
Email Generation
The first email configuration step for OnPremise customers is found in the Email Generation section. Without setting these values, email cannot be sent. AtTask Local Hostname This controls how AtTask communicates with itself to populate email templates. Value: localhost unless serving AtTask through apache or IIS, in which case it needs to be the hostname of the AtTask server. AtTask HTTP Port This designates the HTTP port used during installation of the software. Value: 80 or 8080 are the most common open HTTP ports; 443 is the normal secure HTTP port. AtTask Servlet Context Value: /attask AtTask External Hostname This field is used to build the links back into AtTask from the generated email. Value: the URL you have defined and distributed to your end users to access the login screen. AtTask External HTTP Port This designates the HTTP port used when accessing the AtTask login screen. Value: 80 or 8080 are the most common open HTTP ports; 443 is the normal secure HTTP port. Use https for all generated emails If you are connecting to AtTask through a secure port, you will want the links into AtTask from emails to contain https instead of http as well.
283
Lesson Notes
284