«Последовательности документов» являются вспомогательными объектами метаданных для компонент «Оперативный учет» и «Бухгалтерский учет». Они предназначены для обеспечения проведения определенных документов в непрерывной хронологической последовательности.
При создании последовательности определяется, какие виды документов входят в данную последовательность, а также виды движений, влияющих на последовательность. Виды движений определяют, какие из изменений итогов будут влиять на необходимость перепроведения документов данной последовательности, то есть итоги каких механизмов учета используются документами данной последовательности при проведении.
Например, для организации правильного списания товаров следует в качестве движения, влияющего на последовательность указать регистр оперативного учета, на котором ведется стоимостной учет товаров или, если учет ведется на бухгалтерских счетах, указать счет, на котором ведется учет товаров. В качестве документов, на проведение которых будет влиять данная последовательность, следует указать те виды документов, которые будут анализировать при проведении указанный регистр или остатки по указанному счету. Например, такими документами могут быть расходные накладные, накладные на передачу на реализацию и т. п.
Подробнее о последовательностях документов следует читать в книге «Руководство по конфигурированию и администрированию».
Несмотря на то, что механизм отслеживания и восстановления последовательности документов отрабатывает системой автоматически, средства языка предоставляют возможность непосредственного доступа к методам последовательностей. Доступ к методам возможен в любом программном модуле (все объявленные в конфигураторе последовательности принадлежат глобальному контексту конфигурации). Во всех текстах программных модулей вызовы методов последовательностей можно записывать просто через точку после полного имени последовательности. Полное имя последовательности записывается следующим образом:
Последовательность.<ХХХХХ>
где <ХХХХХ> — идентификатор последовательности, объявленный в конфигураторе.
Англоязычный синоним ключевого слова Последовательность — Sequence.
Пример:
Последовательность.УправленческийУчет.Установить(ТекущийДокумент())
Получить позицию Границы Последовательности.
Синтаксис:
ПолучитьПозицию()
Англоязычный синоним:
GetPosition
Возвращаемое значение:
32-х символьное строковое значение позиции Границы Последовательности.
Описание:
Метод ПолучитьПозицию возвращает позицию Границы Последовательности.
Пример:
ГП = Последовательность.УправленческийУчет.ПолучитьПозицию();
Получить строковое представление Границы Последовательности.
Синтаксис:
Получить()
Англоязычный синоним:
Get
Возвращаемое значение:
Строковое представление Границы Последовательности.
Описание:
Метод Получить возвращает строковое представление Границы Последовательности.
Пример:
ПредставлениеГП = Последовательность.УправленческийУчет.Получить();
Получить документ Границы Последовательности.
Синтаксис:
ПолучитьДокумент()
Англоязычный синоним:
GetDocument
Возвращаемое значение:
Документ Границы Последовательности.
Описание:
Метод ПолучитьДокумент возвращает документ Границы Последовательности.
Пример:
ПокумГП = Последовательность.УправленческийУчет.ПолучитьДокумент();
Получить дату Границы Последовательности.
Синтаксис:
ПолучитьДату()
Англоязычный синоним:
GetDate
Возвращаемое значение:
Дата Границы Последовательности.
Описание:
Метод ПолучитьДату возвращает дату Границы Последовательности.
Пример:
ДатаГП = Последовательность.УправленческийУчет.ПолучитьДату();
Получить время Границы Последовательности.
Синтаксис:
ПолучитьВремя(<Часы>, <Минуты>, <Секунды>)
Англоязычный синоним:
GetTime
Параметры:
|
<Часы> |
Идентификатор переменной, в которую метод возвращает строковое значение часа ГП. |
|
<Минуты> |
Идентификатор переменной, в которую метод возвращает строковое значение минут ГП. |
|
<Ceкyнды> |
Идентификатор переменной, в которую метод возвращает строковое значение секунд ГП. |
Возвращаемое значение:
Строковое значение времени Границы Последовательности в виде "ЧЧ.ММ.СС".
Описание:
Метод ПолучитьВремя возвращает время Границы Последовательности.
Пример:
Функция ВремяГП()
Перем Ч;
Перем М;
Перем С;
ВремяГП = Последовательность.УправленческийУчет.ПолучитьВремя();
Возврат "Время ГП в " + Ч + " час " + М + " мин. " + С + " с";
КонецФункции
Установить ГП на новую дату документ или позицию.
Синтаксис:
Установить(<ПоложениеГП>)
Англоязычный синоним:
Set
Параметры:
|
<ПоложениеГП> |
Выражение типа «дата», «документ» или «позиция документа», на который устанавливается ГП. |
Описание:
Метод Установить изменяет положение Границы Последовательности на начало даты или документа.
Внимание. Следует особо обратить внимание, что механизм последовательности документов отрабатывает системой автоматически, поэтому метод Установить можно применять только в особых случаях, в основном, чтобы ГП принудительно отодвинуть назад, так как при установке вперед документы не перерасчитываются.
Пример:
Последовательность.УправленческийУчет.Установить(ТекущийДокумент());
Сравнить ГП с датой, документом или позицией.
Синтаксис:
Сравнить(<Докум>)
Англоязычный синоним:
Compare
Параметры:
|
<Докум> |
Выражение типа «дата», «документ» или «позиция документа», с которым сравнивается ГП. |
Возвращаемое значение:
Число: -1 (минус единица), если ГП меньше (раньше); 0 если равны; 1 если ГП больше (позже).
Описание:
Метод Сравнить сравнивает ГП с датой, документом или позицией документа.
Пример:
Если Последовательность.УправленческийУчет.Сравнить(Док) = 1 Тогда
Последовательность.УправленческийУчет.Установить(Док);
КонецЕсли;
Определить, принадлежит ли последовательности заданный документ или вид, заданный строкой.
Синтаксис:
ПринадлежитПоследовательности(<Докум>}
Англоязычный синоним:
BelongSequence
Параметры:
|
<Докум> |
Выражение типа «документ» или «строка», определяющая вид документа. |
Возвращаемое значение:
Число: 1 — если документ принадлежит последовательности; 0 — если не принадлежит.
Описание:
Метод ПринадлежитПоследовательности позволяет определить, принадлежит ли последовательности заданный документ или вид, заданный строкой.
Пример:
Если Последовательность.УпрУчет.ПринадлежитПоследовательности(Док) = 1 Тогда
Если Последовательность.УпрУчет.Сравнить(Док) = 1 Тогда
Последовательность.УпрУчет.Установить(Док);
КонецЕсли;
КонецЕсли;
Проверяет, является ли последовательность непрерывной от ГП до заданного документа.
Синтаксис:
Проверить(<Докум>)
Англоязычный синоним:
Validate
Параметры:
|
<Докум> |
Выражение типа «дата», «документ» или «позиция документа», от которой проверяется непрерывность последовательности. |
Возвращаемое значение:
Число: 1 если последовательность непрерывна; 0 если есть проведенные документы между ГП и документом.
Описание:
Метод Проверить проверяет, есть ли между ГП и данной точкой проведенные документы входящие в даную последовательность (т. е. является ли последовательность непрерывной от ГП до этой точки).
Пример:
Если Последовательность.УправленческийУчет.Проверить(Док) = 1 Тогда
Последовательность.УправленческийУчет.Установить(Док);
КонецЕсли;
