WorkPlan Application

Understanding WorkPlan Templates


A WorkPlan Template is a set of Tasks with schedule logic that can be used repetitively to create WorkPlans. A WorkPlan Template is assigned to a Trackor® to provide a task-based schedule for meeting business objectives for that unique Trackor.

The creation of WorkPlan Templates is a multi-step process that requires careful planning in order to obtain the desired scheduling and reporting benefits. Considerations include:

  1. Milestone activities to normalize point-in-time progress.

  2. Determining task granularity - too many tasks that get in the way of job progress versus too few tasks that can not provide predictive project progress.

  3. Coordination with other WorkPlans to ensure Tasks can roll-up across projects for Executive reporting and many, many other factors.

WorkPlans

A WorkPlan is a set of tasks that have comprehensive Project Management capabilities as defined by the Project Management Institute (PMI). The OneVizion® WorkPlan is a task-oriented schedule tracking and forecasting solution that measures progress toward the completion of standard business objectives called Target Goals.

The WorkPlan capabilities include:

  • Assignment of unlimited WorkPlans to a single Target Goal (including repetitive use of the same WorkPlan).

  • Unlimited tasks in the WorkPlan that are applied to the Target Goal.

  • Configured Applet that is a user-defined data container to support data collection for a WorkPlan.

  • Automatically calculated Baseline and Projected (Planned) Dates using either a Start Date to calculate dates forward or Finish Dates to calculate dates backward.

Tasks

A Task is the basic element of the WorkPlan and has a number of standard capabilities:

  • Baseline Dates (Start and Finish)

  • Projected Dates. Projected Dates are calculated using:

    • Predecessor relationship to other Tasks including Finish to Start, Start to Start, Start to Finish, Finish to Finish and Lag dates both positive and negative for each of the relationships.

    • Successor relationship to other Tasks.

    • Durations.

  • Actual Dates.

  • Unlimited Program-defined dates (i.e. Contractor Actual Start/Finish, etc).

  • Calendar to support calculating Projected dates.

  • Responsible Person assigned to complete the Task.

  • Discipline Security.

  • Configured Applet that is a user-defined data container to support data collection for a Task.

Also, a OneVizion Task supports a number of capabilities to tailor the use of a WorkPlan to represent local conditions of Program-wide use including:

  • N/A- Designating a Task N/A removes the Task from the active set of Tasks to be accomplished for the specific Target Goal.

  • Block Calc- Designating a Task as a Block Calc freezes the Projected Date and forces all downstream Projected Dates to be calculated from that date.


For a list of Task Data Functions please refer to Get Task Data Functions.

WorkPlans and Program Management

The use of WorkPlans changes Program Management from a task-centric scheduling tool (focused on planning) to a Target Goal-centric focus. Being Target Goal-centric means the focus is on managing large numbers of similar scopes of work with an emphasis on tracking and forecasting to identify exceptions that might prevent a Program from being completed.

For example, building a national cell tower project can be modeled by managing each tower as the Target Goal. Each Tower has assigned WorkPlans (UMTS, New Build, Rooftop Construction, etc) that represents the completion measurement capability.

OneVizion makes certain assumptions about the SuperUser who will be creating the WorkPlan Templates and the work station environment itself. Before you begin creating WorkPlan Templates, you must make sure the prerequisites outlined in this section have been met.

Administrator Prerequisites

The Administrator responsible for administering WorkPlans should have the following skills:

  • Industry experience including:

    • Solid industry program management experience with the subject being managed.

    • In-depth knowledge of creating scheduled work processes.

  • Computer technology experience including expertise in the following:

    • Microsoft Project 2000 (or higher)

    • Microsoft Excel

Work Station Requirements

Before creating WorkPlan Templates, the proper desktop computer environment must be implemented. The following software is required for a properly configured work station on which to create WorkPlan Templates:

  • Microsoft Project 2000 (or higher)

  • Administrator rights to the WorkPlan Editor Page. Security Tokens for WorkPlan Template Work Station.

Security Requirements

Security Groups for WorkPlan Template lists the security requirements for the user who is responsible for creating the WorkPlan Templates.

Security Groups for WorkPlan Template 

Security TokenSettingWhere UsedDescription
ADMIN_WP_TASKSREADWorkPlan Template Application PageAbility to Add/Edit/Delete Template's Tasks
ADMIN_WP_TASK_TYPESREADWorkPlan Template Application PageAbility to Add/Edit/Delete Template's Types
ADMIN_WP_TEMPLATESREADWorkPlan Template Application PageWorkPlan Templates
ADMIN_XITORREADWorkPlan Template Application PageTarget Goal/Sub-Target Goal configuration applet
ADMIN_WP_CALENDARSREADWorkPlan Template Application PageAbility to Add/Edit/Delete Calendars

