/// <summary>Finds a a Province 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 = Province.FindKey(configurationId, parameterId, externalId); if ((internalId == int.MinValue)) { throw new Exception(string.Format("The Province table does not have a record identified by \'{0}\'", externalId)); } // Return the internal identifier. return internalId; }
/// <summary>Finds a a Province 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 = Province.FindKey(configurationId, parameterId, ((string)(externalId))); if ((((int)(internalId)) == int.MinValue)) { throw new Exception(string.Format("The Province table does not have a record identified by \'{0}\'", externalId)); } } // Return the internal identifier. return internalId; }
/// <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; }