C:/Data/Projects/MCS EPM Global Practice/Frameworks/Public/mpfX/1.0/Libraries/Mcs.Epm.MicrosoftProject.mpFx/EntityFactory.cs

/*  ----------------------------------------------------------------------------
 *  Microsoft Corporation
 *  ----------------------------------------------------------------------------
 *  Microsoft Project Server mpFx (mpFx)
 *  ----------------------------------------------------------------------------
 *  Author: Colby Africa
 *  ----------------------------------------------------------------------------
 *  License: http://code.msdn.microsoft.com/mpFx/Project/License.aspx
 *  ----------------------------------------------------------------------------
 */

using System;
using Mcs.Epm.MicrosoftProject.mpFx.ProjectsWebService;
using Mcs.Epm.MicrosoftProject.mpFx.ResourcesWebService;
using Resource = Microsoft.Office.Project.Server.Library.Resource;

namespace Mcs.Epm.MicrosoftProject.mpFx
{
    /// <summary>
    /// Provides Microsoft Project Server primary entities (Project, Resource, Task, and Assignment) creation factory
    /// </summary>
    public class EntityFactory
    {
        #region Static Fields

        private static bool _AutoCreateGuid = true;

        #endregion

        #region Public Properties

        /// <summary>
        /// Get and set whether GUIDs should be automatically created on new entities
        /// </summary>
        public static bool AutoCreateGuids
        {
            get { return _AutoCreateGuid; }
            set { _AutoCreateGuid = value; }
        }

        #endregion

        #region Project Creation Methods

        /// <summary>
        /// Create empty project row
        /// </summary>
        /// <returns></returns>
        public static ProjectDataSet NewProject()
        {
            ProjectDataSet projectDataSet = new ProjectDataSet();

            ProjectDataSet.ProjectRow project = projectDataSet.Project.NewProjectRow();

            if (AutoCreateGuids)
            {
                project.PROJ_UID = Guid.NewGuid();
            }

            projectDataSet.Project.AddProjectRow(project);

            return projectDataSet;
        }

        public static ProjectDataSet NewProject(ProjectCreationOptions options)
        {
            if (options.Guid == Guid.Empty)
            {
                if (!_AutoCreateGuid)
                {
                    throw new ArgumentException( /*  TODO: Exception Message */);
                }
            }

            ProjectDataSet project = NewProject(options.Name,
                                                options.Guid,
                                                options.ScheduleFromStart,
                                                options.ScheduleFromDate);

            if (options.CalendarGuid != Guid.Empty)
            {
                project.Project[0].CAL_UID = options.CalendarGuid;
            }

            project.Project[0].PROJ_OPT_CALC_ACT_COSTS = options.CalculateActualCosts;
            project.Project[0].PROJ_OPT_CRITICAL_SLACK_LIMIT = options.NumberOfSlackDaysBeforeCritical;
            project.Project[0].PROJ_OPT_HONOR_CONSTRAINTS = options.HonorConstraints;
            project.Project[0].PROJ_OPT_MOVE_ACTUAL_IF_LATER = options.MoveEndCompletedPartsForwardStatusDate;
            project.Project[0].PROJ_OPT_MOVE_ACTUAL_TO_STATUS = options.MoveEndCompletedPartsAfterStatusDateBackStatusDate;
            project.Project[0].PROJ_OPT_MOVE_REMAINING_IF_EARLIER = options.MoveStartRemainingPartsBeforeStatusDateForwardStatusDate;
            project.Project[0].PROJ_OPT_MOVE_REMAINING_TO_STATUS = options.MoveStartRemainingPartsBackStatusDate;
            project.Project[0].PROJ_OPT_MULT_CRITICAL_PATHS = options.CalculateMultipleCriticalPaths;
            project.Project[0].PROJ_OPT_SPLIT_IN_PROGRESS = options.SplitInProgressTasks;
            project.Project[0].PROJ_OPT_SPREAD_ACT_COSTS = options.SpreadActualCosts;
            project.Project[0].PROJ_OPT_SPREAD_PCT_COMP = options.SpreadPercentCompleteToStatusDate;
            project.Project[0].PROJ_OPT_TASK_UPDATES_RES = options.AutoCalculateActualAndRemainingWorkAndCosts;

            return project;
        }

        /// <summary>
        /// Create project row with name 
        /// </summary>
        /// <param name="name">Project Name</param>
        /// <returns></returns>
        public static ProjectDataSet NewProject(string name)
        {
            ProjectDataSet project = NewProject();

            project.Project[0].PROJ_NAME = name;

            return project;
        }

        /// <summary>
        /// Create project with name and guid
        /// </summary>
        /// <param name="name">Project Name</param>
        /// <param name="guid">Project GUI</param>
        /// <returns></returns>
        public static ProjectDataSet NewProject(string name,
                                                Guid guid)
        {
            ProjectDataSet project = NewProject(name);

            if (guid == Guid.Empty)
            {
                if (_AutoCreateGuid)
                {
                    guid = Guid.NewGuid();
                }
                else
                {
                    throw new ArgumentException( /*  TODO: Exception Message  */);
                }
            }
            project.Project[0].PROJ_UID = guid;

            return project;
        }

