Модуль Формы журнала документов

Размещается в разделе конфигурации: Мета­данные — Журнал — Форма.

Запускается при вызо­ве формы журнала документов.

В модуле доступны: глобальный контекст, контекст Модуля формы журнала документов, в котором непосредствен­но доступен выбранный в журнале документ и реквизиты формы жур­нала.

Модуль Формы журнала операций

Размещается в разделе конфигурации: Мета­данные — Журнал операций — Форма.

Запускается при вызо­ве формы журнала операций.

В модуле доступны: глобальный контекст, контекст Модуля формы журнала операций, в котором непосредствен­но доступны реквизиты журнала операций и реквизиты формы.

 Модуль Формы журнала проводок

Размещается в разделе конфигурации: Мета­данные — Журнал проводок — Форма.

Запускается при вызо­ве формы журнала проводок.

В модуле доступны: глобальный контекст, контекст Модуля формы журнала проводок, в котором непосредствен­но доступны реквизиты журнала проводок и реквизиты формы.

Модуль Формы журнала расчетов

Размещается в разделе конфигурации: Мета­данные — Журнал расчетов — Форма.

Запускается при вызо­ве формы журнала расчетов.

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

Модуль вида расчета

Размещается в разделе конфигуратора: Метаданные — Вид расчета — Модуль вида расчета.

Запускается при рас­чете соответствующих записей журнала рас­четов.

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

МонопольныйРежим

Определение режима работы программы.

Синтаксис:

МонопольныйРежим()

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

ExclusiveMode

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

Число 1 — если программа запущена в монопольном режиме;

Число 0 — если программа запущена в сетевом режиме.

Описание:

Функция МонопольныйРежим возвращает число 1 — если программа запу­щена в монопольном режиме и 0 если нет.

Пример:

Процедура Загрузка()

   Если МонопольныйРежим() > 0 Тогда

      ЗагрузитьНаряды();

   Иначе

      Предупреждение("Для запуска этой операции требуется" +

                     "монопольный режим доступа !!!");

   КонецЕсли;

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

НачалоИнтервала

Возвратить дату начала интервала журнала.

Синтаксис:

НачалоИнтервала()

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

BegOfRange

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

Значение даты начала интервала журнала.

Описание:

Метод НачалоИнтервала позволяет получить дату начала интервала журнала.

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

Пример:

НИ = НачалоИнтервала();

НачалоИнтервала

Возвратить дату начала интервала журнала операций.

Синтаксис:

НачалоИнтервала()

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

BegOfRange

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

Значение типа «Дата» — начальная дата интервала журнала операций.

Описание:

Метод НачалоИнтервала позволяет получить текущую начальную дату интервала журнала операций.

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

Пример:

НИ = НачалоИнтервала();

НачалоИнтервала

Возвратить дату начала интервала журнала проводок.

Синтаксис:

НачалоИнтервала()

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

BegOfRange

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

Значение типа «Дата» — начальная дата интервала журнала проводок.

Описание:

Метод НачалоИнтервала позволяет получить начальную дату интервала журнала проводок.

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

Пример:

НИ = НачалоИнтервала();

НачалоПериода

Возвращает дату начала периода формирования запроса.

Синтаксис:

НачалоПериода()

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

BeginOfPeriod

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

Значение типа «дата» — начало периода формирования запроса.

Описание:

Метод НачалоПериода возвращает дату начала периода запроса. Если в тексте запроса (см. «Язык запросов») указана одна из предопреде­ленных группировок типа период ("Год", "Месяц", "День" и т. д.), то при обработке этой и вложенных в нее группировок метод НачалоПериода будет возвращать начало периодов текущих значений этих группировок.

Пример:

ДатаНачала = Запрос.НачалоПериода();

НачалоПериодаБИ

Возвращает дату начала периода бухгалтерских итогов.

Синтаксис:

НачалоПериодаБИ()

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

BeginOfРег1odBT()

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

Значение типа «Дата» — дата начала периода бухгалтерских итогов.

Описание:

Метод НачалоПериодаБИ возвращает дату начала периода бухгалтерских итогов, заданную в режиме «Настройка параметров системы».

Пример:

Дата1 = НачалоПериодаБИ();

НачалоПериодаПоДате

Возвращает дату начала произвольного расчетного периода.

Синтаксис:

НачалоПериодаПоДате{<Дата>)

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

PeriodBeginByDate

Параметры:

<Дата>

Любая дата, которая попадает в требуемый период.

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

Значение типа «дата» — начало расчетного периода журнала расчетов.

Описание:

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

Пример:

// В каждой строке журнала расчетов проставим в реквизит Дни

// количество банковских дней того периода расчета, в который

// попадает запись

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

Календ = СоздатьОбъект("Календарь.РаботаБанка");

ЖР.ВыбратьПериод(ЖР.НачалоТекущегоПериода());

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

   ЖР.Дни = Календ.Дней(НачалоПериодаПоДате(ЖР.ДатаНачала),

                         КонецПериодаПоДате(ЖР.ДатаНачала));

КонецЦикла;

См. также: КонецПериодаПоДате

НачалоСтандартногоИнтервала

Устанавливает вариант задания начала стандартного интервала ото­бражения журнала документов.

Синтаксис:

НачалоСтандартногоИнтервала(<Вариант>)

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

BegOfStandrdRange

Параметры:

<Вариант>

Необязательный параметр. Выражение со значением типа строка или дата. Возможные строковые значе­ния параметра: "День", "Месяц", "Квартал", "Год", "Day", "Month", "Quarter", "Year". Значением типа «дата» задается конкретная дата на­чала интервала журнала документов. Если параметр не задан, то установка сделанная в параметрах системы не меняется, а только возвращается текущий вариант.

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

Возвращает текущий установленный вариант.

Описание:

Функция НачалоСтандартногоИнтервала устанавливает вариант зада ния начала стандартного интервала отображения журнала документов. Вариан может изменяться при помощи главного меню Сервис-Параметры-Общие.

Пример:

НачалоСтандартногоИнтервала("Месяц");

НачалоТекущегоПериода

Возвращает дату начала текущего расчетного периода.

Синтаксис:

НачалоТекущегоПериода()

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

CurrentPeriodBegin

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

Значение типа «дата» — начало текущего расчетного периода журнала рас­четов.

Описание:

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

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

Пример:

//

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

Начало = ЖРЗарп.НачалоТекущегоПериода();

См. также: КонецТекущегоПериода, ПериодДействия, ПериодРегистрации

НачатьТранзакцию

Открыть обработку транзакции.

Синтаксис:

НачатьТранзакцию()

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

BeginTransaction

Описание:

Процедура НачатьТранзакцию открывает транзакцию для обработки ин­формации.

Пример:

Процедура УдалитьПустые()

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

   Спр.ВыбратьЭлементы();

   НачатьТранзакцию();

   Пока Спр.ПолучитьЭлемент() = 1 Тогда

      Если Спр.Количество = 0 Тогда

         Спр.Удалить();

      КонецЕсли;

   КонецПока;

   ЗафиксироватьТранзакцию();

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

НачДата

Начальная дата периода, за который извлекаются результаты запро­са.

Синтаксис:

НачДата

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

BegDate

Описание:

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

Пример:

БухИтоги.ВыполнитьЗапрос(Дата1, Дата2, , , , , "Месяц");

БухИтоги.ВыбратьСчета();

Пока БухИтоги.ПолучитьСчет() = 1 цикл

   БухИтоги.ВыбратьПериоды();

   Пока БухИтоги.ПолучитьПериод() = 1 цикл

      Сообщить("С " + БухИтоги.НачДата.Код + " по " + БухИтоги.КонДата +

               " ДО = " + БухИтоги.ДО());

   КонецЦикла;

КонецЦикла;

НачГода

Определить дату начала года.

Синтаксис:

НачГода(<Дата>)

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

BegOfYear

Параметры:

<Дата>

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

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

Результирующая дата.

Описание:

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

Пример:

ДатаНачалаГода = НачГода(РабочаяДата());

НачКвартала

Определить дату начала квартала.

Синтаксис:

НачКвартала(<Дата>)

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

BegOfQuart

Параметры:

<Дата>

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

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

