Название вида документа.
Синтаксис:
Вид()
Англоязычный синоним:
Kind
Возвращаемое значение:
Строковое значение, содержащее название вида документа, как он задан в конфи гураторе.
Описание:
Метод Вид возвращает название вида документа, как он задан в конфигураторе.
Пример:
Если (Док.Вид() = "ДоплатаПроцентом") ИЛИ (Док.Вид() = "ДоплатаСуммой") Тогда
Сотр = Док.Сотрудник;
Иначе
Предупреждение("Это не доплата!");
КонецЕсли;
Определить пользовательское представление вида документа.
Синтаксис:
ПредставлениеВида()
Англоязычный синоним:
KindPresent
Возвращаемое значение:
Строковое значение, содержащее пользовательское представление вида документа (синоним документа или, если он пустой, то идентификатор).
Описание:
Метод ПредставлениеВида позволяет получить пользовательское представление вида документа, как оно задано в конфигураторе.
Пример:
// отобразим пользовательское представление в строке состояния
Состояние(ВыбДокум.ПредставлениеВида());
Установить значение реквизита по имени идентификатора.
Синтаксис:
УстановитьАтрибут(<ИмяРеквизита>, <3начение>)
Англоязычный синоним:
SetAttrib
Параметры:
|
<ИмяРеквизита> |
Строковое выражение, содержащее имя реквизита, как оно задано в конфигураторе. |
|
<3начение> |
Выражение, содержащее устанавливаемое значение реквизита. |
Описание:
Метод УстановитьАтрибут позволяет установить значение реквизита по имени идентификатора, как оно задано в конфигураторе.
Пример:
Док.УстановитьАтрибут("ЦенаРозн", ЦенаТов);
Получить значение реквизита но имени идентификатора.
Синтаксис:
ПолучитьАтрибут(<ИмяРеквизита>)
Англоязычный синоним:
GetAttrib
Параметры:
|
<ИмяРеквизита> |
Строковое выражение, содержащее имя реквизита, как оно задано в конфигураторе. |
Возвращаемое значение:
Значение реквизита <ИмяРеквизита>.
Описание:
Метод ПолучитьАтрибут позволяет получить значение реквизита по имени идентификатора, как оно задано в конфигураторе.
Пример:
ЦенаДок = Док.ПолучитьАтрибут("Цена");
Возвратить флаг выбора документа.
Синтаксис:
Выбран()
Англоязычный синоним:
Selected
Возвращаемое значение:
Числовое значение: 1 — если документ выбран, 0 — если документ не выбран.
Описание:
Метод Выбран позволяет проверить сам факт позиционирования объекта типа «документ».
Пример:
Док = СоздатьОбъект("Документ.ПрихНакл");
// позиционируем документ по номеру
Док.НайтиПоНомеру("1", 0);
Если Док.Выбран() = 1 Тогда
// если документ найден
// открываем выборку строк спецификации документа
Док.ВыбратьСтроки();
// цикл выбора строк спецификации документа
Если Док.КоличествоСтрок() > 0 Тогда
Пока Док.ПолучитьСтроку() = 1 Цикл
Док.УдалитьСтроку();
КонецЦикла;
КонецЕсли;
КонецЕсли;
Возвратить флаг проводки документа.
Синтаксис:
Проведен()
Англоязычный синоним:
IsTransacted
Возвращаемое значение:
Числовое значение: 1 — если документ проведен, 0 — если документ не проведен.
Описание:
Метод Проведен позволяет проверить сам факт проведения документа.
Пример:
Процедура ПолучитьПроведенные()
Док = СоздатьОбъект("Документ");
// Откроем выборку документов
Док.ВыбратьДокументы(ДатаНачала, ДатаКонца);
// Цикл выбора документов
Пока Док.ПолучитьДокумент() > 0 Цикл
Если Док.Проведен() > 0 Тогда
// для проведенных документов выведем сообщение
Сообщить(Строка(Док.Вид())+" № "+Док.НомерДок+" от "+Док.ДатаДок);
КонецЕсли;
КонецЦикла;
КонецПроцедуры
Определить значение текущего документа.
Синтаксис:
ТекущийДокумент()
Англоязычный синоним:
CurrentDocument
Возвращаемое значение:
Значение текущего документа.
Описание:
Метод ТекущийДокумент возвращает значение позиционированного текущего документа (в целом, как объекта). Данный метод применяется, например, если нужно документ передать как параметр в вызове какого-либо метода или присвоить какому-либо реквизиту.
Пример:
Если Режим = "Подробный" Тогда
// используем объект типа «документ» неопределенного вида
Док = СоздатьОбъект("Документ");
// Откроем выборку документов
Док.ВыбратьДокументы(ДатаНачала, ДатаОкончания);
// Цикл выбора документов
Пока Док.ПолучитьДокумент() > 0 Цикл
// присвоим переменной ТекДок значение найденного документа
ТекДок = Док.ТекущийДокумент();
// ...
КонецЦикла;
КонецЕсли;
Вызов диалога для выбора документа.
Синтаксис:
Выбрать(<Подсказка>, <ФормаЖурнала>, <КомуПодч>)
Англоязычный синоним:
Choose
Параметры:
|
<Подсказка> |
Текст заголовка окна диалога ввода. Может использоваться в качестве подсказки конечному пользователю. |
|
<ФормаЖурнала> |
Строковое выражение идентификатора той формы журнала документа (как он объявлен в конфигураторе), которая должна использоваться для выбора. Если это значение пустое, то используется форма журнала по умолчанию.. Можно указывать имя объекта в следующем виде: · "Журнал.ХХХХХ", где ХХХХХ — имя вида соответствующего объекта, как он задан в конфигураторе, например: "Справочник.Товары"; · "Журнал.Подчиненные"; · "ЖурналОпераций"; · "ЖурналОпераций.YYYYY", где YYYYY — имя формы журнала операций, как оно задано в конфигураторе; |
|
<КомуПодч> |
Необязательный параметр. Используется при открытии выбора по журналу подчиненных документов, т.е когда второй параметр <ФормаЖурнала> имеет значение "Журнал.Подчиненные". В данном случае в этом параметре передается документ-владелец, по которому следует построить журнал подчиненных документов. |
Возвращаемое значение:
Числовое значение: 1 — если документ выбран; 0 — если не выбран.
Описание:
Метод Выбрать вызывает диалоговое окно для выбора документа и затем позиционирует выбранный документ в качестве текущего. Данный метод может использоваться только для объектов, созданных функцией СоздатьОбъект.
Пример:
Док = СоздатьОбъект("Документ.НаклПрих");
// вызываем диалог выбора документа
Если Док.Выбрать("Найди документ") > 0 Тогда
// удаляем выбранный документ
Док.Удалить();
КонецЕсли;
См. также: ВидыДляВыбора
Установка выбираемых видов для объекта типа «документ» неопределенного вида.
Синтаксис:
ВидыДляВыбора(<СписокВидов>)
Англоязычный синоним:
KindsForChoice
Параметры:
|
<СписокВидов> |
Необязательный параметр. Строковое выражение содержащее список видов выбираемых документов, разделенных запятыми. |
Возвращаемое значение:
Строковое значение, содержащее текущий список видов выбираемых документов, разделенных запятыми (на момент до исполнения метода).
Описание:
Метод ВидыДляВыбора устанавливает выбираемые виды для объекта-документ неопределенного вида. Данный метод обычно используется до начала интерактивного позиционирования документа, например, при помощи метода Выбрать.
Данный метод может использоваться только для объектов типа «документ» неопределенного вида — либо созданных функцией СоздатьОбъект, либо определенных в конфигураторе как реквизиты диалога или другого объекта. Если метод ВидыДляВыбора применен к реквизиту диалога типа «документ» неопределенного вида, то интерактивный выбор будет производиться только среди установленных видов документов.
Пример:
// данная процедура присваивает некоторому реквизиту "НаОсновании"
// значение конкретного документа
Процедура УстДокОснования()
// Создадим объект типа «документ» неопределенного вида
Дкм = СоздатьОбъект("Документ");
Дкм.ВидыДляВыбора("РасходнаяНакл, Счет");
// Вызываем диалог выбора документа
Если Дкм.Выбрать("Выберите документ основания", "") > 0 Тогда
НаОсновании = Дкм.ТекущийЭлемент();
КонецЕсли;
КонецПроцедуры
См. также: Выбрать
Итоговое значение реквизита документа.
Синтаксис:
Итог(<ИмяРеквизита>)
Англоязычный синоним:
Total
Параметры:
|
<ИмяРеквизита> |
Строковое выражение, содержащее имя реквизита табличной части документа, для которого в конфигураторе установлено свойство «Итог по колонке». |
Возвращаемое значение:
Числовое значение — сумма по всем строкам табличной части документа для реквизита <ИмяРеквизита>.
Описание:
Метод Итог позволяет определить сумму значений по всем строкам табличной части документа для реквизита <ИмяРеквизита>.
Данный метод может быть использован только для реквизитов табличной части документов, для которых установлено свойство «Итог по колонке» (закладка «Дополнительные» свойств реквизита документа в конфигураторе).
Пример:
Процедура ВычСреднего()
// вычислим среднюю сумму по наряду
Сумма = Итог("Сумма");
Штук = Итог("Штук");
Если Штук <> 0 Тогда
Средн = Сумма / Штук;
Иначе;
Средн = 0;
КонецЕсли;
КонецПроцедуры
Определить количество строк в документе.
Синтаксис:
КоличествоСтрок()
Англоязычный синоним:
LinesCnt
Возвращаемое значение:
Числовое значение — количество строк в документе.
Описание:
Метод КоличествоСтрок позволяет определить количество строк в многострочной части документа.
Пример:
Сообщить("Документ: " + Вид() + " № " + НомерДок + " от " + ДатаДок +
" в документе " + КоличествоСтрок() + " строк");
Найти документ по значению.
Синтаксис:
НайтиДокумент(<Документ>)
Англоязычный синоним:
FindDocument
Параметры:
|
<Документ> |
Выражение, содержащее значение типа «Документ». |
Возвращаемое значение:
Число 1 — если действие выполнено (документ найден);
Число 0 — если действие не выполнено.
Описание:
Метод НайтиДокумент выполняет поиск документа по значению, заданному параметром <Документ>. Данный метод используется для позиционирования объекта на конкретный документ.
Данный метод может использоваться только для объектов, созданных функцией СоздатьОбъект.
Пример:
Процедура УдалДок(Докум)
Док = СоздатьОбъект("Документ.НаклПрих");
// позиционируем созданный объект на заданном документе
Док.НайтиДокумент(Докум);
Если Док.Выбран() > 0 Тогда
// если документ найден, то удалим его
Док.Удалить();
Иначе
Предупреждение ("Неверно задан документ!");
КонецЕсли;
КонецПроцедуры
Найти документ по номеру.
Синтаксис:
НайтиПоНомеру(<Номер>, <Дата>, <ИдентВида>)
Англоязычный синоним:
FindByNum
Параметры:
|
<Номер> |
Строковое выражение, содержащее значение номера искомого документа. |
|
<Дата> |
Выражение типа «дата». |
|
<ИдентВида> |
Необязательный параметр. Строковое выражение, содержащее идентификатор вида документа или идентификатор Нумератора. |
Возвращаемое значение:
Число 1 — если действие выполнено (документ найден);
Число 0 — если действие не выполнено.
Описание:
Метод НайтиПоНомеру позиционирует документ по номеру. В качестве второго параметра задается любая дата из диапазона, в котором нужно искать документ с данным номером. Поиск зависит от выбранного в конфигураторе способа уникальности номеров (по месяцу, году и др.).
Метод может быть использован для объекта Документ общего вида, тогда для поиска нужно указать в параметре <ИдентВида> идентификатор вида документа или идентификатор Нумератора.
Данный метод может использоваться только для объектов, созданных функцией СоздатьОбъект.
Пример:
Если ВвестиЧисло(Ном, "Введите номер приказа", 5, 0) = 1 Тогда
Док=СоздатьОбъект("Документ.ПриказыУвольнения");
// позиционируем документ по заданному номеру
Док.НайтиПоНомеру(Строка(Ном), Дата(0));
Если Док.Выбран() = 1 Тогда
Документ=Док.ТекущийДокумент();
// ...
КонецЕсли;
КонецЕсли;
Получить строку документа по номеру.
Синтаксис:
ПолучитьСтрокуПоНомеру(<Номер>)
Англоязычный синоним:
GetLineByNum
Параметры:
|
<Номер> |
Выражение, содержащее номер искомой строки. |
Возвращаемое значение:
Число 1 — если действие выполнено;
Число 0 — если действие не выполнено.
Описание:
Метод ПолучитьСтрокуПоНомеру устанавливает в качестве текущей строки спецификации документа строку с заданным номером (не порядковым, а тем, который записан в строке, т. к. могут быть пропуски).
Пример:
Процедура УдалЗаданнойСтроки(Док, Стр)
Если Док.Выбран() = 1 Тогда
// если переданный параметр содержит значение документа, то
// найдем в нем строку
Док.ПолучитьСтрокуПоНомеру(Стр);
// удалим найденную строку спецификации документа
Док.УдалитьСтроку();
Иначе
Предупреждение("Документ не выбран!");
КонецЕсли;
КонецЕсли;
Открыть выборку документов.
Синтаксис:
ВыбратьДокументы(<НачалоВыборки>, <КонецВыборки>)
Англоязычный синоним:
SelectDocuments
Параметры:
|
<НачалоВыборки> |
Необязательный параметр. Выражение типа дата, документ или позиция документа, с которого устанавливается начало выборки документов. Если данный параметр опущен, то выборка начинается с самого первого существующего в системе документа. |
|
<КонецВыборки> |
Необязательный параметр. Выражение типа дата, документ или позиция документа, на котором устанавливается конец выборки документов. Если данный параметр опущен, то выборка заканчивается самым последним существующим в системе документом. |
Возвращаемое значение:
Число 1 — если действие выполнено и в выборке есть хотя бы один документ;
Число 0 — если действие не выполнено или в выборке нет ни одного документа.
Описание:
Метод ВыбратьДокументы открывает выборку документов в интервале с <НачалоВыборки> по <КонецВыборки>.
Непосредственно сама выборка осуществляется при помощи метода ПолучитьДокумент в порядке возрастания даты и времени записи документов (если не задан обратный порядок методом ОбратныйПорядок).
Данный метод может использоваться только для объектов, созданных функцией СоздатьОбъект.
Пример:
Если Режим = "Подробный" Тогда
Док = СоздатьОбъект("Документ");
// открываем выборку документов
Док.ВыбратьДокументы(ДатаНачало, ДатаКонец);
// цикл получения документов
Пока Док.ПолучитьДокумент() > 0 Цикл
ТекДок = Док.ТекущийДокумент();
КонецЦикла;
КонецЕсли;
См. также: ПолучитьДокумент, ОбратныйПорядок
Открыть выборку подчиненных документов.
Синтаксис:
ВыбратьПодчиненныеДокументы(<НачалоВыборки>, <КонецВыборки>, <Докум>)
Англоязычный синоним:
SelectChildDocs
Параметры:
|
<НачалоВыборки> |
Необязательный параметр. Выражение типа дата, документ или позиция документа, с которого устанавливается начало выборки документов. Если данный параметр опущен, то выборка начинается с самого первого существующего в системе документа. |
|
<КонецВыборки> |
Необязательный параметр. Выражение типа дата, документ или позиция документа, на котором устанавливается конец выборки документов. Если данный параметр опущен, то выборка заканчивается самым последним существующим в системе документом. |
|
<Докум> |
Выражение типа «документ», содержащее значение документа-владельца, подчиненные которому будут включаться в выборку. |
Возвращаемое значение:
Число: 1 — если действие выполнено и в выборке есть хотя бы один документ; 0 — если действие не выполнено или в выборке нет ни одного документа.
Описание:
Метод ВыбратьПодчиненныеДокументы открывает выборку всех документов, подчиненных заданному документу <Докум> в интервале с <НачалоВыборки> по <КонецВыборки>. Непосредственно сама выборка осуществляется при помощи метода ПолучитьДокумент в порядке возрастания даты и времени записи документов (если не задан обратный порядок методом ОбратныйПорядок).
Данный метод может использоваться только для объектов, созданных функцией СоздатьОбъект.
Пример:
//Проверка того, что по Счету были документы отгрузки
ДокТест = СоздатьОбъект("Документ");
// открываем выборку документов
ДокТест.ВыбратьПодчиненныеДокументы('01.01.80', '31.12.99', ПоСчету);
// получение документа
Если ДокТест.ПолучитьДокумент() = 1 Тогда
Предупреждение("По данному Счету были отгрузки!");
КонецЕсли;
См. также: ПолучитьДокумент, ОбратныйПорядок
Открыть выборку документов по значению.
Синтаксис:
ВыбратьПоЗначению(<НачалоВыборки>, <КонецВыборки>, <ИмяОтбора>, <3нач>)
Англоязычный синоним:
SelectByValue
Параметры:
|
<НачалоВыборки> |
Необязательный параметр. Выражение типа дата, документ или позиция документа, с которого устанавливается начало выборки документов. Если данный параметр опущен, то выборка начинается с самого первого существующего в системе документа. |
|
<КонецВыборки> |
Необязательный параметр. Выражение типа дата, документ или позиция документа, на котором устанавливается конец выборки документов. Если данный параметр опущен, то выборка заканчивается самым последним существующим в системе документом. |
|
<ИмяОтбора> |
Строковое выражение, которое содержит либо название «общего реквизита» документов, либо название «графы отбора» журналов, как они заданы в конфигураторе. |
|
<3нач> |
Значение отбора, по которому строится выборка документов. |
Возвращаемое значение:
Число 1 — если действие выполнено и в выборке есть хотя бы один документ; 0 — если действие не выполнено или в выборке нет ни одного документа.
Описание:
Метод ВыбратьПоЗначению открывает выборку документов в интервале с <НачалоВыборки> по <КонецВыборки>, для которых реквизит отбора <ИмяОтбора> имеет конкретное заданное значение <3нач>.
Непосредственно сама выборка осуществляется при помощи метода ПолучитьДокумент в порядке возрастания даты и времени записи документов (если не задан обратный порядок методом ОбратныйПорядок).
Данный метод может использоваться только для объектов, созданных функцией СоздатьОбъект.
Пример:
Если Режим = "Подробный" Тогда
Док = СоздатьОбъект("Документ");
// открываем выборку документов
Док.ВыбратьПоЗначению(ДатаНачало, ДатаКонец, "Автор", "Сидоров");
// цикл получения документов
Пока Док.ПолучитьДокумент() > 0 Цикл
ТекДок = Док.ТекущийДокумент();
КонецЦикла;
КонецЕсли;
См. также: