Разработка:storages/accentryes - История изменений

Polikarpov в 07:14, 1 декабря 2014

2014-12-01T07:14:17Z

Polikarpov в 06:18, 1 декабря 2014

2014-12-01T06:18:34Z

Polikarpov в 06:46, 19 ноября 2014

2014-11-19T06:46:39Z

Polikarpov: /* get_history($accountid,$begindate=null,$enddate=null) */

2014-11-19T06:23:48Z

‎get_history($accountid,$begindate=null,$enddate=null)

Polikarpov: Новая страница: «{{Infobox_Plugin | name = accentryes | type = storages }} ===Таблица в базе данных=== ''accentryes'' - справочник операций по ...»

2014-11-18T06:39:03Z

Новая страница: «{{Infobox_Plugin | name = accentryes | type = storages }} ===Таблица в базе данных=== ''accentryes'' - справочник операций по ...»

Новая страница

{{Infobox_Plugin
| name = accentryes
| type = storages
}}

===Таблица в базе данных===
''accentryes'' - справочник операций по счетам. Все счета хранятся в справочнике [[Разработка:storages/accounts]].

====Подробный формат полей в таблице:====
* id - id операции.
* fromid - id счета-источника.
* toid - id счета-получателя.
* amount - сумма операции.
* orderid - id приказа, на основании которого совершена операция.
* createdate - дата фактической региcтрации проводки.
* date - дата выполнения операции.
* extentryopts - массив с опциями внешнего ключа.
* extentryoptshash - хеш опций внешнего ключа.
* about - пояснение операции.
* status - статус операции.

===Дополнительные методы:===

===='''Публичные методы:'''====

===='''add_accentry($ptype, $pcode, $objectid, $code, $type, $name, $params, $status = 'active')'''====

Добавляет новую операцию по счету в справочник.

''Аргументы:''
* $fromid(int) - счет, с которого списываем сумму.
* $toid(int) - счет, на который переводим сумму.
* $amount(float) - сумма операции.
* $orderid(int) - id приказа, в соответствии с которым совершена операция.
* $date(int) - дата, когда необходимо провести операцию.
* $extentryopts(array) - массив опций внешнего ключа.
* $about(string) - описание операции.
* $status(string) - статус операции.

''Возвращаемые значения:''
* object - объект операции.
* bool - false в случае ошибки.

''Структура работы:''
# Проверяем существование счета - источника и счета - получателя.
# Формируем объект для добавления в БД.
# Проверяем по хэшу, есть ли в системе такая операция.

===='''get_history($accountid,$begindate=null,$enddate=null) '''====

Получает историю операций по счету за определенный период.

''Аргументы:''
* $accountid(int) - id счета.
* $begindate(int) - начальная дата, если null - не учитывается.
* $enddate(int) - конечная дата, если null - не учитывается.

''Возвращаемые значения:''
* array - массив операций.
* bool - false в случае ошибки.

''Структура работы:''
# Метод проверяет входные данные.
# Производится формирование sql-фрагмента кода
# Подсчитывается баланс по счету после каждой проведенной операции

===='''Приватные методы:'''====

@@ Строка 24: / Строка 24: @@
 ===='''Публичные методы:'''====
-===='''generate_accentry_record($fromid, $toid, $amount, $date, $extentryopts, $about = '', $status = '')'''====
+===='''generate_accentry_record($fromid, $toid, $amount, $date, $extentryopts, $orderid = null, $about = '', $status = '')'''====
 Генерируем объект операции
-Метод генерации объекта операции. Для добавления объекта в справочник необходим id приказа, который создается на основе возвращенного этим методом объекта. Метод создан для предотвращения циклической зависимости между storage/accentryes и modlib/billing
+Метод генерации объекта операции.
 ''Аргументы:''
@@ Строка 36: / Строка 36: @@
 * $date(int) - дата, когда необходимо провести операцию.
 * $extentryopts(array) - массив опций внешнего ключа.
 * $about(string) - описание операции.
 * $status(string) - статус операции.
@@ Строка 42: / Строка 43: @@
 * object - объект операции.
 * bool - false в случае ошибки.
 ===='''add_accentry($accentryobj)'''====

@@ Строка 24: / Строка 24: @@
 ===='''Публичные методы:'''====
-===='''add_accentry($ptype, $pcode, $objectid, $code, $type, $name, $params, $status = 'active')'''====
+===='''generate_accentry_record($fromid, $toid, $amount, $date, $extentryopts, $about = '', $status = '')'''====
-Добавляет новую операцию по счету в справочник.
+Генерируем объект операции
 ''Аргументы:''
@@ Строка 32: / Строка 34: @@
 * $toid(int) - счет, на который переводим сумму.
 * $amount(float) - сумма операции.
 * $date(int) - дата, когда необходимо провести операцию.
 * $extentryopts(array) - массив опций внешнего ключа.
@@ Строка 42: / Строка 43: @@
 * bool - false в случае ошибки.
-''Структура работы:''
+===='''add_accentry($accentryobj)'''====
-# Проверяем существование счета - источника и счета - получателя.
-# Формируем объект для добавления в БД.
+Добавить проводку
-# Проверяем по хэшу, есть ли в системе такая операция.
 ===='''get_history($accountid,$begindate=null,$enddate=null) '''====
@@ Строка 80: / Строка 114: @@
 # Проверяются данные истории. Если история - пустой массив, тогда баланс = 0, если false, то произошла ошибка.
 # Возвращаем баланс или false в случае ошибки
 ===='''Приватные методы:'''====

@@ Строка 64: / Строка 64: @@
 # Производится формирование sql-фрагмента кода
 # Подсчитывается баланс по счету после каждой проведенной операции, операции, не удовлетворяющие условию по времени, удаляются.
 ===='''Приватные методы:'''====