Наименование

Наименование счета.

Синтаксис:

Наименование

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

Description

Описание:

Наименование счета представляет собой произвольную строку символов. Наименование, как правило, разъясняет назначение счета. Максимальная длина наименования счета задается при редактировании свойств планов счетов в Конфигураторе.

При помощи атрибута Наименование можно получать и задавать наименование счета.

Пример:

* При показе готового табличного документа (в данном примере это отчет «Карточка счета») в заголовке окна выдается наименование отчета, код и наименование счета, по которому построен отчет.

// Формирование отчета "Карточка счета"

Табл = СоздатьОбъект("Таблица");

// ...

<команды формирования отчета и выдачи секций табличного документа>

// ...

// Показ готового отчета

Табл.Показать("Карточка счета: " + Счет.Код + " " + Счет.Наименование);

Наименование

Наименование группы видов расчета или вида расчета.

Синтаксис:

Наименование

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

Descriptor

Описание:

Атрибут типа «строка». Представляет собой строку, соответствующую комментарию, заданному при конфигурировании.

Пример:

ВР01 = ВидРасчета.ПоОкладу;

ВРО2 = Вид Расчета.АмортизацияС_НДС;

Группа = ГруппаРасчетов.ОблагаютсяНалогом;

Сообщить("Это расчет " + ВР01.Наименование);

Сообщить(ВР02.Наименование + " " + ВР02.Код);

Сообщить(Строка(Группа.Наименование));

См. также: Наименование

Найти

Найти вхождение подстроки.

Синтаксис:

Найти(<Строка1>, <Строка2>)

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

Find

Параметры:

<Строка1>

Строковое выражение места поиска.

<Строка2>

Строковое выражение шаблона поиска.

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

Числовое значение позиции первого знака найденной подстроки.

Описание:

Функция Найти находит вхождение строки <Строка2> как подстроки в <Строка1>. Возвращает числовое значение позиции первого знака найденной подстроки (первая позиция имеет индекс 1). Если не находит — возвращает число 0.

Пример:

Симв = Найти(ФИО, "Борис");

Найти

Найти запись по индексу.

Синтаксис:

Найти(<Ключ>, <Режим>)

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

Find

Параметры:

<Ключ>

Строковое выражение со значением выражения текущего индекса.

<Режим>

Числовое выражение. Режим поиска записей:

0 — ищет запись на точное соответствие ключу (=);

1 — ищет запись на точное соответствие с ключом или большую (>=);

2 — ищет запись с большим ключом (>);

-1 (минус единица) — ищет запись на точное соответствие с ключом или меньшую(<=);

-2 (минус два) — ищет запись с меньшим ключом (<).

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

Число: 1 — если действие выполнено (запись найдена); 0 — если действие не выполнено.

Описание:

Метод Найти позволяет найти запись, соответствующую данному значению <Ключ> ключа по текущему индексу и режиму поиска, переданному в качестве параметра. Указатель устанавливается на найденную запись.

Следует отметить, что вычисление значения индекса при работе XBase-объекта с базой данных производится объектом самостоятельно на основании выражения, переданного ему при создании ключа (см. описание метода ДобавитьИндекс). При вызове данного метода значение <Ключ> должно быть вычислено средствами встроенного языка, что может представлять определенные трудности, если индекс составной, поля, включенные в выражение индекса, отличны от строковых, и т. д. Поэтому применимость данного метода ограничена случаем использования простых строковых выражений индекса. В более сложных случаях следует применять универсальный метод НайтиПоКлючу.

Пример:

ЗаписьНайдена = ДБФ.Найти("Иванов", 0);

НайтиДокумент

Найти документ по значению.

Синтаксис:

НайтиДокумент(<Документ>)

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

FindDocument

Параметры:

<Документ>

Выражение, содержащее значение типа «Документ».

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

Число 1 — если действие выполнено (документ найден);

Число 0 — если действие не выполнено.

Описание:

Метод НайтиДокумент выполняет поиск документа по значению, заданному параметром <Документ>. Данный метод используется для позиционирования объекта на конкретный документ.

Данный метод может использоваться только для объектов, созданных функцией СоздатьОбъект.

Пример:

Процедура УдалДок(Докум)

Док = СоздатьОбъект("Документ.НаклПрих");

// позиционируем созданный объект на заданном документе

Док.НайтиДокумент(Докум);

Если Док.Выбран() > 0 Тогда

// если документ найден, то удалим его

Док.Удалить();

Иначе

Предупреждение ("Неверно задан документ!");

КонецЕсли;

КонецПроцедуры

НайтиЭлемент

Найти элемент справочника по значению.

Синтаксис:

НайтиЭлемент(<Элемент>)

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

Findltem

Параметры:

<Элемент>

Выражение со значением элемента справочника.

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

Число 1 — если действие выполнено;

Число 0 — если действие не выполнено (элемент не найден).

Описание:

Метод НайтиЭлемент выполняет поиск элемента справочника по значению, заданному параметром <Элемент>, и позиционирует объект справочник на этом элементе.

Данный метод может использоваться только для объектов, созданных функцией СоздатьОбъект.

Пример:

// НашБанк должен иметь тип «справочник.Банки»

Бнк = СоздатьОбъект("Справочник.Банки");

Бнк.ИспользоватьДату(ДатаДок);

Если НашБанк.Выбран() = 1 Тогда

// Позиционируем созданный объект Бнк на заданном элементе

Бнк.НайтиЭлемент(НашБанк);

Процент = Бнк.Процент;

НазваниеБанка = Бнк.Наименование;