Workplans: Security privileges for individual Task date pairs

We now allow more granular restriction for date pairs – at the individual task level. There is a new security tab (Special Task Privs) in Security Role where Admins can add specific restrictions to date-pairs. Admins can select the individual Task’s date pairs and set privileges based on role.

If ‘Special Task Privs’ for the task/date is not set then the general task security model will be used.


General Security model:

The task is editable when the TASKS sec group is set to "RE" and Discipline of the Task in question is assigned to the User. Then "TASK_*_MOD" is checked for a specific date pair (TASK_PROJECTED_MOD or TASK_ACTUAL_MOD etc).


Special Task Privs Mode:

The task is editable when the TASKS sec group is set to "RE" and then privs of the specific Task/DatePair is being checked.

In the screenshot example below,  this role has read-only access to actual date pairs of Tasks ‘135 – Design Review’ and ‘150 – Training’. However, Actual date pairs for ‘100 – New Site Checklist’ and ‘160 – UAT’ can be read and edited

Note that if Task is added to Spec Task Priv Tab but privs are not set then this Task (screenshot below – ‘(A180) 180 – Transition to Support’ and ‘(A 130) 130 – Project Kickoff’ will become inaccessible. When you need to get back to the General task security model just remove Task/DatePair from the Special Task Privs grid.

The creation of a WorkPlan Template is a multi-step process. Below is a chart describing each of the steps involved in the process.

Process Overview

To create a WorkPlan Template requires the following general steps:



Step NumberDescriptionSee this section …
1Analyze Needs for WorkPlansPlanning and Analysis
2Capture WorkPlan data in Microsoft ProjectCapturing Data in Microsoft Project
3Create WorkPlan TemplateCreating WorkPlan Templates


4
Add Tasks to WorkPlan Templatein one of following ways:

Using MS Project

Using the WorkPlan Template page


Importing a Microsoft Project Schedule into OneVizion

Adding Tasks Manually to a WorkPlan Template



5
Configure the WorkPlan Template:

Assign Task Type to Task

Create Assigned Date Pair

Assign Task Types to multiple Tasks and WorkPlans


Working with Task Types

Working with Configured Date Pairs

Ask Type Maintenance
6Test WorkPlanProcess outside OneVizion
7Create WorkPlanCreating a WorkPlan
8Create Trackor to Task LinksTrackor to Task Relationship

Planning and Analysis

Before you begin creating a WorkPlan Template, you must analyze your work processes and carefully plan the template. The process that you are trying to standardize uses a project management model where the smallest unit of measured work is a Task. Tasks have logical relationships with other Tasks including predecessors and successors (that is, steps which must be completed before or after a particular Task). A WorkPlan is a collection of Tasks.

Planning the WorkPlan Template

In planning an efficient WorkPlan, it is important to decide how much information you want OneVizion to collect. You should aim to strike a balance between collecting all possible information and not enough information. The ideal amount of information associated with a standard WorkPlan Template is one that provides actionable information to meet program objectives (pay milestones, etc).

One good method for planning a WorkPlan is to create a 3 X 5 card for each Task and organize them on a flat surface (such as table or wall) and physically arrange the cards to show the completion relationships.

The work process should contain Tasks that adequately describe the progress toward completion of the work process but not overly burden the schedule with collection detail.

Planning Notes

The following are some additional notes on planning a WorkPlan Template:

  • Standard - A standard WorkPlan is an organization-centric planning tool. The information collected should reflect organizational needs for a roll-up of actionable information.

  • Task Data - If data about the Task is required for collection, this information is best contained in a configured applet that is associated with the Task.

Capturing Data in Microsoft Project

The planning and analysis of the WorkPlan must be captured in a computer format that can be used by OneVizion. Two methods are available:

  • Modeling the WorkPlan using Microsoft Project and importing it into OneVizion – this is the recommended process.

  • Direct entry using the OneVizion WorkPlan Template Administration Application Page.

Creating a WorkPlan in Microsoft Project

Creating the WorkPlan in Microsoft Project is a practical alternative to entering WorkPlan data manually through OneVizion. Once created, the schedule is exported from MS Project in a CSV (comma-separated value) file format. This CSV file is then imported into OneVizion to populate the WorkPlan Template.

A compatible OneVizion Microsoft Project schedule uses two objects within the MPP file:

  • Export View

  • Export Map


Use the standard blank Microsoft Project Template found in the OneVizion Component Library that was shipped with your initial installation.

Export View Requirements

The Export View has the following additional fields to be added in the order and the spelling shown below:

  • STATUS_LEVEL

  • DISCIPLINE

  • SITE_RELATED

  • WBS

WBS = Work Breakdown Structure

Adding Fields in Microsoft Project

To add fields in Microsoft Project:

  1. Right-click on the grid header.

  2. Select Insert Column.

  3. Add the Text 1 column and give it a column title STATUS_LEVEL.

  4. Click OK.

  5. Repeat this for the four additional columns (listed above) selecting Text 2 the second time, etc.


Adding Tasks to the Microsoft Project Schedule

After the Fields have been added, then add Tasks to model the WorkPlan using standard Microsoft conventions.

Creating an Export Map

After Tasks have been added to the MS Project schedule, create an MPP export map named Export Map. This Export Map is stored in the MPP file.

To create the Export Map in Microsoft Project:

  1. Open the MS Project file filename.mpp.

  2. Edit the file as needed.

  3. From the File menu select Save As.

  4. Select CSV in the Save As Type list box, enter a file name and click Save.

See the Format of the CSV File for more information.

  1. Open the Export Map dialog and click New Map.

  2. Name the export OneVizion Export Map.

  3. Under Data to Import/Export, select Tasks.

  4. Under Text File Options, select the Export Header Row checkbox.

  5. Click the Task Mapping tab.

  6. Click the Clear all button.

  7. Go to the Grid, select the following fields in the first column, and add rows: ID, Task_Name, Duration, Predecessors, Successors, Text 1, Text 2, Text 3, Text 4, and WBS.

  8. Click OK to close the Define Import/Export Map dialog box.

  9. Click Save to close the Export Mapping dialog and save the file.

  10. Check the file in Notepad for accuracy. It should not have any headers in it.


The header row is absolutely required (ID, Task_Name, Duration, Predecessors, Successors, Text 1, Text 2, Text 3, Text 4, WBS). Make sure it exists in the *.CSV file to be imported into OneVizion.

Format of the CSV File

The Microsoft Project file must be saved in CSV (comma separated variable) format in order to be imported into OneVizion. The CSV file must be generated using the Export function in MS Project to ensure the correct format.

The CSV file must have the following information in the exact order, delineated by commas, and without any header information:

The TASK_ID in Microsoft Project is the OneVizion Order Number. The Task ID cannot be edited in MS Project. OneVizion does not place any constraints on the Order Number other than it must be a whole number (integer).

TASK_ID 
TASK_NAME 
DURATION 
PREDECESSORS 
SUCCESSORS 
DISCP_NAME 
IS_SAR_RELATED 
SAR_STATUS_LEVEL 
WBS 

WorkPlan Template Required Fields

In order to create a OneVizion WorkPlan Template, the following fields will have to be populated:

  • A Workplan instance can’t be stand-alone. It must be attached to a Trackor Record.

  • The Name must be unique to the Trackor Record it is assigned to.

  • Assigning a Workplan Start or Workplan Finish will calculate the Workplan’s Baseline Dates from the Tasks with no Predecessors or Successors respectively.

  • Workplans are Active by default, but they can be set to Inactive, which will filter them from showing up in the GUI.


Field NameDescription

ORDER_NUMBER
The Order Number is a unique number within the WorkPlan that identifies a Task and its order compared to others. It is also used to define the Task Relationship if used by other Tasks in the Predecessors and Successors fields.
TASK_NAMEThe task name is the name of the task limited to 50 characters.

DURATION
In OneVizion, the duration of a task is measured in days. Durations must be specified in days. The calendar in OneVizion sets weekends as non-working days. You can create custom calendars to specify additional non-working days (such as holidays) if you wish.







PREDECESSORS

The Predecessors field specifies the Task ID of the tasks that must be completed prior to beginning work on the current task. If multiple tasks must be completed prior to the start of the task, the Task IDs are separated by commas (i.e., 12, 14SS, 18FF+5). The following relationships can be specified by the following convention:

The default is Finish to Start relationship.


* Start to Start. Add SS to the end of the Order Number

* Finish to Finish. Add FF to the end of the Order Number

* Start to Finish. Add SF to the end of the Order Number

* Positive Lag. Add “+[Number of days lag]” after the Order Number

* Negative Lag. Add “-[Number of days lag]” after the Order Number


SUCCESSORS
The Successors field specifies the Task ID of the tasks that will be started after completion of this task. If multiple tasks will follow the completion of the task, the TASK IDs are separated by commas (i.e., 12, 14).

The Successor used the same formatting convention as Predecessor.

DISCIPLINE
(Text of Discipline Name). The discipline field contains the discipline responsible for execution or completion of the task. The discipline is defined in the V_DISCP validation table. This entry must exist before importing it (i.e. spelled exactly the same as the Discipline in the V_DISP table). This entry is case sensitive.
IS_SAR_RELATEDValue = 1. This flag denotes that a task is related to the Target Goal and must be set to 1 (IS_SAR_RELATED = 1).
SAR_STATUS_LEVELValue=1 to 10. This flag is used to color-code the OneVizion network object in the mapping software.
WBSThis is a general Task field to support Work Breakdown Schedules for compatibility with traditional Project Management systems.


Field NameField Description
Task*Text box containing the name of the task. You can enter up to 50 characters.
Trackor Related*List box containing the Trackor™ associated with this Task. You can select from a list of available Trackors.


Discp
List box containing the discipline assigned to execute or complete the task. The values in the Disc. Fields are stored in the System V_DISCP table*

Some examples of disciplines are AE, AEC, CGC, CN, DC, DCC, OT, PC, PD, PM, PR, RE, RF, RFC, RG, SA, SAC, SC, SS, or TN.

Calendar*
List box containing the Calendar associated with this Task. The Calendar is used for system-calculated dates. For example, the standard OneVizion calendar marks weekends as non-working days, and so they are not included as workdays when a projected date is calculated. You can set up new calendars to reflect holidays and non-work days specific to your business process.
Order Number*Text box containing a unique number that identifies the Task and its order compared to others. The order number is also used to define the Task Relationship if used by other Tasks in the Predecessors and Successors fields. The order number must be a whole number.
WBS*Text box containing a Work Breakdown Structure identifier. This value may be alphanumeric.







Predecessor
Text box containing the Task ID of the tasks that must be completed prior to beginning work on the current task. If multiple tasks must be completed prior to the start of the task, the TASK IDs are separated by commas (i.e., 12, 14). This is also required in order to make the date calculation engine work properly.

The default is Finish to Start relationship.

*Start to Start- Add SS to the end of the Order Number.

*Finish to Finish- Add FF to the end of the Order Number.

*Start to Finish- Add SF to the end of the Order Number.

*Positive Lag- Add “+[Number of days lag]” after the Order Number.

*Negative Lag- Add “-[Number of days lag]” after the Order Number.


Successor
Text box containing the Task ID of the tasks that will be started after completion of this task. If multiple tasks will follow the completion of the task, the TASK IDs are separated by commas (i.e., 12, 14). This is required in order to make the date calculation engine work properly.

Successor uses the same formatting conventions as Predecessors.
Task Window*Text box used to establish a range of time that allows a Task of a particular duration to be accomplished.
Duration*Text box containing the number of days it will take to complete the task.


The following fields are updated for all existing WP Tasks:

Order Number

Discp,

Trackor Type

WBS

Calendar

Required

Milestone

The following fields are changed only for the template task:

Duration

Task Window

NA

Block Calc

Description

Editing or Deleting Tasks

If necessary, you can modify the parameters within a Task or delete a Task from a WorkPlan. While OneVizion does allow you to edit an “in-use” WorkPlan Template, this should be done with caution. This capability allows changing the values in the WorkPlan Template and then applying these changes through all active WorkPlans.

Editing an “in-use” WorkPlan Template should be done only after careful planning. There is no automatic “un-do” button for this capability.


The following table lists the Task properties of a WorkPlan Template that can be changed and the associated consequences.

Edit ActionConsequenceCan it be Undone? Yes/No
Add New TaskTask is added to all existing WorkPlans with no data.Yes. Can be undone by deleting.



Edit Existing Task (active WorkPlan)
Fields that propagate to active WorkPlans:

* Task Name
* Order Number
* Target Goal Related
* Discipline
* Predecessor
* Successor
* Configured Applet



Yes. Can be undone by re-editing.


Edit Existing Task
Fields that propagate only to Template WorkPlans and future WorkPlans created:

* Duration
* Task Window
* Calendar


Yes. Can be undone by re-editing.


Change Successor/Predecessor
The links involved will be removed and recreated. No recalculation would be done on existing the WorkPlan; only the links would be changed.

Any further change to dates in specific WorkPlans would force the calculations as the new logic specifies.

Yes. Can be undone but is difficult if dates have been calculated.
WBSPropagates WBS to all active WorkPlans.Yes. Can be undone by re-editing.

Configurable Form

Adding the Configurable exposes it to all active WorkPlans.
Yes. Can be undone but the data remains in the metadata table.

WorkPlan Task Due


A new automated configuration was created in DEV APPS called P:Worklan Task Due.  This was inspired by customers who frequently ask, “How do I know which tasks are forecast to be finished within X-Days?”

Using the task definition tracker, we select which tasks on the workplan we want to inspect.  On the grid, the user can select the number of days and OneVizion will tell the user which tasks are forecast to be finished within that timeframe.


On this Page