/// <summary>Updates a BlotterMap 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 BlotterMap Table.
ServerDataModel.BlotterMapDataTable blotterMapTable = ServerDataModel.BlotterMap;
// Extract the parameters from the command batch.
AdoTransaction adoTransaction = parameters["adoTransaction"];
SqlTransaction sqlTransaction = parameters["sqlTransaction"];
object configurationId = parameters["configurationId"].Value;
string externalBlotterMapId = ((string)(parameters["blotterMapId"]));
object externalSecurityId = parameters["securityId"].Value;
object externalBlotterId = parameters["blotterId"].Value;
object minimumQuantity = parameters["minimumQuantity"].Value;
object maximumQuantity = parameters["maximumQuantity"].Value;
// The row versioning is largely disabled for external operations.
long rowVersion = long.MinValue;
// Resolve External Identifiers
int blotterMapId = BlotterMap.FindRequiredKey(configurationId, "blotterMapId", externalBlotterMapId);
object securityId = Security.FindOptionalKey(configurationId, "securityId", externalSecurityId);
object blotterId = Blotter.FindOptionalKey(configurationId, "blotterId", externalBlotterId);
// 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.BlotterMapRow blotterMapRow = blotterMapTable.FindByBlotterMapId(blotterMapId);
rowVersion = ((long)(blotterMapRow[blotterMapTable.RowVersionColumn]));
// Call the internal method to complete the operation.
MarkThree.Quasar.Core.BlotterMap.Update(adoTransaction, sqlTransaction, ref rowVersion, blotterMapId, securityId, blotterId, minimumQuantity, maximumQuantity, null, null);
// Return values.
parameters["rowVersion"] = rowVersion;
}
/// <summary>Finds a a BlotterMap 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="externalId">The external identifier for the record.</param>
public static int FindRequiredKey(object configurationId, string parameterId, string externalId)
{
// Look up the internal identifier using the configuration to select the ExternalId column and the external identifier to identify the record
int internalId = BlotterMap.FindKey(configurationId, parameterId, externalId);
if ((internalId == int.MinValue))
{
throw new Exception(string.Format("The BlotterMap table does not have a record identified by \'{0}\'", externalId));
}
// Return the internal identifier.
return internalId;
}
/// <summary>Loads a BlotterMap 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 BlotterMap Table.
ServerDataModel.BlotterMapDataTable blotterMapTable = ServerDataModel.BlotterMap;
// Extract the parameters from the command batch.
AdoTransaction adoTransaction = parameters["adoTransaction"];
SqlTransaction sqlTransaction = parameters["sqlTransaction"];
object configurationId = parameters["configurationId"].Value;
object externalBlotterMapId = parameters["blotterMapId"].Value;
string externalSecurityId = parameters["securityId"];
string externalBlotterId = parameters["blotterId"];
object minimumQuantity = parameters["minimumQuantity"].Value;
object maximumQuantity = parameters["maximumQuantity"].Value;
object externalId0 = parameters["externalId0"].Value;
object externalId1 = parameters["externalId1"].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 blotterMapId = BlotterMap.FindKey(configurationId, "blotterMapId", externalBlotterMapId);
int securityId = Security.FindRequiredKey(configurationId, "securityId", externalSecurityId);
int blotterId = Blotter.FindRequiredKey(configurationId, "blotterId", externalBlotterId);
// 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 ((blotterMapId == 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 = BlotterMap.GetExternalKeyIndex(configurationId, "blotterMapId");
object[] externalIdArray = new object[2];
externalIdArray[externalKeyIndex] = externalBlotterMapId;
externalId0 = externalIdArray[0];
externalId1 = externalIdArray[1];
// Call the internal method to complete the operation.
MarkThree.Quasar.Core.BlotterMap.Insert(adoTransaction, sqlTransaction, ref rowVersion, securityId, blotterId, minimumQuantity, maximumQuantity, externalId0, externalId1);
}
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.
ServerDataModel.BlotterMapRow blotterMapRow = blotterMapTable.FindByBlotterMapId(blotterMapId);
rowVersion = ((long)(blotterMapRow[blotterMapTable.RowVersionColumn]));
// Call the internal method to complete the operation.
MarkThree.Quasar.Core.BlotterMap.Update(adoTransaction, sqlTransaction, ref rowVersion, blotterMapId, securityId, blotterId, minimumQuantity, maximumQuantity, externalId0, externalId1);
}
// Return values.
parameters["rowVersion"] = rowVersion;
}
/// <summary>Finds a a BlotterMap 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="externalId">The external (user supplied) identifier for the record.</param>
public static object FindOptionalKey(object configurationId, string parameterId, object externalId)
{
// Look up the internal identifier using the the configuration to specify which ExternalId column to use as an index.
object internalId = null;
if ((externalId != null))
{
internalId = BlotterMap.FindKey(configurationId, parameterId, ((string)(externalId)));
if ((((int)(internalId)) == int.MinValue))
{
throw new Exception(string.Format("The BlotterMap table does not have a record identified by \'{0}\'", externalId));
}
}
// Return the internal identifier.
return internalId;
}
/// <summary>Finds a a BlotterMap 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 BlotterMap Table.
ServerDataModel.BlotterMapDataTable blotterMapTable = ServerDataModel.BlotterMap;
// 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 = BlotterMap.GetExternalKeyIndex(configurationId, parameterId);
System.Data.DataView externalKeyView = BlotterMap.externalKeyArray[externalKeyIndex];
int recordIndex = externalKeyView.Find(new object[] {
externalId});
if ((recordIndex == -1))
{
return int.MinValue;
}
return ((int)(externalKeyView[recordIndex].Row[blotterMapTable.BlotterMapIdColumn]));
}
/// <summary>Archives a BlotterMap 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 BlotterMap Table.
ServerDataModel.BlotterMapDataTable blotterMapTable = ServerDataModel.BlotterMap;
// Extract the parameters from the command batch.
AdoTransaction adoTransaction = parameters["adoTransaction"];
SqlTransaction sqlTransaction = parameters["sqlTransaction"];
object configurationId = parameters["configurationId"].Value;
string externalBlotterMapId = parameters["blotterMapId"];
// 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 blotterMapId = BlotterMap.FindRequiredKey(configurationId, "blotterMapId", externalBlotterMapId);
// 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.BlotterMapRow blotterMapRow = blotterMapTable.FindByBlotterMapId(blotterMapId);
rowVersion = ((long)(blotterMapRow[blotterMapTable.RowVersionColumn]));
// Call the internal method to complete the operation.
MarkThree.Quasar.Core.BlotterMap.Archive(adoTransaction, sqlTransaction, rowVersion, blotterMapId);
}