КонецЕсли;

См. также: ТекущийЭлемент

НайтиОперацию

Позиционирует объект по значению типа «Документ».

Синтаксис:

НайтиОперацию([<Документ>])

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

FindOper

Параметры:

<Документ>

Значение типа «Документ».

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

Число: 1 — действие выполнено, операция найдена; 0 — действие не выполнено, операция не найдена.

Описание:

Метод НайтиОперацию осуществляет поиск операции по значению типа «Документ».

В системе 1С:Предприятие каждая операция принадлежит документу. Причем операция принадлажит только одному документу, а у документа может существовать только одна операция. Операции введенные вручную принадлежат документам специального вида «Операция».

Поэтому не существует возможности передачи такого значения как «Операция». Для «идентификации» операции фактически используется значение документа, которому она принадлежит. Поэтому для позиционировании объекта «Операция» непосредственно на конкретную операцию используется значение типа «Документ».

Пример:

Опер = СоздатьОбъект("Операция");

Опер.НайтиОперацию(ВыбрДокумент);

НайтиПервыйФайл

Открывает выборку файлов по заданной маске и находит первый файл.

Синтаксис:

НайтиПервыйФайл(<МаскаИмени>)

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

FindFirstFile

Параметры:

<МаскаИмени>

Строковое выражение с маской имен файлов. В строке маски можно использовать символ "*", что означает наличие любого числа произвольных символов. Символ "?" в строке маски означает наличие одного произвольного символа.

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

Строка с именем найденного файла.

Описание:

Метод НайтиПервыйФайл находит первый файл и открывает выборку файлов по заданной маске.

Замечание. Методы НайтиПервыйФайл и НайтиСледующийФайл возвращают имена файлов в той же последовательности, как это делает команда Dir операционной системы MS DOS, т. е. если задана маска "*.*"для некорневого каталога, первым возвращаемым значением будет "." — обозначающая ссылку на текущий каталог. Имя следующего файла будет ".." — обозначающее ссылку на каталог уровнем выше. При получении следующих файлов возвращаемым значением будет имя найденного файла.

Пример:

* В данном примере приведена процедура открытия выборки файлов по заданной маске.

Процедура ПервФ()

Результат = ФС.НайтиПервыйФайл("*.*");

КонецПроцедуры

См. также: НайтиСледующийФайл

НайтиПоКлючу

Найти запись по индексу.

Синтаксис:

НайтиПоКлючу(<Режим>)

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

FindByKey

Параметры:

<Режим>

Числовое выражение. Режим поиска записей:

0 — ищет запись на точное соответствие ключу (=);

1 — ищет запись на точное соответствие с ключом или большую (>=);

2 — ищет запись с большим ключом (>);

-1 (минус единица) — ищет запись на точное соответствие с ключом или меньшую(<=);

-2 (минус два) — ищет запись с меньшим ключом (<).

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

Число: 1 — если действие выполнено (запись найдена); 0 — если действие не выполнено.

Описание:

Метод НайтиПоКлючу позволяет найти запись, соответствующую значениям атрибутов агрегатного объекта типа «Ключ» XBase-объекта по текущему индексу и режиму поиска, переданному в качестве параметра. Указатель устанавливается на найденную запись. Перед вызовом метода следует установить значения всех атрибутов агрегатного объекта типа «Ключ», которые участвуют в вычислении выражения текущего индекса (см. описание метода ДобавитьИндекс).

Пример:

ДБФ.Ключ.Name = "Иванов";

ДБФ.Ключ.DIV_ID = 15; // отдел новых разработок

ЗаписьНайдена = ДБФ.НайтиПоКлючу(0); // поиск по составному, неоднородному ключу

НайтиПоКоду

Найти элемент справочника по коду.

Синтаксис:

НайтиПоКоду(<Код>, <ФлагПоиска>)

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

FindByCode

Параметры:

<Код>

Выражение со значением искомого кода.

<ФлагПоиска>

Необязательный параметр. Числовое выражение — флаг поиска: 0 — поиск во всем справочнике вне зависимости от родителя; 1 — поиск внутри установленного подчинения (родителя); 2 — поиск по полному коду.

Значение по умолчанию: 0 — для справочников, у которых код уникален во всем справочнике; 2 — для справочников, у которых код уникален в группе.

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

Число 1 — если действие выполнено;

Число 0 — если действие не выполнено (элемент не найден).

Описание:

Метод НайтиПоКоду выполняет поиск элемента справочника по значению кода, заданному параметром <Код>, и позиционирует объект справочник на этом элементе. Если справочник многоуровневый, то полный код выбираемого элемента можно задавать, разделяя коды уровней символом "/".

Данный метод может использоваться только для объектов, созданных функцией СоздатьОбъект.

Пример:

// Контекст журнала расчетов.

// Реквизит Подразд имеет тип «справочник»

Пдр = СоздатьОбъект("Справочник.Подразделения");

Пдр.ИспользоватьДату(ДатаДок);

Если Документ.Подразд <> 0 Тогда

// если в документе код подразделения указан...

Пдр.НайтиПоКоду(Документ.Подразд);

Если Пдр.Выбран() > 0 Тогда

Сообщить("Есть такое подразделение !")

Иначе

Сообщить("Нет такого подразделения!")

КонецЕсли;

См. также: ПолныйКод

НайтиПоКоду

Выполняет поиск счета в плане счетов по коду счета.

Синтаксис:

НайтиПоКоду(<КодСчета>)

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

FindByCode

Параметры:

<КодСчета>

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

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

Число: 1 — счет найден; 0 — счет не найден.

Описание:

Метод НайтиПоКоду выполняет поиск счета в плане счетов по коду счета, который передается методу в качестве параметра.

Если счет найден, метод возвращает 1 и позиционирует объект на выбранном счете.

Пример:

Сч = СоздатьОбъект("Счет.Основной");

Сч.НайтиПоКоду("01.01");

НайтиПомеченныеНаУдаление

Находит все помеченные на удаление объекты.

Синтаксис:

НайтиПомеченныеНаУдаление(<Объекты>)

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

FindMarkedForDelete

Параметры:

<Объекты>

Идентификатор объекта типа «СписокЗначений», в который данная процедура помещает найденные объекты.

Описание:

Процедура НайтиПомеченныеНаУдаление находит все помеченные на удаление объекты и помещает их в список значений.

Пример:

Список = СоздатьОбъект("Список Значений");

НайтиПомеченныеНаУдаление(Список);

НайтиПоНаименованию

Найти элемент справочника по наименованию.

Синтаксис:

НайтиПоНаименованию(<Наименование>, <Режим>, <ФлагПоиска>)

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

FindByDescr

Параметры:

<Наименование>

Строковое выражение с наименованием искомого элемента справочника.

<Режим>

Необязательный параметр. Числовое выражение — режим поиска: 1 — поиск внутри установленного подчинения (родителя); 0 — поиск во всем справочнике вне зависимости от родителя. Значение по умолчанию — 1.

<ФлагПоиска>

Необязательный параметр. Числовое выражение — флаг поиска: 1 — найти точное соответствие наименования; 0 — найти наименование по первым символам.

Значение по умолчанию — 0.

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

Число 1 — если действие выполнено;

Число 0 — если действие не выполнено (элемент не найден).

Описание:

Метод НайтиПоНаименованию выполняет поиск элемента справочника по наименованию, заданному параметром <Наименование> и позиционирует объект справочник на этом элементе.

Данный метод может использоваться только для объектов, созданных функцией СоздатьОбъект.

Пример:

Спр = СоздатьОбъект("Справочник.Сотрудники");

Спр.ИспользоватьДату(ДатаДок);

// Позиционируем созданный объект Спр по известному наименованию

Спр.НайтиПоНаименованию("Иванов", 1);

Если Спр.Выбран() > 0 Тогда

Оклад=Спр.Оклад;

Подразделение = Спр.Подразделение;

Иначе

Предупреждение("Нет у нас Ивановых!");

КонецЕсли;

См. также: ПолноеНаименование

НайтиПоНомеру

Найти документ по номеру.

Синтаксис:

НайтиПоНомеру(<Номер>, <Дата>, <ИдентВида>)

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

FindByNum

Параметры:

<Номер>

Строковое выражение, содержащее значение номера искомого документа.

<Дата>

Выражение типа «дата».

<ИдентВида>

Необязательный параметр. Строковое выражение, содержащее идентификатор вида документа или идентификатор Нумератора.

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

Число 1 — если действие выполнено (документ найден);

Число 0 — если действие не выполнено.

Описание:

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

Метод может быть использован для объекта Документ общего вида, тогда для поиска нужно указать в параметре <ИдентВида> идентификатор вида документа или идентификатор Нумератора.

Данный метод может использоваться только для объектов, созданных функцией СоздатьОбъект.

Пример:

Если ВвестиЧисло(Ном, "Введите номер приказа", 5, 0) = 1 Тогда

Док=СоздатьОбъект("Документ.ПриказыУвольнения");

// позиционируем документ по заданному номеру

Док.НайтиПоНомеру(Строка(Ном), Дата(0));

Если Док.Выбран() = 1 Тогда

Документ=Док.ТекущийДокумент();

// ...

КонецЕсли;

НайтиПоРеквизиту

Найти элемент справочника по значению реквизита.

Синтаксис:

НайтиПоРеквизиту(<ИмяРеквизита>, <3начение>, <ФлагГлобальногоПоиска>)

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

FindByAttribute

Параметры:

<ИмяРеквизита>

Строковое выражение с наименованием реквизита.

<3начение>

Значение реквизита для поиска.

<ФлагГлобальногоПоиска>

Числовое выражение. Если 0, то поиск должен выполняться в пределах подчинения справочника, если 1, то поиск должен выполняться по всему справочнику.

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

Число 1 — если действие выполнено;

Число 0 — если действие не выполнено (элемент не найден).

Описание:

Метод НайтиПоРеквизиту выполняет поиск первого элемента с указанным значением заданного реквизита и позиционирует объект справочник на этом элементе.

Данный метод может использоваться только в том случае, если в конфигураторе при описании данного реквизита установлен признак «Сортировка» (Свойства реквизита - Дополнительные - Сортировка).

Данный метод может использоваться только для объектов, созданных функцией СоздатьОбъект.

Пример:

Спр = СоздатьОбъект("Справочник.Сотрудники");

Спр.ИспользоватьДату(ДатаДок);

// Позиционируем созданный объект Спр по реквизиту

Спр.НайтиПоРеквизиту("СерияПаспорта", "XXVII-OP", 1);

Если Спр.Выбран() > 0 Тогда

Имя = Спр.Наименование;

Иначе

Предупреждение("Не найден сотрудник с таким паспортом!");

КонецЕсли;

НайтиСчет

Метод выполняет поиск счета в плане счетов по значению типа «Счет».

Синтаксис:

НайтиСчет(<Счет>)

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

FindAccount

Параметры:

<Счет>

