Глава 7-4
Системные процедуры и функции

• Процедуры и функции обработки значений
• ЗначениеВСтрокуВнутр
• ЗначениеИзСтрокиВнутр
• ЗначениеВСтроку
• ЗначениеИзСтроки
• ЗначениеВФайл
• ЗначениеИзФайла
• СохранитьЗначение
• ВосстановитьЗначение
• Процедуры и функции компоненты «Оперативный учет»
• ПолучитьТА
• ПолучитьДатуТА
• ПолучитьВремяТА
• ПолучитьДокументТА
• ПолучитьПозициюТА
• УстановитьТАна
• УстановитьТАпо
• Процедуры и функции компоненты «Бухгалтерский учет»
• ВыбранныйПланСчетов
• ОсновнойПланСчетов
• СчетПоКоду
• НачалоПериодаБИ
• КонецПериодаБИ
• КонецРассчитанногоПериодаБИ
• НазначитьСчет
• ВвестиПланСчетов
• ВвестиВидСубконто
• МаксимальноеКоличествоСубконто
• Процедуры и функции компоненты «Расчет»
• ОсновнойЖурналРасчетов

Процедуры и функции обработки значений

ЗначениеВСтрокуВнутр

Преобразование значения объекта агрегатного типа из внутреннего представления в строковое.

Синтаксис:

ЗначениеВСтрокуВнутр(<Выражение>)

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

ValueToStringInternal

Параметры:

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

Результирующее строковое значение.

Описание:

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

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

Пример:

* Допустим, в конфигурации формируется отчет с использованием объекта «Таблица». Для обеспечения возможности получать дополнительные сведения по отчету, в таблицах есть возможность в каждой ячейке хранить вычисляемое значение, которое можно затем использовать для обработки. Однако, в ячейке таблицы можно хранить только одно значение. В случае, если все же для обработки необходимо иметь несколько значений, то их можно с помощью метода ЗначениеВСтрокуВнутр упаковать в одну строку. Например, в ячейке таблицы запишем формулу значения ячейки в следующем виде:

ЗначениеВСтрокуВнутр(Запрос.Клиент) + РазделительСтрок +  
ЗначениеВСтрокуВнутр(Запрос.Товар)

Процедура обработки значения ячейки должна в себе содержать алгоритм распаковки значений с использованием метода ЗначениеИзСтрокиВнутр.

Процедура ОбработкаЯчейкиТаблицы(Значение, ФлагСтандартнойОбработки)

   Если ТипЗначенияСтр(Значение) = "Строка" Тогда

      Орг = ЗначениеИзСтрокиВнутр(СтрПолучитьСтроку(Значение, 1));

      Тов = ЗначениеИзСтрокиВнутр(СтрПолучитьСтроку(Значение, 2));

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

         Возврат;

      КонецЕсли;

      Карт(Орг, Тов);

      ФлагСтандартнойОбработки = 0;

      Возврат;

   КонецЕсли;

   ФлагСтандартнойОбработки = 1;

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

См. также: ЗначениеИзСтрокиВнутр, ЗначениеТекущейЯчейки, ОбработкаЯчейкиТаблицы

ЗначениеИзСтрокиВнутр

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

Синтаксис:

ЗначениеИзСтрокиВнутр(<СистСтрока>)

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

ValueFromStringInternal

Параметры:

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

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

Описание:

Применять функцию ЗначениеИзСтрокиВнутр имеет смысл только в особых случаях. Например, если требуется несколько объектов упаковать в одну строку. При помощи функции ЗначениеВСтрокуВнутр объекты можно преобразовать в строковые значения, которые затем можно объединить в единую строку операцией конкатенации. В дальнейшем эту строку можно будет разобрать на составляющие и сделать обратное преобразование при помощи функции ЗначениеИзСтрокиВнутр.

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

Замечание. При использовании метода ЗначениеИзСтрокиВнутр() для значения типа «СписокЗначений», являющимся реквизитом формы, его идентификатор следует передавать в качестве второго параметра. В этом случае метод следует использовать как процедуру, т. е. не использовать возвращаемое значение. Пример:

