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

 

Глава 26
Работа с последовательностями документов


 

«Последовательности документов» являются вспомогательными объектами метаданных для компонент «Оперативный учет» и «Бухгалтерский учет». Они предназначены для обеспечения проведения определенных документов в непрерывной хронологической последовательности.

При создании последовательности определяется, какие виды документов входят в данную последовательность, а также виды движений, влияющих на последовательность. Виды движений определяют, какие из изменений итогов будут влиять на необходимость перепроведения документов данной последовательности, то есть итоги каких механизмов учета используются документами данной последовательности при проведении.

Например, для организации правильного списания товаров следует в качестве движения, влияющего на последовательность указать регистр оперативного учета, на котором ведется стоимостной учет товаров или, если учет ведется на бухгалтерских счетах, указать счет, на котором ведется учет товаров. В качестве документов, на проведение которых будет влиять данная последовательность, следует указать те виды документов, которые будут анализировать при проведении указанный регистр или остатки по указанному счету. Например, такими документами могут быть расходные накладные, накладные на передачу на реализацию и т. п.

Подробнее о последовательностях документов следует читать в книге «Руководство по конфигурированию и администрированию».

Контекст работы с последовательностями

Несмотря на то, что механизм отслеживания и восстановления последовательности документов отрабатывает системой автоматически, средства языка предоставляют возможность непосредственного доступа к методам последовательностей. Доступ к методам возможен в любом программном модуле (все объявленные в конфигураторе последовательности принадлежат глобальному контексту конфигурации). Во всех текстах программных модулей вызовы методов последовательностей можно записывать просто через точку после полного имени последовательности. Полное имя последовательности записывается следующим образом:

Последовательность.<ХХХХХ>

где <ХХХХХ> — идентификатор последовательности, объявленный в конфигураторе.

Англоязычный синоним ключевого слова ПоследовательностьSequence.

Пример:

Последовательность.УправленческийУчет.Установить(ТекущийДокумент())

Методы последовательностей

ПолучитьПозицию

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

Синтаксис:

ПолучитьПозицию()

Англоязычный синоним:

GetPosition

Возвращаемое значение:

32-х символьное строковое значение позиции Границы Последовательности.

Описание:

Метод ПолучитьПозицию возвращает позицию Границы Последовательности.

Пример:

ГП = Последовательность.УправленческийУчет.ПолучитьПозицию();

Получить

Получить строковое представление Границы Последовательности.

Синтаксис:

Получить()

Англоязычный синоним:

Get

Возвращаемое значение:

Строковое представление Границы Последовательности.

Описание:

Метод Получить возвращает строковое представление Границы Последовательности.

Пример:

ПредставлениеГП = Последовательность.УправленческийУчет.Получить();

ПолучитьДокумент

Получить документ Границы Последовательности.

Синтаксис:

ПолучитьДокумент()

Англоязычный синоним:

GetDocument

Возвращаемое значение:

Документ Границы Последовательности.

Описание:

Метод ПолучитьДокумент возвращает документ Границы Последовательности.

Пример:

ПокумГП = Последовательность.УправленческийУчет.ПолучитьДокумент();

ПолучитьДату

Получить дату Границы Последовательности.

Синтаксис:

ПолучитьДату()

Англоязычный синоним:

GetDate

Возвращаемое значение:

Дата Границы Последовательности.

Описание:

Метод ПолучитьДату возвращает дату Границы Последовательности.

Пример:

ДатаГП = Последовательность.УправленческийУчет.ПолучитьДату();

ПолучитьВремя

Получить время Границы Последовательности.

Синтаксис:

ПолучитьВремя(<Часы>, <Минуты>, <Секунды>)

Англоязычный синоним:

GetTime

Параметры:

<Часы>

Идентификатор переменной, в которую метод возвращает строковое значение часа ГП.

<Минуты>

Идентификатор переменной, в которую метод возвращает строковое значение минут ГП.

<Ceкyнды>

Идентификатор переменной, в которую метод возвращает строковое значение секунд ГП.

Возвращаемое значение:

Строковое значение времени Границы Последовательности в виде "ЧЧ.ММ.СС".

Описание:

Метод ПолучитьВремя возвращает время Границы Последовательности.

Пример:

Функция ВремяГП()

   Перем Ч;

   Перем М;

   Перем С;

   ВремяГП = Последовательность.УправленческийУчет.ПолучитьВремя();

   Возврат "Время ГП в " + Ч + " час " + М + " мин. " + С + " с";

КонецФункции

Установить

Установить ГП на новую дату документ или позицию.

Синтаксис:

Установить(<ПоложениеГП>)

Англоязычный синоним:

Set

Параметры:

<ПоложениеГП>

Выражение типа «дата», «документ» или «позиция документа», на который устанавливается ГП.

Описание:

Метод Установить изменяет положение Границы Последовательности на начало даты или документа.

Внимание. Следует особо обратить внимание, что механизм последовательности документов отрабатывает системой автоматически, поэтому метод Установить можно применять только в особых случаях, в основном, чтобы ГП принудительно отодвинуть назад, так как при установке вперед документы не перерасчитываются.

Пример:

Последовательность.УправленческийУчет.Установить(ТекущийДокумент());

Сравнить

Сравнить ГП с датой, документом или позицией.

Синтаксис:

Сравнить(<Докум>)

Англоязычный синоним:

Compare

Параметры:

<Докум>

Выражение типа «дата», «документ» или «позиция документа», с которым сравнивается ГП.

Возвращаемое значение:

Число: -1 (минус единица), если ГП меньше (раньше); 0 если равны; 1 если ГП больше (позже).

Описание:

Метод Сравнить сравнивает ГП с датой, документом или позицией документа.

Пример:

Если Последовательность.УправленческийУчет.Сравнить(Док) = 1 Тогда

   Последовательность.УправленческийУчет.Установить(Док);

КонецЕсли;

ПринадлежитПоследовательности

Определить, принадлежит ли последовательности заданный документ или вид, заданный строкой.

Синтаксис:

ПринадлежитПоследовательности(<Докум>}

Англоязычный синоним:

BelongSequence

Параметры:

<Докум>

Выражение типа «документ» или «строка», определяющая вид документа.

Возвращаемое значение:

Число: 1 — если документ принадлежит последовательности; 0 — если не принадлежит.

Описание:

Метод ПринадлежитПоследовательности позволяет определить, принадлежит ли последовательности заданный документ или вид, заданный строкой.

Пример:

Если Последовательность.УпрУчет.ПринадлежитПоследовательности(Док) = 1 Тогда

   Если Последовательность.УпрУчет.Сравнить(Док) = 1 Тогда

      Последовательность.УпрУчет.Установить(Док);

   КонецЕсли;

КонецЕсли;

Проверить

Проверяет, является ли последовательность непрерывной от ГП до заданного документа.

Синтаксис:

Проверить(<Докум>)

Англоязычный синоним:

Validate

Параметры:

<Докум>

Выражение типа «дата», «документ» или «позиция документа», от которой проверяется непрерывность последовательности.

Возвращаемое значение:

Число: 1 если последовательность непрерывна; 0 если есть проведенные документы между ГП и документом.

Описание:

Метод Проверить проверяет, есть ли между ГП и данной точкой проведенные документы входящие в даную последовательность (т. е. является ли последовательность непрерывной от ГП до этой точки).

Пример:

Если Последовательность.УправленческийУчет.Проверить(Док) = 1 Тогда

   Последовательность.УправленческийУчет.Установить(Док);

КонецЕсли;



Перейти  к оглавлению: Описание встроенного языка

Hosted by uCoz