        /// <summary>
        /// Create project with name, set schedule from (SFS or SFF) and relevant date (start for SFS, finish for SFF)
        /// </summary>
        /// <param name="name">Project Name</param>
        /// <param name="guid">Project Guid</param>
        /// <param name="scheduleFromStart">True to schedule from Start Date, false to schedule from Finish Date</param>
        /// <param name="scheduleFromDate">if 'schedleFromStart' = true, Start Date; false, Finish Data</param>
        /// <returns></returns>
        public static ProjectDataSet NewProject(string name,
                                                Guid guid,
                                                bool scheduleFromStart,
                                                DateTime scheduleFromDate)
        {
            ProjectDataSet project = NewProject(name, guid);

            if (scheduleFromStart)
            {
                project.Project[0].PROJ_INFO_SCHED_FROM = true;
                project.Project[0].PROJ_INFO_START_DATE = scheduleFromDate;
            }
            else
            {
                project.Project[0].PROJ_INFO_SCHED_FROM = false;
                project.Project[0].PROJ_INFO_FINISH_DATE = scheduleFromDate;
            }

            return project;
        }

        #endregion

        #region Resource Creation Methods

        /// <summary>
        /// Creates empty resource
        /// </summary>
        /// <returns></returns>
        public static ResourceDataSet NewResource()
        {
            ResourceDataSet resourceDataSet = new ResourceDataSet();

            ResourceDataSet.ResourcesRow resource = resourceDataSet.Resources.NewResourcesRow();

            resource.RES_UID = Guid.NewGuid();
            resource.RES_NAME = string.Empty;

            resourceDataSet.Resources.AddResourcesRow(resource);
            return resourceDataSet;
        }

        /// <summary>
        /// Creates resource of a specific type
        /// </summary>
        /// <param name="type">Type</param>
        /// <returns></returns>
        public static ResourceDataSet NewResource(Resource.Type type)
        {
            ResourceDataSet resourceDataSet = NewResource();

            resourceDataSet.Resources[0].RES_TYPE = (int) type;

            return resourceDataSet;
        }

        /// <summary>
        /// Creates resource with name
        /// </summary>
        /// <param name="name">Resource Name</param>
        /// <returns></returns>
        public static ResourceDataSet NewResource(string name)
        {
            ResourceDataSet resourceDataSet = NewResource();

            resourceDataSet.Resources[0].RES_NAME = name;

            return resourceDataSet;
        }

        /// <summary>
        /// Creates resource with name and type set
        /// </summary>
        /// <param name="name">Resource Name</param>
        /// <param name="type">Resource Type</param>
        /// <returns></returns>
        public static ResourceDataSet NewResource(string name,
                                                  Resource.Type type)
        {
            ResourceDataSet resourceDataSet = NewResource(type);

            resourceDataSet.Resources[0].RES_NAME = name;

            return resourceDataSet;
        }

        /// <summary>
        /// Creates resource with name, type, and Guid set
        /// </summary>
        /// <param name="name">Resource Name</param>
        /// <param name="type">Resource Type</param>
        /// <param name="guid">Resource Guid</param>
        /// <returns></returns>
        public static ResourceDataSet NewResource(string name,
                                                  Resource.Type type,
                                                  Guid guid)
        {
            ResourceDataSet resource = NewResource(name, type);

            resource.Resources[0].RES_UID = guid;

            return resource;
        }

        /// <summary>
        /// Creates resource with name, guid, email address, and group set
        /// </summary>
        /// <param name="name">Resource Name</param>
        /// <param name="guid">Resource Guid</param>
        /// <param name="emailAddress">Resource Email Address</param>
        /// <param name="group">Resource Group</param>
        /// <returns></returns>
        public static ResourceDataSet NewResource(string name,
                                                  Guid guid,
                                                  string emailAddress,
                                                  string group)
        {
            ResourceDataSet resourceDataSet = NewResource(name, Resource.Type.WorkResource);

            resourceDataSet.Resources[0].RES_UID = guid;
            resourceDataSet.Resources[0].WRES_EMAIL = emailAddress;
            resourceDataSet.Resources[0].RES_GROUP = group;

            return resourceDataSet;
        }

        #endregion

        #region Task Creation Methods

        /// <summary>
        /// Creates empty task
        /// </summary>
        /// <returns></returns>
        public static ProjectDataSet.TaskRow NewTask()
        {
            using (ProjectDataSet projectDataSet = new ProjectDataSet())
            {
                ProjectDataSet.TaskRow task = projectDataSet.Task.NewTaskRow();

                if (AutoCreateGuids)
                {
                    task.TASK_UID = Guid.NewGuid();
                }

                return task;
            }
        }

        /// <summary>
        /// Creates a task row with name set
        /// </summary>
        /// <param name="name">Task Name</param>
        /// <returns></returns>
        public static ProjectDataSet.TaskRow NewTask(string name)
        {
            ProjectDataSet.TaskRow task = NewTask();

            task.TASK_NAME = name;

            return task;
        }

        #endregion
    }
}

---