Go to primary content
Agile Product Lifecycle Management Product Portfolio Management User Guide
Release 9.3.3
E39293-05
  Go To Table Of Contents
Contents

Previous
Previous
 
Next
Next
 

2 Understanding the Interface

As a PPM user, you need to be familiar with the following:

2.1 Home Page

The Agile Home page provides access to Dashboard, Notifications, Workflow Routings, and My Assignments. You can configure the application to view timesheets. You can set the Home page to display one of these tab pages as your preferred start page. For more information, refer the Getting Started with Agile PLM guide.

If you choose one of the dashboard tabs as your preferred start page, that dashboard tab page displays when you click the Home page icon in the top pane.

To view the Home page while you are working on a project page, click the Home icon.

2.1.1 Quick Links

Quick Links, at the top of the Home page, is a list of up to ten links that you use frequently. You can define and edit your own Quick Links list. Your Quick Links list can include predefined Agile PLM system links, saved searches in your Personal Searches folder, or bookmarks in your My Bookmarks folder.

To edit your Quick Links list:

  1. Click the Edit icon next to the Quick Links: heading at the top of the Home page. The Edit Quick Links dialog appears.

  2. From the dropdown list choose the type of link you want to use.

  3. Use the display button and hide button to move links from the Hidden Links list to the Quick Links. Or, double-click to move links from one list to the other list.

  4. You may include more than ten links in the Quick Links list, but only the first ten links are displayed in your Quick Links list.

  5. Reorder the list by selecting one or more links and using the move up and move down arrow buttons to move them up or down in the list.

  6. When you are finished, click the Save button.

2.1.2 Home Page Inbox Tabs

As information passes through the Agile system, users receive news of status changes, requests, and other notifications through email. Users with different roles and privileges receive different notifications. As soon as you log in to the Web Client, it is a good practice to view the information available for your perusal on the Home Page Inbox tabs.

  • Dashboard Tab-Enables you to view and manage information across all your projects. For more details on dashboard features, see "Dashboard."

  • Notifications Tab-Lists notifications that inform you of some action or process that has taken place, or requests that you can accept from the My Assignments tab. In addition, this tab lists the action items or activities for which you can accept or decline ownership from the My Assignments tab. It is a recommended practice to delete the notifications after you have read them.

  • Workflow Routings Tab-Lists the routable objects that require your review or action. Click the object number in the table to open a routable object.

  • My Assignments Tab-My Assignments Tab lists project leaf node objects or action items assigned to you which are not yet complete. You can accept or decline a request or ownership. Click the Quick View callout that appears when you position your mouse cursor over an object, to view the details of the object.

  • Timesheet Tab-Enables timesheet entry by assigned resources on a project. It enables you to track reported time data to ascertain resource utilization and related costs. This tab is visible only if enabled by your Agile administrator.

2.1.2.1 Dashboard

The Dashboard is a highly configurable set of views that enables users to track and manage the information available in the Agile PLM system.

You can create an unlimited number of dashboard tabs to categorize and display the content you want. Access to these tabs can be restricted through roles and privileges. The data that you want to view can be retrieved from different sources, and rendered in charts, tables, and other forms.

Dashboard tabs must be created and configured in Agile Java Client by an administrator. You can view and personalize the tabs that are made visible in Agile PLM Web Client for your use.

For details on configuring Dashboard views, see the Agile PLM Administrator Guide.

The dashboard enables PPM users to view and manage information across all projects. You can use the dashboard to obtain:

  • Executive-level view of key information for all your projects based on your roles and privileges

  • User-level information about your own activities and tasks

  • Resource utilization reports

All users can use the dashboard to access reports and view consolidated information. See also "Reports."

2.1.2.2 Viewing the Dashboard

The Dashboard tab appears on the Home page along with Notifications, Workflow Routings, and My Assignments tabs.

To view the Dashboard:

  1. In the top pane of the Welcome page, click the Home icon.

  2. Click the Dashboard tab.

To make the Dashboard tab page your default start page when you log in to Web Client:

  1. In the top pane of the Welcome page, click My Settings. The User Profile page appears.

  2. Click the Preferences tab.

  3. Click Edit.

  4. Select the Dashboard list item in the Preferred Start Page dropdown list.

  5. Click Save.

2.1.2.3 Manipulating the Dashboard Widgets

The Dashboard widgets can be manipulated by the icons and menu entries described in the table below.

Button Description
Export Exports data in comma-separated value (.CSV) format for use in a spreadsheet (available in all tables).
Maximize/Restore Original Size Expands the window to full size or reduces it to the size it was previously.
Refresh Refreshes the table view to show latest changes to content.
Remove Content From View Closes the window.

To reopen the window, refresh your browser view. Or select the content object from the Add Content dropdown list at the bottom of the page and click Add.

Dashboard Filter Displays the dashboard category fields by which you can filter the widget results. Edit these fields and click Save to obtain the narrowed down search results.

In the windows which display a widget, you can click column headings of most tables to change the sort order. If you have the necessary privileges, you can click the data in most widgets to 'drill down' to a view of the individual object.

2.1.2.4 Dashboard Tabs

The dashboard comprises:

  • Default Tabs that enable you to select the view: Executive, Projects, Resources, Financial, My Stuff, Optional Tab 1, and Optional Tab 2.

  • User-configured tabs that display customized information in tabular or chart formats, based on preferences set up by an administrator.

To view user-configured tabs, you must have the Dashboard Tab View privilege assigned to you, and this privilege must be applied to these tabs within the Agile Java Client.

  • Widgets within each tab that present information relevant to that view. For example, in the My Stuff tab, the widgets represent the current user's project activities: My Discussions, My Documents, My Action Items.

  • The Dashboard Filter icon in every table enables you to filter data within the widgets to create customized views.

The information you can view in the Executive, Projects, and Financial tabs is from root projects for which you have the Read and Discover privilege.

If you are an Executive, you have global privileges. You can view all root-level projects that contain matching values for the dashboard category fields. By default, these fields are labeled Project Type, Region, Division, Customer, Launch Year, Product Line, Category 7 to Category 24, and Program. These are multi-select list fields that can be relabeled and configured within the Administration > General Info tab in the Agile Java Client.

For information on how to configure optional dashboard tabs, see the Agile Administrator Guide.

2.1.2.5 Configuring Dashboard Tab Widgets

The Dashboard Filter icon at the top of each widget enables you to filter the data in the widget to show only the information that is most relevant to you.

To filter the table display within a dashboard tab widget:

  1. Click the Dashboard Filter icon in the table. The default filter values for the dashboard category fields appear.

  2. Click Edit.

  3. The default selection for all the dashboard categories is All. Choose the Selected option to enable the search palette next to each field.

  4. Launch the search palette next to the dashboard category field which you want to filter, and search for defined attributes.

  5. Select attributes for each category field, one by one.

  6. Click Save.

The selected fields display in the widget.

You can filter the dashboard category fields that display within each tab widget according to your business requirement.

For example, a functional manager who owns several resource pools might want to view only off-track tasks assigned to people in certain pools. An executive might set the dashboard to show all the projects, programs, issues, gates, financial summaries, and resources that apply to a division and region, or view a specified subset. Once the dashboard settings are entered, you only see information that satisfies the specified settings.

You can use the dashboard category fields to rapidly classify tasks and to slice data for reporting purposes. The default Dashboard category fields are Project Type, Region, Product Line, Division, Region, Launch year, Program, Category 7 to Category 24.

The values that you set at the root project level are applied down the hierarchy. For example, if you set a particular value for Division at the root project level, all the tasks within the hierarchy are also set to the same value. These fields are ideally used for Customer, Market and other attributes that are relevant at the top level of the project.

If a root project has a value set to "All," then, by design, it will appear in all views no matter what value is selected in the configuration view for that field.

2.1.2.6 Executive Tab

The Executive tab provides portfolio data for the executive who needs to monitor projects and see information rollups by type of project. It provides a cross-section of information on projects where you can see the major risks in terms of schedule, resources, and cost.

The Executive tab contains data only if you have Executive role, or have Read privilege for root-level projects.

The widgets in the Executive tab are:

  • Project Status - Provides a graph of all active projects the user has configured to view, showing the overall status of each (that is, On Track, Needs Attention, Off Track). For each type of status displayed, the widget shows the percentage of projects with the specific status.

To display the number of projects that comprise a segment, place the mouse cursor over that segment of the chart.

To display the Projects tab with a particular segment of projects selected in all windows, click that segment.

The data in this window does not include projects that are in the Completed or Canceled states, projects with a Project State field setting of Proposed or Template, or projects that are archived or soft-deleted.

  • Resource Pool Allocation - Displays a table showing the names of available resource pools and associated data, filtered by the settings in the dashboard filter.

    The table displays the following information for each resource pool:

    • Pool Name- The name of the resource pool.

    • Overdue - The number of Off Track projects which have a resource pool or pool members assigned.

    • Allocation - Displays a red square if the pool or any of its members are over-allocated for a project.

Pool members who do not have current assignments are not counted. Resources who are not assigned to any resource pool do not appear on the dashboard.

To view the Resource Pool Utilization Report, click the icon in the last column of the Resource Pool Allocation widget in the dashboard.

The data in this window does not include projects that are in the Completed or Canceled states, projects with a Project State field setting of Proposed or Template, or projects that are archived or soft-deleted.

  • Financial - Displays a table showing cost rollups for the root projects that you have access to view. The Financial tab in the Executive view also shows the same table that is presented in the Financial View. See "Financial Tab."

2.1.2.7 Projects Tab

The Projects tab displays gate progress, status, and discussions specific to the projects for which you have access as the owner, resource, or team member. The various widgets in the Projects tab are:

  • Project Status - Displays all projects to which you have access (subject to the table filters). It includes the root project name, status, start date and end date.

    To change the sort order, click a column heading.

    To open a Project object, click its name. The icon adjacent to the project name indicates the status of the project, such as On Track or Needs Attention.

  • Gate Status - Displays the gates for each active project, their status and scheduled due date. (The number required is derived from the number of deliverables listed on the Content tab plus the number of dependencies to the gate.)

    To open a project or gate, click its name.

  • Project Discussions - Lists the open discussions, specific to the projects for which you have access rights. The Open Date denotes the date on which the discussion was initiated. Use the Priority drop-down list to filter the discussions by priority.

2.1.2.8 Resources Tab

The Resources tab provides resource pool owners and executives with information about the resources they manage. Pool managers can see the status of activities assigned to their resources, the priority issues related to their resources and the list of off-track activities assigned to their pools. They can also see the current resource loads across the enterprise.

The various widgets in the Resources tab are:

  • Resource Allocation - Shows each resource pool's projects and status, noting items that are in Pending, Assigned, or Overdue statuses. It also notes resources that are over-allocated.

    A pending activity or gate is one that has been delegated to a resource pool, but has not yet been assigned to a user in that pool.

    The number of overdue items is a count of all activities or gates that are past the due date, regardless of whether they are assigned to users.

    To edit status for a resource pool (add or remove resources, or create a report), click its name.

    The data in this window does not include projects that are in the Completed or Canceled states, projects with a Project State field setting of Proposed or Template, or projects that are archived or soft-deleted.

