/// <summary>Archives a Property record.</summary>
/// <param name="transaction">Commits or rejects a set of commands as a unit</param>
/// <param name="RowVersion">The version number of this row.</param>
/// <param name="propertyCode">The value for the PropertyCode column.</param>
/// <param name="archive">true to archive the object, false to unarchive it.</param>
public static void Archive(AdoTransaction adoTransaction, SqlTransaction sqlTransaction, long rowVersion, int propertyCode)
{
// Accessor for the Property Table.
ServerDataModel.PropertyDataTable propertyTable = ServerDataModel.Property;
// Rule #1: Make sure the record exists before updating it.
ServerDataModel.PropertyRow propertyRow = propertyTable.FindByPropertyCode(propertyCode);
if ((propertyRow == null))
{
throw new Exception(string.Format("The Property table does not have an element identified by {0}", propertyCode));
}
// Rule #2: Optimistic Concurrency Check
if ((propertyRow.RowVersion != rowVersion))
{
throw new System.Exception("This record is busy. Please try again later.");
}
// Archive the child records.
// Increment the row version
rowVersion = ServerDataModel.RowVersion.Increment();
// Delete the record in the ADO database.
propertyRow[propertyTable.RowVersionColumn] = rowVersion;
adoTransaction.DataRows.Add(propertyRow);
propertyRow.Delete();
// Archive the record in the SQL database.
SqlCommand sqlCommand = new SqlCommand("update \"Property\" set \"IsArchived\" = 1 where \"PropertyCode\"=@propertyCode");
sqlCommand.Connection = sqlTransaction.Connection;
sqlCommand.Transaction = sqlTransaction;
sqlCommand.Parameters.Add(new SqlParameter("@propertyCode", SqlDbType.Int, 0, ParameterDirection.Input, false, 0, 0, null, DataRowVersion.Current, propertyCode));
sqlCommand.ExecuteNonQuery();
}
/// <summary>Loads a Property record using Metadata Parameters.</summary>
/// <param name="transaction">Contains the parameters and exceptions for this command.</param>
public static void Load(ParameterList parameters)
{
// Accessor for the Property Table.
ServerDataModel.PropertyDataTable propertyTable = ServerDataModel.Property;
// Extract the parameters from the command batch.
AdoTransaction adoTransaction = parameters["adoTransaction"];
SqlTransaction sqlTransaction = parameters["sqlTransaction"];
object configurationId = parameters["configurationId"].Value;
int propertyCode = parameters["propertyCode"];
object name = parameters["name"].Value;
object externalId0 = parameters["externalId0"].Value;
object externalId1 = parameters["externalId1"].Value;
object externalId2 = parameters["externalId2"].Value;
object externalId3 = parameters["externalId3"].Value;
// The row versioning is largely disabled for external operations.
long rowVersion = long.MinValue;
// Find the record using the unique identifier. If it doesn't exist, it will be inserted, if it does exist,
// it will be updated.
ServerDataModel.PropertyRow propertyRow = propertyTable.FindByPropertyCode(propertyCode);
if ((propertyRow == null))
{
// Call the internal 'Insert' method to complete the operation.
MarkThree.Quasar.Core.Property.Insert(adoTransaction, sqlTransaction, ref rowVersion, propertyCode, name, externalId0, externalId1, externalId2, externalId3);
}
else
{
// This will bypass the optimistic concurrency checking required by the internal method.
rowVersion = ((long)(propertyRow[propertyTable.RowVersionColumn]));
// Call the internal 'Update' method to complete the operation.
MarkThree.Quasar.Core.Property.Update(adoTransaction, sqlTransaction, ref rowVersion, propertyCode, name, externalId0, externalId1, externalId2, externalId3);
}
// Return values
parameters["rowVersion"] = rowVersion;
}
/// <summary>Inserts a Property record.</summary>
/// <param name="transaction">Commits or rejects a set of commands as a unit</param>
/// <param name="propertyCode">The value for the PropertyCode column.</param>
/// <param name="name">The value for the Name column.</param>
/// <param name="externalId0">The value for the ExternalId0 column.</param>
/// <param name="externalId1">The value for the ExternalId1 column.</param>
/// <param name="externalId2">The value for the ExternalId2 column.</param>
/// <param name="externalId3">The value for the ExternalId3 column.</param>
public static void Insert(AdoTransaction adoTransaction, SqlTransaction sqlTransaction, ref long rowVersion, int propertyCode, object name, object externalId0, object externalId1, object externalId2, object externalId3)
{
// Accessor for the Property Table.
ServerDataModel.PropertyDataTable propertyTable = ServerDataModel.Property;
// Apply Defaults
if ((name == null))
{
name = System.DBNull.Value;
}
if ((externalId0 == null))
{
externalId0 = System.DBNull.Value;
}
if ((externalId1 == null))
{
externalId1 = System.DBNull.Value;
}
if ((externalId2 == null))
{
externalId2 = System.DBNull.Value;
}
if ((externalId3 == null))
{
externalId3 = System.DBNull.Value;
}
// Increment the row version
rowVersion = ServerDataModel.RowVersion.Increment();
// Insert the record into the ADO database.
ServerDataModel.PropertyRow propertyRow = propertyTable.NewPropertyRow();
propertyRow[propertyTable.RowVersionColumn] = rowVersion;
propertyRow[propertyTable.PropertyCodeColumn] = propertyCode;
propertyRow[propertyTable.NameColumn] = name;
propertyRow[propertyTable.ExternalId0Column] = externalId0;
propertyRow[propertyTable.ExternalId1Column] = externalId1;
propertyRow[propertyTable.ExternalId2Column] = externalId2;
propertyRow[propertyTable.ExternalId3Column] = externalId3;
propertyTable.AddPropertyRow(propertyRow);
adoTransaction.DataRows.Add(propertyRow);
// Insert the record into the SQL database.
SqlCommand sqlCommand = new SqlCommand("insert \"Property\" (\"rowVersion\",\"PropertyCode\",\"Name\",\"ExternalId0\",\"ExternalId1\"" +
",\"ExternalId2\",\"ExternalId3\") values (@rowVersion,@propertyCode,@name,@externalI" +
"d0,@externalId1,@externalId2,@externalId3)");
sqlCommand.Connection = sqlTransaction.Connection;
sqlCommand.Transaction = sqlTransaction;
sqlCommand.Parameters.Add(new SqlParameter("@rowVersion", SqlDbType.BigInt, 0, ParameterDirection.Input, false, 0, 0, null, DataRowVersion.Current, rowVersion));
sqlCommand.Parameters.Add(new SqlParameter("@propertyCode", SqlDbType.Int, 0, ParameterDirection.Input, false, 0, 0, null, DataRowVersion.Current, propertyCode));
sqlCommand.Parameters.Add(new SqlParameter("@name", SqlDbType.NVarChar, 0, ParameterDirection.Input, false, 0, 0, null, DataRowVersion.Current, name));
sqlCommand.Parameters.Add(new SqlParameter("@externalId0", SqlDbType.NVarChar, 0, ParameterDirection.Input, false, 0, 0, null, DataRowVersion.Current, externalId0));
sqlCommand.Parameters.Add(new SqlParameter("@externalId1", SqlDbType.NVarChar, 0, ParameterDirection.Input, false, 0, 0, null, DataRowVersion.Current, externalId1));
sqlCommand.Parameters.Add(new SqlParameter("@externalId2", SqlDbType.NVarChar, 0, ParameterDirection.Input, false, 0, 0, null, DataRowVersion.Current, externalId2));
sqlCommand.Parameters.Add(new SqlParameter("@externalId3", SqlDbType.NVarChar, 0, ParameterDirection.Input, false, 0, 0, null, DataRowVersion.Current, externalId3));
sqlCommand.ExecuteNonQuery();
}
/// <summary>Archives a Property record using Metadata Parameters.</summary>
/// <param name="transaction">Contains the parameters and exceptions for this command.</param>
public static void Archive(ParameterList parameters)
{
// Accessor for the Property Table.
ServerDataModel.PropertyDataTable propertyTable = ServerDataModel.Property;
// Extract the parameters from the command batch.
AdoTransaction adoTransaction = parameters["adoTransaction"];
SqlTransaction sqlTransaction = parameters["sqlTransaction"];
object configurationId = parameters["configurationId"].Value;
int propertyCode = parameters["propertyCode"];
// The row versioning is largely disabled for external operations.
long rowVersion = long.MinValue;
// While the optimistic concurrency checking is disabled for the external methods, the internal methods
// still need to perform the check. This ncurrency checking logic by finding the current row version to be
// will bypass the coused when the internal method is called.
ServerDataModel.PropertyRow propertyRow = propertyTable.FindByPropertyCode(propertyCode);
rowVersion = ((long)(propertyRow[propertyTable.RowVersionColumn]));
// Call the internal method to complete the operation.
MarkThree.Quasar.Core.Property.Archive(adoTransaction, sqlTransaction, rowVersion, propertyCode);
}
/// <summary>Updates a Property record using Metadata Parameters.</summary>
/// <param name="transaction">Contains the parameters and exceptions for this command.</param>
public static void Update(ParameterList parameters)
{
// Accessor for the Property Table.
ServerDataModel.PropertyDataTable propertyTable = ServerDataModel.Property;
// Extract the parameters from the command batch.
AdoTransaction adoTransaction = parameters["adoTransaction"];
SqlTransaction sqlTransaction = parameters["sqlTransaction"];
object configurationId = parameters["configurationId"].Value;
string externalPropertyCode = parameters["propertyCode"];
object name = parameters["name"].Value;
// The row versioning is largely disabled for external operations.
long rowVersion = long.MinValue;
// Resolve External Identifiers
int propertyCode = Property.FindRequiredKey(configurationId, "propertyCode", externalPropertyCode);
// This will bypass the internal optimistic concurrency checking by providing the current rowVersion to the
// internal method.
ServerDataModel.PropertyRow propertyRow = propertyTable.FindByPropertyCode(propertyCode);
rowVersion = ((long)(propertyRow[propertyTable.RowVersionColumn]));
// Call the internal method to complete the operation.
MarkThree.Quasar.Core.Property.Update(adoTransaction, sqlTransaction, ref rowVersion, propertyCode, name, null, null, null, null);
// Return values.
parameters["rowVersion"] = rowVersion;
}
/// <summary>Updates a Property record.</summary>
/// <param name="transaction">Commits or rejects a set of commands as a unit</param>
/// <param name="rowVersion">The version number of the row</param>
/// <param name="propertyCode">The value for the PropertyCode column.</param>
/// <param name="name">The value for the Name column.</param>
/// <param name="externalId0">The value for the ExternalId0 column.</param>
/// <param name="externalId1">The value for the ExternalId1 column.</param>
/// <param name="externalId2">The value for the ExternalId2 column.</param>
/// <param name="externalId3">The value for the ExternalId3 column.</param>
public static void Update(AdoTransaction adoTransaction, SqlTransaction sqlTransaction, ref long rowVersion, int propertyCode, object name, object externalId0, object externalId1, object externalId2, object externalId3)
{
// Accessor for the Property Table.
ServerDataModel.PropertyDataTable propertyTable = ServerDataModel.Property;
// Rule #1: Make sure the record exists before updating it.
ServerDataModel.PropertyRow propertyRow = propertyTable.FindByPropertyCode(propertyCode);
if ((propertyRow == null))
{
throw new Exception(string.Format("The Property table does not have an element identified by {0}", propertyCode));
}
// Rule #2: Optimistic Concurrency Check
if ((propertyRow.RowVersion != rowVersion))
{
throw new System.Exception("This record is busy. Please try again later.");
}
// Apply Defaults
if ((name == null))
{
name = propertyRow[propertyTable.NameColumn];
}
if ((externalId0 == null))
{
externalId0 = propertyRow[propertyTable.ExternalId0Column];
}
if ((externalId1 == null))
{
externalId1 = propertyRow[propertyTable.ExternalId1Column];
}
if ((externalId2 == null))
{
externalId2 = propertyRow[propertyTable.ExternalId2Column];
}
if ((externalId3 == null))
{
externalId3 = propertyRow[propertyTable.ExternalId3Column];
}
// Increment the row version
rowVersion = ServerDataModel.RowVersion.Increment();
// Update the record in the ADO database.
propertyRow[propertyTable.RowVersionColumn] = rowVersion;
propertyRow[propertyTable.NameColumn] = name;
propertyRow[propertyTable.ExternalId0Column] = externalId0;
propertyRow[propertyTable.ExternalId1Column] = externalId1;
propertyRow[propertyTable.ExternalId2Column] = externalId2;
propertyRow[propertyTable.ExternalId3Column] = externalId3;
adoTransaction.DataRows.Add(propertyRow);
// Update the record in the SQL database.
SqlCommand sqlCommand = new SqlCommand("update \"Property\" set \"RowVersion\"=@rowVersion,\"Name\"=@name,\"ExternalId0\"=@extern" +
"alId0,\"ExternalId1\"=@externalId1,\"ExternalId2\"=@externalId2,\"ExternalId3\"=@exter" +
"nalId3 where \"PropertyCode\"=@propertyCode");
sqlCommand.Connection = sqlTransaction.Connection;
sqlCommand.Transaction = sqlTransaction;
sqlCommand.Parameters.Add(new SqlParameter("@rowVersion", SqlDbType.BigInt, 0, ParameterDirection.Input, false, 0, 0, null, DataRowVersion.Current, rowVersion));
sqlCommand.Parameters.Add(new SqlParameter("@propertyCode", SqlDbType.Int, 0, ParameterDirection.Input, false, 0, 0, null, DataRowVersion.Current, propertyCode));
sqlCommand.Parameters.Add(new SqlParameter("@name", SqlDbType.NVarChar, 0, ParameterDirection.Input, false, 0, 0, null, DataRowVersion.Current, name));
sqlCommand.Parameters.Add(new SqlParameter("@externalId0", SqlDbType.NVarChar, 0, ParameterDirection.Input, false, 0, 0, null, DataRowVersion.Current, externalId0));
sqlCommand.Parameters.Add(new SqlParameter("@externalId1", SqlDbType.NVarChar, 0, ParameterDirection.Input, false, 0, 0, null, DataRowVersion.Current, externalId1));
sqlCommand.Parameters.Add(new SqlParameter("@externalId2", SqlDbType.NVarChar, 0, ParameterDirection.Input, false, 0, 0, null, DataRowVersion.Current, externalId2));
sqlCommand.Parameters.Add(new SqlParameter("@externalId3", SqlDbType.NVarChar, 0, ParameterDirection.Input, false, 0, 0, null, DataRowVersion.Current, externalId3));
// Update the record in the SQL database.
sqlCommand.ExecuteNonQuery();
}