ВосстановитьЗначение("СистСтрокаМойСпис", ИдентМойСпис);

Пример: См. предыдущий пример

См. также: ЗначениеВСтрокуВнутр, ЗначениеТекущейЯчейки

ЗначениеВСтроку

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

Синтаксис:

ЗначениеВСтроку(<Объект>)

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

ValueToString

Параметры:

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

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

Описание:

Применять функцию ЗначениеВСтроку имеет смысл только в особых случаях. Например, если требуется несколько объектов упаковать в одну строку. При помощи функции ЗначениеВСтроку объекты можно преобразовать в строковые значения, которые затем можно объединить в единую строку операцией конкатенации. В дальнейшем эту строку можно будет разобрать на составляющие и сделать обратное преобразование при помощи функции ЗначениеИзСтроки.

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

Пример:

СтрДок = ЗначениеВСтроку(ВыбДокумент);

См. также: ЗначениеИзСтроки

ЗначениеИзСтроки

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

Синтаксис:

ЗначениеИзСтроки(<СистСтрока>)

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

ValueFromString

Параметры:

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

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

Описание:

Применять функцию ЗначениеИзСтроки имеет смысл только в особых случаях. Например, если требуется несколько объектов упаковать в одну строку. При помощи функции ЗначениеВСтроку объекты можно преобразовать в строковые значения, которые затем можно объединить в единую строку операцией конкатенации. В дальнейшем эту строку можно будет разобрать на составляющие и сделать обратное преобразование при помощи функции ЗначениеИзСтроки.

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

Пример:

Док = ЗначениеИзСтроки(СтрДок);

См. также: ЗначениеВСтроку

ЗначениеВФайл

Сохраняет значение в файле.

Синтаксис:

ЗначениеВФайл(<ИмяФайла>, <3начение>, <Формат>)

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

ValueToFile

Параметры:

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

Число: 1 — функция выполнена успешно; 0 — функция не выполнена.

Описание:

Функция ЗначениеВФайл позволяет сохранить любое значение в файле. В дальнейшем этот файл можно будет распаковать и сделать обратное преобразование при помощи функции ЗначениеИзФайла.

Пример:

Результат = ЗначениеВФайл(ВыбИмяФайла, ВыбДокумент);

См. также: ЗначениеИзФайла

ЗначениеИзФайла

Восстанавливает значение из файла.

Синтаксис:

ЗначениеИзФайла(<ИмяФайла>, <3начение>, <Формат>)

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

ValueFromFile

Параметры:

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

Значение, которое получено из файла.

Описание:

Функция ЗначениеИзФайла восстанавливает значение из файла, которое упаковано туда при помощи функции ЗначениеВФайл.

Пример:

Док = ЗначениеИзФайла(ВыбИмяФайла);

См. также: ЗначениеВФайл

СохранитьЗначение

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

Синтаксис:

СохранитьЗначение(<Идентификатор>, <3начение>)

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

SaveValue

Параметры:

Описание:

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

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

Пример:

СохранитьЗначение("МойСклад", Склад);

См. также: ВосстановитьЗначение

ВосстановитьЗначение

Восстановить сохраненное для пользователя значение.

Синтаксис:

ВосстановитьЗначение(<Идентификатор>)

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

RestoreValue

Параметры:

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

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

Описание:

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

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

Замечание. При использовании метода ВосстановитьЗначение() для значения типа «СписокЗначений», являющимся реквизитом формы, его идентификатор следует передавать в качестве второго параметра. В этом случае метод следует использовать как процедуру, т. е. не использовать возвращаемое значение. ВосстановитьЗначение("СистСтрокаМойСпис", ИдентМойСпис);

Пример:

ДефСклад = ВосстановитьЗначение("МойСклад");

См. также: СохранитьЗначение

Процедуры и функции компоненты «Оперативный учет»

ПолучитьТА

Получить дату и время Точки Актуальности итогов в текстовом виде. Данная функция используется только при наличии компоненты. «Оперативный учет».

Синтаксис:

ПолучитьТА()

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

GetAP

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

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

Описание:

Функция ПолучитьТА возвращает дату и время Точки Актуальности итогов в текстовом виде.

Пример:

Дата_И_Время_ТА = ПолучитьТА();

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

Получить дату Точки Актуальности итогов. Данная функция используется только при наличии компоненты «Оперативный учет».

Синтаксис:

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

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

GetDateOfAP

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

Значение типа «дата», содержащее дату ТА.

Описание:

Функция ПолучитьДатуТА возвращает значение (типа «дата») даты Точки Актуальности итогов.

Пример:

Дата_ТА = ПолучитьДатуТА();

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

Получить значение времени Точки Актуальности итогов. Данная функция используется только при наличии компоненты «Оперативный учет».

Синтаксис:

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

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

GetTimeOfAP

Параметры:

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

Строковое значение времени ТА в виде " ЧЧ. MM. СС".

Описание:

Функция ПолучитьВремяТА записывает значение времени Точки Актуальности итогов в передаваемые при вызове параметры.

Пример:

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

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

Получить документ, который стоит на ТА. Данная функция используется только при наличии компоненты «Оперативный учет».

Синтаксис:

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

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

GetDocOfAP

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

Значение типа «документ», который стоит на ТА.

Описание:

Функция ПолучитьДокументТА возвращает документ, который стоит на ТА, если он есть.

Пример:

ПоследнийДок = ПолучитьДокументТА();

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

Получить позицию Точки Актуальности итогов. Данная функция используется только при наличии компоненты «Оперативный учет».

Синтаксис:

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

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

GetAPPosition

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

32-х символьное строковое значение позиции ТА.

Описание:

Функция ПолучитьПозициюТА возвращает 32-х символьное строковое значение позиции ТА.

Пример:

ПозицияТА = ПолучитьПозициюТА();

УстановитьТАна

Изменить положение Точки Актуальности итогов. Данный метод используется только при наличии компоненты «Оперативный учет». Данный метод используется только в монопольном режиме доступа.

Синтаксис:

УстановитьТАна(<ПоложениеТА>]

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

SetAPToBeg

Параметры:

Описание:

Метод УстановитьТАна изменяет положение Точки Актуальности итогов на начало даты или документа <ПоложениеТА>. Данный метод используется только в монопольном режиме доступа.

Пример:

УстановитьТАна(ВыбДокумент);

УстановитьТАпо

Изменить положение Точки Актуальности итогов. Данный метод используется только при наличии компоненты «Оперативный учет». Данный метод используется только в монопольном режиме доступа.

Синтаксис:

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

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

SetAPToEnd

Параметры:

Описание:

Метод УстановитьТАпо изменяет положение Точки Актуальности итогов на конец даты или документа <ПоложениеТА>. Данный метод используется только в монопольном режиме доступа.

Пример:

УстановитьТАпо(ВыбДокумент);

Процедуры и функции компоненты «Бухгалтерский учет»

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

ВыбранныйПланСчетов

Возвращает план счетов, выбранный пользователем в параметрах системы.

Синтаксис:

ВыбранныйПланСчетов()

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

DefaultChartOfAccounts

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

Значение типа «ПланСчетов».

Описание:

Функция ВыбранныйПланСчетов позволяет определить текущее значение параметра «Основной план счетов», выбранное пользователем при работе с системой.

Пример:

Сч = СоздатьОбъект("Счет");

Сч.ИспользоватьПланСчетов(ВыбранныйПланСчетов());

ОсновнойПланСчетов

Возвращает план счетов, установленный в конфигурации в качестве основного.

Синтаксис:

ОсновнойПланСчетов()

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

MainChartOfAccounts

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

Значение типа «ПланСчетов».

Описание:

Функция ОсновнойПланСчетов выдает план счетов установленный в конфигурации в качестве основного.

Пример:

Сч = СоздатьОбъект("Счет");