Результирующая дата.

Описание:

Функция НачКвартала определяет дату начала квартала для указанной да­ты.

Пример:

ДатаНачалаКвартала = НачКвартала(РабочаяДата());

НачМесяца

Определить дату начала месяца.

Синтаксис:

НачМесяца(<Дата>)

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

BegOfMonth

Параметры:

<Дата>

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

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

Результирующая дата.

Описание:

Функция НачМесяца определяет дату начала месяца для указанной даты.

Пример:

ДатаНачалаМесяца = НачМесяца(РабочаяДата());

НачНедели

Определить дату начала недели.

Синтаксис:

НачНедели(<Дата>)

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

BegOfWeek

Параметры:

<Дата>

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

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

Результирующая дата.

Описание:

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

Пример:

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

НачПериода

Выдает начальную дату установленного в данный момент периода основных итогов.

Синтаксис:

НачПериода()

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

BeginOfPeriod

Возвращаемое значение: Начальная дата периода.

Описание:

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

Пример:

Сообщить(ПериодСтр(БухИтоги.НачПериода(), БухИтоги.КонПериода());

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

Значение реквизита Наименование.

Синтаксис:

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

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

Description

Описание:

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

Пример:

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

Спр.НайтиПоКоду("29");

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

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

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

Синтаксис:

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

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

Description

Описание:

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

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

Пример:

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

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

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

// ...

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

// ...

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

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

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

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

Синтаксис:

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

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

Descriptor

Описание:

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

Пример:

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

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

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

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

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

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

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

Найти

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

Синтаксис:

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

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

Find

Параметры:

<Ключ>	Строковое выражение со значением выражения теку­щего индекса.
<Режим>	Числовое выражение. Режим поиска записей: 0 — ищет запись на точное соответствие ключу (=); 1 — ищет запись на точное соответствие с ключом или большую (>=); 2 — ищет запись с большим ключом (>); -1 (минус единица) — ищет запись на точное соответ­ствие с ключом или меньшую(<=); -2 (минус два) — ищет запись с меньшим ключом (<).

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

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

Описание:

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

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

Пример:

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

Найти

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

Синтаксис:

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

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

Find

Параметры:

<Строка1>	Строковое выражение места поиска.
<Строка2>	Строковое выражение шаблона поиска.

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

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

Описание:

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

Описание:

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

Пример:

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

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

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

Напечатать

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

Синтаксис:

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

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

Print

Параметры:

<Флаг>

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

Описание:

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

Пример:

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

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

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

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

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

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

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

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

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

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

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

Синтаксис:

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

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

SetAccount

Параметры:

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

Описание:

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

Пример:

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

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

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

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

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

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

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

Синтаксис:

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

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

SetType

Параметры:

<ИмяРеквизита>	Строковое выражение — название реквизита спра­вочника неопределенного типа, как он назван в кон­фигураторе.
<ИмяТипа>	Строковое выражение — название типа данных (или Вид субконто), который назначается реквизиту спра­вочника. Например: "Строка", "Число", "Справочник.Товары", "Документ.РасходнаяНакладная" и т. п.
<Длина>	Необязательный параметр. Числовое выражение — длина поля представления данных. Имеет смысл только при задании числового или строкового типа.
<Точность>	Необязательный параметр. Числовое выражение — число знаков числа после десятичной точки. Имеет смысл только при задании числового типа.

Описание:

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

Пример:

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

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

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

Синтаксис:

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

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

SetType

Параметры:

<ИмяРеквизита>	Строковое выражение — название реквизита доку­мента неопределенного типа, как он назван в конфи­гураторе.
<ИмяТипа>	Строковое выражение — название типа данных (или Вид субконто), который назначается реквизиту до­кумента. Например: "Строка", "Число", "Справочник.Товары", "Документ.РасходнаяНакладная" ит. п.
<Длина>	Необязательный параметр. Числовое выражение — длина поля представления данных. Имеет смысл только при задании числового или строкового типа.
<Точность>	Необязательный параметр. Числовое выражение — число знаков числа после десятичной точки. Имеет смысл только при задании числового типа.

Описание:

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

Пример:

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

---

---