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

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

using System;
using System.Web.Services.Protocols;
using System.Windows.Forms;
using Mcs.Epm.MicrosoftProject.mpFx.CustomFieldsWebService;
using Microsoft.Office.Project.Server.Library;

namespace Mcs.Epm.MicrosoftProject.mpFx.WinForms
{
    /// <summary>
    /// WinForms user interface for creating or editing an enterprise custom field
    /// </summary>
    public partial class EditNewCustomFieldForm : Form
    {
        #region Instance Data

        private readonly CustomFieldDefinition _CustomFieldDefinition;
        private readonly CustomFieldDataSet _customFieldDataSet;
        private readonly bool _IsNew;

        private readonly ProjectServer _ProjectServer;

        #endregion

        #region Public Properties

        #endregion

        #region Constructor

        public EditNewCustomFieldForm(ProjectServer projectServer)
        {
            _ProjectServer = projectServer;

            _CustomFieldDefinition = new CustomFieldDefinition(string.Empty) { Guid = Guid.Empty };

            _IsNew = true;

            InitializeComponent();

            LoadEntities();
            LoadTypes();

            nameTextBox.Select();
        }

        public EditNewCustomFieldForm(ProjectServer projectServer,
                                      CustomFieldDataSet customFieldDataSet)
        {
            _ProjectServer = projectServer;

            _customFieldDataSet = customFieldDataSet;

            _CustomFieldDefinition = new CustomFieldDefinition((CustomFieldDataSet.CustomFieldsRow)customFieldDataSet.CustomFields.Rows[0]);

            _IsNew = false;

            InitializeComponent();

            LoadEntities();
            LoadTypes();

            entityList.Enabled = false;
            typeList.Enabled = false;

            nameTextBox.Text = _CustomFieldDefinition.Name;
            requiredCheckBox.Checked = _CustomFieldDefinition.IsRequired;

            switch (_CustomFieldDefinition.DisplayType)
            {
                case CustomFieldDefinition.DisplayTypes.Data:
                    dataOption.Checked = true;
                    break;
                case CustomFieldDefinition.DisplayTypes.GraphicalIndicators:
                    grapicalIndicatorsOption.Checked = true;
                    break;
                default:
                    throw new ArgumentOutOfRangeException();
            }

            switch (_CustomFieldDefinition.AttributeType)
            {
                case CustomFieldDefinition.AttributeTypes.None:
                    noneOption.Checked = true;
                    lookupTableOption.Enabled = false;
                    formulaOption.Enabled = false;
                    break;
                case CustomFieldDefinition.AttributeTypes.LookupTable:
                    lookupTableOption.Checked = true;
                    formulaOption.Enabled = false;
                    noneOption.Enabled = false;
                    break;
                case CustomFieldDefinition.AttributeTypes.Formula:
                    formulaOption.Checked = true;
                    lookupTableOption.Enabled = false;
                    noneOption.Enabled = false;
                    break;
                default:
                    throw new ArgumentOutOfRangeException();
            }

            nameTextBox.Select();
        }

        public string FieldName
        {
            get { return nameTextBox.Text; }
        }

        public CustomFieldDefinition CustomFieldDefinition
        {
            get { return _CustomFieldDefinition; }
        }

        #endregion

        #region Private Methods

        private void LoadEntities()
        {
            string displayeName = Utilities.GetEntityTypeDisplayName(_CustomFieldDefinition.EntityGuid);
            int selectedIndex = 0;

            if (displayeName.Equals("Project", StringComparison.InvariantCultureIgnoreCase))
            {
                selectedIndex = 0;
            }
            else if (displayeName.Equals("Task", StringComparison.InvariantCultureIgnoreCase))
            {
                selectedIndex = 1;
            }
            else if (displayeName.Equals("Resource", StringComparison.InvariantCultureIgnoreCase))
            {
                selectedIndex = 2;
            }

            entityList.Items.Add("Project");
            entityList.Items.Add("Task");
            entityList.Items.Add("Resource");

            entityList.SelectedIndex = selectedIndex;
        }

        private void LoadTypes()
        {
            int selectedIndex;

            switch (_CustomFieldDefinition.Type)
            {
                case CustomField.Type.COST:
                    selectedIndex = 0;
                    break;
                case CustomField.Type.DATE:
                    selectedIndex = 1;
                    break;
                case CustomField.Type.DURATION:
                    selectedIndex = 2;
                    break;
                case CustomField.Type.FLAG:
                    selectedIndex = 3;
                    break;
                case CustomField.Type.NUMBER:
                    selectedIndex = 4;
                    break;
                case CustomField.Type.TEXT:
                    selectedIndex = 5;
                    break;
                default:
                    selectedIndex = 5;
                    break;

            }

            typeList.Items.Add("Cost");
            typeList.Items.Add("Date");
            typeList.Items.Add("Duration");
            typeList.Items.Add("Flag");
            typeList.Items.Add("Number");
            typeList.Items.Add("Text");

            typeList.SelectedIndex = selectedIndex;
        }

        private bool ValidateForm()
        {
            if (nameTextBox.Text == String.Empty)
            {
                MessageBox.Show("Please provide a unique name for the field.", "Custom Fields", MessageBoxButtons.OK, MessageBoxIcon.Warning);
                nameTextBox.Select();
                return false;
            }

            return true;
        }

        private bool CreateField()
        {
            try
            {
                _CustomFieldDefinition.Guid = new Guid();
                _CustomFieldDefinition.Type = CustomFields.GetTypeFromName(typeList.SelectedItem.ToString());
                _CustomFieldDefinition.EntityGuid = new Guid(Utilities.GetEntityGuidStringFromName(entityList.SelectedItem.ToString()));
                _CustomFieldDefinition.IsRequired = requiredCheckBox.Checked = true;

                _ProjectServer.CustomFields.Create(_CustomFieldDefinition, false, true);

                return true;
            }
            catch (Exception exception)
            {
                MessageBox.Show(exception.Message, "Custom Fields", MessageBoxButtons.OK, MessageBoxIcon.Error);
                return false;
            }
        }

        private void UpdateFieldDefinition()
        {
            if (noneOption.Checked)
            {
                _CustomFieldDefinition.AttributeType = CustomFieldDefinition.AttributeTypes.None;
            }
            else if (lookupTableOption.Checked)
            {
                _CustomFieldDefinition.AttributeType = CustomFieldDefinition.AttributeTypes.LookupTable;
            }
            if (formulaOption.Checked)
            {
                _CustomFieldDefinition.AttributeType = CustomFieldDefinition.AttributeTypes.Formula;
            }

            if (dataOption.Checked)
            {
                _CustomFieldDefinition.DisplayType = CustomFieldDefinition.DisplayTypes.Data;
            }
            else if (grapicalIndicatorsOption.Checked)
            {
                _CustomFieldDefinition.DisplayType = CustomFieldDefinition.DisplayTypes.GraphicalIndicators;
            }
        }

        private bool SaveField()
        {
            bool checkedOut = false;

            try
            {
                _ProjectServer.CustomFields.CheckOut(new[] { _CustomFieldDefinition.Guid });
                checkedOut = true;

                _ProjectServer.CustomFields.Update(_customFieldDataSet, _CustomFieldDefinition, false, true);
                checkedOut = false;

                return true;
            }
            catch (SoapException exception)
            {
                MessageBox.Show(this,
                                Errors.ProcessMSProjectErrors(exception),
                                "Test",
                                MessageBoxButtons.OK,
                                MessageBoxIcon.Error);
            }
            catch (Exception exception)
            {
                MessageBox.Show(this,
                                exception.Message,
                                "Test",
                                MessageBoxButtons.OK,
                                MessageBoxIcon.Error);

            }
            finally
            {
                if (checkedOut)
                {
                    _ProjectServer.CustomFields.CheckIn(_CustomFieldDefinition.Guid, true);
                }
            }

            return false;
        }

        #endregion

        #region Event Handlers

        private void noneOption_CheckedChanged(object sender, EventArgs e)
        {
            editCustomAttributesButton.Enabled = !noneOption.Checked;
            summaryRowsCalcFormulaOption.Enabled = noneOption.Checked;

            UpdateFieldDefinition();
        }

        private void lookupTableOption_CheckedChanged(object sender, EventArgs e)
        {
            editCustomAttributesButton.Enabled = lookupTableOption.Checked;

            UpdateFieldDefinition();
        }

        private void formulaOption_CheckedChanged(object sender, EventArgs e)
        {
            editCustomAttributesButton.Enabled = formulaOption.Checked;

            UpdateFieldDefinition();
        }

        private void dataOption_CheckedChanged(object sender, EventArgs e)
        {
            editGraphicalIndicators.Enabled = !dataOption.Checked;

            UpdateFieldDefinition();
        }

        private void grapicalIndicatorsOption_CheckedChanged(object sender, EventArgs e)
        {
            editGraphicalIndicators.Enabled = grapicalIndicatorsOption.Checked;

            UpdateFieldDefinition();
        }

        private void okButton_Click(object sender, EventArgs e)
        {
            if (ValidateForm())
            {
                Cursor = Cursors.WaitCursor;

                if (grapicalIndicatorsOption.Checked == false)
                {
                    _CustomFieldDefinition.NonSummaryCriteriaString = string.Empty;
                    _CustomFieldDefinition.ProjectSummaryCriteriaString = string.Empty;
                    _CustomFieldDefinition.SummaryTaskCriteriaString = string.Empty;
                }
                if (_IsNew)
                {
                    if (CreateField())
                    {
                        Close();
                    }
                }
                else
                {
                    if (SaveField())
                    {
                        Close();
                    }
                }

                Cursor = Cursors.Default;
            }
            DialogResult = DialogResult.OK;
        }

