/**
* Instantiate an array of CustomFieldSelections from a Database Result
* @param DatabaseResultBase $objDbResult
* @return CustomFieldSelection[]
*/
public static function InstantiateDbResult(QDatabaseResultBase $objDbResult, $strExpandAsArrayNodes = null)
{
$objToReturn = array();
// If blank resultset, then return empty array
if (!$objDbResult) {
return $objToReturn;
}
// Load up the return array with each row
if ($strExpandAsArrayNodes) {
$objLastRowItem = null;
while ($objDbRow = $objDbResult->GetNextRow()) {
$objItem = CustomFieldSelection::InstantiateDbRow($objDbRow, null, $strExpandAsArrayNodes, $objLastRowItem);
if ($objItem) {
array_push($objToReturn, $objItem);
$objLastRowItem = $objItem;
}
}
} else {
while ($objDbRow = $objDbResult->GetNextRow()) {
array_push($objToReturn, CustomFieldSelection::InstantiateDbRow($objDbRow));
}
}
return $objToReturn;
}
/**
* This loads an expanded array of CustomFieldSelections and their associated values
* The values for each selection can be accessed by looping through: $CustomFieldSelections[$i]->CustomFieldValue->ShortDescription
*
* @param integer $intAssetId
* @param integer $intCustomAssetFieldId
* @param string $strOrderBy
* @param string $strLimit
* @param ExpansionMap Object $objExpansionMap
* @return CustomAssetFieldSelection
*/
public static function LoadExpandedArray($intEntityId, $intEntityQtypeId, $intCustomFieldId, $strOrderBy = null, $strLimit = null, $objExpansionMap = null)
{
// Expand to include Values
$objExpansionMap[CustomFieldSelection::ExpandCustomFieldValue] = true;
// Call to ArrayQueryHelper to Get Database Object and Get SQL Clauses
CustomFieldSelection::ArrayQueryHelper($strOrderBy, $strLimit, $strLimitPrefix, $strLimitSuffix, $strExpandSelect, $strExpandFrom, $objExpansionMap, $objDatabase);
// Properly Escape All Input Parameters using Database->SqlVariable()
$intEntityId = $objDatabase->SqlVariable($intEntityId);
$intEntityQtypeId = $objDatabase->SqlVariable($intEntityQtypeId);
$intCustomFieldId = $objDatabase->SqlVariable($intCustomFieldId);
$strQuery = sprintf('
SELECT
%s
`custom_field_selection`.*
%s
FROM
`custom_field_selection`
%s
WHERE
`custom_field_selection` . `entity_id` = %s AND
`custom_field_selection` . `entity_qtype_id` = %s AND
`custom_field_selection__custom_field_value_id` . `custom_field_id` = %s
%s
%s', $strLimitPrefix, $strExpandSelect, $strExpandFrom, $intEntityId, $intEntityQtypeId, $intCustomFieldId, $strOrderBy, $strLimitSuffix);
// Perform the Query and Instantiate the Result
$objDbResult = $objDatabase->Query($strQuery);
return CustomFieldSelection::InstantiateDbRow($objDbResult->GetNextRow());
}
/**
* Instantiate a CustomFieldValue from a Database Row.
* Takes in an optional strAliasPrefix, used in case another Object::InstantiateDbRow
* is calling this CustomFieldValue::InstantiateDbRow in order to perform
* early binding on referenced objects.
* @param DatabaseRowBase $objDbRow
* @param string $strAliasPrefix
* @return CustomFieldValue
*/
public static function InstantiateDbRow($objDbRow, $strAliasPrefix = null, $strExpandAsArrayNodes = null, $objPreviousItem = null)
{
// If blank row, return null
if (!$objDbRow) {
return null;
}
// See if we're doing an array expansion on the previous item
if ($strExpandAsArrayNodes && $objPreviousItem && $objPreviousItem->intCustomFieldValueId == $objDbRow->GetColumn($strAliasPrefix . 'custom_field_value_id', 'Integer')) {
// We are. Now, prepare to check for ExpandAsArray clauses
$blnExpandedViaArray = false;
if (!$strAliasPrefix) {
$strAliasPrefix = 'custom_field_value__';
}
if (array_key_exists($strAliasPrefix . 'customfieldasdefault__custom_field_id', $strExpandAsArrayNodes) && !is_null($objDbRow->GetColumn($strAliasPrefix . 'customfieldasdefault__custom_field_id'))) {
if ($intPreviousChildItemCount = count($objPreviousItem->_objCustomFieldAsDefaultArray)) {
$objPreviousChildItem = $objPreviousItem->_objCustomFieldAsDefaultArray[$intPreviousChildItemCount - 1];
$objChildItem = CustomField::InstantiateDbRow($objDbRow, $strAliasPrefix . 'customfieldasdefault__', $strExpandAsArrayNodes, $objPreviousChildItem);
if ($objChildItem) {
array_push($objPreviousItem->_objCustomFieldAsDefaultArray, $objChildItem);
}
} else {
array_push($objPreviousItem->_objCustomFieldAsDefaultArray, CustomField::InstantiateDbRow($objDbRow, $strAliasPrefix . 'customfieldasdefault__', $strExpandAsArrayNodes));
}
$blnExpandedViaArray = true;
}
if (array_key_exists($strAliasPrefix . 'customfieldselection__custom_field_selection_id', $strExpandAsArrayNodes) && !is_null($objDbRow->GetColumn($strAliasPrefix . 'customfieldselection__custom_field_selection_id'))) {
if ($intPreviousChildItemCount = count($objPreviousItem->_objCustomFieldSelectionArray)) {
$objPreviousChildItem = $objPreviousItem->_objCustomFieldSelectionArray[$intPreviousChildItemCount - 1];
$objChildItem = CustomFieldSelection::InstantiateDbRow($objDbRow, $strAliasPrefix . 'customfieldselection__', $strExpandAsArrayNodes, $objPreviousChildItem);
if ($objChildItem) {
array_push($objPreviousItem->_objCustomFieldSelectionArray, $objChildItem);
}
} else {
array_push($objPreviousItem->_objCustomFieldSelectionArray, CustomFieldSelection::InstantiateDbRow($objDbRow, $strAliasPrefix . 'customfieldselection__', $strExpandAsArrayNodes));
}
$blnExpandedViaArray = true;
}
// Either return false to signal array expansion, or check-to-reset the Alias prefix and move on
if ($blnExpandedViaArray) {
return false;
} else {
if ($strAliasPrefix == 'custom_field_value__') {
$strAliasPrefix = null;
}
}
}
// Create a new instance of the CustomFieldValue object
$objToReturn = new CustomFieldValue();
$objToReturn->__blnRestored = true;
$objToReturn->intCustomFieldValueId = $objDbRow->GetColumn($strAliasPrefix . 'custom_field_value_id', 'Integer');
$objToReturn->intCustomFieldId = $objDbRow->GetColumn($strAliasPrefix . 'custom_field_id', 'Integer');
$objToReturn->strShortDescription = $objDbRow->GetColumn($strAliasPrefix . 'short_description', 'Blob');
$objToReturn->intCreatedBy = $objDbRow->GetColumn($strAliasPrefix . 'created_by', 'Integer');
$objToReturn->dttCreationDate = $objDbRow->GetColumn($strAliasPrefix . 'creation_date', 'DateTime');
$objToReturn->intModifiedBy = $objDbRow->GetColumn($strAliasPrefix . 'modified_by', 'Integer');
$objToReturn->strModifiedDate = $objDbRow->GetColumn($strAliasPrefix . 'modified_date', 'VarChar');
// Instantiate Virtual Attributes
foreach ($objDbRow->GetColumnNameArray() as $strColumnName => $mixValue) {
$strVirtualPrefix = $strAliasPrefix . '__';
$strVirtualPrefixLength = strlen($strVirtualPrefix);
if (substr($strColumnName, 0, $strVirtualPrefixLength) == $strVirtualPrefix) {
$objToReturn->__strVirtualAttributeArray[substr($strColumnName, $strVirtualPrefixLength)] = $mixValue;
}
}
// Prepare to Check for Early/Virtual Binding
if (!$strAliasPrefix) {
$strAliasPrefix = 'custom_field_value__';
}
// Check for CustomField Early Binding
if (!is_null($objDbRow->GetColumn($strAliasPrefix . 'custom_field_id__custom_field_id'))) {
$objToReturn->objCustomField = CustomField::InstantiateDbRow($objDbRow, $strAliasPrefix . 'custom_field_id__', $strExpandAsArrayNodes);
}
// Check for CreatedByObject Early Binding
if (!is_null($objDbRow->GetColumn($strAliasPrefix . 'created_by__user_account_id'))) {
$objToReturn->objCreatedByObject = UserAccount::InstantiateDbRow($objDbRow, $strAliasPrefix . 'created_by__', $strExpandAsArrayNodes);
}
// Check for ModifiedByObject Early Binding
if (!is_null($objDbRow->GetColumn($strAliasPrefix . 'modified_by__user_account_id'))) {
$objToReturn->objModifiedByObject = UserAccount::InstantiateDbRow($objDbRow, $strAliasPrefix . 'modified_by__', $strExpandAsArrayNodes);
}
// Check for CustomFieldAsDefault Virtual Binding
if (!is_null($objDbRow->GetColumn($strAliasPrefix . 'customfieldasdefault__custom_field_id'))) {
if ($strExpandAsArrayNodes && array_key_exists($strAliasPrefix . 'customfieldasdefault__custom_field_id', $strExpandAsArrayNodes)) {
array_push($objToReturn->_objCustomFieldAsDefaultArray, CustomField::InstantiateDbRow($objDbRow, $strAliasPrefix . 'customfieldasdefault__', $strExpandAsArrayNodes));
} else {
$objToReturn->_objCustomFieldAsDefault = CustomField::InstantiateDbRow($objDbRow, $strAliasPrefix . 'customfieldasdefault__', $strExpandAsArrayNodes);
}
}
// Check for CustomFieldSelection Virtual Binding
if (!is_null($objDbRow->GetColumn($strAliasPrefix . 'customfieldselection__custom_field_selection_id'))) {
if ($strExpandAsArrayNodes && array_key_exists($strAliasPrefix . 'customfieldselection__custom_field_selection_id', $strExpandAsArrayNodes)) {
array_push($objToReturn->_objCustomFieldSelectionArray, CustomFieldSelection::InstantiateDbRow($objDbRow, $strAliasPrefix . 'customfieldselection__', $strExpandAsArrayNodes));
} else {
$objToReturn->_objCustomFieldSelection = CustomFieldSelection::InstantiateDbRow($objDbRow, $strAliasPrefix . 'customfieldselection__', $strExpandAsArrayNodes);
}
}
return $objToReturn;
}
