/// <summary>Updates a Province 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 Province Table.
ServerMarketData.ProvinceDataTable provinceTable = ServerMarketData.Province;
// Extract the parameters from the command batch.
AdoTransaction adoTransaction = parameters["adoTransaction"];
SqlTransaction sqlTransaction = parameters["sqlTransaction"];
object configurationId = parameters["configurationId"].Value;
object abbreviation = parameters["abbreviation"].Value;
object externalCountryId = parameters["countryId"].Value;
object name = parameters["name"].Value;
string externalProvinceId = ((string)(parameters["provinceId"]));
// The row versioning is largely disabled for external operations.
long rowVersion = long.MinValue;
// Resolve External Identifiers
object countryId = Country.FindOptionalKey(configurationId, "countryId", externalCountryId);
int provinceId = Province.FindRequiredKey(configurationId, "provinceId", externalProvinceId);
// 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.
ServerMarketData.ProvinceRow provinceRow = provinceTable.FindByProvinceId(provinceId);
rowVersion = ((long)(provinceRow[provinceTable.RowVersionColumn]));
// Call the internal method to complete the operation.
MarkThree.Guardian.Core.Province.Update(adoTransaction, sqlTransaction, ref rowVersion, abbreviation, countryId, null, null, name, provinceId);
// Return values.
parameters["rowVersion"] = rowVersion;
}
/// <summary>Archives a Province 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="provinceId">The value for the ProvinceId 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 provinceId)
{
// Accessor for the Province Table.
ServerMarketData.ProvinceDataTable provinceTable = ServerMarketData.Province;
// Rule #1: Make sure the record exists before updating it.
ServerMarketData.ProvinceRow provinceRow = provinceTable.FindByProvinceId(provinceId);
if ((provinceRow == null))
{
throw new Exception(string.Format("The Province table does not have an element identified by {0}", provinceId));
}
// Rule #2: Optimistic Concurrency Check
if ((provinceRow.RowVersion != rowVersion))
{
throw new System.Exception("This record is busy. Please try again later.");
}
// Archive the child records.
for (int index = 0; (index < provinceRow.GetAccountBaseRows().Length); index = (index + 1))
{
ServerMarketData.AccountBaseRow childAccountBaseRow = provinceRow.GetAccountBaseRows()[index];
AccountBase.ArchiveChildren(adoTransaction, sqlTransaction, childAccountBaseRow.RowVersion, childAccountBaseRow.AccountBaseId);
}
// Increment the row version
rowVersion = ServerMarketData.RowVersion.Increment();
// Delete the record in the ADO database.
provinceRow[provinceTable.RowVersionColumn] = rowVersion;
adoTransaction.DataRows.Add(provinceRow);
provinceRow.Delete();
// Archive the record in the SQL database.
SqlCommand sqlCommand = new SqlCommand("update \"Province\" set \"IsArchived\" = 1 where \"ProvinceId\"=@provinceId");
sqlCommand.Connection = sqlTransaction.Connection;
sqlCommand.Transaction = sqlTransaction;
sqlCommand.Parameters.Add(new SqlParameter("@provinceId", SqlDbType.Int, 0, ParameterDirection.Input, false, 0, 0, null, DataRowVersion.Current, provinceId));
sqlCommand.ExecuteNonQuery();
}
/// <summary>Loads a Province 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 Province Table.
ServerMarketData.ProvinceDataTable provinceTable = ServerMarketData.Province;
// Extract the parameters from the command batch.
AdoTransaction adoTransaction = parameters["adoTransaction"];
SqlTransaction sqlTransaction = parameters["sqlTransaction"];
object configurationId = parameters["configurationId"].Value;
string abbreviation = parameters["abbreviation"];
string externalCountryId = parameters["countryId"];
object externalId0 = parameters["externalId0"].Value;
object externalId1 = parameters["externalId1"].Value;
string name = parameters["name"];
object externalProvinceId = parameters["provinceId"].Value;
// The row versioning is largely disabled for external operations. The value is returned to the caller in the
// event it's needed for operations within the batch.
long rowVersion = long.MinValue;
// Resolve External Identifiers
int countryId = Country.FindRequiredKey(configurationId, "countryId", externalCountryId);
int provinceId = Province.FindKey(configurationId, "provinceId", externalProvinceId);
// The load operation will create a record if it doesn't exist, or update an existing record. The external
// identifier is used to determine if a record exists with the same key.
if ((provinceId == int.MinValue))
{
// Populate the 'externalId' varaibles so that the external identifier can be used to find the row when an
// external method is called with the same 'configurationId' parameter.
int externalKeyIndex = Province.GetExternalKeyIndex(configurationId, "provinceId");
object[] externalIdArray = new object[2];
externalIdArray[externalKeyIndex] = externalProvinceId;
externalId0 = externalIdArray[0];
externalId1 = externalIdArray[1];
// Call the internal method to complete the operation.
MarkThree.Guardian.Core.Province.Insert(adoTransaction, sqlTransaction, ref rowVersion, abbreviation, countryId, externalId0, externalId1, name);
}
else
{
// 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.
ServerMarketData.ProvinceRow provinceRow = provinceTable.FindByProvinceId(provinceId);
rowVersion = ((long)(provinceRow[provinceTable.RowVersionColumn]));
// Call the internal method to complete the operation.
MarkThree.Guardian.Core.Province.Update(adoTransaction, sqlTransaction, ref rowVersion, abbreviation, countryId, externalId0, externalId1, name, provinceId);
}
// Return values.
parameters["rowVersion"] = rowVersion;
}
/// <summary>Archives a Province 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 Province Table.
ServerMarketData.ProvinceDataTable provinceTable = ServerMarketData.Province;
// Extract the parameters from the command batch.
AdoTransaction adoTransaction = parameters["adoTransaction"];
SqlTransaction sqlTransaction = parameters["sqlTransaction"];
object configurationId = parameters["configurationId"].Value;
string externalProvinceId = parameters["provinceId"];
// The row versioning is largely disabled for external operations.
long rowVersion = long.MinValue;
// Find the internal identifier using the primar key elements.
// identifier is used to determine if a record exists with the same key.
int provinceId = Province.FindRequiredKey(configurationId, "provinceId", externalProvinceId);
// 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.
ServerMarketData.ProvinceRow provinceRow = provinceTable.FindByProvinceId(provinceId);
rowVersion = ((long)(provinceRow[provinceTable.RowVersionColumn]));
// Call the internal method to complete the operation.
MarkThree.Guardian.Core.Province.Archive(adoTransaction, sqlTransaction, rowVersion, provinceId);
}
/// <summary>Updates a Province 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="abbreviation">The value for the Abbreviation column.</param>
/// <param name="countryId">The value for the CountryId column.</param>
/// <param name="externalId0">The value for the ExternalId0 column.</param>
/// <param name="externalId1">The value for the ExternalId1 column.</param>
/// <param name="name">The value for the Name column.</param>
/// <param name="provinceId">The value for the ProvinceId column.</param>
public static void Update(AdoTransaction adoTransaction, SqlTransaction sqlTransaction, ref long rowVersion, object abbreviation, object countryId, object externalId0, object externalId1, object name, int provinceId)
{
// Accessor for the Province Table.
ServerMarketData.ProvinceDataTable provinceTable = ServerMarketData.Province;
// Rule #1: Make sure the record exists before updating it.
ServerMarketData.ProvinceRow provinceRow = provinceTable.FindByProvinceId(provinceId);
if ((provinceRow == null))
{
throw new Exception(string.Format("The Province table does not have an element identified by {0}", provinceId));
}
// Rule #2: Optimistic Concurrency Check
if ((provinceRow.RowVersion != rowVersion))
{
throw new System.Exception("This record is busy. Please try again later.");
}
// Apply Defaults
if ((abbreviation == null))
{
abbreviation = provinceRow[provinceTable.AbbreviationColumn];
}
if ((countryId == null))
{
countryId = provinceRow[provinceTable.CountryIdColumn];
}
if ((externalId0 == null))
{
externalId0 = provinceRow[provinceTable.ExternalId0Column];
}
if ((externalId1 == null))
{
externalId1 = provinceRow[provinceTable.ExternalId1Column];
}
if ((name == null))
{
name = provinceRow[provinceTable.NameColumn];
}
// Increment the row version
rowVersion = ServerMarketData.RowVersion.Increment();
// Update the record in the ADO database.
provinceRow[provinceTable.RowVersionColumn] = rowVersion;
provinceRow[provinceTable.AbbreviationColumn] = abbreviation;
provinceRow[provinceTable.CountryIdColumn] = countryId;
provinceRow[provinceTable.ExternalId0Column] = externalId0;
provinceRow[provinceTable.ExternalId1Column] = externalId1;
provinceRow[provinceTable.NameColumn] = name;
adoTransaction.DataRows.Add(provinceRow);
// Update the record in the SQL database.
SqlCommand sqlCommand = new SqlCommand("update \"Province\" set \"RowVersion\"=@rowVersion,\"Abbreviation\"=@abbreviation,\"Coun" +
"tryId\"=@countryId,\"ExternalId0\"=@externalId0,\"ExternalId1\"=@externalId1,\"Name\"=@" +
"name where \"ProvinceId\"=@provinceId");
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("@abbreviation", SqlDbType.NVarChar, 0, ParameterDirection.Input, false, 0, 0, null, DataRowVersion.Current, abbreviation));
sqlCommand.Parameters.Add(new SqlParameter("@countryId", SqlDbType.Int, 0, ParameterDirection.Input, false, 0, 0, null, DataRowVersion.Current, countryId));
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("@name", SqlDbType.NVarChar, 0, ParameterDirection.Input, false, 0, 0, null, DataRowVersion.Current, name));
sqlCommand.Parameters.Add(new SqlParameter("@provinceId", SqlDbType.Int, 0, ParameterDirection.Input, false, 0, 0, null, DataRowVersion.Current, provinceId));
// Update the record in the SQL database.
sqlCommand.ExecuteNonQuery();
}