/// <summary>Updates a Folder record using Metadata Parameters.</summary>
/// <param name="transaction">Contains the parameters and exceptions for this command.</param>
public new static void Update(ParameterList parameters)
{
// Accessor for the Folder Table.
ServerDataModel.FolderDataTable folderTable = ServerDataModel.Folder;
// Extract the parameters from the command batch.
AdoTransaction adoTransaction = parameters["adoTransaction"];
SqlTransaction sqlTransaction = parameters["sqlTransaction"];
object configurationId = parameters["configurationId"].Value;
object description = parameters["description"].Value;
object groupPermission = parameters["groupPermission"].Value;
object hidden = parameters["hidden"].Value;
object name = parameters["name"].Value;
object owner = parameters["owner"].Value;
object ownerPermission = parameters["ownerPermission"].Value;
object readOnly = parameters["readOnly"].Value;
object worldPermission = parameters["worldPermission"].Value;
string externalFolderId = ((string)(parameters["folderId"]));
object externalTypeCode = parameters["typeCode"].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 folderId = Object.FindRequiredKey(configurationId, "folderId", externalFolderId);
object typeCode = Type.FindOptionalKey(configurationId, "typeCode", externalTypeCode);
// This disables the concurrency checking logic by finding the current row version and passing it to the
// internal method.
ServerDataModel.FolderRow folderRow = folderTable.FindByFolderId(folderId);
rowVersion = ((long)(folderRow[folderTable.RowVersionColumn]));
// Call the internal method to complete the operation.
MarkThree.Quasar.Core.Folder.Update(adoTransaction, sqlTransaction, ref rowVersion, description, null, null, null, null, null, null, null, null, groupPermission, hidden, name, owner, ownerPermission, readOnly, worldPermission, folderId, typeCode);
// Return values.
parameters["rowVersion"] = rowVersion;
}
/// <summary>ArchiveChildrens a Folder 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="folderId">The value for the FolderId column.</param>
/// <param name="archive">true to archive the object, false to unarchive it.</param>
internal static void ArchiveChildren(AdoTransaction adoTransaction, SqlTransaction sqlTransaction, long rowVersion, int folderId)
{
// Accessor for the Folder Table.
ServerDataModel.FolderDataTable folderTable = ServerDataModel.Folder;
// This record can be used to iterate through all the children.
ServerDataModel.FolderRow folderRow = folderTable.FindByFolderId(folderId);
// Archive the child records.
for (int index = 0; (index < folderRow.GetSystemFolderRows().Length); index = (index + 1))
{
ServerDataModel.SystemFolderRow childSystemFolderRow = folderRow.GetSystemFolderRows()[index];
SystemFolder.ArchiveChildren(adoTransaction, sqlTransaction, childSystemFolderRow.RowVersion, childSystemFolderRow.SystemFolderId);
}
// Increment the row version
rowVersion = ServerDataModel.RowVersion.Increment();
// Delete the record in the ADO database.
folderRow[folderTable.RowVersionColumn] = rowVersion;
adoTransaction.DataRows.Add(folderRow);
folderRow.Delete();
// Archive the record in the SQL database.
SqlCommand sqlCommand = new SqlCommand("update \"Folder\" set \"IsArchived\" = 1 where \"FolderId\"=@folderId");
sqlCommand.Connection = sqlTransaction.Connection;
sqlCommand.Transaction = sqlTransaction;
sqlCommand.Parameters.Add(new SqlParameter("@folderId", SqlDbType.Int, 0, ParameterDirection.Input, false, 0, 0, null, DataRowVersion.Current, folderId));
sqlCommand.ExecuteNonQuery();
}
/// <summary>Loads a Folder record using Metadata Parameters.</summary>
/// <param name="transaction">Contains the parameters and exceptions for this command.</param>
public new static void Load(ParameterList parameters)
{
// Accessor for the Folder Table.
ServerDataModel.FolderDataTable folderTable = ServerDataModel.Folder;
// Extract the parameters from the command batch.
AdoTransaction adoTransaction = parameters["adoTransaction"];
SqlTransaction sqlTransaction = parameters["sqlTransaction"];
object configurationId = parameters["configurationId"].Value;
object description = parameters["description"].Value;
object groupPermission = parameters["groupPermission"].Value;
object hidden = parameters["hidden"].Value;
string name = parameters["name"];
object owner = parameters["owner"].Value;
object ownerPermission = parameters["ownerPermission"].Value;
object readOnly = parameters["readOnly"].Value;
object worldPermission = parameters["worldPermission"].Value;
string externalFolderId = parameters["folderId"];
object externalTypeCode = parameters["typeCode"].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 folderId = Object.FindKey(configurationId, "folderId", externalFolderId);
object typeCode = Type.FindOptionalKey(configurationId, "typeCode", externalTypeCode);
ServerDataModel.FolderRow folderRow = folderTable.FindByFolderId(folderId);
// 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 ((folderRow == null))
{
// 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 = Folder.GetExternalKeyIndex(configurationId, "folderId");
object[] externalIdArray = new object[8];
externalIdArray[externalKeyIndex] = externalFolderId;
object externalId0 = externalIdArray[0];
object externalId1 = externalIdArray[1];
object externalId2 = externalIdArray[2];
object externalId3 = externalIdArray[3];
object externalId4 = externalIdArray[4];
object externalId5 = externalIdArray[5];
object externalId6 = externalIdArray[6];
object externalId7 = externalIdArray[7];
// Call the internal method to complete the operation.
MarkThree.Quasar.Core.Folder.Insert(adoTransaction, sqlTransaction, ref rowVersion, description, externalId0, externalId1, externalId2, externalId3, externalId4, externalId5, externalId6, externalId7, groupPermission, hidden, name, owner, ownerPermission, readOnly, worldPermission, typeCode);
}
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.
rowVersion = ((long)(folderRow[folderTable.RowVersionColumn]));
// Call the internal method to complete the operation.
MarkThree.Quasar.Core.Folder.Update(adoTransaction, sqlTransaction, ref rowVersion, description, null, null, null, null, null, null, null, null, groupPermission, hidden, name, owner, ownerPermission, readOnly, worldPermission, folderId, typeCode);
}
// Return values.
parameters["rowVersion"] = rowVersion;
}
/// <summary>Inserts a Folder 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="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>
/// <param name="externalId4">The value for the ExternalId4 column.</param>
/// <param name="externalId5">The value for the ExternalId5 column.</param>
/// <param name="externalId6">The value for the ExternalId6 column.</param>
/// <param name="externalId7">The value for the ExternalId7 column.</param>
/// <param name="groupPermission">The value for the GroupPermission column.</param>
/// <param name="hidden">The value for the Hidden column.</param>
/// <param name="name">The value for the Name column.</param>
/// <param name="owner">The value for the Owner column.</param>
/// <param name="ownerPermission">The value for the OwnerPermission column.</param>
/// <param name="readOnly">The value for the ReadOnly column.</param>
/// <param name="worldPermission">The value for the WorldPermission column.</param>
/// <param name="typeCode">The value for the TypeCode column.</param>
public new static int Insert(
AdoTransaction adoTransaction,
SqlTransaction sqlTransaction,
ref long rowVersion,
object description,
object externalId0,
object externalId1,
object externalId2,
object externalId3,
object externalId4,
object externalId5,
object externalId6,
object externalId7,
object groupPermission,
object hidden,
string name,
object owner,
object ownerPermission,
object readOnly,
object worldPermission,
object typeCode)
{
// Accessor for the Folder Table.
ServerDataModel.FolderDataTable folderTable = ServerDataModel.Folder;
// Apply Defaults
if ((typeCode == null))
{
typeCode = "Folder";
}
// Insert the base members using the base class.
int folderId = Object.Insert(adoTransaction, sqlTransaction, ref rowVersion, description, externalId0, externalId1, externalId2, externalId3, externalId4, externalId5, externalId6, externalId7, groupPermission, hidden, name, owner, ownerPermission, readOnly, typeCode, worldPermission);
// Increment the row version
rowVersion = ServerDataModel.RowVersion.Increment();
// Insert the record into the ADO database.
ServerDataModel.FolderRow folderRow = folderTable.NewFolderRow();
folderRow[folderTable.RowVersionColumn] = rowVersion;
folderRow[folderTable.FolderIdColumn] = folderId;
folderTable.AddFolderRow(folderRow);
adoTransaction.DataRows.Add(folderRow);
// Insert the record into the SQL database.
SqlCommand sqlCommand = new SqlCommand("insert \"Folder\" (\"rowVersion\",FolderId) values (@rowVersion,@folderId)");
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("@folderId", SqlDbType.Int, 0, ParameterDirection.Input, false, 0, 0, null, DataRowVersion.Current, folderId));
sqlCommand.ExecuteNonQuery();
// Return Statements
return(folderRow.FolderId);
}
/// <summary>Updates a Folder 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="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>
/// <param name="externalId4">The value for the ExternalId4 column.</param>
/// <param name="externalId5">The value for the ExternalId5 column.</param>
/// <param name="externalId6">The value for the ExternalId6 column.</param>
/// <param name="externalId7">The value for the ExternalId7 column.</param>
/// <param name="groupPermission">The value for the GroupPermission column.</param>
/// <param name="hidden">The value for the Hidden column.</param>
/// <param name="name">The value for the Name column.</param>
/// <param name="owner">The value for the Owner column.</param>
/// <param name="ownerPermission">The value for the OwnerPermission column.</param>
/// <param name="readOnly">The value for the ReadOnly column.</param>
/// <param name="worldPermission">The value for the WorldPermission column.</param>
/// <param name="folderId">The value for the FolderId column.</param>
/// <param name="typeCode">The value for the TypeCode column.</param>
public static void Update(
AdoTransaction adoTransaction,
SqlTransaction sqlTransaction,
ref long rowVersion,
object description,
object externalId0,
object externalId1,
object externalId2,
object externalId3,
object externalId4,
object externalId5,
object externalId6,
object externalId7,
object groupPermission,
object hidden,
object name,
object owner,
object ownerPermission,
object readOnly,
object worldPermission,
int folderId,
object typeCode)
{
// Accessor for the Folder Table.
ServerDataModel.FolderDataTable folderTable = ServerDataModel.Folder;
// Rule #1: Make sure the record exists before updating it.
ServerDataModel.FolderRow folderRow = folderTable.FindByFolderId(folderId);
if ((folderRow == null))
{
throw new Exception(string.Format("The Folder table does not have an element identified by {0}", folderId));
}
// Rule #2: Optimistic Concurrency Check
if ((folderRow.RowVersion != rowVersion))
{
throw new System.Exception("This record is busy. Please try again later.");
}
// Apply Defaults
// Insert the base members using the base class. Note that optimistic concurrency is only used
// by the top level type in the hierarchy, it is bypassed after you pass the first test.
long baseRowVersion = folderRow.ObjectRow.RowVersion;
Object.Update(adoTransaction, sqlTransaction, ref baseRowVersion, description, externalId0, externalId1, externalId2, externalId3, externalId4, externalId5, externalId6, externalId7, groupPermission, hidden, name, folderId, owner, ownerPermission, readOnly, typeCode, worldPermission);
// Increment the row version
rowVersion = ServerDataModel.RowVersion.Increment();
// Update the record in the ADO database.
folderRow[folderTable.RowVersionColumn] = rowVersion;
adoTransaction.DataRows.Add(folderRow);
// Update the record in the SQL database.
}
/// <summary>Archives a Folder 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="folderId">The value for the FolderId column.</param>
/// <param name="archive">true to archive the object, false to unarchive it.</param>
public new static void Archive(AdoTransaction adoTransaction, SqlTransaction sqlTransaction, long rowVersion, int folderId)
{
// Accessor for the Folder Table.
ServerDataModel.FolderDataTable folderTable = ServerDataModel.Folder;
// Rule #1: Make sure the record exists before updating it.
ServerDataModel.FolderRow folderRow = folderTable.FindByFolderId(folderId);
if ((folderRow == null))
{
throw new Exception(string.Format("The Folder table does not have an element identified by {0}", folderId));
}
// Rule #2: Optimistic Concurrency Check
if ((folderRow.RowVersion != rowVersion))
{
throw new System.Exception("This record is busy. Please try again later.");
}
// Delete the base class record. Note that optimistic concurrency is only used
// by the top level type in the hierarchy, it is bypassed after you pass the first test.
long baseRowVersion = folderRow.ObjectRow.RowVersion;
Object.Archive(adoTransaction, sqlTransaction, baseRowVersion, folderId);
}
/// <summary>Archives a Folder record using Metadata Parameters.</summary>
/// <param name="transaction">Contains the parameters and exceptions for this command.</param>
public new static void Archive(ParameterList parameters)
{
// Accessor for the Folder Table.
ServerDataModel.FolderDataTable folderTable = ServerDataModel.Folder;
// Extract the parameters from the command batch.
AdoTransaction adoTransaction = parameters["adoTransaction"];
SqlTransaction sqlTransaction = parameters["sqlTransaction"];
object configurationId = parameters["configurationId"].Value;
string externalFolderId = parameters["folderId"];
// 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;
// Find the internal identifier using the primary key elements.
// identifier is used to determine if a record exists with the same key.
int folderId = Folder.FindRequiredKey(configurationId, "folderId", externalFolderId);
// This disables the concurrency checking logic by finding the current row version and passing it to the
// internal method.
ServerDataModel.FolderRow folderRow = folderTable.FindByFolderId(folderId);
rowVersion = ((long)(folderRow[folderTable.RowVersionColumn]));
// Call the internal method to complete the operation.
MarkThree.Quasar.Core.Folder.Archive(adoTransaction, sqlTransaction, rowVersion, folderId);
}