        private void editCustomAttributesButton_Click(object sender, EventArgs e)
        {
            if (lookupTableOption.Checked)
            {
                Cursor = Cursors.WaitCursor;

                EditCustomFieldLookupFieldForm form = new EditCustomFieldLookupFieldForm(_CustomFieldDefinition, _ProjectServer);

                if (form.ShowDialog(this) == DialogResult.OK)
                {
                    _CustomFieldDefinition.LookupTableGuid = form.LookupTableGUID;
                    _CustomFieldDefinition.DefaultValueGuid = form.DefaultValueGUID;
                    _CustomFieldDefinition.LeafOnly = form.AllowOnlyLeafNode;
                    _CustomFieldDefinition.MultiSelect = form.AllowMultiSelect ? CustomField.AcceptableMaxValues.TWOHUNDREDFIFTY : CustomField.AcceptableMaxValues.DEFAULT;
                }

                Cursor = Cursors.Default;
            }
            else if (formulaOption.Checked)
            {
            }
        }

        private void cancelButton_Click(object sender, EventArgs e)
        {
            Close();
        }

        private void nameTextBox_TextChanged(object sender, EventArgs e)
        {
            _CustomFieldDefinition.Name = nameTextBox.Text;
        }

        private void requiredCheckBox_CheckedChanged(object sender, EventArgs e)
        {
            _CustomFieldDefinition.IsRequired = requiredCheckBox.Checked;
        }

        private void typeList_SelectedIndexChanged(object sender, EventArgs e)
        {
            bool lookupTableOptionEnabled = false;
            bool formulaOptionEnabled = true;
            bool requiredOptionEnabled = true;
            bool summaryRowsCalcFormulaOptionEnabled = true;

            switch (typeList.SelectedIndex)
            {
                case 0: //  Cost
                    break;
                case 1: //  Date
                    break;
                case 2: //  Duration
                    break;
                case 3: //  Flag
                    requiredOptionEnabled = false;
                    break;
                case 4: //  Number
                    break;
                case 5: //  Text
                    lookupTableOptionEnabled = true;
                    summaryRowsCalcFormulaOptionEnabled = false;
                    break;
            }

            requiredCheckBox.Enabled = requiredOptionEnabled;
            lookupTableOption.Enabled = lookupTableOptionEnabled;
            formulaOption.Enabled = formulaOptionEnabled;
            calculationForSummaryRowsGroupBox.Enabled = summaryRowsCalcFormulaOptionEnabled;
            editCustomAttributesButton.Enabled = lookupTableOption.Enabled && (lookupTableOption.Checked || formulaOption.Checked);

        }

        private void editGraphicalIndicators_Click(object sender, EventArgs e)
        {
            GraphicalIndicator indicator = new GraphicalIndicator(new Guid(Utilities.GetEntityGuidStringFromName(entityList.Text)),
                                                                  _CustomFieldDefinition,
                                                                  CustomFields.GetTypeFromName(typeList.Text));

            EditNewGraphicalIndicatorForm indicatorForm = new EditNewGraphicalIndicatorForm(indicator);

            if (indicatorForm.ShowDialog(this) == DialogResult.OK)
            {
                _CustomFieldDefinition.ProjectSummaryCriteriaString = indicatorForm.ProjectSummaryCriteriaString;
                _CustomFieldDefinition.SummaryTaskCriteriaString = indicatorForm.SummaryTaskCriteriaString;
                _CustomFieldDefinition.NonSummaryCriteriaString = indicatorForm.NonSummaryCriteriaString;

                _CustomFieldDefinition.ShowValuesInTooltip = indicatorForm.ShowValuesInToolTips;
            }
        }

        private void entityList_SelectedIndexChanged(object sender, EventArgs e)
        {
            bool summaryRowOptionsEnabled = false;
            bool assignmentRowOptionsEnabled = false;

            switch (entityList.SelectedIndex)
            {
                case 0: //  Project                    
                    break;
                case 1: //  Task
                    summaryRowOptionsEnabled = true;
                    assignmentRowOptionsEnabled = true;
                    break;
                case 2: //  Resource
                    assignmentRowOptionsEnabled = true;
                    break;
            }

            calculationForSummaryRowsGroupBox.Enabled = summaryRowOptionsEnabled;
            calculationForAssignmentRowsGroupBox.Enabled = assignmentRowOptionsEnabled;

        }

        #endregion

    }
}

---