LeadStatusHistoryEntry::register

static function register($ownerID, array $entityFields = null, array $options = null)
{
	if(!is_int($ownerID))
	{
		$ownerID = (int)$ownerID;
	}

	if($ownerID <= 0)
	{
		throw new Main\ArgumentException('Owner ID must be greater than zero.', 'ownerID');
	}

	if(!is_array($options))
	{
		$options = array();
	}

	if(!is_array($entityFields))
	{
		$dbResult = \CCrmLead::GetListEx(
			array(),
			array('=ID' => $ownerID, 'CHECK_PERMISSIONS' => 'N'),
			false,
			false,
			array('ID', 'STATUS_ID', 'ASSIGNED_BY_ID')
		);
		$entityFields = is_object($dbResult) ? $dbResult->Fetch() : null;
		if(!is_array($entityFields))
		{
			return false;
		}
	}

	$statusID = isset($entityFields['STATUS_ID']) ? $entityFields['STATUS_ID'] : '';
	if($statusID === '')
	{
		return false;
	}

	$responsibleID = isset($entityFields['ASSIGNED_BY_ID']) ? (int)$entityFields['ASSIGNED_BY_ID'] : 0;

	$time = isset($options['TIME']) ? $options['TIME'] : null;
	if($time === null)
	{
		$time = new DateTime();
	}

	$month = (int)$time->format('m');
	$quarter = $month <= 3 ? 1 : ($month <= 6 ? 2 : ($month <= 9 ? 3 : 4));
	$year = (int)$time->format('Y');

	$semanticID = \CCrmLead::GetSemanticID($statusID);

	$isNew = isset($options['IS_NEW']) ? (bool)$options['IS_NEW'] : false;
	$typeID = PhaseSemantics::isFinal($semanticID)
		? HistoryEntryType::FINALIZATION : ($isNew ? HistoryEntryType::CREATION : HistoryEntryType::MODIFICATION);

	$date = Date::createFromTimestamp($time->getTimestamp());

	$latest = self::getLatest($ownerID);
	if(is_array($latest) && $latest['STATUS_ID'] === $statusID)
	{
		return false;
	}

	$result = LeadStatusHistoryTable::add(
		array(
			'TYPE_ID' => $typeID,
			'OWNER_ID' => $ownerID,
			'CREATED_TIME' => $time,
			'CREATED_DATE' =>  $date,
			'PERIOD_YEAR' => $year,
			'PERIOD_QUARTER' => $quarter,
			'PERIOD_MONTH' => $month,
			'RESPONSIBLE_ID' => $responsibleID,
			'STATUS_ID' => $statusID,
			'STATUS_SEMANTIC_ID' => $semanticID,
			'IS_IN_WORK' =>  !$isNew ? 'Y' : 'N',
			'IS_JUNK' =>  PhaseSemantics::isLost($semanticID) ? 'Y' : 'N'
		)
	);

	if($result->isSuccess()
		&& $result->getId() > 0
		&& is_array($latest)
		&& ((int)$latest['TYPE_ID']) === HistoryEntryType::FINALIZATION)
	{
		LeadStatusHistoryTable::delete($latest['ID']);
	}

	LeadStatusHistoryWithSupposedEntry::register($ownerID);
	return true;
}