/// <summary>Updates a TransactionType 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 TransactionType Table.
ServerDataModel.TransactionTypeDataTable transactionTypeTable = ServerDataModel.TransactionType;
// Extract the parameters from the command batch.
AdoTransaction adoTransaction = parameters["adoTransaction"];
SqlTransaction sqlTransaction = parameters["sqlTransaction"];
object configurationId = parameters["configurationId"].Value;
string externalTransactionTypeCode = parameters["transactionTypeCode"];
object quantitySign = parameters["quantitySign"].Value;
object cashSign = parameters["cashSign"].Value;
object mnemonic = parameters["mnemonic"].Value;
object description = parameters["description"].Value;
// The row versioning is largely disabled for external operations.
long rowVersion = long.MinValue;
// Resolve External Identifiers
int transactionTypeCode = TransactionType.FindRequiredKey(configurationId, "transactionTypeCode", externalTransactionTypeCode);
// This will bypass the internal optimistic concurrency checking by providing the current rowVersion to the
// internal method.
ServerDataModel.TransactionTypeRow transactionTypeRow = transactionTypeTable.FindByTransactionTypeCode(transactionTypeCode);
rowVersion = ((long)(transactionTypeRow[transactionTypeTable.RowVersionColumn]));
// Call the internal method to complete the operation.
MarkThree.Quasar.Core.TransactionType.Update(adoTransaction, sqlTransaction, ref rowVersion, transactionTypeCode, quantitySign, cashSign, mnemonic, description, null, null, null, null);
// Return values.
parameters["rowVersion"] = rowVersion;
}
/// <summary>Inserts a TransactionType record.</summary>
/// <param name="transaction">Commits or rejects a set of commands as a unit</param>
/// <param name="transactionTypeCode">The value for the TransactionTypeCode column.</param>
/// <param name="quantitySign">The value for the QuantitySign column.</param>
/// <param name="cashSign">The value for the CashSign column.</param>
/// <param name="mnemonic">The value for the Mnemonic column.</param>
/// <param name="description">The value for the Description 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 transactionTypeCode, decimal quantitySign, decimal cashSign, string mnemonic, string description, object externalId0, object externalId1, object externalId2, object externalId3)
{
// Accessor for the TransactionType Table.
ServerDataModel.TransactionTypeDataTable transactionTypeTable = ServerDataModel.TransactionType;
// Apply Defaults
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.TransactionTypeRow transactionTypeRow = transactionTypeTable.NewTransactionTypeRow();
transactionTypeRow[transactionTypeTable.RowVersionColumn] = rowVersion;
transactionTypeRow[transactionTypeTable.TransactionTypeCodeColumn] = transactionTypeCode;
transactionTypeRow[transactionTypeTable.QuantitySignColumn] = quantitySign;
transactionTypeRow[transactionTypeTable.CashSignColumn] = cashSign;
transactionTypeRow[transactionTypeTable.MnemonicColumn] = mnemonic;
transactionTypeRow[transactionTypeTable.DescriptionColumn] = description;
transactionTypeRow[transactionTypeTable.ExternalId0Column] = externalId0;
transactionTypeRow[transactionTypeTable.ExternalId1Column] = externalId1;
transactionTypeRow[transactionTypeTable.ExternalId2Column] = externalId2;
transactionTypeRow[transactionTypeTable.ExternalId3Column] = externalId3;
transactionTypeTable.AddTransactionTypeRow(transactionTypeRow);
adoTransaction.DataRows.Add(transactionTypeRow);
// Insert the record into the SQL database.
SqlCommand sqlCommand = new SqlCommand(@"insert ""TransactionType"" (""rowVersion"",""TransactionTypeCode"",""QuantitySign"",""CashSign"",""Mnemonic"",""Description"",""ExternalId0"",""ExternalId1"",""ExternalId2"",""ExternalId3"") values (@rowVersion,@transactionTypeCode,@quantitySign,@cashSign,@mnemonic,@description,@externalId0,@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("@transactionTypeCode", SqlDbType.Int, 0, ParameterDirection.Input, false, 0, 0, null, DataRowVersion.Current, transactionTypeCode));
sqlCommand.Parameters.Add(new SqlParameter("@quantitySign", SqlDbType.Decimal, 0, ParameterDirection.Input, false, 0, 0, null, DataRowVersion.Current, quantitySign));
sqlCommand.Parameters.Add(new SqlParameter("@cashSign", SqlDbType.Decimal, 0, ParameterDirection.Input, false, 0, 0, null, DataRowVersion.Current, cashSign));
sqlCommand.Parameters.Add(new SqlParameter("@mnemonic", SqlDbType.NVarChar, 0, ParameterDirection.Input, false, 0, 0, null, DataRowVersion.Current, mnemonic));
sqlCommand.Parameters.Add(new SqlParameter("@description", SqlDbType.NVarChar, 0, ParameterDirection.Input, false, 0, 0, null, DataRowVersion.Current, description));
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 TransactionType 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="transactionTypeCode">The value for the TransactionTypeCode 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 transactionTypeCode)
{
// Accessor for the TransactionType Table.
ServerDataModel.TransactionTypeDataTable transactionTypeTable = ServerDataModel.TransactionType;
// Rule #1: Make sure the record exists before updating it.
ServerDataModel.TransactionTypeRow transactionTypeRow = transactionTypeTable.FindByTransactionTypeCode(transactionTypeCode);
if ((transactionTypeRow == null))
{
throw new Exception(string.Format("The TransactionType table does not have an element identified by {0}", transactionTypeCode));
}
// Rule #2: Optimistic Concurrency Check
if ((transactionTypeRow.RowVersion != rowVersion))
{
throw new System.Exception("This record is busy. Please try again later.");
}
// Archive the child records.
for (int index = 0; (index < transactionTypeRow.GetAllocationRows().Length); index = (index + 1))
{
ServerDataModel.AllocationRow childAllocationRow = transactionTypeRow.GetAllocationRows()[index];
Allocation.Archive(adoTransaction, sqlTransaction, childAllocationRow.RowVersion, childAllocationRow.AllocationId);
}
for (int index = 0; (index < transactionTypeRow.GetBlockOrderRows().Length); index = (index + 1))
{
ServerDataModel.BlockOrderRow childBlockOrderRow = transactionTypeRow.GetBlockOrderRows()[index];
BlockOrder.Archive(adoTransaction, sqlTransaction, childBlockOrderRow.RowVersion, childBlockOrderRow.BlockOrderId);
}
for (int index = 0; (index < transactionTypeRow.GetOrderRows().Length); index = (index + 1))
{
ServerDataModel.OrderRow childOrderRow = transactionTypeRow.GetOrderRows()[index];
Order.Archive(adoTransaction, sqlTransaction, childOrderRow.RowVersion, childOrderRow.OrderId);
}
for (int index = 0; (index < transactionTypeRow.GetProposedOrderRows().Length); index = (index + 1))
{
ServerDataModel.ProposedOrderRow childProposedOrderRow = transactionTypeRow.GetProposedOrderRows()[index];
ProposedOrder.Archive(adoTransaction, sqlTransaction, childProposedOrderRow.RowVersion, childProposedOrderRow.ProposedOrderId);
}
// Increment the row version
rowVersion = ServerDataModel.RowVersion.Increment();
// Delete the record in the ADO database.
transactionTypeRow[transactionTypeTable.RowVersionColumn] = rowVersion;
adoTransaction.DataRows.Add(transactionTypeRow);
transactionTypeRow.Delete();
// Archive the record in the SQL database.
SqlCommand sqlCommand = new SqlCommand("update \"TransactionType\" set \"IsArchived\" = 1 where \"TransactionTypeCode\"=@transa" +
"ctionTypeCode");
sqlCommand.Connection = sqlTransaction.Connection;
sqlCommand.Transaction = sqlTransaction;
sqlCommand.Parameters.Add(new SqlParameter("@transactionTypeCode", SqlDbType.Int, 0, ParameterDirection.Input, false, 0, 0, null, DataRowVersion.Current, transactionTypeCode));
sqlCommand.ExecuteNonQuery();
}
/// <summary>Initializes the static elements of an Object.</summary>
static TransactionType()
{
// The table must be locked before the indices can be read into an accelerator array.
ServerDataModel.TransactionTypeLock.AcquireReaderLock(System.Threading.Timeout.Infinite);
// Accessor for the TransactionType Table.
ServerDataModel.TransactionTypeDataTable transactionTypeTable = ServerDataModel.TransactionType;
// This does an indirect lookup operation using the views created for the ExternalId columns. Take the index of the user
// identifier column calcualted above and use it to find a record containing the external identifier.
TransactionType.externalKeyArray = new DataView[] {
transactionTypeTable.UKTransactionTypeExternalId0,
transactionTypeTable.UKTransactionTypeExternalId1,
transactionTypeTable.UKTransactionTypeExternalId2,
transactionTypeTable.UKTransactionTypeExternalId3};
// The table must be released after the array is constructed.
ServerDataModel.TransactionTypeLock.ReleaseReaderLock();
}
/// <summary>Archives a TransactionType 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 TransactionType Table.
ServerDataModel.TransactionTypeDataTable transactionTypeTable = ServerDataModel.TransactionType;
// Extract the parameters from the command batch.
AdoTransaction adoTransaction = parameters["adoTransaction"];
SqlTransaction sqlTransaction = parameters["sqlTransaction"];
object configurationId = parameters["configurationId"].Value;
int transactionTypeCode = parameters["transactionTypeCode"];
// 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.TransactionTypeRow transactionTypeRow = transactionTypeTable.FindByTransactionTypeCode(transactionTypeCode);
rowVersion = ((long)(transactionTypeRow[transactionTypeTable.RowVersionColumn]));
// Call the internal method to complete the operation.
MarkThree.Quasar.Core.TransactionType.Archive(adoTransaction, sqlTransaction, rowVersion, transactionTypeCode);
}
/// <summary>Finds a a TransactionType record using a configuration and an external identifier.</summary>
/// <param name="configurationId">Specified which mappings (user id columns) to use when looking up external identifiers.</param>
/// <param name="parameterId">The name of the parameter as specified in the configuration table.</param>
/// <param name="externalId">The external (user supplied) identifier for the record.</param>
public static int FindKey(object configurationId, string parameterId, object externalId)
{
// A missing key will never match a column.
if ((externalId == null))
{
return int.MinValue;
}
// Accessor for the TransactionType Table.
ServerDataModel.TransactionTypeDataTable transactionTypeTable = ServerDataModel.TransactionType;
// Look for the record using the external identifier. The configuration selected the key to use, which effectively
// selected the external id column to use for the search. If a record is found in the view, a translation still needs
// to be made back to the original table before an index to the record can be returned to the caller.
int externalKeyIndex = TransactionType.GetExternalKeyIndex(configurationId, parameterId);
System.Data.DataView externalKeyView = TransactionType.externalKeyArray[externalKeyIndex];
int recordIndex = externalKeyView.Find(new object[] {
externalId});
if ((recordIndex == -1))
{
return int.MinValue;
}
return ((int)(externalKeyView[recordIndex].Row[transactionTypeTable.TransactionTypeCodeColumn]));
}
/// <summary>Loads a TransactionType 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 TransactionType Table.
ServerDataModel.TransactionTypeDataTable transactionTypeTable = ServerDataModel.TransactionType;
// Extract the parameters from the command batch.
AdoTransaction adoTransaction = parameters["adoTransaction"];
SqlTransaction sqlTransaction = parameters["sqlTransaction"];
object configurationId = parameters["configurationId"].Value;
int transactionTypeCode = parameters["transactionTypeCode"];
decimal quantitySign = parameters["quantitySign"];
decimal cashSign = parameters["cashSign"];
string mnemonic = parameters["mnemonic"];
string description = parameters["description"];
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.TransactionTypeRow transactionTypeRow = transactionTypeTable.FindByTransactionTypeCode(transactionTypeCode);
if ((transactionTypeRow == null))
{
// Call the internal 'Insert' method to complete the operation.
MarkThree.Quasar.Core.TransactionType.Insert(adoTransaction, sqlTransaction, ref rowVersion, transactionTypeCode, quantitySign, cashSign, mnemonic, description, externalId0, externalId1, externalId2, externalId3);
}
else
{
// This will bypass the optimistic concurrency checking required by the internal method.
rowVersion = ((long)(transactionTypeRow[transactionTypeTable.RowVersionColumn]));
// Call the internal 'Update' method to complete the operation.
MarkThree.Quasar.Core.TransactionType.Update(adoTransaction, sqlTransaction, ref rowVersion, transactionTypeCode, quantitySign, cashSign, mnemonic, description, externalId0, externalId1, externalId2, externalId3);
}
// Return values
parameters["rowVersion"] = rowVersion;
}
/// <summary>Updates a TransactionType 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="transactionTypeCode">The value for the TransactionTypeCode column.</param>
/// <param name="quantitySign">The value for the QuantitySign column.</param>
/// <param name="cashSign">The value for the CashSign column.</param>
/// <param name="mnemonic">The value for the Mnemonic column.</param>
/// <param name="description">The value for the Description 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 transactionTypeCode, object quantitySign, object cashSign, object mnemonic, object description, object externalId0, object externalId1, object externalId2, object externalId3)
{
// Accessor for the TransactionType Table.
ServerDataModel.TransactionTypeDataTable transactionTypeTable = ServerDataModel.TransactionType;
// Rule #1: Make sure the record exists before updating it.
ServerDataModel.TransactionTypeRow transactionTypeRow = transactionTypeTable.FindByTransactionTypeCode(transactionTypeCode);
if ((transactionTypeRow == null))
{
throw new Exception(string.Format("The TransactionType table does not have an element identified by {0}", transactionTypeCode));
}
// Rule #2: Optimistic Concurrency Check
if ((transactionTypeRow.RowVersion != rowVersion))
{
throw new System.Exception("This record is busy. Please try again later.");
}
// Apply Defaults
if ((quantitySign == null))
{
quantitySign = transactionTypeRow[transactionTypeTable.QuantitySignColumn];
}
if ((cashSign == null))
{
cashSign = transactionTypeRow[transactionTypeTable.CashSignColumn];
}
if ((mnemonic == null))
{
mnemonic = transactionTypeRow[transactionTypeTable.MnemonicColumn];
}
if ((description == null))
{
description = transactionTypeRow[transactionTypeTable.DescriptionColumn];
}
if ((externalId0 == null))
{
externalId0 = transactionTypeRow[transactionTypeTable.ExternalId0Column];
}
if ((externalId1 == null))
{
externalId1 = transactionTypeRow[transactionTypeTable.ExternalId1Column];
}
if ((externalId2 == null))
{
externalId2 = transactionTypeRow[transactionTypeTable.ExternalId2Column];
}
if ((externalId3 == null))
{
externalId3 = transactionTypeRow[transactionTypeTable.ExternalId3Column];
}
// Increment the row version
rowVersion = ServerDataModel.RowVersion.Increment();
// Update the record in the ADO database.
transactionTypeRow[transactionTypeTable.RowVersionColumn] = rowVersion;
transactionTypeRow[transactionTypeTable.QuantitySignColumn] = quantitySign;
transactionTypeRow[transactionTypeTable.CashSignColumn] = cashSign;
transactionTypeRow[transactionTypeTable.MnemonicColumn] = mnemonic;
transactionTypeRow[transactionTypeTable.DescriptionColumn] = description;
transactionTypeRow[transactionTypeTable.ExternalId0Column] = externalId0;
transactionTypeRow[transactionTypeTable.ExternalId1Column] = externalId1;
transactionTypeRow[transactionTypeTable.ExternalId2Column] = externalId2;
transactionTypeRow[transactionTypeTable.ExternalId3Column] = externalId3;
adoTransaction.DataRows.Add(transactionTypeRow);
// Update the record in the SQL database.
SqlCommand sqlCommand = new SqlCommand(@"update ""TransactionType"" set ""RowVersion""=@rowVersion,""QuantitySign""=@quantitySign,""CashSign""=@cashSign,""Mnemonic""=@mnemonic,""Description""=@description,""ExternalId0""=@externalId0,""ExternalId1""=@externalId1,""ExternalId2""=@externalId2,""ExternalId3""=@externalId3 where ""TransactionTypeCode""=@transactionTypeCode");
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("@transactionTypeCode", SqlDbType.Int, 0, ParameterDirection.Input, false, 0, 0, null, DataRowVersion.Current, transactionTypeCode));
sqlCommand.Parameters.Add(new SqlParameter("@quantitySign", SqlDbType.Decimal, 0, ParameterDirection.Input, false, 0, 0, null, DataRowVersion.Current, quantitySign));
sqlCommand.Parameters.Add(new SqlParameter("@cashSign", SqlDbType.Decimal, 0, ParameterDirection.Input, false, 0, 0, null, DataRowVersion.Current, cashSign));
sqlCommand.Parameters.Add(new SqlParameter("@mnemonic", SqlDbType.NVarChar, 0, ParameterDirection.Input, false, 0, 0, null, DataRowVersion.Current, mnemonic));
sqlCommand.Parameters.Add(new SqlParameter("@description", SqlDbType.NVarChar, 0, ParameterDirection.Input, false, 0, 0, null, DataRowVersion.Current, description));
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();
}
