Files
2018-06-29 19:47:36 +00:00

453 lines
11 KiB
C#

///////////////////////////////////////////////////////////
// WorkorderItemTask.cs
// Implementation of Class WorkorderItemTask
// CSLA type: Editable Child
// Created on: 07-Jun-2004 8:41:50 AM
// Object design: Joyce
// Coded: John 26-July-2004
///////////////////////////////////////////////////////////
using System;
using System.Data;
using CSLA.Data;
using GZTW.Data;
using CSLA;
using System.Threading;
using CSLA.Security;
namespace GZTW.AyaNova.BLL
{
/// <summary>
/// A single task item for a work order
/// </summary>
[Serializable]
public class WorkorderItemTask : BusinessBase {
#region Attributes
private bool bReadOnly;
private Guid mID;
private Guid mCreator;
private Guid mModifier;
private SmartDate mCreated;
private SmartDate mModified;
private Guid mTaskID;
/// <summary>
/// ID of WorkorderItem this task belongs with
/// </summary>
private Guid mWorkorderItemID;
/// <summary>
/// Whether completed, incomplete, not applicable Default is 0 (incomplete)
/// </summary>
private WorkorderItemTaskCompletionTypes mCompletionType;
/// <summary>
/// Back reference to group it came from
/// </summary>
private Guid mTaskGroupID;
#endregion
#region Constructor
private WorkorderItemTask()
{
//Set to read / write initially so that properties
//can be set
bReadOnly=false;
//Child object
MarkAsChild();
//New ID
mID = Guid.NewGuid();
//Set record history to defaults
mCreated = new SmartDate(DBUtil.CurrentWorkingDateTime);
mModified=new SmartDate();
mCreator=Guid.Empty;
mModifier=Guid.Empty;
mCompletionType = WorkorderItemTaskCompletionTypes.Incomplete;
}
#endregion
#region BusinessProperties
//---Common properties
/// <summary>
/// Initial created date of this object
/// </summary>
public string Created
{
get
{
return mCreated.ToString();
}
}
/// <summary>
/// User ID of who initially created this object
/// </summary>
public Guid Creator
{
get
{
return mCreator;
}
}
/// <summary>
/// Last modified date of this object
/// </summary>
public string Modified
{
get
{
return mModified.ToString();
}
}
/// <summary>
/// User ID of who last modified this object
/// </summary>
public Guid Modifier
{
get
{
return mModifier;
}
}
/// <summary>
/// Unique ID of this object
/// </summary>
public Guid ID
{
get
{
return mID;
}
}
//---WorkorderItemTask specific properties
/// <summary>
/// <see cref="WorkorderItemTaskCompletionTypes"/>
/// </summary>
public WorkorderItemTaskCompletionTypes WorkorderItemTaskCompletionType
{
get
{
return mCompletionType;
}
set
{
if(bReadOnly)
ThrowSetError();
else
{
if(mCompletionType!=value)
{
mCompletionType = value;
MarkDirty();
}
}
}
}
/// <summary>
/// ID of <see cref="Task"/>
/// </summary>
public Guid TaskID
{
get
{
return mTaskID;
}
set
{
if(bReadOnly)
ThrowSetError();
else
{
if(mTaskID!=value)
{
mTaskID = value;
MarkDirty();
}
}
}
}
/// <summary>
/// ID of <see cref="TaskGroup"/>
/// </summary>
public Guid TaskGroupID
{
get
{
return mTaskGroupID;
}
set
{
if(bReadOnly)
ThrowSetError();
else
{
if(mTaskGroupID!=value)
{
mTaskGroupID = value;
MarkDirty();
}
}
}
}
/// <summary>
/// Guid ID of parent <see cref="WorkorderItem"/> object
/// </summary>
public Guid WorkorderItemID
{
get
{
return mWorkorderItemID;
}
}
/// <summary>
/// Called by parent collection object
/// when called in turn by workorder object that is read only due to
/// security or closed or service completed
/// </summary>
/// <param name="RO">Either true or the rights allowed for the current user</param>
public void SetReadOnly(bool RO)
{
bReadOnly=RO;
}
/// <summary>
/// Throw an error when a read only user
/// tries to set a property
/// (this should normally never be called unless someone is using the developer api since the UI
/// should prevent it from happening initially)
/// </summary>
private void ThrowSetError()
{
throw new System.Security.SecurityException
(
string.Format
(
LocalizedTextTable.GetLocalizedTextDirect("Error.Security.NotAuthorizedToChange"),
LocalizedTextTable.GetLocalizedTextDirect("WorkorderItemO.Task")
)
);
}
#endregion
#region System.object overrides
/// <summary>
///
/// </summary>
/// <returns></returns>
public override string ToString()
{
return "WorkorderItemTask" + mID.ToString();
}
/// <summary>
///
/// </summary>
/// <param name="obj"></param>
/// <returns></returns>
public override bool Equals(Object obj)
{
if ( obj == null || GetType ( ) != obj.GetType ( ) ) return false;
WorkorderItemTask c=(WorkorderItemTask)obj;
return mID==c.mID;
}
/// <summary>
///
/// </summary>
/// <returns></returns>
public override int GetHashCode()
{
return ("WorkorderItemTask" + mID).GetHashCode();
}
#endregion
#region Static methods
/// <summary>
/// Create item
/// </summary>
/// <param name="obj">Parent ID</param>
/// <returns>New Item</returns>
internal static WorkorderItemTask NewItem(WorkorderItem obj)
{
//case 1387
if (AyaBizUtils.IsGenerator || ((obj.mHeaderRights > SecurityLevelTypes.ReadOnly) &&
(AyaBizUtils.Right("Object.WorkorderItemTask") > (int)SecurityLevelTypes.ReadOnly)))
{
WorkorderItemTask child=new WorkorderItemTask();
child.mWorkorderItemID=obj.ID;
return child;
}
else
throw new System.Security.SecurityException(
string.Format(
LocalizedTextTable.GetLocalizedTextDirect("Error.Security.NotAuthorizedToCreate"),
LocalizedTextTable.GetLocalizedTextDirect("WorkorderItemO.Task")));
}
/// <summary>
/// Retrieve item
/// </summary>
/// <param name="dr">Data reader</param>
/// <param name="obj"></param>
/// <returns>item from database</returns>
internal static WorkorderItemTask GetItem(SafeDataReader dr, WorkorderItem obj)
{
//case 1387
if ((obj.mHeaderRights > SecurityLevelTypes.NoAccess) &&
(AyaBizUtils.Right("Object.WorkorderItemTask") > (int)SecurityLevelTypes.NoAccess))
{
WorkorderItemTask child = new WorkorderItemTask();
child.Fetch(dr);
return child;
}
else
throw new System.Security.SecurityException(
string.Format(
LocalizedTextTable.GetLocalizedTextDirect("Error.Security.NotAuthorizedToRetrieve"),
LocalizedTextTable.GetLocalizedTextDirect("WorkorderItemO.Task")));
}
#endregion
#region DAL DATA ACCESS
#region Fetch
/// <summary>
/// Fetch from db
/// </summary>
/// <param name="dr"></param>
private void Fetch(SafeDataReader dr)
{
//Standard items
mCreated=DBUtil.ToLocal(dr.GetSmartDate("aCreated"));
mCreator=dr.GetGuid("aCreator");
mModified=DBUtil.ToLocal(dr.GetSmartDate("aModified"));
mModifier=dr.GetGuid("aModifier");
mID=dr.GetGuid("aID");
//WorkorderItemTask specific parameters
mTaskID=dr.GetGuid("aTaskID");
mTaskGroupID=dr.GetGuid("aTaskGroupID");
mWorkorderItemID=dr.GetGuid("aWorkorderItemID");
mCompletionType=(WorkorderItemTaskCompletionTypes)dr.GetInt16("aWorkorderItemTaskCmpltnType");
//Get access rights level
bReadOnly=AyaBizUtils.Right("Object.WorkorderItemTask")<(int)SecurityLevelTypes.ReadWrite;
MarkOld();
}
#endregion fetch
#region Add / Update
/// <summary>
/// Persist object to database
/// </summary>
/// <param name="obj">Parent object</param>
/// <param name="tr">Parents transaction object</param>
internal void Update(WorkorderItem obj,IDbTransaction tr)
{
//No need to update if there is nothing changed
if(!this.IsDirty) return;
// If not a new record, check if record was modified
//by another user since original retrieval:
if(!IsNew)
DBUtil.CheckSafeToUpdateInsideTransaction(this.mModified.Date, this.mID, "aWorkorderItemTask", tr);//case 1960
#region Delete
if(IsDeleted)
{
if(!IsNew)
{
DBCommandWrapper cmDelete = DBUtil.GetCommandFromSQL("DELETE FROM aWorkorderItemTask WHERE aID=@ID;");
cmDelete.AddInParameter("@ID",DbType.Guid,this.mID);
DBUtil.DB.ExecuteNonQuery(cmDelete, tr);
}
MarkNew();
return;
}
#endregion
#region Add / Update
//get modification time temporarily, if update succeeds then
//set to this time
System.DateTime dtModified = DBUtil.CurrentWorkingDateTime;
DBCommandWrapper cm = null;
if(IsNew)//Add or update?
cm=DBUtil.GetCommandFromSQL(
"INSERT INTO aWorkorderItemTask (aTaskID, aTaskGroupID, " +
"aID, aWorkorderItemID, aWorkorderItemTaskCmpltnType, " +
"aCreated,aModified,aCreator,aModifier) VALUES (@TaskID,@TaskGroupID, " +
"@ID,@WorkorderItemID,@WorkorderItemTaskCompletionType, " +
"@Created,@Modified,@CurrentUserID,@CurrentUserID)"
);
else
cm=DBUtil.GetCommandFromSQL(
"UPDATE aWorkorderItemTask SET aTaskID=@TaskID, aTaskGroupID=@TaskGroupID, " +
"aID=@ID, aWorkorderItemID=@WorkorderItemID, " +
"aWorkorderItemTaskCmpltnType=@WorkorderItemTaskCompletionType, " +
" aModifier=@CurrentUserID, " +
" aModified=@Modified WHERE aID=@ID"
);
//WorkorderItemTask specific parameters
cm.AddInParameter("@ID",DbType.Guid,mID);
cm.AddInParameter("@WorkorderItemID",DbType.Guid,mWorkorderItemID);
cm.AddInParameter("@TaskID",DbType.Guid,mTaskID);
cm.AddInParameter("@TaskGroupID",DbType.Guid,mTaskGroupID);
cm.AddInParameter("@WorkorderItemTaskCompletionType",DbType.Int16,(int)mCompletionType);
//standard parameters
cm.AddInParameter("@CurrentUserID",DbType.Guid, CurrentUserID);
cm.AddInParameter("@Created",DbType.DateTime, DBUtil.ToUTC(mCreated.Date));
cm.AddInParameter("@Modified",DbType.DateTime, DBUtil.ToUTC(dtModified));
DBUtil.DB.ExecuteNonQuery(cm, tr);
MarkOld();//db is now synched with object
//Successful update so
//change modification time to match
this.mModified.Date=dtModified;
#endregion
}
#endregion add/update
#endregion
}//end WorkorderItemTask
}//end namespace GZTW.AyaNova.BLL