Сч.ИспользоватьПланСчетов(ОсновнойПланСчетов());

СчетПоКоду

Поиск бухгалтерского счета по коду.

Синтаксис:

СчетПоКоду(<КодСчета>[, <ПланСчетов>])

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

AccountByCode

Параметры:

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

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

Описание:

Метод СчетаПоКоду позволяет найти значение типа «Счет» по коду счета, указанному в виде символьной строки.

Пример:

// При проведении документа формируем проводку

Операция.НоваяПроводка();

Операция.Дебет.Счет = СчетПоКоду("51");

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

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

Синтаксис:

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

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

BeginOfРег1odBT()

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

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

Описание:

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

Пример:

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

КонецПериодаБИ

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

Синтаксис:

КонецПериодаБИ()

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

EndOfРег1odBT()

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

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

Описание:

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

Пример:

Дата2 = КонецПериодаБИ();

КонецРассчитанногоПериодаБИ

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

Синтаксис:

КонецРассчитанногоПериодаБИ()

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

EndOfCalculatedРег1odBT()

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

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

Описание:

Метод КонецРассчитанногоПериодаБИ возвращает последнюю дату рассчитанных бухгалтерских итогов, заданную в режиме «Управление бухгалтерских итогов» при работе в режиме «1С:Предприятие».

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

Пример:

Если Дата2 > КонецРассчитанногоПериодаБИ() Тогда

   Сообщить("Период не рассчитан!");

   Возврат;

КонецЕсли;

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

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

Синтаксис:

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

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

SetAccount

Параметры:

Описание:

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

Пример:

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

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

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

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

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

ВвестиПланСчетов

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

Синтаксис:

ВвестиПланСчетов(<ПланСчетов>, <Подсказка>, <Таймаут>)

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

InputChartOfAccounts

Параметры:

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

Числовое значение: 1 — выбор осуществлен , 0 — выбор не осуществлен (пользователем нажата кнопка «Отмена», клавиша <Esc> или закрыто окно диалога).

Описание:

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

Пример:

Перем ВыбПлан;

Если ВвестиПланСчетов(ВыбПлан, "Введите план счетов") = 1 Тогда

   ...

КонецЕсли;

ВвестиВидСубконто

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

Синтаксис:

ВвестиВидСубконто(<ВидСубконто>, <Подсказка>, [<Счет>], [<Таймаут>])

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

InputSubcontoKind

Параметры:

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

Числовое значение: 1 — выбор осуществлен , 0 — выбор не осуществлен (пользователем нажата кнопка «Отмена», клавиша <Esc> или закрыто окно диалога).

Описание:

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

Пример:

Перем ВыбВидСубк;

Если ВвестиВидСубконто(ВыбВидСубк, "Введите вид убконто", ВыбСчет) = 1 Тогда

   ...

КонецЕсли;

МаксимальноеКоличествоСубконто

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

Синтаксис:

МаксимальноеКоличествоСубконто()

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

MaxSubcontoCount

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

Число — максимальное количество видов субконто.

Описание:

Метод МаксимальноеКоличествоСубконто выдает значение параметра «Максимальное количество субконто», указанное в метаданных в настройке планов счетов. Фактически она позволяет определить, сколько видов субконто может быть задано для счета.

Пример:

Если МаксимальноеКоличествоСубконто() < 2 Тогда

   Форма.ВидСубк2.Видимость(0);

КонецЕсли;

Процедуры и функции компоненты «Расчет»

ОсновнойЖурналРасчетов

Устанавливает основной журнал расчетов. Используется только при наличии компоненты «Расчет».

Синтаксис:

ОсновнойЖурналРасчетов(<ЖурналРасч>)

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

BasicCalcJournal

Параметры:

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

Значение текущего журнала расчетов.

Описание:

Функция ОсновнойЖурналРасчетов устанавливает основной журнал расчетов. По умолчанию основной журнал расчетов — первый в списке журналов расчетов.

Пример:

ОсновнойЖурналРасчетов("Основной");

---

---