ВЖурнал

Помещает существующую связь документов или создает новую и помещает её в журнал документов (то есть управляет записями о связях документов).

Синтаксис

ВЖурнал(ТипЖурнала[, ВидЗаписи][, Дата][, Сумма][, Связь|, Документ][, Комментарий])

Параметры

ТипЖурнала (текст) – тип журнала, в котором необходимо сделать запись. В программе существуют следующие журналы:

Список типов журналов может быть расширен разработчиками.

ВидЗаписи (текст) – вид записи в журнале. Возможны следующие значения: "Оплата", "Отгрузка", "Регистрация", "Переуступка долга", "Включать в сделку", "Поставка", "Сторно", "Планирование". Соответствующий флаг будет установлен на записи связи документов. Причём можно установить сразу несколько флагов, перечислив нужные значения через символ "+". Параметр можно не указывать, в этом случае никаких флагов на связи установлено не будет. Если в журнал помещается существующая связь, то указанные флаги изменены не будут.

Дата (дата) – дата записи в журнале. Если параметр не указан, то берётся дата документа. А если помещается существующая связь, то берется дата связи.

Сумма (число) – сумма записи в журнале. Если параметр не указан, берётся сумма документа или сумма существующей связи.

Связь (объект) – объект с записью о связи документов. Если указан такой объект, то новая запись в журналах документов создаваться не будет, просто данная запись будет помещена в указанный журнал документов. При этом, если в вызове функции были указаны сумма, дата или вид записи, то они будут изменены. Если параметр "Связь" не указан, то ищется контекстный объект с именем "Связь". И если таковой находится, то функция изменяет запись этого объекта.

Повторный вызов функции "ВЖурнал" для той же связи приведёт уже к добавлению новой записи о связи, а не к изменению указанной связи.

Документ (объект) – документ, с которым будет связан текущий документ. Этот параметр используется только, если не указан параметр "Связь". Причём в этом случае, создаётся новая запись о связи документов: указанный документ будет документом-основанием, а текущий документ – документом-следствием. Если функция не нашла объект "Связь" и не указан параметр "Документ", то берётся для связывания текущий документ.

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

Комментарий (текст) – комментарий, который заносится в одноименное поле журнала. При указании комментария обязательно должен быть указан параметр "ВидЗаписи" (хотя бы пустой).

Возвращает

Объект – новая или измененная запись журнала документов.

Комментарии

Чтобы поместить запись в конкретный раздел журнала, необходимо указать параметр вида "ТипЖурнала.Название". Если указанного раздела в журнале не существует, то в журнале будет создан этот раздел и будет помещена в него запись.

Примеры

Сделать запись о текущем документе в книге продаж:

ВЖурнал("Продажа");

Сделать запись о связи документов в книге продаж:

ДляВсех(Оснований("НаклРасх"))
   ВЖурнал("Продажа");

См. также:

•  Документ