Значение типа «Счет».

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

Число: 1 — счет найден; 0 — счет не найден.

Описание:

Метод НайтиСчет выполняет поиск счета по значению, заданному параметром <Счет>, и позиционирует объект на выбранном счете.

Пример:

Сч = СоздатьОбъект("Счет.Основной");

Сч.НайтиСчет(ВыбСчет);

НайтиСледующийФайл

Находит следующий файл по открытой выборке файлов.

Синтаксис:

НайтиСледующийФайл()

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

FindNextFile

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

Строка с именем найденного файла.

Описание:

Метод НайтиСледующийФайл находит следующий файл по открытой выборке файлов.

Пример:

* В данном примере приведена процедура взятия следующего файла выборки файлов.

Процедура СледФ()

Результат = ФС.НайтиСледующийФайл();

КонецПроцедуры

См. также: НайтиПервыйФайл

НайтиСсылки

Находит ссылки на объекты, переданные в списке значений.

Синтаксис:

НайтиСсылки(<Объекты>, <Ссылки>)

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

FindReferences

Параметры:

<Объекты>

Конкретное значение объекта или объект типа «СписокЗначений», в котором данной процедуре передаются объекты, по которым надо найти ссылки.

<Ссылки>

Идентификатор объекта типа «ТаблицаЗначений», в который данная процедура помещает найденные ссылки на объекты. Таблица значений состоит из 3 колонок:

1. Объект — объект, на который ссылаются;

2. Ссылка — объект, который содержит ссылку;

3. Комментарий — комментарий к ссылке.

Описание:

Процедура НайтиСсылки находит ссылки на переданные в списке объекты, и помещает их в таблицу значений.

Пример:

Список = СоздатьОбъект("СписокЗначений");

ТаблицаСсылок = СоздатьОбъект("ТаблицаЗначений");

НайтиПомеченныеНаУдаление(Список);

НайтиСсылки(Список, ТаблицаСсылок);

НайтиЗапись

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

Синтаксис:

НайтиЗапись(<Запись>)

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

FindRecord

Параметры:

<3апись>

Запись журнала расчетов.

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

Число: 1 — если операция успешно выполнена; 0 — в противном случае.

Описание:

Метод позиционирует запись журнала расчетов, переданную в качестве параметра <3апись>. Передаваемое в качестве параметра значение, как правило, ранее получается за счет применения метода журнала расчетов ТекущаяЗапись. Фактически, данный метод открывает выборку журнала расчетов, заведомо состоящую из одной записи, и позиционирует ее.

Пример:

ЖЗ = СоздатьОбъект("ЖурналРасчетов.Зарплата");

ЖЗ.ВыбратьЗаписиПоОбъекту(Сотрудник, ДН, ДО);

Пока ЖЗ.ПолучитьЗапись() = 1 Цикл

Если ЖЗ.ПлатВедомость.Выбран() = 1 Тогда

ЗаписьЖР = ЖЗ.ТекущаяЗапись();

КонецЕсли;

КонецЦикла;

// теперь найдем запись и что-нибудь с ней поделаем

ЖЗ.НайтиЗапись(ЗаписьЖР);

ЖЗ.ПлатВедомость.Проведена = 1;

ЖЗ.ФиксироватьЗапись();

См. также: ТекущаяЗсшись

НайтиЗначение

Найти значение на заданную дату.

Синтаксис:

НайтиЗначение(<Дата>, <Режим>)

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

FindValue

Параметры:

<Дата>

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

<Режим>

Числовое выражение, значение которого задает режим поиска, если на заданную дату не существует значения периодического реквизита. Если -1 (минус единица) — возвращается значение на предыдущую дату, если 0 — возвращается код завершения неуспешной операции, если 1 — возвращается значение на последующую дату.

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

Число: 1 — если вызов метода закончился успешно, 0 — если нет.

Описание:

Метод НайтиЗначение позволяет найти периодическое значение на заданную дату <Дата>. Режим поиска в случае, если на заданную дату не существует значения периодического реквизита задается параметром <Режим>. Само полученное значение следует считывать из атрибута Значение.

Пример:

Если ПерВал.НайтиЗначение(ДатаП, Нап) = 0 Тогда

Предупреждение("Не нашли значение!", 3);

Возврат;

КонецЕсли;

НайтиЗначение

Определить номер позиции в списке для элемента, имеющего заданное значение.

Синтаксис:

НайтиЗначение(<Знач>)

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

FindValue

Параметры:

<Знач>

Выражение со значением, которое необходимо найти в списке.

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

Номер позиции в списке, где расположено требуемое значение. Если значение не найдено, то — 0.

Описание:

С помощью метода НайтиЗначение можно определить номер позиции в списке для элемента, имеющего значение <Знач>.

Пример:

Позиция = Спис.НайтиЗначение(Вид Расчета.ДоплатаПроцентом);

НайтиЗначение

Найти заданное значение в таблице значений.

Синтаксис:

НайтиЗначение(<Знач>, <Строка>, <Колонка>)

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

FindValue

Параметры:

<Знач>

Значение для поиска.

<Строка>

Идентификатор переменной, куда возвращается номер найденной строки. Если при вызове метода передать в этот параметр номер строки, то поиск будет осуществляться только по указанной строке.

<Колонка>

Идентификатор переменной, куда возвращается номер найденной колонки. Если при вызове метода передать в этот параметр номер или идентификатор колонки, то поиск будет осуществляться только по указанной колонке.

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

Число: 0 — значение не найдено; 1 — значение найдено.

Описание:

Метод НайтиЗначение позволяет найти искомое значение в таблице значений и определить номер строки и номер колонки таблицы значений.

Пример:

Перем НомСтр;

Перем НомКолонки;

Табл.НайтиЗначение(ВыбЗнач, НомСтр, НомКолонки);

Напечатать

Напечатать таблицу без предварительного просмотра.

Синтаксис:

Напечатать{<Флаг>)

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

Параметры:

<Флаг>

Числовое выражение — режим запроса диалога печати: 1 — запрашивать диалог печати; 0 — не запрашивать диалог печати.

Описание:

Метод Напечатать позволяет вывести таблицу на печать без открытия окна редактирования (см. Показать).

Пример:

Таб.Напечатать(0);

См. также: Показать

Назначение агрегатного типа данных XBase

Для работы с базами данных формата DBF в системе может использоваться специальный агрегатный тип данных — XBase. Механизм работы с базами данных формата DBF предназначен для обеспечения возможности манипулирования ими непосредственно из встроенного языка программы 1С:Предприятие. Каждый XBase-объект может быть связан с одним файлом базы данных.

Назначение и краткая характеристика встроенного языка

Встроенный язык системы 1С:Предприятие предназначен для описания (на стадии разработки конфигурации) алгоритмов функционирования прикладной задачи.

Встроенный язык (далее по тексту — язык) представляет собой предметно-ориентированный язык программирования, специально разработанный с учетом возможности его применения не только профессиональными программистами. В частности, все операторы языка имеют как русское, так и англоязычное написание, которые можно использовать одновременно в одном исходном тексте. Основной язык, описываемый в данной книге — русский, однако для каждого оператора языка приводится его англоязычный синоним.

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

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

НазначитьСчет

Назначает счет значению типа «Вид субконто».

Синтаксис:

НазначитьСчет(<ВидСубконто>, <Счет>[, <НомерСубконто>])

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

SetAccount

Параметры:

<ВидСубконто>

Значение типа «ВидСубконто», переданное по ссылке — обычно реквизит диалога формы.

<Счет>

Значение типа «Счет».

<НомерСубконто>

Значение типа «Число» — номер субконто для данного счета.

Описание:

Данная процедура используется для организации выбора значения типа «Вид субконто» в диалоге формы применительно к конкретному счету, то есть организовать выбор видов субконто конкретного счета. В качестве первого параметра передается собственно реквизит диалога, а в качестве второго — счет. Вызов данной процедуры ограничивает выбор вида субконто видами, заданными для конкретного счета. Кроме того, само значение вида субконто очищается, если данный вид субконто не используется для указанного счета. Если указан параметр НомерСубконто, то значение вида субконто будет автоматически установлено в соответствии с настройкой субконто указанного счета с данным номером.

Пример:

Процедура ПриВыбореСчета()

НазначитьСчет(ВыбВидСубконто1, Счет, 1);

НазначитьСчет(ВыбВидСубконто2, Счет, 2);

НазначитьСчет(ВыбВидСубконтоЗ, Счет, 3);

КонецПроцедуры

НазначитьТип

Назначить тип для константы неопределенного типа.

Синтаксис:

НазначитьТип(<ИмяКонстанты>, <ИмяТипа>, <Длина>, <Точность>)

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

SetType

Параметры:

<ИмяКонстанты>

Строковое выражение — название константы неопределенного типа, как она названа в конфигураторе.

<ИмяТипа>

Строковое выражение — название типа данных (или Вид субконто), который назначается константе. Например:

"Строка", "Число", "Справочник.Товары", "Документ.РасходнаяНакладная" и т. п.

<Длина>

Необязательный параметр. Числовое выражение — длина поля представления данных. Имеет смысл только при задании числового или строкового типа.

<Точность>

Необязательный параметр. Числовое выражение — число знаков числа после десятичной точки. Имеет смысл только при задании числового типа.

Описание:

Метод НазначитьТип позволяет назначить тип для константы, которой в конфигураторе назначен тип «Неопределенный».

Пример:

Константа.НазначитьТип("ТМЦ", "Справочник.Товары");

НазначитьТип

Назначить тип для реквизита неопределенного вида.

Синтаксис:

НазначитьТип(<ИмяРеквизита>, <ИмяТипа>, <Длина>, <Точность>)

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

SetType

Параметры:

<ИмяРеквизита>

Строковое выражение — название реквизита справочника неопределенного типа, как он назван в конфигураторе.

<ИмяТипа>

Строковое выражение — название типа данных (или Вид субконто), который назначается реквизиту справочника. Например:

"Строка", "Число", "Справочник.Товары", "Документ.РасходнаяНакладная" и т. п.

<Длина>

<Точность>

Описание:

Метод НазначитьТип позволяет назначить тип для реквизита, которому в конфигураторе назначен тип «Неопределенный».

Пример:

Номенклатура.НазначитьТип("ТМЦ", "Справочник.Товары");

НазначитьТип

Назначить тип для реквизита неопределенного вида.

Синтаксис:

НазначитьТип(<ИмяРеквизита>, <ИмяТипа>, <Длина>, <Точность>)

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

SetType

Параметры:

<ИмяРеквизита>

Строковое выражение — название реквизита документа неопределенного типа, как он назван в конфигураторе.

<ИмяТипа>

Строковое выражение — название типа данных (или Вид субконто), который назначается реквизиту документа. Например:

"Строка", "Число", "Справочник.Товары", "Документ.РасходнаяНакладная" ит. п.

<Длина>

<Точность>

Описание:

Пример:

Накладная.НазначитьТип("ТМЦ", "Справочник.Товары");

НазначитьТип

Назначить тип для реквизита неопределенного вида.

Синтаксис:

НазначитьТип(<ИмяРеквизита>, <ИмяТипа>, <Длина>, <Точность>)

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

SetType

Параметры:

<ИмяРеквизита>

Строковое выражение — название реквизита регистра неопределенного типа, как он назван в конфигураторе.

<ИмяТипа>

Строковое выражение — название типа данных (или Вид субконто), который назначается реквизиту регистра. Например:

"Строка", "Число", "Справочник.Товары", " Документ.РасходнаяНакладная" ит. п.

<Длина>

<Точность>

Описание:

Пример:

Регистр.УчетТМЦ.НазначитьТип("ТМЦ", "Справочник.Товары");

НазначитьТип

Назначить тип для реквизита неопределенного вида.

Синтаксис:

НазначитьТип(<ИмяРеквизита>, <ИмяТипа>, <Длина>, <Точность>)

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

SetType

Параметры:

<ИмяРеквизита>

Строковое выражение — название реквизита счета неопределенного типа, как он назван в конфигураторе.

<ИмяТипа>

Строковое выражение — название типа данных (или Вид субконто), который назначается реквизиту счета. Например:

"Строка", "Число", "Справочник.Товары", "Документ. РасходнаяНакладная" и т. п.

<Длина>

<Точность>

Описание:

Пример:

ВыбСчет.НазначитьТип("ТМЦ", "Справочник.Товары");

НазначитьТип

Назначить тип для реквизита неопределенного вида.

Синтаксис:

НазначитьТип(<ИмяРеквизита>, <ИмяТипа>, <Длина>, <Точность>)

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

SetType

Параметры:

<ИмяРеквизита>

Строковое выражение — название реквизита операции или проводки неопределенного типа, как он назван в конфигураторе.

<ИмяТипа>

Строковое выражение — название типа данных (или Вид субконто), который назначается реквизиту операции или проводки. Например:

"Строка", "Число", "Справочник.Товары", "Документ.РасходнаяНакладная" ит. п.

<Длина>

<Точность>

Описание:

Пример:

Операция.НазначитьТип("ТМЦ", "Справочник.Товары");

НазначитьТип

Назначить тип для реквизита неопределенного вида.

Синтаксис:

НазначитьТип(<ИмяРеквизита>, <ИмяТипа>, <Длина>, <Точность>}

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

SetType

Параметры:

<ИмяРеквизита>

Строковое выражение — название реквизита журнала расчетов неопределенного типа, как он назван в конфигураторе.

<ИмяТипа>

Строковое выражение — название типа данных (или Вид субконто), который назначается реквизиту журнала расчетов. Например, «Строка», «Число», «Справочник.Товары», «Документ.РасходнаяНакладная» и т. п.

<Длина>

<Точность>

Описание:

Пример:

ЖЗ = СоздатьОбъект("ЖурналРасчетов.Зарплата");

// будем записывать несколько реквизитов

ЖЗ.НазначитьТип("ТМЦ", "Справочник.Товары");

ЖЗ.УстановитьРеквизит("ТМЦ", ВыбТовар);

ЖЗ.ВвестиРасчет(Сотр, ВР, Нач, Оконч, Сумма * Процент);

НазначитьТип

Назначить тип для периодического объекта неопределенного типа.

Синтаксис:

НазначитьТип(<ИмяТипа>, <Длина>, <Точность>)

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

SetType

Параметры:

<ИмяТипа>

Строковое выражение — название типа данных, который назначается периодическому реквизиту справочника или периодической константе неопределенного типа. Например: "Строка", "Число", "Справочник.Товары", "Документ.РасходнаяНакладная" и т. п.

<Длина>

<Точность>

Описание:

Метод НазначитьТип позволяет назначить тип периодического реквизита справочника или периодической константе неопределенного типа.

Пример:

Тов = СоздатьОбъект("Справочник.Номенклатура");

// Позиционируем созданный справочник по известному коду

Тов.НайтиПоКоду(51);

Если Тов.Выбран() = 1 Тогда

ВыбТМЦ = Тов.ТекущийЭлемент();

Иначе

Предупреждение("Не найден товар!");

Возврат;

КонецЕсли;

ПерТМЦ = СоздатьОбъект("Периодический");

ПерТМЦ.ИспользоватьОбъект("ТМЦ", ВыбТМЦ);

ПерТМЦ.НазначитьТип("Справочник.Товары");

НазначитьТип

Назначить тип для элемента диалога неопределенного вида.

Синтаксис:

НазначитьТип(<ИмяТипа>, <Длина>, <Точность>)

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

AssignType

Параметры:

<ИмяТипа>

Строковое выражение — название типа данных, которое назначается элементу диалога. Например: "Строка", "Число", "Справочник.Товары", "Документ.РасходнаяНакладная" ит. п.

<Длина>

<Точность>

Описание:

Метод НазначитьТип позволяет назначить тип для элемента диалога, которому в конфигураторе назначен тип «Неопределенный».

Данный метод доступен в контексте Модуля формы (см. «Виды программных модулей»).

Пример:

Форма.ВыбКолич.НазначитьТип("Число", 15, 2);

Форма.ВыбДата.НазначитьТип("Дата");

Форма.ВыбТовар.НазначитьТип("Справочник.Товары");

Форма.ВыбДокум.НазначитьТип("Документ");

См. также: УстановитьТип, ТипЗначения, ТипЗначенияСтр

НазначитьТип

Назначить тип для значения ячейки неопределенного вида.

Синтаксис:

НазначитьТип(<ИмяТипа>, <Длина>, <Точность>)

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

SetType

Параметры:

<ИмяТипа>

Строковое выражение — название типа данных, которое назначается значению ячейки. Например: "Строка", "Число", "Справочник.Товары", " Документ.РасходнаяНакладная" и т. п.

<Длина>

<Точность>

Описание:

Метод НазначитьТип позволяет назначить тип для значения ячейки, которому в конфигураторе назначен тип «Неопределенный».

Пример:

ВыбОбласть.НазначитьТип("Число", 15, 2);

См. также: УстановитьТип, ТипЗначения, ТипЗначенияСтр

НазначитьВид

Для значений типа «Документ неопределенного вида», «Справочник неопределенного вида», «Счет неопределенного вида» назначает конкретный вид.

Синтаксис:

НазначитьВид(<3начение>, <Вид>)

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

SetKind

Параметры:

<3начение>

Значение типа документ/справочник/счет неопределенного вида — обычно реквизит документа, справочника или диалога формы.

<Вид>

Строка — вид значения может быть задан строкой, содержащей идентификатор конкретного справочника, документа, плана счетов.

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

Описание:

Процедура НазначитьВид используется для установки значениям типа «Документ неопределенного вида», «Справочник неопределенного вида», «Счет неопределенного вида» конкретный вид. При этом, если существующее значение не соответсвует вновь установленному виду — то оно очищается.

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

Данная процедура может использоваться в сочетании с методом элемента формы НеИзменятьВид. Это возволяет регулировать программно собственно вид, а само значение предоставить выбирать пользователю интерактивно.

Пример:

* Например, реквизиту документа «Контрагент» типа справочник неопределенного вида, в зависимости от значений других реквизитов можно установить вид «Организации» или «Сотрудники».

Процедура ВводНаОсновании(ДокОсн)

Если ДокОсн.Вид() = "Счет" Тогда

НазначитьВид(Контрагент, «Организации»);

Иначе

НазначитВид(Контрагент, «Сотрудники»);

КонецЕсли;

Форма.Контрагент.НеИзменятьВид(1);

КонецПроцедуры

НазваниеИнтерфейса

Получить название интерфейса пользователя.

Синтаксис:

НазваниеИнтерфейса()

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

UserInterfaceName

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

Строковое значение, содержащее название интерфейса пользователя.

Описание:

Функция НазваниеИнтерфейса возвращает название интерфейса, заданное пользователю в конфигураторе.

Пример:

МойИнтерфейс = НазваниеИнтерфейса();

НазваниеНабораПрав

Получить название набора прав пользователя.

Синтаксис:

НазваниеНабораПрав(<ВыдИспНабПрав>)

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

RightName

Параметры:

<ВыдИспНабПрав>

Выдавать используемый набор прав или нет. Необязательный параметр. Число: 0 — выдает установленный пользователю набор прав; 1 — выдает пустую строку, если пользователю набор прав назначен, но установлен режим отключения контроля набора прав. Значение по умолчанию — 0.

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

Строковое значение, содержащее название набора прав пользователя.

Описание:

Функция НазваниеНабораПрав возвращает название набора прав, заданное пользователю в конфигураторе.

Пример:

МоиПрава = НазваниеНабораПрав();

НеИзменятьВид

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

Синтаксис:

НеИзменятьВид(<Признак>)

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

FixKind

Параметры:

<Признак>

Числовое выражение — признак запрета изменения вида. Может принимать значения:

0 — разрешить изменение вида при выборе значения;

1 — запретить изменение вида при выборе значения.

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

Число — текущее значение признака.

Описание:

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

Предположим, в диалоге существует реквизит типа справочник неопределенного вида. Вид этого элемента устанавливается при помощи встроенного языка процедурой НазначитьВид. Метод НеИзменятьВид(1) позволяет запретить пользователю при выборе значения выбрать вид справочника.

Пример:

* Например, в некотором документе, для его реквизита «Контрагент» типа справочник неопределенного вида, назначается вид «Организации» или «Сотрудники» и запрещается интерактивное изменение вида пользователем.

Процедура ВводНаОсновании(ДокОсн)

Если ДокОсн.Вид() = "Счет" Тогда

НазначитьВид(Контрагент, «Организации»);

Иначе

НазначитьВид(Контрагент, «Сотрудники»);

КонецЕсли;

Форма.Контрагент.НеИзменятьВид(1);

КонецПроцедуры

НеПроводитьДокумент

Отменить процесс проведения документа.

Синтаксис:

НеПроводитьДокумент()

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

DoNotTransactDoc

Описание:

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

Данный метод доступен только в контексте Модуля документа в предопределенной процедуре ОбработкаПроведения (см. Гл. «Системные предопределенные процедуры»).

По своему действию данный метод полностью аналогичен вызову системной функции СтатусВозврата с параметром 0, т. е. отменить действие.

Пример:

Процедура ОбработкаПроведения();

Если Число(Клиент.Выбран()) > 0 Тогда

ДвиженияРегистраРеализации();

Иначе

Сообщить("Не выбран клиент по реализации!!! Документ не проводится!!!");

НеПроводитьДокумент();

Возврат;

КонецЕсли;

КонецПроцедуры

См. также:

СтатусВозврата

НомерДняГода

Определить день года указанной даты.

Синтаксис:

НомерДняГода(<Дата>)

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

GetDayOfYear

Параметры:

<Дата>

Выражение со значением типа «дата».

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

Число со значением определенного дня года.

Описание:

Функция НомерДняГода определяет порядковый день в году для указанной даты.

Пример:

ЗначениеДняГода = НомерДняГода(РабочаяДата());

НомерДняНедели

Определить день недели указанной даты.

Синтаксис:

НомерДняНедели(<Дата>)

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

GetDayOfWeek

Параметры:

<Дата>

Выражение со значением типа «дата».

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

Число со значением определенного порядкового дня недели.

Описание:

Функция НомерДняНедели определяет день недели указанной даты. Возвращаемое значение — число со значением определенного порядкового дня недели (1 — понедельник, 2 — вторник, ..., 7 — воскресенье).

Пример:

ЗначениеДняНедели = НомерДняНедели(РабочаяДата());

НомерДок

Номер документа

Синтаксис:

НомерДок

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

DocNum

Описание:

При помощи атрибута НомерДок можно получать и задавать значение номера выбранного документа.

Пример:

Основание = Вид() + " № " + СокрП(НомерДок) + " от " + ДатаДок;

НомерКорреспонденции

Определяет номер текущей корреспонденции в операции.

Синтаксис:

НомерКорреспонденции()

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

CorrespondenceNumber

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

Число — номер текущей корреспонденции в проводке.

Описание:

Для текущей проводки (корреспонденции) возвращает ее номер корреспонденции, если проводка не сложная — 1.

Пример:

Опер = СоздатьОбъект("Операция");

Опер.НайтиОперацию(ВыбрДокумент);

Для Инд = 1 До Опер.КоличествоПроводок() Цикл

Опер.ПолучитьПроводкуПоНомеру(Инд);

Сообщить("Проводка " + Опер.НомерПроводки() +

"Корр. " + Опер.НомерКорреспонденции());

КонецЦикла;

НомерНеделиГода

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

Синтаксис:

НомерНеделиГода(<Дата>)

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

GetWeekOfYear

Параметры:

<Дата>

Выражение со значением типа «дата».

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

Число со значением определенного номера недели в году.

Описание:

Функция НомерНеделиГода определяет номер недели в году для указанной даты.

Пример:

ЗначениеНедели = НомерНеделиГода(РабочаяДата());

НомерПоля

Определить номер поля по названию.

Синтаксис:

НомерПоля(<НазваниеПоля>)

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

FieldNo

Параметры:

<HaзвaниeПoля>

Строковое выражение с названием поля.

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

Числовое значение номера поля.

Описание:

Метод НомерПоля предназначен для определения номера поля по его на-^анию.

Пример:

НомП = ДБФ.НомерПоля("CODE");

НомерПроводки

Определяет номер текущей проводки.

Синтаксис:

НомерПроводки()

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

EntryNumber

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

Число — номер проводки.

Описание:

Для текущей проводки (корреспонденции) возвращает ее номер (не абсолютный, а именно номер проводки без учета корреспонденции).

Пример:

Опер = СоздатьОбъект ("Операция");

Опер.НайтиОперацию(ВыбрДокумент);

Для Инд = 1 До Опер.КоличествоПроводок() Цикл

Опер.ПолучитьПроводкуПоНомеру(Инд);

Сообщить("Проводка " + Опер.НомерПроводки() +

"Корр. " + Опер.НомерКорреспонденции());

КонецЦикла;

НомерСтроки

Синтаксис:

НомерСтроки

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

LineNum

Описание:

Атрибут НомерСтроки задает числовое значение номера строки многострочной части выбранного документа. Данный атрибут имеет смысл только при выбранной строке. Присвоение строке нового номера передвигает строку в многострочной части документа.

Пример:

Процедура ОбработкаПроведения()

Регистр.ТовЗап.Склад = Склад;

ВыбратьСтроки();

Пока ПолучитьСтроку() > 0 Цикл

Регистр.ПривязыватьСтроку(НомерСтроки);

Регистр.ТовЗап.Товар = Товар;

Регистр.ТовЗап.Количество = Количество;

Регистр.ТовЗап.Стоимость = Стоимость;

Регистр.ТовЗап.ДвижениеРасходВыполнить();

КонецЦикла;

КонецПроцедуры

НомерСтроки

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

Синтаксис:

НомерСтроки()

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

LineNum

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

Число — номер строки документа, выполнившего движение регистра.

Описание:

Метод НомерСтроки возвращает значение номера строки документа, которая задала движение регистра (в случае, когда в Модуле документа перед движением регистра использовали метод ПривязыватьСтроку). Метод используется после получения очередного движения регистра (см. функции ПолучитьДвижение и ПолучитьИтог).

Данный метод может использоваться только для переменных созданных Функцией СоздатьОбъект.

Пример:

Рег = СоздатьОбъект("Регистр.Взаиморасчеты");

Рег.ВременныйРасчет();

Рег.УстановитьФильтр(Клиент);

РассчитатьРегистрыНа(ДатаНачала);

Рег.ВыбратьДвиженияСОстатками(ДатаКонца);

Пока Рег.ПолучитьДвижение() = 1 Цикл

Прих = 0;

Расх = 0;

Если Рег.Приход = 1 Тогда

Прих = Рег.Долг;

Иначе

Расх = Рег.Долг;

КонецЕсли;

ТекущееСальдо = Рег.Остаток(Клиент, "Задолженность");

Док = Рег.ТекущийДокумент();

НомСтр = Рег.НомерСтроки();

Таб.ВывестиСекцию("Документ");

КонецЦикла;

См. также: ПолучитьДвижение, ТекущийДокумент, ПривязыватьСтроку