Open Discussions by Resource Pool - Shows the discussions for each resource pool. You can select priorities to display from the Priority list. Click the name of a project to open it. Once the project object is open you can go to its Discussions tab, and view associated issues. (For further information on the Discussions tab, see "Discussions Table."

If there is a discussion thread, only the top level issue is displayed.

The data in this window does not include projects that are in the Completed or Canceled states, projects with a Project State field setting of Proposed or Template, or projects that are archived or soft-deleted.

  • Resource Pool Activity Status - Shows Off-Track items assigned to pool members of pools that you own, noting Scheduled due date, Project name, and Scheduled End date. To view and update off-track resource pool activities, click the Resource pool name.

The data in this window does not include projects that are in the Completed or Canceled states, projects with a Project State field setting of Proposed, or projects that are archived or soft-deleted.

Resource Pool Utilization - Shows a graph of resource pool utilization by project, enabling a pool manager to see where resources are allocated or over-allocated.

To view project name and percent utilization of resources, place the mouse pointer over each chart segment.

To view team data, click the chart segment of interest. This opens the corresponding project object in the Team tab.

The data in this window does not include projects that are in the Completed or Canceled states, projects with a Project State field setting of Proposed, or projects that are archived or soft-deleted.

2.1.2.9 Financial Tab

The Financial tab shows charts of capital expense, labor cost, and fixed cost for each root project available. The Financial tab also shows the same table that is presented in the 'Financial' widget in the Executive tab.

To configure which reports appear in the Financial tab, use Tools and Settings > Administration > Dashboard Configuration.

To select the projects to be considered for each chart, use the Dashboard filter in the chart.

You can minimize, maximize, or close charts in the tab view. When a chart is closed, the Add Content list appears. Use this list to re-open any chart that you have closed.

2.1.2.10 My Stuff Tab

The My Stuff tab displays the Documents, Discussions, and Action Items assigned to the logged in user. The widgets in this tab are:

  • My Action Items - Displays all your Action Items by Status, Creator, and Due Date. The name of the project or discussion to which the Action Item is associated appears as a link in the Belongs To column. Click the link to view the associated object. To view the Action Item, click the corresponding link in the Subject column.

  • My Documents - Lists all the project-related documents that you own with the name of the Root Project, Project Name, Folder Number, and the File Name. To open a file, click the folder number and then click the Files tab. Alternatively, you can click the file name to view the document.

  • My Discussions - Lists all the discussions you have created for the selected set of projects, showing the Subject, Most Recent Message, and the Date for each. You can click the Subject link to view and reply to a discussion.

2.1.2.11 Optional Tabs

You can configure Optional Tab1 and Optional Tab2 to display reports based on your customized queries in each table. If you have the privilege to configure these tabs, a Configure button appears in the middle of each table in the Optional Tabs page.

To configure a dashboard widget table:

  1. Click Configure.

  2. In the Table Name field, type a name relevant for the data you want to show in the table.

  3. In the Chart Type field, select an option.

  4. Click Next.

  5. Select one of the following search options:

    • Saved Search - Use the search palette to select a saved search.

    • Advanced Search - Click Define Query to use the Agile PLM Advanced Search feature to retrieve the data you want.

    • Click Next.

  6. Specify sort order and click Finish.

  7. Select the fields you want to display from the Available Fields column and move them to the Selected Fields column using the left and right arrows. You can also reorder the fields using the up and down arrows.

The fields that are available for display are configured in Java Client by an administrator. For more information on configuring Optional tabs in Java Client, see the Agile PLM Administrator Guide.

2.1.2.12 Dashboard Management Administration Tasks

If your Agile administrator has given you Administrator privilege applied to Dashboard Management, you can use the Tools and Settings menu (Tools and Settings > Administration > Dashboard Configuration) to modify systemwide settings that determine which available tables to display on each tab, and the order in which they are displayed. For instructions, see "Configuring the Dashboard."

Caution Any Dashboard Management modification you make affects every Agile PLM user. If you display a particular table, then every user can see that table in their dashboard. If you hide a particular table, then no one can see that table in their dashboard.

2.1.2.13 Notifications

The Home page Notifications tab lists notifications that have been sent to you through the PLM notification system. Notifications inform you of some action or process that has taken place, such as the trigger of a field subscription and the generation of RFQs. A notification can also let you know that you have a request that requires your attention. Requests ask you to accept or decline ownership of an action item or activity.

To accept or decline a request, use the My Assignments tab.

To view a notification:

Click the Subject link.

The notification details and links to associated data are displayed in the notification palette. The palette controls include:

  • Back - read the previous notification in the table.

  • Forward - read the next notification in the table.

  • Delete - delete the displayed notification.

  • Close - close the palette.

To delete notifications from the table:

  1. Select the table rows you want to delete.

  2. Click the Delete button or Press the Delete key.

To filter the Notifications by time ranges:

Use the Pending age of notifications dropdown list to select the age for the notifications that you want to see in the table: All, 30 days, 90 days, 180 days, 360 days.

For example, select 90 days to see notifications that moved into your Notifications list within the last 90 days. The default is 90 days, but once you make a selection in this list, that selection is retained the next time you log in.

The Notifications table displays the following information about each notification.

You can sort the Notifications table by clicking any of the table column headers described below.

Notification table columns Description
Notification icons Displays icons representing the type of notification and whether you have read the notification:

Unread notifications:

- Unread notification

- High importance unread notification

- Low importance unread notification.

Read notifications:

- Read notification

- High importance read notification

- Low importance read notification

Subject A link that you can click.

The title of the notification.

Click this link to view and read the notification in the notification palette.

Object icon Icon for the object type related to the notification.

Place your cursor over the icon to see the object name in the tool tip, for example, ECR or Audit.

Click this column header to sort the notification table by object type.

Regarding A link that you can click.

The object for which the notification was sent, for example, a specific Discussion or ECR.

Click this link to open the object in the content pane.

Or, use the Quick View feature to view the object:

Place your cursor over the link.

When the Quick View bubble appears, click Quick View to open the object in the Quick View palette, a separate pop-up window.

The Notifications table remains visible and accessible behind the Quick View palette.

Received The date the notification was received.

Click this column header to sort the notification table by date.


2.1.2.13.1 PPM Notifications

Within Product Portfolio Management, default notifications are triggered and sent to appropriate recipients when you perform various actions on a project object. For example, a notification can inform you of schedule or status changes, an activity assigned to you, or a project that needs your approval, based on your role.

Event-based notifications can also be configured in Java Client according to your requirement. Such notifications can be triggered by event-based subscriptions.

For detailed information on event-based notifications, configuring notifications, and creating custom notifications, see the Agile PLM Administrator Guide.


Note:

Notifications are generated only when enabled in Java Client.

Default PPM notifications are related to any of the following:

  • Ownership, Assignment or Delegation

  • Schedule Change

  • Cost

  • Workflow

  • Discussions

  • Subscriptions

  • Setup

2.1.2.13.2 Cost Impact Notifications
Notification Received By When...
Task Overbudget Notification Task Owner The cost of executing a task exceeds the budget allocation for it.
Actual Time exceeds Budgeted time to Object Owner Notification Project owner Resource(s) allocated to a task have exceeded the budgeted time to complete the task.
Actual Time exceeds Budgeted time to Pool Owner Notification Resource Pool Owner Resource(s) from the recipient's resource pool have exceeded the budgeted time to complete the allocated task.

2.1.2.13.3 Discussion-related Notifications
Notification Received By When...
Discussion Action Item Assignment Notification Discussion participant/program resource An action item associated with a discussion is assigned to the recipient.
Discussion Create Notification Any user added to the Notify list during discussion creation. A new discussion object is created successfully.
Discussion Send Discussion participant/program resource A discussion is sent to the recipient.
Reply Create Notification Discussion participants A user replies to a message within a discussion thread.
Reply Update Notification Discussion participants A user updates a reply message within a discussion thread.

2.1.2.13.4 Other Notifications
Notification Received By When...
Relationship Promotion Failure Notification Program Owner Automatic promotion of a project status fails for any reason, for example, the non-completion of a required field.
Relationship Notifications > Subscription Notification Notification subscriber Field tags within a subscription notification is changed or updated.

2.1.2.13.5 Ownership, Assignment, or Delegation Notifications

The following notifications are related to ownership, assignment, or delegation of a project object.

Notification Received By When...
Project Object Delegation Notification Delegated user. A Project activity is delegated to the recipient.
Action Item Assignment Notification Assigned user. An action item is assigned to the recipient.
Project Owner Assignment Notification Project owner. The recipient creates a project from a template or is assigned ownership of a project during project creation from a template.
Assignment of an activity to a resource. Assigned user. An activity is assigned to the recipient.
Accept activity assignment Project Owner The assigned resource accepts the activity assignment.
Reject activity assignment Project Owner The assigned resource rejects the activity assignment
Project Object Delegation Accept Notification Project Owner A resource accepts an activity delegation.
Project Object Delegation Reject Notification Project Owner A resource declines an activity delegation.
Notification for Project Object Delegation Delegated user. A project activity is delegated to the recipient and must be accepted or rejected from the My Assignments tab.
Notification for Activity Object Owner Change New Activity Owner Ownership of an activity is changed on the General Info tab.
Pool Owner Project Delegation Notification Resource Pool Owner An activity (with or without child activities) is delegated to a resource pool.
Notification for Activity Assignment to a Resource Resource Pool Member An activity is assigned to the recipient.
Pool Owner Project Delegation Request Resource Pool Owner A child activity of a template project is delegated to the recipient's resource pool and must be accepted or rejected from the My Assignments tab.
Pool Owner Project Delegation Accept Notification Project Owner A resource pool owner accepts an activity assignment.
Pool Owner Project Delegation Reject Notification Project Owner A resource pool owner rejects an activity assignment.
Notification to Resource pool owner- Assignment of Activity Resource Pool Owner An activity is assigned to a resource in the recipient's resource pool. For proposed projects, this can be controlled using a SmartRule.
Gate Action Item Assignment Notification Assigned user An action item associated with a project gate is assigned to the recipient.
Gate Object Delegation Delegated user A project gate is delegated to the recipient.
Gate Object Delegation Accept Notification Gate Owner A user accepts a gate object delegation.
Gate Object Delegation Reject Notification Gate Owner A user rejects a gate object delegation.
Notification for Gate Object Delegation Delegated user A program gate is delegated to the recipient and must be accepted or rejected from the My Assignments tab.
Notification for Gate Object Owner Change New Gate Owner Ownership of a Gate is changed on the General Info tab.

2.1.2.13.6 Schedule Change Notifications
Notification Received By When...
Parent Project Schedule Change Notification Parent Program Owner The scheduled date of a parent activity is changed. Applies only when one or more baselines are created for the tree.
Predecessor Project Schedule Change Notification Successor Program Owner The scheduled dates of a predecessor activity is changed, resulting in changes to the scheduled dates of the successor activity.
Microsoft Project Sync Change Notification Program Owner Changes made to a PPM project from Microsoft Project are synchronized, resulting in schedule date changes. Applies only when one or more baselines are created for the tree.
Child Activity Reschedule Notification Activity Owner The scheduled date of a child activity is changed because of changes to the scheduled date of the parent activity. Applies only when one or more baselines are created for the tree.
Notification to Activity Owner for Project Schedule Date Change due to addition of Predecessor Activity Owner The Schedule Date of an activity has changed because it is now dependent upon a preceding activity.
Project Schedule Change Notification - addition of gate predecessor Activity Owner The Schedule Date of an activity has changed because it is now dependent upon a preceding gate.

2.1.2.13.7 Setup-related Notifications
Notification Received By When...
Project Creation Notification Project Creator Project creation is run as a background process and a new project is created successfully.
Activity Send Any user. An activity is sent to the recipient.
User Disabled Notification Resource Pool Owner A user who was assigned as a resource to an activity from the recipient's resource pool has been disabled by the system.

2.1.2.13.8 Workflow-related Notifications
Notification Received By When...
Project Status Promotion, Observers/Notifiers Designated observers or users on the Notify list. There is a change in activity status.
Project Status Promotion, Approvers Designated approvers. There is a change in activity status that requires approval.
Approve Project, Notifiers All users on the Notify list for the activity. The activity has been approved to move forward in the workflow.
Project Approve Activity, Add Approver Designated approver. The recipient is added as an approver for a project or activity.
Project Approve Activity, Add Observer Designated observer. The recipient is added as an observer for a project or activity.
Project Approve Activity, Remove Approver Designated Project Approver The recipient is removed from the list of approvers for a project or activity.
Project Activity Comment Program Owner A user has added a comment to an activity.
Project Activity Promotion Failure, Reject Program Owner A required approver rejects a project status promotion request.
Project Activity Promotion, Approve Program Owner A required approver approves a project status promotion request.
Gate Status Promotion Observers/Notifiers Designated Gate Observers There is a change in gate status.
Gate Status Promotion; Approvers Project /Gate Approvers There is a change in gate status that requires approval.
Project Approve Gate; Add Approver Designated Gate Approver The recipient is added as an approver for a gate.
Project Approve Gate; Add Observer Designated Gate Observer The recipient is added as an observer for a gate.
Project Approver Gate; Remove Approver Designated Gate Approver The recipient is removed from the list of approvers for a gate.
Project Gate Comment Program Owner A user adds a comment to a project gate.
Project Gate Promotion Failure Reject Program Owner A required approver rejects a gate status promotion request.
Project Gate Promotion; Approve Program Owner A required approver approves a gate status promotion request.

2.1.2.14 Workflow Routings Tab

The Home page Workflow Routings tab lists routable objects that require your attention. For example, your Workflow Routings table may contain tasks that you can choose to accept.

The workflow routings are a combination of base classes and actions that define the kind of attention on the routed object. In PPM, the routable objects are Activities or Gates in the Project Class.

The workflow routings tab consists of routable objects that require your:

  • Approval

  • Acknowledgment

  • Acceptance or Rejection

  • Review

  • Action

This tab includes features that allow you to review your routing objects quickly and efficiently. For detailed information on Workflow Routing tab, see the Getting Started with Agile PLM guide.

2.1.2.15 My Assignments

The Home page My Assignments tab lists Activities and Action Items for which you are responsible. The My Assignments tab provides a set of tools that allow you to efficiently work with your assignments. You can sort the assignments table rows, or select one or more assignment rows in the table, and then perform an action on the selected assignments. For example, you can accept or decline a project activity assignment, or flag an assignment for easier tracking.

The Home page My Assignments tab table includes:

  • Activity objects where:

    • The activity is In Process. The workflow status type is not Complete or Canceled.

    • The activity's Project State attribute is set to Active. Proposed or Template activities are not included.

    • You are the owner of the activity and the Delegated Owner field is blank. If you have delegated ownership, the Delegated Owner field contains the name of the delegated owner until the activity is accepted or declined.

    • You are the delegated owner of the activity.

    • You are a resource on the Team tab of the activity and your allocation is greater than 0%.

  • Action Items where:

    • The action item is assigned to you and it is not Complete or Canceled.

    • The action item is assigned to you and it has been accepted.

    • The action item is assigned to you and it has not been declined.

    • You are the creator of the action item and it has been declined by the assignee.

2.1.2.15.1 Project Assignments

Projects that display in your My Assignments tab are:

  • Active root-level projects that have no child objects, for which you are the owner.

  • Leaf-level projects for which you are the owner.

  • Projects that you have delegated to a resource from the Actions> Delegate menu.

The project is displayed until the assigned resource accepts the action item. Once the resource accepts the action item, it disappears from your My Assignments list and you receive a notification in the Notifications tab.

2.1.2.15.2 My Assignments Table

Your Agile administrator determines which columns appear in the My Assignments table. The displayed attributes can be enabled or disabled only through the Admin > System Settings > My Assignments node in Agile Java Client PLM Administrator. You can, however, rearrange or filter the defined columns as you want, using the Personalize option. If you have questions about the My Assignments tab, contact your Agile administrator.

By default, the My Assignments tab includes the following columns:

Column name Description
Flag Flag icon which you can set to manage your assignments. For more information, see "Flagging Assignments."
Activity Status The current status of the activity. For example, if you have not yet accepted the assignment, a Pending Acceptance icon is displayed here.
Name The name of the activity or action item. Click this link to open the activity or action item.
Status Workflow status of the activity or action item. For example, an activity can be Not Started or In Process and an action item can be Not Accepted, Accepted, or In Progress.

If you have the appropriate privileges, you can edit the Status column. For more information, see "Editing Assignments."

Due Date The date the activity or action item is due.

You can sort the assignment list by due dates. For more information, see "Using the View Options to Sort your Assignment List."

If you have the appropriate privileges, you can edit the Due Date column.

% Complete For activities, the percentage of the task that has been completed.

If you have the appropriate privileges, you can edit the % Complete column. For more information, see "Editing Assignments."

Related To For activities, the Related To column lists the parent activity and root parent activity.

For action items, the Related To column lists the activity or discussion object to which the action item is associated.

Click the links in this column to open the related activities or discussions.

Actual Hours For activities, the number of hours expended on the activity.

If you have the appropriate privileges, you can edit the Actual Hours column. For more information, see "Editing Assignments."


2.1.2.15.3 My Assignments Tab Tools

The My Assignments tab tools include:

Tool Description
Views Select a view from the dropdown list.

Use the list to sort your assignments by pre-defined views, for example, pending requests, flagged assignments, due dates, action items, or activities where you are a resource.

For more information, see "Using the View Options to Sort your Assignment List."

Print Prints the table.

Enables you to print the assignment table in the currently displayed sort order.

For more information, see "Printing the Assignment Table."

Accept Accept the selected activities, project activity assignments, or action items.

For activities, accept the ownership when you are the designated owner.

For project activity assignments, accept the assignment as a resource for the activity.

For action items, accept the action item when you are the assignee and the action item has not yet been accepted.

For more information, see "Accepting Assignments."

Decline Decline the selected activities, project activity assignments, or action items.

For activities, decline the ownership when you are the designated owner.

For project activity assignments, decline the assignment as a resource for the activity.

For action items, decline the action item when you are the assignee and the action item has not yet been accepted.

For more information, see"Declining Assignments."

Mark Complete Mark as complete the selected activities or action items.

For activities, sets the Complete field to 100% and changes the workflow status to Complete.

For action items, changes their status to complete and removes them from your assignment list.

For more information, see "Mark Assignments Complete."

More >

Add to Flagged View

Sets the flag for all the selected table rows.

Enables you to flag multiple rows simultaneously.

To display flagged rows, in the View dropdown list, choose Flagged.

For more information, see "Flagging Assignments."

More >

Add to Hidden Assignments View

Enables you to hide assignments.

Hidden assignments do not appear in the assignments table.

For more information, see "Hiding and Unhiding Assignments."

More > Remove From View Remove assignments from the Hidden view.

When displaying the hidden assignment view, this menu enables you to remove (unhide) the selected assignment rows.

More > Fill-down Copy the value from a cell to the corresponding cells in all rows following the selection.
More > Fill-down (selected cells) Copy the value from a cell to all the selected cells. The value of the first cell in the selection is copied into all the selected cells.
More > Fill-up Copy the value from a cell to the corresponding cells in all rows preceding the selection.
More > Fill-up (selected cells) Copy the value from a cell to all the selected cells. The value of the last cell in the selection is copied into all the selected cells.
Flag not set

Flag set

Flag icon appears in each row of the assignment table.

Set or unset the flag by clicking it.

The flag helps you to organize your assignments and mark the ones you want to track.

For more information, see "Flagging Assignments."

Quick View The Quick View callout appears when you place the mouse cursor over the name of the activity.

Click this callout to open a pop-up window that displays important details about the object and enables you to edit, accept, or decline the object. The content of this window is configured in Java Client Administrator.

For more information, see "Using the Quick View Dialog."


2.1.2.15.4 Using the View Options to Sort your Assignment List

Use the Home page My Assignments tab Views dropdown list to sort your assignments and quickly find the assignments with which you want to work. For example, you can sort for pending requests or for overdue assignments.

Agile PLM provides the following pre-defined view categories.

View Description
Base View* Displays all assignments, except hidden assignments.
Pending Requests Displays only pending requests.
Flagged Displays only the flagged assignment rows.

You set or clear flags to manage your assignments. This Views list choice displays only the rows that you have flagged.

Due Today or Overdue

Due this Week

Due within 2 Weeks

Due within 30 Days

Due within 90 Days

These Views list choices display assignment table rows according to due dates.
Hidden Assignments Displays only hidden assignments.

You decide which assignments you want to hide on your assignments list.

For more information, see "Hiding and Unhiding Assignments."

Activities where I am a Resource Displays activities where you have been assigned as a resource on the Team tab.
Action Items Displays action items assigned to you.

Action items are generated and assigned from activities and discussions.


2.1.2.15.5 Creating Personalized Views

The Personalize button enables you to create customized views of the content that is displayed in page tables. Once you create views, these are listed as options for your selection in the Views drop-down list. For details on using the Personalize options, see the Getting Started with Agile PLM guide.

2.1.2.15.6 Hiding and Unhiding Assignments

On the My Assignments tab of the Home page, the More > Add to Hidden Assignments View command enables you to hide assignment rows that you do not want to see. The assignments are still part of your assignment list, but they are displayed only when you choose Hidden Assignments in the Views dropdown list.

Hiding assignments can be a useful assignment management tool. For example, suppose you are assigned as a resource for an activity, but you are not the activity owner. You have completed your portion of the task, but other resources have not yet completed their portions of the task. Therefore, the assignment still appears on your My Assignments tab because it has not been marked as Complete. You can hide this assignment so it no longer appears on your assignments list. However, it will still appear on the assignment lists of other resources.

Hiding an assignment removes it from all your My Assignments tab views except your Hidden Assignments view. Your Hidden Assignments view has no effect on the assignment lists of other users. You can hide assignments (add them to your hidden view), display your hidden assignments, and unhide hidden assignments (remove them from your hidden view).

To add assignment rows to your Hidden View:

  1. Click the Home button to display the Home page.

  2. Click the My Assignments tab to display your list of assignments.

If desired, use the Views dropdown list or the filter to sort which assignment rows are displayed.

  1. Select one or more rows in the table.

  2. Choose More > Add to Hidden Assignments View.

To view your hidden assignments:

  1. Click the My Assignments tab to display your list of assignments.

  2. In the Views dropdown list, choose Hidden Assignments.

To remove assignment rows from your Hidden View:

  1. Click the My Assignments tab to display your list of assignments.

  2. In the Views dropdown list, choose Hidden Assignments.

  3. In the hidden assignments view, select the rows you want.

  4. Choose More > Remove from View.

2.1.2.15.7 Printing the Assignment Table

You can use the Print function in the My Assignments tab of the Home page to print the currently displayed assignments table. Use the View dropdown list or the Filter to sort the table, and then print the displayed table rows.

To print the My Assignment table:

  1. Click the Home button to display the Home page.

  2. Click the My Assignments tab to display your list of assignments.

  3. Use the Views dropdown list to sort the table to display the assignments you want.

  4. Click the Print button.

A printable version of the table is displayed in a new browser window and the Print dialog appears.

  1. Click Print in the Print dialog.

  2. Close the new browser window when you are finished.

2.1.2.15.8 Using the Quick View Dialog

On the Home page My Assignments tab, the Quick View tool tip (appears when you place the mouse cursor over the name of activity objects) opens a details dialog that displays additional information about the object and enables you to perform some actions on that object, for example, edit and delete. In the details dialog, the attributes that you can view and the actions that you can perform are determined by the roles and privileges that are assigned to you for that object type.

To configure Quick View dialog in PPM, see "UI Configuration Data."

2.1.2.16 Timesheet

The Timesheet feature helps Agile PPM customers address critical business needs, such as the accurate calculation of resource time and associated labor costs for a project. This feature helps authorized users to do the following:

  • Record the number of hours worked against each assigned task, on a daily or weekly basis.

  • View and administer all timesheets recorded in the system.

  • Derive resource time data for reports and analysis.

Timesheet entry and management is restricted by certain role, privilege, and SmartRule settings in Java Client. For details, see the Agile PLM Administrator Guide.

2.1.2.17 Timesheet Tab Tools

Tool Description
More >Print Prints the selected timesheets. Click More > Print to print the timesheet.
More >Timesheet Search Enables users with appropriate privileges to search and view all timesheets recorded in the system. Click More > Timesheet Search to search for time sheets. For more information, see "Searching for Timesheets."
More > Fill-down Copy the value from a cell to the corresponding cells in all rows following the selection.
More > Fill-down (selected cells) Copy the value from a cell to all the selected cells. The value of the first cell in the selection is copied into all the selected cells.
More > Fill-up Copy the value from a cell to the corresponding cells in all rows preceding the selection.
More > Fill-up (selected cells) Copy the value from a cell to all the selected cells. The value of the last cell in the selection is copied into all the selected cells.
Views Enables you to select from a list of defined timesheet views. You can create views using the Personalize options.
Personalize Click Personalize to set the Table filters. You can configure the timesheet display to show selected attributes such as the associated activity's Name, Number (manually created or auto-generated activity number), Description, Parent, Parent Number, or Root Parent.

If you have privilege to view timesheets of other users, you can create a View to configure and view other users' time sheets.

This filter works the same as in My Assignments. For detailed information about using the filter, see the Getting Started with Agile PLM guide.


2.2 Project Page

The project page opens when you click any project object. From this page, you can record and update information such as schedule, cost, status, resources, content, and discussions about the project.

From the project page, you can:

2.2.1 Viewing Project Details

The Details View is displayed by default if you click a project object that is at the lowest level in the hierarchy (no sub-activities). If you click an object that has sub-activities, it opens in the Summary view. The Summary view is not available for objects without sub-activities. While viewing a project, you can click the Details View or Summary buttons to toggle between the two views.

You can view and manage project-related objects from the following tabs or pages within the Details View.

Tab Tasks
General Info View and edit general information about the project, including activities, status, and other attributes configured in Administration. See "Viewing General Information."
Schedule Manage the schedule of individual activities within the project, create baselines, and analyze the impact of changes. See "Managing Schedules."
Dependencies Create and manage dependencies between various project-related activities. See "Creating and Editing Dependencies in Web Client."
Team Manage resources for a project. See "Managing Resources."
Content View and manage all project-related content, including deliverables. See "Managing Content."
Workflow View workflows and sign off, and assign approvers, observers, and notifiers as necessary.
Collaboration Create or join project-related discussions, view action items, share news and information. See "Managing Discussions."
Attachments View, edit, and manage attachments that are required for project execution. See "Working with Attachments."
History View project history. See "Viewing History.".

2.2.2 Viewing Project Summary

When you first open a project which has sub-activities the Summary view displays. (If the project you open does not have sub-activities, then the Details view appears.) The Summary view is a consolidated view of project information. Executives, task owners and project managers can use this page to quickly review current information, status, and health of a project. This view can comprise all parent-level objects (projects, phases, and tasks) that have child activities. This view is not available on leaf-level activities and gates.

The Summary page contains several 'widgets'. Each widget provides users with customized information and action buttons for a specific aspect of the project, as configured by an administrator. For example, a Project Gates widget may provide users visibility into the status of the project gates (milestones) for that project and deliverables associated with those gates. An Upcoming Activities and Action Items widget may list upcoming activities and provide an Add button that you can use to add an action item to be performed for an activity.

To configure the Summary view, you need appropriate privileges. For details on privileges and summary page configuration steps, see the Agile PLM Administrator Guide.

Figure 2-1 Project Summary Page

Project Summary Page

2.2.2.1 Summary Page Actions

You can perform the primary actions required on the project directly from the Summary view.

Most widgets contain links to the listed objects. You can use these links to navigate to the appropriate tab of the object and perform necessary actions. For example, in the Project Gates widget, you can click the name of the Gate to modify the details.

The contents of each widget and the actions that you can perform within each are explained in the table below.

Widget Description Actions Available
Project Summary A quick overview of the project. Displays data for attributes associated to project activities, as configured by an administrator. Examples of the attributes are Name, Description, Status, Scheduled Start date, and Scheduled End date Add image - Insert an image file from your local drive. Click Add Image to browse and select an image file from your local drive. The image file is automatically resized if it exceeds the allotted space and resolution.

Replace Image - Replace the current image file with another.

Image editing options are available only to root project managers, and only on the root project.

Edit - Edit the attribute values displayed within the widget. You must have Modify privilege to edit these values. For details, see the Agile PLM Administrator Guide.

Upcoming Activities and Action Items Helps you keep track of immediate requirements. Lists project activities and action items that are either overdue, or will be due within a specified time frame. You can view leaf-level project objects (including gate sub-classes) that are in Not Started or In Progress states, and Open Action Items associated to the Activity being viewed and its child activities. Table columns are sortable; by default these are sorted by Due Date. Add Action Item - Create a Action Item for the activity being viewed currently. Click Add Action Item to open a dialog where you can create the new action item.

Show -Filter the list using the options within the Show drop-down list to display upcoming action items and activities, or items that need your immediate attention. For example, you can use the My Activities and Action Items list item to filter the list by items for which you are the assigned owner. After selecting an option, you can additionally narrow down the results by entering a number in the due in - days field. The default value in this field is 7 (days).

Recent Discussions Displays a list of recent, open discussions that occurred within a specified time frame. When you click a row to select a discussion, the discussion thread displays in the bottom pane of the window as a preview. Add - Create a discussion to be associated with the current Activity. Click Add to open the Add Discussion wizard and enter discussion details. You can select the list of users you want to include in the discussion and notify them.

Join - Join an existing discussion. Select the row of the discussion you want to join and click Join to join the discussion.

Reply - Reply to a discussion message. Click Reply on the right-hand side of the selected discussion row to open a dialog where you can enter your response. You can edit the subject of the message if you want. By default, the response will be sent to all users currently included in the discussion. You can edit the Notify List field in the dialog to change the list of users who will receive the response.

Project Gates Displays the list of Gates and their due dates.

If you have created multiple Gate subclasses to establish milestones, you can configure this widget to display the Gate subclasses you want to view. For details, see the Agile PLM Administrator Guide.

Quick Navigation - Click the name of a listed gate to navigate directly to the General Info tab view of that gate.
Important Content Displays a list of content objects that were added to the Important Content view from the Content tab. See "Working with Project Content." Quick Navigation - Click the content object name to navigate directly to that General Info tab for that object.
Project News Displays project-related news to keep team members and resources informed about project information. Add - Click Add to open a dialog where you can create a news item related to the activity currently being viewed. You can add a subject and news text.

Remove - Select a news item and click Remove to remove it from the widget. You can multi-select items in the list to remove them.

Team Contact Info. Displays the team members associated with the selected activity and provides contact information for those team members. Click the name of the team member to navigate directly to the Team tab of the current activity.

Send Email - Send a notification to a team member whose name appears as an attribute within the widget. Click the Email icon next to the username to open a comments dialog box, where you can enter comments and then send these as a notification to the team member.


To toggle between the summary view and a detailed view of the project, click Summary or Details View as appropriate.

2.2.3 Viewing General Information

The General Info tab contains Activity and Status information, and displays information for the fields listed in the table. Fields which contain information that is compiled or rolled up from other fields are not editable.To edit fields, click the Edit button. You can make changes in the editable fields, and click Save to save the changes, or click Cancel to exit without saving.

Field Contains...
Schedule Information that enables you to quickly track program progress. Displays the targeted start and finish dates. Also displays the total duration between the targeted start and finish dates.

The default Start time stamp is 08:00:00 A.M and default End time stamp is 05:00:00 P.M. However, you can manually edit the End time stamp, if required.

You cannot edit the Start time stamp to a value lesser than 08:00:00.If you create the project at 07:00:00 A.M, the Start time stamp displays 08:00:00A.M.

The value of the default time stamp is based on the value set for Working hours configuration in the configuration file (agile.properties) during Agile PLM installation.

Estimated Information that enables you to track when overdue items will be delivered.
Actual Actual varies from schedule if you are ahead of or behind targeted project dates.
Variance in Work Days Start Variance, Finish Variance, and Duration Variance are displayed for Estimated, and Actual dates, compared with Scheduled dates. Variances are displayed in either Work Days or Calendar Days, or both Work and Calendar days.

Your Agile administrator determines which information is displayed in the summary table on the General Info tab.

Number The Autonumber assigned to the project object.
Activities Type Displays whether the activity is a project, program, phase, or task.
Owner The project owner.
Name The name of the activity.
Description Text that describes the project. The maximum length is set by the Agile administrator.
Root Parent A link to the root parent object.
Parent A link to the parent object.
Project State Indicates the type: Active, Proposed, Template. Only an active project can undergo changes in workflow status.
Audit Score The audit score for the activity. See "Audit Values."
Weight Weight assigned to the activity.
Weighted Score A calculated score based on the audit score times the weight.
Status Indicates the workflow status of the project.
Rollup Health Status Indicates whether the health status rollup is selected or not.
Cost Status Denotes the cost status for the activity. This value is a selected value for the leaf object and a rolled-up value for a parent object.
Resource Status Denotes the resource status for the activity. This value is a selected value for the leaf object and a rolled-up value for a parent object.
Quality Status Denotes the quality status for the activity. This value is a selected value for the leaf object and a rolled-up value for a parent object.
Lock User Name of the user who is currently using Gantt Chart or Microsoft® Project to modify the project. When a user launches either Gantt Chart or Microsoft Project, the activity is automatically locked to prevent any other user from editing the project in PPM.
Workflow Identifies the object's assigned workflow.
Schedule Status The schedule status of the activity.
Overall Status An overall status of the activity. This value is calculated based on either selected or rolled up-values for cost, resource, quality, and schedule. It denotes the worst of these status values (cost, resource, quality, and schedule).
Project Type Dashboard field. May be renamed during implementation.
Region Dashboard field. May be renamed during implementation.
Division Dashboard field. May be renamed during implementation.
Product Line Dashboard field. May be renamed during implementation.
Customer Dashboard field. May be renamed during implementation.
Launch Year Dashboard field. May be renamed during implementation.
Global Controls whether the project is available to all executives or not.
Actual Labor Cost The Labor cost incurred on the project as on date, based on the actual work done on the project.
Budgeted Labor Cost The intended Labor cost for the project.
Estimated Labor Cost to Completion The cost of Labor for the entire project which is calculated based on the change in Project cost or plan, as the project progresses.
Actual Fixed Cost The Fixed Cost incurred on the project as on date, based on the actual work done on the project.
Budgeted Fixed Cost The intended Fixed cost for the project.
Estimated Fixed Cost to Completion The fixed cost for the project which is calculated based on the change in the project costing or plan as the project progresses.
Actual Capital Expenses The capital expenses incurred on the project as on date.
Budgeted Capital Expenses The intended capital expense limit on the project.
Estimated Capital Expenses to Completion The estimated capital expenses for the project which varies based on any change in the fixed assets of the project.
Actual Time (In Days) Days Effort is calculated at the rate of 8 hours per day and displayed as Actual Time (In Days). Each day is calculated as a bucket of 8 hours. For example, if actual hours worked is 24, Actual Time (In Days) is calculated as 3 days. If actual hours worked is 25, it is calculated as 4 days.
Budgeted Time (In Days) The preallocated time in days for a project to reach completion.
Estimated Time to Completion The approximate time that is required for the project to reach completion, by the progress in project.
Category fields Fields that are configured by the administrator. There are 25 Category fields. The last category field is assigned to the criteria called 'All Programs', by default. The user can create a project and link it to a specific program. This linking helps to consolidate information from multiple projects associated with the same program.

These Category fields are not available for Users and User Group objects.

Schedule Editor Indicates the source of schedule editing for this project: PPM or MSP (Microsoft® Project). This is automatically set to MSP when you launch a project into Microsoft Project. When set to MSP, the PPM project does not change dates and duration programmatically. This ensures that when the project is published in PPM from Microsoft® Project, the project dates are correct in PPM.
Actual Flex Cost A cost field that is configured by the administrator. Actual cost reflects the cost incurred on the project as on date.
Budgeted Flex Cost A cost field that is configured by the administrator. Budgeted cost reflects the intended cost for the project.
Estimated Flex Cost to Completion A cost field that is configured by the administrator. Estimated cost reflects the cost that keeps varying based on any change in the project cost or plan as the project progresses.
Critical Indicates whether the activity is on the critical path.
Total Actual Cost Sum of all the actual costs.
Total Budgeted Cost Sum of all the budgeted costs.
Total Estimated Cost to Completion Sum of all the estimated costs to completion.
Created from Template Name of the template from which this project is created.
PLM Reference Any object that you want to add as a reference to the project. This object also appears in the Content tab of the project.
Project Keywords Keywords that are associated to the project. You can configure the project summary page to display important content by these project keywords.
Functional Team(s) Lists any functional teams you have associated with the activity for workflow routings.
Integration details (Appears only if RMW is installed.)
Scale Factor Indicates the number by which the BOM quantity should be multiplied for commercial production.
Operating Mode Defaults to Clinical Supply.
Integration Message Provides information about the integration, or reason for failure.
Integration Status Indicates whether the PPM object was successfully synced to RMW.
Internal ID ID of the synced object in the RMW database.

To edit the information in the General Info tab:

  1. Click Edit on the General Info tab of a project object.

  2. Modify the editable fields.

  3. Click Save.

2.2.3.1 Dates

Within Agile PPM, dates are displayed in your preferred date format, but there is no time zone conversion applied for dates such as Schedule Start Date, Schedule End Date, Actual Start Date, Actual End Date, Estimated Start Date and Estimated End Date.

Date values that you enter are stored in Greenwich Mean Time (GMT) and displayed without the time zone. For example, if you enter a date value of 10/10/2009, the system stores the date in the database as 10/10/2009 00:00:00 GMT.

Page Two, Page Three, Workflow, and History dates are displayed in user-preferred time zones.

2.2.3.2 Duration

Objects within a project can have different duration types such as:

  • Fixed duration - The object takes a defined period, for example, five days. For Fixed duration, the Days Effort is calculated as the Scheduled Duration times the sum of the % Allocation of all resources. You can also create a zero duration activity by selecting Fixed Duration and setting Zero as the Days Effort.

  • Effort driven - The Days Effort of the object is fixed, but the number of resources assigned affects the Scheduled Duration. For Effort Driven Duration Type, the Scheduled Duration is calculated as the Days Effort divided by the sum of % Allocation of all resources.

If a parent changes to a leaf node object (an activity with no children) then the Duration type changes from 'Calculated' to 'Fixed'. The Duration remains the same as it was when it was the parent. If the parent object had resources, Days Effort is calculated based on the percentage allocation of the Resource/Groups assigned to the Team tab. If there are no resources, the Days Effort is the same as the Scheduled Duration.

2.2.3.3 Audit Values

The General Info tab of activities contains the following audit values:

  • Audit Score - The value assigned to each object in a project by an auditor during an audit, based on performance indicators.

  • Weight - A value that reflects the importance of the individual object compared to other objects in the entire project.

  • Weighted Score - A value calculated by multiplying the values in the Weight and Audit Score fields.

2.2.4 Working with Attachments

Attachments to Agile business objects contain pertinent information about the object in addition to the information recorded on the object tabs. Examples of attachment files are:

  • Drawing files such as CAD drawings or scanned image files in viewable formats

  • Web-based information in the form of URLs

  • Project specifications and other documents

  • Non-viewable files, compressed files, and so on


Important:

As a best practice, it is recommended that the attachments tab in Agile PPM activities and gates be disabled. Agile PPM provides a unique tab, the Content Tab, that you can use for all project content, including attachments.

For more information on working with attachments, refer the Getting Started with Agile PLM guide.

2.2.5 Collaborating on Project Activities

The Collaboration tab enables you to manage project-related discussions, action items that result from the discussions, and news items. You can also add and view these objects in the Project Summary page.

Figure 2-2 Collaboration Tab

Collaboration tab

The Collaboration tab has the following views:

  • Discussions - Enables you to initiate, join, reply to, or remove a discussion. The Notifications tab in your Home page displays all the discussions notified to you. For further information on managing discussions, see "Managing Discussions."

  • Action Items - Enables you to manage the action items. You can add, remove, accept, or decline an action item. In addition, you can mark the action item 'Complete'. The Action Items which you add in this tab appear in the My Assignments tab of the assignee's Home page. You can view these action items in the Upcoming Activities and Action Items widget of the Project Summary page.

For further information on working with Action items, see "Viewing Action Items."

  • News - Enables you to add and remove news or announcements specific to the project. You can also add and remove news items on the Project Summary page.

2.2.6 Viewing History

The History tab records all actions taken, such as editing the General Info tab or changing activities or team members.

If you do not have the appropriate read privileges, you cannot view the fields on the History tab. If you have questions about your privileges, see your Agile administrator.

2.2.7 Actions Menu

The Actions Menu consists of the following options in addition to the standard PLM menu commands such as Bookmark, Subscribe, Save As and Delete.

Menu Description
Gantt Chart Click Gantt Chart to view the Gantt Chart view of the project. For more information on working with Gantt, see "Gantt Chart."
Delegate Click Delegate to delegate the project to a different owner. For more information on delegating ownership, see "Delegating Ownership."
Substitute Resource Click Substitute Resource to replace a resource in the project team. For more information on substituting resources, see "Substituting Resources."
Change Parent Click Change Parent to modify the root parent of the project.
Make This a Root Activity In the project or phase within a project, select Make this a root activity to start a new project. This change modifies the existing dependencies.
Compare Baselines Click Compare Baselines to view a comparison between two project baselines. For more information, see "Comparing Baselines."
Microsoft® Project The entries in this menu enable you to launch the existing PPM project in Microsoft Project. In addition, you can save the existing PPM project as an XML file. For more information, see "Working with Microsoft Project."
Complete Click Complete to modify the status of the project to 'Complete'.
Change to Canceled Click Change to Canceled to modify the status of the Project to 'Canceled'.
Reports and Analytics The entries in this menu enable you to obtain reports on Project Resource Utilization and Schedule. For more information, see "Reports."
PPM Sync to RMW (appears if RMW is installed) Click PPM Sync to RMW to update the RMW database with projects and work requests created in PPM.

2.2.8 Address Book Palette

To search for a user group:

  1. Click to open the address book palette.

  2. Choose User Groups in the address book palette dropdown list.

  3. Type the user group object search criteria that you want to use.

  4. Click the Execute a Quick Search button.

  5. In the palette search results table, select the user group row or rows you want:

    • Double-click a row.

    • Select one or more rows and drag them to the field that you are modifying.

  1. Press the Escape key to close the address book palette.

To search for a user within a user group:

The Search within a User Group option becomes available when the number of user groups in the Agile PLM system exceeds 200.

  1. Click to open the address book palette.

  2. Choose Search within a user group in the address book palette dropdown list.

  3. In the Select a user group to search within popup, type the name of the user group you want or click to search for a group.

  4. When you have selected a user group, click OK in the popup.

Agile PLM adds the group name to the address book palette dropdown list. Agile PLM continues to add group names to the palette dropdown list until the number of groups equals twenty. As additional groups are added to the list, Agile PLM removes the oldest entries from the dropdown list. A maximum of twenty groups that you recently selected for the Search within a user group option remain on the dropdown list.

Alternately, you can use the address book palette dropdown list to select one of the user groups that you have selected recently.

  1. Type the user object search criteria that you want to use.

  2. Click the Execute a Quick Search button. The search is restricted to the members of the selected group.

  3. In the palette search results table, select the user row or rows you want:

    1. Double-click a row.

    2. Select one or more rows and drag them to the field that you are modifying.

    3. Press the Escape key to close the address book palette.

To search for users:

  1. Click to open the address book palette.

  2. Choose Users in the address book palette dropdown list.

  3. Type the user object search criteria that you want to use.

  4. Click the Execute a Quick Search button.

  5. In the palette search results table, select the user row or rows you want to add:

    1. Double-click a row.

    2. Select one or more rows and drag them to the field that you are modifying.

  6. Press the Escape key to close the address book palette.

2.3 Gantt Chart

The Gantt Chart feature is a powerful project management tool that helps project managers plan, administer, and track projects from start to finish. With Gantt, you can create a project and then plan the work breakdown structure for this project, which includes defining activities and tasks, creating dependencies between tasks, and performing resource management.

The Gantt Chart offers rich user-friendly features (such as Excel-like data editing) to manipulate and view data in graphical or tabular formats. Multiple view options enable you to focus on discrete project aspects, and right-click menus help you to quickly take actions on selected project objects.

The default Gantt view consists of a menu bar, standard toolbar, a tabular activity pane and a graphical activity pane. The tabular activity pane provides a hierarchical tree structure representation of all activities and the graphical pane provides a graphical representation of activities with color and iconic indicators.

Figure 2-3 Gantt Chart

Gantt Chart

2.3.1 Prerequisites

Ensure that you have the appropriate privileges to perform project management activities within the Gantt Chart. If you have questions about your assigned roles and privileges, contact your Agile administrator.

The Gantt chart uses Java Web Start technology and requires Java Runtime Environment (JRE) to be installed on your computer. If the recommended JRE does not exist on your system or if you have a lower version installed, you are prompted to install the latest JRE version. For information on recommended JRE, see Agile PLM 9.3 Release Notes.

If certain firewalls prevent this automatic download, you can download and install the appropriate JRE version from the URL: http://www.sun.com.

2.3.2 Modes of Operation

The Gantt chart operates in three modes:

  • Connected - Requested data is obtained directly from the server.

  • Disconnected - Requested data is obtained from the installation folder. If the server is not available, Gantt switches to this mode. Once the server becomes available, it switches back to Connected mode.

  • Offline - Requested data is retrieved from the installation folder. The server is assumed to be unavailable.


Note:

The Gantt chart opens in the mode it was set to when you last worked on it. If the Gantt Chart was set to Offline mode in your last session, it opens in Offline mode when you next try to launch a project from Web Client. The requested project cannot be opened as the system assumes server unavailability. Instead, a new default project is launched. To open the project you wanted, change the mode from Offline to Connected, and then launch the project again from Web Client.

2.3.3 Launching Gantt

To launch the Gantt Chart for a project, open the project and select Details View > Gantt Chart.

If your project has sub-activities, you can also select Actions > Gantt Chart from the Summary view.

When you start the Gantt Chart, Java JAR files are downloaded into your computer's temporary files folder. Once these are loaded, the Gantt Chart appears.

2.3.4 Launch Options

You can launch the Gantt Chart from Web Client using any of the following options:

  • Full Lock Mode - Locks the current activity and all its lower-level activities, including dependent activities in other projects. Open in this mode to make overall schedule changes that should overwrite information in related projects.

  • Internal Lock Mode - Locks the current activity and all its lower-level activities within the project. Dependant activities in other projects remain unlocked and can be edited. Be aware that scheduling changes that you make may affect the schedule of dependent activities in other projects. Open in this mode to perform changes that are not related to schedule.

  • Read Only mode - Enables you to view but not edit data. Open in this mode to view or monitor projects without making changes.

When you open a project from within the Gantt Chart, it opens in Full Lock Mode.

2.3.5 Launching Gantt Using Shortcuts

During Gantt download, you are prompted to confirm whether you want shortcuts to the Gantt application to be installed on your Desktop and Start menu. Click Yes to confirm. These shortcuts are especially useful when you want to work on Gantt offline.

To launch Gantt from the Desktop, double-click the Gantt icon. To launch Gantt from the Start menu, choose Programs > Oracle | Agile PLM and select the Gantt application. Once you have saved a Gantt Chart Exchange (.gcx) file on your system, you can simply double-click the file to launch the Gantt Chart.

2.3.6 Gantt Toolbar

Most actions on the Gantt chart can be performed using the icons on the toolbar or corresponding keyboard shortcuts. When you place your mouse pointer over an icon, the shortcut key appears next to the name of the icon.

Function Shortcut Keys Description
Cut Ctrl+X Cuts a selected cell value, activity or gate.
Copy Ctrl+C Copies a selected cell value, activity or gate.
Paste Ctrl+V Pastes the cut or copied cell value, activity or gate.
Open Ctrl+O Open Activities or Gates.
Save Ctrl+S Saves changed information in the Gantt.
Activity Insert Inserts an activity below the selected activity, at the same indent level.
Gate Alt+G Inserts a gate below the selected activity, at the same indent level.
Delete Delete Deletes the selected item from the Gantt Chart.

To select an activity for deletion, highlight or select the whole row.

Create Dependency Alt+C Adds a dependency.
Edit Dependency Alt+D Opens the Edit Dependency dialog for the selected dependency.
Go To Selected Task Ctrl+G Brings the corresponding graphic into view.
Outdent or Move Left Alt+Shift+Left Outdents an item, so that a project element no longer reports to the higher-level element.

Moves the selected item or items to the left.

Indent or Move Right Alt+Shift+Right Indents an item, making a project element report to another item.

Moves the selected item or items to the right.

Move Up Alt+Shift+Up Moves an item up to change the order of the listed items at the same level. If project elements report to that item, these move along with it.
Move Down Alt+Shift+Down Moves an item down to change the order of the listed items at the same level. If project elements report to the item, these move along with it.
Expand All Ctrl+E Expands the Project tree structure to view all the activities within.
Collapse All Ctrl+Q Collapses the Project tree structure to hide all the activities in the tree.
Zoom In Ctrl+Plus (NumPad) Enlarges the graphical pane view.
Zoom Out Ctrl+Minus Reduces the graphical pane view.
Zoom To Fit Ctrl+0 Changes the size of the graphical pane to show the entire project within the visible area.
Manage Resources Alt+F10 Enables you to select and manage resources for the selected activities.
Delegate Owner Alt+F12 Enables you to delegate the ownership of the selected activities.

2.3.7 Views in Gantt

Gantt supports the following views:

  • Gantt

  • Task Assignment

  • Calendar

  • Critical Path

  • Comparative Gantt

  • Resource

  • Resource Sheet

  • Resource Utilization

2.3.7.1 Gantt

The Gantt view is the default view. This view displays the project activities and schedules in a combination pane. One pane displays a tabular view of activities in a hierarchical tree structure. The other displays a graphical view of activities in a bar graph format.

2.3.7.2 Task Assignment

The Task Assignment view is a combination view of the Gantt Chart in the top pane and the Manage Resources sheet and Resource Utilization chart in the bottom pane. When you select an activity in the Gantt view, resource information about the task appears in the Manage Resource view. You can simultaneously view the resource utilization of each resource in a graph format in the Resource Utilization pane.

2.3.7.3 Calendar

The Calendar view enables you to create, edit, and review your project tasks in a calendar format. The Calendar view consists of two tabs, Month and Day. The Month tab displays a monthly view with all the days in the month. The Day tab displays a day view with all the hours in the day.

The Calendar view is helpful to view tasks that are scheduled on a particular day, week or month. It shows tasks schedules for a specific week or range of weeks. You can create a project by entering a task and the duration of a project using the calendar format.

2.3.7.4 Critical Path

Critical path view helps you plan all activities that directly affect the completion date of a project. Critical Path is determined by identifying all the activities that have slack, below a pre-determined number of days.

Critical path activities act as the basis for creating a schedule and planning resource allocation. It helps you analyze where a remedial action is required to get a project back on track. Critical path can be viewed at activity and sub-activity level. The critical task is the current activity on the critical path.

If a schedule is on a critical path, the schedule bar on the graphical pane appears red.

2.3.7.5 Comparative Gantt

The Comparative Gantt view helps you compare the current project schedule against estimated or actual schedules, or against a saved baseline. To view a comparison, select an option from the drop-down list in the main toolbar. The default comparison value is Estimated. All saved baselines display in this list for selection.

In the graphical view:

  • The Current schedule of a parent displays in orange.

  • The Current schedule of a child activity displays in pink.

  • The Estimated, Actual, or Baseline schedule of the parent activity displays in white.

  • The Estimated, Actual, or Baseline schedule of selected child activities displays in gray.

In the tabular view, you can view baseline schedule information (start and end dates) in columns alongside current schedule information.

2.3.7.6 Resource

The Resource view displays a list of all users for a particular project and their task allocation according to the schedule, in a calendar format. If you assign an allocation to a user, you will be able to view a bar graph in the pane below displaying the percentage of allocation. You can also select the topmost row - All Users - to view a bar graph of all resources simultaneously.

In this view, you can also update task assignments to balance resource workload. For instance, if a user has been assigned two tasks in the same time period, causing overloading, one of the tasks can be postponed or reassigned. The Project Manager or Resource Pool Manager can move the task to another time period or to another user using a simple drag-and-drop action. The Gantt data is updated immediately, and synchronized to the server when saved.

2.3.7.7 Resource Sheet

The Resource Sheet enables you to view available resources and add selected resources to your project. The Resource Sheet contains a set of users who are associated with the activities within a project. Adding resources to a Resource Sheet reduces duplication and maintenance of resources. You can access the Resource Sheet from View > Resource Sheet.

The Resource Sheet view contains fields with relevant user information such as Title, Business Phone, Email, Status, Assigned from Pool, and so on. You can review, add, or edit information on each resource. You can quickly create a resource list for your project by adding the name of each resource and their related information. A resource can be an individual, a company or department, a piece of equipment, a room, or any other resource that you are using for your project.


Note:

Simultaneous updates to the Resource Sheet by different users are not supported. Updates to the resource sheet are saved independently of Gantt chart updates.

2.3.7.8 Resource Utilization

The Resource Utilization view displays all the resources and the tasks assigned to each resource. It displays the tasks and task allocations from other projects in PPM as well. You can view the following information for each resource or resource group in this table:

  • Name

  • Pool Name

  • % Allocation

  • Schedule Start

  • Schedule End

To format columns in the report:

  1. Choose Format>Preferences.

  2. Within the Preferences dialog that opens, in the Columns tab, select the columns you want to display.

  3. Use the arrow buttons to move selected column names from the Available Columns list to the Selected Columns list.

  4. To rearrange the order in which the columns display, move them up or down in the list using the up and down arrows.

  5. To hide or show gridlines, select the appropriate check boxes for Horizontal and Vertical.

  6. Click OK to apply your changes.

2.3.8 Customizing the Gantt Chart

The graphical and tabular display of data within the Gantt Chart can be customized based on your preferences. You can configure the display of columns, grids, bar labels, appearance, and styles using the options in the Format menu.

You can configure the columns to display Page One attributes - the options that are made available in these fields are configured in the Java Client General Info attribute settings.

2.3.8.1 Setting Preferences

You can customize column display and set other preferences such as preferred file download location, as described further.

To customize column display:

  1. Choose Format > Preferences.

  2. Within the Preferences dialog that opens, in the Columns tab, select the columns you want to display.

  3. Use the arrow buttons to move selected column names from the Available columns list to the Frozen or Non-Frozen columns list as desired. The Non-Frozen column displays all the visible columns in the tabular activity pane.

  4. Click OK.

To freeze, unfreeze, or hide one or more columns:

  1. Within the tabular view pane, select the column or columns.

  2. In the right-click menu, select Freeze Column, Unfreeze Column or Hide as appropriate.

Within the Columns tab of the Preferences dialog, you can use the and arrow buttons to sort the order of the displayed columns. Alternatively, you can click and drag a column in the tabular view pane to change its location.

To set preferences for offline mode:

  1. Choose Format > Preferences.

  2. Within the Preferences dialog, select the Advanced tab.

  3. In the File Location field, browse and select the folder to which you want your files downloaded for offline access. The default location for file downloads is your My Documents folder.

  4. In the Project Name field, you can enter a default value for activity names. For example, if several of your projects start with the same name, say 'ABC Project V.1', 'ABC Project V.2', 'ABC Project V.3' and so on, you can enter 'ABC Project' in this field so that you only need to change the rest of the name.

  5. Select other options as appropriate:

    • If you select Yes for the Download Page Two and Page Three field, this information gets downloaded when you are in Online mode, and can be saved for offline activity. If you select No, this information is loaded only if you choose to view the properties of a selected activity.

    • If you select Yes in the Display Locked Projects on Exit field, a dialog appears when you exit Gantt, where you can view the list of projects that are locked by you. You can then choose to unlock activities that other users may need to access.

  6. Click OK to exit the Preferences dialog.

  7. In the Format menu, click Save Settings to save your preferences. The next time you log in, these settings are maintained.

2.3.8.2 Appearance and Style

To customize the appearance of your Gantt Chart, choose Format > Appearance and choose a theme.

To change the graphical view style, choose Format > Styles and choose a style.

2.3.8.3 Bar Labels

You can select the text to be displayed on the bar graphs on the graphical view pane. The information is displayed in relation to the task, project or phase corresponding to the bar graph. Choose Format >Bar Labels and select labels.

2.3.8.4 Grids

You can also customize the display of grids and rows in your graphical view.

Once you have made changes to any of the format settings, select Format>Save Settings from the menu bar to save changes.

The Save Settings command does not save changes to the Grid.

2.3.8.5 View Bar

The View Bar is a pane that is displayed on the left of the Gantt Chart and enables you easy access to view the different type of Gantt views. The Gantt view types are displayed as icons and you can click the icon to display the view. The default setting for the View Bar is Enabled. To disable it for a particular session, click View and select View Bar.

A check mark next to the View Bar option indicates that the view bar is enabled.

2.3.9 Gantt File Menu Options

The File menu in the Gantt Chart offers the following options:

Menu Command Action
New Creates a new root project with default project data.
Open Opens a search window where you can locate and open projects from the server. You can search by Root Project, Root Template, Activities, Gates, or All Project. Available only in online mode. The search criteria you last used appears by default in the Find From field.

When you search by Activities or Gates, parametric search options become available if corresponding attributes have been enabled in Java Client. Click Options to view parametric search fields and specify criteria.

Open File Helps you search and locate a saved GCX (Gantt Chart Exchange) file on your hard drive. If you saved a folder location as a preference in the Advanced tab of the Format > Preferences dialog, this folder is opened. If the current project was opened using a GCX file stored in a particular folder, that folder is opened.
Save Saves the project to the server. Saved data includes: Page One, Page Two, Page Three, Schedule, Dependencies, Team, and Resources.
Save File Saves the project to your hard drive. Saved data includes all activities, dependencies, resource sheet, activity states, and any modifications made after you last saved the project.
Save As Saves the project to the server under a different name. Saved data includes: Page One, Page Two, Page Three, Schedule, Team, and Resource Sheet. Content (from the Content tab) is not saved.
Save As File Saves the project to your hard drive under a different name. Make sure you change the name of the root project so that you do not update an existing project on the server inadvertently.
Recent Files Displays a list of up to 10 files that were recently opened from the hard drive.
Work Offline When selected, switches the Gantt to offline mode, regardless of server availability. To return to online mode, select this option again. Connection status is displayed at the bottom right corner of the window.

2.3.10 Working Offline on Gantt

You can use the Gantt client as a standalone application on your computer and continue working on the Gantt chart even when you are not logged into Agile PLM. This feature enables you to do the following:

  • Continue working on a project while traveling or during server downtime.

  • Create a preliminary draft of a project and make it available online only when you want other users to see it.

  • Email a saved project to others for opinions and updates.

The first time you launch a Gantt chart from Web Client, you are provided the option to save a shortcut to the Gantt chart on your desktop. Once you save the shortcut, you can use it to launch Gantt and work on it offline.

2.3.11 Unlocking Projects before Exiting

When you close the Gantt Chart after working on it in Offline or Disconnected mode, the projects that you opened from Gantt remain locked. To ensure that projects used by others are unlocked for their use, you are prompted to unlock projects before you exit. Within the Unlock Projects dialog that appears, select the projects that you want to unlock for the use of others and click OK.

2.3.12 Toggling the View Between Gantt and Web Client

While you are working on the Gantt Chart, you can switch to the Web Client view if required. This option is available in all modes of the Gantt Chart and is highlighted only when at least one row from the project Tree is selected.

To switch to the Web Client view of the current project:

  1. Select one or more activity rows in the Gantt chart.

  2. In the Tools menu, or in the right-click menu, select Show In Browser. If you are not connected to the server, the Agile PLM login screen appears.

  3. Log in to Agile. A new browser window opens for each activity row that you selected.

2.3.13 Printing a Gantt Chart

You can print any view of the Gantt Chart using the Print option in the File menu.

Within the Print window, or the Print Preview window, you can manually change Page Setup options if necessary. By default, the page margins are set to 0.5 inches, and the page orientation is set to Landscape.