Программный интерфейс инструментария разработчика "1С:Библиотека стандартных подсистем" включает в себя все экспортные процедуры и функции, которые размещены в областях кода ПрограммныйИнтерфейс. При разработке собственных библиотек и прикладных решений настоятельно рекомендуется использовать только процедуры и функции программного интерфейса библиотеки.
При выпуске новых версий библиотеки в этих процедурах и функциях обеспечивается обратная совместимость, поэтому прикладным разработчикам не требуется пересматривать свой код и адаптировать объекты метаданных своих конфигураций под новые требования и возможности каждой новой версии библиотеки. Это не гарантируется для всех прочих служебных экспортных процедур и функций.
Для удобства поиска и изучения программный интерфейс сгруппирован по подсистемам и разделен на две основные категории:
Интерфейс – экспортные процедуры и функции, которые предназначены для вызова из прикладного кода;
Переопределение – экспортные процедуры переопределяемых модулей, содержимое которых может или должно быть изменено в конфигурации-потребителе. С их помощью решаются задачи изменения поведения библиотечной функциональности, ее параметризации спецификой конфигурации-потребителя, а также для подключения библиотечной функциональности к объектам конфигурации-потребителя. Они не предназначены для вызова из прикладного кода.
Подробнее о программном интерфейсе и переопределяемых модулях см. в "Системе стандартов и методик разработки конфигураций для платформы 1С:Предприятие 8", в разделе "Разработка и использование библиотек".
Выполняет произвольный алгоритм на встроенном языке 1С:Предприятия, предварительно устанавливая
безопасный режим выполнения кода и безопасный режим разделения данных для всех разделителей,
присутствующих в составе конфигурации. В результате при выполнении алгоритма:
- игнорируются попытки установки привилегированного режима,
- запрещаются все внешние (по отношению к платформе 1С:Предприятие) действия (COM,
загрузка внешних компонент, запуск внешних приложений и команд операционной системы,
доступ к файловой системе и Интернет-ресурсам),
- запрещается отключение использования разделителей сеанса,
- запрещается изменение значений разделителей сеанса (если разделение данным разделителем не
является условно выключенным),
- запрещается изменение объектов, которые управляют состоянием условного разделения.
Синтаксис
Процедура ВыполнитьКод(Знач Алгоритм, Знач Параметры = Неопределено) Экспорт
Параметры
Алгоритм - Строка - содержащая произвольный алгоритм на встроенном языке 1С:Предприятия.
Параметры - Произвольный - в качестве значения данного параметра может быть передано значение,
которое требуется для выполнения алгоритма (при этом в тексте алгоритма обращение к данному
значению должно осуществляться как к имени переменной Параметры).
Пример вызова
ЕХТ_БезопасныйРежим.ВыполнитьКод(Алгоритм, Параметры)
Доступность
Сервер, Толстый клиент, Внешнее соединение
Проверяет наличие механизма платформы, предупреждающего об опасных действиях.
Синтаксис
Функция ЕстьЗащитаОтОпасныхДействий() Экспорт
Возвращаемое значение
Булево - если Истина, тогда работает механизм предупреждений безопасности.
Пример вызова
Результат = ЕХТ_БезопасныйРежим.ЕстьЗащитаОтОпасныхДействий()
Доступность
Сервер, Толстый клиент, Внешнее соединение
Возвращает описание защиты от опасных действий с отключенными предупреждениями. Функция не приводит к ошибке компиляции при отсутствии в платформе механизмов предупреждений безопасности.
Синтаксис
Функция ОписаниеЗащитыБезПредупреждений() Экспорт
Возвращаемое значение
ОписаниеЗащитыОтОпасныхДействий - со свойством ПредупреждатьОбОпасныхДействиях = Ложь.
Пример вызова
Результат = ЕХТ_БезопасныйРежим.ОписаниеЗащитыБезПредупреждений()
Доступность
Сервер, Толстый клиент, Внешнее соединение
Проверят установленность безопасного режима, игнорируя безопасный режим профиля безопасности, использующегося в качестве профиля безопасности с уровнем привилегий конфигурации.
Синтаксис
Функция Установлен() Экспорт
Возвращаемое значение
Булево - Истина, если установлен, иначе Ложь.
Пример вызова
Результат = ЕХТ_БезопасныйРежим.Установлен()
Доступность
Сервер, Толстый клиент, Внешнее соединение
Получает номер версии без номера сборки.
Синтаксис
Функция БезНомераСборки(Знач Версия) Экспорт
Параметры
Версия - Строка - версия конфигурации в формате РР.ПП.ЗЗ.СС,
где СС - номер сборки, который будет удален.
Возвращаемое значение
Строка - номер версии конфигурации без номера сборки в формате РР.ПП.ЗЗ.
Пример вызова
Результат = ЕХТ_Версия.БезНомераСборки(Версия)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает преобразованную в число строку версии.
Пример: ЕХТ_Версия.вЧисло("1.6.4.7") = 1000600040007
Синтаксис
Функция вЧисло(Знач Версия, Знач КоличествоРазрядов = 4) Экспорт
Пример вызова
Результат = ЕХТ_Версия.вЧисло(Версия, КоличествоРазрядов)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает версию расширения. Если имя расширения не указано, то возвращает версию расширения ЕХТ.
Синтаксис
Функция Расширения(Знач ИмяРасширения = "ЕХТ") Экспорт
Пример вызова
Результат = ЕХТ_Версия.Расширения(ИмяРасширения)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Получает редакцию версии.
Синтаксис
Функция Редакция(Знач Версия) Экспорт
Параметры
Версия - Строка - версия конфигурации в формате РР.ПП.ЗЗ.СС,
где ЗЗ и СС - номер версии и номер сборки, которые будут удалены.
Возвращаемое значение
Строка - номер редакции конфигурации РР.ПП.
Пример вызова
Результат = ЕХТ_Версия.Редакция(Версия)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Проверяет соответствие полученной строки формату версий.
Синтаксис
Функция СоответствуетФормату(Знач Строка, Знач КоличествоЧастей = 4) Экспорт
Параметры
Строка - Строка - Проверяемая строка. КоличествоЧастей - Число - Количество проверяемых частей версии.
Возвращаемое значение
Булево - Истина, если соответствует.
Пример вызова
Результат = ЕХТ_Версия.СоответствуетФормату(Строка, КоличествоЧастей)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Сравнить две строки версий. Возвращает Число: больше 0, если СтрокаВерсии1 > СтрокаВерсии2; 0, если версии равны.
Синтаксис
Функция Сравнить(Знач СтрокаВерсии1, Знач СтрокаВерсии2, Знач СравнитьПервыеЧасти = 4) Экспорт
Параметры
СтрокаВерсии1 - Строка - первый номер версии. СтрокаВерсии2 - Строка - второй сравниваемый номер версии. СравнитьПервыеЧасти - Число - количество первых частей, которые надо сравнить.
Возвращаемое значение
Число - больше 0, если СтрокаВерсии1 > СтрокаВерсии2; 0, если версии равны.
Пример вызова
Результат = ЕХТ_Версия.Сравнить(СтрокаВерсии1, СтрокаВерсии2, СравнитьПервыеЧасти)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Сравнить первые три части строк версий.
Синтаксис
Функция СравнитьБезНомераСборки(Знач СтрокаВерсии1, Знач СтрокаВерсии2) Экспорт
Параметры
СтрокаВерсии1 - Строка - первый номер версии. СтрокаВерсии2 - Строка - второй сравниваемый номер версии.
Возвращаемое значение
Число - больше 0, если СтрокаВерсии1 > СтрокаВерсии2; 0, если версии равны.
Пример вызова
Результат = ЕХТ_Версия.СравнитьБезНомераСборки(СтрокаВерсии1, СтрокаВерсии2)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Сравнивает версию конфигурации с переданным значением.
Синтаксис
Функция СравнитьКонфигурацию(Знач СтрокаВерсии) Экспорт
Параметры
СтрокаВерсии - Строка - Проверяемое значение.
Возвращаемое значение
Число - больше 0, если версия конфигурации > СтрокаВерсии; 0, если версии равны.
Пример вызова
Результат = ЕХТ_Версия.СравнитьКонфигурацию(СтрокаВерсии)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Сравнивает версию платформы с переданным значением.
Синтаксис
Функция СравнитьПлатформу(Знач СтрокаВерсии) Экспорт
Параметры
СтрокаВерсии - Строка - Проверяемое значение.
Возвращаемое значение
Число - больше 0, если версия платформы > СтрокаВерсии; 0, если версии равны.
Пример вызова
Результат = ЕХТ_Версия.СравнитьПлатформу(СтрокаВерсии)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Сравнивает режим совместимости конфигурации с переданным значением.
Синтаксис
Функция СравнитьРежимСовместимости(Знач СтрокаВерсии) Экспорт
Параметры
СтрокаВерсии - Строка - Проверяемое значение.
Возвращаемое значение
Число - больше 0, если режим совместимости конфигурации > СтрокаВерсии; 0, если версии равны.
Пример вызова
Результат = ЕХТ_Версия.СравнитьРежимСовместимости(СтрокаВерсии)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Выполнить метод внешнего компонента
Синтаксис
Функция ВыполнитьМетод(Объект, Имя, Параметры = Неопределено) Экспорт
Параметры
Объект - Экземпляр класса внешнего компонента Имя - Строка, имя выполняемого метода Параметры - Структура, содержит имена и значения параметров
Возвращаемое значение
Произвольный - результат, возвращаемый методом
Пример вызова
Результат = ЕХТ_ВК.ВыполнитьМетод(Объект, Имя, Параметры)
Доступность
Сервер, Тонкий клиент
Выполнить метод внешнего компонента асинхронно
Синтаксис
Процедура ВыполнитьМетодАсинхронно(Объект, Имя, ОписаниеОповещения, Параметры = Неопределено) Экспорт
Параметры
Объект - Экземпляр класса внешнего компонента Имя - Строка, имя выполняемого метода Параметры - Структура, содержит имена и значения параметров ОписаниеОповещения - описание оповещения
Пример вызова
ЕХТ_ВК.ВыполнитьМетодАсинхронно(Объект, Имя, ОписаниеОповещения, Параметры)
Доступность
Сервер, Тонкий клиент
Начать подключение внешней компоненты ОписаниеОповещения - ОписаниеОповещения
Синтаксис
Процедура НачатьПодключение(Знач ОписаниеОповещения) Экспорт
Пример вызова
ЕХТ_ВК.НачатьПодключение(ОписаниеОповещения)
Доступность
Сервер, Тонкий клиент
Начинает получение заданного объекта внешней компоненты
Синтаксис
Процедура НачатьПолучениеОбъекта(ОписаниеОповещения, ОписаниеОбъекта) Экспорт
Параметры
ОписаниеОповещения - ОписаниеОповещения ИмяОбъекта - Строка
Пример вызова
ЕХТ_ВК.НачатьПолучениеОбъекта(ОписаниеОповещения, ОписаниеОбъекта)
Доступность
Сервер, Тонкий клиент
Подключить внешнюю компоненту
Синтаксис
Процедура Подключить(Знач Местоположение, Знач Имя, Знач Тип = Неопределено) Экспорт
Пример вызова
ЕХТ_ВК.Подключить(Местоположение, Имя, Тип)
Доступность
Сервер, Тонкий клиент
Подключает компоненту, выполненную по технологии Native API и COM. Компонента должна храниться в макете конфигурации в виде ZIP-архива.
Синтаксис
Функция ПодключитьИзМакета(Идентификатор, ПолноеИмяМакета) Экспорт
Параметры
Идентификатор - Строка - идентификатор объекта внешней компоненты. ПолноеИмяМакета - Строка - полное имя макета конфигурации, хранящего ZIP-архив.
Возвращаемое значение
AddIn, Неопределено - экземпляр объекта внешней компоненты или Неопределено, если не удалось создать.
Пример вызова
ПодключаемыйМодуль = ОбщегоНазначения.ПодключитьКомпонентуИзМакета(
"CNameDecl",
"ОбщийМакет.КомпонентаСклоненияФИО");
Если ПодключаемыйМодуль <> Неопределено Тогда
// ПодключаемыйМодуль содержит созданный экземпляр подключенной компоненты.
КонецЕсли;
ПодключаемыйМодуль = Неопределено;
Доступность
Сервер, Тонкий клиент
Заканчивает вызов внешней компоненты
Синтаксис
Процедура ПослеВыполнения(Результат, ПараметрыВызова, ДополнительныеПараметры) Экспорт
Параметры
Результат - Произвольный ПараметрыВызова - Массив ДополнительныеПараметры - Произвольный
Пример вызова
ЕХТ_ВК.ПослеВыполнения(Результат, ПараметрыВызова, ДополнительныеПараметры)
Доступность
Сервер, Тонкий клиент
Заканчивает вызов внешней компоненты с ошибкой
Синтаксис
Процедура ПослеВыполненияСОшибкой(Ошибка, СтандартнаяОбработка, ДополнительныеПараметры) Экспорт
Параметры
Ошибка - ИнформацияОбОшибке СтандартнаяОбработка - Булево ДополнительныеПараметры - Произвольный
Пример вызова
ЕХТ_ВК.ПослеВыполненияСОшибкой(Ошибка, СтандартнаяОбработка, ДополнительныеПараметры)
Доступность
Сервер, Тонкий клиент
Заканчивает подключение внешней компоненты
Синтаксис
Процедура ПослеПодключения(Подключено, ДополнительныеПараметры) Экспорт
Параметры
Подключено - Булево ДополнительныеПараметры - Произвольный
Пример вызова
ЕХТ_ВК.ПослеПодключения(Подключено, ДополнительныеПараметры)
Доступность
Сервер, Тонкий клиент
Заканчивает подключение внешней компоненты с ошибкой
Синтаксис
Процедура ПослеПодключенияСОшибкой(Ошибка, СтандартнаяОбработка, ДополнительныеПараметры) Экспорт
Параметры
Ошибка - ИнформацияОбОшибке СтандартнаяОбработка - Булево ДополнительныеПараметры - Произвольный
Пример вызова
ЕХТ_ВК.ПослеПодключенияСОшибкой(Ошибка, СтандартнаяОбработка, ДополнительныеПараметры)
Доступность
Сервер, Тонкий клиент
Заканчивает получение объекта внешней компоненты
Синтаксис
Процедура ПослеПолученияОбъекта(Результат, ДополнительныеПараметры) Экспорт
Параметры
Результат - заданный объект внешней компоненты или ИнформацияОбОшибке ДополнительныеПараметры - Произвольный
Пример вызова
ЕХТ_ВК.ПослеПолученияОбъекта(Результат, ДополнительныеПараметры)
Доступность
Сервер, Тонкий клиент
Заканчивает установку внешней компоненты ДополнительныеПараметры - произвольный
Синтаксис
Процедура ПослеУстановки(ДополнительныеПараметры) Экспорт
Пример вызова
ЕХТ_ВК.ПослеУстановки(ДополнительныеПараметры)
Доступность
Сервер, Тонкий клиент
Завершает неудачную установку компоненты
Синтаксис
Процедура ПослеУстановкиСОшибкой(Ошибка, СтандартнаяОбработка, ДополнительныеПараметры) Экспорт
Параметры
Ошибка - ИнформацияОбОшибке СтандартнаяОбработка - Булево ДополнительныеПараметры - Произвольный
Пример вызова
ЕХТ_ВК.ПослеУстановкиСОшибкой(Ошибка, СтандартнаяОбработка, ДополнительныеПараметры)
Доступность
Сервер, Тонкий клиент
Выполняет регистрацию компоненты "comcntr.dll" для текущей версии платформы. В случае успешной регистрации, предлагает пользователю перезапустить клиентский сеанс для того чтобы регистрация вступила в силу. Вызывается перед клиентским кодом, который использует менеджер COM-соединений (V83.COMConnector) и инициируется интерактивными действиями пользователя.
Синтаксис
Процедура ЗарегистрироватьCOMСоединитель(Знач ВыполнитьПерезагрузкуСеанса = Истина, Знач Оповещение = Неопределено) Экспорт
Параметры
ВыполнитьПерезагрузкуСеанса - Булево - если Истина, то после регистрации COM соединителя
будет вызван диалог перезапуска сеанса.
Оповещение - ОписаниеОповещения - оповещение о результате регистрации.
- Зарегистрировано - Булево - Истина, если COM соединитель зарегистрирован без ошибок.
- ДополнительныеПараметры - Произвольный - значение, которое было указано
при создании объекта ОписаниеОповещения.
Пример вызова
ЗарегистрироватьCOMСоединитель();
Доступность
Сервер, Тонкий клиент
Продолжение процедуры ОбщегоНазначенияКлиент.ЗарегистрироватьCOMСоединитель.
Синтаксис
Функция ЗарегистрироватьCOMСоединительДоступнаРегистрация() Экспорт
Пример вызова
Результат = ЕХТ_ВнешнееСоединение.ЗарегистрироватьCOMСоединительДоступнаРегистрация()
Доступность
Сервер, Тонкий клиент
Продолжение процедуры ОбщегоНазначенияКлиент.ЗарегистрироватьCOMСоединитель.
Синтаксис
Процедура ЗарегистрироватьCOMСоединительОповеститьОбОшибке(Контекст) Экспорт
Пример вызова
ЕХТ_ВнешнееСоединение.ЗарегистрироватьCOMСоединительОповеститьОбОшибке(Контекст)
Доступность
Сервер, Тонкий клиент
Продолжение процедуры ОбщегоНазначенияКлиент.ЗарегистрироватьCOMСоединитель.
Синтаксис
Процедура ЗарегистрироватьCOMСоединительПриПроверкеОтветаОПерезапускеСеанса(Ответ, Контекст) Экспорт
Пример вызова
ЕХТ_ВнешнееСоединение.ЗарегистрироватьCOMСоединительПриПроверкеОтветаОПерезапускеСеанса(Ответ, Контекст)
Доступность
Сервер, Тонкий клиент
Продолжение процедуры ОбщегоНазначенияКлиент.ЗарегистрироватьCOMСоединитель.
Синтаксис
Процедура ЗарегистрироватьCOMСоединительПриПроверкеРегистрации(Результат, Контекст) Экспорт
Пример вызова
ЕХТ_ВнешнееСоединение.ЗарегистрироватьCOMСоединительПриПроверкеРегистрации(Результат, Контекст)
Доступность
Сервер, Тонкий клиент
Возвращает CLSID COM-класса для работы с "1С:Предприятием 8" через COM-соединение.
Синтаксис
Функция ИдентификаторCOMСоединителя(Знач ИмяCOMСоединителя) Экспорт
Параметры
ИмяCOMСоединителя - Строка - имя COM-класса для работы с "1С:Предприятием 8" через COM-соединение.
Возвращаемое значение
Строка - строковое представление CLSID.
Пример вызова
Результат = ЕХТ_ВнешнееСоединение.ИдентификаторCOMСоединителя(ИмяCOMСоединителя)
Доступность
Сервер, Тонкий клиент
Возвращает имя COM-класса для работы с 1С:Предприятием 8 через COM-соединение.
Синтаксис
Функция ИмяCOMСоединителя() Экспорт
Возвращаемое значение
Строка - имя COM-класса для работы с 1С:Предприятием 8 через COM-соединение.
Пример вызова
Результат = ЕХТ_ВнешнееСоединение.ИмяCOMСоединителя()
Доступность
Сервер, Тонкий клиент
Возвращает шаблон структуры параметров для установки внешнего соединения. Параметрам необходимо задать требуемые значения и передать в метод ОбщегоНазначения.УстановитьВнешнееСоединение().
Синтаксис
Функция Параметры() Экспорт
Возвращаемое значение
Структура - коллекция параметров.
Пример вызова
Результат = ЕХТ_ВнешнееСоединение.Параметры()
Доступность
Сервер, Тонкий клиент
Извлекает из строки соединения с информационной базой параметры подключения и передает параметры в структуру для установки внешнего соединения.
Синтаксис
Функция ПараметрыИзСтрокиСоединения(Знач СтрокаСоединения) Экспорт
Параметры
СтрокаСоединения - Строка - строка соединения ИБ.
Возвращаемое значение
см. СтруктураПараметровДляУстановкиВнешнегоСоединения.
Пример вызова
Результат = ЕХТ_ВнешнееСоединение.ПараметрыИзСтрокиСоединения(СтрокаСоединения)
Доступность
Сервер, Тонкий клиент
Устанавливает внешнее соединение с информационной базой по переданным параметрам подключения и возвращает указатель на это соединение.
Синтаксис
Функция Установить(Параметры) Экспорт
Параметры
Параметры - см. ЕХТ_ВнешнееСоединение.Параметры
Возвращаемое значение
Структура - информация о соединении:
* Соединение - COMОбъект, Неопределено - указатель на COM-объект соединения или Неопределено в случае ошибки;
* КраткоеОписаниеОшибки - Строка - краткое описание ошибки;
* ПодробноеОписаниеОшибки - Строка - подробное описание ошибки;
* ОшибкаПодключенияКомпоненты - Булево - флаг ошибки подключения COM.
Пример вызова
Результат = ЕХТ_ВнешнееСоединение.Установить(Параметры)
Доступность
Сервер, Тонкий клиент
Формирует представление даты в формате GMT Источник: УправлениеЭлектроннойПочтой.ПолучитьДатуСтрокойСоСмещениемGMT
Синтаксис
Функция вGMT(Знач Дата) Экспорт
Пример вызова
Результат = ЕХТ_ДатаВремя.вGMT(Дата)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает дату, как строку в формата ISO8601.
Синтаксис
Функция вISO8601(Знач Дата) Экспорт
Параметры
Дата - дата для преобразования.
Возвращаемое значение
Строка - строка даты в формате ISO8601.
Пример вызова
Результат = ЕХТ_ДатаВремя.вISO8601(Дата)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Преобразует универсальную дату в дату формата rfc1123-date ("Sun, 31 Mar 2019 10:25:27 GMT")
См. https://www.w3.org/Protocols/rfc2616/rfc2616-sec3.html, п. 3.3.1.
Синтаксис
Функция вRFC1123(Знач Дата) Экспорт
Пример вызова
Результат = ЕХТ_ДатаВремя.вRFC1123(Дата)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Формирует представление даты в формате Coordinated Universal Time.
Синтаксис
Функция вUTC(Знач Дата) Экспорт
Параметры
Дата - ДатаВремя - дата, представление которой необходимо получить.
Возвращаемое значение
Строка - представление даты в формате Coordinated Universal Time(UTC).
Пример вызова
Результат = ЕХТ_ДатаВремя.вUTC(Дата)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает количество секунд, прошедших с начала дня.
Синтаксис
Функция Время(Знач Дата) Экспорт
Пример вызова
Результат = ЕХТ_ДатаВремя.Время(Дата)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает сокращенное название дня недели по дате.
Синтаксис
Функция ДеньНеделиСтр(Знач Дата) Экспорт
Пример вызова
Результат = ЕХТ_ДатаВремя.ДеньНеделиСтр(Дата)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает строку "Пн,Вт,Ср,Чт,Пт,Сб,Вс"
Синтаксис
Функция ДниНеделиСтр() Экспорт
Возвращаемое значение
Строка -
Пример вызова
Результат = ЕХТ_ДатаВремя.ДниНеделиСтр()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает дату с добавленным количеством дней.
Синтаксис
Функция ДобавитьДень(Знач Дата, Знач КоличествоДней = 1) Экспорт
Возвращаемое значение
Дата - дата с добавленным количеством дней.
Пример вызова
Результат = ЕХТ_ДатаВремя.ДобавитьДень(Дата, КоличествоДней)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает дату с добавленным количеством дней к исходной дате.
Синтаксис
Функция ДобавитьДни(Знач Дата, Знач КоличествоДней) Экспорт
Параметры
Дата - Дата - Исходная дата. КоличествоДней - Число - Количество дней.
Возвращаемое значение
Дата - Новая дата.
Пример вызова
Результат = ЕХТ_ДатаВремя.ДобавитьДни(Дата, КоличествоДней)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает Истина, если параметр дата и не она пустая
Синтаксис
Функция Заполнена(Знач Дата) Экспорт
Пример вызова
Результат = ЕХТ_ДатаВремя.Заполнена(Дата)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает дату из строки формата ISO8601.
Синтаксис
Функция ИзISO8601(Знач СтрокаДаты) Экспорт
Параметры
СтрокаДаты - Строка - строка даты в формате ISO8601.
Возвращаемое значение
Дата - дата из строки.
Пример вызова
Результат = ЕХТ_ДатаВремя.ИзISO8601(СтрокаДаты)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Преобразует дату формата rfc1123-date в обычную универсальную дату. См. https://www.w3.org/Protocols/rfc2616/rfc2616-sec3.html, п. 3.3.1.
Синтаксис
Функция ИзRFC1123(Знач ДатаСтрокой) Экспорт
Пример вызова
Результат = ЕХТ_ДатаВремя.ИзRFC1123(ДатаСтрокой)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Функция преобразовывает дату в формате RFC822 к формату 1С - дата и время
Синтаксис
Функция ИзRFC822(Знач СтрокаДата) Экспорт
Параметры
СтрокаДата – Строка вида "Tue, 27 May 2012 15:30:00 +0300"
Возвращаемое значение
<Дата> – Результат преобразования или Неопределено, если преобразование не удалось
Пример вызова
Результат = ЕХТ_ДатаВремя.ИзRFC822(СтрокаДата)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Преобразует исходную строку в дату. Если дату не удалось распознать, то возвращается пустая дата (01.01.01 00:00:00).
Синтаксис
Функция ИзСтроки(Знач Значение, ДополнительныеПараметры = Неопределено) Экспорт
Параметры
Значение - Строка - строка, которую необходимо привести к дате.
Формат даты должен быть в виде "ДД.ММ.ГГГГ" или "ДД/ММ/ГГ" или "ДД-ММ-ГГ ЧЧ:ММ:CC",
Например, "23.02.1980" или "23/02/80 09:15:45".
ДополнительныеПараметры - Структура:
ЧастьДаты - Строка или ЧастиДаты - Определяет допустимые части даты. По умолчанию, ЧастиДаты.ДатаВремя.
Возвращаемое значение
Дата - полученная дата. Если в результате преобразования возникла ошибка, то текст ошибки возвращается в параметре ДополнительныеПараметры.Ошибка.
Пример вызова
Результат = ЕХТ_ДатаВремя.ИзСтроки(Значение, ДополнительныеПараметры)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Проверяет пересекаются ли интервалы
Синтаксис
Функция ИнтервалыПересекаются(Знач ДатаНачалаПервогоИнтервала, Знач ДатаОкончанияПервогоИнтервала, Знач ДатаНачалаВторогоИнтервала, Знач ДатаОкончанияВторогоИнтервала) Экспорт
Параметры
ДатаНачалаПервогоИнтервала - Дата - дата начала первого интервала. ДатаОкончанияПервогоИнтервала - Дата - дата окончания первого интервала. ДатаНачалаВторогоИнтервала - Дата - дата начала второго интервала. ДатаОкончанияВторогоИнтервала - Дата - дата окончания второго интервала.
Возвращаемое значение
Булево - истина, если интервалы пересекаются, ложь, если не пересекаются.
Пример вызова
Результат = ЕХТ_ДатаВремя.ИнтервалыПересекаются(ДатаНачалаПервогоИнтервала, ДатаОкончанияПервогоИнтервала, ДатаНачалаВторогоИнтервала, ДатаОкончанияВторогоИнтервала)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает количество дней в неделе.
Синтаксис
Функция КоличествоДнейВНеделе() Экспорт
Возвращаемое значение
Число - количество дней в неделе.
Пример вызова
Результат = ЕХТ_ДатаВремя.КоличествоДнейВНеделе()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает количество дней в периоде.
Синтаксис
Функция КоличествоДнейВПериоде(Знач ДатаНачала, Знач ДатаОкончания) Экспорт
Пример вызова
Результат = ЕХТ_ДатаВремя.КоличествоДнейВПериоде(ДатаНачала, ДатаОкончания)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает количество минут в сутках.
Синтаксис
Функция КоличествоМинутВСутках() Экспорт
Возвращаемое значение
Число - количество минут в сутках.
Пример вызова
Результат = ЕХТ_ДатаВремя.КоличествоМинутВСутках()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает количество минут в часе.
Синтаксис
Функция КоличествоМинутВЧасе() Экспорт
Возвращаемое значение
Число - количество минут в часе.
Пример вызова
Результат = ЕХТ_ДатаВремя.КоличествоМинутВЧасе()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает количество секунд в минуте.
Синтаксис
Функция КоличествоСекундВМинуте() Экспорт
Возвращаемое значение
Число - количество секунд в минуте.
Пример вызова
Результат = ЕХТ_ДатаВремя.КоличествоСекундВМинуте()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает количество секунд в сутках.
Синтаксис
Функция КоличествоСекундВСутках() Экспорт
Возвращаемое значение
Число - количество секунд в сутках.
Пример вызова
Результат = ЕХТ_ДатаВремя.КоличествоСекундВСутках()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает количество секунд в часе.
Синтаксис
Функция КоличествоСекундВЧасе() Экспорт
Возвращаемое значение
Число - количество секунд в часе.
Пример вызова
Результат = ЕХТ_ДатаВремя.КоличествоСекундВЧасе()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает количество часов в сутках.
Синтаксис
Функция КоличествоЧасовВСутках() Экспорт
Возвращаемое значение
Число - количество часов в сутках.
Пример вызова
Результат = ЕХТ_ДатаВремя.КоличествоЧасовВСутках()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает конечную дату интервала
Синтаксис
Функция КонецПериода(Знач ДатаПериода, Знач Периодичность) Экспорт
Параметры
ДатаПериода - <Дата> - дата входящая в интервал Периодичность - <Строка> - интервал представление которого необходимо сформировать.
Возвращаемое значение
<Дата> - конечная дата переданного интервала.
Пример вызова
Результат = ЕХТ_ДатаВремя.КонецПериода(ДатаПериода, Периодичность)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает максимальную дату, поддерживаемую в системе.
Синтаксис
Функция Максимальная() Экспорт
Пример вызова
Результат = ЕХТ_ДатаВремя.Максимальная()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает массив дней, входящих в период.
Синтаксис
Функция МассивДатИзПериода(Знач ДатаНачала, Знач ДатаОкончания) Экспорт
Параметры
ДатаНачала - Дата ОкончаниеПериода - Дата
Возвращаемое значение
Массив из Дата - Дни периода.
Пример вызова
Результат = ЕХТ_ДатаВремя.МассивДатИзПериода(ДатаНачала, ДатаОкончания)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает массив дней, входящих в массив периодов.
Синтаксис
Функция МассивДатИзПериодов(Знач Периоды) Экспорт
Параметры
Периоды - Массив, ТаблицаЗначений - Коллекция периодов.
* НачалоПериода - Дата
* ОкончаниеПериода - Дата
Возвращаемое значение
Массив из Дата - Дни периодов.
Пример вызова
Результат = ЕХТ_ДатаВремя.МассивДатИзПериодов(Периоды)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает количество секунд для переданных минут.
Синтаксис
Функция МинутыВСекунды(Знач КоличествоМинут = 0) Экспорт
Пример вызова
Результат = ЕХТ_ДатаВремя.МинутыВСекунды(КоличествоМинут)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает представление периода. Имя функции "ПредставлениеПериода" занято платформой.
Синтаксис
Функция НаименованиеПериода(Знач НачалоПериода, Знач ОкончаниеПериода) Экспорт
Параметры
НачалоПериода - Дата ОкончаниеПериода - Дата
Возвращаемое значение
Строка - Представление периода.
Пример вызова
Результат = ЕХТ_ДатаВремя.НаименованиеПериода(НачалоПериода, ОкончаниеПериода)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает начальную дату интервала
Синтаксис
Функция НачалоПериода(Знач ДатаПериода, Знач Периодичность) Экспорт
Параметры
ДатаПериода - <Дата> - дата входящая в интервал Периодичность - <Строка> - интервал представление которого необходимо сформировать.
Возвращаемое значение
<Дата> - начальная дата переданного интервала.
Пример вызова
Результат = ЕХТ_ДатаВремя.НачалоПериода(ДатаПериода, Периодичность)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает период пересечения
Синтаксис
Функция ПериодПересеченияДвухИнтервалов(Знач ДатаНачалаПервогоИнтервала, Знач ДатаОкончанияПервогоИнтервала, Знач ДатаНачалаВторогоИнтервала, Знач ДатаОкончанияВторогоИнтервала) Экспорт
Параметры
ДатаНачалаПервогоИнтервала - Дата - дата начала первого интервала. ДатаОкончанияПервогоИнтервала - Дата - дата окончания первого интервала. ДатаНачалаВторогоИнтервала - Дата - дата начала второго интервала. ДатаОкончанияВторогоИнтервала - Дата - дата окончания второго интервала.
Возвращаемое значение
Структура - структура с периодом пересечения двух периодов * ДатаНачала - Дата - начало периода пересечения. * ДатаОкончания - Дата - окончание периода пересечения.
Пример вызова
Результат = ЕХТ_ДатаВремя.ПериодПересеченияДвухИнтервалов(ДатаНачалаПервогоИнтервала, ДатаОкончанияПервогоИнтервала, ДатаНачалаВторогоИнтервала, ДатаОкончанияВторогоИнтервала)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает массив периодов на основании массива дней.
Синтаксис
Функция ПериодыИзМассиваДат(Знач МассивДат) Экспорт
Параметры
МассивДат - Массив из Дата
Возвращаемое значение
Массив - Периоды.
* НачалоПериода - Дата
* ОкончаниеПериода - Дата
Пример вызова
Результат = ЕХТ_ДатаВремя.ПериодыИзМассиваДат(МассивДат)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает строковое представление интервала между переданными датами или относительно переданной даты и текущей даты сеанса.
Синтаксис
Функция ПредставлениеИнтервала(Знач НачальнаяДата, Знач КонечнаяДата = Неопределено) Экспорт
Параметры
НачальнаяДата - Дата - начальная точка интервала. КонечнаяДата - Дата - конечная точка интервала, если не задана - берется текущая дата сеанса.
Возвращаемое значение
Строка - представление интервала времени.
Пример вызова
Результат = ЕХТ_ДатаВремя.ПредставлениеИнтервала(НачальнаяДата, КонечнаяДата)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает представление интервала в годах, месяцах и днях.
Синтаксис
Функция ПредставлениеИнтервалаГМД(Знач Дата1, Знач Дата2) Экспорт
Параметры
Дата1 - Дата - Первая дата интервала.
Дата2 - Дата - Вторая дата интервала.
Возвращаемое значение
Строка - представление интервала.
Пример вызова
Дата1 = Дата(2009, 12, 31);
Дата2 = Дата(2005, 1, 10);
ЕХТ.СообщитьПользователю(ЕХТ_ДатаВремя.ПредставлениеИнтервалаГМД(Дата1, Дата2)); // 4 года 11 месяцев 21 день
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает представление даты относительно текущего момента
Синтаксис
Функция ПредставлениеОтносительнойДаты(Знач ВыбраннаяДата, ДатаТекущая = Неопределено) Экспорт
Параметры
ВыбраннаяДата - Дата - Абсолютная дата синхронизации данных.
Возвращаемое значение
Строка - представление относительной даты синхронизации.
*Никогда (Т = пустая дата).
*Только что (Т < 1 мин)
*2 минуты (14 минут) назад (1 мин < Т < 15 мин)
*15 минут назад (15 мин < Т < 30 мин)
*30 минут назад (30 мин < Т < 1 час)
*1 час назад (1 час < Т < 2 час)
*2 часа назад (2 час < Т < 3 час).
*Сегодня, 12:44 (3 час < Т < вчера).
*Вчера, 22:30 (вчера < Т < позавчера).
*Позавчера, 21:22 (позавчера < Т < позапозавчера).
*<12 Марта 2012г.> (позапозавчера < Т).
Пример вызова
Результат = ЕХТ_ДатаВремя.ПредставлениеОтносительнойДаты(ВыбраннаяДата, ДатаТекущая)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает пустую дату 01-01-0001 00:00:00
Синтаксис
Функция Пустая() Экспорт
Пример вызова
Результат = ЕХТ_ДатаВремя.Пустая()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает разницу в днях между двумя датами.
Синтаксис
Функция РазницаДней(Знач Дата1, Знач Дата2) Экспорт
Пример вызова
Результат = ЕХТ_ДатаВремя.РазницаДней(Дата1, Дата2)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает разницу в секундах между двумя датами.
Синтаксис
Функция РазницаСекунд(Знач Дата1, Знач Дата2) Экспорт
Пример вызова
Результат = ЕХТ_ДатаВремя.РазницаСекунд(Дата1, Дата2)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает разность дат в годах, месяцах и днях.
Синтаксис
Процедура РазностьДатГМД(Знач Дата1, Знач Дата2, ГГ = 0, ММ = 0, ДД = 0) Экспорт
Параметры
Дата1 - Дата - Первая дата интервала.
Дата2 - Дата - Вторая дата интервала.
Пример вызова
ЕХТ_ДатаВремя.РазностьДатГМД(Дата1, Дата2, ГГ, ММ, ДД)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает количество секунд для переданных минут.
Синтаксис
Функция СекундыИзМинут(Знач КоличествоМинут = 0) Экспорт
Пример вызова
Результат = ЕХТ_ДатаВремя.СекундыИзМинут(КоличествоМинут)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает количество секунд для переданных часов.
Синтаксис
Функция СекундыИзЧасов(Знач КоличествоЧасов = 0) Экспорт
Пример вызова
Результат = ЕХТ_ДатаВремя.СекундыИзЧасов(КоличествоЧасов)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Преобразует секунды в строку вида "1 час. 2 мин. 15 сек."
Синтаксис
Функция СекундыЧЧММСС(Знач Секунд, Миллисекунд = Неопределено) Экспорт
Пример вызова
Результат = ЕХТ_ДатаВремя.СекундыЧЧММСС(Секунд, Миллисекунд)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Определяет смещение времени сервера относительно времени программы.
Синтаксис
Функция СмещениеВремениСервера() Экспорт
Возвращаемое значение
Число - смещение времени в секундах.
Может использоваться для приведения фильтров, применяемых к журналу регистрации, к дате сервера,
а также для приведения дат, полученных из журнала регистрации, к датам программы.
Пример вызова
Результат = ЕХТ_ДатаВремя.СмещениеВремениСервера()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает ТекущаяУниверсальнаяДата.
Синтаксис
Функция Универсальная() Экспорт
Пример вызова
Результат = ЕХТ_ДатаВремя.Универсальная()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает дату в формате ЧЧ:ММ (часы и минуты)
Синтаксис
Функция ФорматЧЧММ(Знач Дата) Экспорт
Параметры
Дата - ДатаВремя - дата, представление которой необходимо получить.
Возвращаемое значение
Строка - представление даты в формате ЧЧ:ММ (часы и минуты)
Пример вызова
Результат = ЕХТ_ДатаВремя.ФорматЧЧММ(Дата)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает количество секунд для переданных часов.
Синтаксис
Функция ЧасыВСекунды(Знач КоличествоЧасов = 0) Экспорт
Пример вызова
Результат = ЕХТ_ДатаВремя.ЧасыВСекунды(КоличествоЧасов)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Определяет, является ли год високосным (или дата относится к високосному году)
Синтаксис
Функция ЭтоВисокосныйГод(Знач Год) Экспорт
Параметры
Год - Число - год, високосность которого определяется;
- Дата - любая дата года, високосность которого нужно проверить
Возвращаемое значение
Булево - Истина, если год является високосным.
Пример вызова
Результат = ЕХТ_ДатаВремя.ЭтоВисокосныйГод(Год)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает Истина, если параметр это незаполненная дата
Синтаксис
Функция ЭтоПустая(Знач Дата) Экспорт
Пример вызова
Результат = ЕХТ_ДатаВремя.ЭтоПустая(Дата)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Рекурсивное обслуживание иерархических пометок с тремя состояниями в дереве.
Синтаксис
Процедура ИзменениеПометки(ДанныеСтроки) Экспорт
Параметры
ДанныеСтроки - ДанныеФормыЭлементДерева - Пометка хранится в числовой колонке "Пометка".
Пример вызова
ЕХТ_ДеревоЗначений.ИзменениеПометки(ДанныеСтроки)
Доступность
Сервер, Тонкий клиент
Возвращает массив строк дерева, значения в которых соответствуют значениям, переданным в структуре ДанныеСтроки
Синтаксис
Функция НайтиРекурсивно(НаборСтрок, ДанныеСтроки, Найденные=Неопределено) Экспорт
Пример вызова
Результат = ЕХТ_ДеревоЗначений.НайтиРекурсивно(НаборСтрок, ДанныеСтроки, Найденные)
Доступность
Сервер, Тонкий клиент
Рекурсивное обслуживание иерархических пометок с тремя состояниями в дереве.
Синтаксис
Процедура ПроставитьПометкиВверх(ДанныеСтроки) Экспорт
Параметры
ДанныеСтроки - ДанныеФормыЭлементДерева - Пометка хранится в числовой колонке "Пометка".
Пример вызова
ЕХТ_ДеревоЗначений.ПроставитьПометкиВверх(ДанныеСтроки)
Доступность
Сервер, Тонкий клиент
Рекурсивное обслуживание иерархических пометок с тремя состояниями в дереве.
Синтаксис
Процедура ПроставитьПометкиВниз(ДанныеСтроки) Экспорт
Параметры
ДанныеСтроки - ДанныеФормыЭлементДерева - Пометка хранится в числовой колонке "Пометка".
Пример вызова
ЕХТ_ДеревоЗначений.ПроставитьПометкиВниз(ДанныеСтроки)
Доступность
Сервер, Тонкий клиент
Разворачивает узлы указанного дерева на форме.
Синтаксис
Процедура Развернуть(Форма, ИмяЭлементаФормы, ИдентификаторСтрокиДерева = "*", РазвернутьСПодчиненными = Ложь) Экспорт
Параметры
Форма - УправляемаяФорма - форма, на которой размещен элемент управления с деревом значений.
ИмяЭлементаФормы - Строка - имя элемента с таблицей формы (деревом значений) и связанного с ней
реквизита формы (должны совпадать).
ИдентификаторСтрокиДерева - Произвольный - идентификатор строки дерева, которую требуется развернуть.
Если указано "*", то будут развернуты все узлы верхнего уровня.
Если указано Неопределено, то строки дерева развернуты не будут.
Значение по умолчанию: "*".
РазвернутьСПодчиненными - Булево - если Истина, то следует раскрыть также и все подчиненные узлы.
По умолчанию Ложь.
Пример вызова
ЕХТ_ДеревоЗначений.Развернуть(Форма, ИмяЭлементаФормы, ИдентификаторСтрокиДерева, РазвернутьСПодчиненными)
Доступность
Сервер, Тонкий клиент
Возвращает таблицу значений из динамического списка.
Синтаксис
Функция вТаблицуЗначений(Знач ЭлементСписок) Экспорт
Параметры
ЭлементСписок - ТаблицаФормы - элемент формы динамического списка.
Пример вызова
Результат = ЕХТ_ДинамическийСписок.вТаблицуЗначений(ЭлементСписок)
Доступность
Сервер, Вызов сервера, Тонкий клиент
Возвращает Истина, если список пустой.
Синтаксис
Функция Пустой(Знач ЭлементСписок) Экспорт
Параметры
ЭлементСписок - ТаблицаФормы - элемент формы динамического списка.
Возвращаемое значение
Булево - Истина, если список пустой.
Пример вызова
Результат = ЕХТ_ДинамическийСписок.Пустой(ЭлементСписок)
Доступность
Сервер, Вызов сервера, Тонкий клиент
Возвращает и устанавливает свойства динамического списка
Синтаксис
Функция Свойства(Знач Список, Знач НовыеСвойства = Неопределено) Экспорт
Параметры
Список - ТаблицаФормы или ДинамическийСписок, для которого устанавливаются свойства.
НовыеСвойства - Структура - см. СтруктураСвойствДинамическогоСписка().
Структура - текущие, или если устаналиваются новые, то предыдущие, значения свойств:
* ТекстЗапроса - Строка - текст запроса.
* ОсновнаяТаблица - Строка - имя основной таблицы.
* ДинамическоеСчитываниеДанных - Булево - признак использования динамического считывания.
Пример вызова
Результат = ЕХТ_ДинамическийСписок.Свойства(Список, НовыеСвойства)
Доступность
Сервер, Вызов сервера, Тонкий клиент
Создать структуру свойств динамического списка для вызова УстановитьСвойстваДинамическогоСписка().
Синтаксис
Функция СтруктураСвойств() Экспорт
Возвращаемое значение
Структура - любое поле может иметь значение Неопределено, если оно не устанавливается:
* ТекстЗапроса - Строка - новый текст запроса.
* ОсновнаяТаблица - Строка - имя основной таблицы.
* ДинамическоеСчитываниеДанных - Булево - признак использования динамического считывания.
Пример вызова
Результат = ЕХТ_ДинамическийСписок.СтруктураСвойств()
Доступность
Сервер, Вызов сервера, Тонкий клиент
Возвращает текущие данные динамического списка.
Синтаксис
Функция ТекущиеДанные(Знач ЭлементСписок) Экспорт
Параметры
Список - <ДинамическийСписок> - динамический список.
Возвращаемое значение
<ДанныеФормыСтруктура> - текущие данные списка.
Если в списке нет активной строки или активной является строка группировки - возвращается Неопределено.
Пример вызова
Результат = ЕХТ_ДинамическийСписок.ТекущиеДанные(ЭлементСписок)
Доступность
Сервер, Вызов сервера, Тонкий клиент
Удалить элемент группы отбора динамического списка.
Синтаксис
Процедура УдалитьЭлементыГруппыОтбора(Список, ИмяПоля = Неопределено, Представление = Неопределено) Экспорт
Параметры
ДинамическийСписок - ДинамическийСписок - реквизит формы, для которого требуется установить отбор. ИмяПоля - Строка - имя поля компоновки (не используется для групп). Представление - Строка - представление поля компоновки.
Пример вызова
ЕХТ_ДинамическийСписок.УдалитьЭлементыГруппыОтбора(Список, ИмяПоля, Представление)
Доступность
Сервер, Вызов сервера, Тонкий клиент
Установить или обновить значение параметра ИмяПараметра динамического списка Список.
Синтаксис
Процедура УстановитьПараметр(Список, ИмяПараметра, Значение, Использование = Истина) Экспорт
Параметры
Список - ДинамическийСписок - реквизит формы, для которого требуется установить параметр. ИмяПараметра - Строка - имя параметра динамического списка. Значение - Произвольный - новое значение параметра. Использование - Булево - признак использования параметра.
Пример вызова
ЕХТ_ДинамическийСписок.УстановитьПараметр(Список, ИмяПараметра, Значение, Использование)
Доступность
Сервер, Вызов сервера, Тонкий клиент
Установить текст запроса, основную таблицу или динамическое считывание в динамическом списке. Устанавливать эти свойства следует за один вызов этой процедуры, чтобы не снижалась производительность.
Синтаксис
Процедура УстановитьСвойства(Список, СтруктураСвойств) Экспорт
Параметры
Список - ТаблицаФормы - элемент формы динамического списка, для которого устанавливаются свойства. СтруктураПараметров - Структура - см. СтруктураСвойствДинамическогоСписка().
Пример вызова
ЕХТ_ДинамическийСписок.УстановитьСвойства(Список, СтруктураСвойств)
Доступность
Сервер, Вызов сервера, Тонкий клиент
Добавляет на форму списка условное оформление поля Дата
Синтаксис
Процедура УстановитьУсловноеОформлениеПоляДата(Форма, Знач ИмяСписка = "Список", Знач ИмяПоля = "Дата", Знач ДополнительныеПараметры = Неопределено) Экспорт
Параметры
Форма - УправляемаяФорма - Форма документа. ИмяСписка - Строка - Имя динамического списка. ИмяПоля - Строка или Массив - Имя оформляемого поля. ДополнительныеПараметры - Структура - Необязательный. Формат оформления.
Пример вызова
ЕХТ_ДинамическийСписок.УстановитьУсловноеОформлениеПоляДата(Форма, ИмяСписка, ИмяПоля, ДополнительныеПараметры)
Доступность
Сервер, Вызов сервера, Тонкий клиент
Добавить или заменить существующий элемент отбора динамического списка.
Синтаксис
Процедура УстановитьЭлементОтбора(Список, ИмяПоля, ПравоеЗначение = Неопределено, ВидСравнения = Неопределено, Представление = Неопределено, Использование = Неопределено, РежимОтображения = Неопределено, ИдентификаторПользовательскойНастройки = Неопределено) Экспорт
Параметры
ДинамическийСписок - ДинамическийСписок - Список, в котором требуется установить отбор.
ИмяПоля - Строка - Поле, по которому необходимо установить отбор.
ПравоеЗначение - Произвольный - Значение отбора.
Необязательный. Значение по умолчанию: Неопределено.
Внимание! Если передать Неопределено, то значение не будет изменено.
ВидСравнения - ВидСравненияКомпоновкиДанных - Условие отбора.
Представление - Строка - Представление элемента компоновки данных.
Необязательный. Значение по умолчанию: Неопределено.
Если указано, то выводится только флажок использования с указанным представлением (значение не выводится).
Для очистки (чтобы значение снова выводилось) следует передать пустую строку.
Использование - Булево - Флажок использования этого отбора.
Необязательный. Значение по умолчанию: Неопределено.
РежимОтображения - РежимОтображенияЭлементаНастройкиКомпоновкиДанных - Способ отображения этого отбора
пользователю.
* РежимОтображенияЭлементаНастройкиКомпоновкиДанных.БыстрыйДоступ - В группе быстрых настроек над списком.
* РежимОтображенияЭлементаНастройкиКомпоновкиДанных.Обычный - В настройка списка (в подменю Еще).
* РежимОтображенияЭлементаНастройкиКомпоновкиДанных.Недоступный - Запретить пользователю менять этот отбор.
ИдентификаторПользовательскойНастройки - Строка - Уникальный идентификатор этого отбора.
Используется для связи с пользовательскими настройками.
Пример вызова
ЕХТ_ДинамическийСписок.УстановитьЭлементОтбора(Список, ИмяПоля, ПравоеЗначение, ВидСравнения, Представление, Использование, РежимОтображения, ИдентификаторПользовательскойНастройки)
Доступность
Сервер, Вызов сервера, Тонкий клиент
Вместо этой функции рекомендуется использовать функции ВыполнитьФункцию и ВыполнитьПроцедуру. Запустить выполнение процедуры в фоновом задании, если это возможно. При выполнении любого из следующих условий запуск выполняется не в фоне, а сразу в основном потоке: * если вызов выполняется в файловой базе во внешнем соединении (в этом режиме фоновые задания не поддерживаются); * если приложение запущено в режиме отладки (параметр /C РежимОтладки) - для упрощения отладки конфигурации; * если в файловой ИБ имеются активные фоновые задания - для снижения времени ожидания пользователя; * если выполняется процедура модуля внешней обработки или внешнего отчета. Не следует использовать эту функцию, если необходимо безусловно запускать фоновое задание. Может применяться совместно с функцией ЕХТ_ДлительныеОперацииКлиент.ОжидатьЗавершение.
Синтаксис
Функция ВыполнитьВФоне(Знач ИмяПроцедуры, Знач ПараметрыПроцедуры, Знач ПараметрыВыполнения) Экспорт
Параметры
ИмяПроцедуры - Строка - имя экспортной процедуры общего модуля, модуля менеджера объекта
или модуля обработки, которую необходимо выполнить в фоне.
Например, "МойОбщийМодуль.МояПроцедура", "Отчеты.ЗагруженныеДанные.Сформировать"
или "Обработки.ЗагрузкаДанных.МодульОбъекта.Загрузить".
У процедуры должно быть два или три формальных параметра:
* Параметры - Структура - произвольные параметры ПараметрыПроцедуры;
* АдресРезультата - Строка - адрес временного хранилища, в которое нужно
поместить результат работы процедуры. Обязательно;
* АдресДополнительногоРезультата - Строка - если в ПараметрыВыполнения установлен
параметр ДополнительныйРезультат, то содержит адрес дополнительного временного
хранилища, в которое нужно поместить результат работы процедуры. Опционально.
При необходимости выполнить в фоне функцию ее следует обернуть в процедуру,
а ее результат возвращать через второй параметр АдресРезультата.
ПараметрыПроцедуры - Структура - произвольные параметры вызова процедуры ИмяПроцедуры.
ПараметрыВыполнения - см. ЕХТ_ДлительныеОперации.ПараметрыВыполненияВФоне
Возвращаемое значение
Структура:
* Статус - Строка - "Выполняется", если задание еще не завершилось;
"Выполнено", если задание было успешно выполнено;
"Ошибка", если задание завершено с ошибкой;
"Отменено", если задание отменено пользователем или администратором.
* ИдентификаторЗадания - УникальныйИдентификатор - если Статус = "Выполняется", то содержит
идентификатор запущенного фонового задания.
* АдресРезультата - Строка - адрес временного хранилища, в которое будет
помещен (или уже помещен) результат работы процедуры.
* АдресДополнительногоРезультата - Строка - если установлен параметр ДополнительныйРезультат,
содержит адрес дополнительного временного хранилища,
в которое будет помещен (или уже помещен) результат работы процедуры.
* КраткоеПредставлениеОшибки - Строка - краткая информация об исключении, если Статус = "Ошибка".
* ПодробноеПредставлениеОшибки - Строка - подробная информация об исключении, если Статус = "Ошибка".
* Сообщения - ФиксированныйМассив - если Статус <> "Выполняется", то массив объектов СообщениеПользователю,
которые были сформированы в фоновом задании.
Пример вызова
В общем виде процесс запуска и обработки результата длительной операции выглядит следующим образом:
1) Процедура, которая будет исполняться в фоне, располагается в модуле менеджера объекта или в серверном общем модуле:
Процедура ВыполнитьДействие(Параметры, АдресРезультата) Экспорт
...
ПоместитьВоВременноеХранилище(Результат, АдресРезультата);
КонецПроцедуры
2) Запуск операции на сервере и подключение обработчика ожидания:
&НаКлиенте
Процедура ВыполнитьДействие()
ДлительнаяОперация = НачатьВыполнениеНаСервере();
ПараметрыОжидания = ЕХТ_ДлительныеОперацииКлиент.ПараметрыОжидания(ЭтотОбъект);
...
ОповещениеОЗавершении = Новый ОписаниеОповещения("ВыполнитьДействиеЗавершение", ЭтотОбъект);
ЕХТ_ДлительныеОперацииКлиент.ОжидатьЗавершение(ДлительнаяОперация, ОповещениеОЗавершении, ПараметрыОжидания);
КонецПроцедуры
&НаСервере
Функция НачатьВыполнениеНаСервере()
ПараметрыПроцедуры = Новый Структура;
...
ПараметрыВыполнения = ЕХТ_ДлительныеОперации.ПараметрыВыполненияВФоне(УникальныйИдентификатор);
...
Возврат ЕХТ_ДлительныеОперации.ВыполнитьВФоне("Обработки.МояОбработка.ВыполнитьДействие",
ПараметрыПроцедуры, ПараметрыВыполнения);
КонецФункции
3) Обработка результата выполнения операции:
&НаКлиенте
Процедура ВыполнитьДействиеЗавершение(Результат, ДополнительныеПараметры) Экспорт
Если Результат = Неопределено Тогда
Возврат;
КонецЕсли;
ВывестиРезультат(Результат);
КонецПроцедуры
Доступность
Сервер, Толстый клиент, Внешнее соединение
Запустить выполнение процедуры в фоновом задании, если это возможно. При выполнении любого из следующих условий запуск выполняется не в фоне, а сразу в основном потоке: * если вызов выполняется в файловой базе во внешнем соединении (в этом режиме фоновые задания не поддерживаются); * если приложение запущено в режиме отладки (параметр /C РежимОтладки) - для упрощения отладки конфигурации; * если в файловой ИБ имеются активные фоновые задания - для снижения времени ожидания пользователя; * если выполняется процедура модуля внешней обработки или внешнего отчета. Не следует использовать эту функцию, если необходимо безусловно запускать фоновое задание. Может применяться совместно с функцией ЕХТ_ДлительныеОперацииКлиент.ОжидатьЗавершение. Вызываемая процедура может быть с произвольным числом параметров, но не более 7. Значения передаваемых параметров процедуры, а также возвращаемое значение должны быть сериализуемыми. Параметры процедуры не должны быть возвращаемыми.
Синтаксис
Функция ВыполнитьПроцедуру(Знач ПараметрыВыполнения = Неопределено, ИмяПроцедуры, Знач Параметр1 = Неопределено, Знач Параметр2 = Неопределено, Знач Параметр3 = Неопределено, Знач Параметр4 = Неопределено, Знач Параметр5 = Неопределено, Знач Параметр6 = Неопределено, Знач Параметр7 = Неопределено) Экспорт
Параметры
ПараметрыВыполнения - см. ЕХТ_ДлительныеОперации.ПараметрыВыполненияПроцедуры
ИмяПроцедуры - Строка - имя экспортной процедуры общего модуля, модуля менеджера объекта
или модуля обработки, которую необходимо выполнить в фоне.
Например, "МойОбщийМодуль.МояПроцедура", "Отчеты.ЗагруженныеДанные.Сформировать"
или "Обработки.ЗагрузкаДанных.МодульОбъекта.Загрузить".
Параметр1 - Произвольный - произвольные параметры вызова процедуры. Количество параметров может быть от 0 до 7.
Параметр2 - Произвольный
Параметр3 - Произвольный
Параметр4 - Произвольный
Параметр5 - Произвольный
Параметр6 - Произвольный
Параметр7 - Произвольный
Возвращаемое значение
Структура - параметры выполнения задания:
* Статус - Строка - "Выполняется", если задание еще не завершилось;
"Выполнено", если задание было успешно выполнено;
"Ошибка", если задание завершено с ошибкой;
"Отменено", если задание отменено пользователем или администратором.
* ИдентификаторЗадания - УникальныйИдентификатор - если Статус = "Выполняется", то содержит
идентификатор запущенного фонового задания.
* КраткоеПредставлениеОшибки - Строка - краткая информация об исключении, если Статус = "Ошибка".
* ПодробноеПредставлениеОшибки - Строка - подробная информация об исключении, если Статус = "Ошибка".
* Сообщения - ФиксированныйМассив - если Статус <> "Выполняется", то массив объектов СообщениеПользователю,
которые были сформированы в фоновом задании.
Пример вызова
В общем виде процесс запуска и обработки результата длительной операции в модуле формы выглядит следующим образом:
1) Процедура, которая будет исполняться в фоне, располагается в модуле менеджера объекта или в серверном общем модуле:
Процедура ВыполнитьРасчет(Знач МойПараметр1, Знач МойПараметр2) Экспорт
...
КонецПроцедуры
2) Запуск операции на сервере и подключение обработчика ожидания (при необходимости):
&НаКлиенте
Процедура ВыполнитьРасчет()
ДлительнаяОперация = НачатьВыполнениеНаСервере();
ОповещениеОЗавершении = Новый ОписаниеОповещения("ОбработатьРезультат", ЭтотОбъект);
ПараметрыОжидания = ЕХТ_ДлительныеОперацииКлиент.ПараметрыОжидания(ЭтотОбъект);
ЕХТ_ДлительныеОперацииКлиент.ОжидатьЗавершение(ДлительнаяОперация, ОповещениеОЗавершении, ПараметрыОжидания);
КонецПроцедуры
&НаСервере
Функция НачатьВыполнениеНаСервере()
Возврат ЕХТ_ДлительныеОперации.ВыполнитьПроцедуру(, "Обработки.МояОбработка.ВыполнитьРасчет",
МойПараметр1, МойПараметр2);
КонецФункции
3) Обработка результата длительной операции:
&НаКлиенте
Процедура ОбработатьРезультат(Результат, ДополнительныеПараметры) Экспорт
Если Результат = Неопределено Тогда
Возврат;
КонецЕсли;
ПриЗавершенииРасчета();
КонецПроцедуры
Доступность
Сервер, Толстый клиент, Внешнее соединение
Запустить выполнение функции в фоновом задании, если это возможно. При выполнении любого из следующих условий запуск выполняется не в фоне, а сразу в основном потоке: * если вызов выполняется в файловой базе во внешнем соединении (в этом режиме фоновые задания не поддерживаются); * если приложение запущено в режиме отладки (параметр /C РежимОтладки) - для упрощения отладки конфигурации; * если в файловой ИБ имеются активные фоновые задания - для снижения времени ожидания пользователя; * если выполняется функция модуля внешней обработки или внешнего отчета. Не следует использовать эту функцию, если необходимо безусловно запускать фоновое задание. Может применяться совместно с функцией ЕХТ_ДлительныеОперацииКлиент.ОжидатьЗавершение. Вызываемая функция может быть с произвольным числом параметров, но не более 7. Значения передаваемых параметров функции, а также возвращаемое значение должны быть сериализуемыми. Параметры функции не должны быть возвращаемыми.
Синтаксис
Функция ВыполнитьФункцию(Знач ПараметрыВыполнения, ИмяФункции, Знач Параметр1 = Неопределено, Знач Параметр2 = Неопределено, Знач Параметр3 = Неопределено, Знач Параметр4 = Неопределено, Знач Параметр5 = Неопределено, Знач Параметр6 = Неопределено, Знач Параметр7 = Неопределено) Экспорт
Параметры
ПараметрыВыполнения - УправляемаяФорма - форма, из которой из которой выполняется вызов;
- УникальныйИдентификатор - идентификатор формы, из которой выполняется вызов.
- см. ПараметрыВыполненияФункции
ИмяФункции - Строка - имя экспортной функции общего модуля, модуля менеджера объекта
или модуля обработки, которую необходимо выполнить в фоне.
Например, "МойОбщийМодуль.МояПроцедура", "Отчеты.ЗагруженныеДанные.Сформировать"
или "Обработки.ЗагрузкаДанных.МодульОбъекта.Загрузить".
Параметр1 - Произвольный - произвольные параметры вызова функции. Количество параметров может быть от 0 до 7.
Параметр2 - Произвольный
Параметр3 - Произвольный
Параметр4 - Произвольный
Параметр5 - Произвольный
Параметр6 - Произвольный
Параметр7 - Произвольный
Возвращаемое значение
Структура:
* Статус - Строка - "Выполняется", если задание еще не завершилось;
"Выполнено", если задание было успешно выполнено;
"Ошибка", если задание завершено с ошибкой;
"Отменено", если задание отменено пользователем или администратором.
* ИдентификаторЗадания - УникальныйИдентификатор - если Статус = "Выполняется", то содержит
идентификатор запущенного фонового задания.
* АдресРезультата - Строка - адрес временного хранилища, в которое будет
помещен результат работы функции.
* КраткоеПредставлениеОшибки - Строка - краткая информация об исключении, если Статус = "Ошибка".
* ПодробноеПредставлениеОшибки - Строка - подробная информация об исключении, если Статус = "Ошибка".
* Сообщения - ФиксированныйМассив - если Статус <> "Выполняется", то массив объектов СообщениеПользователю,
которые были сформированы в фоновом задании.
Пример вызова
В общем виде процесс запуска и обработки результата длительной операции в модуле формы выглядит следующим образом:
1) Функция, которая будет исполняться в фоне, располагается в модуле менеджера объекта или в серверном общем модуле:
Функция РассчитатьЗначение(Знач МойПараметр1, Знач МойПараметр2) Экспорт
...
Возврат Результат;
КонецФункции
2) Запуск операции на сервере и подключение обработчика ожидания:
&НаКлиенте
Процедура РассчитатьЗначение()
ДлительнаяОперация = НачатьВыполнениеНаСервере();
ОповещениеОЗавершении = Новый ОписаниеОповещения("ОбработатьРезультат", ЭтотОбъект);
ПараметрыОжидания = ЕХТ_ДлительныеОперацииКлиент.ПараметрыОжидания(ЭтотОбъект);
ЕХТ_ДлительныеОперацииКлиент.ОжидатьЗавершение(ДлительнаяОперация, ОповещениеОЗавершении, ПараметрыОжидания);
КонецПроцедуры
&НаСервере
Функция НачатьВыполнениеНаСервере()
ПараметрыВыполнения = ЕХТ_ДлительныеОперации.ПараметрыВыполненияФункции(УникальныйИдентификатор);
Возврат ЕХТ_ДлительныеОперации.ВыполнитьФункцию(ПараметрыВыполнения, "Обработки.МояОбработка.РассчитатьЗначение",
МойПараметр1, МойПараметр2);
КонецФункции
3) Обработка результата длительной операции:
&НаКлиенте
Процедура ОбработатьРезультат(Результат, ДополнительныеПараметры) Экспорт
Если Результат = Неопределено Тогда
Возврат;
КонецЕсли;
ВывестиРезультат(Результат.АдресРезультата);
КонецПроцедуры
Доступность
Сервер, Толстый клиент, Внешнее соединение
Проверяет состояние фонового задания по переданному идентификатору. При аварийном завершении задания вызывает исключение, возникшее в нем, либо исключение общего вида "Не удалось выполнить данную операцию. Подробности см. в Журнале регистрации".
Синтаксис
Функция ЗаданиеВыполнено(Знач ИдентификаторЗадания) Экспорт
Параметры
ИдентификаторЗадания - УникальныйИдентификатор - идентификатор фонового задания.
Возвращаемое значение
Булево - состояние выполнения задания.
Пример вызова
Результат = ЕХТ_ДлительныеОперации.ЗаданиеВыполнено(ИдентификаторЗадания)
Доступность
Сервер, Толстый клиент, Внешнее соединение
Отменяет выполнение фонового задания по переданному идентификатору. При этом если в длительной операции открывались транзакции, то будет произведен откат последней открытой транзакции. Таким образом, если длительная операция выполняет обработку (запись) данных, то для полной отмены всей операции следует выполнять запись в одной транзакции (в таком случае, будет отменена вся транзакция целиком). Если же достаточно, чтобы длительная операция была не отменена целиком, а прервана на достигнутом этапе, то, напротив, открывать одну длинную транзакцию не требуется.
Синтаксис
Процедура ОтменитьВыполнениеЗадания(Знач ИдентификаторЗадания) Экспорт
Параметры
ИдентификаторЗадания - см. ЕХТ_ДлительныеОперации.ВыполнитьВФоне.
Пример вызова
ЕХТ_ДлительныеОперации.ОтменитьВыполнениеЗадания(ИдентификаторЗадания)
Доступность
Сервер, Толстый клиент, Внешнее соединение
Возвращает новую структуру для параметра ПараметрыВыполнения функции ВыполнитьВФоне.
Синтаксис
Функция ПараметрыВыполненияВФоне(Знач ИдентификаторФормы) Экспорт
Параметры
ИдентификаторФормы - УникальныйИдентификатор - уникальный идентификатор формы,
во временное хранилище которой надо поместить результат выполнения процедуры.
Возвращаемое значение
Структура:
* ИдентификаторФормы - УникальныйИдентификатор - уникальный идентификатор формы,
во временное хранилище которой надо поместить результат выполнения процедуры.
* ДополнительныйРезультат - Булево - признак использования дополнительного временного хранилища для передачи
результата из фонового задания в родительский сеанс. По умолчанию - Ложь.
* ОжидатьЗавершение - Число
- Неопределено - таймаут в секундах ожидания завершения фонового задания.
Если задано Неопределено, то ждать до момента завершения задания.
Если задано 0, то ждать завершения задания не требуется.
По умолчанию - 2 секунды; а для низкой скорости соединения - 4.
* НаименованиеФоновогоЗадания - Строка - описание фонового задания. По умолчанию - имя процедуры.
* КлючФоновогоЗадания - Строка - уникальный ключ для активных фоновых заданий, имеющих такое же имя процедуры.
По умолчанию не задан.
* АдресРезультата - Строка - адрес временного хранилища, в которое должен быть помещен результат
работы процедуры. Если не задан, адрес формируется автоматически.
* ЗапуститьВФоне - Булево - если Истина, то задание будет всегда выполняться в фоне,
за исключением режима отладки.
В файловом варианте при наличии ранее запущенных заданий,
новое задание становится в очередь и начинает выполняться после завершения предыдущих.
* ЗапуститьНеВФоне - Булево - если Истина, задание всегда будет запускаться непосредственно,
без использования фонового задания.
* БезРасширений - Булево - если Истина, то фоновое задание будет запущено без подключения
расширений конфигурации.
Пример вызова
Результат = ЕХТ_ДлительныеОперации.ПараметрыВыполненияВФоне(ИдентификаторФормы)
Доступность
Сервер, Толстый клиент, Внешнее соединение
Конструктор коллекции ПараметрыВыполненияПроцедуры для функции ВыполнитьПроцедуру.
Синтаксис
Функция ПараметрыВыполненияПроцедуры() Экспорт
Возвращаемое значение
Структура - параметры выполнения длительной операции:
* ОжидатьЗавершение - Число - таймаут в секундах ожидания завершения фонового задания.
Если задано Неопределено, то ждать до момента завершения задания.
Если задано 0, то ждать завершения задания не требуется.
По умолчанию - 2 секунды; а для низкой скорости соединения - 4.
* НаименованиеФоновогоЗадания - Строка - описание фонового задания. По умолчанию - имя процедуры.
* КлючФоновогоЗадания - Строка - уникальный ключ для активных фоновых заданий, имеющих такое же имя процедуры.
По умолчанию не задан.
* ЗапуститьВФоне - Булево - если Истина, то задание будет всегда выполняться в фоне,
за исключением режима отладки.
В файловом варианте при наличии ранее запущенных заданий,
новое задание становится в очередь и начинает выполняться
после завершения предыдущих.
* ЗапуститьНеВФоне - Булево - если Истина, задание всегда будет запускаться непосредственно,
без использования фонового задания.
* БезРасширений - Булево - если Истина, то фоновое задание будет запущено без подключения
расширений конфигурации.
Пример вызова
Результат = ЕХТ_ДлительныеОперации.ПараметрыВыполненияПроцедуры()
Доступность
Сервер, Толстый клиент, Внешнее соединение
Конструктор коллекции ПараметрыВыполненияФункции для функции ВыполнитьФункцию.
Синтаксис
Функция ПараметрыВыполненияФункции(Знач ИдентификаторФормы) Экспорт
Параметры
ИдентификаторФормы - УникальныйИдентификатор - уникальный идентификатор формы,
во временное хранилище которой надо поместить результат выполнения процедуры.
Возвращаемое значение
Структура - параметры выполнения длительной операции:
* ИдентификаторФормы - УникальныйИдентификатор - уникальный идентификатор формы,
во временное хранилище которой надо поместить результат выполнения процедуры.
* ОжидатьЗавершение - Число - таймаут в секундах ожидания завершения фонового задания.
Если задано Неопределено, то ждать до момента завершения задания.
Если задано 0, то ждать завершения задания не требуется.
По умолчанию - 2 секунды; а для низкой скорости соединения - 4.
* НаименованиеФоновогоЗадания - Строка - описание фонового задания. По умолчанию - имя процедуры.
* КлючФоновогоЗадания - Строка - уникальный ключ для активных фоновых заданий, имеющих такое же имя процедуры.
По умолчанию не задан.
* АдресРезультата - Строка - адрес временного хранилища, в которое должен быть помещен результат
работы процедуры. Если не задан, адрес формируется автоматически.
* ЗапуститьВФоне - Булево - если Истина, то задание будет всегда выполняться в фоне,
за исключением режима отладки.
В файловом варианте при наличии ранее запущенных заданий,
новое задание становится в очередь и начинает выполняться после завершения предыдущих.
* ЗапуститьНеВФоне - Булево - если Истина, задание всегда будет запускаться непосредственно,
без использования фонового задания.
* БезРасширений - Булево - если Истина, то фоновое задание будет запущено без подключения
расширений конфигурации.
Пример вызова
Результат = ЕХТ_ДлительныеОперации.ПараметрыВыполненияФункции(ИдентификаторФормы)
Доступность
Сервер, Толстый клиент, Внешнее соединение
Считывает информацию о ходе выполнения длительной операции, записанную процедурой ЕХТ_ДлительныеОперации.СообщитьПрогресс.
Синтаксис
Функция ПрочитатьПрогресс(Знач ИдентификаторЗадания) Экспорт
Параметры
ИдентификаторЗадания - УникальныйИдентификатор - идентификатор фонового задания.
Возвращаемое значение
Неопределено, Структура - информация о ходе выполнения фонового задания, записанная процедурой СообщитьПрогресс:
* Процент - Число - необязательный. Процент выполнения.
* Текст - Строка - необязательный. Информация о текущей операции.
* ДополнительныеПараметры - Произвольный - необязательный. Любая дополнительная информация.
Пример вызова
Результат = ЕХТ_ДлительныеОперации.ПрочитатьПрогресс(ИдентификаторЗадания)
Доступность
Сервер, Толстый клиент, Внешнее соединение
Получает сообщения пользователю, отфильтровывает служебные сообщения о состоянии длительной операции.
Синтаксис
Функция СообщенияПользователю(УдалятьПолученные = Ложь, ИдентификаторЗадания = Неопределено) Экспорт
Параметры
УдалятьПолученные - Булево - признак необходимости удаления полученных сообщений.
ИдентификаторЗадания - УникальныйИдентификатор - идентификатор фонового задания, соответствующего длительной
операции, у которой требуется получить сообщения пользователю.
Если не задан, то сообщения пользователю возвращаются
из сеанса текущего пользователя.
Возвращаемое значение
ФиксированныйМассив - объекты СообщениеПользователю, которые были сформированы в фоновом задании.
Пример вызова
Операция = ЕХТ_ДлительныеОперации.ВыполнитьВФоне(...); ... Сообщения = ЕХТ_ДлительныеОперации.СообщенияПользователю(Истина, Операция.ИдентификаторЗадания);
Доступность
Сервер, Толстый клиент, Внешнее соединение
Регистрирует информацию о ходе выполнения длительной операции. Во избежание избыточного потребления памяти и ее утечек при выполнении одной длительной операции не следует сообщать прогресс более 100 раз. Для того чтобы выводить ход выполнения длительной операции для пользователя, следует установить свойство ВыводитьПрогрессВыполнения в Истина (см. ЕХТ_ДлительныеОперацииКлиент.ПараметрыОжидания). Его также можно получать отдельно при помощи функции ЕХТ_ДлительныеОперации.ПрочитатьПрогресс.
Синтаксис
Процедура СообщитьПрогресс(Знач Процент = Неопределено, Знач Текст = Неопределено, Знач ДополнительныеПараметры = Неопределено) Экспорт
Параметры
Процент - Число - процент выполнения.
Текст - Строка - информация о текущей операции.
ДополнительныеПараметры - Произвольный - любая дополнительная информация, которую необходимо передать на клиент.
Значение должно быть простым (сериализуемым в XML-строку).
Пример вызова
ЕХТ_ДлительныеОперации.СообщитьПрогресс(Процент, Текст, ДополнительныеПараметры)
Доступность
Сервер, Толстый клиент, Внешнее соединение
Ожидать завершения выполнения процедуры в фоновом задании и открыть форму ожидания длительной операции. Применяется совместно с функцией ЕХТ_ДлительныеОперации.ВыполнитьВФоне для повышения отзывчивости пользовательского интерфейса, заменяя длительный серверный вызов на запуск фонового задания.
Синтаксис
Процедура ОжидатьЗавершение(Знач ДлительнаяОперация, Знач ОповещениеОЗавершении = Неопределено, Знач ПараметрыОжидания = Неопределено) Экспорт
Параметры
ДлительнаяОперация - см. ЕХТ_ДлительныеОперации.ВыполнитьВФоне
ОповещениеОЗавершении - ОписаниеОповещения - оповещение, которое вызывается при завершении фонового задания.
Параметры процедуры-обработчика оповещения:
* Результат - Структура
- Неопределено - структура со свойствами или Неопределено, если задание было отменено:
** Статус - Строка - "Выполнено", если задание было успешно выполнено;
"Ошибка", если задание завершено с ошибкой.
** АдресРезультата - Строка - адрес временного хранилища, в которое будет
помещен (или уже помещен) результат работы процедуры.
** АдресДополнительногоРезультата - Строка - если установлен параметр ДополнительныйРезультат,
содержит адрес дополнительного временного хранилища,
в которое будет помещен (или уже помещен) результат работы процедуры.
** КраткоеПредставлениеОшибки - Строка - краткая информация об исключении, если Статус = "Ошибка".
** ПодробноеПредставлениеОшибки - Строка - подробная информация об исключении, если Статус = "Ошибка".
** Сообщения - ФиксированныйМассив
- Неопределено - массив объектов СообщениеПользователю,
сформированных в процедуре-обработчике длительной операции.
* ДополнительныеПараметры - Произвольный - произвольные данные, переданные в описании оповещения.
ПараметрыОжидания - см. ЕХТ_ДлительныеОперацииКлиент.ПараметрыОжидания
Пример вызова
ЕХТ_ДлительныеОперацииКлиент.ОжидатьЗавершение(ДлительнаяОперация, ОповещениеОЗавершении, ПараметрыОжидания)
Доступность
Тонкий клиент, Толстый клиент
Возвращает пустую структуру для параметра ПараметрыОжидания процедуры ЕХТ_ДлительныеОперацииКлиент.ОжидатьЗавершение.
Синтаксис
Функция ПараметрыОжидания(ФормаВладелец) Экспорт
Параметры
ФормаВладелец - УправляемаяФорма
- Неопределено - форма, из которой вызывается длительная операция.
Возвращаемое значение
Структура - параметры выполнения задания:
* ФормаВладелец - УправляемаяФорма
- Неопределено - форма, из которой вызывается длительная операция.
* ТекстСообщения - Строка - текст сообщения, выводимый на форме ожидания.
Если не задан, то выводится "Пожалуйста, подождите...".
* ВыводитьОкноОжидания - Булево - если Истина, то открыть окно ожидания с визуальной индикацией длительной операции.
Если используется собственный механизм индикации, то следует указать Ложь.
* ВыводитьПрогрессВыполнения - Булево - выводить прогресс выполнения в процентах на форме ожидания.
Процедура-обработчик длительной операции может сообщить о ходе своего выполнения
с помощью вызова процедуры ЕХТ_ДлительныеОперации.СообщитьПрогресс.
* ОповещениеОПрогрессеВыполнения - ОписаниеОповещения - оповещение, которое периодически вызывается при
проверке готовности фонового задания. Параметры процедуры-обработчика оповещения:
# Прогресс - Структура, Неопределено - структура со свойствами или Неопределено, если задание было отменено. Свойства:
## Статус - Строка - "Выполняется", если задание еще не завершилось;
"Выполнено", если задание было успешно выполнено;
"Ошибка", если задание завершено с ошибкой;
"Отменено", если задание отменено пользователем или администратором.
## ИдентификаторЗадания - УникальныйИдентификатор - идентификатор запущенного фонового задания.
## Прогресс - Структура, Неопределено - результат функции ЕХТ_ДлительныеОперации.ПрочитатьПрогресс,
если ВыводитьПрогрессВыполнения = Истина.
## Сообщения - ФиксированныйМассив, Неопределено - если ВыводитьСообщения = Истина, массив объектов СообщениеПользователю,
очередная порция сообщений, сформированных в процедуре-обработчике длительной операции.
# ДополнительныеПараметры - Произвольный - произвольные данные, переданные в описании оповещения.
* ВыводитьСообщения - Булево - выводить в оповещения о завершении и прогресс сообщения,
сформированные в процедуре-обработчике длительной операции.
* Интервал - Число - интервал в секундах между проверками готовности длительной операции.
По умолчанию 0 - после каждой проверки интервал увеличивается с 1 до 15 секунд
с коэффициентом 1.4.
* ОповещениеПользователя - Структура:
** Показать - Булево - если Истина, то по завершении длительной операции вывести оповещение пользователя.
** Текст - Строка - текст оповещения пользователя.
** НавигационнаяСсылка - Строка - навигационная ссылка оповещения пользователя.
** Пояснение - Строка - пояснение оповещения пользователя.
* ПолучатьРезультат - Булево - служебный параметр. Не предназначен для использования.
Пример вызова
Результат = ЕХТ_ДлительныеОперацииКлиент.ПараметрыОжидания(ФормаВладелец)
Доступность
Тонкий клиент, Толстый клиент
Возвращает строковое представление документа
Синтаксис
Функция Представление(Знач Ссылка, Знач Номер=Неопределено, Знач Дата=Неопределено) Экспорт
Параметры
Ссылка - ссылка на документ Номер - номер документа Дата - дата документа
Пример вызова
Результат = ЕХТ_Документы.Представление(Ссылка, Номер, Дата)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Проверяет статус проведения переданных документов и возвращает те из них, которые не проведены.
Синтаксис
Функция Проведены(Знач Документы) Экспорт
Параметры
Документы - Массив Из ДокументСсылка - документы, статус проведения которых необходимо проверить.
Возвращаемое значение
Массив Из ДокументСсылка - непроведенные документы.
Пример вызова
Результат = ЕХТ_Документы.Проведены(Документы)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Выполняет попытку проведения документов.
Синтаксис
Функция Провести(Знач Документы) Экспорт
Параметры
Документы - Массив из ДокументСсылка - документы, которые необходимо провести.
Возвращаемое значение
Массив из Структура: * Ссылка - ДокументСсылка - документ, который не удалось провести, * ОписаниеОшибки - Строка - текст описания ошибки при проведении.
Пример вызова
Результат = ЕХТ_Документы.Провести(Документы)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает таблицу значений с информацией об ошибках за указанный период.
Синтаксис
Функция ТаблицаОшибокЗаПериод(Знач ДатаНачала, Знач ДатаОкончания) Экспорт
Параметры
ДатаНачала - Дата - Дата начала периода, за который нужно выбрать информацию.
ДатаОкончания - Дата - Дата окончания периода, за который нужно выбрать информацию.
Возвращаемое значение
ТаблицаЗначений - Записи из журнала регистрации в соответствии с фильтром:
УровеньЖурналаРегистрации - УровеньЖурналаРегистрации.Ошибка
Начало и Окончание периода - из параметров.
Пример вызова
Результат = ЕХТ_ЖурналРегистрации.ТаблицаОшибокЗаПериод(ДатаНачала, ДатаОкончания)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Выгружает запрос в строку XML, которую можно вставить в Консоль запросов. Для переноса запроса и всех его параметров в Консоль запросов, необходимо вызвать функцию в окне. «Вычислить выражение»(Shift + F9), скопировать полученный XML в поле "Текст запроса" консоли запросов и выполнить команду "Заполнить из XML" из меню "Еще". Подробнее об использование функции смотрите в справке к консоли запросов.
Синтаксис
Функция вXML(Запрос) Экспорт
Параметры
Запрос - Запрос - Запрос, который необходимо выгрузить в формат строки XML.
Возвращаемое значение
Строка - строка в формате XML, которую можно извлечь при помощи метода "ОбщегоНазначения.ЗначениеИзСтрокиXML".
После извлечения получится объект типа "Структура" с полями:
* Текст - Строка - Текст запроса.
* Параметры - Структура - Параметры запроса.
Пример вызова
Результат = ЕХТ_Запрос.вXML(Запрос)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает фрагмент текста запроса "ОБЪЕДИНИТЬ ВСЕ".
Синтаксис
Функция ВставкаОбъединитьВсе() Экспорт
Возвращаемое значение
Строка
Пример вызова
Результат = ЕХТ_Запрос.ВставкаОбъединитьВсе()
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает фрагмент текста запроса, отделяющего один запрос от другого.
Синтаксис
Функция ВставкаРазделитель() Экспорт
Возвращаемое значение
Строка - разделитель запросов.
Пример вызова
Результат = ЕХТ_Запрос.ВставкаРазделитель()
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает строку запроса, сериализованного во внутренний формат.
Синтаксис
Функция вСтрокуВнутр(Запрос) Экспорт
Пример вызова
Результат = ЕХТ_Запрос.вСтрокуВнутр(Запрос)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Функция возвращает все поля всех временных таблиц из менеджера временных таблиц или из самого запроса. Используется для просмотра временных таблиц в отладчике. Запрос - запрос (для вычленения текста запроса) или менеджер временных таблиц (имена временных таблиц в этом случае надо передавать явно) ИменаВТ - строка с именами интересующих временных таблиц (обязательный параметр при передаче менеджера ВТ вместо запроса в первом параметре) Пример вызова функции: ЕХТ_Запрос.ВТ(Запрос, "")
Синтаксис
Функция ВТ(Знач ЗапросИлиМенеджер, Знач ИменаВТ = "") Экспорт
Пример вызова
Результат = ЕХТ_Запрос.ВТ(ЗапросИлиМенеджер, ИменаВТ)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает ТаблицуЗначений из созданного, выполненного и выгруженного запроса.
Синтаксис
Функция Выгрузить(Знач ТекстЗапроса, Знач Параметры = Неопределено, МенеджерВременныхТаблиц = Неопределено) Экспорт
Пример вызова
Результат = ЕХТ_Запрос.Выгрузить(ТекстЗапроса, Параметры, МенеджерВременныхТаблиц)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает массив структур из созданного, выполненного и выгруженного запроса.
Синтаксис
Функция ВыгрузитьВМассивСтруктур(Знач ТекстЗапроса, Знач Параметры = Неопределено, МенеджерВременныхТаблиц = Неопределено) Экспорт
Пример вызова
Результат = ЕХТ_Запрос.ВыгрузитьВМассивСтруктур(ТекстЗапроса, Параметры, МенеджерВременныхТаблиц)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Формирует пакет запросов и возвращает результат каждого запроса
Синтаксис
Функция ВыгрузитьРезультатыЗапроса(Запрос, ТекстыЗапроса, ОбходРезультата = Неопределено, ДобавитьРазделитель = Ложь, УничтожитьСозданныеВременныеТаблицы = Ложь) Экспорт
Параметры
Запрос - Запрос - запрос, параметры которого предварительно установлены.
ТекстыЗапроса - СписокЗначений - в списке перечислены тексты запросов и их имена.
ОбходРезультата - ОбходРезультатаЗапроса - вариант обхода результата запроса.
ДобавитьРазделитель - Булево - добавлять разделитель между запросами из ТекстыЗапроса
УничтожитьСозданныеВременныеТаблицы - Булево - добавить уничножение временных таблиц, создаваемых в ТекстыЗапроса
Для уничтожения таблице должно быть присвоено имя в ТекстыЗапроса
Возвращаемое значение
Структура - структура в которую помещены полученные таблицы
Пример вызова
Результат = ЕХТ_Запрос.ВыгрузитьРезультатыЗапроса(Запрос, ТекстыЗапроса, ОбходРезультата, ДобавитьРазделитель, УничтожитьСозданныеВременныеТаблицы)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Добавляет в запрос отбор из текста.
Синтаксис
Процедура ДобавитьОтбор(Запрос, Знач ТекстОтбора) Экспорт
Пример вызова
ЕХТ_Запрос.ДобавитьОтбор(Запрос, ТекстОтбора)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает восстановленный объект Запрос из строки XML.
Синтаксис
Функция ИзXML(СтрокаXML) Экспорт
Пример вызова
Результат = ЕХТ_Запрос.ИзXML(СтрокаXML)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает восстановленный объект Запрос из строки внутреннего формата.
Синтаксис
Функция ИзСтрокиВнутр(Знач СтрокаВнутр) Экспорт
Пример вызова
Результат = ЕХТ_Запрос.ИзСтрокиВнутр(СтрокаВнутр)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает список псевдонимов колонок запроса.
Синтаксис
Функция КолонкиЗапроса(Знач Запрос) Экспорт
Пример вызова
Результат = ЕХТ_Запрос.КолонкиЗапроса(Запрос)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Подготавливает строку для использования в качестве шаблона поиска в запросе. Экранирует служебные символы, если они есть в строке.
Синтаксис
Функция ПодготовитьСтрокуПоиска(Знач ИсходнаяСтрокаПоиска) Экспорт
Параметры
СтрокаПоиска - Строка - произвольная строка.
Возвращаемое значение
Строка - строка подготовленная для поиска данных в запросе.
Пример вызова
Результат = ЕХТ_Запрос.ПодготовитьСтрокуПоиска(ИсходнаяСтрокаПоиска)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает Истина, если в созданном и выполненном запросе нет ни одной записи.
Синтаксис
Функция Пустой(Знач ТекстЗапроса, Знач Параметры = Неопределено, МенеджерВременныхТаблиц = Неопределено) Экспорт
Пример вызова
Результат = ЕХТ_Запрос.Пустой(ТекстЗапроса, Параметры, МенеджерВременныхТаблиц)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает объект Запрос, созданный на основе переданных параметров.
Синтаксис
Функция Создать(Знач ТекстЗапроса, Знач Параметры = Неопределено, МенеджерВременныхТаблиц = Неопределено) Экспорт
Пример вызова
Результат = ЕХТ_Запрос.Создать(ТекстЗапроса, Параметры, МенеджерВременныхТаблиц)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает РезультатЗапроса из созданного и выполненного запроса.
Синтаксис
Функция СоздатьВыполнить(Знач ТекстЗапроса, Знач Параметры = Неопределено, МенеджерВременныхТаблиц = Неопределено) Экспорт
Пример вызова
Результат = ЕХТ_Запрос.СоздатьВыполнить(ТекстЗапроса, Параметры, МенеджерВременныхТаблиц)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Кодирует значение по алгоритму base64.
Синтаксис
Функция вBase64(Знач Значение) Экспорт
Параметры
Значение - исходное значение, которое необходимо закодировать.
Возвращаемое значение
Строка - закодированное значение.
Пример вызова
Результат = ЕХТ_Значение.вBase64(Значение)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Преобразует (сериализует) любое значение в XML-строку. Преобразованы в могут быть только те объекты, для которых в синтакс-помощнике указано, что они сериализуются. См. также ЗначениеИзСтрокиXML.
Синтаксис
Функция вXML(Знач Значение, Знач _НазначениеТипаXML=Неопределено) Экспорт
Параметры
Значение - Произвольный - значение, которое необходимо сериализовать в XML-строку.
Возвращаемое значение
Строка - XML-строка.
Пример вызова
Результат = ЕХТ_Значение.вXML(Значение, _НазначениеТипаXML)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает преобразованное в Булево значение.
Синтаксис
Функция вБулево(Знач Значение) Экспорт
Пример вызова
Результат = ЕХТ_Значение.вБулево(Значение)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает сериализованный объект в виде двоичных данных.
Синтаксис
Функция вДвоичныеДанные(Знач Объект, Знач _НазначениеТипаXML=Неопределено) Экспорт
Параметры
Объект - Любой сериализуемый в XML объект.
Возвращаемое значение
ДвоичныеДанные - сериализованный объект.
Пример вызова
Результат = ЕХТ_Значение.вДвоичныеДанные(Объект, _НазначениеТипаXML)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Преобразует (сериализует) любое значение в XML-строку. Преобразованы в могут быть только те объекты, для которых в синтакс-помощнике указано, что они сериализуются. См. также ЗначениеИзСтрокиXML.
Синтаксис
Функция вСтрокуXML(Знач Значение, Знач _НазначениеТипаXML=Неопределено) Экспорт
Параметры
Значение - Произвольный - значение, которое необходимо сериализовать в XML-строку.
Возвращаемое значение
Строка - XML-строка.
Пример вызова
Результат = ЕХТ_Значение.вСтрокуXML(Значение, _НазначениеТипаXML)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает системное представление значения в строковом виде
Синтаксис
Функция вСтрокуВнутр(Знач Значение) Экспорт
Пример вызова
Результат = ЕХТ_Значение.вСтрокуВнутр(Значение)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Создает массив и копирует в него значения, содержащиеся в колонке объекта, для которого доступен обход посредством оператора Для каждого … Из.
Синтаксис
Функция ВыгрузитьКолонку(КоллекцияСтрок, ИмяКолонки, ТолькоУникальныеЗначения=Ложь) Экспорт
Параметры
КоллекцияСтрок - ТаблицаЗначений,
ДеревоЗначений,
СписокЗначений,
ТабличнаяЧасть,
Соответствие,
Структура - коллекция, колонку которой нужно выгрузить в массив.
А так же другие объекты, для которых доступен обход
посредством оператора Для каждого … Из … Цикл.
ИмяКолонки - Строка - имя поля коллекции, значения которого нужно выгрузить.
ТолькоУникальныеЗначения - Булево - необязательный, если истина, то в массив будут включены
только различающиеся значения.
Возвращаемое значение
Массив - значения колонки.
Пример вызова
Результат = ЕХТ_Значение.ВыгрузитьКолонку(КоллекцияСтрок, ИмяКолонки, ТолькоУникальныеЗначения)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Декодирует base64-представление значения в исходное значение.
Синтаксис
Функция ИзBase64(Знач СтрокаBase64) Экспорт
Параметры
СтрокаBase64 - Строка - исходная строка, которую необходимо декодировать.
Возвращаемое значение
Значение - декодированное значение
Пример вызова
Результат = ЕХТ_Значение.ИзBase64(СтрокаBase64)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Выполняет преобразование (десериализацию) XML-строки в значение. См. также ВСтрокуXML.
Синтаксис
Функция ИзXML(Знач СтрокаXML) Экспорт
Параметры
СтрокаXML - Строка - XML-строка, с сериализованным объектом..
Возвращаемое значение
Произвольный - значение, полученное из переданной XML-строки.
Пример вызова
Результат = ЕХТ_Значение.ИзXML(СтрокаXML)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Десериализует объект из двоичных данных
Синтаксис
Функция ИзДвоичныхДанных(Знач ДвоичныеДанныеОбъекта) Экспорт
Параметры
ДанныеОбъекта - двоичные данные, представляющие собой объект, сериализованный, например, при помощи СериализоватьОбъектВДвоичныеДанные.
Пример вызова
Результат = ЕХТ_Значение.ИзДвоичныхДанных(ДвоичныеДанныеОбъекта)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Выполняет преобразование (десериализацию) XML-строки в значение. См. также ВСтрокуXML.
Синтаксис
Функция ИзСтрокиXML(Знач СтрокаXML) Экспорт
Параметры
СтрокаXML - Строка - XML-строка, с сериализованным объектом..
Возвращаемое значение
Произвольный - значение, полученное из переданной XML-строки.
Пример вызова
Результат = ЕХТ_Значение.ИзСтрокиXML(СтрокаXML)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает значение из системного представления значения в строковом виде
Синтаксис
Функция ИзСтрокиВнутр(Знач СтрокаВнутр) Экспорт
Пример вызова
Результат = ЕХТ_Значение.ИзСтрокиВнутр(СтрокаВнутр)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Вычисляет контрольную сумму для произвольных данных по указанному алгоритму.
Синтаксис
Функция КонтрольнаяСумма(Знач Данные, Знач ПараметрХешФункция=Неопределено) Экспорт
Параметры
Данные - Произвольный - любое сериализуемое значение. Алгоритм - ХешФункция - алгоритм расчета контрольной суммы. По умолчанию, MD5.
Возвращаемое значение
Строка - контрольная сумма строкой без пробелов, 32 байта.
Пример вызова
Результат = ЕХТ_Значение.КонтрольнаяСумма(Данные, ПараметрХешФункция)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Устанавливает и/или возвращает любое значение из кэша по указанному ключу. Сохраненное значение пропадает без обращений более 20 минут или после вызова ОбновитьПовторноИспользуемыеЗначения().
Синтаксис
Функция ПовтИсп(Знач Ключ, Знач НовоеЗначение = NULL) Экспорт
Пример вызова
Результат = ЕХТ_Значение.ПовтИсп(Ключ, НовоеЗначение)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает строковое представление типа.
Синтаксис
Функция ПредставлениеТипа(Знач Значение, Знач ДлинаПредставления = 150) Экспорт
Параметры
Значение - Любое Значение - значение, для которого нужно получить представление типа. ДлинаПредставления - Число - максимальная длина строки представления.
Пример вызова
Результат = ЕХТ_Значение.ПредставлениеТипа(Значение, ДлинаПредставления)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает пустой УникальныйИдентфикатор.
Синтаксис
Функция ПустойУникальныйИдентификатор() Экспорт
Возвращаемое значение
УникальныйИдентификатор - уникальный идентификатор.
Пример вызова
Результат = ЕХТ_Значение.ПустойУникальныйИдентификатор()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Создает полную копию структуры, соответствия, массива, списка или таблицы значений, рекурсивно, с учетом типов дочерних элементов. При этом содержимое значений объектных типов (СправочникОбъект, ДокументОбъект и т.п.) не копируются, а возвращаются ссылки на исходный объект.
Синтаксис
Функция Скопировать(Знач Источник) Экспорт
Параметры
Источник - Структура, Соответствие, Массив, СписокЗначений, ТаблицаЗначений - объект, который необходимо
скопировать.
Возвращаемое значение
Структура, Соответствие, Массив, СписокЗначений, ТаблицаЗначений - копия объекта, переданного в параметре Источник.
Пример вызова
Результат = ЕХТ_Значение.Скопировать(Источник)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает Истина если значения равны.
Синтаксис
Функция Сравнить(Знач Значение1, Знач Значение2) Экспорт
Пример вызова
Результат = ЕХТ_Значение.Сравнить(Значение1, Значение2)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает тип строкой, н-р "Строка", "Справочник" и т.п.
Синтаксис
Функция ТипСтр(Знач Значение) Экспорт
Пример вызова
Результат = ЕХТ_Значение.ТипСтр(Значение)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает фиксированную коллекцию с фиксированными значениями.
Синтаксис
Функция Фиксировать(Знач Значение) Экспорт
Параметры
Значение - -
Возвращаемое значение
- Коллекция с неизменяемыми значениями.
Пример вызова
Результат = ЕХТ_Значение.Фиксировать(Значение)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Проверяет соответствие ИНН требованиям.
Синтаксис
Функция ЭтоИНН(Знач ИНН, ЭтоЮридическоеЛицо = Неопределено, ТекстОшибки = "") Экспорт
Параметры
ИНН - Строка - проверяемый индивидуальный номер налогоплательщика. ЭтоЮридическоеЛицо - Булево - признак, является ли владелец ИНН юридическим лицом. ТекстОшибки - Строка - текст сообщения о найденных ошибках.
Возвращаемое значение
Булево - Истина, если соответствует.
Пример вызова
Результат = ЕХТ_Значение.ЭтоИНН(ИНН, ЭтоЮридическоеЛицо, ТекстОшибки)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Проверяет соответствие КПП требованиям. Согласно приложению к приказу ФНС России от 29.06.2012 N ММВ-7-6/435@ "Об утверждении Порядка и условий присвоения, применения, а также изменения идентификационного номера налогоплательщика".
Синтаксис
Функция ЭтоКПП(Знач КПП, ТекстСообщения = "") Экспорт
Параметры
КПП - Строка - проверяемый код причины постановки на учет. ТекстСообщения - Строка - текст сообщения о найденных ошибках.
Возвращаемое значение
Булево - Истина, если соответствует.
Пример вызова
Результат = ЕХТ_Значение.ЭтоКПП(КПП, ТекстСообщения)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Проверяет соответствие ОГРН требованиям.
Синтаксис
Функция ЭтоОГРН(Знач ОГРН, ЭтоЮридическоеЛицо = Неопределено, ТекстСообщения = "") Экспорт
Параметры
ОГРН - Строка - проверяемый основной государственный регистрационный номер. ЭтоЮридическоеЛицо - Булево - признак, является ли владелец ОГРН юридическим лицом. ТекстСообщения - Строка - текст сообщения о найденных ошибках.
Возвращаемое значение
Булево - Истина, если соответствует.
Пример вызова
Результат = ЕХТ_Значение.ЭтоОГРН(ОГРН, ЭтоЮридическоеЛицо, ТекстСообщения)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Проверяет соответствие кода ОКПО требованиям стандартов.
Синтаксис
Функция ЭтоОКПО(Знач ПроверяемыйКод, ЭтоЮридическоеЛицо = Неопределено, ТекстСообщения = "") Экспорт
Параметры
ПроверяемыйКод - Строка - проверяемый код ОКПО; ЭтоЮридическоеЛицо - Булево - признак, является ли владелец кода ОКПО юридическим лицом; ТекстСообщения - Строка - текст сообщения о найденных ошибках в проверяемом коде ОКПО.
Возвращаемое значение
Булево - Истина, если соответствует.
Пример вызова
Результат = ЕХТ_Значение.ЭтоОКПО(ПроверяемыйКод, ЭтоЮридическоеЛицо, ТекстСообщения)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Проверяет возможность сериализации значения. Источник: https://infostart.ru/1c/articles/464212/
Синтаксис
Функция ЭтоСериализуемое(Знач Значение, Знач Получатель = "ХранилищеЗначения", МассивПутей = Неопределено) Экспорт
Параметры
Значение - Значение, для которого требуется найти несериализуемые объекты
Получатель - Получатель сериализованного значения. Может принимать значения:
"ХранилищеЗначения" - используется конструктор объекта ХранилищеЗначения
"ВременноеХранилище" - используется метод ПоместитьВоВременноеХранилище.
Возвращаемое значение
Булево - Истина, если значение может быть сериализовано, Ложь, если нет. В параметре МассивПутей возвращается массив путей до несериализуемых объектов.
Пример вызова
Результат = ЕХТ_Значение.ЭтоСериализуемое(Значение, Получатель, МассивПутей)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Проверяет номер страхового свидетельства на соответствие требованиям ПФР.
Синтаксис
Функция ЭтоСтраховойНомерПФР(Знач СтраховойНомер, ТекстСообщения = "") Экспорт
Параметры
СтраховойНомер - Строка - страховой номер ПФР. Строка должна быть ведена по шаблону "999-999-999 99". ТекстСообщения - Строка - текст сообщения об ошибке ввода страхового номера.
Возвращаемое значение
Булево - Истина, если соответствует.
Пример вызова
Результат = ЕХТ_Значение.ЭтоСтраховойНомерПФР(СтраховойНомер, ТекстСообщения)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает Истина если параметр соответствует требованиям к уникальному идентификатору
Синтаксис
Функция ЭтоУникальныйИдентификатор(Знач Идентификатор) Экспорт
Пример вызова
Результат = ЕХТ_Значение.ЭтоУникальныйИдентификатор(Идентификатор)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Преобразует (сериализует) любое значение в XML-строку. Преобразованы в могут быть только те объекты, для которых в синтакс-помощнике указано, что они сериализуются. См. также ЗначениеИзСтрокиXML.
Синтаксис
Функция вXML(Знач Значение, Знач _НазначениеТипаXML=Неопределено) Экспорт
Параметры
Значение - Произвольный - значение, которое необходимо сериализовать в XML-строку.
Возвращаемое значение
Строка - XML-строка.
Пример вызова
Результат = ЕХТ_ЗначениеСервер.вXML(Значение, _НазначениеТипаXML)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает сериализованный объект в виде двоичных данных.
Синтаксис
Функция вДвоичныеДанные(Знач Объект, Знач _НазначениеТипаXML=Неопределено) Экспорт
Параметры
Объект - Любой сериализуемый в XML объект.
Возвращаемое значение
ДвоичныеДанные - сериализованный объект.
Пример вызова
Результат = ЕХТ_ЗначениеСервер.вДвоичныеДанные(Объект, _НазначениеТипаXML)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Преобразует (сериализует) любое значение в XML-строку. Преобразованы в могут быть только те объекты, для которых в синтакс-помощнике указано, что они сериализуются. См. также ЗначениеИзСтрокиXML.
Синтаксис
Функция вСтрокуXML(Знач Значение, Знач _НазначениеТипаXML=Неопределено) Экспорт
Параметры
Значение - Произвольный - значение, которое необходимо сериализовать в XML-строку.
Возвращаемое значение
Строка - XML-строка.
Пример вызова
Результат = ЕХТ_ЗначениеСервер.вСтрокуXML(Значение, _НазначениеТипаXML)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Выполняет преобразование (десериализацию) XML-строки в значение. См. также ЗначениеВСтрокуXML.
Синтаксис
Функция ИзXML(Знач СтрокаXML) Экспорт
Параметры
СтрокаXML - Строка - XML-строка, с сериализованным объектом..
Возвращаемое значение
Произвольный - значение, полученное из переданной XML-строки.
Пример вызова
Результат = ЕХТ_ЗначениеСервер.ИзXML(СтрокаXML)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Десериализует объект из двоичных данных
Синтаксис
Функция ИзДвоичныхДанных(Знач ДвоичныеДанныеОбъекта) Экспорт
Параметры
ДанныеОбъекта - двоичные данные, представляющие собой объект, сериализованный, например, при помощи СериализоватьОбъектВДвоичныеДанные.
Пример вызова
Результат = ЕХТ_ЗначениеСервер.ИзДвоичныхДанных(ДвоичныеДанныеОбъекта)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Выполняет преобразование (десериализацию) XML-строки в значение. См. также ЗначениеВСтрокуXML.
Синтаксис
Функция ИзСтрокиXML(Знач СтрокаXML) Экспорт
Параметры
СтрокаXML - Строка - XML-строка, с сериализованным объектом..
Возвращаемое значение
Произвольный - значение, полученное из переданной XML-строки.
Пример вызова
Результат = ЕХТ_ЗначениеСервер.ИзСтрокиXML(СтрокаXML)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Вычисляет контрольную сумму для произвольных данных по указанному алгоритму.
Синтаксис
Функция КонтрольнаяСумма(Знач Данные, Знач ПараметрХешФункция=Неопределено) Экспорт
Параметры
Данные - Произвольный - любое сериализуемое значение. Алгоритм - ХешФункция - алгоритм расчета контрольной суммы. По умолчанию, MD5.
Возвращаемое значение
Строка - контрольная сумма строкой без пробелов, 32 байта.
Пример вызова
Результат = ЕХТ_ЗначениеСервер.КонтрольнаяСумма(Данные, ПараметрХешФункция)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает признак возможности обращения к разделенным данным (которые входят в состав разделителей). Признак относится к сеансу, но может меняться во время работы сеанса, если разделение было включено в самом сеансе, поэтому проверку следует делать непосредственно перед обращением к разделенным данным. Возвращает Истина, если конфигурация не может работать в режиме разделения данных (не содержит общих реквизитов, предназначенных для разделения данных).
Синтаксис
Функция ДоступноИспользованиеРазделенныхДанных() Экспорт
Возвращаемое значение
Булево - Истина, если разделение не поддерживается, либо разделение выключено,
либо разделение включено и разделители установлены.
- Ложь, если разделение включено и разделители не установлены.
Пример вызова
Результат = ЕХТ_ИБ.ДоступноИспользованиеРазделенныхДанных()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает ИдентификаторИнформационнойБазы.
Синтаксис
Функция ИдентификаторИнформационнойБазы(Знач Заменить = Ложь) Экспорт
Пример вызова
Результат = ЕХТ_ИБ.ИдентификаторИнформационнойБазы(Заменить)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает флаг использования разделителя ОбластьДанных для текущего сеанса.
Синтаксис
Функция ИспользованиеРазделителяСеанса() Экспорт
Возвращаемое значение
Булево - если Истина, разделение используется, иначе нет.
Пример вызова
Результат = ЕХТ_ИБ.ИспользованиеРазделителяСеанса()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает каталог ИБ из строки соединения файловой базы
Синтаксис
Функция Каталог(Знач СтрокаСоединения = "") Экспорт
Пример вызова
Результат = ЕХТ_ИБ.Каталог(СтрокаСоединения)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает количество пользователей ИБ.
Синтаксис
Функция КоличествоПользователей() Экспорт
Пример вызова
Результат = ЕХТ_ИБ.КоличествоПользователей()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Заглушка для БСП. Всегда возвращает Ложь
Синтаксис
Функция НеобходимоОбновление() Экспорт
Пример вызова
Результат = ЕХТ_ИБ.НеобходимоОбновление()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает Истина, если удалось подключиться через V83.COMConnector.
Синтаксис
Функция Подключить(Знач Каталог, Знач ИмяПользователя = "", Знач Пароль = "", Соединение = Неопределено) Экспорт
Пример вызова
Результат = ЕХТ_ИБ.Подключить(Каталог, ИмяПользователя, Пароль, Соединение)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает признак включения условного разделения. В случае вызова в неразделенной конфигурации возвращает Ложь.
Синтаксис
Функция РазделениеВключено() Экспорт
Пример вызова
Результат = ЕХТ_ИБ.РазделениеВключено()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Создает пустую ИБ.
Синтаксис
Функция Создать(Знач КаталогИБ, Знач ДополнительныеПараметры = Неопределено) Экспорт
Пример вызова
Результат = ЕХТ_ИБ.Создать(КаталогИБ, ДополнительныеПараметры)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает строку соединения для выбранного каталога.
Синтаксис
Функция СтрокаСоединенияДляКаталога(Знач Каталог) Экспорт
Пример вызова
Результат = ЕХТ_ИБ.СтрокаСоединенияДляКаталога(Каталог)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает структуру строки соединения.
Синтаксис
Функция СтруктураСоединения(СтрокаСоединения = "") Экспорт
Пример вызова
Результат = ЕХТ_ИБ.СтруктураСоединения(СтрокаСоединения)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает Истина, если установлен Привилегированный Режим.
Синтаксис
Функция УстановленПривилегированныйРежим() Экспорт
Пример вызова
Результат = ЕХТ_ИБ.УстановленПривилегированныйРежим()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает признак ЭтоКопия.
Синтаксис
Функция ЭтоКопия() Экспорт
Пример вызова
Результат = ЕХТ_ИБ.ЭтоКопия()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Функция - Это файловая
Синтаксис
Функция ЭтоФайловая(Знач СтрокаСоединения = "", КаталогИБ = Неопределено) Экспорт
Параметры
СтрокаСоединения - Строка - Строка соединения проверяемой ИБ КаталогИБ - Строка - Возвращаемое значение для файловой ИБ
Возвращаемое значение
- Булево
Пример вызова
Результат = ЕХТ_ИБ.ЭтоФайловая(СтрокаСоединения, КаталогИБ)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Запускает диагностику сетевого ресурса. В модели сервиса возвращается только описание ошибки.
Синтаксис
Функция ДиагностикаСоединения(URL) Экспорт
Параметры
URL - Строка - адрес URL ресурса, диагностику которого надо выполнить.
Возвращаемое значение
Структура - Результат диагностики:
* ОписаниеОшибки - Строка - краткое описание ошибки.
* ЖурналДиагностики - Строка - подробный журнал диагностики с техническими подробностями.
Пример вызова
// Диагностика веб-сервиса адресного классификатора.
Результат = ОбщегоНазначенияКлиентСервер.ДиагностикаСоединения("https://api.orgaddress.1c.ru/orgaddress/v1?wsdl");
ОписаниеОшибки = Результат.ОписаниеОшибки;
ЖурналДиагностики = Результат.ЖурналДиагностики;
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает настройку прокси сервера для доступа в Интернет со стороны клиента для текущего пользователя.
Синтаксис
Функция НастройкиПроксиНаКлиенте() Экспорт
Возвращаемое значение
Соответствие - свойства: ИспользоватьПрокси - использовать ли прокси-сервер. НеИспользоватьПроксиДляЛокальныхАдресов - использовать ли прокси-сервер для локальных адресов. ИспользоватьСистемныеНастройки - использовать ли системные настройки прокси-сервера. Сервер - адрес прокси-сервера. Порт - порт прокси-сервера. Пользователь - имя пользователя для авторизации на прокси-сервере. Пароль - пароль пользователя.
Пример вызова
Результат = ЕХТ_Интернет.НастройкиПроксиНаКлиенте()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает параметры настройки прокси-сервера на стороне сервера 1С:Предприятие.
Синтаксис
Функция НастройкиПроксиНаСервере() Экспорт
Возвращаемое значение
Соответствие - свойства: ИспользоватьПрокси - использовать ли прокси-сервер. НеИспользоватьПроксиДляЛокальныхАдресов - использовать ли прокси-сервер для локальных адресов. ИспользоватьСистемныеНастройки - использовать ли системные настройки прокси-сервера. Сервер - адрес прокси-сервера. Порт - порт прокси-сервера. Пользователь - имя пользователя для авторизации на прокси-сервере. Пароль - пароль пользователя.
Пример вызова
Результат = ЕХТ_Интернет.НастройкиПроксиНаСервере()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Создает объект описания защищенного соединения OpenSSL.
Синтаксис
Функция НовоеЗащищенноеСоединение(СертификатКлиента = Неопределено, СертификатыУдостоверяющихЦентров = Неопределено) Экспорт
Параметры
СертификатКлиента - СертификатКлиентаФайл,
СертификатКлиентаWindows,
Неопределено - см ЗащищенноеСоединениеOpenSSL.
СертификатыУдостоверяющихЦентров - СертификатыУдостоверяющихЦентровФайл,
СертификатыУдостоверяющихЦентровWindows,
СертификатыУдостоверяющихЦентровLinux,
СертификатыУдостоверяющихЦентровОС,
Неопределено - см. ЗащищенноеСоединениеOpenSSL.
Возвращаемое значение
ЗащищенноеСоединениеOpenSSL - описание защищенного соединения.
Пример вызова
Результат = ЕХТ_Интернет.НовоеЗащищенноеСоединение(СертификатКлиента, СертификатыУдостоверяющихЦентров)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает прокси по настройкам НастройкаПроксиСервера для заданного протокола Протокол.
Синтаксис
Функция НовыйИнтернетПрокси(НастройкаПроксиСервера, Протокол) Экспорт
Параметры
НастройкаПроксиСервера - Соответствие:
ИспользоватьПрокси - использовать ли прокси-сервер.
НеИспользоватьПроксиДляЛокальныхАдресов - использовать ли прокси-сервер для локальных адресов.
ИспользоватьСистемныеНастройки - использовать ли системные настройки прокси-сервера.
Сервер - адрес прокси-сервера.
Порт - порт прокси-сервера.
Пользователь - имя пользователя для авторизации на прокси-сервере.
Пароль - пароль пользователя.
ИспользоватьАутентификациюОС - Булево - признак использования аутентификации средствами операционной системы.
Протокол - строка - протокол для которого устанавливаются параметры прокси сервера, например "http", "https",
"ftp".
Возвращаемое значение
ИнтернетПрокси
Пример вызова
Результат = ЕХТ_Интернет.НовыйИнтернетПрокси(НастройкаПроксиСервера, Протокол)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает структуру параметров для получения файла из Интернета.
Синтаксис
Функция ПараметрыПолученияФайла() Экспорт
Возвращаемое значение
Структура - со свойствами:
* ПутьДляСохранения - Строка - путь на сервере (включая имя файла), для сохранения скачанного файла.
Не заполняется при сохранении файла во временное хранилище.
* Пользователь - Строка - пользователь от имени которого установлено соединение.
* Пароль - Строка - пароль пользователя от которого установлено соединение.
* Порт - Число - порт сервера с которым установлено соединение.
* Таймаут - Число - таймаут на получение файла, в секундах.
* ЗащищенноеСоединение - Булево - признак использования защищенного соединения ftps или https.
- ЗащищенноеСоединение - см. в синтакс-помощнике описание свойства ЗащищенноеСоединение
объектов FTPСоединение и HTTPСоединение.
- Неопределено - в случае, если защищенное соединение не используется.
Параметры только для http (https) соединения:
* Заголовки - Соответствие - см. в синтакс-помощнике описание параметра Заголовки объекта HTTPЗапрос.
* ИспользоватьАутентификациюОС - Булево - см. в синтакс-помощнике описание параметра
ИспользоватьАутентификациюОС объекта HTTPСоединение.
Параметры только для ftp (ftps) соединения:
* ПассивноеСоединение - Булево - флаг указывает, что соединение должно пассивным (или активным).
* УровеньИспользованияЗащищенногоСоединения - УровеньИспользованияЗащищенногоСоединенияFTP - См. описание
одноименного свойства в синтакс-помощнике платформы. Значение по умолчанию - Авто.
Пример вызова
Результат = ЕХТ_Интернет.ПараметрыПолученияФайла()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает объект ИнтернетПрокси для доступа в Интернет. Допустимые протоколы для создания ИнтернетПрокси http, https, ftp и ftps.
Синтаксис
Функция ПолучитьПрокси(Знач URLИлиПротокол) Экспорт
Параметры
URLИлиПротокол - Строка - url в формате [Протокол://]<Сервер>/<Путь к файлу на сервере>,
либо идентификатор протокола (http, ftp, ...).
Возвращаемое значение
ИнтернетПрокси - Описывает параметры прокси-серверов для различных протоколов.
Если не удалось распознать схему сетевой протокол,
то будет создать прокси на основании протокола HTTP.
Пример вызова
Результат = ЕХТ_Интернет.ПолучитьПрокси(URLИлиПротокол)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Функция для получения файла из сети Интернет.
Синтаксис
Функция СкачатьФайл(Знач URL, Знач ПараметрыПолучения, Знач НастройкаСохранения, Знач ЗаписыватьОшибку=Истина) Экспорт
Параметры
URL - строка - url файла в формате:
НастройкиПолучения - Структура со свойствами.
* ПутьДляСохранения - Строка - путь на сервере (включая имя файла), для сохранения скачанного файла.
* Пользователь - Строка - пользователь от имени которого установлено соединение.
* Пароль - Строка - пароль пользователя от которого установлено соединение.
* Порт - Число - порт сервера с которым установлено соединение.
* Таймаут - Число - таймаут на получение файла, в секундах.
* ЗащищенноеСоединение - Булево - для случая http загрузки флаг указывает,
что соединение должно производиться через https.
* ПассивноеСоединение - Булево - для случая ftp загрузки флаг указывает,
что соединение должно пассивным (или активным).
* Заголовки - Соответствие - см. описание параметра Заголовки объекта HTTPЗапрос.
* ИспользоватьАутентификациюОС - Булево - см. описание параметра ИспользоватьАутентификациюОС объекта HTTPСоединение.
НастройкаСохранения - соответствие - содержит параметры для сохранения скачанного файла
ключи:
МестоХранения - строка - может содержать
"Сервер" - сервер,
"ВременноеХранилище" - временное хранилище.
Путь - строка (необязательный параметр) -
путь к каталогу на клиенте либо на сервере либо адрес во временном хранилище
если не задано будет сгенерировано автоматически.
Возвращаемое значение
структура
успех - булево - успех или неудача операции
строка - строка - в случае успеха либо строка-путь сохранения файла
либо адрес во временном хранилище
в случае неуспеха сообщение об ошибке.
Пример вызова
Результат = ЕХТ_Интернет.СкачатьФайл(URL, ПараметрыПолучения, НастройкаСохранения, ЗаписыватьОшибку)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Служебная информация для отображения текущих настроек и состояний прокси для выполнения диагностики.
Синтаксис
Функция СостояниеНастроекПрокси() Экспорт
Возвращаемое значение
Структура - со свойствами:
* СоединениеЧерезПрокси - Булево - Признак того, что соединение должно выполняться через прокси.
* Представление - Строка - Представление текущего настроенного прокси.
Пример вызова
Результат = ЕХТ_Интернет.СостояниеНастроекПрокси()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Разбирает строку URI на составные части и возвращает в виде структуры. На основе RFC 3986.
Синтаксис
Функция СтруктураURI(Знач СтрокаURI) Экспорт
Параметры
СтрокаURI - Строка - ссылка на ресурс в формате:
<схема>://<логин>:<пароль>@<хост>:<порт>/<путь>?<параметры>#<якорь>.
Возвращаемое значение
Структура - составные части URI согласно формату: * Схема - Строка - схема из URI. * Логин - Строка - логин из URI. * Пароль - Строка - пароль из URI. * ИмяСервера - Строка - часть <хост>:<порт> из URI. * Хост - Строка - хост из URI. * Порт - Строка - порт из URI. * ПутьНаСервере - Строка - часть <путь>?<параметры>#<якорь> из URI.
Пример вызова
Результат = ЕХТ_Интернет.СтруктураURI(СтрокаURI)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Разделяет URL по составным частям: протокол, сервер, путь к ресурсу.
Синтаксис
Функция СтруктураURL(Знач URL) Экспорт
Параметры
URL - Строка - ссылка на ресурс в сети Интернет.
Возвращаемое значение
Структура - Структура с полями:
* Протокол - Строка - протокол доступа к ресурсу.
* ИмяСервера - Строка - сервер, на котором располагается ресурс.
* ПутьКФайлуНаСервере - Строка - путь к ресурсу на сервере.
Пример вызова
Результат = ЕХТ_Интернет.СтруктураURL(URL)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Проверяет действительность IP адреса и нормализует его, убирая лидирующие нули
Синтаксис
Функция ЭтоIP(Адрес) Экспорт
Пример вызова
Результат = ЕХТ_Интернет.ЭтоIP(Адрес)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает картинку для типа значения.
Синтаксис
Функция Значения(Знач Значение) Экспорт
Пример вызова
Результат = ЕХТ_Картинка.Значения(Значение)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает картинку по имени.
Синтаксис
Функция ИзБиблиотеки(Знач ИмяКартинки, Знач КартинкаПоУмолчанию = Неопределено) Экспорт
Параметры
ИмяКартинки - Строка - Имя картинки, заданное в Библиотеке картинок. КартинкаПоУмолчанию - Картинка - Возвращается если картинка по имени не найдена.
Возвращаемое значение
Картинка - найденная картинка.
Пример вызова
Результат = ЕХТ_Картинка.ИзБиблиотеки(ИмяКартинки, КартинкаПоУмолчанию)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает массив с расширениями файлов-картинок.
Синтаксис
Функция СписокРасширенийФайлов() Экспорт
Пример вызова
Результат = ЕХТ_Картинка.СписокРасширенийФайлов()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает картинку для типа.
Синтаксис
Функция Типа(Знач Тип) Экспорт
Пример вызова
Результат = ЕХТ_Картинка.Типа(Тип)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает фильтр, используемый в диалоге выбора файлов.
Синтаксис
Функция ФильтрФайлов() Экспорт
Возвращаемое значение
Строка - строка, содержащая фильтр для файлов-изображений
Пример вызова
Результат = ЕХТ_Картинка.ФильтрФайлов()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Выгружает внешний отчет в файлы.
Синтаксис
Функция ВыгрузитьВнешнийОтчетВФайлы(Знач ИмяФайла, Знач ИмяКаталогаВыгрузки = Неопределено, Знач ПараметрыЗапуска = Неопределено) Экспорт
Пример вызова
Результат = ЕХТ_Конфигуратор.ВыгрузитьВнешнийОтчетВФайлы(ИмяФайла, ИмяКаталогаВыгрузки, ПараметрыЗапуска)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Выгружает внешнюю обработку в файлы.
Синтаксис
Функция ВыгрузитьВнешнююОбработкуВФайлы(Знач ИмяФайла, Знач ИмяКаталогаВыгрузки = Неопределено, Знач ПараметрыЗапуска = Неопределено) Экспорт
Пример вызова
Результат = ЕХТ_Конфигуратор.ВыгрузитьВнешнююОбработкуВФайлы(ИмяФайла, ИмяКаталогаВыгрузки, ПараметрыЗапуска)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Выгружает конфигурацию в файлы.
Синтаксис
Функция ВыгрузитьКонфигурациюВФайлы(Знач КаталогВыгрузки, Знач ПараметрыЗапуска = Неопределено) Экспорт
Пример вызова
Результат = ЕХТ_Конфигуратор.ВыгрузитьКонфигурациюВФайлы(КаталогВыгрузки, ПараметрыЗапуска)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Выгрузка расширения ИБ в файлы.
Синтаксис
Функция ВыгрузитьРасширениеВФайлы(Знач ИмяРасширения, Знач ИмяКаталогаВыгрузки, Знач ПараметрыЗапуска = Неопределено) Экспорт
Пример вызова
Результат = ЕХТ_Конфигуратор.ВыгрузитьРасширениеВФайлы(ИмяРасширения, ИмяКаталогаВыгрузки, ПараметрыЗапуска)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Выгрузка расширения из файла в файлы.
Синтаксис
Функция ВыгрузитьРасширениеИзФайлаВФайлы(Знач ИмяРасширения, Знач ИмяФайлаРасширения, Знач ИмяКаталогаВыгрузки, Знач ПараметрыЗапуска = Неопределено) Экспорт
Пример вызова
Результат = ЕХТ_Конфигуратор.ВыгрузитьРасширениеИзФайлаВФайлы(ИмяРасширения, ИмяФайлаРасширения, ИмяКаталогаВыгрузки, ПараметрыЗапуска)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Загружает внешний отчет из файлов.
Синтаксис
Функция ЗагрузитьВнешнийОтчетИзФайлов(Знач ИмяФайла, Знач ИмяКаталогаВыгрузки = Неопределено, Знач ПараметрыЗапуска = Неопределено) Экспорт
Пример вызова
Результат = ЕХТ_Конфигуратор.ЗагрузитьВнешнийОтчетИзФайлов(ИмяФайла, ИмяКаталогаВыгрузки, ПараметрыЗапуска)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Загружает внешнюю обработку из файлов.
Синтаксис
Функция ЗагрузитьВнешнююОбработкуИзФайлов(Знач ИмяФайла, Знач ИмяКаталогаВыгрузки = Неопределено, Знач ПараметрыЗапуска = Неопределено) Экспорт
Пример вызова
Результат = ЕХТ_Конфигуратор.ЗагрузитьВнешнююОбработкуИзФайлов(ИмяФайла, ИмяКаталогаВыгрузки, ПараметрыЗапуска)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Загрузка расширения в ИБ из файла расширения.
Синтаксис
Функция ЗагрузитьРасширениеИзФайла(Знач ИмяРасширения, Знач ИмяФайлаРасширения, ПараметрыЗапуска = Неопределено) Экспорт
Пример вызова
Результат = ЕХТ_Конфигуратор.ЗагрузитьРасширениеИзФайла(ИмяРасширения, ИмяФайлаРасширения, ПараметрыЗапуска)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Загрузка расширения из файлов
Пример использования:
ПараметрыЗапуска = ПараметрыЗапуска();
ПараметрыЗапуска.Каталог = КаталогИБ;
Результат = ЗагрузитьРасширениеИзФайлов("ЕХТ_Подписки", ЭтотОбъект.КаталогРасширения, ПараметрыЗапуска);
ЕХТ.СообщитьПользователю("Загрузка расширения"
+ " Код возврата:" + Результат.КодВозврата
+ " Ошибки: "+ ?(Результат.ПотокОшибок="", " (нет)", Результат.ПотокОшибок)
+ " Длительность: "+Результат.Длительность+" сек.");
Синтаксис
Функция ЗагрузитьРасширениеИзФайлов(ИмяРасширения, КаталогРасширения, ПараметрыЗапуска = Неопределено) Экспорт
Пример вызова
Результат = ЕХТ_Конфигуратор.ЗагрузитьРасширениеИзФайлов(ИмяРасширения, КаталогРасширения, ПараметрыЗапуска)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает полный путь к каталогу tmplts.
Синтаксис
Функция КаталогШаблонов() Экспорт
Пример вызова
Результат = ЕХТ_Конфигуратор.КаталогШаблонов()
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает результат проверки наличия конфигурации поставщика.
Синтаксис
Функция КонфигурацияПоставщикаСуществует(Знач ИмяКонфигурацииПоставщика = Неопределено, Знач ПараметрыЗапуска = Неопределено) Экспорт
Пример вызова
Результат = ЕХТ_Конфигуратор.КонфигурацияПоставщикаСуществует(ИмяКонфигурацииПоставщика, ПараметрыЗапуска)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает полный путь к 1cv8.exe заданной версии.
Синтаксис
Функция НайтиПрограммуЗаданнойВерсии(Знач Версия) Экспорт
Пример вызова
Результат = ЕХТ_Конфигуратор.НайтиПрограммуЗаданнойВерсии(Версия)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращет Истина, если запущен Конфигуратор.
Синтаксис
Функция Открыт() Экспорт
Пример вызова
Результат = ЕХТ_Конфигуратор.Открыт()
Доступность
Сервер, Вызов сервера, Внешнее соединение
Выполняет пакетный запуск Конфигуратора с заданными параметрами.
Синтаксис
Функция ПакетныйЗапуск(Знач СтрокаКоманды, Знач ПараметрыЗапуска) Экспорт
Пример вызова
Результат = ЕХТ_Конфигуратор.ПакетныйЗапуск(СтрокаКоманды, ПараметрыЗапуска)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает параметры запуска пакетного режима.
Синтаксис
Функция ПараметрыЗапуска() Экспорт
Пример вызова
Результат = ЕХТ_Конфигуратор.ПараметрыЗапуска()
Доступность
Сервер, Вызов сервера, Внешнее соединение
Сохраняет конфигурацию в каталог
Пример вызова:
ПараметрыЗапуска = ПараметрыЗапуска();
ПараметрыЗапуска.ИмяПользователя = ИмяПользователя();
СохранитьКонфигурациюВКаталог("C:\Users\Andrey\Desktop\Выгрузка конфигурации", ПараметрыЗапуска);
Синтаксис
Функция СохранитьКонфигурациюВКаталог(Знач ИмяКаталога, Знач ПараметрыЗапуска = Неопределено) Экспорт
Пример вызова
Результат = ЕХТ_Конфигуратор.СохранитьКонфигурациюВКаталог(ИмяКаталога, ПараметрыЗапуска)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Сохраняет конфигурацию в файл.
Пример вызова:
ПараметрыЗапуска = ПараметрыЗапуска();
ПараметрыЗапуска.ИмяПользователя = ИмяПользователя();
СохранитьКонфигурациюВФайл("C:\Users\Andrey\Desktop\Выгрузка конфигурации\1cv8.cf", ПараметрыЗапуска);
Синтаксис
Функция СохранитьКонфигурациюВФайл(Знач ИмяФайла, Знач ПараметрыЗапуска = Неопределено) Экспорт
Пример вызова
Результат = ЕХТ_Конфигуратор.СохранитьКонфигурациюВФайл(ИмяФайла, ПараметрыЗапуска)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Сохранение расширения в файл
Пример использования:
ПараметрыЗапуска = ПараметрыЗапуска();
ПараметрыЗапуска.Каталог = КаталогИБ;
Результат = СохранитьРасширениеВФайл("ЕХТ", ЕХТ_Файлы.К(ЭтотОбъект.Каталог)+"ЕХТ.cfe", ПараметрыЗапуска);
ЕХТ.СообщитьПользователю("Сохранить расширение"
+ " Код возврата:" + Результат.КодВозврата
+ " Ошибки: "+ ?(Результат.ПотокОшибок="", " (нет)", Результат.ПотокОшибок)
+ " Длительность: "+Результат.Длительность+" сек.");
Синтаксис
Функция СохранитьРасширениеВФайл(Знач ИмяРасширения, Знач ИмяФайла, Знач ПараметрыЗапуска = Неопределено) Экспорт
Пример вызова
Результат = ЕХТ_Конфигуратор.СохранитьРасширениеВФайл(ИмяРасширения, ИмяФайла, ПараметрыЗапуска)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Пример использования:
SecretKey = "secret";
Payload = Новый Структура;
Payload.Вставить("sub", "1234567890");
Payload.Вставить("name", "John Doe");
Payload.Вставить("admin", Истина);
Token = ЕХТ_Криптография.вJWT(SecretKey, Payload);
Синтаксис
Функция вJWT(Знач SecretKey, Знач Payload = Неопределено, Знач ExtraHeaders = Неопределено) Экспорт
Пример вызова
Результат = ЕХТ_Криптография.вJWT(SecretKey, Payload, ExtraHeaders)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Вычисляет подпись алгоритмом HMAC-SHA256.
Синтаксис
Функция Подпись(Знач Ключ, Знач Данные) Экспорт
Параметры
Ключ - ДвоичныеДанные. Данные - Строка. ВозвращаемоеЗначение: Строка - подпись в формате BASE64.
Пример вызова
Результат = ЕХТ_Криптография.Подпись(Ключ, Данные)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Форматирование текста информации и запись в журнал регистрации.
Синтаксис
Функция Информация(Знач ИмяМодуля, Знач ИмяМетода, Знач Комментарий, Знач Данные = Неопределено, Знач ДополнительныеПараметры = Неопределено) Экспорт
Параметры
ИмяМодуля - Строка - Полное имя модуля. ИмяМетода - Строка - Имя процедуры или функции. Комментарий - Строка - Произвольная строка комментария к событию. Данные - Произвольный - Данные, с которыми связано событие. ДополнительныеПараметры - Структура - Дополнительные параметры.
Возвращаемое значение
- Строка - Возвращает строку, записанную в Журнал Регистрации.
Пример вызова
Сообщение = ЕХТ_Строка.сПараметрами(
НСтр("ru = '1-я строка описания ошибки <%1>
|2-я строка описания ошибки <%2>
|3-я строка описания ошибки <%3>'"),
Значение1,
Значение2,
Значение3);
ЕХТ_Лог.Информация(ПолноеИмя(), "ИмяМетода", Сообщение);
Доступность
Сервер, Вызов сервера, Внешнее соединение
Форматирование текста ошибки и запись в журнал регистрации.
Синтаксис
Функция Ошибка(Знач ИмяМодуля, Знач ИмяМетода, Знач Комментарий, Знач Данные = Неопределено, Знач ДополнительныеПараметры = Неопределено) Экспорт
Параметры
ИмяМодуля - Строка - Полное имя модуля. ИмяМетода - Строка - Имя процедуры или функции. Комментарий - Строка - Произвольная строка комментария к событию. Данные - Произвольный - Данные, с которыми связано событие. ДополнительныеПараметры - Структура - Дополнительные параметры.
Возвращаемое значение
- Строка - Возвращает строку, записанную в Журнал Регистрации.
Пример вызова
Сообщение = ЕХТ_Строка.сПараметрами(
НСтр("ru = '1-я строка описания ошибки <%1>
|2-я строка описания ошибки <%2>
|3-я строка описания ошибки <%3>'"),
Значение1,
Значение2,
Значение3);
ЕХТ_Лог.Ошибка(ПолноеИмя(), "ИмяМетода", Сообщение);
Доступность
Сервер, Вызов сервера, Внешнее соединение
Форматирование текста предупреждения и запись в журнал регистрации.
Синтаксис
Функция Предупреждение_(Знач ИмяМодуля, Знач ИмяМетода, Знач Комментарий, Знач Данные = Неопределено, Знач ДополнительныеПараметры = Неопределено) Экспорт
Параметры
ИмяМодуля - Строка - Полное имя модуля. ИмяМетода - Строка - Имя процедуры или функции. Комментарий - Строка - Произвольная строка комментария к событию. Данные - Произвольный - Данные, с которыми связано событие. ДополнительныеПараметры - Структура - Дополнительные параметры.
Возвращаемое значение
- Строка - Возвращает строку, записанную в Журнал Регистрации.
Пример вызова
Сообщение = ЕХТ_Строка.сПараметрами(
НСтр("ru = '1-я строка описания предупреждения <%1>
|2-я строка описания предупреждения <%2>
|3-я строка описания предупреждения <%3>'"),
Значение1,
Значение2,
Значение3);
ЕХТ_Лог.Предупреждение_(ПолноеИмя(), "ИмяМетода", Сообщение);
Доступность
Сервер, Вызов сервера, Внешнее соединение
Форматирование текста примечания и запись в журнал регистрации.
Синтаксис
Функция Примечание(Знач ИмяМодуля, Знач ИмяМетода, Знач Комментарий, Знач Данные = Неопределено, Знач ДополнительныеПараметры = Неопределено) Экспорт
Параметры
ИмяМодуля - Строка - Полное имя модуля. ИмяМетода - Строка - Имя процедуры или функции. Комментарий - Строка - Произвольная строка комментария к событию. Данные - Произвольный - Данные, с которыми связано событие. ДополнительныеПараметры - Структура - Дополнительные параметры.
Возвращаемое значение
- Строка - Возвращает строку, записанную в Журнал Регистрации.
Пример вызова
Сообщение = ЕХТ_Строка.сПараметрами(
НСтр("ru = '1-я строка описания ошибки <%1>
|2-я строка описания ошибки <%2>
|3-я строка описания ошибки <%3>'"),
Значение1,
Значение2,
Значение3);
ЕХТ_Лог.Примечание(ПолноеИмя(), "ИмяМетода", Сообщение);
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает добавленное в массив значение.
Синтаксис
Функция Добавить(Массив, Знач Значение = Неопределено) Экспорт
Пример вызова
Результат = ЕХТ_Массив.Добавить(Массив, Значение)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Дополняет массив МассивПриемник значениями из массива МассивИсточник.
Синтаксис
Функция Дополнить(МассивПриемник, Знач МассивИсточник, Знач ТолькоУникальныеЗначения = Ложь) Экспорт
Параметры
МассивПриемник - Массив - массив, в который необходимо добавить значения. МассивИсточник - Массив - массив значений для заполнения. ТолькоУникальныеЗначения - Булево - если истина, то в массив будут включены только уникальные значения.
Пример вызова
Результат = ЕХТ_Массив.Дополнить(МассивПриемник, МассивИсточник, ТолькоУникальныеЗначения)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает массив из полученных значений.
Синтаксис
Функция ИзЗначения(Знач П01 = NULL, Знач П02 = NULL, Знач П03 = NULL, Знач П04 = NULL, Знач П05 = NULL, Знач П06 = NULL, Знач П07 = NULL, Знач П08 = NULL, Знач П09 = NULL, Знач П10 = NULL, Знач П11 = NULL, Знач П12 = NULL) Экспорт
Параметры
П01..П12 - ЛюбоеЗначение - значения, которые нужно поместить в массив.
Возвращаемое значение
Массив - массив со значениями.
Пример вызова
Результат = ЕХТ_Массив.ИзЗначения(П01, П02, П03, П04, П05, П06, П07, П08, П09, П10, П11, П12)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает массив элементов коллекции. Если передан параметр КлючЭлемента, то в массив будет помещаться полученное по ключу значение элемента коллеции.
Синтаксис
Функция ИзКоллекции(Знач Коллекция, Знач КлючЭлемента = Неопределено) Экспорт
Пример вызова
Результат = ЕХТ_Массив.ИзКоллекции(Коллекция, КлючЭлемента)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает Массив, созданный из полученного Соответствия. Параметр КлючИлиЗначение указывает что именно нужно поместить в массив - "Ключ" или "Значение".
Синтаксис
Функция ИзСоответствия(Знач Соответствие, Знач КлючИлиЗначение = "Значение") Экспорт
Пример вызова
Результат = ЕХТ_Массив.ИзСоответствия(Соответствие, КлючИлиЗначение)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает массив строк из строки, в которой могут быть пробелы, переносы строк и т.п.
Синтаксис
Функция ИзСтроки(Знач Строка, Знач Разделители = Неопределено, Знач ВключатьПустые = Ложь) Экспорт
Пример вызова
Результат = ЕХТ_Массив.ИзСтроки(Строка, Разделители, ВключатьПустые)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает максимальное значение и, при необходимости, его индекс из полученного массива.
Синтаксис
Функция МаксимальноеЗначение(Знач Массив, ИндексЗначения = Неопределено) Экспорт
Параметры
Массив - Массив - Массив, в котором нужно найти максимальное значение. ИндексЗначения - Число - Индекс элемента массива с максимальным значением (возвращаемое значение).
Возвращаемое значение
- МаксимальноеЗначение.
Пример вызова
Результат = ЕХТ_Массив.МаксимальноеЗначение(Массив, ИндексЗначения)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает минимальное значение и, при необходимости, его индекс из полученного массива.
Синтаксис
Функция МинимальноеЗначение(Знач Массив, ИндексЗначения = Неопределено) Экспорт
Параметры
Массив - Массив - Массив, в котором нужно найти минимальное значение. ИндексЗначения - Число - Индекс элемента массива с минимальным значением (возвращаемое значение).
Возвращаемое значение
- Минимальное значение.
Пример вызова
Результат = ЕХТ_Массив.МинимальноеЗначение(Массив, ИндексЗначения)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает свернутую копию массива.
Синтаксис
Функция Свернутый(Знач Массив) Экспорт
Пример вызова
Результат = ЕХТ_Массив.Свернутый(Массив)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает свернутый массив.
Синтаксис
Функция Свернуть(Массив) Экспорт
Пример вызова
Результат = ЕХТ_Массив.Свернуть(Массив)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Создает копию значения типа Массив, рекурсивно, с учетом типов значений элементов массива. Если элементы массива содержат значения объектных типов (СправочникОбъект, ДокументОбъект и т.п.), то их содержимое не копируются, а возвращаются ссылки на исходный объект.
Синтаксис
Функция Скопировать(Знач МассивИсточник) Экспорт
Параметры
МассивИсточник - Массив, копию которого необходимо получить.
Возвращаемое значение
Массив - копия исходного массива.
Пример вызова
Результат = ЕХТ_Массив.Скопировать(МассивИсточник)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает сортированную копию массива, где Направление это НаправлениеСортировки.Возр или НаправлениеСортировки.Убыв.
Синтаксис
Функция Сортированный(Знач Массив, Знач Направление = Неопределено) Экспорт
Пример вызова
Результат = ЕХТ_Массив.Сортированный(Массив, Направление)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает отсортированный массив, где Направление это НаправлениеСортировки.Возр или НаправлениеСортировки.Убыв.
Синтаксис
Функция Сортировать(Массив, Знач Направление = Неопределено) Экспорт
Пример вызова
Результат = ЕХТ_Массив.Сортировать(Массив, Направление)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает элементы массива с <НачальныйИндекс> по <КонечныйИндекс>.
Синтаксис
Функция Срез(Знач Массив, Знач НачальныйИндекс = 0, Знач КонечныйИндекс = Неопределено) Экспорт
Параметры
Массив - Массив - исходный массив, срез которого будет получен.
НачальныйИндекс - Число - Индекс элемента, с которого начинается срез (включительно).
Если параметр не указан, то выбираются элементы с начала массива.
Если указано значение, меньшее нуля, то параметр принимает значение 0.
КонечныйИндекс - Число - Индекс элемента, по который выполняется срез (включительно).
Если параметр не указан, то выбираются элементы до конца массива.
Если указано значение, большее индекса конечного элемента,
то параметр принимает значение, равное индексу конечного элемента.
Возвращаемое значение
Массив - элементы исходного массива в указанном диапазоне.
Пример вызова
Результат = ЕХТ_Массив.Срез(Массив, НачальныйИндекс, КонечныйИндекс)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Удаляет из массива полученное значение или все значения полученного массива.
Синтаксис
Функция Удалить(Массив, Знач УдаляемоеЗначение) Экспорт
Параметры
Массив - Массив - Массив, в котором нужно удалить значения. УдаляемоеЗначение - Значение или Массив со значеними, которые нужно удалить.
Пример вызова
Результат = ЕХТ_Массив.Удалить(Массив, УдаляемоеЗначение)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Удаление из массива всех незаполненных значений.
Синтаксис
Функция УдалитьНезаполненные(Массив) Экспорт
Параметры
Массив
Пример вызова
Результат = ЕХТ_Массив.УдалитьНезаполненные(Массив)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает фиксированный массив из полученного значения.
Синтаксис
Функция ФиксированныйИзЗначения(Знач Значение) Экспорт
Параметры
Значение - ЛюбоеЗначение - значение, которые нужно поместить в массив.
Возвращаемое значение
ФиксированныйМассив - массив со значениями.
Пример вызова
Результат = ЕХТ_Массив.ФиксированныйИзЗначения(Значение)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает фиксированный массив с фиксированными значениями.
Синтаксис
Функция Фиксировать(Знач Массив) Экспорт
Параметры
Значение - Массив - Исходный массив.
Возвращаемое значение
ФиксированныйМассив -
Пример вызова
Результат = ЕХТ_Массив.Фиксировать(Массив)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает последний элемент массива.
Синтаксис
Функция Хвост(Знач Массив) Экспорт
Пример вызова
Результат = ЕХТ_Массив.Хвост(Массив)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает модуль числа
Синтаксис
Функция Модуль(Знач Значение) Экспорт
Пример вызова
Результат = ЕХТ_Математика.Модуль(Значение)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Выполняет пропорциональное распределение суммы в соответствии с заданными коэффициентами распределения.
Синтаксис
Функция РаспределитьСуммуПропорциональноКоэффициентам(Знач РаспределяемаяСумма, Знач Коэффициенты, Знач Точность = 2) Экспорт
Параметры
РаспределяемаяСумма - Число - сумма, которую надо распределить, если сумма равна 0 - то возвращается Неопределено;
Если передана отрицательная - расчет по модулю и после инверсия знаков результата.
Коэффициенты - Массив - коэффициенты распределения, должны быть положительны или отрицательными одновременно
Точность - Число - точность округления при распределении. Необязателен.
Возвращаемое значение
Массив - массив размерностью равный массиву коэффициентов, содержит
суммы в соответствии с весом коэффициента (из массива коэффициентов).
В случае, если распределить невозможно (кол-во коэффициентов = 0,
есть коэффициенты с отрицательным значением или суммарный вес коэффициентов = 0),
тогда будет возвращено Неопределено.
Пример вызова
Коэффициенты = Новый Массив; Коэффициенты.Добавить(1); Коэффициенты.Добавить(2); Результат = ОбщегоНазначенияКлиентСервер.РаспределитьСуммуПропорциональноКоэффициентам(1, Коэффициенты); // Результат = [0.33, 0.67] Источник: БСП.ОбщегоНазначенияКлиентСервер
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает Метаданные.Версия.
Синтаксис
Функция Версия() Экспорт
Пример вызова
Результат = ЕХТ_Метаданные.Версия()
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает строку вида "8.3.8"
Синтаксис
Функция ВерсияРежимаСовместимости(Знач ПроверяемыйРежим = Неопределено) Экспорт
Пример вызова
Результат = ЕХТ_Метаданные.ВерсияРежимаСовместимости(ПроверяемыйРежим)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает строку с видом объекта, например "Валюты".
Синтаксис
Функция ВидСтр(Знач ОбъектМетаданных) Экспорт
Пример вызова
Результат = ЕХТ_Метаданные.ВидСтр(ОбъектМетаданных)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает перечень (с классификацией) прав, допустимых для объекта метаданных.
Синтаксис
Функция ДопустимыеПраваДляОбъектаМетаданных(Знач ОбъектМетаданных) Экспорт
Параметры
ОбъектМетаданных - ОбъектМетаданных, ОбъектМетаданныхКонфигурация.
Возвращаемое значение
* Имя - Строка, имя вида права, которое может использоваться
для функции ПравоДоступа(),
* Интерактивное - Булево, флаг того, что право ограничивает возможность
выполнения интерактивных операций,
* Чтение - Булево, флаг того, что право предоставляет или подразумевает
возможность чтения данных заданного объекта метаданных,
* Изменение - Булево, флаг того, что право предоставляет или подразумевает
возможность изменения данных заданного объекта метаданных,
* АдминистрированиеИнформационнойБазы - Булево, флаг того, что право
предоставляет или предполагает возможность администрирования
(глобального для информационной базы),
* АдминистрированиеОбластиДанных - Булево, флаг того, что право предоставляет
или предполагает возможность администрирования (глобального для
текущей области данных).
Пример вызова
Результат = ЕХТ_Метаданные.ДопустимыеПраваДляОбъектаМетаданных(ОбъектМетаданных)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Позволяет определить, есть ли среди реквизитов объекта реквизит с переданным именем.
Синтаксис
Функция ЕстьРеквизитОбъекта(Знач ИмяРеквизита, Знач ОбъектМетаданных) Экспорт
Параметры
ИмяРеквизита - Строка - имя реквизита; ОбъектМетаданных - ОбъектМетаданных - объект, в котором требуется проверить наличие реквизита.
Возвращаемое значение
Булево - Истина, если есть.
Пример вызова
Результат = ЕХТ_Метаданные.ЕстьРеквизитОбъекта(ИмяРеквизита, ОбъектМетаданных)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает перечень объектов, ссылки на которые содержатся в исходном объекте метаданных. Наборы ссылок и хранение ссылок в хранилище значения не учитываются.
Синтаксис
Функция ЗависимостиОбъектаМетаданных(Знач ОбъектМетаданных) Экспорт
Параметры
ОбъектМетаданных.
Пример вызова
Результат = ЕХТ_Метаданные.ЗависимостиОбъектаМетаданных(ОбъектМетаданных)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает Структуру со значениями свойств метаданных конфигурации, преобразованных в строку.
Синтаксис
Функция ЗначенияСвойствСтр(Знач Свойства) Экспорт
Параметры
Свойства - Строка или Структура - свойста, значения которых нужно получить.
Возвращаемое значение
Структура - Структура со строковыми значениями свойств.
Пример вызова
Результат = ЕХТ_Метаданные.ЗначенияСвойствСтр(Свойства)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает Метаданные.Имя.
Синтаксис
Функция Имя() Экспорт
Пример вызова
Результат = ЕХТ_Метаданные.Имя()
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает имя базового типа по переданному значению объекта метаданных.
Синтаксис
Функция ИмяБазовогоТипаОбъекта(ОбъектМетаданных) Экспорт
Параметры
ОбъектМетаданных - объект метаданных, по которому необходимо определить базовый тип.
Возвращаемое значение
Строка - имя базового типа по переданному значению объекта метаданных.
Пример вызова
Результат = ЕХТ_Метаданные.ИмяБазовогоТипаОбъекта(ОбъектМетаданных)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает картинку соответствующую типу объекта.
Синтаксис
Функция КартинкаОбъекта(Знач ОбъектМетаданных) Экспорт
Пример вызова
Результат = ЕХТ_Метаданные.КартинкаОбъекта(ОбъектМетаданных)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает код основного языка конфигурации, например "ru".
Синтаксис
Функция КодОсновногоЯзыка() Экспорт
Возвращаемое значение
Строка - код языка.
Пример вызова
Результат = ЕХТ_Метаданные.КодОсновногоЯзыка()
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает Истина, если объект метаданных входит в коллекцию объектов метаданных.
Синтаксис
Функция КоллекцияСодержитОбъект(Знач Коллекция, Знач Объект) Экспорт
Пример вызова
Результат = ЕХТ_Метаданные.КоллекцияСодержитОбъект(Коллекция, Объект)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает Истина, если объект метаданных, найденный по типу, входит в коллекцию объектов метаданных.
Синтаксис
Функция КоллекцияСодержитТип(Знач Коллекция, Знач Тип) Экспорт
Пример вызова
Результат = ЕХТ_Метаданные.КоллекцияСодержитТип(Коллекция, Тип)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Проверка существования макета по метаданным конфигурации и расширений.
Синтаксис
Функция МакетСуществует(Знач ПолноеИмяМакета) Экспорт
Параметры
ПолноеИмяМакета - Строка - полное имя макета.
Возвращаемое значение
Булево - признак существования макета.
Пример вызова
Результат = ЕХТ_Метаданные.МакетСуществует(ПолноеИмяМакета)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Проверяет принадлежность объекта метаданных к подсистемам. Проверка производится на непосредственное вхождение в состав указанных подсистем. Подчиненные подистемы не учитываются.
Синтаксис
Функция ОбъектВключенВПодсистемы(Знач ОбъектМетаданных, Знач СписокПодсистем) Экспорт
Параметры
ОбъектМетаданных - Строка, полное имя объекта метаданных или ОбъектМетаданных СписокПодсистем - Строка, полные имена подсистем, перечисленные через запятую или в массиве
Возвращаемое значение
Булево
Пример вызова
Результат = ЕХТ_Метаданные.ОбъектВключенВПодсистемы(ОбъектМетаданных, СписокПодсистем)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает Истина, если объект метаданных входит в коллекцию объектов метаданных.
Синтаксис
Функция ОбъектВходитВКоллекцию(Знач Объект, Знач Коллекция) Экспорт
Пример вызова
Результат = ЕХТ_Метаданные.ОбъектВходитВКоллекцию(Объект, Коллекция)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Проверяет доступность объектов метаданных по текущим значениям функциональных опций.
Синтаксис
Функция ОбъектДоступенПоФункциональнымОпциям(Знач ОбъектМетаданных) Экспорт
Параметры
ОбъектМетаданных.
Пример вызова
Результат = ЕХТ_Метаданные.ОбъектДоступенПоФункциональнымОпциям(ОбъектМетаданных)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает объект метаданных по типу ссылки
Синтаксис
Функция ОбъектМетаданныхПоТипуСсылки(Знач ТипСсылки) Экспорт
Параметры
ТипСсылки - Тип,
Пример вызова
Результат = ЕХТ_Метаданные.ОбъектМетаданныхПоТипуСсылки(ТипСсылки)
Доступность
Сервер, Вызов сервера, Внешнее соединение
// Пример использования: &НаСервере Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка) ЭтотОбъект.СписокТипов = ЕХТ_Метаданные.ПараметрыТаблицыИспользованияОбъектов().СписокЗначений; КонецПроцедуры &НаСервере Процедура Команда1НаСервере() ПараметрыТаблицы = ЕХТ_Метаданные.ПараметрыТаблицыИспользованияОбъектов(); ПараметрыТаблицы.ТолькоИспользуемые = ЭтотОбъект.ТолькоИспользуемые; ПараметрыТаблицы.УпорядочитьПоКоличеству = ЭтотОбъект.УпорядочитьПоКоличеству; ПараметрыТаблицы.СписокЗначений = ЭтотОбъект.СписокТипов; ЕХТ_ТаблицаЗначений.ВывестиНаФорму(ЕХТ_Метаданные.ТаблицаИспользованияОбъектов(ПараметрыТаблицы), ЭтотОбъект, "Результат"); КонецПроцедуры
Синтаксис
Функция ПараметрыТаблицыИспользованияОбъектов() Экспорт
Пример вызова
Результат = ЕХТ_Метаданные.ПараметрыТаблицыИспользованияОбъектов()
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает строку с полным именем объекта, например "Справочник.Валюты".
Синтаксис
Функция ПолноеИмяПоТипу(Знач Тип) Экспорт
Пример вызова
Результат = ЕХТ_Метаданные.ПолноеИмяПоТипу(Тип)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает строку с представлением объекта.
Синтаксис
Функция ПредставлениеОбъекта(Знач ОбъектМетаданных) Экспорт
Пример вызова
Результат = ЕХТ_Метаданные.ПредставлениеОбъекта(ОбъектМетаданных)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает структуру свойств, заполненную из макета ЕХТ_ТипыМетаданных
Синтаксис
Функция СвойстваТипа(Знач ТипСтр, Знач Свойство = Неопределено) Экспорт
Пример вызова
Результат = ЕХТ_Метаданные.СвойстваТипа(ТипСтр, Свойство)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает Метаданные.Синоним.
Синтаксис
Функция Синоним() Экспорт
Пример вызова
Результат = ЕХТ_Метаданные.Синоним()
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает список объектов метаданных.
Синтаксис
Функция СписокОбъектов(Знач СписокОбъектов) Экспорт
Параметры
СписокОбъектов - Строка, Массив -
Возвращаемое значение
Массив -
Пример вызова
Результат = ЕХТ_Метаданные.СписокОбъектов(СписокОбъектов)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает строку свойств ОбъектМетаданных: Роль.
Синтаксис
Функция СтрокаСвойствРоли() Экспорт
Возвращаемое значение
Строка - свойства роли через запятую
Пример вызова
Результат = ЕХТ_Метаданные.СтрокаСвойствРоли()
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает структуру вида: Реквизиты - Массив с именами реквизитов объекта. ТабличныеЧасти - Структура массивов с именами реквизитов табличных частей.
Синтаксис
Функция СтруктураРеквизитовОбъекта(Знач ОбъектМетаданных, Знач ДополнительныеПараметры = Неопределено) Экспорт
Пример вызова
Результат = ЕХТ_Метаданные.СтруктураРеквизитовОбъекта(ОбъектМетаданных, ДополнительныеПараметры)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает таблицу значений с количеством объектов ИБ.
Синтаксис
Функция ТаблицаИспользованияОбъектов(ПараметрыТаблицы = Неопределено) Экспорт
Параметры
ПараметрыТаблицы - Структура - см. ПараметрыТаблицыИспользованияОбъектов()
Возвращаемое значение
ТаблицаЗначений -
Пример вызова
Результат = ЕХТ_Метаданные.ТаблицаИспользованияОбъектов(ПараметрыТаблицы)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Таблица значений, заполненная из макета ЕХТ_ТипыМетаданных
Синтаксис
Функция ТаблицаТипов(Знач Отбор = Неопределено) Экспорт
Пример вызова
Результат = ЕХТ_Метаданные.ТаблицаТипов(Отбор)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает Истина, если объект метаданных, найденный по типу, входит в коллекцию объектов метаданных.
Синтаксис
Функция ТипВходитВКоллекцию(Знач Тип, Знач Коллекция) Экспорт
Пример вызова
Результат = ЕХТ_Метаданные.ТипВходитВКоллекцию(Тип, Коллекция)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает строку с типом объекта, например "Справочник".
Синтаксис
Функция ТипСтр(Знач ОбъектМетаданных) Экспорт
Пример вызова
Результат = ЕХТ_Метаданные.ТипСтр(ОбъектМетаданных)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает цвет стиля по имени.
Синтаксис
Функция ЦветСтиля(Знач ИмяСтиля) Экспорт
Пример вызова
Результат = ЕХТ_Метаданные.ЦветСтиля(ИмяСтиля)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает шрифт стиля по имени.
Синтаксис
Функция ШрифтСтиля(Знач ИмяСтиля) Экспорт
Пример вызова
Результат = ЕХТ_Метаданные.ШрифтСтиля(ИмяСтиля)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Проверяет, является ли переданный объект метаданных бизнес-процессом.
Синтаксис
Функция ЭтоБизнесПроцесс(Знач ОбъектМетаданных) Экспорт
Параметры
ОбъектМетаданных - проверяемый объект метаданных.
Пример вызова
Результат = ЕХТ_Метаданные.ЭтоБизнесПроцесс(ОбъектМетаданных)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Проверяет, является ли переданный объект метаданных внешним источником данных.
Синтаксис
Функция ЭтоВнешнийИсточникДанных(Знач ОбъектМетаданных) Экспорт
Параметры
ОбъектМетаданных - проверяемый объект метаданных.
Пример вызова
Результат = ЕХТ_Метаданные.ЭтоВнешнийИсточникДанных(ОбъектМетаданных)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Проверяет, является ли переданный объект метаданных документом.
Синтаксис
Функция ЭтоДокумент(Знач ОбъектМетаданных) Экспорт
Параметры
ОбъектМетаданных - проверяемый объект метаданных.
Пример вызова
Результат = ЕХТ_Метаданные.ЭтоДокумент(ОбъектМетаданных)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает структуру свойств, заполненную из макета ЕХТ_ТипыМетаданных
Синтаксис
Функция ЭтоДопустимыйТип(Знач ТипСтр, ЗначенияСвойств = Неопределено) Экспорт
Параметры
ТипСтр - Строка - Проверсемый тип ЗначенияСвойств - Структура - Возвращаемое значение
Возвращаемое значение
- Булево
Пример вызова
Результат = ЕХТ_Метаданные.ЭтоДопустимыйТип(ТипСтр, ЗначенияСвойств)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Проверяет, является ли переданный объект метаданных журналом документов.
Синтаксис
Функция ЭтоЖурналДокументов(Знач ОбъектМетаданных) Экспорт
Параметры
ОбъектМетаданных - проверяемый объект метаданных.
Пример вызова
Результат = ЕХТ_Метаданные.ЭтоЖурналДокументов(ОбъектМетаданных)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Проверяет, является ли переданный объект метаданных задачей.
Синтаксис
Функция ЭтоЗадача(Знач ОбъектМетаданных) Экспорт
Параметры
ОбъектМетаданных - проверяемый объект метаданных.
Пример вызова
Результат = ЕХТ_Метаданные.ЭтоЗадача(ОбъектМетаданных)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Проверяет, является ли переданный объект метаданных константной.
Синтаксис
Функция ЭтоКонстанта(Знач ОбъектМетаданных) Экспорт
Параметры
ОбъектМетаданных - проверяемый объект метаданных.
Пример вызова
Результат = ЕХТ_Метаданные.ЭтоКонстанта(ОбъектМетаданных)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Проверяет, является ли переданный объект метаданных набором записей.
Синтаксис
Функция ЭтоНаборЗаписей(Знач ОбъектМетаданных) Экспорт
Параметры
ОбъектМетаданных - проверяемый объект метаданных.
Пример вызова
Результат = ЕХТ_Метаданные.ЭтоНаборЗаписей(ОбъектМетаданных)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Проверяет, является ли переданный объект метаданных перерасчетом.
Синтаксис
Функция ЭтоНаборЗаписейПерерасчета(Знач ОбъектМетаданных) Экспорт
Параметры
ОбъектМетаданных - проверяемый объект метаданных.
Пример вызова
Результат = ЕХТ_Метаданные.ЭтоНаборЗаписейПерерасчета(ОбъектМетаданных)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Проверяет, является ли переданный объект метаданных набором записей, поддерживающим итоги.
Синтаксис
Функция ЭтоНаборЗаписейПоддерживающийИтоги(Знач ОбъектМетаданных) Экспорт
Параметры
ОбъектМетаданных - проверяемый объект метаданных.
Пример вызова
Результат = ЕХТ_Метаданные.ЭтоНаборЗаписейПоддерживающийИтоги(ОбъектМетаданных)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Проверяет, является ли переданный объект метаданных последовательности.
Синтаксис
Функция ЭтоНаборЗаписейПоследовательности(Знач ОбъектМетаданных) Экспорт
Параметры
ОбъектМетаданных - проверяемый объект метаданных.
Пример вызова
Результат = ЕХТ_Метаданные.ЭтоНаборЗаписейПоследовательности(ОбъектМетаданных)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Проверяет, является ли переданный объект метаданных независимым набором записей.
Синтаксис
Функция ЭтоНезависимыйНаборЗаписей(Знач ОбъектМетаданных) Экспорт
Параметры
ОбъектМетаданных - проверяемый объект метаданных.
Пример вызова
Результат = ЕХТ_Метаданные.ЭтоНезависимыйНаборЗаписей(ОбъектМетаданных)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Проверяет, является ли переданный объект метаданных общим реквизитом.
Синтаксис
Функция ЭтоОбщийРеквизит(Знач ОбъектМетаданных) Экспорт
Параметры
ОбъектМетаданных - проверяемый объект метаданных.
Пример вызова
Результат = ЕХТ_Метаданные.ЭтоОбщийРеквизит(ОбъектМетаданных)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Проверяет, является ли переданный объект метаданных объектом ОбъектМетаданныхКонфигурация.
Синтаксис
Функция ЭтоОбъектМетаданныхКонфигурация(Знач ОбъектМетаданных) Экспорт
Параметры
ОбъектМетаданных - проверяемый объект метаданных.
Пример вызова
Результат = ЕХТ_Метаданные.ЭтоОбъектМетаданныхКонфигурация(ОбъектМетаданных)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Проверяет, является ли переданный объект метаданных параметром сеанса.
Синтаксис
Функция ЭтоПараметрСеанса(Знач ОбъектМетаданных) Экспорт
Параметры
ОбъектМетаданных - проверяемый объект метаданных.
Пример вызова
Результат = ЕХТ_Метаданные.ЭтоПараметрСеанса(ОбъектМетаданных)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Проверяет, является ли переданный объект метаданных перечислением.
Синтаксис
Функция ЭтоПеречисление(Знач ОбъектМетаданных) Экспорт
Параметры
ОбъектМетаданных - проверяемый объект метаданных.
Пример вызова
Результат = ЕХТ_Метаданные.ЭтоПеречисление(ОбъектМетаданных)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Проверяет, является ли переданный объект метаданных планом видов расчета.
Синтаксис
Функция ЭтоПланВидовРасчета(Знач ОбъектМетаданных) Экспорт
Параметры
ОбъектМетаданных - проверяемый объект метаданных.
Пример вызова
Результат = ЕХТ_Метаданные.ЭтоПланВидовРасчета(ОбъектМетаданных)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Проверяет, является ли переданный объект метаданных планом видов расчета.
Синтаксис
Функция ЭтоПланВидовХарактеристик(Знач ОбъектМетаданных) Экспорт
Параметры
ОбъектМетаданных - проверяемый объект метаданных.
Пример вызова
Результат = ЕХТ_Метаданные.ЭтоПланВидовХарактеристик(ОбъектМетаданных)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Проверяет, является ли переданный объект метаданных планом обмена.
Синтаксис
Функция ЭтоПланОбмена(Знач ОбъектМетаданных) Экспорт
Параметры
ОбъектМетаданных - проверяемый объект метаданных.
Пример вызова
Результат = ЕХТ_Метаданные.ЭтоПланОбмена(ОбъектМетаданных)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Проверяет, является ли переданный объект метаданных планом счетов.
Синтаксис
Функция ЭтоПланСчетов(Знач ОбъектМетаданных) Экспорт
Параметры
ОбъектМетаданных - проверяемый объект метаданных.
Пример вызова
Результат = ЕХТ_Метаданные.ЭтоПланСчетов(ОбъектМетаданных)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Проверяет, является ли переданный объект метаданных подсистемой.
Синтаксис
Функция ЭтоПодсистема(Знач ОбъектМетаданных) Экспорт
Параметры
ОбъектМетаданных - проверяемый объект метаданных.
Пример вызова
Результат = ЕХТ_Метаданные.ЭтоПодсистема(ОбъектМетаданных)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Определяет принадлежность объекта метаданных к общему типу "Последовательности".
Синтаксис
Функция ЭтоПоследовательность(Знач ОбъектМетаданных) Экспорт
Параметры
ОбъектМетаданных - ОбъектМетаданных - объект, для которого необходимо определить принадлежность к заданному типу.
Возвращаемое значение
Булево - Истина, если объект является последовательностью.
Пример вызова
Результат = ЕХТ_Метаданные.ЭтоПоследовательность(ОбъектМетаданных)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Проверяет включение объекта метаданных в состав разделителя в режиме, включающем разделение данных.
Синтаксис
Функция ЭтоРазделенныйОбъектМетаданных(Знач ОбъектМетаданных, Знач ИмяРазделителя) Экспорт
Параметры
ОбъектМетаданных - проверяемый объект метаданных, ИмяРазделителя - Строка - имя общего реквизита - разделителя.
Пример вызова
Результат = ЕХТ_Метаданные.ЭтоРазделенныйОбъектМетаданных(ОбъектМетаданных, ИмяРазделителя)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Проверяет, является ли переданный объект метаданных регистром бухгалтерии.
Синтаксис
Функция ЭтоРегистрБухгалтерии(Знач ОбъектМетаданных) Экспорт
Параметры
ОбъектМетаданных - проверяемый объект метаданных.
Пример вызова
Результат = ЕХТ_Метаданные.ЭтоРегистрБухгалтерии(ОбъектМетаданных)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Проверяет, является ли переданный объект метаданных регистром накопления.
Синтаксис
Функция ЭтоРегистрНакопления(Знач ОбъектМетаданных) Экспорт
Параметры
ОбъектМетаданных - проверяемый объект метаданных.
Пример вызова
Результат = ЕХТ_Метаданные.ЭтоРегистрНакопления(ОбъектМетаданных)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Проверяет, является ли переданный объект метаданных регистром расчета.
Синтаксис
Функция ЭтоРегистрРасчета(Знач ОбъектМетаданных) Экспорт
Параметры
ОбъектМетаданных - проверяемый объект метаданных.
Пример вызова
Результат = ЕХТ_Метаданные.ЭтоРегистрРасчета(ОбъектМетаданных)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Проверяет, является ли переданный объект метаданных регистром сведений.
Синтаксис
Функция ЭтоРегистрСведений(Знач ОбъектМетаданных) Экспорт
Параметры
ОбъектМетаданных - проверяемый объект метаданных.
Пример вызова
Результат = ЕХТ_Метаданные.ЭтоРегистрСведений(ОбъектМетаданных)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Проверяет, является ли переданный объект метаданных регламентным заданием.
Синтаксис
Функция ЭтоРегламентноеЗадание(Знач ОбъектМетаданных) Экспорт
Параметры
ОбъектМетаданных - проверяемый объект метаданных.
Пример вызова
Результат = ЕХТ_Метаданные.ЭтоРегламентноеЗадание(ОбъектМетаданных)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Проверяет, является ли переданный объект метаданных справочником.
Синтаксис
Функция ЭтоСправочник(Знач ОбъектМетаданных) Экспорт
Параметры
ОбъектМетаданных - проверяемый объект метаданных.
Пример вызова
Результат = ЕХТ_Метаданные.ЭтоСправочник(ОбъектМетаданных)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Проверяет, является ли переданный объект метаданных ссылочным.
Синтаксис
Функция ЭтоСсылочныеДанные(Знач ОбъектМетаданных) Экспорт
Параметры
ОбъектМетаданных - проверяемый объект метаданных.
Пример вызова
Результат = ЕХТ_Метаданные.ЭтоСсылочныеДанные(ОбъектМетаданных)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Проверяет, является ли переданный объект метаданных ссылочным с поддержкой предопределенных элементов.
Синтаксис
Функция ЭтоСсылочныеДанныеПоддерживающиеПредопределенныеЭлементы(Знач ОбъектМетаданных) Экспорт
Параметры
ОбъектМетаданных - проверяемый объект метаданных.
Пример вызова
Результат = ЕХТ_Метаданные.ЭтоСсылочныеДанныеПоддерживающиеПредопределенныеЭлементы(ОбъектМетаданных)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает признак того, что реквизит входит в подмножество стандартных реквизитов.
Синтаксис
Функция ЭтоСтандартныйРеквизит(Знач СтандартныеРеквизиты, Знач ИмяРеквизита) Экспорт
Параметры
СтандартныеРеквизиты - ОписанияСтандартныхРеквизитов - тип и значение, описывающие коллекцию настроек различных
стандартных реквизитов;
ИмяРеквизита - Строка - реквизит, который необходимо проверить на принадлежность множеству стандартных
реквизитов.
Возвращаемое значение
Булево - Истина, если реквизит входит в подмножество стандартных реквизитов.
Пример вызова
Результат = ЕХТ_Метаданные.ЭтоСтандартныйРеквизит(СтандартныеРеквизиты, ИмяРеквизита)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает Истину, если объект включен непросредственно в любую из списка подсистем
Синтаксис
Функция ОбъектВключенВПодсистемы(Знач ПолноеИмяОбъекта, Знач СтрокаПодсистем) Экспорт
Пример вызова
Результат = ЕХТ_МетаданныеПовтИсп.ОбъектВключенВПодсистемы(ПолноеИмяОбъекта, СтрокаПодсистем)
Доступность
Сервер, Внешнее соединение
Записывает конфиденциальные данные в безопасное хранилище. Вызывающий код должен самостоятельно устанавливать привилегированный режим. Безопасное хранилище недоступно для чтения пользователям (кроме администраторов), а доступно только коду, который делает обращения только к своей части данных и в том контексте, который предполагает чтение или запись конфиденциальных данных.
Синтаксис
Процедура вБезопасноеХранилище(Владелец, Данные, Ключ = "Пароль") Экспорт
Параметры
Владелец - ПланОбменаСсылка
- СправочникСсылка
- Строка - ссылка на объект информационной базы,
представляющий объект-владелец сохраняемого пароля или строка до 128 символов.
Для объектов других типов в качестве владельца рекомендуется использовать ссылку на
элемент метаданных этого типа в справочнике ИдентификаторыОбъектовМетаданных
или ключ в виде строки с учетом имен подсистем.
Например, для БСП:
Владелец = ОбщегоНазначения.ИдентификаторОбъектаМетаданных("РегистрСведений.АдресныеОбъекты");
если нужно 1 хранилище на подсистему БСП:
Владелец = "СтандартныеПодсистемы.УправлениеДоступом";
если нужно более 1 хранилища на подсистему БСП:
Владелец = "СтандартныеПодсистемы.УправлениеДоступом.<Уточнение>";
Данные - Произвольный - данные помещаемые в безопасное хранилище. Неопределенно - удаляет все данные.
Для удаления данных по ключу следует использовать процедуру УдалитьДанныеИзБезопасногоХранилища.
Ключ - Строка - ключ сохраняемых настроек, по умолчанию "Пароль".
Ключ должен соответствовать правилам, установленным для идентификаторов:
* Первым символом ключа должна быть буква или символ подчеркивания (_).
* Каждый из последующих символов может быть буквой, цифрой или символом подчеркивания (_).
Пример вызова
Процедура ПриЗаписиНаСервере(Отказ, ТекущийОбъект, ПараметрыЗаписи)
Если ТекущийПользовательМожетИзменятьПароль Тогда
УстановитьПривилегированныйРежим(Истина);
ОбщегоНазначения.ЗаписатьДанныеВБезопасноеХранилище(ТекущийОбъект.Ссылка, Логин, "Логин");
ОбщегоНазначения.ЗаписатьДанныеВБезопасноеХранилище(ТекущийОбъект.Ссылка, Пароль);
УстановитьПривилегированныйРежим(Ложь);
КонецЕсли;
КонецПроцедуры
Доступность
Сервер, Вызов сервера, Внешнее соединение
Установить/Получить значение из РегистрСведений.ЕХТ_Настройки
Синтаксис
Функция Значение(Знач Ключ, Знач НовоеЗначение = NULL, Знач КлючОбъекта = "ЕХТ_ЗначениеНастройки", Знач ИмяПользователя = "") Экспорт
Пример вызова
Результат = ЕХТ_Настройки.Значение(Ключ, НовоеЗначение, КлючОбъекта, ИмяПользователя)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Установить/Получить значение из ХранилищаОбщихНастроек пользователя
Требуется ПравоДоступа("СохранениеДанныхПользователя", Метаданные)
Синтаксис
Функция ЗначениеПользователя(Ключ, Значение = NULL, КлючОбъекта = "ЕХТ_ЗначениеНастройкиПользователя") Экспорт
Пример вызова
Результат = ЕХТ_Настройки.ЗначениеПользователя(Ключ, Значение, КлючОбъекта)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает данные из безопасного хранилища. Вызывающий код должен самостоятельно устанавливать привилегированный режим. Безопасное хранилище недоступно для чтения пользователям (кроме администраторов), а доступно только коду, который делает обращения только к своей части данных и в том контексте, который предполагает чтение или запись конфиденциальных данных.
Синтаксис
Функция ИзБезопасногоХранилища(Владелец, Ключи = "Пароль", ОбщиеДанные = Неопределено) Экспорт
Параметры
Владелец - ПланОбменаСсылка
- СправочникСсылка
- Строка - ссылка на объект информационной базы,
представляющий объект-владелец сохраняемого пароля или строка до 128 символов.
Ключи - Строка - содержит список имен сохраненных данных, указанных через запятую.
ОбщиеДанные - Булево - Истина, если требуется в модели сервиса получить данные из общих данных в разделенном режиме.
Возвращаемое значение
Произвольный, Структура, Неопределенно - данные из безопасного хранилища. Если указан один ключ,
то возвращается его значение, иначе структура.
Если данные отсутствуют - Неопределенно.
Пример вызова
Процедура ПриЧтенииНаСервере(ТекущийОбъект) Если ТекущийПользовательМожетИзменятьПароль Тогда УстановитьПривилегированныйРежим(Истина); Логин = ОбщегоНазначения.ПрочитатьДанныеИзБезопасногоХранилища(ТекущийОбъект.Ссылка, "Логин"); Пароль = ОбщегоНазначения.ПрочитатьДанныеИзБезопасногоХранилища(ТекущийОбъект.Ссылка); УстановитьПривилегированныйРежим(Ложь); Иначе Элементы.ГруппаЛогинИПароль.Видимость = Ложь; КонецЕсли; КонецПроцедуры
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает настройки объекта.
Синтаксис
Функция ОбъектаСписком(Знач ИдентификаторОбъекта, Знач НовыйСписокНастроек = NULL) Экспорт
Параметры
ИдентификаторОбъекта - Строка - Идентификатор объекта расширения. НовыйСписокНастроек - Структура - Новые значения настроек.
Возвращаемое значение
- Структура
Пример вызова
Результат = ЕХТ_Настройки.ОбъектаСписком(ИдентификаторОбъекта, НовыйСписокНастроек)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Удаляет конфиденциальные данные в безопасном хранилище. Вызывающий код должен самостоятельно устанавливать привилегированный режим. Безопасное хранилище недоступно для чтения пользователям (кроме администраторов), а доступно только коду, который делает обращения только к своей части данных и в том контексте, который предполагает чтение или запись конфиденциальных данных.
Синтаксис
Процедура УдалитьИзБезопасногоХранилища(Владелец, Ключи = Неопределено) Экспорт
Параметры
Владелец - ПланОбменаСсылка
- СправочникСсылка
- Строка - ссылка на объект информационной базы,
представляющий объект-владелец сохраняемого пароля или строка до 128 символов.
Ключи - Строка - содержит список имен удаляемых данных, указанных через запятую.
Неопределено - удаляет все данные.
Пример вызова
Процедура ПередУдалением(Отказ) // Проверка значения свойства ОбменДанными.Загрузка отсутствует, так как удалять данные // из безопасного хранилища нужно даже при удалении объекта при обмене данными. УстановитьПривилегированныйРежим(Истина); ОбщегоНазначения.УдалитьДанныеИзБезопасногоХранилища(Ссылка); УстановитьПривилегированныйРежим(Ложь); КонецПроцедуры
Доступность
Сервер, Вызов сервера, Внешнее соединение
Загружает настройку из хранилища общих настроек, как метод платформы Загрузить, объектов СтандартноеХранилищеНастроекМенеджер или ХранилищеНастроекМенеджер.<Имя хранилища>, но с поддержкой длины ключа настроек более 128 символов путем хеширования части, которая превышает 96 символов. Кроме того, возвращает указанное значение по умолчанию, если настройки не найдены. Если нет права СохранениеДанныхПользователя, возвращается значение по умолчанию без ошибки. В возвращаемом значении очищаются ссылки на несуществующий объект в базе данных, а именно - возвращаемая ссылка заменяется на указанное значение по умолчанию; - из данных типа Массив ссылки удаляются; - у данных типа Структура и Соответствие ключ не меняется, а значение устанавливается Неопределено; - анализ значений в данных типа Массив, Структура, Соответствие выполняется рекурсивно.
Синтаксис
Функция ХранилищеОбщихНастроекЗагрузить(КлючОбъекта, КлючНастроек, ЗначениеПоУмолчанию = Неопределено, ОписаниеНастроек = Неопределено, ИмяПользователя = Неопределено) Экспорт
Параметры
КлючОбъекта - Строка - см. синтакс-помощник платформы.
КлючНастроек - Строка - см. синтакс-помощник платформы.
ЗначениеПоУмолчанию - Произвольный - значение, которое возвращается, если настройки не найдены.
Если не указано, возвращается значение Неопределено.
ОписаниеНастроек - ОписаниеНастроек - см. синтакс-помощник платформы.
ИмяПользователя - Строка - см. синтакс-помощник платформы.
Возвращаемое значение
Произвольный - см. синтакс-помощник платформы.
Пример вызова
Результат = ЕХТ_Настройки.ХранилищеОбщихНастроекЗагрузить(КлючОбъекта, КлючНастроек, ЗначениеПоУмолчанию, ОписаниеНастроек, ИмяПользователя)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Сохраняет настройку в хранилище общих настроек, как метод платформы Сохранить, объектов СтандартноеХранилищеНастроекМенеджер или ХранилищеНастроекМенеджер.<Имя хранилища>, но с поддержкой длины ключа настроек более 128 символов путем хеширования части, которая превышает 96 символов. Если нет права СохранениеДанныхПользователя, сохранение пропускается без ошибки.
Синтаксис
Процедура ХранилищеОбщихНастроекСохранить(КлючОбъекта, КлючНастроек, Настройки, ОписаниеНастроек = Неопределено, ИмяПользователя = Неопределено, ОбновитьПовторноИспользуемыеЗначения = Ложь) Экспорт
Параметры
КлючОбъекта - Строка - см. синтакс-помощник платформы. КлючНастроек - Строка - см. синтакс-помощник платформы. Настройки - Произвольный - см. синтакс-помощник платформы. ОписаниеНастроек - ОписаниеНастроек - см. синтакс-помощник платформы. ИмяПользователя - Строка - см. синтакс-помощник платформы. ОбновитьПовторноИспользуемыеЗначения - Булево - выполнить одноименный метод платформы.
Пример вызова
ЕХТ_Настройки.ХранилищеОбщихНастроекСохранить(КлючОбъекта, КлючНастроек, Настройки, ОписаниеНастроек, ИмяПользователя, ОбновитьПовторноИспользуемыеЗначения)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Сохраняет несколько настроек в хранилище общих настроек, как метод платформы Сохранить, объектов СтандартноеХранилищеНастроекМенеджер или ХранилищеНастроекМенеджер.<Имя хранилища>, но с поддержкой длины ключа настроек более 128 символов путем хеширования части, которая превышает 96 символов. Если нет права СохранениеДанныхПользователя, сохранение пропускается без ошибки.
Синтаксис
Процедура ХранилищеОбщихНастроекСохранитьМассив(НесколькоНастроек, ОбновитьПовторноИспользуемыеЗначения = Ложь) Экспорт
Параметры
НесколькоНастроек - Массив - со значениями:
* Значение - Структура:
* Объект - Строка - см. параметр КлючОбъекта в синтакс-помощнике платформы.
* Настройка - Строка - см. параметр КлючНастроек в синтакс-помощнике платформы.
* Значение - Произвольный - см. параметр Настройки в синтакс-помощнике платформы.
ОбновитьПовторноИспользуемыеЗначения - Булево - выполнить одноименный метод платформы.
Пример вызова
ЕХТ_Настройки.ХранилищеОбщихНастроекСохранитьМассив(НесколькоНастроек, ОбновитьПовторноИспользуемыеЗначения)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Удаляет настройку из хранилища общих настроек, как метод платформы Удалить, объектов СтандартноеХранилищеНастроекМенеджер или ХранилищеНастроекМенеджер.<Имя хранилища>, но с поддержкой длины ключа настроек более 128 символов путем хеширования части, которая превышает 96 символов. Если нет права СохранениеДанныхПользователя, удаление пропускается без ошибки.
Синтаксис
Процедура ХранилищеОбщихНастроекУдалить(КлючОбъекта, КлючНастроек, ИмяПользователя) Экспорт
Параметры
КлючОбъекта - Строка, Неопределено - см. синтакс-помощник платформы. КлючНастроек - Строка, Неопределено - см. синтакс-помощник платформы. ИмяПользователя - Строка, Неопределено - см. синтакс-помощник платформы.
Пример вызова
ЕХТ_Настройки.ХранилищеОбщихНастроекУдалить(КлючОбъекта, КлючНастроек, ИмяПользователя)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает вид объекта строкой.
Синтаксис
Функция ВидСтр(Знач Объект) Экспорт
Параметры
Объект - ЛюбойОбъект - Объект
Возвращаемое значение
Строка - "Номенклатура", "Контрагенты" и т.п.
Пример вызова
Результат = ЕХТ_Объект.ВидСтр(Объект)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Вызвать экспортную функцию объекта встроенного языка по имени. При включении профилей безопасности для вызова оператора Выполнить() используется переход в безопасный режим с профилем безопасности, используемом для информационной базы (если выше по стеку не был установлен другой безопасный режим).
Синтаксис
Функция ВызватьФункцию(Знач Объект, Знач ИмяМетода, Знач Параметры = Неопределено) Экспорт
Параметры
Объект - Произвольный - объект встроенного языка 1С:Предприятия, содержащий методы (например, ОбработкаОбъект).
ИмяМетода - Строка - имя экспортной функции модуля объекта обработки.
Параметры - Массив - параметры передаются в функцию <ИмяМетода>
в порядке расположения элементов массива.
Возвращаемое значение
Произвольный - результат вызываемой функции.
Пример вызова
Результат = ЕХТ_Объект.ВызватьФункцию(Объект, ИмяМетода, Параметры)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Выполнить экспортную процедуру объекта встроенного языка по имени. При включении профилей безопасности для вызова оператора Выполнить() используется переход в безопасный режим с профилем безопасности, используемым для информационной базы (если выше по стеку не был установлен другой безопасный режим).
Синтаксис
Процедура ВыполнитьМетод(Знач Объект, Знач ИмяМетода, Знач Параметры = Неопределено) Экспорт
Параметры
Объект - Произвольный - объект встроенного языка 1С:Предприятия, содержащий методы (например, ОбработкаОбъект).
ИмяМетода - Строка - имя экспортной процедуры модуля объекта обработки.
Параметры - Массив - параметры передаются в процедуру <ИмяПроцедуры>
в порядке расположения элементов массива.
Пример вызова
ЕХТ_Объект.ВыполнитьМетод(Объект, ИмяМетода, Параметры)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает имя менеджера объекта.
Синтаксис
Функция ИмяМенеджера(Знач Объект, ЭтоОбщийМодуль=Ложь) Экспорт
Пример вызова
Результат = ЕХТ_Объект.ИмяМенеджера(Объект, ЭтоОбщийМодуль)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает менеджер объекта.
Синтаксис
Функция Менеджер(Знач Объект) Экспорт
Пример вызова
Результат = ЕХТ_Объект.Менеджер(Объект)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает менеджер объекта по имени. Ограничение: не обрабатываются точки маршрутов бизнес-процессов.
Синтаксис
Функция МенеджерПоИмени(Знач Имя) Экспорт
Параметры
Имя - Строка - имя например, "Справочник", "Справочники", "Справочник.Организации".
Возвращаемое значение
СправочникиМенеджер, СправочникМенеджер, ДокументыМенеджер, ДокументМенеджер, ...
Пример вызова
Результат = ЕХТ_Объект.МенеджерПоИмени(Имя)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает структуру, добавленную в ДополнительныеСвойства, чтобы избежать пересечения по ключам с конфигурацией
Синтаксис
Функция СлужебныеСвойства(Объект) Экспорт
Пример вызова
Результат = ЕХТ_Объект.СлужебныеСвойства(Объект)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает ссылку существующего объекта или созданную ссылку для нового объекта.
Синтаксис
Функция Ссылка(Знач Объект, ЭтоНовый = Неопределено) Экспорт
Параметры
Объект - СправочникОбъект, ... ЭтоНовый - Булево (Возвращаемое значение).
Пример вызова
Результат = ЕХТ_Объект.Ссылка(Объект, ЭтоНовый)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает тип объекта строкой.
Синтаксис
Функция ТипСтр(Знач Объект) Экспорт
Параметры
Объект - ЛюбойОбъект - Объект
Возвращаемое значение
Строка - "Справочник", "Документ" и т.д.
Пример вызова
Результат = ЕХТ_Объект.ТипСтр(Объект)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает таблицу значений с описанием объектов расширений ЕХТ_*
Синтаксис
Функция ТаблицаОбъектов(Отбор = Неопределено) Экспорт
Пример вызова
Результат = ЕХТ_ОбъектыРасширений.ТаблицаОбъектов(Отбор)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Активизирует начальную страницу.
Синтаксис
Процедура АктивизироватьНачальнуюСтраницу() Экспорт
Пример вызова
ЕХТ_Окна.АктивизироватьНачальнуюСтраницу()
Доступность
Тонкий клиент
Восстановление положениe основного окна: Alt+Shift+R https://www.forum.mista.ru/topic.php?id=828077
Синтаксис
Процедура ВосстановитьПоложениеОсновногоОкна() Экспорт
Пример вызова
ЕХТ_Окна.ВосстановитьПоложениеОсновногоОкна()
Доступность
Тонкий клиент
Возвращает имя текущей формы.
Синтаксис
Функция ИмяТекущейФормы() Экспорт
Возвращаемое значение
Строка или Неопределено - имя текущей формы.
Пример вызова
Результат = ЕХТ_Окна.ИмяТекущейФормы()
Доступность
Тонкий клиент
Возвращает текущую форму.
Синтаксис
Функция ТекущаяФорма() Экспорт
Возвращаемое значение
УправляемаяФорма - текущая форма.
Пример вызова
Результат = ЕХТ_Окна.ТекущаяФорма()
Доступность
Тонкий клиент
Выводит сообщение пользователю средствами ОС.
Синтаксис
Процедура ПоказатьСообщение(Знач ТекстСообщения) Экспорт
Параметры
ТекстСообщения - Строка - текст сообщения.
Пример вызова
ЕХТ_ОС.ПоказатьСообщение("Привет, " + Символы.ПС + "Мир!");
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Добавить элемент компоновки в контейнер элементов компоновки.
Синтаксис
Функция ДобавитьЭлемент(ОбластьДобавления, Знач ИмяПоля, Знач ВидСравнения, Знач ПравоеЗначение = Неопределено, Знач Представление = Неопределено, Знач Использование = Неопределено, Знач РежимОтображения = Неопределено, Знач ИдентификаторПользовательскойНастройки = Неопределено) Экспорт
Параметры
ОбластьДобавления - КоллекцияЭлементовОтбораКомпоновкиДанных - контейнер с элементами и группами отбора,
например, Список.Отбор или группа в отборе.
ИмяПоля - Строка - имя поля компоновки данных (заполняется всегда).
ПравоеЗначение - Произвольный - сравниваемое значение.
ВидСравнения - ВидСравненияКомпоновкиДанных - вид сравнения.
Представление - Строка - представление элемента компоновки данных.
Использование - Булево - использование элемента.
РежимОтображения - РежимОтображенияЭлементаНастройкиКомпоновкиДанных - режим отображения.
ИдентификаторПользовательскойНастройки - Строка - см. ОтборКомпоновкиДанных.ИдентификаторПользовательскойНастройки
в синтакс-помощнике.
Возвращаемое значение
ЭлементОтбораКомпоновкиДанных - элемент компоновки.
Пример вызова
Результат = ЕХТ_Отбор.ДобавитьЭлемент(ОбластьДобавления, ИмяПоля, ВидСравнения, ПравоеЗначение, Представление, Использование, РежимОтображения, ИдентификаторПользовательскойНастройки)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Изменить элемент отбора с заданным именем поля или представлением.
Синтаксис
Функция ИзменитьЭлементы(ОбластьПоиска, Знач ИмяПоля = Неопределено, Знач Представление = Неопределено, Знач ПравоеЗначение = Неопределено, Знач ВидСравнения = Неопределено, Знач Использование = Неопределено, Знач РежимОтображения = Неопределено, Знач ИдентификаторПользовательскойНастройки = Неопределено) Экспорт
Параметры
ОбластьПоиска - КоллекцияЭлементовОтбораКомпоновкиДанных - контейнер с элементами и группами отбора,
например, Список.Отбор или группа в отборе.
ИмяПоля - Строка - имя поля компоновки данных (заполняется всегда).
Представление - Строка - представление элемента компоновки данных.
ПравоеЗначение - Произвольный - сравниваемое значение.
ВидСравнения - ВидСравненияКомпоновкиДанных - вид сравнения.
Использование - Булево - использование элемента.
РежимОтображения - РежимОтображенияЭлементаНастройкиКомпоновкиДанных - режим отображения.
ИдентификаторПользовательскойНастройки - Строка - см. ОтборКомпоновкиДанных.ИдентификаторПользовательскойНастройки
в синтакс-помощнике.
Возвращаемое значение
Число - количество измененных элементов.
Пример вызова
Результат = ЕХТ_Отбор.ИзменитьЭлементы(ОбластьПоиска, ИмяПоля, Представление, ПравоеЗначение, ВидСравнения, Использование, РежимОтображения, ИдентификаторПользовательскойНастройки)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Выполняет поиск элемента отбора в коллекции по заданному представлению.
Синтаксис
Функция НайтиЭлементПоПредставлению(КоллекцияЭлементов, Представление) Экспорт
Параметры
КоллекцияЭлементов - КоллекцияЭлементовОтбораКомпоновкиДанных - контейнер с элементами и группами отбора,
например, Список.Отбор.Элементы или группа в отборе.
Представление - Строка - представление группы.
Возвращаемое значение
ЭлементОтбораКомпоновкиДанных - элемент отбора.
Пример вызова
Результат = ЕХТ_Отбор.НайтиЭлементПоПредставлению(КоллекцияЭлементов, Представление)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Найти элемент или группу отбора по заданному имени поля или представлению.
Синтаксис
Функция НайтиЭлементыИГруппы(Знач ОбластьПоиска, Знач ИмяПоля = Неопределено, Знач Представление = Неопределено) Экспорт
Параметры
ОбластьПоиска - ОтборКомпоновкиДанных, КоллекцияЭлементовОтбораКомпоновкиДанных,
ГруппаЭлементовОтбораКомпоновкиДанных - контейнер
с элементами и группами отбора, например Список.Отбор или группа в отборе.
ИмяПоля - Строка - имя поля компоновки (не используется для групп).
Представление - Строка - представление поля компоновки.
Возвращаемое значение
Массив - коллекция отборов.
Пример вызова
Результат = ЕХТ_Отбор.НайтиЭлементыИГруппы(ОбластьПоиска, ИмяПоля, Представление)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Добавить группу отбора в коллекцию КоллекцияЭлементов.
Синтаксис
Функция СоздатьГруппуЭлементов(Знач КоллекцияЭлементов, Представление, ТипГруппы) Экспорт
Параметры
КоллекцияЭлементов - ОтборКомпоновкиДанных, КоллекцияЭлементовОтбораКомпоновкиДанных,
ГруппаЭлементовОтбораКомпоновкиДанных - контейнер
с элементами и группами отбора, например Список.Отбор или группа в отборе.
Представление - Строка - представление группы.
ТипГруппы - ТипГруппыЭлементовОтбораКомпоновкиДанных - тип группы.
Возвращаемое значение
ГруппаЭлементовОтбораКомпоновкиДанных - группа отбора.
Пример вызова
Результат = ЕХТ_Отбор.СоздатьГруппуЭлементов(КоллекцияЭлементов, Представление, ТипГруппы)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Удалить элементы отбора с заданным именем поля или представлением.
Синтаксис
Процедура УдалитьЭлементыГруппы(Знач ОбластьУдаления, Знач ИмяПоля=Неопределено, Знач Представление=Неопределено) Экспорт
Параметры
ОбластьУдаления - КоллекцияЭлементовОтбораКомпоновкиДанных - контейнер с элементами и группами отбора,
например, Список.Отбор или группа в отборе..
ИмяПоля - Строка - имя поля компоновки (не используется для групп).
Представление - Строка - представление поля компоновки.
Пример вызова
ЕХТ_Отбор.УдалитьЭлементыГруппы(ОбластьУдаления, ИмяПоля, Представление)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Добавить или заменить существующий элемент отбора.
Синтаксис
Процедура УстановитьЭлемент(ОбластьПоискаДобавления, Знач ИмяПоля, Знач ПравоеЗначение = Неопределено, Знач ВидСравнения = Неопределено, Знач Представление = Неопределено, Знач Использование = Неопределено, Знач РежимОтображения = Неопределено, Знач ИдентификаторПользовательскойНастройки = Неопределено) Экспорт
Параметры
ОбластьПоискаДобавления - КоллекцияЭлементовОтбораКомпоновкиДанных - контейнер с элементами и группами отбора,
например, Список.Отбор или группа в отборе.
ИмяПоля - Строка - имя поля компоновки данных (заполняется всегда).
ПравоеЗначение - произвольный - сравниваемое значение.
ВидСравнения - ВидСравненияКомпоновкиДанных - вид сравнения.
Представление - Строка - представление элемента компоновки данных.
Использование - Булево - использование элемента.
РежимОтображения - РежимОтображенияЭлементаНастройкиКомпоновкиДанных - режим отображения.
ИдентификаторПользовательскойНастройки - Строка - см. ОтборКомпоновкиДанных.ИдентификаторПользовательскойНастройки
в синтакс-помощнике.
Пример вызова
ЕХТ_Отбор.УстановитьЭлемент(ОбластьПоискаДобавления, ИмяПоля, ПравоеЗначение, ВидСравнения, Представление, Использование, РежимОтображения, ИдентификаторПользовательскойНастройки)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает Истина, если включен режим отладки.
Синтаксис
Функция Включена() Экспорт
Возвращаемое значение
Булево - Истина, если включен режим отладки.
Пример вызова
Результат = ЕХТ_Отладка.Включена()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Выводит в окно сообщений время начала, окончания и длительность замера.
Пример использования:
Замер = ЕХТ_Отладка.Замер("Проверка паузы в две секунды");
ЕХТ_Система.Пауза(2);
ЕХТ_Отладка.Замер(Замер); // здесь выводит длительность
Синтаксис
Функция Замер(Знач ПараметрЗамера = Неопределено, ВывестиСообщение = Истина) Экспорт
Пример вызова
Результат = ЕХТ_Отладка.Замер(ПараметрЗамера, ВывестиСообщение)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Инициализирует компоновщик настроек компоновки данных, с обработкой исключения.
Синтаксис
Процедура ИнициализироватьКомпоновщикНастроек(КомпоновщикНастроек, Схема, Отчет = Неопределено, ВариантОтчета = Неопределено) Экспорт
Параметры
КомпоновщикНастроек - КомпоновщикНастроекКомпоновкиДанных - компоновщик настроек, который необходимо инициализировать. Схема - СхемаКомпоновкиДанных, URL - см. синтакс-помощник: ИсточникДоступныхНастроекКомпоновкиДанных. Отчет - ОтчетОбъект, Неопределено - отчет, чей компоновщик инициализируется. ВариантОтчета - СправочникСсылка.ВариантыОтчета, Неопределено - хранилище варианта отчета.
Пример вызова
ЕХТ_ОтчетыОбработки.ИнициализироватьКомпоновщикНастроек(КомпоновщикНастроек, Схема, Отчет, ВариантОтчета)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Обработки, встроенные в платформу https://infostart.ru/public/369487/ 1. Активные пользователи - "v8res://mngbase/StandardActiveUsers.epf"; 2. Журнал регистрации - "v8res://mngbase/StandardEventLog.epf"; 3. Поиск ссылок на объект - "v8res://mngbase/StandardFindByRef.epf"; 4. Проведение документов - "v8res://mngbase/StandardDocumentsPosting.epf"; 5. Удаление помеченных объектов - "v8res://mngbase/StandardDeleteMarkedObjects.epf"; 6. Управление внешними источниками данных - "v8res://mngbase/StandardExternalDataSourcesManagement.epf"; 7. Управление итогами - "v8res://mngbase/StandardTotalsManagement.epf"; 8. Управление полнотекстовым поиском - "v8res://mngbase/StandardFullTextSearchManagement.epf"; 9. Управление расширениями конфигурации - "v8res://mngbase/StandardExtensionsManagement.epf"; 10. upd. с 8.3.11. Управление системой взаимодействия - "v8res://mngbase/StandardECSRegister.epf" 11. Конструктор запросов на управляемых формах - "v8res://mngbase/QueryWizard.epf";
Синтаксис
Процедура ПодключитьВстроенные() Экспорт
Пример вызова
ЕХТ_ОтчетыОбработки.ПодключитьВстроенные()
Доступность
Сервер, Вызов сервера, Внешнее соединение
Устанавливает отчету переданную схему и на основании ее инициализирует компоновщик настроек. Если контекстом является форма отчета (настроек), то обновляет основной реквизит формы - Отчет. В результате, контекст объекта и формы отчета синхронизируются. Вызывается например, из обработчика ПередЗагрузкойНастроекВКомпоновщик объекта универсального отчета для установки схемы, программно сформированной на основании другого объекта метаданных.
Синтаксис
Процедура ПодключитьСхему(Отчет, Контекст, Схема, КлючСхемы) Экспорт
Параметры
Отчет - ОтчетОбъект, ВнешнийОтчетОбъект - отчет, которому необходимо установить схему.
Контекст - УправляемаяФорма - форма отчета или форма настройки отчета.
Передается "как есть" из одноименного параметра события
ПередЗагрузкойНастроекВКомпоновщик.
- Структура - параметры отчета: см. ВариантыОтчетов.ПодключитьОтчетИЗагрузитьНастройки.
Схема - СхемаКомпоновкиДанных - схема, которую необходимо установить отчету.
КлючСхемы - Строка - идентификатор новой схемы, который будет записан в дополнительные свойства
пользовательских настроек.
Пример вызова
// В обработчике объекта отчета ПередЗагрузкойНастроекВКомпоновщик компоновщик настроек
// инициализируется на основании схемы из общих макетов:
Если КлючСхемы <> "1" Тогда
КлючСхемы = "1";
Схема = ПолучитьОбщийМакет("МояОбщаяСхемаКомпоновки");
ОтчетыСервер.ПодключитьСхему(ЭтотОбъект, Контекст, Схема, КлючСхемы);
КонецЕсли;
Доступность
Сервер, Вызов сервера, Внешнее соединение
Помещает значения перечисления в массив.
Синтаксис
Функция вМассив(Знач Перечисление, Знач ИсключаяЗначения = Неопределено) Экспорт
Параметры
Перечисление - ПеречислениеМенеджер - исходное перечисление. ИсключаяЗначения - Массив, ФиксированныйМассив - значения перечисления, не включаемые в результат.
Возвращаемое значение
Массив - массив элементов типа ПеречислениеСсылка.
Пример вызова
Результат = ЕХТ_Перечисление.вМассив(Перечисление, ИсключаяЗначения)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Помещает значения перечисления в список значений.
Синтаксис
Функция вСписокЗначений(Знач Перечисление, Знач ИсключаяЗначения = Неопределено) Экспорт
Параметры
Перечисление - ПеречислениеМенеджер - исходное перечисление. ИсключаяЗначения - Массив, ФиксированныйМассив - значения перечисления, не включаемые в результат.
Возвращаемое значение
СписокЗначений - список значений элементов типа ПеречислениеСсылка.
Пример вызова
Результат = ЕХТ_Перечисление.вСписокЗначений(Перечисление, ИсключаяЗначения)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Предназначена для получения имени перечисления по значению.
Синтаксис
Функция Имя(Знач ЗначениеПеречисления) Экспорт
Параметры
Элемент перечисления.
Возвращаемое значение
Строка - имя элемента перечисления в метаданных.
Пример вызова
Результат = ЕХТ_Перечисление.Имя(ЗначениеПеречисления)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Предназначена для получения имени элемента перечисления по значению.
Синтаксис
Функция ИмяЗначения(Знач ЗначениеПеречисления) Экспорт
Параметры
Элемент перечисления.
Возвращаемое значение
Строка - имя элемента перечисления в метаданных.
Пример вызова
Результат = ЕХТ_Перечисление.ИмяЗначения(ЗначениеПеречисления)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Предназначена для получения индекса значения перечисления.
Синтаксис
Функция ИндексЗначения(Знач ЗначениеПеречисления) Экспорт
Параметры
Элемент перечисления.
Возвращаемое значение
Число - индекс элемента перечисления в метаданных.
Пример вызова
Результат = ЕХТ_Перечисление.ИндексЗначения(ЗначениеПеречисления)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает признак использования плана обмена в обмене данными. Если план обмена содержит хотя бы один узел кроме предопределенного, то считается, что он используется.
Синтаксис
Функция ОбменДаннымиВключен(Знач ИмяПланаОбмена, Знач Отправитель = Неопределено) Экспорт
Параметры
ИмяПланаОбмена - Строка - имя плана обмена, как оно задано в конфигураторе. Отправитель - ПланОбменаСсылка - Значение параметра устанавливается, если необходимо определить есть ли другие узлы обмена, кроме того, из которого был получен объект.
Возвращаемое значение
Булево. Истина - план обмена используется, Ложь - нет.
Пример вызова
Результат = ЕХТ_ПланыОбмена.ОбменДаннымиВключен(ИмяПланаОбмена, Отправитель)
Доступность
Сервер, Внешнее соединение
Возвращает менеджер объекта по имени. Ограничение: не обрабатываются точки маршрутов бизнес-процессов.
Синтаксис
Функция МенеджерПоИмени(Знач Имя) Экспорт
Параметры
Имя - Строка - имя например, "Справочник", "Справочники", "Справочник.Организации".
Возвращаемое значение
СправочникиМенеджер, СправочникМенеджер, ДокументыМенеджер, ДокументМенеджер, ...
Пример вызова
Результат = ЕХТ_ПовтИспСервер.МенеджерПоИмени(Имя)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает ссылки точек маршрута бизнес-процессов.
Синтаксис
Функция СсылкиТочекМаршрутаБизнесПроцессов() Экспорт
Возвращаемое значение
* Ключ - Тип - тип ТочкаМаршрутаБизнесПроцессаСсылка,
* Значение - Строка - имя бизнес-процесса.
Пример вызова
Результат = ЕХТ_ПовтИспСервер.СсылкиТочекМаршрутаБизнесПроцессов()
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает последние свойства события для указанных События и Объекта Вызывается из обработчиков ПодписокНаСобытие, расположенных в общих модулях расширения ЕХТ_Подписки
Синтаксис
Функция ПолучитьСвойстваСобытия(Знач Объект, Знач Событие) Экспорт
Пример вызова
Результат = ЕХТ_Подписки.ПолучитьСвойстваСобытия(Объект, Событие)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Сохраняет свойства события в объекте, если у него есть ДополнительныеСвойства, или в СписокСвойствСобытийОбъектов. Вызывается из обработчиков событий в расширении ЕХТ_Подписки
Синтаксис
Процедура СохранитьСвойстваСобытия(Знач СвойстваСобытия) Экспорт
Пример вызова
ЕХТ_Подписки.СохранитьСвойстваСобытия(СвойстваСобытия)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Удаляет последние свойства события для указанных События и Объекта Вызывается из ОбработчикСобытияПосле
Синтаксис
Процедура УдалитьСвойстваСобытия(Знач СвойстваСобытия) Экспорт
Пример вызова
ЕХТ_Подписки.УдалитьСвойстваСобытия(СвойстваСобытия)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Вызывается из обработчиков ПодписокНаСобытие, расположенных в общих модулях расширения ЕХТ_Подписки
Синтаксис
Функция ЭтоОбработчикПодпискиНаСобытие(СвойстваСобытия, Знач Событие, Знач Обработчик) Экспорт
Пример вызова
Результат = ЕХТ_Подписки.ЭтоОбработчикПодпискиНаСобытие(СвойстваСобытия, Событие, Обработчик)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает уникальный идентификатор пользователя ИБ.
Синтаксис
Функция ИдентификаторТекущегоПользователяИБ() Экспорт
Пример вызова
Результат = ЕХТ_Пользователи.ИдентификаторТекущегоПользователяИБ()
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает количество пользователей.
Синтаксис
Функция Количество() Экспорт
Пример вызова
Результат = ЕХТ_Пользователи.Количество()
Доступность
Сервер, Вызов сервера, Внешнее соединение
Обновление прав на расширение для пользователей ИБ.
Синтаксис
Процедура ОбновитьРолиРасширения() Экспорт
Пример вызова
ЕХТ_Пользователи.ОбновитьРолиРасширения()
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает свойства текущего пользователя.
Синтаксис
Функция СвойстваТекущегоПользователяИБ() Экспорт
Пример вызова
Результат = ЕХТ_Пользователи.СвойстваТекущегоПользователяИБ()
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает текущего пользователя. Рекомендуется использовать в коде, который не поддерживает работу с внешними пользователями. Если вход в сеанс выполнил внешний пользователь, тогда будет вызвано исключение.
Синтаксис
Функция ТекущийПользователь() Экспорт
Возвращаемое значение
СправочникСсылка.Пользователи - пользователь.
Пример вызова
Результат = ЕХТ_Пользователи.ТекущийПользователь()
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает хеш пароля. https://infostart.ru/public/326063/
Синтаксис
Функция ХешПароля(Знач Пароль) Экспорт
Пример вызова
Результат = ЕХТ_Пользователи.ХешПароля(Пароль)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Проверяет что у первого и второго паролей совпадают первые или вторые хеш-суммы.
Синтаксис
Функция ХешСуммаПароляСовпадает(СохраняемоеЗначениеПервогоПароля, СохраняемоеЗначениеВторогоПароля) Экспорт
Параметры
СохраняемоеЗначениеПервогоПароля - Строка - содержит хеш-суммы сохраняемого пароля в формате
одноименного свойства типа ПользовательИнформационнойБазы.
СохраняемоеЗначениеВторогоПароля - Строка - то же, что и СохраняемоеЗначениеВторогоПароля.
Пример вызова
Результат = ЕХТ_Пользователи.ХешСуммаПароляСовпадает(СохраняемоеЗначениеПервогоПароля, СохраняемоеЗначениеВторогоПароля)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Проверяет, является ли текущий или указанный пользователь полноправным.
Полноправным считается пользователь, который:
а) при непустом списке пользователей информационной базы
имеет роль ПолныеПрава и роль для администрирования системы (если ПроверятьПраваАдминистрированияСистемы = Истина);
б) при пустом списке пользователей информационной базы
основная роль конфигурации не задана или ПолныеПрава.
Синтаксис
Функция ЭтоПолноправныйПользователь(Пользователь = Неопределено,
ПроверятьПраваАдминистрированияСистемы = Ложь,
УчитыватьПривилегированныйРежим = Истина) Экспорт
Параметры
Пользователь - Неопределено - проверяется текущий пользователь ИБ.
- СправочникСсылка.Пользователи, СправочникСсылка.ВнешниеПользователи - осуществляется
поиск пользователя ИБ по уникальному идентификатору, заданному в реквизите
ИдентификаторПользователяИБ. Если пользователь ИБ не найден, возвращается Ложь.
- ПользовательИнформационнойБазы - проверяется указанный пользователь ИБ.
ПроверятьПраваАдминистрированияСистемы - Булево - если задано Истина, тогда проверяется наличие
роли для администрирования системы.
УчитыватьПривилегированныйРежим - Булево - если задано Истина, тогда для текущего пользователя
функция возвращает Истина, когда установлен привилегированный режим.
Возвращаемое значение
Булево - если Истина, пользователь является полноправным.
Пример вызова
Результат = ЕХТ_Пользователи.ЭтоПолноправныйПользователь(Пользователь, ПроверятьПраваАдминистрированияСистемы, УчитыватьПривилегированныйРежим)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Разбирает строку с адресами электронной почты. При разборе проверяет корректность адресов.
Синтаксис
Функция АдресаИзСтроки(Знач СписокАдресов) Экспорт
Параметры
СписокАдресов - Строка - адреса электронной почты, разделитель - запятая, либо точка с запятой:
Получатель1 <Адрес1>, Получатель 2 <Адрес2>... Получатель N <АдресN>.
Возвращаемое значение
Массив - содержит массив структур адресов.
Поля структуры:
Псевдоним - Строка - представление адресата.
Адрес - Строка - найденный и соответствующий требованиям почтовый адрес.
Если текст, похожий на адрес найден, но не соответствует требованиям
стандартов, то такой текст записывается в поле "Псевдоним".
ОписаниеОшибки - Строка - текстовое представление ошибки, либо пустая строка, если ошибок нет.
Пример вызова
Результат = ЕХТ_Почта.АдресаИзСтроки(СписокАдресов)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Функция проверяет, что введенная строка с email-адресами введена правильно. Формат строки: Z = ИмяПользователя|[Имя Пользователя] [<]пользователь@почтовый_сервер[>], Строка = Z[<разделитель*>Z]. Прим.: разделитель* - имеется ввиду любой разделитель адресов.
Синтаксис
Функция РазобратьСтрокуСАдресами(Знач СтрокаПереданныхАдресов, Знач ВызыватьИсключение = Истина) Экспорт
Параметры
СтрокаПереданныхАдресов - Строка - правильная строка с почтовыми адресами. ВызыватьИсключение - Булево - необходимо передать Ложь, чтобы в случае неуспешного разбора не выдавалось исключение.
Возвращаемое значение
Структура:
* Статус - Булево - успех или неуспех преобразования.
* Значение - Массив - (параметр доступен, если Статус = Истина) коллекция адресов в виде структур:
** Адрес - Строка - e-mail получателя.
** Представление - Строка - имя получателя.
* СообщениеОбОшибке - Строка - (параметр доступен, если Статус = Ложь) информация об ошибке.
ВАЖНО: Функция возвращает массив структур, в которых одно поле (любое)
может быть незаполнено. Может использоваться различными
подсистемами для собственного сопоставления имени пользователя
некому email-адресу. Поэтому необходимо перед непосредственной
отправкой проверить, что поле почтового адреса заполнено.
Пример вызова
Результат = ЕХТ_Почта.РазобратьСтрокуСАдресами(СтрокаПереданныхАдресов, ВызыватьИсключение)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Проверяет email-адрес на соответствие требованиям стандартов RFC 5321, RFC 5322, а также RFC 5335, RFC 5336 и RFC 3696. Кроме того, функция ограничивает использование спецсимволов.
Синтаксис
Функция ЭтоАдрес(Знач Адрес, Знач РазрешитьЛокальныеАдреса = Ложь) Экспорт
Параметры
Адрес - Строка - проверяемый email. РазрешитьЛокальныеАдреса - Булево - не выдавать ошибку в случае отсутствия зоны домена в адресе.
Возвращаемое значение
Булево - Истина, если ошибок нет.
Пример вызова
Результат = ЕХТ_Почта.ЭтоАдрес(Адрес, РазрешитьЛокальныеАдреса)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Вызывает исключение, если тип значения параметра ИмяПараметра процедуры или функции ИмяПроцедурыИлиФункции отличается от ожидаемого. Для быстрой диагностики типов параметров, передаваемых в процедуры и функции программного интерфейса. В связи с особенностью реализации ОписанияТипов всегда включает в себя тип <Неопределено>. если требуется жесткая проверка типа, используйте в параметре ОжидаемыеТипы конкретный тип, массив или соответствие типов.
Синтаксис
Процедура Параметр(Знач ИмяПроцедурыИлиФункции, Знач ИмяПараметра, Знач ЗначениеПараметра, Знач ОжидаемыеТипы, Знач ОжидаемыеТипыСвойств = Неопределено) Экспорт
Параметры
ИмяПроцедурыИлиФункции - Строка - имя процедуры или функции, параметр которой проверяется.
ИмяПараметра - Строка - имя проверяемого параметра процедуры или функции.
ЗначениеПараметра - Произвольный - фактическое значение параметра.
ОжидаемыеТипы - ОписаниеТипов, Тип, Массив, ФиксированныйМассив, Соответствие, ФиксированноеСоответствие - тип(ы)
параметра процедуры или функции.
ОжидаемыеТипыСвойств - Структура - если ожидаемый тип - структура, то
в этом параметре можно указать типы ее свойств.
Пример вызова
ЕХТ_Проверка.Параметр(ИмяПроцедурыИлиФункции, ИмяПараметра, ЗначениеПараметра, ОжидаемыеТипы, ОжидаемыеТипыСвойств)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Вызывает исключение с текстом Сообщение, если Условие не равно Истина. Применяется для самодиагностики кода.
Синтаксис
Процедура Условие(Знач Условие, Знач Сообщение = "", Знач КонтекстПроверки = "") Экспорт
Параметры
Условие - Булево - если не равно Истина, то вызывается исключение. КонтекстПроверки - Строка - например, имя процедуры или функции, в которой выполняется проверка. Сообщение - Строка - текст сообщения. Если не задан, то исключение вызывается с сообщением по умолчанию.
Пример вызова
ЕХТ_Проверка.Условие(Условие, Сообщение, КонтекстПроверки)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает результат проверки условий. Если значение реквизита отсутствует, то условие не проверяется.
Условия - массив структур с полями
Реквизит - Строка - имя реквизита объекта;
Значение - Произвольный - значение реквизита объекта;
СравнитьВерсии - Булево - проверять условие через СравнитьВерсии
ВидСравнения - ВидСравнения - вид сравнения значений. Допустимые для использования виды:
Равно, НеРавно, Больше, БольшеИлиРавно, Меньше, МеньшеИлиРавно,
ВСписке, НеВСписке, Заполнено, НеЗаполнено.
Значение по умолчанию - Равно.
ЗначенияРеквизитов - структура, в ключе имя реквизита, в значении - значение
Синтаксис
Функция УсловияВыполняются(Знач Условия, Знач ЗначенияРеквизитов) Экспорт
Пример вызова
Условия = Новый Массив;
Условия.Добавить(Новый Структура("Реквизит,ВидСравнения,Значение", "Результат", "=", 0));
Значения = Новый Структура("Результат", 1);
ЕХТ.СообщитьПользователю(ЕХТ_Проверка.УсловияВыполняются(Условия, Значения)); // Выводит Нет
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Преобразует РасписаниеРегламентногоЗадания в структуру.
Синтаксис
Функция вСтруктуру(Знач Расписание) Экспорт
Параметры
Расписание - РасписаниеРегламентногоЗадания - исходное расписание.
Возвращаемое значение
Структура - расписание в виде структуры.
Пример вызова
Результат = ЕХТ_Расписание.вСтруктуру(Расписание)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает Истина, если полученный параметр является заполненным Расписанием
Синтаксис
Функция Заполнено(Знач Расписание) Экспорт
Параметры
Расписание - РасписаниеРегламентногоЗадания - проверяемое расписание.
Возвращаемое значение
Булево - Истина, если расписание заполнено и Ложь если нет.
Пример вызова
Результат = ЕХТ_Расписание.Заполнено(Расписание)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Преобразует структуру в РасписаниеРегламентногоЗадания.
Синтаксис
Функция ИзСтруктуры(Знач Структура) Экспорт
Параметры
СтруктураРасписания - Структура - расписание в виде структуры.
Возвращаемое значение
РасписаниеРегламентногоЗадания - расписание.
Пример вызова
Результат = ЕХТ_Расписание.ИзСтруктуры(Структура)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает расписание без повторов.
Синтаксис
Функция НеПовторять() Экспорт
Пример вызова
Результат = ЕХТ_Расписание.НеПовторять()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает расписание с периодом повтора в минутах.
Синтаксис
Функция ПовторятьКаждуюМинуту(Знач Минуты = 1) Экспорт
Пример вызова
Результат = ЕХТ_Расписание.ПовторятьКаждуюМинуту(Минуты)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает расписание с периодом повтора "каждый день, один раз в день"
Синтаксис
Функция ПовторятьКаждыйДень() Экспорт
Пример вызова
Результат = ЕХТ_Расписание.ПовторятьКаждыйДень()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает расписание с периодом повтора в часах.
Синтаксис
Функция ПовторятьКаждыйЧас(Знач Часы = 1) Экспорт
Пример вызова
Результат = ЕХТ_Расписание.ПовторятьКаждыйЧас(Часы)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает расписание с периодом повтора в минутах.
Синтаксис
Функция ПовторятьПоМинутам(Знач Минуты = 1) Экспорт
Пример вызова
Результат = ЕХТ_Расписание.ПовторятьПоМинутам(Минуты)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает расписание с периодом повтора в часах.
Синтаксис
Функция ПовторятьПоЧасам(Знач Часы = 1) Экспорт
Пример вызова
Результат = ЕХТ_Расписание.ПовторятьПоЧасам(Часы)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает представление расписания.
Синтаксис
Функция Представление(Знач Расписание) Экспорт
Параметры
Расписание - РасписаниеРегламентногоЗадания - исходное расписание.
Возвращаемое значение
Строка - представление расписания.
Пример вызова
Результат = ЕХТ_Расписание.Представление(Расписание)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает следующую дата выполнения расписания.
Синтаксис
Функция СледующаяДата(Знач Расписание, Знач ДатаДляПроверки, Знач ДатаНачалаПоследнегоЗапуска = Неопределено, Знач ДатаЗавершенияПоследнегоЗапуска = Неопределено, Знач МаксимальныйГоризонтПланирования = Неопределено) Экспорт
Параметры
Расписание - РасписаниеРегламентногоЗадания - расписание по которому будет рассчитываться дата. ДатаДляПроверки - Дата - минимальная дата на которую может быть запланировано выполнение. ДатаНачалаПоследнегоЗапуска - Дата - Дата начала последнего запуска задания. Если дата задана, то используется для проверки таких условий как ПериодПовтораДней, ПериодНедель, ПериодПовтораВТечениеДня. Если дата не задана, то считается, что задание не выполнялось ни разу и проверка этих условий не производится. ДатаЗавершенияПоследнегоЗапуска - Дата - Дата завершения последнего запуска задания. Если дата задана, то используется для проверки условия ПаузаПовтора. Если дата не задана, то считается, что задание ни разу не завершалось, и проверка этого условия не производится. МаксимальныйГоризонтПланирования - Число - Максимальное количество секунд относительно ДатаДляПроверки на которое может быть выполнено планирование. Увеличение значения может привести к замедлению расчета на сложных расписаниях.
Возвращаемое значение
Дата - следующая дата выполнения расписания.
Пример вызова
Результат = ЕХТ_Расписание.СледующаяДата(Расписание, ДатаДляПроверки, ДатаНачалаПоследнегоЗапуска, ДатаЗавершенияПоследнегоЗапуска, МаксимальныйГоризонтПланирования)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает значение указанного свойства объекта или коллекции.
Синтаксис
Функция Значение(Знач Источник, Знач Свойство, Знач ЗначениеПоУмолчанию = NULL) Экспорт
Пример вызова
Результат = ЕХТ_Свойства.Значение(Источник, Свойство, ЗначениеПоУмолчанию)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает Истина если значение свойства равно переданному значению.
Синтаксис
Функция ЗначениеРавно(Знач Источник, Знач Свойство, Знач Значение) Экспорт
Пример вызова
Результат = ЕХТ_Свойства.ЗначениеРавно(Источник, Свойство, Значение)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает Истина если свойство существует и его значение заданного типа.
Синтаксис
Функция ЗначениеСТипом(Знач Источник, Знач Свойство, Знач Тип) Экспорт
Пример вызова
Результат = ЕХТ_Свойства.ЗначениеСТипом(Источник, Свойство, Тип)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает структуру со значениями указанных свойств объекта или коллекции.
Синтаксис
Функция Значения(Знач Источник, Знач СписокСвойств, Знач ИсключаяСвойства = Неопределено) Экспорт
Пример вызова
Результат = ЕХТ_Свойства.Значения(Источник, СписокСвойств, ИсключаяСвойства)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает Истина если у источника есть такое свойство. В параметре ЗначениеСвойства возвращается значение.
Синтаксис
Функция Существует(Знач Источник, Знач Свойство, ЗначениеСвойства = Неопределено) Экспорт
Пример вызова
Результат = ЕХТ_Свойства.Существует(Источник, Свойство, ЗначениеСвойства)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Завершает процесс ОС по идентификатору.
Синтаксис
Процедура ЗавершитьПроцессОС(Знач ИдентификаторПроцесса) Экспорт
Пример вызова
ЕХТ_Система.ЗавершитьПроцессОС(ИдентификаторПроцесса)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Запускает внешнюю программу в соответствии с параметрами запуска. Не доступно в веб-клиенте.
Синтаксис
Функция ЗапуститьПрограмму(Знач СтрокаКоманды, ПараметрыЗапускаПрограммы = Неопределено) Экспорт
Параметры
СтрокаКоманды - Строка - Командная строка для запуска программы. ПараметрыЗапускаПрограммы - Структура, Неопределено - см. функцию ПараметрыЗапускаПрограммы.
Возвращаемое значение
Структура - Результат работы программы.
КодВозврата - Число - код возврата программы.
ПотокВывода - Строка - результат работы программы, направленный в поток stdout.
ПотокОшибок - Строка - ошибки исполнения программы, направленные в поток stderr.
Пример вызова
ОбщегоНазначенияКлиентСервер.ЗапуститьПрограмму("calc");
ПараметрыЗапускаПрограммы = ОбщегоНазначенияКлиентСервер.ПараметрыЗапускаПрограммы();
ПараметрыЗапускаПрограммы.ВыполнитьСНаивысшимиПравами = Истина;
ОбщегоНазначенияКлиентСервер.ЗапуститьПрограмму("C:\Program Files\1cv8\common\1cestart.exe",
ПараметрыЗапускаПрограммы);
ПараметрыЗапускаПрограммы = ОбщегоНазначенияКлиентСервер.ПараметрыЗапускаПрограммы();
ПараметрыЗапускаПрограммы.ДождатьсяЗавершения = Истина;
Результат = ОбщегоНазначенияКлиентСервер.ЗапуститьПрограмму("ping 127.0.0.1 -n 5", ПараметрыЗапускаПрограммы);
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Выполняет регистрацию компоненты "comcntr.dll" для текущей версии платформы. В случае успешной регистрации, предлагает пользователю перезапустить клиентский сеанс для того чтобы регистрация вступила в силу. Вызывается перед клиентским кодом, который использует менеджер COM-соединений (V83.COMConnector) и инициируется интерактивными действиями пользователя.
Синтаксис
Функция ЗарегистрироватьCOMСоединитель(ИмяФайла = Неопределено) Экспорт
Параметры
ВыполнитьПерезагрузкуСеанса - Булево - если Истина, то после регистрации компоненты будет вызван диалог перезапуска сеанса.
Пример вызова
ЗарегистрироватьCOMСоединитель();
// далее идет код, использующий менеджер COM-соединений (V83.COMConnector).
// ...
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает идентификатор процесса ОС.
Синтаксис
Функция ИдентификаторПроцессаОС() Экспорт
Пример вызова
Результат = ЕХТ_Система.ИдентификаторПроцессаОС()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает полный путь к каталогу C:\Users\User\AppData\Local\
Синтаксис
Функция КаталогAppData() Экспорт
Пример вызова
Результат = ЕХТ_Система.КаталогAppData()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает полный путь к каталогу C:\ProgramData\
Синтаксис
Функция КаталогProgramData() Экспорт
Пример вызова
Результат = ЕХТ_Система.КаталогProgramData()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает полный путь к каталогу C:\Users\Andrey\AppData\Roaming\
Синтаксис
Функция КаталогRoaming() Экспорт
Пример вызова
Результат = ЕХТ_Система.КаталогRoaming()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает Истина, если клиентское приложение подключено к базе через веб-сервер.
Синтаксис
Функция КлиентПодключенЧерезВебСервер() Экспорт
Возвращаемое значение
Булево - Истина, если подключен.
Пример вызова
Результат = ЕХТ_Система.КлиентПодключенЧерезВебСервер()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает кодировку стандартных поток вывода и ошибок, используемую в текущей ОС.
Синтаксис
Функция КодировкаСтандартныхПотоков() Экспорт
Возвращаемое значение
КодировкаТекста - кодировка стандартных потоков вывода и ошибок.
Пример вызова
Результат = ЕХТ_Система.КодировкаСтандартныхПотоков()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Синтаксис
Функция ПараметрыЗапускаПрограммы() Экспорт
Возвращаемое значение
Структура - где:
* ТекущийКаталог - Строка - Задает текущий каталог запускаемого приложения.
* Оповещение - ОписаниеОповещения - оповещение о результате завершения запущенного приложения,
если оповещение не задано в случае ошибки будет показано предупреждение.
- Результат - Структура - результат работы программы:
-- ПриложениеЗапущено - Булево - Истина, если внешнее приложение не вызвало ошибок при открытии.
-- ОписаниеОшибки - Строка - краткое описание ошибки. При отмене пользователем пустая строка.
-- КодВозврата - Число - код возврата программы.
-- ПотокВывода - Строка - результат работы программы, направленный в поток stdout.
В веб-клиенте всегда принимает значение "".
-- ПотокОшибок - Строка - ошибки исполнения программы, направленные в поток stderr.
В веб-клиенте всегда принимает значение "".
- ДополнительныеПараметры - Произвольный - значение, которое было указано при создании объекта ОписаниеОповещения.
* ДождатьсяЗавершения - Булево - Истина, дожидаться завершения запущенного приложения перед продолжением работы.
* ПолучитьПотокВывода - Булево - Ложь - результат, направленный в поток stdout,
если не указан ДождатьсяЗавершения - игнорируется.
* ПолучитьПотокОшибок - Булево - Ложь - ошибки, направленные в поток stderr,
если не указан ДождатьсяЗавершения - игнорируется.
* КодировкаИсполнения - Строка, Число - Кодировка, устанавливаемая в Windows с помощью команды chcp.
в Linux и MacOS игнорируется. Возможные значения "OEM", "CP866", "UTF8" или номер кодовой страницы.
* ВыполнитьСНаивысшимиПравами - Булево - Истина, если требуется запустить программу на исполнение
с повышением привилегий системы:
- Windows: запрос UAC;
- Linux: исполнение с командой pkexec;
- macOS, веб-клиент и мобильный клиент: будет возвращено Результат.ОписаниеОшибки.
Пример вызова
Результат = ЕХТ_Система.ПараметрыЗапускаПрограммы()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Останавливает выполнение кода на заданное время.
Синтаксис
Процедура Пауза(Знач КоличествоСекунд) Экспорт
Параметры
КоличествоСекунд - Число - время ожидания в секундах.
Пример вызова
ЕХТ_Система.Пауза(КоличествоСекунд)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Проверяет содержит ли строка команды опасные действия
Синтаксис
Функция СодержитНебезопасныеДействия(СтрокаКоманды) Экспорт
Пример вызова
Результат = ЕХТ_Система.СодержитНебезопасныеДействия(СтрокаКоманды)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает массив структур с описаниями дисков.
Синтаксис
Функция СписокДисковWindows() Экспорт
Пример вызова
Результат = ЕХТ_Система.СписокДисковWindows()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает Истина, если клиентское приложение является мобильным клиентом.
Синтаксис
Функция ЭтоМобильныйКлиент() Экспорт
Возвращаемое значение
Булево - если нет клиентского приложения, возвращается Ложь.
Пример вызова
Результат = ЕХТ_Система.ЭтоМобильныйКлиент()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Проверяет, что выполнение происходит на учебной платформе, на которой, например, недоступно получение свойства ПользовательОС.
Синтаксис
Функция ЭтоУчебнаяПлатформа() Экспорт
Пример вызова
Результат = ЕХТ_Система.ЭтоУчебнаяПлатформа()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Показывает диалог выбора каталога.
Синтаксис
Процедура ВыбратьКаталог(ОбработчикЗавершения, Заголовок = "") Экспорт
Параметры
ОбработчикЗавершения - ОписаниеОповещения - содержит описание процедуры, которая будет вызвана после
закрытия диалога выбора со следующими параметрами:
- ПутьККаталогу - Строка - полный путь к каталогу. Если не установлено расширение работы с файлами
или пользователь отказался от выбора, возвращает пустую строку.
- ДополнительныеПараметры - значение, которое было указано при создании объекта ОписаниеОповещения.
Заголовок - Строка - заголовок диалога выбора каталога.
Пример вызова
ЕХТ_СистемаКлиент.ВыбратьКаталог(ОбработчикЗавершения, Заголовок)
Доступность
Тонкий клиент
Показывает диалог выбора файла и помещает выбранный файл во временное хранилище. Совмещает работу методов глобального контекста НачатьПомещениеФайла и НачатьПомещениеФайлов, возвращая идентичный результат вне зависимости от того, подключено расширение работы с файлами или нет. Ограничения: Не используется для выбора каталогов - эта опция не поддерживается веб-клиентом.
Синтаксис
Процедура ЗагрузитьФайл( ОбработчикЗавершения, ПараметрыЗагрузки = Неопределено, ИмяФайла = "", АдресВоВременномХранилище = "") Экспорт
Параметры
ОбработчикЗавершения - ОписаниеОповещения - содержит описание процедуры, которая будет вызвана после
загрузки файла со следующими параметрами:
* ПомещенныйФайл - Неопределено - пользователь отказался от выбора.
- Структура - пользователь выбрал файл.
** Хранение - Строка - расположение данных во временном хранилище.
** Имя - Строка - в тонком клиенте и в веб-клиенте с установленным
расширением работы с файлами - локальный путь, по которому
был получен файл. В веб-клиенте без расширения работы с
файлами - имя файла с расширением.
* ДополнительныеПараметры - Произвольный - значение, которое было указано при создании объекта
ОписаниеОповещения.
ПараметрыЗагрузки - Структура - См. ПараметрыЗагрузкиФайла.
ИмяФайла - Строка - полный путь к файлу, который будет предложен пользователю в начале
интерактивного выбора или помещен во временное хранилище в неинтерактивном. Если
выбран неинтерактивный режим и параметр не заполнен, будет вызвано исключение.
АдресВоВременномХранилище - Строка - адрес, по которому будет сохранен файл.
Пример вызова
Оповещение = Новый ОписаниеОповещения("ВыбратьФайлПослеПомещенияФайла", ЭтотОбъект, Контекст);
ПараметрыЗагрузки = ПараметрыЗагрузкиФайла();
ПараметрыЗагрузки.ИдентификаторФормы = УникальныйИдентификатор;
ЗагрузитьФайл(Оповещение, ПараметрыЗагрузки);
Доступность
Тонкий клиент
Показывает диалог выбора файлов и помещает выбранные файлы во временное хранилище. Совмещает работу методов глобального контекста НачатьПомещениеФайла и НачатьПомещениеФайлов, возвращая идентичный результат вне зависимости от того, подключено расширение работы с файлами или нет. Ограничения: Не используется для выбора каталогов - эта опция не поддерживается веб-клиентом. Не поддерживается множественный выбор в веб-клиенте, если не установлено расширение работы с файлами.
Синтаксис
Процедура ЗагрузитьФайлы( ОбработчикЗавершения, ПараметрыЗагрузки = Неопределено, ЗагружаемыеФайлы = Неопределено) Экспорт
Параметры
ОбработчикЗавершения - ОписаниеОповещения - содержит описание процедуры, которая будет вызвана после
загрузки файлов со следующими параметрами:
* ПомещенныеФайлы - Неопределено - пользователь отказался от выбора.
- Массив - Содержит объекты типа Структура. Пользователь выбрал файл.
** Хранение - Строка - расположение данных во временном хранилище.
** Имя - Строка - в тонком клиенте и в веб-клиенте с установленным
расширением работы с файлами - локальный путь, по которому
был получен файл. В веб-клиенте без расширения работы с
файлами - имя файла с расширением.
** ПолноеИмя - Строка - в тонком клиенте и в веб-клиенте с установленным
расширением работы с файлами - локальный путь, по которому
был получен файл. В веб-клиенте без расширения работы с файлами
принимает значение "".
** ИмяФайла - Строка - имя файла с расширением.
* ДополнительныеПараметры - Произвольный - значение, которое было указано при создании объекта ОписаниеОповещения.
ПараметрыЗагрузки - Структура - См. ПараметрыЗагрузкиФайла.
ЗагружаемыеФайлы - Массив - содержит объекты типа ОписаниеПередаваемогоФайла. Может быть заполнен полностью,
в этом случае загружаемые файлы будут сохранены по указанным адресам. Может быть заполнен
частично - у элементов массива заполнены только имена. В этом случае, загружаемые файлы будут
размещены в новых временных хранилищах. Массив может быть не заполнен. В этом случае набор
помещаемых файлов определяется по значениям, указанным в параметре ПараметрыЗагрузки. Если в
параметрах загрузки выбран неинтерактивный режим и параметр ЗагружаемыеФайлы не заполнен, будет
вызвано исключение.
Пример вызова
Оповещение = Новый ОписаниеОповещения("ЗагрузитьРасширениеПослеПомещенияФайлов", ЭтотОбъект, Контекст);
ПараметрыЗагрузки = ПараметрыЗагрузкиФайла();
ПараметрыЗагрузки.ИдентификаторФормы = УникальныйИдентификатор;
ЗагрузитьФайлы(Оповещение, ПараметрыЗагрузки);
Доступность
Тонкий клиент
Запускает внешнюю программу в соответствии с параметрами запуска.
Синтаксис
Процедура ЗапуститьПрограмму(Знач КомандаЗапуска, ПараметрыЗапускаПрограммы = Неопределено) Экспорт
Параметры
КомандаЗапуска - Строка - командная строка для запуска программы.
- Массив - первый элемент массива, путь к исполняемому приложению,
если Массив, то первый элемент массива - путь к исполняемому приложению, остальные - передаваемые параметры,
массив соответствует тому, который получит вызываемая программа в argv.
ПараметрыЗапускаПрограммы - Структура - См. ПараметрыЗапускаПрограммы
Пример вызова
ЕХТ_СистемаКлиент.ЗапуститьПрограмму(КомандаЗапуска, ПараметрыЗапускаПрограммы)
Доступность
Тонкий клиент
Открывает навигационную ссылку в программе, которая ассоциирована с протоколом навигационной ссылки. Допустимые протоколы: http, https, e1c, v8help, mailto, tel, skype. Для открытия проводника или файла в программе просмотра не следует формировать ссылку по протоколу file:// - для открытия проводника см. ОткрытьПроводник. - для открытия файла по расширению см. ОткрытьФайлВПрограммеПросмотра.
Синтаксис
Процедура ОткрытьНавигационнуюСсылку(НавигационнаяСсылка, Знач Оповещение = Неопределено) Экспорт
Параметры
НавигационнаяСсылка - Строка - ссылка, которую требуется открыть.
Оповещение - ОписаниеОповещения - оповещение о результате открытия.
если оповещение не задано, в случае ошибки будет показано предупреждение.
- ПриложениеЗапущено - Булево - Истина, если внешнее приложение не вызвало ошибок при открытии.
- ДополнительныеПараметры - Произвольный - значение, которое было указано при создании объекта ОписаниеОповещения.
Пример вызова
ОткрытьНавигационнуюСсылку("e1cib/navigationpoint/startpage"); // начальная страница.
ОткрытьНавигационнуюСсылку("v8help://1cv8/QueryLanguageFullTextSearchInData");
ОткрытьНавигационнуюСсылку("https://1c.ru");
ОткрытьНавигационнуюСсылку("mailto:help@1c.ru");
ОткрытьНавигационнуюСсылку("skype:echo123?call");
Доступность
Тонкий клиент
Открывает проводник с указанным путем. Если передан путь к файлу, то выполняет позиционирование курсора в проводнике на этом файле.
Синтаксис
Процедура ОткрытьПроводник(ПутьККаталогуИлиФайлу) Экспорт
Параметры
ПутьККаталогуИлиФайлу - Строка - полный путь к файлу или каталогу на диске.
Пример вызова
// Для Windows
ОткрытьПроводник("C:\Users");
ОткрытьПроводник("C:\Program Files\1cv8\common\1cestart.exe");
// Для Linux
ОткрытьПроводник("/home/");
ОткрытьПроводник("/opt/1C/v8.3/x86_64/1cv8c");
Доступность
Тонкий клиент
Открывает файл для просмотра или редактирования. Если файл открывается из двоичных данных во временном хранилище, предварительно сохраняет его во временный каталог.
Синтаксис
Процедура ОткрытьФайл( РасположениеФайла, ОбработчикЗавершения = Неопределено, ИмяФайла = "", ПараметрыОткрытия = Неопределено) Экспорт
Параметры
РасположениеФайла - Строка - полный путь к файлу в файловой системе или адрес данных файла
во временном хранилище.
ОбработчикЗавершения - ОписаниеОповещения, Неопределено - описание процедуры, принимающей результат работы
метода, с параметрами:
* ФайлИзменен - Булево - изменен файл на диске или двоичные данные во временном хранилище.
* ДополнительныеПараметры - Произвольный - значение, которое было указано при создании объекта
ОписаниеОповещения.
ИмяФайла - Строка - имя файла с расширением или расширение файла без точки. Если
параметр РасположениеФайла содержит адрес во временном хранилище и параметр
ИмяФайла не заполнен, будет вызвано исключение.
ПараметрыОткрытия - Структура - см. ПараметрыОткрытияФайла.
Пример вызова
ЕХТ_СистемаКлиент.ОткрытьФайл(РасположениеФайла, ОбработчикЗавершения, ИмяФайла, ПараметрыОткрытия)
Доступность
Тонкий клиент
Инициализирует структуру параметров для загрузки файла из файловой системы. Для использования в ЗагрузитьФайл и ЗагрузитьФайлы
Синтаксис
Функция ПараметрыЗагрузкиФайла() Экспорт
Возвращаемое значение
Структура - со свойствами:
* ИдентификаторФормы - УникальныйИдентификатор - уникальный идентификатор формы, из
которой выполняется размещение файла. Если параметр не заполнен,
необходимо вызывать метод глобального контекста УдалитьИзВременногоХранилища
после завершения работы с полученными двоичными данными. Значение по
умолчанию - Неопределено.
* Интерактивно - Булево - указывает использование интерактивного режима, при котором
пользователю показывается диалог выбора файлов. Значение по
умолчанию - Истина.
* Диалог - ДиалогВыбораФайла - свойства см. в синтакс-помощнике.
Используется, если свойство Интерактивно принимает значение Истина и
удалось подключить расширение работы с файлами.
* ТекстПредложения - Строка - текст предложения об установке расширения. Если параметр
принимает значение "", будет выведен стандартный текст предложения.
Значение по умолчанию - "".
* ДействиеПередНачаломПомещенияФайлов - ОписаниеОповещения, Неопределено - содержит описание процедуры,
которая будет вызвана непосредственно перед началом помещения файла
во временное хранилище.Если параметр принимает значение Неопределено,
перед помещением файла никакая процедура вызываться не будет. Значение
по умолчанию - Неопределено. Параметры вызываемой процедуры:
** ПомещаемыеФайлы - СсылкаНаФайл, Массив - ссылка на файл, готовый к помещению во временное хранилище.
Если загружалось несколько файлов, содержит массив ссылок.
** ОтказОтПомещенияФайла - Булево - признак отказа от дальнейшего помещения файла. Если в теле процедуры-обработчика
установить данному параметру значение Истина, то помещение файла будет отменено.
** ДополнительныеПараметры - Произвольный - значение, которое было указано при создании объекта ОписаниеОповещения.
Пример вызова
ПараметрыЗагрузки = ПараметрыЗагрузкиФайла();
ПараметрыЗагрузки.Диалог.Заголовок = НСтр("ru = 'Выберите документ'");
ПараметрыЗагрузки.Диалог.Фильтр = НСтр("ru = 'Файлы MS Word (*.doc;*.docx)|*.doc;*.docx|Все файлы(*.*)|*.*'");
ЗагрузитьФайл(Оповещение, ПараметрыЗагрузки);
Доступность
Тонкий клиент
Синтаксис
Функция ПараметрыЗапускаПрограммы() Экспорт
Возвращаемое значение
Структура - где:
* ТекущийКаталог - Строка - Задает текущий каталог запускаемого приложения.
* Оповещение - ОписаниеОповещения - оповещение о результате завершения запущенного приложения,
если оповещение не задано в случае ошибки будет показано предупреждение.
- Результат - Структура - результат работы программы:
-- ПриложениеЗапущено - Булево - Истина, если внешнее приложение не вызвало ошибок при открытии.
-- ОписаниеОшибки - Строка - краткое описание ошибки. При отмене пользователем пустая строка.
-- КодВозврата - Число - код возврата программы.
-- ПотокВывода - Строка - результат работы программы, направленный в поток stdout.
В веб-клиенте всегда принимает значение "".
-- ПотокОшибок - Строка - ошибки исполнения программы, направленные в поток stderr.
В веб-клиенте всегда принимает значение "".
- ДополнительныеПараметры - Произвольный - значение, которое было указано при создании объекта ОписаниеОповещения.
* ДождатьсяЗавершения - Булево - Истина, дожидаться завершения запущенного приложения перед продолжением работы.
* ПолучитьПотокВывода - Булево - Ложь - результат, направленный в поток stdout,
если не указан ДождатьсяЗавершения - игнорируется.
* ПолучитьПотокОшибок - Булево - Ложь - ошибки, направленные в поток stderr,
если не указан ДождатьсяЗавершения - игнорируется.
* КодировкаИсполнения - Строка, Число - Кодировка, устанавливаемая в Windows с помощью команды chcp.
в Linux и MacOS игнорируется. Возможные значения "OEM", "CP866", "UTF8" или номер кодовой страницы.
* ВыполнитьСНаивысшимиПравами - Булево - Истина, если требуется запустить программу на исполнение
с повышением привилегий системы:
- Windows: запрос UAC;
- Linux: исполнение с командой pkexec;
- macOS, веб-клиент и мобильный клиент: будет возвращено Результат.ОписаниеОшибки.
Пример вызова
Результат = ЕХТ_СистемаКлиент.ПараметрыЗапускаПрограммы()
Доступность
Тонкий клиент
Инициализирует структуру параметров для открытия файла. Для использования в ОткрытьФайл
Синтаксис
Функция ПараметрыОткрытияФайла() Экспорт
Возвращаемое значение
Структура - со свойствами:
*Кодировка - Строка - кодировка текстового файла. Если параметр не задан, формат текста
будет определен автоматически. Список кодировок см. в синтакс-помощнике в
описании метода Записать текстового документа. Значение по умолчанию - "".
*ДляРедактирования - Булево - Истина, если файл открывается для редактирования, иначе Ложь. Если
параметр принимает значение Истина, ожидает закрытия программы и если в параметре
РасположениеФайла хранится адрес во временном хранилище, обновляет данные файла.
Значение по умолчанию - Ложь.
Пример вызова
Результат = ЕХТ_СистемаКлиент.ПараметрыОткрытияФайла()
Доступность
Тонкий клиент
Инициализирует структуру параметров для сохранения файла в файловую систему. Для использования в СохранитьФайл.
Синтаксис
Функция ПараметрыСохраненияФайла() Экспорт
Возвращаемое значение
Структура - со свойствами:
* Интерактивно - Булево - указывает использование интерактивного режима, при котором
пользователю показывается диалог выбора файлов. Значение по
умолчанию - Истина.
* Диалог - ДиалогВыбораФайла - свойства см. в синтакс-помощнике.
Используется, если свойство Интерактивно принимает значение Истина и
удалось подключить расширение работы с файлами.
* ТекстПредложения - Строка - текст предложения об установке расширения. Если параметр
принимает значение "", будет выведен стандартный текст предложения.
Значение по умолчанию - "".
Пример вызова
ПараметрыСохранения = ПараметрыСохраненияФайла();
ПараметрыСохранения.Диалог.Заголовок = НСтр("ru = 'Сохранить профиль ключевых операций в файл'");
ПараметрыСохранения.Диалог.Фильтр = "Файлы профиля ключевых операций (*.xml)|*.xml";
СохранитьФайл(Неопределено, СохранитьПрофильКлючевыхОперацийНаСервере(), , ПараметрыСохранения);
Доступность
Тонкий клиент
Инициализирует структуру параметров для сохранения файла в файловую систему. Для использования в СохранитьФайлы
Синтаксис
Функция ПараметрыСохраненияФайлов() Экспорт
Возвращаемое значение
Структура - со свойствами:
* Интерактивно - Булево - указывает использование интерактивного режима, при котором
пользователю показывается диалог выбора файлов. Значение по
умолчанию - Истина.
* Диалог - ДиалогВыбораФайла - свойства см. в синтакс-помощнике.
Используется, если свойство Интерактивно принимает значение Истина и
удалось подключить расширение работы с файлами.
* ТекстПредложения - Строка - текст предложения об установке расширения. Если параметр
принимает значение "", будет выведен стандартный текст предложения.
Значение по умолчанию - "".
Пример вызова
ПараметрыСохранения = ПараметрыСохраненияФайлов();
ПараметрыСохранения.Диалог.Заголовок = НСтр("ru ='Выбор папки для сохранения сформированного документа'");
СохранитьФайлы(Оповещение, ПолучаемыеФайлы, ПараметрыСохранения);
Доступность
Тонкий клиент
Предлагает пользователю установить расширение работы с файлами в веб-клиенте. Предназначена для использования в начале участков кода, в которых ведется работа с файлами.
Синтаксис
Процедура ПодключитьРасширениеДляРаботыСФайлами( ОписаниеОповещенияОЗакрытии, ТекстПредложения = "", ВозможноПродолжениеБезУстановки = Истина) Экспорт
Параметры
ОписаниеОповещенияОЗакрытии - ОписаниеОповещения - описание процедуры, которая будет вызвана после закрытия
формы со следующими параметрами:
- РасширениеПодключено - Булево - Истина, если расширение было подключено.
- ДополнительныеПараметры - Произвольный - параметры, заданные в ОписаниеОповещенияОЗакрытии.
ТекстПредложения - Строка - текст сообщения. Если не указан, то выводится текст по умолчанию.
ВозможноПродолжениеБезУстановки - Булево - если Истина, будет показана кнопка ПродолжитьБезУстановки,
если Ложь, будет показана кнопка Отмена.
Пример вызова
Оповещение = Новый ОписаниеОповещения("ПечатьДокументаЗавершение", ЭтотОбъект);
ТекстСообщения = НСтр("ru = 'Для печати документа необходимо установить расширение работы с файлами.'");
ПодключитьРасширениеДляРаботыСФайлами(Оповещение, ТекстСообщения);
Процедура ПечатьДокументаЗавершение(РасширениеПодключено, ДополнительныеПараметры) Экспорт
Если РасширениеПодключено Тогда
// код печати документа, рассчитывающий на то, что расширение подключено.
// ...
Иначе
// код печати документа, который работает без подключенного расширения.
// ...
КонецЕсли;
Доступность
Тонкий клиент
Показывает диалог выбора файла.
Синтаксис
Процедура ПоказатьДиалогВыбора(ОбработчикЗавершения, Диалог) Экспорт
Параметры
ОбработчикЗавершения - ОписаниеОповещения - содержит описание процедуры, которая будет вызвана после
закрытия диалога выбора со следующими параметрами:
Диалог - ДиалогВыбораФайла - свойства см. в синтакс-помощнике.
Пример вызова
ЕХТ_СистемаКлиент.ПоказатьДиалогВыбора(ОбработчикЗавершения, Диалог)
Доступность
Тонкий клиент
Получение имени временного каталога.
Синтаксис
Процедура СоздатьВременныйКаталог(Знач Оповещение, Расширение = "") Экспорт
Параметры
Оповещение - ОписаниеОповещения - оповещение о результате получения со следующими параметрами.
- ИмяКаталога - Строка - путь к созданному каталогу.
- ДополнительныеПараметры - Структура - значение, которое было указано при создании объекта ОписаниеОповещения.
Расширение - Строка - суффикс в имени каталога, который поможет идентифицировать каталог при анализе.
Пример вызова
ЕХТ_СистемаКлиент.СоздатьВременныйКаталог(Оповещение, Расширение)
Доступность
Тонкий клиент
Получает файл и сохраняет его в локальную файловую систему пользователя.
Синтаксис
Процедура СохранитьФайл(ОбработчикЗавершения, АдресВоВременномХранилище, ИмяФайла = "", ПараметрыСохранения = Неопределено) Экспорт
Параметры
ОбработчикЗавершения - ОписаниеОповещения, Неопределено - содержит описание процедуры, которая
будет вызвана после завершения со следующими параметрами:
* ПолученныеФайлы - Неопределено - файлы не были получены.
- Массив - Содержит объекты типа ОписаниеПереданногоФайла. Сохраненные файлы.
* ДополнительныеПараметры - Произвольный - значение, которое было указано при создании объекта ОписаниеОповещения.
АдресВоВременномХранилище - Строка - расположение данных во временном хранилище.
ИмяФайла - Строка - полный путь, по которому должен быть сохранен получаемый файл или имя файла
с расширением.
ПараметрыСохранения - Структура - См. ПараметрыСохраненияФайла
Пример вызова
Оповещение = Новый ОписаниеОповещения("СохранитьСертификатПослеПолученияФайлов", ЭтотОбъект, Контекст);
ПараметрыСохранения = ПараметрыСохраненияФайла();
СохранитьФайл(Оповещение, Контекст.АдресСертификата, ИмяФайла, ПараметрыСохранения);
Доступность
Тонкий клиент
Получает файлы и сохраняет их в локальную файловую систему пользователя. Для сохранения файлов в неинтерактивном режиме свойство Имя параметра СохраняемыеФайлы должно содержать полный путь к сохраняемому файлу или, если свойство Имя содержит только имя файла с расширением, необходимо заполнить свойство Каталог элемента Диалог параметра ПараметрыСохранения. В иных случаях будет вызвано исключение.
Синтаксис
Процедура СохранитьФайлы(ОбработчикЗавершения, СохраняемыеФайлы, ПараметрыСохранения = Неопределено) Экспорт
Параметры
ОбработчикЗавершения - ОписаниеОповещения, Неопределено - содержит описание процедуры, которая
будет вызвана после завершения со следующими параметрами:
* ПолученныеФайлы - Неопределено - файлы не были получены.
- Массив - содержит объекты типа ОписаниеПереданногоФайла. Сохраненные файлы.
* ДополнительныеПараметры - Произвольный - значение, которое было указано при создании объекта
ОписаниеОповещения.
СохраняемыеФайлы - Массив - содержит объекты типа ОписаниеПереданногоФайла:
* Хранение - расположение данных во временном хранилище.
* Имя - Строка - полный путь, по которому должен быть сохранен получаемый файл или имя файла с расширением.
ПараметрыСохранения - Структура - см. ПараметрыСохраненияФайла
Пример вызова
Оповещение = Новый ОписаниеОповещения("СохранитьПечатнуюФормуВФайлПослеПолученияФайлов", ЭтотОбъект);
ПараметрыСохранения = ПараметрыСохраненияФайлов();
СохранитьФайлы(Оповещение, ПолучаемыеФайлы, ПараметрыСохранения);
Доступность
Тонкий клиент
Возвращает объект Запрос из полученной СКД
Синтаксис
Функция вЗапрос(Знач СхемаКомпоновки, Знач НастройкиКомпоновки = Неопределено) Экспорт
Пример вызова
Результат = ЕХТ_СКД.вЗапрос(СхемаКомпоновки, НастройкиКомпоновки)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает таблицу значений.
Синтаксис
Функция вТаблицуЗначений(Знач СхемаКомпоновки, Знач НастройкиКомпоновки = Неопределено, Знач ДополнительныеПараметры = Неопределено) Экспорт
Пример вызова
Результат = ЕХТ_СКД.вТаблицуЗначений(СхемаКомпоновки, НастройкиКомпоновки, ДополнительныеПараметры)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает табличный документ.
Синтаксис
Функция вТабличныйДокумент(Знач СхемаКомпоновки, Знач НастройкиКомпоновки = Неопределено, Знач ДополнительныеПараметры = Неопределено) Экспорт
Пример вызова
Результат = ЕХТ_СКД.вТабличныйДокумент(СхемаКомпоновки, НастройкиКомпоновки, ДополнительныеПараметры)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает ссылку на новый элемент отбора в переданном отборе схемы компоновки данных.
Синтаксис
Функция ДобавитьУсловиеОтбора(Отбор, Знач ЛевоеЗначение, Знач ПравоеЗначение = Неопределено, Знач ТипОтбора = Неопределено, Знач ВидСравнения = Неопределено, Знач ПравоеЗначениеПоле = Ложь) Экспорт
Параметры
Отбор - ОтборКомпоновкиДанных - отбор схемы компоновки, в который необходимо добавить новый элемент ЛевоеЗначение - Строка, ПолеКомпоновкиДанных - поле компоновки, по которому необходимо установить отбор (необязательное) ПравоеЗначение - Произвольный, Строка, ПолеКомпоновкиДанных - значение отбора (необязательное) или поле компоновки ТипОтбора - ЭлементОтбораКомпоновкиДанных, ГруппаЭлементовОтбораКомпоновкиДанных - тип нового элемента отбора (необязательное) ВидСравнения - ВидСравненияКомпоновкиДанных - вид сравнения левого и правого значения ПравоеЗначениеПоле - Булево - указывает использовать ли в качестве правого значения поле компоновки данных.
Возвращаемое значение
ЭлементОтбораКомпоновкиДанных - ссылка на новый элемент отбора схемы компоновки данных.
Пример вызова
Результат = ЕХТ_СКД.ДобавитьУсловиеОтбора(Отбор, ЛевоеЗначение, ПравоеЗначение, ТипОтбора, ВидСравнения, ПравоеЗначениеПоле)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает параметры формирования запроса для объекта.
Синтаксис
Функция ДополнительныеПараметрыЗапросаДляОбъекта() Экспорт
Возвращаемое значение
- Структура: - ПсевдонимТаблицы - Строка - псевдоним таблицы запроса. - ОграничитьВыборку - Число - кол-во элементов в выборке, 0 - не ограничивать. - ВключатьТабличныеЧасти - Булево.
Пример вызова
Результат = ЕХТ_СКД.ДополнительныеПараметрыЗапросаДляОбъекта()
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает ВидСравненияКомпоновкиДанных. Поддерживаются значения параметра типа "Строка": "=", "<>", ">", ">=", "<", "<=".
Синтаксис
Функция ЗначениеВидСравнения(Знач ПараметрВидСравнения) Экспорт
Пример вызова
Результат = ЕХТ_СКД.ЗначениеВидСравнения(ПараметрВидСравнения)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает ТипГруппыЭлементовОтбораКомпоновкиДанных. Поддерживаются значения параметра типа "Строка": "И", "ИЛИ", "НЕ".
Синтаксис
Функция ЗначениеТипГруппыОтбора(Знач ТипГруппы) Экспорт
Пример вызова
Результат = ЕХТ_СКД.ЗначениеТипГруппыОтбора(ТипГруппы)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Инициализирует компоновщик настроек на форме.
Синтаксис
Процедура ИнициализироватьКомпоновщикНастроек(Знач Форма, КомпоновщикНастроекФормы, Знач СхемаКомпоновки, НастройкиКомпоновки = Неопределено) Экспорт
Пример вызова
ЕХТ_СКД.ИнициализироватьКомпоновщикНастроек(Форма, КомпоновщикНастроекФормы, СхемаКомпоновки, НастройкиКомпоновки)
Доступность
Сервер, Вызов сервера, Внешнее соединение
ТипыОбъектов это либо массив строк вида "Документ.Анкета" либо строка вида "Документ.Анкета,Документ.Встреча" либо массив объектов метаданных.
Синтаксис
Функция ОбщиеРеквизитыОбъектов(Знач СписокОбъектов, Знач ДополнительныеПараметры = Неопределено) Экспорт
Пример вызова
Результат = ЕХТ_СКД.ОбщиеРеквизитыОбъектов(СписокОбъектов, ДополнительныеПараметры)
Доступность
Сервер, Вызов сервера, Внешнее соединение
СписокОбъектов это либо массив строк вида "Документ.Анкета", либо строка вида "Документ.Анкета,Документ.Встреча" либо массив объектов метаданных.
Синтаксис
Функция ОбщиеРеквизитыОбъектовВТаблицуЗначений(Знач СписокОбъектов, Знач ДополнительныеПараметры = Неопределено) Экспорт
Пример вызова
Результат = ЕХТ_СКД.ОбщиеРеквизитыОбъектовВТаблицуЗначений(СписокОбъектов, ДополнительныеПараметры)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает таблицу значений с одной строкой и колонками, соответствующими реквизитам объекта. Объект может быть не записан.
Синтаксис
Функция ОбъектВТаблицуЗначений(Знач Объект) Экспорт
Пример вызова
Результат = ЕХТ_СКД.ОбъектВТаблицуЗначений(Объект)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Очищает все элементы настройки компоновки данных из объекта
Синтаксис
Процедура ОчиститьНастройки(Настройки) Экспорт
Параметры
Настройки - НастройкиКомпоновкиДанных - очищаемые настройки.
Пример вызова
ЕХТ_СКД.ОчиститьНастройки(Настройки)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает значение параметра компоновки данных.
Синтаксис
Функция ПолучитьПараметр(Настройки, Параметр) Экспорт
Параметры
Настройки - НастройкиКомпоновкиДанных,
ПользовательскиеНастройкиКомпоновкиДанных,
КомпоновщикНастроекКомпоновкиДанных,
КоллекцияЗначенийПараметровКомпоновкиДанных,
ОформлениеКомпоновкиДанных -
настройки, в которых происходит поиск параметра. Не поддерживает тип ДанныеРасшифровкиКомпоновкиДанных.
Параметр - Строка,
ПараметрКомпоновкиДанных -
имя параметра СКД, для которого нужно вернуть значение параметра.
Возвращаемое значение
ПараметрКомпоновкиДанных, ЗначениеПараметраНастроекКомпоновкиДанных - Искомый параметр.
Пример вызова
Результат = ЕХТ_СКД.ПолучитьПараметр(Настройки, Параметр)
Доступность
Сервер, Вызов сервера, Внешнее соединение
ТаблицаУсловий: ТаблицаЗначений с обязательными колонками:
- Используется: Булево
- ТипВидОбъекта - Строка - Тип.Вид объекта
- ИдентификаторУсловия: Строка (36)
- Условие - ХранилищеЗначения - НастройкаКомпоновки
СписокКолонок: Строка: (необяз.) Строка колонок ТаблицыУсловий, значения которых нужно добавить к результату.
Имена колонок не должны совпадать именами реквизитов объектов конфигурации.
Рекомендуется использовать префикс, н-р "Результат" (см. в ЕХТ_ВремяДокументов)
Синтаксис
Функция ПолучитьСхемуКомпоновкиПроверкиОбъекта(Знач ТипВидОбъекта, Знач ТаблицаУсловий, Знач СписокКолонок = Неопределено) Экспорт
Пример вызова
Результат = ЕХТ_СКД.ПолучитьСхемуКомпоновкиПроверкиОбъекта(ТипВидОбъекта, ТаблицаУсловий, СписокКолонок)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает Истина, если схемы идентичны.
Синтаксис
Функция Равны(Знач Схема1, Знач Схема2) Экспорт
Пример вызова
Результат = ЕХТ_СКД.Равны(Схема1, Схема2)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращается независимую копию исходной схемы компоновки данных
Синтаксис
Функция Скопировать(Знач ИсходнаяСхема) Экспорт
Параметры
ИсходнаяСхема - СхемаКомпоновкиДанных - схема, которую требуется скопировать.
Возвращаемое значение
СхемаКомпоновкиДанных - новая схема компоновки данных с настройками, идентичными исходной схеме.
Пример вызова
Результат = ЕХТ_СКД.Скопировать(ИсходнаяСхема)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Копирует настройки компоновки данных
Синтаксис
Процедура СкопироватьНастройки(НастройкиПриемник, Знач НастройкиИсточник) Экспорт
Параметры
НастройкиПриемник - НастройкиКомпоновкиДанных, НастройкиВложенногоОбъектаКомпоновкиДанных ГруппировкаКомпоновкиДанных, ГруппировкаТаблицыКомпоновкиДанных, ГруппировкаДиаграммыКомпоновкиДанных, ТаблицаКомпоновкиДанных, ДиаграммаКомпоновкиДанных - коллекция настроек КД, куда копируются настройки НастройкиИсточник - НастройкиКомпоновкиДанных, НастройкиВложенногоОбъектаКомпоновкиДанных ГруппировкаКомпоновкиДанных, ГруппировкаТаблицыКомпоновкиДанных, ГруппировкаДиаграммыКомпоновкиДанных, ТаблицаКомпоновкиДанных, ДиаграммаКомпоновкиДанных - коллекция настроек КД, откуда копируются настройки.
Пример вызова
ЕХТ_СКД.СкопироватьНастройки(НастройкиПриемник, НастройкиИсточник)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Копирует элементы отбора из одной коллекции отбора в другую
Синтаксис
Процедура СкопироватьОтбор(ОтборПриемник, Знач ОтборИсточник, Знач ТолькоИспользуемые = Ложь) Экспорт
Параметры
Приемник - ОтборКомпоновкиДанных - куда копировать Источник - ОтборКомпоновкиДанных - откуда копировать ТолькоИспользуемые - Булево - копировать только используемые
Пример вызова
ЕХТ_СКД.СкопироватьОтбор(ОтборПриемник, ОтборИсточник, ТолькоИспользуемые)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Копирует элементы из одной коллекции в другую
Синтаксис
Процедура СкопироватьЭлементы(ПриемникЗначения, Знач ИсточникЗначения, Знач ОчищатьПриемник = Истина) Экспорт
Параметры
ПриемникЗначения - КоллекцияЗначенийПараметровКомпоновкиДанных,
ЗначенияПараметровДанныхКомпоновкиДанных -
коллекция элементов КД, куда копируются параметры
ИсточникЗначения - КоллекцияЗначенийПараметровКомпоновкиДанных,
ЗначенияПараметровДанныхКомпоновкиДанных -
коллекция элементов КД, откуда копируются параметры
ОчищатьПриемник - Булево - признак необходимости очистки приемника.
Пример вызова
ЕХТ_СКД.СкопироватьЭлементы(ПриемникЗначения, ИсточникЗначения, ОчищатьПриемник)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает созданную схему компоновки данных. Основа: https://infostart.ru/public/575659 Автор: Дмитрий Иванов (kambl)
Синтаксис
Функция Создать(Знач НаборДанных = Неопределено, Знач ДополнительныеПараметры = Неопределено) Экспорт
Параметры
НаборДанных - Запрос, текст запроса (строка), ТаблицаЗначений, ДеревоЗначений
ДополнительныеПараметры (Тип: Структура)
- ПараметрыДанных: (Тип: Структура) КомпоновщикНастроек.Настройки.ПараметрыДанных
- Отбор: (Тип: Структура) КомпоновщикНастроек.Настройки.Отбор
- Ресурсы: (Тип: Структура): содержит перечень полей ресурсов, где ключ - ИмяПоля, Значение(Строка) - Агрегатная функция ("Сумма", "Среднее", "Количество", и т.д.);
- АвтоЗаполнениеДоступныхПолей (Тип: Булево);
- МакетОформления (Тип: Строка) - Имя макета оформления
Возвращаемое значение
- СхемаКомпоновкиДанных
Пример вызова
Результат = ЕХТ_СКД.Создать(НаборДанных, ДополнительныеПараметры)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает текст запроса для переданного Тип.Вид объекта ДополнительныеПараметры: Структура. См. ОписаниеПараметровЗапросаДляОбъекта()
Синтаксис
Функция ТекстЗапросаДляОбъекта(ТипыИзменяемыхОбъектов, ДополнительныеПараметры=Неопределено) Экспорт
Пример вызова
Результат = ЕХТ_СКД.ТекстЗапросаДляОбъекта(ТипыИзменяемыхОбъектов, ДополнительныеПараметры)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Устанавливает значение параметра компоновки данных.
Синтаксис
Функция УстановитьПараметр(Настройки, Параметр, Значение, Использование = Истина) Экспорт
Параметры
Настройки - НастройкиКомпоновкиДанных, ПользовательскиеНастройкиКомпоновкиДанных, КомпоновщикНастроекКомпоновкиДанных,
КоллекцияЗначенийПараметровКомпоновкиДанных, ОформлениеКомпоновкиДанных - Настройки,
в которых происходит поиск параметра.
Параметр - Строка, ПараметрКомпоновкиДанных - Имя параметра СКД, для которого нужно установить значение параметра.
Значение - Произвольный - Значение параметра.
Использование - Булево - Признак использования параметра. По умолчанию всегда принимается равным истине.
Возвращаемое значение
ПараметрКомпоновкиДанных, ЗначениеПараметраНастроекКомпоновкиДанных - Параметр, для которого установлено значение.
Пример вызова
Результат = ЕХТ_СКД.УстановитьПараметр(Настройки, Параметр, Значение, Использование)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Устанавливает элемент отбора и возвращает его.
Синтаксис
Функция УстановитьЭлементОтбора(Компоновщик, Знач ИмяПараметра, Знач ЗначениеПараметра, Знач Использование = Истина) Экспорт
Пример вызова
Результат = ЕХТ_СКД.УстановитьЭлементОтбора(Компоновщик, ИмяПараметра, ЗначениеПараметра, Использование)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает Массив, созданный из полученного Соответствия. Параметр КлючИлиЗначение указывает что именно нужно поместить в массив - "Ключ" или "Значение".
Синтаксис
Функция вМассив(Знач Соответствие, Знач КлючИлиЗначение = "Значение") Экспорт
Пример вызова
Результат = ЕХТ_Соответствие.вМассив(Соответствие, КлючИлиЗначение)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает Структуру, созданную из полученного Соответствия.
Синтаксис
Функция вСтруктуру(Знач Соответствие) Экспорт
Пример вызова
Результат = ЕХТ_Соответствие.вСтруктуру(Соответствие)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Дополняет соответствие значениями из другого соответствия.
Синтаксис
Процедура Дополнить(Приемник, Знач Источник, Знач Заменять = Неопределено) Экспорт
Параметры
Приемник - Соответствие - коллекция, в которую будут добавляться новые значения.
Источник - Соответствие - коллекция, из которой будут считываться пары Ключ и Значение для заполнения.
Заменять - Булево, Неопределено - Что делать в местах пересечения ключей источника и приемника:
Истина - Заменять значения приемника (самый быстрый способ),
Ложь - Не заменять значения приемника (пропускать),
Неопределено - Значение по умолчанию. Бросать исключение.
Пример вызова
ЕХТ_Соответствие.Дополнить(Приемник, Источник, Заменять)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает соответствие, ключами которого являются элементы массива. По умолчанию, в качестве значений для всех ключей будет установлено Истина.
Синтаксис
Функция ИзМассива(Знач Массив, Знач Значение = Истина) Экспорт
Параметры
Массив - Массив - элементы которого нужно поместить в Соответствие. Значение - Любое значение - значение которое будет помещено в значение Соответствия.
Возвращаемое значение
Соответствие - соответствие, в ключи которого помещены элементы переданного массива.
Пример вызова
Результат = ЕХТ_Соответствие.ИзМассива(Массив, Значение)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает индекс элемента Соответствия по ключу
Синтаксис
Функция ИндексКлюча(Знач Соответствие, Знач Ключ, Значение=Неопределено) Экспорт
Параметры
Соответствие - Соответствие - соответствие, в котором надо найти элемент с ключом Ключ - Произвольный - искомый ключ Значение - Произвольный (Возвращаемое значение)
Возвращаемое значение
ИндексКлюча - числовой индекс элемента или Неопределено, если ключ не найден
Пример вызова
Результат = ЕХТ_Соответствие.ИндексКлюча(Соответствие, Ключ, Значение)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает ключ элемента Соответствия по индексу
Синтаксис
Функция КлючИндекса(Знач Соответствие, Знач Индекс, Значение = Неопределено) Экспорт
Параметры
Соответствие - Соответствие - соответствие, в котором надо найти элемент с ключом Индекс - Число - искомый ключ Значение - Произвольный (Возвращаемое значение)
Возвращаемое значение
ИндексКлюча - числовой индекс элемента или Неопределено, если ключ не найден
Пример вызова
Результат = ЕХТ_Соответствие.КлючИндекса(Соответствие, Индекс, Значение)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Проверяет наличие в соответствии элемента с искомым значением ключа
Синтаксис
Функция КлючСуществует(Знач Соответствие, Знач Ключ, Значение=Неопределено) Экспорт
Параметры
Соответствие - Соответствие - соответствие, в котором надо проверить ключ Ключ - Произвольный - искомый ключ Значение - Произвольный (Возвращаемое значение)
Возвращаемое значение
КлючСуществует - Булево Истина - существует Ложь - отсутствует
Пример вызова
Результат = ЕХТ_Соответствие.КлючСуществует(Соответствие, Ключ, Значение)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает значение Соответствия по строковому ключу без учета регистра букв.
Синтаксис
Функция ПолучитьБезУчетаРегистра(Знач Соответствие, Знач Ключ) Экспорт
Параметры
Соответствие - Соответствие - соответствие, из которого нужно получить значение Ключ - Строка - ключ получаемого элемента
Пример вызова
Результат = ЕХТ_Соответствие.ПолучитьБезУчетаРегистра(Соответствие, Ключ)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Получает элемент Соответствия по индексу
Синтаксис
Функция ПолучитьПоИндексу(Соответствие, Знач Индекс) Экспорт
Параметры
Соответствие - Соответствие - соответствие, из которого нужно получить элемент по индексу Индекс - Число - индекс получаемого элемента
Пример вызова
Результат = ЕХТ_Соответствие.ПолучитьПоИндексу(Соответствие, Индекс)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Создает копию значения типа Соответствие, рекурсивно, с учетом типов значений. Если значения соответствия содержат значения объектных типов (СправочникОбъект, ДокументОбъект и т.п.), то их содержимое не копируются, а возвращаются ссылки на исходный объект.
Синтаксис
Функция Скопировать(Знач СоответствиеИсточник) Экспорт
Параметры
СоответствиеИсточник - Соответствие - соответствие, копию которого необходимо получить.
Возвращаемое значение
Соответствие - копия исходного соответствия.
Пример вызова
Результат = ЕХТ_Соответствие.Скопировать(СоответствиеИсточник)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Удаляет элемент Соответствия по индексу
Синтаксис
Процедура УдалитьПоИндексу(Соответствие, Знач Индекс) Экспорт
Параметры
Соответствие - Соответствие - соответствие из которого удаляется элемент по индексу Индекс - Число - индекс удаляемого элемента
Пример вызова
ЕХТ_Соответствие.УдалитьПоИндексу(Соответствие, Индекс)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает фиксированное соответствие с фиксированными значениями.
Синтаксис
Функция Фиксировать(Знач Соответствие) Экспорт
Параметры
Соответствие - Соответствие - Исходное Соответствие.
Возвращаемое значение
ФиксированноеСоответствие -
Пример вызова
Результат = ЕХТ_Соответствие.Фиксировать(Соответствие)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Создает список значений из строки с разделителями
Синтаксис
Функция ИзСтроки(Знач Строка, Знач Разделитель=",", Знач ВключатьПустые=Ложь) Экспорт
Параметры
Строка - строка, в которой через разделитель перечислены элементы создаваемого списка. Разделитель - подстрока, являющаяся разделителем значений в строке. УчитыватьПустые - учитывать пустые.
Возвращаемое значение
Тип: Строка. Результат замены.
Пример вызова
Результат = ЕХТ_СписокЗначений.ИзСтроки(Строка, Разделитель, ", ВключатьПустые)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Создает копию значения типа СписокЗначений, рекурсивно, с учетом типов его значений. Если в списке значений есть значения объектных типов (СправочникОбъект, ДокументОбъект и т.п.), то их содержимое не копируются, а возвращаются ссылки на исходный объект.
Синтаксис
Функция Скопировать(СписокИсточник) Экспорт
Параметры
СписокИсточник - СписокЗначений - список значений, копию которого необходимо получить.
Возвращаемое значение
СписокЗначений - копия исходного списка значений.
Пример вызова
Результат = ЕХТ_СписокЗначений.Скопировать(СписокИсточник)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает структуру для заполнения реквизитов проверяемой группы.
Синтаксис
Функция ОписаниеГруппы(Знач Ссылка) Экспорт
Пример вызова
Результат = ЕХТ_Справочники.ОписаниеГруппы(Ссылка)
Доступность
Сервер, Внешнее соединение
Возвращает структуру для заполнения реквизитов проверяемого объекта.
Синтаксис
Функция ОписаниеОбъекта(Знач Ссылка, Знач ЭтоГруппа) Экспорт
Пример вызова
Результат = ЕХТ_Справочники.ОписаниеОбъекта(Ссылка, ЭтоГруппа)
Доступность
Сервер, Внешнее соединение
Возвращает структуру для заполнения реквизитов проверяемого элемента.
Синтаксис
Функция ОписаниеЭлемента(Знач Ссылка) Экспорт
Пример вызова
Результат = ЕХТ_Справочники.ОписаниеЭлемента(Ссылка)
Доступность
Сервер, Внешнее соединение
Возвращает созданную группу справочника, заполненную по описанию.
Синтаксис
Функция ПроверитьГруппу(Знач Описание, ЭтоНовый = Неопределено) Экспорт
Пример вызова
Результат = ЕХТ_Справочники.ПроверитьГруппу(Описание, ЭтоНовый)
Доступность
Сервер, Внешнее соединение
Возвращает созданный объект справочника, заполненный по описанию.
Синтаксис
Функция ПроверитьОбъект(Знач Описание, ЭтоНовый = Неопределено) Экспорт
Пример вызова
Результат = ЕХТ_Справочники.ПроверитьОбъект(Описание, ЭтоНовый)
Доступность
Сервер, Внешнее соединение
Возвращает созданный элемент справочника, заполненный по описанию.
Синтаксис
Функция ПроверитьЭлемент(Знач Описание, ЭтоНовый = Неопределено) Экспорт
Пример вызова
Результат = ЕХТ_Справочники.ПроверитьЭлемент(Описание, ЭтоНовый)
Доступность
Сервер, Внешнее соединение
Возвращает список родителей для указанной ссылки
Синтаксис
Функция СписокРодителей(Знач Ссылка) Экспорт
Пример вызова
Результат = ЕХТ_Справочники.СписокРодителей(Ссылка)
Доступность
Сервер, Внешнее соединение
Возвращает ссылку на элемент справочника по уникальному идентификатору
Синтаксис
Функция Ссылка(Знач Вид, Знач Идентификатор) Экспорт
Пример вызова
Результат = ЕХТ_Справочники.Ссылка(Вид, Идентификатор)
Доступность
Сервер, Внешнее соединение
Возвращает вид ссылки строкой
Синтаксис
Функция ВидСтр(Знач Ссылка) Экспорт
Пример вызова
Результат = ЕХТ_Ссылка.ВидСтр(Ссылка)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает дату создания ссылки.
Синтаксис
Функция ДатаСоздания(Знач Ссылка) Экспорт
Пример вызова
Результат = ЕХТ_Ссылка.ДатаСоздания(Ссылка)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Производит замену ссылок во всех данных. После замены неиспользуемые ссылки опционально удаляются. Замена ссылок происходит с транзакциями по изменяемому объекту и его связям, не по анализируемой ссылке. При вызове в неразделенном сеансе не выявляет ссылок в разделенных областях.
Синтаксис
Функция Заменить(Знач ПарыЗамен, Знач Параметры = Неопределено) Экспорт
Параметры
ПарыЗамен - Соответствие - пары замен.
* Ключ - ЛюбаяСсылка - что ищем (дубль).
* Значение - ЛюбаяСсылка - на что заменяем (оригинал).
Ссылки сами на себя и пустые ссылки для поиска будут проигнорированы.
Параметры - Структура - Необязательный. Параметры замены.
* СпособУдаления - Строка - необязательный. Что делать с дублем после успешной замены.
"" - по умолчанию. Не предпринимать никаких действий.
"Пометка" - помечать на удаление.
"Непосредственно" - удалять непосредственно.
* УчитыватьПрикладныеПравила - Булево - необязательный. Режим проверки параметра ПарыЗамен.
Истина - по умолчанию. Проверять каждую пару "дубль-оригинал" (вызывается функция
ВозможностьЗаменыЭлементов модуля менеджера).
Ложь - отключить прикладные проверки пар.
* ВключатьБизнесЛогику - Булево - необязательный. Режим записи мест использования при замене дублей на оригиналы.
Истина - по умолчанию. Места использования дублей записываются в режиме ОбменДанными.Загрузка = Ложь.
Ложь - запись ведется в режиме ОбменДанными.Загрузка = Истина.
* ЗаменаПарыВТранзакции - Булево - необязательный. Определяет размер транзакции.
Истина - по умолчанию. Транзакция охватывает все места использования одного дубля. Может быть очень ресурсоемко
в случае большого количества мест использований.
Ложь - замена каждого места использования выполняется в отдельной транзакции.
* ПривилегированнаяЗапись - Булево - необязательный. Требуется ли устанавливать привилегированный режим перед запись.
Ложь - по умолчанию. Записывать с текущими правами.
Истина - записывать в привилегированном режиме.
Возвращаемое значение
ТаблицаЗначений - неуспешные замены (ошибки).
* Ссылка - ЛюбаяСсылка - ссылка, которую заменяли.
* ОбъектОшибки - Произвольный - объект - причина ошибки.
* ПредставлениеОбъектаОшибки - Строка - строковое представление объекта ошибки.
* ТипОшибки - Строка - тип ошибки:
"ОшибкаБлокировки" - при обработке ссылки некоторые объекты были заблокированы.
"ДанныеИзменены" - в процессе обработки данные были изменены другим пользователем.
"ОшибкаЗаписи" - не смогли записать объект, или метод ВозможностьЗаменыЭлементов вернул отказ.
"ОшибкаУдаления" - не смогли удалить объект.
"НеизвестныеДанные" - при обработке были найдены данные, которые не планировались к анализу, замена не реализована.
* ТекстОшибки - Строка - подробное описание ошибки.
Пример вызова
Результат = ЕХТ_Ссылка.Заменить(ПарыЗамен, Параметры)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает значение реквизита, прочитанного из информационной базы по ссылке на объект. Если доступа к реквизиту нет, возникнет исключение прав доступа. Если необходимо зачитать реквизит независимо от прав текущего пользователя, то следует использовать предварительный переход в привилегированный режим. Функция не предназначена для получения значений реквизитов пустых ссылок.
Синтаксис
Функция ЗначениеРеквизитаОбъекта(Ссылка, ИмяРеквизита) Экспорт
Параметры
Ссылка - ссылка на объект, - элемент справочника, документ, ... ИмяРеквизита - Строка, например, "Код".
Возвращаемое значение
Произвольный - зависит от типа значения прочитанного реквизита.
Пример вызова
Результат = ЕХТ_Ссылка.ЗначениеРеквизитаОбъекта(Ссылка, ИмяРеквизита)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает значения реквизита, прочитанного из информационной базы для нескольких объектов. Если доступа к реквизиту нет, возникнет исключение прав доступа. Если необходимо зачитать реквизит независимо от прав текущего пользователя, то следует использовать предварительный переход в привилегированный режим. Функция не предназначена для получения значений реквизитов пустых ссылок.
Синтаксис
Функция ЗначениеРеквизитаОбъектов(МассивСсылок, ИмяРеквизита) Экспорт
Параметры
МассивСсылок - массив ссылок на объекты одного типа.
ВАЖНО! значения массива должны быть ссылками на
объекты одного типа!
ИмяРеквизита - Строка, например, "Код".
Возвращаемое значение
Соответствие - Ключ - ссылка на объект, Значение - значение прочитанного реквизита.
Пример вызова
Результат = ЕХТ_Ссылка.ЗначениеРеквизитаОбъектов(МассивСсылок, ИмяРеквизита)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает структуру, содержащую значения реквизитов прочитанные из информационной базы по ссылке на объект. Если доступа к одному из реквизитов нет, возникнет исключение прав доступа. Если необходимо зачитать реквизит независимо от прав текущего пользователя, то следует использовать предварительный переход в привилегированный режим. Функция не предназначена для получения значений реквизитов пустых ссылок.
Синтаксис
Функция ЗначенияРеквизитовОбъекта(Ссылка, Знач Реквизиты) Экспорт
Параметры
Ссылка - ЛюбаяСсылка - объект, значения реквизитов которого необходимо получить.
Реквизиты - Строка - имена реквизитов, перечисленные через запятую, в формате
требований к свойствам структуры.
Например, "Код, Наименование, Родитель".
- Структура, ФиксированнаяСтруктура - в качестве ключа передается
псевдоним поля для возвращаемой структуры с результатом, а в качестве
значения (опционально) фактическое имя поля в таблице.
Если значение не определено, то имя поля берется из ключа.
- Массив, ФиксированныйМассив - имена реквизитов в формате требований
к свойствам структуры.
Возвращаемое значение
Структура - содержит имена (ключи) и значения затребованных реквизитов.
Если строка затребованных реквизитов пуста, то возвращается пустая структура.
Если в качестве объекта передана пустая ссылка, то все реквизиты вернутся со значением Неопределено.
Пример вызова
Результат = ЕХТ_Ссылка.ЗначенияРеквизитовОбъекта(Ссылка, Реквизиты)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает значения реквизитов, прочитанные из информационной базы для нескольких объектов. Если доступа к одному из реквизитов нет, возникнет исключение прав доступа. Если необходимо зачитать реквизит независимо от прав текущего пользователя, то следует использовать предварительный переход в привилегированный режим. Функция не предназначена для получения значений реквизитов пустых ссылок.
Синтаксис
Функция ЗначенияРеквизитовОбъектов(МассивСсылок, ИменаРеквизитов) Экспорт
Параметры
МассивСсылок - массив ссылок на объекты одного типа.
ВАЖНО! значения массива должны быть ссылками на
объекты одного типа!
ИменаРеквизитов - Строка, имена реквизитов перечисленные через запятую,
в формате требований к свойствам структуры.
Например, "Код, Наименование, Родитель".
Возвращаемое значение
Соответствие - где ключ - ссылка на объект, а Значение - структура, которая
содержит список свойств, как список имен в строке.
ИменаРеквизитов, со значениям реквизитов, прочитанными из информационной базы.
Пример вызова
Результат = ЕХТ_Ссылка.ЗначенияРеквизитовОбъектов(МассивСсылок, ИменаРеквизитов)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает ссылку, полученную из навигационной ссылки. Источник: https://helpf.pro/faq/view/1469.html
Синтаксис
Функция ИзНавигационнойСсылки(Знач НавигационнаяСсылка) Экспорт
Пример вызова
Результат = ЕХТ_Ссылка.ИзНавигационнойСсылки(НавигационнаяСсылка)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает ссылку, полученную из имени менеджера и уникального идентификатора
Синтаксис
Функция ИзУникальногоИдентификатора(Знач ИмяМенеджера, Знач Идентификатор, Знач ОчищатьЕслиНеСуществует = Истина) Экспорт
Пример вызова
Результат = ЕХТ_Ссылка.ИзУникальногоИдентификатора(ИмяМенеджера, Идентификатор, ОчищатьЕслиНеСуществует)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает полное имя объекта метаданных по переданному значению ссылки. Примеры: "Справочник.Номенклатура"; "Документ.ПриходнаяНакладная".
Синтаксис
Функция ИмяТаблицы(Знач Ссылка) Экспорт
Параметры
Ссылка - ЛюбаяСсылка - объект, для которого необходимо получить имя таблицы ИБ.
Возвращаемое значение
Строка - полное имя объекта метаданных для указанного объекта.
Пример вызова
Результат = ЕХТ_Ссылка.ИмяТаблицы(Ссылка)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает менеджер объекта по ссылке на объект.
Синтаксис
Функция Менеджер(Знач Ссылка) Экспорт
Параметры
Ссылка - ЛюбаяСсылка - ссылка, менеджер которой требуется получить.
Возвращаемое значение
СправочникМенеджер, ДокументМенеджер.
Пример вызова
Результат = ЕХТ_Ссылка.Менеджер(Ссылка)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Получает все места использования ссылок. Если какая-либо ссылка нигде не используется, то строк для нее в результирующей таблице не будет. При вызове в неразделенном сеансе не выявляет ссылок в разделенных областях.
Синтаксис
Функция МестаИспользования(Знач НаборСсылок, Знач АдресРезультата = "") Экспорт
Параметры
НаборСсылок - Массив - ссылки, для которых ищем места использования.
АдресРезультата - Строка - необязательный адрес во временном хранилище, куда будет помещен копия результата
замены.
Возвращаемое значение
ТаблицаЗначений - состоит из колонок:
* Ссылка - ЛюбаяСсылка - ссылка, которая анализируется.
* Данные - Произвольный - данные, содержащие анализируемую ссылку.
* Метаданные - ОбъектМетаданных - метаданные найденных данных.
* ПредставлениеДанных - Строка - представление данных, содержащих анализируемую ссылку.
* ТипСсылки - Тип - тип анализируемой ссылки.
* ВспомогательныеДанные - Булево - Истина, если данные используются анализируемой ссылкой как
вспомогательные данные (ведущее измерение или попали в исключение ПриДобавленииИсключенийПоискаСсылок).
* ЭтоСлужебныеДанные - Булево - данные попали в исключение ПриДобавленииИсключенийПоискаСсылок
Пример вызова
Результат = ЕХТ_Ссылка.МестаИспользования(НаборСсылок, АдресРезультата)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает описание предмета в виде текстовой строки. Для документов возвращается представление, для остальных ссылочных типов возвращается представление и тип в скобках, например, "Ножницы (Номенклатура)". Для пустых ссылок, Неопределено или незаполненных значений примитивных типов возвращается "не задан".
Синтаксис
Функция ПредметСтрокой(Знач СсылкаНаПредмет) Экспорт
Параметры
СсылкаНаПредмет - Произвольный.
Возвращаемое значение
Строка - например, "Ножницы (Номенклатура)", "Заказ клиента № 0001 от 01.01.2001" или "не задан".
Пример вызова
Результат = ЕХТ_Ссылка.ПредметСтрокой(СсылкаНаПредмет)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает описания предметов СсылкиНаПредметы. Для документов возвращается представление, для остальных ссылочных типов возвращается представление и тип в скобках, например, "Ножницы (Номенклатура)". Для пустых ссылок или незаполненных значений примитивных типов возвращается "не задан". Значение "удален", если объект не существует в информационной базе. Значения Неопределено пропускаются.
Синтаксис
Функция ПредметыСтрокой(Знач СсылкиНаПредметы) Экспорт
Параметры
СсылкиНаПредметы - Массив из ЛюбаяСсылка
Возвращаемое значение
Соответствие из КлючЗначение:
* Ключ - ЛюбаяСсылка
* Значение - Строка - например, "Ножницы (Номенклатура)", "Заказ клиента № 0001 от 01.01.2001" или "не задан".
Пример вызова
Результат = ЕХТ_Ссылка.ПредметыСтрокой(СсылкиНаПредметы)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает представление переданной ссылки.
Синтаксис
Функция Представление(Знач Ссылка) Экспорт
Параметры
Ссылка - ЛюбаяСсылка
Возвращаемое значение
Строка - представление ссылки или "удален", если ссылка не существует в информационной базе.
Пример вызова
Результат = ЕХТ_Ссылка.Представление(Ссылка)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает представления переданных ссылок.
Синтаксис
Функция Представления(Знач ПроверяемыеСсылки) Экспорт
Параметры
ПроверяемыеСсылки - Массив из ЛюбаяСсылка, ЛюбаяСсылка
Возвращаемое значение
Соответствие из КлючЗначение: * Ключ - ЛюбаяСсылка * Значение - Строка - представление ссылки или "удален", если ссылка не существует в информационной базе.
Пример вызова
Результат = ЕХТ_Ссылка.Представления(ПроверяемыеСсылки)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Проверяет физическое наличие записи в информационной базе данных о переданном значении ссылки.
Синтаксис
Функция Существует(Знач Ссылка) Экспорт
Параметры
ЛюбаяСсылка - значение любой ссылки информационной базы данных.
Возвращаемое значение
Булево.
Пример вызова
Результат = ЕХТ_Ссылка.Существует(Ссылка)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает полное имя объекта метаданных по переданному значению ссылки. Примеры: "Справочник.Номенклатура"; "Документ.ПриходнаяНакладная".
Синтаксис
Функция ТипВидСтр(Знач Ссылка) Экспорт
Параметры
Ссылка - ЛюбаяСсылка - объект, для которого необходимо получить ТипВидСтр.
Возвращаемое значение
Строка - полное имя объекта метаданных для указанного объекта.
Пример вызова
Результат = ЕХТ_Ссылка.ТипВидСтр(Ссылка)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает тип ссылки строкой
Синтаксис
Функция ТипСтр(Знач Ссылка) Экспорт
Пример вызова
Результат = ЕХТ_Ссылка.ТипСтр(Ссылка)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Удаляет кавычки с начала и конца строки, если они есть.
Синтаксис
Функция БезКавычек(Знач Строка) Экспорт
Параметры
Строка - Строка - входная строка.
Возвращаемое значение
Строка - строка без двойных кавычек.
Пример вызова
Результат = ЕХТ_Строка.БезКавычек(Строка)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает строку, закодированную в Base64.
Синтаксис
Функция вBase64(Знач Строка, Знач Кодировка = "UTF-8", Знач ЗаписатьBOM = Ложь) Экспорт
Параметры
Строка - Строка - Строка, которую нужно закодировать. Кодировка - Строка или КодировкаТекста - Кодировка строки. ЗаписатьBOM - Булево - Признак добавления BOM.
Возвращаемое значение
- Строка
Пример вызова
Результат = ЕХТ_Строка.вBase64(Строка, Кодировка, ЗаписатьBOM)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает строку Base64, содержащей данные строки в виде двоичных данных файла без BOM.
Синтаксис
Функция вBase64БезBOM(Знач СтрокаДанных, Знач КодировкаТекста = "UTF-8", Знач БезПереводаСтрок = Ложь) Экспорт
Параметры
СтрокаДанных - Строка - строка для преобразования в BASE64. КодировкаТекста - Строка - используемая кодировка текста. БезПереводаСтрок - Булево - убрать переводы строк в результирующей строке
Возвращаемое значение
Строка - строка в BASE64.
Пример вызова
Результат = ЕХТ_Строка.вBase64БезBOM(СтрокаДанных, КодировкаТекста, БезПереводаСтрок)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает строку Unicode. Источник: БП.ДокументооборотСКонтролирующимиОрганами.ТекстВШестнадцатеричныйUnicode
Синтаксис
Функция вUnicode(Знач Строка) Экспорт
Пример вызова
Результат = ЕХТ_Строка.вUnicode(Строка)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Заменяет в шаблоне строки имена параметров на их значения. Параметры в строке выделяются с двух сторон квадратными скобками.
Синтаксис
Функция ВставитьПараметры(Знач ШаблонСтроки, Знач Параметры, Знач ЛеваяСкобка = "[", Знач ПраваяСкобка = "]") Экспорт
Параметры
ШаблонСтроки - Строка - строка, в которую необходимо вставить значения.
Параметры - Структура - подставляемые значения параметров, где ключ - имя параметра без спецсимволов,
значение - вставляемое значение.
Возвращаемое значение
Строка - строка со вставленными значениями.
Пример вызова
Значения = Новый Структура("Фамилия,Имя", "Пупкин", "Вася");
Результат = ЕХТ_Строка.ВставитьПараметры("Здравствуй, [Имя] [Фамилия].", Значения);
- возвращает: "Здравствуй, Вася Пупкин".
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Преобразует исходную строку в транслит. Может использоваться для отправки SMS сообщений латиницей или для сохранения файлов и папок, чтобы обеспечить возможность их переноса между разными операционными системами. Обратное преобразование из латинских символов не предусмотрено.
Синтаксис
Функция вТранслит(Знач Значение) Экспорт
Параметры
Значение - Строка - произвольная строка.
Возвращаемое значение
Строка - строка, в которой кириллица заменена на транслит.
Пример вызова
Результат = ЕХТ_Строка.вТранслит(Значение)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Преобразует исходную строку в число без вызова исключений.
Синтаксис
Функция вЧисло(Знач Значение, Знач ЧислоРазрядов = Неопределено, Знач ЧислоРазрядовДробнойЧасти = Неопределено) Экспорт
Параметры
Значение - Строка - Строка, которую необходимо привести к числу.
Например, "10", "+10", "010", вернет 10;
"(10)", "-10",вернет -10;
"10,2", "10.2",вернет 10.2;
"000", " ", "",вернет 0;
"10текст", вернет Неопределено.
Возвращаемое значение
Число, Неопределено - Полученное число, либо Неопределено, если строка не является числом.
Пример вызова
Результат = ЕХТ_Строка.вЧисло(Значение, ЧислоРазрядов, ЧислоРазрядовДробнойЧасти)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Дополняет строку символами слева или справа до заданной длины и возвращает ее. Незначащие символы слева и справа удаляются. По умолчанию функция дополняет строку символами "0" (ноль) слева.
Синтаксис
Функция Дополнить(Знач Строка, Знач ДлинаСтроки, Знач Символ = "0", Знач Режим = "Слева") Экспорт
Параметры
Строка - Строка - исходная строка, которую необходимо дополнить символами; ДлинаСтроки - Число - требуемая результирующая длина строки; Символ - Строка - символ, которым необходимо дополнить строку; Режим - Строка - "Слева" или "Справа" - режим добавления символов к исходной строке.
Возвращаемое значение
Строка - строка, дополненная символами. Пример 1: Строка = "1234"; ДлинаСтроки = 10; Символ = "0"; Режим = "Слева" Возврат: "0000001234". Пример 2: Строка = " 1234 "; ДлинаСтроки = 10; Символ = "#"; Режим = "Справа" Возврат: "1234######".
Пример вызова
Результат = ЕХТ_Строка.Дополнить(Строка, ДлинаСтроки, Символ, Режим)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Находит в исходной строке все вхождения подстроки поиска и заменяет ее на подстроку замены. В отличии от типовой СтрЗаменить, повторяет проверку вхождения после замены и при наличии повторяет операцию.
Синтаксис
Функция ЗаменитьВсе(Знач Строка, Знач ПодстрокаПоиска, Знач ПодстрокаЗамены) Экспорт
Параметры
Строка - Строка - Исходная строка ПодстрокаПоиска - Строка - Искомая подстрока ПодстрокаЗамены - Строка - Подстрока, на которую будет заменена подстрока поиска
Пример вызова
Результат = ЕХТ_Строка.ЗаменитьВсе(Строка, ПодстрокаПоиска, ПодстрокаЗамены)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Заменяет недопустимые символы в XML-строке на заданные символы.
Синтаксис
Функция ЗаменитьНедопустимыеСимволыXML(Знач Текст, СимволЗамены = " ") Экспорт
Параметры
Текст - Строка - строка, в которой требуется выполнить замену недопустимых символов. СимволЗамены - Строка - строка, на которую требуется выполнить замену недопустимого символа в XML-строке.
Возвращаемое значение
Строка - строка, полученная заменой недопустимых символов в XML-строке.
Пример вызова
Результат = ЕХТ_Строка.ЗаменитьНедопустимыеСимволыXML(Текст, СимволЗамены)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Заменяет в строке значения из ключа списка на значение списка.
Синтаксис
Функция ЗаменитьПоСписку(Знач Строка, Знач Список, Знач ПроверитьВхождение = Истина) Экспорт
Пример вызова
Результат = ЕХТ_Строка.ЗаменитьПоСписку(Строка, Список, ПроверитьВхождение)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Выполняет замену всех символов в строке на выбранный.
Синтаксис
Функция ЗаменитьСимволыНаОдин(Знач Строка, Знач ЗаменяемыеСимволы, Знач СимволЗамены) Экспорт
Параметры
Строка - Строка - исходная строка, в которой требуется замена символов;
ЗаменяемыеСимволы - Строка - строка символов, каждый из которых требует замены;
СимволЗамены - Строка - символов замены, на который нужно заменить символы параметра
ЗаменяемыеСимволы.
Возвращаемое значение
Строка - строка после замены символов.
Пример вызова
Результат = ЕХТ_Строка.ЗаменитьСимволыНаОдин(Строка, ЗаменяемыеСимволы, СимволЗамены)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Выполняет замену символов в строке. Предназначена для простых случаев - например, для замены латиницы на похожие кириллические символы.
Синтаксис
Функция ЗаменитьСимволыПарами(Знач Строка, Знач ЗаменяемыеСимволы, Знач СимволыЗамены) Экспорт
Параметры
Строка - Строка - исходная строка, в которой требуется замена символов;
ЗаменяемыеСимволы - Строка - строка символов, каждый из которых требует замены;
СимволыЗамены - Строка - строка символов, на каждый из которых нужно заменить символы параметра
ЗаменяемыеСимволы.
Возвращаемое значение
Строка - строка после замены символов.
Пример вызова
Результат = ЕХТ_Строка.ЗаменитьСимволыПарами(Строка, ЗаменяемыеСимволы, СимволыЗамены)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает идентификатор из представления.
Синтаксис
Функция ИдентификаторИзПредставления(Знач Представление) Экспорт
Пример вызова
Результат = ЕХТ_Строка.ИдентификаторИзПредставления(Представление)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает строку, декодированную из Base64.
Синтаксис
Функция ИзBase64(Знач Строка) Экспорт
Параметры
Строка - Строка - Строка, которую нужно декодировать.
Возвращаемое значение
- Строка
Пример вызова
Результат = ЕХТ_Строка.ИзBase64(Строка)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает строку очищенную от тэгов HTML.
Синтаксис
Функция ИзHTML(Знач ТекстHTML) Экспорт
Параметры
ТекстHTML - Строка - Строка, которую нужно очистить.
Возвращаемое значение
- Строка
Пример вызова
Результат = ЕХТ_Строка.ИзHTML(ТекстHTML)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает строку из строки Unicode. Источник: https://infostart.ru/ajax/comment_pub.php?t=64971&c=18
Синтаксис
Функция ИзUnicode(Знач Строка) Экспорт
Пример вызова
Результат = ЕХТ_Строка.ИзUnicode(Строка)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает строку состояющую из заданного количества кавычек.
Синтаксис
Функция Кавычки(Знач Количество = 1) Экспорт
Пример вызова
Результат = ЕХТ_Строка.Кавычки(Количество)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает строку со всеми символами кириллицы в обоих регистрах.
Синтаксис
Функция Кириллица() Экспорт
Возвращаемое значение
- Строка
Пример вызова
Результат = ЕХТ_Строка.Кириллица()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает строку со всеми символами латиницы в обоих регистрах.
Синтаксис
Функция Латиница() Экспорт
Возвращаемое значение
- Строка
Пример вызова
Результат = ЕХТ_Строка.Латиница()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает строку между переданными подстроками.
Синтаксис
Функция Между(Знач Строка, Знач НачальнаяПодстрока, Знач КонечнаяПодстрока, ДополнительныеПараметры = Неопределено) Экспорт
Параметры
Строка - Строка - Строка, в которой выполняется поиск. НачальнаяПодстрока - Строка - Искомый префикс. КонечнаяПодстрока - Строка - Искомый суффикс. ДополнительныеПараметры - Структура - см. тело функции.
Возвращаемое значение
- Строка
Пример вызова
Результат = ЕХТ_Строка.Между(Строка, НачальнаяПодстрока, КонечнаяПодстрока, ДополнительныеПараметры)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает строку между переданными подстроками, включая начальную и конечную подстроку.
Синтаксис
Функция МеждуВключаяПодстроки(Знач Строка, Знач НачальнаяПодстрока, Знач КонечнаяПодстрока, ДополнительныеПараметры = Неопределено) Экспорт
Параметры
Строка - Строка - Строка, в которой выполняется поиск. НачальнаяПодстрока - Строка - Искомый префикс. КонечнаяПодстрока - Строка - Искомый суффикс. ДополнительныеПараметры - Структура - см. тело функции.
Возвращаемое значение
- Строка
Пример вызова
Результат = ЕХТ_Строка.МеждуВключаяПодстроки(Строка, НачальнаяПодстрока, КонечнаяПодстрока, ДополнительныеПараметры)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает массив всех подстрок между переданными подстроками.
Синтаксис
Функция НайтиВсеМежду(Знач Строка, Знач НачальнаяПодстрока, Знач КонечнаяПодстрока, ДополнительныеПараметры = Неопределено) Экспорт
Параметры
Строка - Строка - Строка, в которой выполняется поиск. НачальнаяПодстрока - Строка - Искомый префикс. КонечнаяПодстрока - Строка - Искомый суффикс. ДополнительныеПараметры - Структура - см. тело функции.
Возвращаемое значение
- Массив
Пример вызова
Результат = ЕХТ_Строка.НайтиВсеМежду(Строка, НачальнаяПодстрока, КонечнаяПодстрока, ДополнительныеПараметры)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает массив всех подстрок между переданными подстроками, включая начальную и конечную подстроку.
Синтаксис
Функция НайтиВсеМеждуВключаяПодстроки(Знач Строка, Знач НачальнаяПодстрока, Знач КонечнаяПодстрока, ДополнительныеПараметры = Неопределено) Экспорт
Параметры
Строка - Строка - Строка, в которой выполняется поиск. НачальнаяПодстрока - Строка - Искомый префикс. КонечнаяПодстрока - Строка - Искомый суффикс. ДополнительныеПараметры - Структура - см. тело функции.
Возвращаемое значение
- Массив
Пример вызова
Результат = ЕХТ_Строка.НайтиВсеМеждуВключаяПодстроки(Строка, НачальнаяПодстрока, КонечнаяПодстрока, ДополнительныеПараметры)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Удаляет из строки указанные символы.
Синтаксис
Функция Очистить(Знач Строка, Знач УдалитьСимволы) Экспорт
Пример вызова
Результат = ЕХТ_Строка.Очистить(Строка, УдалитьСимволы)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает строку до разделителя, не включая разделитель.
Синтаксис
Функция Перед(Знач Строка, Знач Разделитель, Остаток = Неопределено) Экспорт
Параметры
Строка - Строка - исходная строка.
Разделитель - Строка - один или несколько символов.
Остаток - Строка - если разделитель найден, то в параметре возвращается остаток строки, включая разделитель,
иначе возвращается вся строка.
Возвращаемое значение
- строка до разделителя
Пример вызова
Результат = ЕХТ_Строка.Перед(Строка, Разделитель, Остаток)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Формирует строку из заданного количества повторяющихся строк.
Синтаксис
Функция Повторить(Знач ПовторяемыйФрагмент, Знач КоличествоПовторов) Экспорт
Пример вызова
Результат = ЕХТ_Строка.Повторить(ПовторяемыйФрагмент, КоличествоПовторов)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Подставляет параметры в строку. Максимально возможное число параметров - 9. Параметры в строке задаются как %<номер параметра>. Нумерация параметров начинается с единицы.
Синтаксис
Функция ПодставитьПараметры(Знач ШаблонСтроки, Знач Параметр1, Знач Параметр2 = Неопределено, Знач Параметр3 = Неопределено, Знач Параметр4 = Неопределено, Знач Параметр5 = Неопределено, Знач Параметр6 = Неопределено, Знач Параметр7 = Неопределено, Знач Параметр8 = Неопределено, Знач Параметр9 = Неопределено) Экспорт
Параметры
ШаблонСтроки - Строка - шаблон строки с параметрами (вхождениями вида "%<номер параметра>",
например "%1 пошел в %2");
Параметр<n> - Строка - значение подставляемого параметра.
Возвращаемое значение
Строка - текстовая строка с подставленными параметрами.
Пример вызова
ЕХТ_Строка.ПодставитьПараметры(НСтр("ru='%1 пошел в %2'"), "Вася", "Зоопарк") = "Вася пошел
в Зоопарк".
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает строку после разделителя, не включая разделитель.
Синтаксис
Функция После(Знач Строка, Знач Разделитель, Начало = Неопределено) Экспорт
Параметры
Строка - Строка - исходная строка.
Разделитель - Строка - один или несколько символов.
Начало - Строка - если разделитель найден, то в параметре возвращается начало строки, включая разделитель,
иначе возвращается вся строка.
Возвращаемое значение
- строка после разделителя
Пример вызова
Результат = ЕХТ_Строка.После(Строка, Разделитель, Начало)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает представление из идентификатора.
Синтаксис
Функция ПредставлениеИзИдентификатора(Знач Идентификатор) Экспорт
Пример вызова
Результат = ЕХТ_Строка.ПредставлениеИзИдентификатора(Идентификатор)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Проверяет строку на соответствие регулярному выражению. Источник: https://infostart.ru/public/464971
Синтаксис
Функция Проверить(Знач Строка, Знач Паттерн) Экспорт
Пример вызова
ЕХТ.СообщитьПользователю(ЕХТ_Строка.Проверить("01.01.2012","\d{2}\.\d{2}\.\d{4}")); // Истина
ЕХТ.СообщитьПользователю(ЕХТ_Строка.Проверить("01.01.20121","\d{2}\.\d{2}\.\d{4}")); // Ложь
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Разбивает строку на несколько строк по указанному разделителю. Разделитель может иметь любую длину. В случаях, когда разделителем является строка из одного символа, и не используется параметр СокращатьНепечатаемыеСимволы, рекомендуется использовать функцию платформы СтрРазделить.
Синтаксис
Функция РазложитьВМассивПодстрок(Знач Значение, Знач Разделитель = ",", Знач ПропускатьПустыеСтроки = Неопределено, СокращатьНепечатаемыеСимволы = Ложь) Экспорт
Параметры
Значение - Строка - текст с разделителями.
Разделитель - Строка - разделитель строк текста, минимум 1 символ.
ПропускатьПустыеСтроки - Булево - признак необходимости включения в результат пустых строк.
Если параметр не задан, то функция работает в режиме совместимости со своей предыдущей версией:
> для разделителя-пробела пустые строки не включаются в результат, для остальных разделителей пустые строки
включаются в результат;
> если параметр Строка не содержит значащих символов или не содержит ни одного символа (пустая строка), то в
случае разделителя-пробела результатом функции будет массив, содержащий одно значение "" (пустая строка), а
при других разделителях результатом функции будет пустой массив.
СокращатьНепечатаемыеСимволы - Булево - сокращать непечатаемые символы по краям каждой из найденных подстрок.
Возвращаемое значение
Массив из Строка
Пример вызова
СтроковыеФункцииКлиентСервер.РазложитьСтрокуВМассивПодстрок(",один,,два,", ",")
- возвратит массив из 5 элементов, три из которых - пустые: "", "один", "", "два", "";
СтроковыеФункцииКлиентСервер.РазложитьСтрокуВМассивПодстрок(",один,,два,", ",", Истина)
- возвратит массив из двух элементов: "один", "два";
СтроковыеФункцииКлиентСервер.РазложитьСтрокуВМассивПодстрок(" один два ", " ")
- возвратит массив из двух элементов: "один", "два";
СтроковыеФункцииКлиентСервер.РазложитьСтрокуВМассивПодстрок("")
- возвратит пустой массив;
СтроковыеФункцииКлиентСервер.РазложитьСтрокуВМассивПодстрок("",,Ложь)
- возвратит массив с одним элементом: ""(пустая строка);
СтроковыеФункцииКлиентСервер.РазложитьСтрокуВМассивПодстрок("", " ")
- возвратит массив с одним элементом: "" (пустая строка).
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает строку с кавычками.
Синтаксис
Функция сКавычками(Знач Строка = "", Знач ДобавитьПоКраям = 1, Знач УдвоитьВСтроке = Ложь) Экспорт
Параметры
Строка - Строка - Исходная строка. ДобавитьПоКраям - Число - Количество добавляемых кавычек. УдвоитьВСтроке - Булево - Удвоить кавычки в строке.
Возвращаемое значение
- Строка
Пример вызова
Результат = ЕХТ_Строка.сКавычками(Строка, ДобавитьПоКраям, УдвоитьВСтроке)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает Истина, если в строке содержится любой из символов.
Синтаксис
Функция Содержит(Знач Строка, Знач Символы) Экспорт
Пример вызова
Результат = ЕХТ_Строка.Содержит(Строка, Символы)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает Истина, если в проверяемой строке есть русские буквы.
Синтаксис
Функция СодержитКириллицу(Знач Строка) Экспорт
Пример вызова
Результат = ЕХТ_Строка.СодержитКириллицу(Строка)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Сокращает строку до нужной длины, при этом обрезанная часть возвращается в виде хеша, обеспечивая уникальность строки. Проверяет длину строки на входе и, в случае превышения максимальной длины, преобразует ее конец по алгоритму MD5 в уникальную строку из 32 символов.
Синтаксис
Функция СократитьКонтрольнойСуммой(Знач Строка, Знач МаксимальнаяДлина) Экспорт
Параметры
Строка - Строка - исходная строка произвольной длины.
МаксимальнаяДлина - Число - требуемое максимальное количество символов в строке,
минимальное значение: 32.
Возвращаемое значение
Строка - строка, не превышающая максимальную длину.
Пример вызова
Результат = ЕХТ_Строка.СократитьКонтрольнойСуммой(Строка, МаксимальнаяДлина)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает соответствие национального алфавита и латиницы.
Синтаксис
Функция СоответствиеНациональногоАлфавитаИЛатиницы() Экспорт
Возвращаемое значение
- Строка
Пример вызова
Результат = ЕХТ_Строка.СоответствиеНациональногоАлфавитаИЛатиницы()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Подставляет параметры в строку. Максимально возможное число параметров - 9. Параметры в строке задаются как %<номер параметра>. Нумерация параметров начинается с единицы.
Синтаксис
Функция сПараметрами(Знач ШаблонСтроки, Знач Параметр1, Знач Параметр2 = Неопределено, Знач Параметр3 = Неопределено, Знач Параметр4 = Неопределено, Знач Параметр5 = Неопределено, Знач Параметр6 = Неопределено, Знач Параметр7 = Неопределено, Знач Параметр8 = Неопределено, Знач Параметр9 = Неопределено) Экспорт
Параметры
ШаблонСтроки - Строка - шаблон строки с параметрами (вхождениями вида "%<номер параметра>",
например "%1 пошел в %2");
Параметр<n> - Строка - значение подставляемого параметра.
Возвращаемое значение
Строка - текстовая строка с подставленными параметрами.
Пример вызова
ЕХТ_Строка.сПараметрами(НСтр("ru='%1 пошел в %2'"), "Вася", "Зоопарк") = "Вася пошел
в Зоопарк".
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Подставляет параметры в строку. Число параметров в строке не ограничено. Параметры в строке задаются как %<номер параметра>. Нумерация параметров начинается с единицы.
Синтаксис
Функция сПараметрамиИзМассива(Знач ШаблонСтроки, Знач Параметры) Экспорт
Параметры
ШаблонСтроки - Строка - шаблон строки с параметрами (вхождениями вида "%<номер параметра>",
например "%1 пошел в %2");
Параметры - Массив - значения параметров в строке ШаблонСтроки.
Возвращаемое значение
Строка - строка с подставленными значениями параметрами.
Пример вызова
ЗначенияПараметров = Новый Массив;
ЗначенияПараметров.Добавить("Вася");
ЗначенияПараметров.Добавить("Зоопарк");
Результат = ЕХТ_Строка.сПараметрамиИзМассива(НСтр("ru='%1 пошел в %2'"), ЗначенияПараметров);
- вернет строку "Вася пошел в Зоопарк".
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Формирует представление числа для определенного языка и параметров числа.
Синтаксис
Функция сЧислом(Шаблон, Число, Вид = Неопределено, ФорматнаяСтрока = Неопределено) Экспорт
Параметры
Шаблон - Строка - строка, содержит перечисленные через точку с запятой 6 форм строки
для каждой категории числительного:
- %1 обозначает позицию числа;
Число - Число - число, которое будет подставлено в строку вместо параметра "%1".
Вид - ВидЧисловогоЗначения - определяет вид числового значения, для которого формируется представление.
- Количественное (по умолчанию) или Порядковое.
ФорматнаяСтрока - Строка - строка параметров форматирования. См. аналогичный параметр в СтрокаСЧислом.
Возвращаемое значение
Строка - представление строки числа в требуемой форме.
Пример вызова
// Представление параметров:
//
// Lang | Zero | One | Two | Few | Many | Other
// ============================================================================================================
// ru | | XX1 / X11 | | XX2-XX4 / X12-X14 | XX0, XX5-XX9, X11-X14 | дробные
// Card.| | остался %1 день | | осталось %1 дня | осталось %1 дней | осталось %1 дня
// | | вижу %1 рыбу | | вижу %1-х рыб | вижу %5 рыб | вижу %1 рыбы
// ------------------------------------------------------------------------------------------------------------
// ru | | | | | | других нет
// Ord. | | | | | | %1-й день
// ------------------------------------------------------------------------------------------------------------
// en | | для 1 | | | | остальное
// Card.| | left %1 day | | | | left %1 days
// ------------------------------------------------------------------------------------------------------------
// en | | XX1 / X11 | XX2 / X12 | XX3 / X13 | | остальное
// Ord. | | %1st day | %1nd day | %1rd day | | %1th day.
// Card. - Cardinal - Количественное;
// Ord. - Ordinal - Порядковое;
// X - любая цифра;
// / - кроме.
Строка = СтроковыеФункцииКлиентСервер.СтрокаСЧисломДляЛюбогоЯзыка(
НСтр("ru=';остался %1 день;;осталось %1 дня;осталось %1 дней;осталось %1 дня';
|en=';left %1 day;;;;left %1 days'"),
0.05,, "ЧДЦ=1");
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает Истина если в строке содержатся только заданные символы.
Синтаксис
Функция ТолькоДопустимыеСимволы(Знач Строка, Знач ДопустимыеСимволы) Экспорт
Параметры
Строка - Строка - Проверяемая строка. ДопустимыеСимволы - Строка - Строка допустимых символов.
Возвращаемое значение
- Булево
Пример вызова
Результат = ЕХТ_Строка.ТолькоДопустимыеСимволы(Строка, ДопустимыеСимволы)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Проверяет, содержит ли строка только цифры.
Синтаксис
Функция ТолькоЦифры(Знач Значение, Знач Устаревший = Истина, Знач ПробелыЗапрещены = Истина) Экспорт
Параметры
Значение - Строка - проверяемая строка. Устаревший - Булево - устаревший параметр, не используется. ПробелыЗапрещены - Булево - если Ложь, то в строке допустимо наличие пробелов.
Возвращаемое значение
Булево - Истина - строка содержит только цифры или пустая, Ложь - строка содержит иные символы.
Пример вызова
Результат = СтроковыеФункцииКлиентСервер.ТолькоЦифрыВСтроке("0123"); // Истина
Результат = СтроковыеФункцииКлиентСервер.ТолькоЦифрыВСтроке("0123abc"); // Ложь
Результат = СтроковыеФункцииКлиентСервер.ТолькоЦифрыВСтроке("01 2 3",, Ложь); // Истина
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Удаляет из строки префикс или суффикс.
Синтаксис
Функция Удалить(Знач Строка, Знач Префикс = Неопределено, Знач Суффикс = Неопределено, Знач УдалитьВсе = Ложь) Экспорт
Пример вызова
Результат = ЕХТ_Строка.Удалить(Строка, Префикс, Суффикс, УдалитьВсе)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Удаляет недопустимые символы в XML-строке.
Синтаксис
Функция УдалитьНедопустимыеСимволыXML(Знач Текст) Экспорт
Параметры
Текст - Строка - строка, в которой требуется удалить недопустимые символы.
Возвращаемое значение
Строка - строка, полученная при удалении недопустимых символов в XML-строке.
Пример вызова
Результат = ЕХТ_Строка.УдалитьНедопустимыеСимволыXML(Текст)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Удаляет из строки префикс.
Синтаксис
Функция УдалитьСлева(Знач Строка, Знач Префикс, Знач УдалитьВсе = Ложь) Экспорт
Пример вызова
Результат = ЕХТ_Строка.УдалитьСлева(Строка, Префикс, УдалитьВсе)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Удаляет из строки суффикс.
Синтаксис
Функция УдалитьСправа(Знач Строка, Знач Суффикс, Знач УдалитьВсе = Ложь) Экспорт
Пример вызова
Результат = ЕХТ_Строка.УдалитьСправа(Строка, Суффикс, УдалитьВсе)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Форматирует строку в соответствии с заданным шаблоном. Для создания форматированной строки рекомендуется использовать одноименные функции в общих модулях СтроковыеФункции и СтроковыеФункцииКлиент поддерживающие расширенные возможности оформления текста элементами стиля. Возможные значения тегов в шаблоне: - <b> Строка </b> - выделяет строку жирным шрифтом. - <a href = "Ссылка"> Строка </a> - добавляет гиперссылку. Например, "Минимальная версия программы <b>1.1</b>. <a href = "Обновление">Обновите</a> программу.".
Синтаксис
Функция ФорматированнаяСтрока(Знач СтрокаСТегами) Экспорт
Параметры
СтрокаСТегами - Строка - строка, содержащая теги форматирования.
Возвращаемое значение
ФорматированнаяСтрока - преобразованная строка.
Пример вызова
Результат = ЕХТ_Строка.ФорматированнаяСтрока(СтрокаСТегами)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает последнюю подстроку из строки с разделителями. Если строка пустая или ни один из разделителей не найден, то возвращает пустую строку.
Синтаксис
Функция Хвост(Знач Строка, Знач Разделители) Экспорт
Пример вызова
Результат = ЕХТ_Строка.Хвост(Строка, Разделители)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возращает Истина если переданная строка является допустимым идентификатором.
Синтаксис
Функция ЭтоИдентификатор(Знач Строка) Экспорт
Параметры
Строка - Строка - Проверяемая строка.
Возвращаемое значение
- Булево
Пример вызова
Результат = ЕХТ_Строка.ЭтоИдентификатор(Строка)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает Истина если переданный символ является разделителем слов.
Синтаксис
Функция ЭтоРазделительСлов(Знач Символ) Экспорт
Параметры
Символ - Строка - Проверяемый символ.
Возвращаемое значение
- Булево
Пример вызова
Результат = ЕХТ_Строка.ЭтоРазделительСлов(Символ)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает массив из полученной структуры. В качестве элементов массива могут быть как ключи, так и значения структуры
Синтаксис
Функция вМассив(Знач Структура, Знач КлючИлиЗначение = "Значение") Экспорт
Пример вызова
Результат = ЕХТ_Структура.вМассив(Структура, КлючИлиЗначение)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает фиксированный массив из параметров выбора
Синтаксис
Функция вПараметрыВыбора(Знач Структура) Экспорт
Пример вызова
Результат = ЕХТ_Структура.вПараметрыВыбора(Структура)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Вставляет в структуру значение и возвращает это значение.
Синтаксис
Функция Вставить(Структура, Знач Ключ, Знач Значение = Неопределено) Экспорт
Пример вызова
Результат = ЕХТ_Структура.Вставить(Структура, Ключ, Значение)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает Строку, полученную из Структуры (см. описание ИзСтрокиПараметров) Значения структуры могут быть пустыми. Не должны содержать кавычки и ;
Синтаксис
Функция вСтрокуПараметров(Знач СтруктураПараметров) Экспорт
Пример вызова
Результат = ЕХТ_Структура.вСтрокуПараметров(СтруктураПараметров)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает строку из полученной структуры
Синтаксис
Функция вСтрокуСоЗначениями(Структура, РазделительСтрок = ",", РазделительКлючаЗначения = ":") Экспорт
Пример вызова
Результат = ЕХТ_Структура.вСтрокуСоЗначениями(Структура, РазделительСтрок, ", РазделительКлючаЗначения)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Дополняет структуру значениями из другой структуры.
Синтаксис
Функция Дополнить(Приемник, Знач Источник, Знач Заменять = Неопределено, Знач ИсключаяСвойства = Неопределено, Знач Префикс = "") Экспорт
Параметры
Приемник - Структура - коллекция, в которую будут добавляться новые значения.
Источник - Структура - коллекция, из которой будут считываться пары Ключ и Значение для заполнения.
Заменять - Булево, Неопределено - Что делать в местах пересечения ключей источника и приемника:
Истина - Заменять значения приемника (самый быстрый способ),
Ложь - Не заменять значения приемника (пропускать),
Неопределено - Значение по умолчанию. Бросать исключение.
Пример вызова
Результат = ЕХТ_Структура.Дополнить(Приемник, Источник, Заменять, ИсключаяСвойства, Префикс)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Заполняет все значения структуры заданным значением.
Синтаксис
Функция Заполнить(Структура, Знач Значение) Экспорт
Пример вызова
Результат = ЕХТ_Структура.Заполнить(Структура, Значение)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает значение свойства структуры.
Синтаксис
Функция Значение(Знач Структура, Знач Ключ, Знач ЗначениеПоУмолчанию = Неопределено) Экспорт
Параметры
Структура - Структура
- ФиксированнаяСтруктура - объект, из которого необходимо прочитать значение ключа.
Ключ - Строка - имя свойства структуры, для которого необходимо прочитать значение.
ЗначениеПоУмолчанию - Произвольный - необязательный. Возвращается когда в структуре нет значения по указанному
ключу.
Для скорости рекомендуется передавать только быстро вычисляемые значения (например примитивные типы),
а инициализацию более тяжелых значений выполнять после проверки полученного значения (только если это
требуется).
Возвращаемое значение
Произвольный - значение свойства структуры. ЗначениеПоУмолчанию если в структуре нет указанного свойства.
Пример вызова
Результат = ЕХТ_Структура.Значение(Структура, Ключ, ЗначениеПоУмолчанию)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает Структуру, созданную из полученного Соответствия.
Синтаксис
Функция ИзСоответствия(Знач Соответствие) Экспорт
Пример вызова
Результат = ЕХТ_Структура.ИзСоответствия(Соответствие)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Получает значения параметров из строки.
Синтаксис
Функция ИзСтрокиПараметров(Знач СтрокаПараметров) Экспорт
Параметры
СтрокаПараметров - Строка - строка, содержащая параметры, каждый из которых представляет собой
фрагмент вида <Имя параметра>=<Значение>, где:
Имя параметра - имя параметра;
Значение - его значение.
Фрагменты отделяются друг от друга символами ';'.
Если значение содержит пробельные символы, то оно должно быть заключено в двойные
кавычки (").
Например:
"File=""c:\InfoBases\Trade""; Usr=""Director"";"
Разделитель - Строка - символ, которым фрагменты отделяются друг от друга.
Возвращаемое значение
Структура - значения параметров, где ключ - имя параметра, значение - значение параметра.
Пример вызова
Результат = ЕХТ_Структура.ИзСтрокиПараметров("File=""c:\InfoBases\Trade""; Usr=""Director"";""");
- вернет структуру:
ключ "File" и значение "c:\InfoBases\Trade"
ключ "Usr" и значение "Director".
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает структуру из строки, где элементы структуры разделены РазделительСтрок, а ключ и значение - РазделительКлючаЗначения. Значение в строке может отсутствовать, тогда в значение структуры помещается Ключ
Синтаксис
Функция ИзСтрокиСоЗначениями(Знач Строка, РазделительСтрок = ",", РазделительКлючаЗначения = ":") Экспорт
Пример вызова
Результат = ЕХТ_Структура.ИзСтрокиСоЗначениями(Строка, РазделительСтрок, ", РазделительКлючаЗначения)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Очищает значения свойств структуры.
Синтаксис
Процедура ОчиститьЗначения(Структура) Экспорт
Параметры
Структура - Структура - очищаемая структура.
Пример вызова
ЕХТ_Структура.ОчиститьЗначения(Структура)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Создает копию значения типа Структура, рекурсивно, с учетом типов значений свойств. Если свойства структуры содержат значения объектных типов (СправочникОбъект, ДокументОбъект и т.п.), то их содержимое не копируются, а возвращаются ссылки на исходный объект.
Синтаксис
Функция Скопировать(СтруктураИсточник, Знач ИсключаяСвойства = "") Экспорт
Параметры
СтруктураИсточник - Структура - копируемая структура.
Возвращаемое значение
Структура - копия исходной структуры.
Пример вызова
Результат = ЕХТ_Структура.Скопировать(СтруктураИсточник, ИсключаяСвойства)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает массив ключей
Синтаксис
Функция СписокСвойств(Знач Структура, Знач ИсключаяСвойства = Неопределено) Экспорт
Пример вызова
Результат = ЕХТ_Структура.СписокСвойств(Структура, ИсключаяСвойства)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает, разделенную запятыми, строку ключей структуры
Синтаксис
Функция СтрокаСвойств(Знач Структура, Знач ИсключаяСвойства = Неопределено, Знач Разделитель = ",") Экспорт
Пример вызова
Результат = ЕХТ_Структура.СтрокаСвойств(Структура, ИсключаяСвойства, Разделитель, ")
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Удаляет из структуры заданные свойства
Синтаксис
Функция УдалитьСвойства(Структура, Знач СтрокаСвойств) Экспорт
Пример вызова
Результат = ЕХТ_Структура.УдалитьСвойства(Структура, СтрокаСвойств)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает фиксированную структуру с фиксированными значениями.
Синтаксис
Функция Фиксировать(Знач Структура) Экспорт
Параметры
Структура - Структура - Исходная структура.
Возвращаемое значение
ФиксированнаяСтруктура -
Пример вызова
Результат = ЕХТ_Структура.Фиксировать(Структура)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Преобразовывает таблицу значений в структуру структур
Синтаксис
Функция вСтруктуруСтруктур(ТЗ, Знач ИмяКлючевойКолонки) Экспорт
Параметры
Таблица - Таблица значений, которую необходимо преобразовать.
КолонкаКлюч - Строка - ключ возвращаемой структуры
Возвращаемое значение
Структура - Структура структур, повторяющая все строки со всеми колонками переданной таблицы значений.
Пример вызова
Результат = ЕХТ_ТаблицаЗначений.вСтруктуруСтруктур(ТЗ, ИмяКлючевойКолонки)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает табличный документ, сформированный из таблицы значений.
Синтаксис
Функция вТабличныйДокумент(Знач ТаблицаЗначений, ДополнительныеПараметры = Неопределено) Экспорт
Параметры
ТаблицаЗначений - ТаблицаЗначений - Произвольная таблица значений. ДополнительныеПараметры - Структура - Дополнительные параметры: - АвтоподборШириныКолонок - Булево (по умолчанию - Истина).
Возвращаемое значение
ТабличныйДокумент - сформированный ТабличныйДокумент. Пример вызова функции: ТабличныйДокумент = ЕХТ_ТаблицаЗначений.вТабличныйДокумент(ТаблицаЗначений);
Пример вызова
Результат = ЕХТ_ТаблицаЗначений.вТабличныйДокумент(ТаблицаЗначений, ДополнительныеПараметры)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Выводит ТЗ на форму.
Синтаксис
Процедура ВывестиНаФорму(Знач ТЗ, Форма, Знач ИмяРеквизитаФормы, Знач ДополнительныеПараметры = Неопределено) Экспорт
Параметры
ТЗ - ТаблицаЗначений - ТаблицаЗначений, которую нужно вывести на форму.
Форма - УправляемаяФорма - Форма, в которую нажно вывести ТЗ.
ИмяРеквизитаФормы - Строка - Имя реквизита формы.
ДополнительныеПараметры - Структура - Дополнительные параметры вывода.
Пример вызова:
ТЗ = ЕХТ_ТаблицаЗначений.Создать("К1,К2,К3", ЕХТ_Тип.ОписаниеЧисло(3, 0));
ГСЧ = Новый ГенераторСлучайныхЧисел;
Для н = 1 по 3 Цикл
СтрокаТЗ = ТЗ.Добавить();
СтрокаТЗ.К1 = ГСЧ.СлучайноеЧисло(1, 100);
СтрокаТЗ.К2 = ГСЧ.СлучайноеЧисло(1, 100);
СтрокаТЗ.К3 = ГСЧ.СлучайноеЧисло(1, 100);
КонецЦикла;
ДополнительныеПараметры = Новый Структура;
ДополнительныеПараметры.Вставить("Родитель", "Группа2");
ДополнительныеПараметры.Вставить("Перед", "Реквизит2");
// ДополнительныеПараметры.Вставить("БезОтступа");
СписокДействий = Новый Структура;
СписокДействий.Вставить("ПриИзменении", "Подключаемый_ПриИзменении");
ДополнительныеПараметры.Вставить("СписокДействий", СписокДействий);
ЕХТ_ТаблицаЗначений.ВывестиНаФорму(ТЗ, ЭтотОбъект, "ТЗ", ДополнительныеПараметры);
Пример вызова
ЕХТ_ТаблицаЗначений.ВывестиНаФорму(ТЗ, Форма, ИмяРеквизитаФормы, ДополнительныеПараметры)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает массив со значениями из указанной колонки
Синтаксис
Функция ВыгрузитьКолонку(Знач ТаблицаЗначений, Знач ИмяКолонки, Знач Свернуть = Ложь) Экспорт
Параметры
ТаблицаЗначений - произвольная таблица значений ИмяКолонки - Строка - имя выгружаемой колонки Свернуть - Булево - оставить в массиве только уникальные значения
Возвращаемое значение
Массив - массив с выгруженными значениями
Пример вызова
Результат = ЕХТ_ТаблицаЗначений.ВыгрузитьКолонку(ТаблицаЗначений, ИмяКолонки, Свернуть)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает добавленную и заполненную строку ТаблицыЗначений
Синтаксис
Функция Добавить(Знач ТаблицаЗначений, Знач ЗначенияЗаполнения = Неопределено) Экспорт
Пример вызова
Результат = ЕХТ_ТаблицаЗначений.Добавить(ТаблицаЗначений, ЗначенияЗаполнения)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Добавляет индексы в ТаблицуЗначений Возвращает эту же ТаблицуЗначений
Синтаксис
Функция ДобавитьИндексы(ТаблицаЗначений, Знач СтрокаИндексов) Экспорт
Пример вызова
Результат = ЕХТ_ТаблицаЗначений.ДобавитьИндексы(ТаблицаЗначений, СтрокаИндексов)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Добавляет колонки в ТаблицуЗначений Возвращает эту же ТаблицуЗначений
Синтаксис
Функция ДобавитьКолонки(ТаблицаЗначений, Знач СтрокаКолонок, Знач ОписанияТипаКолонок = Неопределено) Экспорт
Пример вызова
Результат = ЕХТ_ТаблицаЗначений.ДобавитьКолонки(ТаблицаЗначений, СтрокаКолонок, ОписанияТипаКолонок)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Добавляет колонки с префиксом "_Нрег_".
Синтаксис
Функция ДобавитьКолонкиНРег(ТЗ, Знач СтрокаКолонок) Экспорт
Пример вызова
Результат = ЕХТ_ТаблицаЗначений.ДобавитьКолонкиНРег(ТЗ, СтрокаКолонок)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Дополняет таблицу-приемник данными данными из таблицы источника
Синтаксис
Процедура Дополнить(Приемник, Знач Источник) Экспорт
Параметры
Приемник - ТаблицаЗначений - таблица в которую будут добавлены строки из таблицы-источника Источник - ТаблицаЗначений - таблица из которой будут браться строки для заполнения
Пример вызова
ЕХТ_ТаблицаЗначений.Дополнить(Приемник, Источник)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Очищает таблицу-приемник и заполняет данными из таблицы-источника.
Синтаксис
Процедура Заполнить(Приемник, Знач Источник) Экспорт
Параметры
Приемник - ТаблицаЗначений - таблица в которую будут добавлены строки из таблицы-источника Источник - ТаблицаЗначений - таблица из которой будут браться строки для заполнения
Пример вызова
ЕХТ_ТаблицаЗначений.Заполнить(Приемник, Источник)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Заполняет колонки строками в нижнем регистре.
Синтаксис
Процедура ЗаполнитьКолонкиНРег(СтрокаТЗ) Экспорт
Пример вызова
ЕХТ_ТаблицаЗначений.ЗаполнитьКолонкиНРег(СтрокаТЗ)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Заполняет номером строки заданную колонку ТаблицыЗначений. Если такой колонки в ТаблицеЗначений нет, то создается
Синтаксис
Процедура ЗаполнитьНомерСтроки(ТаблицаЗначений, Знач ИмяКолонки, Знач ОписаниеТипаКолонки=Неопределено, Знач НачатьНумерацию = 1) Экспорт
Пример вызова
ЕХТ_ТаблицаЗначений.ЗаполнитьНомерСтроки(ТаблицаЗначений, ИмяКолонки, ОписаниеТипаКолонки, НачатьНумерацию)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает таблицу значений из макета, в котором содержатся описания колонок и данные
Синтаксис
Функция ИзМакета(Знач Макет, Знач СписокНомеровИсключаемыхКолонок = Неопределено) Экспорт
Пример вызова
Результат = ЕХТ_ТаблицаЗначений.ИзМакета(Макет, СписокНомеровИсключаемыхКолонок)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает число количества строк. Если указан параметр НовоеКоличество, то изменяет количество строк.
Синтаксис
Функция Количество(ТаблицаЗначений, Знач НовоеКоличество = Неопределено) Экспорт
Пример вызова
Результат = ЕХТ_ТаблицаЗначений.Количество(ТаблицаЗначений, НовоеКоличество)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Аналогично платформенному методу Найти.
Синтаксис
Функция НайтиНРег(ТЗ, Знач Значение, Знач ИмяКолонки) Экспорт
Пример вызова
Результат = ЕХТ_ТаблицаЗначений.НайтиНРег(ТЗ, Значение, ИмяКолонки)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Аналогично платформенному методу НайтиСтроки.
Синтаксис
Функция НайтиСтрокиНРег(ТЗ, Отбор) Экспорт
Пример вызова
Результат = ЕХТ_ТаблицаЗначений.НайтиСтрокиНРег(ТЗ, Отбор)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает копию таблицы значений, свернутую с помощью агрегатных функций запроса Источник: https://infostart.ru/public/723744
Синтаксис
Функция СвернутьЗапросом(Знач ТаблицаЗначений, Знач КолонкиГруппировок, Знач КолонкиСуммирования, Знач Ф = "СУММА") Экспорт
Пример вызова
Результат = ЕХТ_ТаблицаЗначений.СвернутьЗапросом(ТаблицаЗначений, КолонкиГруппировок, КолонкиСуммирования, Ф)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Аналогично платформенному методу Скопировать.
Синтаксис
Функция СкопироватьНРег(ТЗ, Знач Строки = Неопределено, Знач Колонки = Неопределено) Экспорт
Пример вызова
Результат = ЕХТ_ТаблицаЗначений.СкопироватьНРег(ТЗ, Строки, Колонки)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Создает ТаблицуЗначений с заданными параметрами.
Синтаксис
Функция Создать(Знач СтрокаКолонок, Знач ОписанияТипаКолонок = Неопределено, Знач СтрокаИндексов = "", Знач КоличествоСтрок = 0) Экспорт
Параметры
СтрокаКолонок - Строка - Строка колонок через запятую, которые нужно добавить. ОписанияТипаКолонок - ОписаниеТипа - Описание типа устанавливаемого для всех колонок. СтрокаИндексов - Строка - Строка с индексами через запятую, которые нужно добавить. КоличествоСтрок - Число - В созданной таблице значений будет добавлено данное количество строк.
Возвращаемое значение
- ТаблицаЗначений - созданная таблица значений.
Пример вызова
Результат = ЕХТ_ТаблицаЗначений.Создать(СтрокаКолонок, ОписанияТипаКолонок, СтрокаИндексов, КоличествоСтрок)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает массив с именами колонок таблицы.
Синтаксис
Функция СписокКолонок(Знач ТаблицаЗначений, Знач ИсключитьКолонки = "") Экспорт
Параметры
ТаблицаЗначений - ТаблицаЗначений - Таблица значений, из которой нужно получить имена колонок. ИсключитьКолонки - Строка - Строка колонок через запятую, которые не нужно возвращать.
Возвращаемое значение
- Массив - Массив с именами колонок таблицы значений.
Пример вызова
Результат = ЕХТ_ТаблицаЗначений.СписокКолонок(ТаблицаЗначений, ИсключитьКолонки)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает Истина, если две таблицы значений полностью идентичны
Синтаксис
Функция Сравнить(Знач ТЗ1, Знач ТЗ2) Экспорт
Пример вызова
Результат = ЕХТ_ТаблицаЗначений.Сравнить(ТЗ1, ТЗ2)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает строку колонок таблицы значений через запятую.
Синтаксис
Функция СтрокаКолонок(Знач ТаблицаЗначений, Знач ИсключитьКолонки = "") Экспорт
Параметры
ТаблицаЗначений - ТаблицаЗначений - Таблица значений, из которой нужно получить имена колонок. ИсключитьКолонки - Строка - Строка колонок через запятую, которые не нужно возвращать.
Возвращаемое значение
- Строка - Строка с именами колонок через запятую.
Пример вызова
Результат = ЕХТ_ТаблицаЗначений.СтрокаКолонок(ТаблицаЗначений, ИсключитьКолонки)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Преобразовывает строку таблицы значений в структуру
Синтаксис
Функция СтрокуВСтруктуру(Знач СтрокаТаблицы, Знач СтрокаКолонок = Неопределено, Знач ИсключаяКолонки = Неопределено) Экспорт
Параметры
СтрокаТаблицы - Строка таблицы значений, которую необходимо преобразовать. СписокСвойств - Строка - Список колонок через запятую, которые необходимо включить ИсключаяСвойства - Строка - Список колонок через запятую, которые не будут выгружены
Возвращаемое значение
Структура - Структура структур, повторяющая все строки со всеми колонками переданной таблицы значений.
Пример вызова
Результат = ЕХТ_ТаблицаЗначений.СтрокуВСтруктуру(СтрокаТаблицы, СтрокаКолонок, ИсключаяКолонки)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Удаляет заданные колонки из таблицы значений.
Синтаксис
Процедура УдалитьКолонки(ТЗ, Знач СтрокаКолонок) Экспорт
Параметры
ТЗ - ТаблицаЗначений - таблица, в которой нужно удалить колонки. СтрокаКолонок - Строка - строка колонок через запятую.
Пример вызова
ЕХТ_ТаблицаЗначений.УдалитьКолонки(ТЗ, СтрокаКолонок)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Автоматическая установка ширины колонки табличного документа. Источник: https://helpf.pro/faq/view/417
Синтаксис
Процедура АвтоподборШириныКолонок(ТабличныйДокумент) Экспорт
Пример вызова
ЕХТ_ТабличныйДокумент.АвтоподборШириныКолонок(ТабличныйДокумент)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает строку HTML.
Синтаксис
Функция вHTML(Знач ТабличныйДокумент) Экспорт
Пример вызова
Результат = ЕХТ_ТабличныйДокумент.вHTML(ТабличныйДокумент)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Оформляет ячейку в виде гиперссылки и заполняет поля адреса и представления ссылки.
Синтаксис
Процедура ВывестиГиперссылку(Ячейка, Знач АдресСсылки, Знач ПредставлениеСсылки = Неопределено) Экспорт
Параметры
Ячейка - ОбластьЯчеекТабличногоДокумента - область табличного документа.
АдресСсылки - Строка - адрес ссылки, которую необходимо вывести в указанной ячейке.
В стандартной форме отчета автоматически открываются ссылки следующих форматов:
"http://<адрес>", "https://<адрес>", "e1cib/<адрес>", "e1c://<адрес>"
Такие ссылки открываются при помощи процедуры ОбщегоНазначенияКлиент.ОткрытьНавигационнуюСсылку.
См. также ПредставлениеНавигационнойСсылки.НавигационнаяСсылка в синтакс-помощнике.
Для открытия ссылок других форматов следует написать код
в процедуре ОтчетыКлиентПереопределяемый.ОбработкаВыбораТабличногоДокумента.
ПредставлениеСсылки - Строка, Неопределено - наименование, которую необходимо вывести в указанной ячейке.
Если Неопределено, то выводится как есть АдресСсылки.
Пример вызова
ЕХТ_ТабличныйДокумент.ВывестиГиперссылку(Ячейка, АдресСсылки, ПредставлениеСсылки)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает массив с границами и типами выделенных областей.
Синтаксис
Функция ВыделенныеОбласти(Знач ТабличныйДокумент) Экспорт
Пример вызова
Результат = ЕХТ_ТабличныйДокумент.ВыделенныеОбласти(ТабличныйДокумент)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает свойства области.
Синтаксис
Функция СвойстваОбласти(Знач ТабличныйДокумент, Знач Область) Экспорт
Пример вызова
Результат = ЕХТ_ТабличныйДокумент.СвойстваОбласти(ТабличныйДокумент, Область)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Удаляет в табличном документе колонки с номерам из массива.
Синтаксис
Процедура УдалитьКолонки(ТабличныйДокумент, Знач МассивКолонок) Экспорт
Пример вызова
ЕХТ_ТабличныйДокумент.УдалитьКолонки(ТабличныйДокумент, МассивКолонок)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Процедура управляет состояние поля табличного документа.
Синтаксис
Процедура УстановитьСостояниеПоляОтчета(ОтображениеСостояния, Знач Состояние="НеИспользовать") Экспорт
Параметры
ОтображениеСостояния - ПолеФормы - поле формы с видом ПолеТабличногоДокумента,
для которого необходимо установить состояние.
Состояние - Строка - задает вид состояния.
Пример вызова
ЕХТ_ТабличныйДокумент.УстановитьСостояниеПоляОтчета(ОтображениеСостояния, Состояние)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает примерно 0.35 мм. https://partners.v8.1c.ru/forum/topic/1391514#m_1391514
Синтаксис
Функция ВысотаПунктаВМиллиметрах() Экспорт
Пример вызова
Результат = ЕХТ_ТабличныйДокументСервер.ВысотаПунктаВМиллиметрах()
Доступность
Сервер, Вызов сервера
ОбъединитьЯчейки Находит ячейки, содержащие в тексте МаркерОбъединения Объединяет ячейки, располагающиеся рядом, содержащие одинаковый текст и маркер объединения
Синтаксис
Процедура ОбъединитьЯчейки(ТабличныйДокумент, Знач МаркерОбъединения) Экспорт
Пример вызова
ЕХТ_ТабличныйДокументСервер.ОбъединитьЯчейки(ТабличныйДокумент, МаркерОбъединения)
Доступность
Сервер, Вызов сервера
Возвращает описания форматов сохранения табличного документа.
Синтаксис
Функция ТаблицаТиповФайлов() Экспорт
Возвращаемое значение
ТаблицаЗначений: * ТипФайлаТабличногоДокумента - ТипФайлаТабличногоДокумента - значение, соответствующее формату; * Ссылка - ПеречислениеСсылка.ФорматыСохраненияОтчетов - ссылка на метаданные, где хранится представление; * Представление - Строка - представление типа файла (заполняется из перечисления); * Расширение - Строка - тип файла для операционной системы; * Картинка - Картинка - картинка формата.
Пример вызова
Результат = ЕХТ_ТабличныйДокументСервер.ТаблицаТиповФайлов()
Доступность
Сервер, Вызов сервера
Возвращает примерно 1.85 мм. https://partners.v8.1c.ru/forum/topic/1391514#m_1391514
Синтаксис
Функция ШиринаПунктаВМиллиметрах() Экспорт
Пример вызова
Результат = ЕХТ_ТабличныйДокументСервер.ШиринаПунктаВМиллиметрах()
Доступность
Сервер, Вызов сервера
Возвращает строковое представление типа. Для ссылочных типов возвращает в формате "СправочникСсылка.ИмяОбъекта" или "ДокументСсылка.ИмяОбъекта". Для остальных типов приводит тип к строке, например "Число".
Синтаксис
Функция вСтроку(Знач Тип) Экспорт
Параметры
Тип - Тип - для которого надо получить представление.
Возвращаемое значение
Строка - представление типа.
Пример вызова
Результат = ЕХТ_Тип.вСтроку(Тип)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает Истина, если тип переданного значения соответствует ожидаемому типу.
Синтаксис
Функция ЗначениеОжидаемогоТипа(Знач Значение, Знач ОжидаемыеТипы) Экспорт
Пример вызова
Результат = ЕХТ_Тип.ЗначениеОжидаемогоТипа(Значение, ОжидаемыеТипы)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает значение для идентификации типа "Бизнес-процесс".
Синтаксис
Функция ИмяБизнесПроцесс() Экспорт
Возвращаемое значение
Строка.
Пример вызова
Результат = ЕХТ_Тип.ИмяБизнесПроцесс()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает значение для идентификации общего типа "Бизнес-процессы".
Синтаксис
Функция ИмяБизнесПроцессы() Экспорт
Возвращаемое значение
Строка.
Пример вызова
Результат = ЕХТ_Тип.ИмяБизнесПроцессы()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает значение для идентификации типа "Документ".
Синтаксис
Функция ИмяДокумент() Экспорт
Возвращаемое значение
Строка.
Пример вызова
Результат = ЕХТ_Тип.ИмяДокумент()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает значение для идентификации общего типа "Документы".
Синтаксис
Функция ИмяДокументы() Экспорт
Возвращаемое значение
Строка.
Пример вызова
Результат = ЕХТ_Тип.ИмяДокументы()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает значение для идентификации типа "Журнал документов".
Синтаксис
Функция ИмяЖурналДокументов() Экспорт
Возвращаемое значение
Строка.
Пример вызова
Результат = ЕХТ_Тип.ИмяЖурналДокументов()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает значение для идентификации общего типа "Журналы документов".
Синтаксис
Функция ИмяЖурналыДокументов() Экспорт
Возвращаемое значение
Строка.
Пример вызова
Результат = ЕХТ_Тип.ИмяЖурналыДокументов()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает значение для идентификации типа "Задача".
Синтаксис
Функция ИмяЗадача() Экспорт
Возвращаемое значение
Строка.
Пример вызова
Результат = ЕХТ_Тип.ИмяЗадача()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает значение для идентификации общего типа "Задачи".
Синтаксис
Функция ИмяЗадачи() Экспорт
Возвращаемое значение
Строка.
Пример вызова
Результат = ЕХТ_Тип.ИмяЗадачи()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает значение для идентификации типа "Константа".
Синтаксис
Функция ИмяКонстанта() Экспорт
Возвращаемое значение
Строка.
Пример вызова
Результат = ЕХТ_Тип.ИмяКонстанта()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает значение для идентификации общего типа "Константы".
Синтаксис
Функция ИмяКонстанты() Экспорт
Возвращаемое значение
Строка.
Пример вызова
Результат = ЕХТ_Тип.ИмяКонстанты()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает значение для идентификации типа "Перечисление".
Синтаксис
Функция ИмяПеречисление() Экспорт
Возвращаемое значение
Строка.
Пример вызова
Результат = ЕХТ_Тип.ИмяПеречисление()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает значение для идентификации общего типа "Перечисления".
Синтаксис
Функция ИмяПеречисления() Экспорт
Возвращаемое значение
Строка.
Пример вызова
Результат = ЕХТ_Тип.ИмяПеречисления()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает значение для идентификации типа "План видов расчета".
Синтаксис
Функция ИмяПланВидовРасчета() Экспорт
Возвращаемое значение
Строка.
Пример вызова
Результат = ЕХТ_Тип.ИмяПланВидовРасчета()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает значение для идентификации типа "План видов характеристик".
Синтаксис
Функция ИмяПланВидовХарактеристик() Экспорт
Возвращаемое значение
Строка.
Пример вызова
Результат = ЕХТ_Тип.ИмяПланВидовХарактеристик()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает значение для идентификации типа "План обмена".
Синтаксис
Функция ИмяПланОбмена() Экспорт
Возвращаемое значение
Строка.
Пример вызова
Результат = ЕХТ_Тип.ИмяПланОбмена()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает значение для идентификации типа "План счетов".
Синтаксис
Функция ИмяПланСчетов() Экспорт
Возвращаемое значение
Строка.
Пример вызова
Результат = ЕХТ_Тип.ИмяПланСчетов()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает значение для идентификации общего типа "Планы видов расчета".
Синтаксис
Функция ИмяПланыВидовРасчета() Экспорт
Возвращаемое значение
Строка.
Пример вызова
Результат = ЕХТ_Тип.ИмяПланыВидовРасчета()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает значение для идентификации общего типа "Планы видов характеристик".
Синтаксис
Функция ИмяПланыВидовХарактеристик() Экспорт
Возвращаемое значение
Строка.
Пример вызова
Результат = ЕХТ_Тип.ИмяПланыВидовХарактеристик()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает значение для идентификации общего типа "Планы обмена".
Синтаксис
Функция ИмяПланыОбмена() Экспорт
Возвращаемое значение
Строка.
Пример вызова
Результат = ЕХТ_Тип.ИмяПланыОбмена()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает значение для идентификации общего типа "Планы счетов".
Синтаксис
Функция ИмяПланыСчетов() Экспорт
Возвращаемое значение
Строка.
Пример вызова
Результат = ЕХТ_Тип.ИмяПланыСчетов()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает значение для идентификации общего типа "Последовательности".
Синтаксис
Функция ИмяПоследовательности() Экспорт
Возвращаемое значение
Строка.
Пример вызова
Результат = ЕХТ_Тип.ИмяПоследовательности()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает значение для идентификации типа "Последовательность".
Синтаксис
Функция ИмяПоследовательность() Экспорт
Возвращаемое значение
Строка.
Пример вызова
Результат = ЕХТ_Тип.ИмяПоследовательность()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает значение для идентификации типа "Регистр бухгалтерии".
Синтаксис
Функция ИмяРегистрБухгалтерии() Экспорт
Возвращаемое значение
Строка.
Пример вызова
Результат = ЕХТ_Тип.ИмяРегистрБухгалтерии()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает значение для идентификации общего типа "Регистр накопления".
Синтаксис
Функция ИмяРегистрНакопления() Экспорт
Возвращаемое значение
Строка.
Пример вызова
Результат = ЕХТ_Тип.ИмяРегистрНакопления()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает значение для идентификации общего типа "Регистр расчета".
Синтаксис
Функция ИмяРегистрРасчета() Экспорт
Возвращаемое значение
Строка.
Пример вызова
Результат = ЕХТ_Тип.ИмяРегистрРасчета()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает значение для идентификации типа "Регистр сведений".
Синтаксис
Функция ИмяРегистрСведений() Экспорт
Возвращаемое значение
Строка.
Пример вызова
Результат = ЕХТ_Тип.ИмяРегистрСведений()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает значение для идентификации общего типа "Регистры бухгалтерии".
Синтаксис
Функция ИмяРегистрыБухгалтерии() Экспорт
Возвращаемое значение
Строка.
Пример вызова
Результат = ЕХТ_Тип.ИмяРегистрыБухгалтерии()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает значение для идентификации общего типа "Регистры накопления".
Синтаксис
Функция ИмяРегистрыНакопления() Экспорт
Возвращаемое значение
Строка.
Пример вызова
Результат = ЕХТ_Тип.ИмяРегистрыНакопления()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает значение для идентификации общего типа "Регистры расчета".
Синтаксис
Функция ИмяРегистрыРасчета() Экспорт
Возвращаемое значение
Строка.
Пример вызова
Результат = ЕХТ_Тип.ИмяРегистрыРасчета()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает значение для идентификации общего типа "Регистры сведений".
Синтаксис
Функция ИмяРегистрыСведений() Экспорт
Возвращаемое значение
Строка.
Пример вызова
Результат = ЕХТ_Тип.ИмяРегистрыСведений()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает значение для идентификации типа "Регламентное задание".
Синтаксис
Функция ИмяРегламентноеЗадание() Экспорт
Возвращаемое значение
Строка.
Пример вызова
Результат = ЕХТ_Тип.ИмяРегламентноеЗадание()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает значение для идентификации общего типа "Регламентные задания".
Синтаксис
Функция ИмяРегламентныеЗадания() Экспорт
Возвращаемое значение
Строка.
Пример вызова
Результат = ЕХТ_Тип.ИмяРегламентныеЗадания()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает значение для идентификации типа "Справочник".
Синтаксис
Функция ИмяСправочник() Экспорт
Возвращаемое значение
Строка.
Пример вызова
Результат = ЕХТ_Тип.ИмяСправочник()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает значение для идентификации общего типа "Справочники".
Синтаксис
Функция ИмяСправочники() Экспорт
Возвращаемое значение
Строка.
Пример вызова
Результат = ЕХТ_Тип.ИмяСправочники()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает описание типов, содержащее все ссылочные типы объектов метаданных, существующих в конфигурации и расширениях.
Синтаксис
Функция ОписаниеВсеСсылки() Экспорт
Пример вызова
Результат = ЕХТ_Тип.ОписаниеВсеСсылки()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает ОписаниеТипа из строки вида "Число, 1, 0" или "Справочник.Номенклатура"
Синтаксис
Функция ОписаниеИзСтроки(Знач ОписаниеТипаСтрокой, Знач ОписаниеТипаПоУмолчанию = Неопределено, Знач Разделитель = ",") Экспорт
Пример вызова
Результат = ЕХТ_Тип.ОписаниеИзСтроки(ОписаниеТипаСтрокой, ОписаниеТипаПоУмолчанию, Разделитель, ")
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает описание типов, содержащее типы Число, Строка, Булево, Дата, УникальныйИдентификатор, ОписаниеТипов.
Синтаксис
Функция ОписаниеПримитивныхТипов() Экспорт
Пример вызова
Результат = ЕХТ_Тип.ОписаниеПримитивныхТипов()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает описание типов, содержащее все ссылочные типы объектов метаданных, существующих в конфигурации и расширениях.
Синтаксис
Функция ОписаниеСсылочныхТипов() Экспорт
Пример вызова
Результат = ЕХТ_Тип.ОписаниеСсылочныхТипов()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает Истина, если любой тип из ОписаниеТипа1 содержится в ОписаниеТипа2.
Синтаксис
Функция Пересекается(Знач ОписаниеТипа1, Знач ОписаниеТипа2) Экспорт
Пример вызова
Результат = ЕХТ_Тип.Пересекается(ОписаниеТипа1, ОписаниеТипа2)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает строковое представление типа.
Синтаксис
Функция Представление(Знач Тип, Знач ДлинаПредставления = 150) Экспорт
Параметры
Тип - Тип - тип, представление которого нужно получить. ДлинаПредставления - Число - максимальная длина строки представления.
Пример вызова
Результат = ЕХТ_Тип.Представление(Тип, ДлинаПредставления)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает пустое значение заданного типа: примитивного или ссылочного.
Синтаксис
Функция ПустоеЗначение(Знач ЗаданныйТип) Экспорт
Параметры
ЗаданныйТип - тип, пустое значение которого нужно получить.
Пример вызова
Результат = ЕХТ_Тип.ПустоеЗначение(ЗаданныйТип)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает Истина, если переданный тип это перечисление.
Синтаксис
Функция ЭтоПеречисление(Знач Тип) Экспорт
Пример вызова
Результат = ЕХТ_Тип.ЭтоПеречисление(Тип)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает Истина, если проверяемый тип входит в состав примитивных типов.
Синтаксис
Функция ЭтоПримитивный(Знач ПроверяемыйТип) Экспорт
Пример вызова
Результат = ЕХТ_Тип.ЭтоПримитивный(ПроверяемыйТип)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает Истина, если проверяемый тип является ссылочным типом объектов метаданных, существующих в конфигурации и расширениях.
Синтаксис
Функция ЭтоСсылочный(Знач ПроверяемыйТип) Экспорт
Пример вызова
Результат = ЕХТ_Тип.ЭтоСсылочный(ПроверяемыйТип)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает описание типов, содержащее все примитивные типы. в конфигурации.
Синтаксис
Функция ОписаниеПримитивныхТипов() Экспорт
Возвращаемое значение
ОписаниеТипов - описание.
Пример вызова
Результат = ЕХТ_ТипПовтИсп.ОписаниеПримитивныхТипов()
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает описание типов, содержащее все ссылочные типы объектов метаданных, существующих в конфигурации.
Синтаксис
Функция ОписаниеСсылочныхТипов() Экспорт
Возвращаемое значение
ОписаниеТипов - описание.
Пример вызова
Результат = ЕХТ_ТипПовтИсп.ОписаниеСсылочныхТипов()
Доступность
Сервер, Вызов сервера, Внешнее соединение
Добавляет элемент условного оформления в форму.
Синтаксис
Функция Добавить(ФормаИлиСписок, ИменаПолей) Экспорт
Параметры
ФормаИлиСписок - ФормаКлиентскогоПриложения, ДинамическийСписок - Форма или список,
в который необходимо добавить условное оформление.
ИменаПолей - Строка - Имена элементов формы, разделенные запятыми, для которых применяется оформление.
Например: "Поле1, Поле2".
Если необходимо чтобы условное оформление применялось ко всем строкам таблицы, тогда:
- Для условного оформления управляемой формы в параметре "ИменаПолей" следует передать имя таблицы формы.
- Для условного оформления динамического списка в параметре "ИменаПолей" следует передать пустую строку.
Возвращаемое значение
ЭлементУсловногоОформленияКомпоновкиДанных - Добавленный элемент условного оформления формы или списка.
Пример вызова
Результат = ЕХТ_УсловноеОформление.Добавить(ФормаИлиСписок, ИменаПолей)
Доступность
Сервер
Добавляет отбор элемента условного оформления.
Синтаксис
Функция ДобавитьГруппуОтборов(ОформлениеКД, ТипГруппы) Экспорт
Параметры
ОформлениеКД - ЭлементУсловногоОформленияКомпоновкиДанных, ГруппаЭлементовОтбораКомпоновкиДанных -
Элемент условного оформления формы или группа отборов.
ТипГруппы - ТипГруппыЭлементовОтбораКомпоновкиДанных, Строка - Тип группы отборов.
Поддерживаемые значения типа "Строка": "И", "ИЛИ", "НЕ".
Возвращаемое значение
ГруппаЭлементовОтбораКомпоновкиДанных - Группа элементов отбора.
Пример вызова
Результат = ЕХТ_УсловноеОформление.ДобавитьГруппуОтборов(ОформлениеКД, ТипГруппы)
Доступность
Сервер
Добавляет отбор элемента условного оформления.
Синтаксис
Функция ДобавитьОтбор(ОформлениеКД, Поле, ПараметрВидСравнения = "=", Значение = Неопределено) Экспорт
Параметры
ОформлениеКД - ЭлементУсловногоОформленияКомпоновкиДанных, ГруппаЭлементовОтбораКомпоновкиДанных -
Элемент условного оформления формы или группа отборов.
Поле - Строка - Имя поля отбора.
ПараметрВидСравнения - ВидСравненияКомпоновкиДанных, Строка - Вид сравнения отбора.
Если указано значение "=", то используется ВидСравненияКомпоновкиДанных.Равно.
Поддерживаемые значения типа "Строка": "=", "<>", ">", ">=", "<", "<=".
Значение - Произвольный - Значение отбора. Необязательный если ВидСравнения = Заполнено или НеЗаполнено.
Возвращаемое значение
ЭлементОтбораКомпоновкиДанных - Добавленный элемент отбора.
Пример вызова
Результат = ЕХТ_УсловноеОформление.ДобавитьОтбор(ОформлениеКД, Поле, ПараметрВидСравнения, Значение)
Доступность
Сервер
См "[Взрыв шаблона!] Новый способ программной настройки условного оформления." https://infostart.ru/public/1161402/
Синтаксис
Функция Настройка(УсловноеОформление) Экспорт
Пример вызова
Результат = ЕХТ_УсловноеОформление.Настройка(УсловноеОформление)
Доступность
Сервер
Устанавливает параметр условного оформления.
Синтаксис
Процедура УстановитьПараметр(ОформлениеКД, ИмяПараметра, ЗначениеПараметра) Экспорт
Параметры
ОформлениеКД - ЭлементУсловногоОформленияКомпоновкиДанных - Элемент условного оформления формы.
ИмяПараметра - Строка - Имя параметра или параметр компоновки данных, значение которого нужно установить.
Имена параметров см. в синтакс-помощнике: "ОформлениеКомпоновкиДанных", блок "Описание".
ЗначениеПараметра - Произвольный - Значение, которое нужно установить.
Типы значений см. в синтакс-помощнике: "ОформлениеКомпоновкиДанных", блок "Описание".
Пример вызова
ЕХТ_УсловноеОформление.УстановитьПараметр(ОформлениеКД, ИмяПараметра, ЗначениеПараметра)
Доступность
Сервер
Возвращает время последнего изменения файла.
Синтаксис
Функция ВремяИзменения(Знач ИмяФайла) Экспорт
Пример вызова
Результат = ЕХТ_Файлы.ВремяИзменения(ИмяФайла)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Заменяет недопустимые символы в имени файла.
Синтаксис
Функция ЗаменитьНедопустимыеСимволыВИмениФайла(Знач ИмяФайла, НаЧтоМенять = " ") Экспорт
Параметры
ИмяФайла - Строка - исходное имя файла. НаЧтоМенять - Строка - строка, на которую необходимо заменить недопустимые символы.
Возвращаемое значение
Строка - преобразованное имя файла.
Пример вызова
Результат = ЕХТ_Файлы.ЗаменитьНедопустимыеСимволыВИмениФайла(ИмяФайла, НаЧтоМенять)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Проверяет имя файла на соответствие маске файлов.
Синтаксис
Функция ИмяСоответствуетМаске(Знач ИмяФайла, Знач Маска = "*.*") Экспорт
Параметры
ИмяФайла - Строка - проверямое имя файла. Маска - Строка - маска файлов.
Возвращаемое значение
Булево - Истина, если соответствует, иначе Ложь.
Пример вызова
Результат = ЕХТ_Файлы.ИмяСоответствуетМаске(ИмяФайла, Маска)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает индекс пиктограммы файла - индекс в картинке КоллекцияПиктограммФайлов.
Синтаксис
Функция ИндексПиктограммы(Знач ИмяФайла) Экспорт
Пример вызова
Результат = ЕХТ_Файлы.ИндексПиктограммы(ИмяФайла)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает кодировку файла.
Синтаксис
Функция КодировкаФайла(Знач Файл, Знач Расширение = Неопределено) Экспорт
Параметры
Файл - Строка или Двоичные данные - Файл, кодировку которого необходимо определить. Расширение - Строка - Расширение файла.
Возвращаемое значение
Кодировка - Строка - Кодировка файла.
Пример вызова
Результат = ЕХТ_Файлы.КодировкаФайла(Файл, Расширение)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Копирует содержимое каталога в другой каталог.
Синтаксис
Процедура КопироватьСодержимоеКаталога(Знач КаталогИсточник, Знач КаталогПриемник, Знач Маска = "*.*", Знач КопироватьПодкаталоги = Ложь) Экспорт
Параметры
КаталогИсточник - Строка - Путь к исходному каталогу. КаталогПриемник - Строка - Путь к каталогу назначения. Маска - Строка - Маска файлов. КопироватьПодкаталоги - Булево - Копировать содержимое вложенных подкаталогов.
Пример вызова
ЕХТ_Файлы.КопироватьСодержимоеКаталога(КаталогИсточник, КаталогПриемник, Маска, КопироватьПодкаталоги)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Копирует содержимое каталога с подкаталогами в другой каталог.
Синтаксис
Процедура КопироватьСодержимоеКаталогаСПодкаталогами(Знач КаталогИсточник, Знач КаталогПриемник, Знач Маска = "*.*") Экспорт
Параметры
КаталогИсточник - Строка - Путь к исходному каталогу. КаталогПриемник - Строка - Путь к каталогу назначения. Маска - Строка - Маска файлов.
Пример вызова
ЕХТ_Файлы.КопироватьСодержимоеКаталогаСПодкаталогами(КаталогИсточник, КаталогПриемник, Маска)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Проверяет наличие недопустимых символов в имени файла.
Синтаксис
Функция НайтиНедопустимыеСимволыВИмениФайла(ИмяФайла) Экспорт
Параметры
ИмяФайла - Строка - имя файла.
Возвращаемое значение
Массив - массив обнаруженных в имени файла недопустимых символов.
Если недопустимых символов не обнаружено - возвращается пустой массив.
Пример вызова
Результат = ЕХТ_Файлы.НайтиНедопустимыеСимволыВИмениФайла(ИмяФайла)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает строку недопустимых символов. Согласно http://en.wikipedia.org/wiki/Filename - в разделе "Reserved characters and words".
Синтаксис
Функция ПолучитьНедопустимыеСимволыВИмениФайла() Экспорт
Возвращаемое значение
Строка - строка недопустимых символов.
Пример вызова
Результат = ЕХТ_Файлы.ПолучитьНедопустимыеСимволыВИмениФайла()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает строковое представление размера файла.
Синтаксис
Функция ПредставлениеРазмера(Знач Размер, Знач Единица = Неопределено, Знач ВыводитьЕдиницу = Истина) Экспорт
Параметры
Размер - Число - Размер файла в байтах Единица - Строка - одно из значений: "ТБ", "ГБ", "МБ" или "КБ" ВыводитьЕдиницу - Булево - добавляет к представлению единицу
Возвращаемое значение
- Строка, представление размера
Пример вызова
Результат = ЕХТ_Файлы.ПредставлениеРазмера(Размер, Единица, ВыводитьЕдиницу)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает размер файла.
Синтаксис
Функция Размер(Знач ИмяФайла, Знач Кратность = 1, Знач Точность = 3) Экспорт
Пример вызова
Результат = ЕХТ_Файлы.Размер(ИмяФайла, Кратность, Точность)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает размер файла в гигабайтах.
Синтаксис
Функция РазмерГб(Знач ИмяФайла, Знач Точность = 3) Экспорт
Пример вызова
Результат = ЕХТ_Файлы.РазмерГб(ИмяФайла, Точность)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает размер файла в килобайтах.
Синтаксис
Функция РазмерКб(Знач ИмяФайла, Знач Точность = 3) Экспорт
Пример вызова
Результат = ЕХТ_Файлы.РазмерКб(ИмяФайла, Точность)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает размер файла в мегабайтах.
Синтаксис
Функция РазмерМб(Знач ИмяФайла, Знач Точность = 3) Экспорт
Пример вызова
Результат = ЕХТ_Файлы.РазмерМб(ИмяФайла, Точность)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает размер файла в терабайтах.
Синтаксис
Функция РазмерТб(Знач ИмяФайла, Знач Точность = 3) Экспорт
Пример вызова
Результат = ЕХТ_Файлы.РазмерТб(ИмяФайла, Точность)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает расширение файла с точкой
Синтаксис
Функция Расширение(Знач ИмяФайла) Экспорт
Параметры
ИмяФайла - Строка - имя файла с именем каталога или без.
Возвращаемое значение
Строка - расширение файла с точкой.
Пример вызова
Результат = ЕХТ_Файлы.Расширение(ИмяФайла)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает расширение файла без точки.
Синтаксис
Функция РасширениеБезТочки(Знач ИмяФайла) Экспорт
Параметры
ИмяФайла - Строка - имя файла с именем каталога или без.
Возвращаемое значение
Строка - преобразованное расширение.
Пример вызова
Результат = ЕХТ_Файлы.РасширениеБезТочки(ИмяФайла)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает фильтр, используемый для выбора файлов-изображений
Синтаксис
Функция ФильтрКартинок() Экспорт
Возвращаемое значение
Строка - строка, содержащая фильтр для файлов-изображений
Пример вызова
Результат = ЕХТ_Файлы.ФильтрКартинок()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Синтаксис
Функция ЭтоРасширениеИсполняемогоФайла(Знач Расширение) Экспорт
Параметры
Расширение - Строка - свойство Расширение объекта Файл.
Пример вызова
Результат = ЕХТ_Файлы.ЭтоРасширениеИсполняемогоФайла(Расширение)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Разделяет файл на части на сервере, помещает части во временный каталог.
Синтаксис
Функция Разделить(Знач ИмяФайла, Знач РазмерЧастиВМегабайтах=3) Экспорт
Параметры
ИмяФайла - Строка - имя файла, который требуется разделить на части. РазмерЧастиВМегабайтах - Число - размер одной части файла в мегабайтах.
Возвращаемое значение
Массив - полученные части файла, структура с ключами:
* Хранение - Строка - положение файла на сервере,
* ХешСумма - Число - значение хеш-суммы, полученное функцией CRC32.
Пример вызова
Результат = ЕХТ_ФайлыСервер.Разделить(ИмяФайла, РазмерЧастиВМегабайтах)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает размер каталога в байтах
Синтаксис
Функция РазмерКаталога(Знач Каталог) Экспорт
Пример вызова
Результат = ЕХТ_ФайлыСервер.РазмерКаталога(Каталог)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Создает временный каталог. После окончания работы с временным каталогом его необходимо удалить с помощью ФайловаяСистема.УдалитьВременныйКаталог.
Синтаксис
Функция СоздатьВременныйКаталог(Знач Расширение = "") Экспорт
Параметры
Расширение - Строка - расширение каталога, которое идентифицирует назначение временного каталога
и подсистему, которая его создала.
Рекомендуется указывать на английском языке.
Возвращаемое значение
Строка - полный путь к каталогу с разделителем пути.
Пример вызова
Результат = ЕХТ_ФайлыСервер.СоздатьВременныйКаталог(Расширение)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Удаляет временный каталог вместе с его содержимым, если возможно. Если временный каталог не может быть удален (например, он занят каким-то процессом), то в журнал регистрации записывается соответствующее предупреждение, а процедура завершается. Для совместного использования с ФайловаяСистема.СоздатьВременныйКаталог, после окончания работы с временным каталогом.
Синтаксис
Процедура УдалитьВременныйКаталог(Знач Путь) Экспорт
Параметры
Путь - Строка - полный путь к временному каталогу.
Пример вызова
ЕХТ_ФайлыСервер.УдалитьВременныйКаталог(Путь)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Удаляет временный файл. Если временный файл не может быть удален (например, он занят каким-то процессом), то в журнал регистрации записывается соответствующее предупреждение, а процедура завершается. Для совместного использования с методом ПолучитьИмяВременногоФайла, после окончания работы с временным файлом.
Синтаксис
Процедура УдалитьВременныйФайл(Знач Путь) Экспорт
Параметры
Путь - Строка - полный путь к временному файлу.
Пример вызова
ЕХТ_ФайлыСервер.УдалитьВременныйФайл(Путь)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Синтаксис
Функция ПоследнееИзМассива(Знач МассивЗаданий, Знач ПоследнееЗадание = Неопределено) Экспорт
Параметры
МассивЗаданий - Массив из ФоновоеЗадание ПоследнееЗадание - ФоновоеЗадание - Неопределено
Возвращаемое значение
ФоновоеЗадание, Неопределено
Пример вызова
Результат = ЕХТ_ФоновыеЗадания.ПоследнееИзМассива(МассивЗаданий, ПоследнееЗадание)
Доступность
Сервер, Вызов сервера
Процедура активизирует элемент формы. Если это - табличная часть, то тогда анализируется, может табличная часть на закладке и если так, то закладка становится текущей, но табличная часть не активизируется
Синтаксис
Процедура АктивизироватьЭлемент(Знач Форма, Знач ИмяЭлемента) Экспорт
Параметры
Форма - Управляемая форма ИмяЭлементаФормы - Строка - имя элемента, который необходимо активизировать
Пример вызова
ЕХТ_Форма.АктивизироватьЭлемент(Форма, ИмяЭлемента)
Доступность
Сервер, Тонкий клиент
Возвращает строку Тип для переданной формы или имени формы.
Синтаксис
Функция ВидСтр(Знач Форма) Экспорт
Параметры
Форма - УправляемаяФорма - форма, для которой нужно получить.
Возвращаемое значение
- Строка - Тип формы
Пример вызова
Результат = ЕХТ_Форма.ВидСтр(Форма)
Доступность
Сервер, Тонкий клиент
Добавляет ГруппаФормы/ОбычнаяГруппа на форму.
Синтаксис
Функция ДобавитьГруппу(Форма, Знач ИмяЭлемента, Знач РодительЭлемента = Неопределено, Знач ПередЭлементом = Неопределено, ДополнительныеСвойства = Неопределено) Экспорт
Параметры
Форма - УправляемаяФорма - Форма, в которую нужно добавить. ИмяЭлемента - Строка - Имя элемента. РодительЭлемента - Строка или Элемент - Имя элемента или Элемент - Родитель для добавляемого элемента. ПередЭлементом - Строка или Элемент - Имя элемента или Элемент, перед которым вставляется этот элемент.
Возвращаемое значение
- ЭлементФормы - добавленный элемент.
Пример вызова
Результат = ЕХТ_Форма.ДобавитьГруппу(Форма, ИмяЭлемента, РодительЭлемента, ПередЭлементом, ДополнительныеСвойства)
Доступность
Сервер, Тонкий клиент
Добавляет ГруппаФормы/ГруппаКолонок на форму.
Синтаксис
Функция ДобавитьГруппуКолонок(Форма, Знач ИмяЭлемента, Знач РодительЭлемента = Неопределено, Знач ПередЭлементом = Неопределено, ДополнительныеСвойства = Неопределено) Экспорт
Параметры
Форма - УправляемаяФорма - Форма, в которую нужно добавить. ИмяЭлемента - Строка - Имя элемента. РодительЭлемента - Строка или Элемент - Имя элемента или Элемент - Родитель для добавляемого элемента. ПередЭлементом - Строка или Элемент - Имя элемента или Элемент, перед которым вставляется этот элемент.
Возвращаемое значение
- ЭлементФормы - добавленный элемент.
Пример вызова
Результат = ЕХТ_Форма.ДобавитьГруппуКолонок(Форма, ИмяЭлемента, РодительЭлемента, ПередЭлементом, ДополнительныеСвойства)
Доступность
Сервер, Тонкий клиент
Добавляет ДекорацияФормы/Картинка на форму.
Синтаксис
Функция ДобавитьДекорациюКартинка(Форма, Знач ИмяЭлемента, Знач РодительЭлемента = Неопределено, Знач ПередЭлементом = Неопределено, ДополнительныеСвойства = Неопределено) Экспорт
Параметры
Форма - УправляемаяФорма - Форма, в которую нужно добавить. ИмяЭлемента - Строка - Имя элемента. РодительЭлемента - Строка или Элемент - Имя элемента или Элемент - Родитель для добавляемого элемента. ПередЭлементом - Строка или Элемент - Имя элемента или Элемент, перед которым вставляется этот элемент.
Возвращаемое значение
- ЭлементФормы - добавленный элемент.
Пример вызова
Результат = ЕХТ_Форма.ДобавитьДекорациюКартинка(Форма, ИмяЭлемента, РодительЭлемента, ПередЭлементом, ДополнительныеСвойства)
Доступность
Сервер, Тонкий клиент
Добавляет ПолеФормы/ПолеКартинки на форму.
Синтаксис
Функция ДобавитьКартинку(Форма, Знач ИмяЭлемента, Знач РодительЭлемента = Неопределено, Знач ПередЭлементом = Неопределено, ДополнительныеСвойства = Неопределено) Экспорт
Параметры
Форма - УправляемаяФорма - Форма, в которую нужно добавить. ИмяЭлемента - Строка - Имя элемента. РодительЭлемента - Строка или Элемент - Имя элемента или Элемент - Родитель для добавляемого элемента. ПередЭлементом - Строка или Элемент - Имя элемента или Элемент, перед которым вставляется этот элемент.
Возвращаемое значение
- ЭлементФормы - добавленный элемент.
Пример вызова
Результат = ЕХТ_Форма.ДобавитьКартинку(Форма, ИмяЭлемента, РодительЭлемента, ПередЭлементом, ДополнительныеСвойства)
Доступность
Сервер, Тонкий клиент
Добавляет КнопкаФормы на форму.
Синтаксис
Функция ДобавитьКнопку(Форма, Знач ИмяИлиКоманда, Знач РодительЭлемента = Неопределено, Знач ПередЭлементом = Неопределено, ДополнительныеСвойства = Неопределено) Экспорт
Параметры
Форма - УправляемаяФорма - Форма, в которую нужно добавить. ИмяЭлемента - Строка - Имя элемента. РодительЭлемента - Строка или Элемент - Имя элемента или Элемент - Родитель для добавляемого элемента. ПередЭлементом - Строка или Элемент - Имя элемента или Элемент, перед которым вставляется этот элемент.
Возвращаемое значение
- ЭлементФормы - добавленный элемент.
Пример вызова
Результат = ЕХТ_Форма.ДобавитьКнопку(Форма, ИмяИлиКоманда, РодительЭлемента, ПередЭлементом, ДополнительныеСвойства)
Доступность
Сервер, Тонкий клиент
Добавляет ГруппаФормы/КоманднаяПанель на форму.
Синтаксис
Функция ДобавитьКоманднуюПанель(Форма, Знач ИмяЭлемента, Знач РодительЭлемента = Неопределено, Знач ПередЭлементом = Неопределено, ДополнительныеСвойства = Неопределено) Экспорт
Параметры
Форма - УправляемаяФорма - Форма, в которую нужно добавить. ИмяЭлемента - Строка - Имя элемента. РодительЭлемента - Строка или Элемент - Имя элемента или Элемент - Родитель для добавляемого элемента. ПередЭлементом - Строка или Элемент - Имя элемента или Элемент, перед которым вставляется этот элемент.
Возвращаемое значение
- ЭлементФормы - добавленный элемент.
Пример вызова
Результат = ЕХТ_Форма.ДобавитьКоманднуюПанель(Форма, ИмяЭлемента, РодительЭлемента, ПередЭлементом, ДополнительныеСвойства)
Доступность
Сервер, Тонкий клиент
Добавляет связанные Команду и КнопкаФормы на форму.
Синтаксис
Функция ДобавитьКомандуИКнопку(Форма, Знач ИмяКомандыИКнопки, Знач РодительЭлемента = Неопределено, Знач ПередЭлементом = Неопределено) Экспорт
Параметры
Форма - УправляемаяФорма - Форма, в которую нужно добавить. ИмяКомандыИКнопки - Строка или Структура - Имя команды или Структура со свойством Имя. РодительЭлемента - Строка или Элемент - Имя элемента или Элемент - Родитель для добавляемого элемента. ПередЭлементом - Строка или Элемент - Имя элемента или Элемент, перед которым вставляется этот элемент.
Возвращаемое значение
- Структура - Структура со свойствами Команда и Кнопка.
Пример вызова
Результат = ЕХТ_Форма.ДобавитьКомандуИКнопку(Форма, ИмяКомандыИКнопки, РодительЭлемента, ПередЭлементом)
Доступность
Сервер, Тонкий клиент
Добавляет ДекорацияФормы/Надпись на форму.
Синтаксис
Функция ДобавитьНадпись(Форма, Знач ИмяЭлемента, Знач РодительЭлемента = Неопределено, Знач ПередЭлементом = Неопределено, ДополнительныеСвойства = Неопределено) Экспорт
Параметры
Форма - УправляемаяФорма - Форма, в которую нужно добавить. ИмяЭлемента - Строка - Имя элемента. РодительЭлемента - Строка или Элемент - Имя элемента или Элемент - Родитель для добавляемого элемента. ПередЭлементом - Строка или Элемент - Имя элемента или Элемент, перед которым вставляется этот элемент.
Возвращаемое значение
- ЭлементФормы - добавленный элемент.
Пример вызова
Результат = ЕХТ_Форма.ДобавитьНадпись(Форма, ИмяЭлемента, РодительЭлемента, ПередЭлементом, ДополнительныеСвойства)
Доступность
Сервер, Тонкий клиент
Добавляет ГруппаФормы/Подменю на форму.
Синтаксис
Функция ДобавитьПодменю(Форма, Знач ИмяЭлемента, Знач РодительЭлемента = Неопределено, Знач ПередЭлементом = Неопределено, ДополнительныеСвойства = Неопределено) Экспорт
Параметры
Форма - УправляемаяФорма - Форма, в которую нужно добавить. ИмяЭлемента - Строка - Имя элемента. РодительЭлемента - Строка или Элемент - Имя элемента или Элемент - Родитель для добавляемого элемента. ПередЭлементом - Строка или Элемент - Имя элемента или Элемент, перед которым вставляется этот элемент.
Возвращаемое значение
- ЭлементФормы - добавленный элемент.
Пример вызова
Результат = ЕХТ_Форма.ДобавитьПодменю(Форма, ИмяЭлемента, РодительЭлемента, ПередЭлементом, ДополнительныеСвойства)
Доступность
Сервер, Тонкий клиент
Добавляет ПолеФормы/ПолеHTMLДокумента на форму.
Синтаксис
Функция ДобавитьПолеHTMLДокумента(Форма, Знач ИмяИлиРеквизит, Знач РодительЭлемента = Неопределено, Знач ПередЭлементом = Неопределено, ДополнительныеСвойства = Неопределено) Экспорт
Параметры
Форма - УправляемаяФорма - Форма, в которую нужно добавить. ИмяЭлемента - Строка - Имя элемента или путь к данным элемента. РодительЭлемента - Строка или Элемент - Имя элемента или Элемент - Родитель для добавляемого элемента. ПередЭлементом - Строка или Элемент - Имя элемента или Элемент, перед которым вставляется этот элемент.
Возвращаемое значение
- ЭлементФормы - добавленный элемент.
Пример вызова
Результат = ЕХТ_Форма.ДобавитьПолеHTMLДокумента(Форма, ИмяИлиРеквизит, РодительЭлемента, ПередЭлементом, ДополнительныеСвойства)
Доступность
Сервер, Тонкий клиент
Добавляет ПолеФормы/ПолеВвода на форму.
Синтаксис
Функция ДобавитьПолеВвода(Форма, Знач ИмяИлиРеквизит, Знач РодительЭлемента = Неопределено, Знач ПередЭлементом = Неопределено, ДополнительныеСвойства = Неопределено) Экспорт
Параметры
Форма - УправляемаяФорма - Форма, в которую нужно добавить. ИмяЭлемента - Строка - Имя элемента или путь к данным элемента. РодительЭлемента - Строка или Элемент - Имя элемента или Элемент - Родитель для добавляемого элемента. ПередЭлементом - Строка или Элемент - Имя элемента или Элемент, перед которым вставляется этот элемент.
Возвращаемое значение
- ЭлементФормы - добавленный элемент.
Пример вызова
Результат = ЕХТ_Форма.ДобавитьПолеВвода(Форма, ИмяИлиРеквизит, РодительЭлемента, ПередЭлементом, ДополнительныеСвойства)
Доступность
Сервер, Тонкий клиент
Добавляет ТаблицаФормы на форму.
Синтаксис
Функция ДобавитьТаблицу(Форма, Знач ИмяИлиРеквизит, Знач РодительЭлемента = Неопределено, Знач ПередЭлементом = Неопределено, ДополнительныеСвойства = Неопределено) Экспорт
Параметры
Форма - УправляемаяФорма - Форма, в которую нужно добавить. ИмяЭлемента - Строка - Имя элемента или путь к данным элемента. РодительЭлемента - Строка или Элемент - Имя элемента или Элемент - Родитель для добавляемого элемента. ПередЭлементом - Строка или Элемент - Имя элемента или Элемент, перед которым вставляется этот элемент.
Возвращаемое значение
- ЭлементФормы - добавленный элемент.
Пример вызова
Результат = ЕХТ_Форма.ДобавитьТаблицу(Форма, ИмяИлиРеквизит, РодительЭлемента, ПередЭлементом, ДополнительныеСвойства)
Доступность
Сервер, Тонкий клиент
Добавляет ПолеПереключателя/Тумблер на форму.
Синтаксис
Функция ДобавитьТумблер(Форма, Знач ИмяИлиРеквизит, Знач РодительЭлемента = Неопределено, Знач ПередЭлементом = Неопределено, ДополнительныеСвойства = Неопределено) Экспорт
Параметры
Форма - УправляемаяФорма - Форма, в которую нужно добавить. ИмяЭлемента - Строка - Имя элемента или путь к данным элемента. РодительЭлемента - Строка или Элемент - Имя элемента или Элемент - Родитель для добавляемого элемента. ПередЭлементом - Строка или Элемент - Имя элемента или Элемент, перед которым вставляется этот элемент.
Возвращаемое значение
- ЭлементФормы - добавленный элемент.
Пример вызова
Результат = ЕХТ_Форма.ДобавитьТумблер(Форма, ИмяИлиРеквизит, РодительЭлемента, ПередЭлементом, ДополнительныеСвойства)
Доступность
Сервер, Тонкий клиент
Добавляет ПолеФормы/ПолеФлажка на форму.
Синтаксис
Функция ДобавитьФлажок(Форма, Знач ИмяИлиРеквизит, Знач РодительЭлемента = Неопределено, Знач ПередЭлементом = Неопределено, ДополнительныеСвойства = Неопределено) Экспорт
Параметры
Форма - УправляемаяФорма - Форма, в которую нужно добавить. ИмяЭлемента - Строка - Имя элемента или путь к данным элемента. РодительЭлемента - Строка или Элемент - Имя элемента или Элемент - Родитель для добавляемого элемента. ПередЭлементом - Строка или Элемент - Имя элемента или Элемент, перед которым вставляется этот элемент.
Возвращаемое значение
- ЭлементФормы - добавленный элемент.
Пример вызова
Результат = ЕХТ_Форма.ДобавитьФлажок(Форма, ИмяИлиРеквизит, РодительЭлемента, ПередЭлементом, ДополнительныеСвойства)
Доступность
Сервер, Тонкий клиент
Возвращает значение из добавленной во все формы структуры "ЕХТ_СвойстваФормы"
Синтаксис
Функция ЗначениеСвойстваФормы(Знач Форма, Знач ИмяСвойства, Знач НовоеЗначение = NULL) Экспорт
Пример вызова
Результат = ЕХТ_Форма.ЗначениеСвойстваФормы(Форма, ИмяСвойства, НовоеЗначение)
Доступность
Сервер, Тонкий клиент
Возвращает значение свойства ИмяСвойства элемента формы с именем ИмяЭлемента. Применяется в тех случаях, когда элемент формы может не быть на форме из-за отсутствия прав у пользователя на объект, реквизит объекта или команду.
Синтаксис
Функция ЗначениеСвойстваЭлемента(ФормаИлиЭлементыФормы, ИмяЭлемента, ИмяСвойства) Экспорт
Параметры
ЭлементыФормы - ВсеЭлементыФормы
- ЭлементыФормы - коллекция элементов управляемой формы.
ИмяЭлемента - Строка - имя элемента формы.
ИмяСвойства - Строка - имя свойства элемента формы.
Возвращаемое значение
Произвольный - значение свойства ИмяСвойства элемента формы ИмяЭлемента.
Пример вызова
Результат = ЕХТ_Форма.ЗначениеСвойстваЭлемента(ФормаИлиЭлементыФормы, ИмяЭлемента, ИмяСвойства)
Доступность
Сервер, Тонкий клиент
Возвращает и может устанавливать значение элемента формы
Синтаксис
Функция ЗначениеЭлемента(Знач Форма, Знач Элемент, Знач НовоеЗначение = NULL) Экспорт
Параметры
Форма - УправляемаяФорма - форма, в которой расположен элемент. Элемент - ЭлементФормы - элемент, для которого нужно получить или установить значение. НовоеЗначение - Любое - устанавливаемое значение элемента.
Возвращаемое значение
- Любое - полученное или установленное значение элемента.
Пример вызова
Результат = ЕХТ_Форма.ЗначениеЭлемента(Форма, Элемент, НовоеЗначение)
Доступность
Сервер, Тонкий клиент
Возвращает полное имя другой формы этого же объекта.
Синтаксис
Функция ИмяДругойФормы(Знач Форма, Знач ИмяДругойФормы = Неопределено) Экспорт
Параметры
Форма - УправляемаяФорма - Исходная форма. ИмяДругойФормы - Строка - Имя другой формы.
Возвращаемое значение
Строка
Пример вызова
Результат = ЕХТ_Форма.ИмяДругойФормы(Форма, ИмяДругойФормы)
Доступность
Сервер, Тонкий клиент
Возвращает картинку, соответствующую типу формы.
Синтаксис
Функция Картинка(Знач Форма) Экспорт
Пример вызова
Результат = ЕХТ_Форма.Картинка(Форма)
Доступность
Сервер, Тонкий клиент
Возвращает командную панель формы.
Синтаксис
Функция КоманднаяПанель(Знач Форма) Экспорт
Параметры
Форма - УправляемаяФорма - форма, для которой нужно получить.
Возвращаемое значение
- Элемент или Неопределено, если определить не удалось.
Пример вызова
Результат = ЕХТ_Форма.КоманднаяПанель(Форма)
Доступность
Сервер, Тонкий клиент
Возвращает ссылку на основной реквизит формы.
Синтаксис
Функция ОсновнойРеквизит(Знач Форма, ИмяРеквизита = "") Экспорт
Параметры
Форма - УправляемаяФорма - форма, для которой нужно получить основной реквизит. ИмяРеквизита - Строка - возвращает имя основного реквизита
Возвращаемое значение
- Ссылка - ссылка на основной реквизит формы.
Пример вызова
Результат = ЕХТ_Форма.ОсновнойРеквизит(Форма, ИмяРеквизита)
Доступность
Сервер, Тонкий клиент
Возвращает структуру, заполненную из ЭтотОбъект.Параметры Источник: https://forum.infostart.ru/forum9/topic102786/(11)
Синтаксис
Функция ПараметрыВСтруктуру(Знач ПараметрыФормы) Экспорт
Пример вызова
Результат = ЕХТ_Форма.ПараметрыВСтруктуру(ПараметрыФормы)
Доступность
Сервер, Тонкий клиент
Обход особенности платформы, когда затирается редактируемое значение в текущем элементе при изменении формы.
Синтаксис
Процедура ПредотвратитьСбросРедактируемогоЗначения(Форма) Экспорт
Пример вызова
ЕХТ_Форма.ПредотвратитьСбросРедактируемогоЗначения(Форма)
Доступность
Сервер, Тонкий клиент
Процедура, вызываемая из всех форм расширений из обработчика ПриСозданииНаСервере и генерирующая событие "Форма.ПриСоздании".
Синтаксис
Процедура ПриСоздании(Форма) Экспорт
Параметры
Форма - УправляемаяФорма - форма объекта расширения.
Пример вызова
ЕХТ_Форма.ПриСоздании(Форма)
Доступность
Сервер, Тонкий клиент
Возвращает ПутьКДанным для полученного элемента.
Синтаксис
Функция ПутьКДаннымЭлемента(Знач Форма, Знач Элемент) Экспорт
Параметры
Форма - УправляемаяФорма - форма, в которой расположен элемент. Элемент - ЭлементФормы - элемент, для которого надо получить ПутьКДанным.
Возвращаемое значение
- Строка - ПутьКДанным элемента. В случае отсутствия возвращается Неопределено.
Пример вызова
Результат = ЕХТ_Форма.ПутьКДаннымЭлемента(Форма, Элемент)
Доступность
Сервер, Тонкий клиент
Возвращает реквизит формы по полученному параметру ПутьКДанным
Синтаксис
Функция Реквизит(Знач Форма, Знач ПутьКДанным) Экспорт
Пример вызова
Результат = ЕХТ_Форма.Реквизит(Форма, ПутьКДанным)
Доступность
Сервер, Тонкий клиент
Возвращает признак наличия реквизита формы по полученному параметру ПутьКДанным
Синтаксис
Функция РеквизитСуществует(Знач Форма, Знач ПутьКДанным, ЗначениеРеквизита = Неопределено) Экспорт
Пример вызова
Результат = ЕХТ_Форма.РеквизитСуществует(Форма, ПутьКДанным, ЗначениеРеквизита)
Доступность
Сервер, Тонкий клиент
Сбрасывает размеры и положение формы. Вызывать из ПриСозданииНаСервере.
Синтаксис
Процедура СброситьНастройки(Форма) Экспорт
Параметры
Форма - УправляемаяФорма - форма, для которой нужно сбросить настройки.
Пример вызова
ЕХТ_Форма.СброситьНастройки(Форма)
Доступность
Сервер, Тонкий клиент
Устарела.
Синтаксис
Функция ТипВид(Знач Форма) Экспорт
Пример вызова
Результат = ЕХТ_Форма.ТипВид(Форма)
Доступность
Сервер, Тонкий клиент
Возвращает строку Тип.Вид для переданной формы или имени формы
Синтаксис
Функция ТипВидСтр(Знач Форма) Экспорт
Параметры
Форма - УправляемаяФорма - форма, для которой нужно получить.
Возвращаемое значение
- Строка - Тип.Вид формы
Пример вызова
Результат = ЕХТ_Форма.ТипВидСтр(Форма)
Доступность
Сервер, Тонкий клиент
Возвращает строку Тип для переданной формы или имени формы.
Синтаксис
Функция ТипСтр(Знач Форма) Экспорт
Параметры
Форма - УправляемаяФорма - форма, для которой нужно получить.
Возвращаемое значение
- Строка - Тип формы
Пример вызова
Результат = ЕХТ_Форма.ТипСтр(Форма)
Доступность
Сервер, Тонкий клиент
Устанавливает ключ назначения формы (ключ назначения использования и ключ сохранения положения окна). При необходимости копирует текущие настройки формы, если для соответствующего нового ключа они еще не были записаны.
Синтаксис
Процедура УстановитьКлючНазначения(Форма, Ключ, КлючПоложения = "", УстановитьНастройки = Истина) Экспорт
Параметры
Форма - УправляемаяФорма - форма ПриСозданииНаСервере, которой устанавливается ключ. Ключ - Строка - новый ключ назначения формы. УстановитьНастройки - Булево - установить новому ключу настройки, сохраненные для текущего ключа.
Пример вызова
ЕХТ_Форма.УстановитьКлючНазначения(Форма, Ключ, КлючПоложения, УстановитьНастройки)
Доступность
Сервер, Тонкий клиент
Устанавливает свойство ИмяСвойства элемента формы с именем ИмяЭлемента в значение Значение. Применяется в тех случаях, когда элемента формы может не быть на форме из-за отсутствия прав у пользователя на объект, реквизит объекта или команду.
Синтаксис
Процедура УстановитьСвойствоЭлемента(ФормаИлиЭлементыФормы, ИмяЭлемента, ИмяСвойства, Значение) Экспорт
Параметры
ЭлементыФормы - ВсеЭлементыФормы
- ЭлементыФормы - коллекция элементов управляемой формы.
ИмяЭлемента - Строка - имя элемента формы.
ИмяСвойства - Строка - имя устанавливаемого свойства элемента формы.
Значение - Произвольный - новое значение элемента.
Пример вызова
ЕХТ_Форма.УстановитьСвойствоЭлемента(ФормаИлиЭлементыФормы, ИмяЭлемента, ИмяСвойства, Значение)
Доступность
Сервер, Тонкий клиент
Заполняет для формы и элементов свойство ТолькоПросмотр = Истина
Синтаксис
Процедура УстановитьТолькоПросмотр(Форма, Знач СтрокаИсключений = "") Экспорт
Параметры
Форма - УправляемаяФорма - форма, для которой нужно установить режим "Только просмотр". СтрокаИсключений - Строка - Перечень элементов через запятую, для которых свойство изменять не нужно.
Пример вызова
ЕХТ_Форма.УстановитьТолькоПросмотр(Форма, СтрокаИсключений)
Доступность
Сервер, Тонкий клиент
Отправляет DELETE запрос
Синтаксис
Функция Delete(URL, Данные = Неопределено, ДополнительныеПараметры = Неопределено, Сессия = Неопределено) Экспорт
Параметры
URL - Строка - URL ресурса, к которому будет отправлен запрос. Данные - Структура, Соответствие, Строка, ДвоичныеДанные - см. описание ДополнительныеПараметры.Данные. ДополнительныеПараметры - См. НовыеПараметры Сессия - См. СоздатьСессию
Возвращаемое значение
См. ВызватьМетод
Пример вызова
Результат = ЕХТ_ХТТП.Delete(URL, Данные, ДополнительныеПараметры, Сессия)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Отправляет DELETE запрос
Синтаксис
Функция DeleteJson(URL, Json, ДополнительныеПараметры = Неопределено, Сессия = Неопределено) Экспорт
Параметры
URL - Строка - URL ресурса, к которому будет отправлен запрос. Json - Структура, Соответствие - данные, которые необходимо сериализовать в JSON. ДополнительныеПараметры - См. НовыеПараметры Сессия - См. СоздатьСессию
Возвращаемое значение
Соответствие, Структура - ответ, десериализованный из JSON.
Параметры преобразования см. ДополнительныеПараметры.ПараметрыПреобразованияJSON
Пример вызова
Результат = ЕХТ_ХТТП.DeleteJson(URL, Json, ДополнительныеПараметры, Сессия)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Отправляет GET запрос
Синтаксис
Функция Get(URL, ПараметрыЗапроса = Неопределено, ДополнительныеПараметры = Неопределено, Сессия = Неопределено) Экспорт
Параметры
URL - Строка - URL ресурса, к которому будет отправлен запрос.
ПараметрыЗапроса - Структура, Соответствие - параметры, которые будут отправлены в URL (часть после ?):
* Ключ - Строка - ключ параметра в URL.
* Значение - Строка - значение параметра URL
- Массив - сформирует строку из нескольких параметров: key=value1&key=value2 и т.д.
ДополнительныеПараметры - См. НовыеПараметры
Сессия - См. СоздатьСессию
Возвращаемое значение
См. ВызватьМетод
Пример вызова
Результат = ЕХТ_ХТТП.Get(URL, ПараметрыЗапроса, ДополнительныеПараметры, Сессия)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Отправляет GET запрос
Синтаксис
Функция GetJson(URL, ПараметрыЗапроса = Неопределено, ДополнительныеПараметры = Неопределено, Сессия = Неопределено) Экспорт
Параметры
URL - Строка - URL ресурса, к которому будет отправлен запрос.
ПараметрыЗапроса - Структура, Соответствие - параметры, которые будут отправлены в URL (часть после ?).
См. описание Сессия.ПараметрыЗапроса.
ДополнительныеПараметры - См. НовыеПараметры
Сессия - См. СоздатьСессию
Возвращаемое значение
Соответствие, Структура - ответ, десериализованный из JSON.
Параметры преобразования см. ДополнительныеПараметры.ПараметрыПреобразованияJSON.
Пример вызова
Результат = ЕХТ_ХТТП.GetJson(URL, ПараметрыЗапроса, ДополнительныеПараметры, Сессия)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Отправляет HEAD запрос
Синтаксис
Функция Head(URL, ДополнительныеПараметры = Неопределено, Сессия = Неопределено) Экспорт
Параметры
URL - Строка - URL ресурса, к которому будет отправлен запрос. ДополнительныеПараметры - См. НовыеПараметры Сессия - См. СоздатьСессию
Возвращаемое значение
См. ВызватьМетод
Пример вызова
Результат = ЕХТ_ХТТП.Head(URL, ДополнительныеПараметры, Сессия)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Вычисляет HMAC (hash-based message authentication code).
Синтаксис
Функция HMAC(Ключ, Данные, Алгоритм) Экспорт
Параметры
Ключ - ДвоичныеДанные - секретный ключ. Данные - ДвоичныеДанные - данные, для которых нужно посчитать HMAC. Алгоритм - ХешФункция - алгоритм, используемый для вычисления хеша.
Возвращаемое значение
ДвоичныеДанные - вычисленное значение HMAC.
Пример вызова
Результат = ЕХТ_ХТТП.HMAC(Ключ, Данные, Алгоритм)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Преобразование JSON в Объект.
Синтаксис
Функция JsonВОбъект(Json, Кодировка = "utf-8", ПараметрыПреобразования = Неопределено) Экспорт
Параметры
Json - Поток, ДвоичныеДанные, Строка - данные в формате JSON.
Кодировка - Строка - кодировка текста JSON. Значение по умолчанию - utf-8.
ПараметрыПреобразования - Структура - параметры преобразования JSON:
* ПрочитатьВСоответствие - Булево - если Истина, чтение объекта JSON будет выполнено в Соответствие,
иначе в Структура.
* ИменаСвойствСоЗначениямиДата - Массив, Строка, ФиксированныйМассив - имена свойств JSON,
для которых нужно вызывать восстановление даты из строки.
* ФорматДатыJSON - ФорматДатыJSON - определяет формат десериализации дат JSON-объектов.
* ИмяФункцииВосстановления - Строка - определяет имя функции, которая будет вызывается при чтении
каждого свойства и должна иметь следующие параметры:
** Свойство - Строка - указывается только при чтении объектов JSON
** Значение - Произвольный - значение допустимого для сериализации типа
** ДополнительныеПараметры - Произвольный
Возвращаемое значение
Произвольный - значение, десериализованное из JSON.
* МодульФункцииВосстановления - Произвольный - определяет модуль, процедура которого будет использована для
восстановления значения.
* ДополнительныеПараметрыФункцииВосстановления - Произвольный - определяет дополнительные параметры, которые
будут переданы в функцию восстановления значений.
* ИменаСвойствДляОбработкиВосстановления - Массив - определяет массив имен свойств JSON, для которых
будет вызвана функция восстановления.
* МаксимальнаяВложенность - Число - определяет максимальный уровень вложенности объекта JSON.
Произвольный - значение, десериализованное из JSON.
Пример вызова
Результат = ЕХТ_ХТТП.JsonВОбъект(Json, Кодировка, ПараметрыПреобразования)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Отправляет OPTIONS запрос
Синтаксис
Функция Options(URL, ДополнительныеПараметры = Неопределено, Сессия = Неопределено) Экспорт
Параметры
URL - Строка - URL ресурса, к которому будет отправлен запрос. ДополнительныеПараметры - См. НовыеПараметры Сессия - См. СоздатьСессию
Возвращаемое значение
См. ВызватьМетод
Пример вызова
Результат = ЕХТ_ХТТП.Options(URL, ДополнительныеПараметры, Сессия)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Отправляет PATCH запрос
Синтаксис
Функция Patch(URL, Данные = Неопределено, ДополнительныеПараметры = Неопределено, Сессия = Неопределено) Экспорт
Параметры
URL - Строка - URL ресурса, к которому будет отправлен запрос. Данные - Структура, Соответствие, Строка, ДвоичныеДанные - см. описание ДополнительныеПараметры.Данные. ДополнительныеПараметры - См. НовыеПараметры Сессия - См. СоздатьСессию
Возвращаемое значение
См. ВызватьМетод
Пример вызова
Результат = ЕХТ_ХТТП.Patch(URL, Данные, ДополнительныеПараметры, Сессия)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Отправляет POST запрос
Синтаксис
Функция Post(URL, Данные = Неопределено, ДополнительныеПараметры = Неопределено, Сессия = Неопределено) Экспорт
Параметры
URL - Строка - URL ресурса, к которому будет отправлен запрос. Данные - Структура, Соответствие, Строка, ДвоичныеДанные - см. описание ДополнительныеПараметры.Данные. ДополнительныеПараметры - См. НовыеПараметры Сессия - См. СоздатьСессию
Возвращаемое значение
См. ВызватьМетод
Пример вызова
Результат = ЕХТ_ХТТП.Post(URL, Данные, ДополнительныеПараметры, Сессия)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Отправляет POST запрос
Синтаксис
Функция PostJson(URL, Json, ДополнительныеПараметры = Неопределено, Сессия = Неопределено) Экспорт
Параметры
URL - Строка - URL ресурса, к которому будет отправлен запрос. Json - Структура, Соответствие - данные, которые необходимо сериализовать в JSON. ДополнительныеПараметры - См. НовыеПараметры Сессия - См. СоздатьСессию
Возвращаемое значение
Соответствие, Структура - ответ, десериализованный из JSON.
Параметры преобразования см. ДополнительныеПараметры.ПараметрыПреобразованияJSON
Пример вызова
Результат = ЕХТ_ХТТП.PostJson(URL, Json, ДополнительныеПараметры, Сессия)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Отправляет PUT запрос
Синтаксис
Функция Put(URL, Данные = Неопределено, ДополнительныеПараметры = Неопределено, Сессия = Неопределено) Экспорт
Параметры
URL - Строка - URL ресурса, к которому будет отправлен запрос. Данные - Структура, Соответствие, Строка, ДвоичныеДанные - см. описание ДополнительныеПараметры.Данные. ДополнительныеПараметры - См. НовыеПараметры Сессия - См. СоздатьСессию
Возвращаемое значение
См. ВызватьМетод
Пример вызова
Результат = ЕХТ_ХТТП.Put(URL, Данные, ДополнительныеПараметры, Сессия)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Отправляет PUT запрос
Синтаксис
Функция PutJson(URL, Json, ДополнительныеПараметры = Неопределено, Сессия = Неопределено) Экспорт
Параметры
URL - Строка - URL ресурса, к которому будет отправлен запрос. Json - Структура, Соответствие - данные, которые необходимо сериализовать в JSON. ДополнительныеПараметры - См. НовыеПараметры Сессия - См. СоздатьСессию
Возвращаемое значение
Соответствие, Структура - ответ, десериализованный из JSON.
Параметры преобразования см. ДополнительныеПараметры.ПараметрыПреобразованияJSON
Пример вызова
Результат = ЕХТ_ХТТП.PutJson(URL, Json, ДополнительныеПараметры, Сессия)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает полный адрес, собранный через слэш из переданных частей.
Синтаксис
Функция А(Знач Часть1, Знач Часть2, Знач Часть3 = Неопределено) Экспорт
Пример вызова
Результат = ЕХТ_ХТТП.А(Часть1, Часть2, Часть3)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Восстанавливает значение типа, десериализация которого не поддерживается.
Синтаксис
Функция ВосстановлениеJson(Свойство, Значение, ТипыСвойств) Экспорт
Параметры
Свойство - Строка - имя свойства, значение которого нужно восстановить.
Значение - Строка - значение, которое нужно восстановить.
ТипыСвойств - Соответствие - типы свойств, которые нужно восстановить.
* Ключ - Строка - имя свойства. Равно значению параметра Свойство.
* Значение - Тип - исходный тип значения.
Возвращаемое значение
Произвольный - восстановленное значение.
Пример вызова
Результат = ЕХТ_ХТТП.ВосстановлениеJson(Свойство, Значение, ТипыСвойств)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Отправляет данные на указанный адрес для обработки с использованием указанного HTTP-метода.
Синтаксис
Функция ВызватьМетод(Метод, URL, ДополнительныеПараметры = Неопределено, Сессия = Неопределено) Экспорт
Параметры
Метод - Строка - имя HTTP-метода для запроса. URL - Строка - URL ресурса, к которому будет отправлен запрос. ДополнительныеПараметры - См. НовыеПараметры Сессия - См. СоздатьСессию
Возвращаемое значение
Структура - ответ на выполненный запрос:
* ВремяВыполнения - Число - время выполнения запроса в миллисекундах.
* Cookies - Соответствие - cookies полученные с сервера.
* Заголовки - Соответствие - HTTP заголовки ответа.
* ЭтоПостоянныйРедирект - Булево - признак постоянного редиректа.
* ЭтоРедирект - Булево - признак редиректа.
* Кодировка - Строка - кодировка текста ответа.
* Тело - ДвоичныеДанные - тело ответа.
* КодСостояния - Число - код состояния ответа.
* URL - Строка - итоговый URL, по которому был выполнен запрос.
Пример вызова
Результат = ЕХТ_ХТТП.ВызватьМетод(Метод, URL, ДополнительныеПараметры, Сессия)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Выполняет запись данных в архив GZip.
Синтаксис
Функция ЗаписатьGZip(Данные) Экспорт
Параметры
Данные - ДвоичныеДанные - исходные данные.
Возвращаемое значение
ДвоичныеДанные - данные упакованные GZip.
Пример вызова
Результат = ЕХТ_ХТТП.ЗаписатьGZip(Данные)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает ответ сервера в виде десериализованного значения JSON.
Синтаксис
Функция КакJson(Ответ, ПараметрыПреобразованияJSON = Неопределено) Экспорт
Параметры
Ответ - См. НовыйОтвет
ПараметрыПреобразованияJSON - Структура - задает параметры преобразования JSON.
* ПрочитатьВСоответствие - Булево - Если Истина, чтение объекта JSON будет выполнено в Соответствие.
Если Ложь, объекты будут считываться в объект типа Структура.
* ФорматДатыJSON - ФорматДатыJSON - формат, в котором представлена дата в строке, подлежащей преобразованию.
* ИменаСвойствСоЗначениямиДата - Массив, Строка - имена свойств JSON,
для которых нужно вызывать восстановление даты из строки.
* ИмяФункцииВосстановления - Строка - определяет имя функции, которая будет вызывается при чтении
каждого свойства и должна иметь следующие параметры:
** Свойство - Строка - указывается только при чтении объектов JSON
** Значение - Произвольный - значение допустимого для сериализации типа
** ДополнительныеПараметры - Произвольный
Возвращаемое значение
Произвольный - значение, десериализованное из JSON.
* МодульФункцииВосстановления - Произвольный - определяет модуль, процедура которого будет использована для
восстановления значения.
* ДополнительныеПараметрыФункцииВосстановления - Произвольный - определяет дополнительные параметры, которые
будут переданы в функцию восстановления значений.
* ИменаСвойствДляОбработкиВосстановления - Массив - определяет массив имен свойств JSON, для которых
будет вызвана функция восстановления.
* МаксимальнаяВложенность - Число - определяет максимальный уровень вложенности объекта JSON.
Соответствие - ответ сервера в виде десериализованного значения JSON.
Если ПараметрыПреобразования.ПрочитатьВСоответствие = Истина (по умолчанию).
Структура - если ПараметрыПреобразования.ПрочитатьВСоответствие = Ложь.
Пример вызова
Результат = ЕХТ_ХТТП.КакJson(Ответ, ПараметрыПреобразованияJSON)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает ответ сервера в XDTO.
Синтаксис
Функция КакXDTO(Ответ, ПараметрыЧтенияXML = Неопределено, НаборСхемXML = Неопределено, Кодировка = Неопределено) Экспорт
Параметры
Ответ - См. НовыйОтвет
ПараметрыЧтенияXML - ПараметрыЧтенияXML - Параметры чтения, которые будут использованы при чтении данных XML
Подробнее см. в синтакс помощнике метод ЧтениеXML.ОткрытьПоток
НаборСхемXML - НаборСхемXML - Набор схем XML, используемых при проверке читаемого документа XML.
Если набор схем указан, но не проверен и включена проверка документа XML,
то будет выполнена проверка набора схем
Подробнее см. в синтакс помощнике метод ЧтениеXML.ОткрытьПоток
Кодировка - Строка, КодировкаТекста - Позволяет задать кодировку.
Подробнее см. в синтакс помощнике метод ЧтениеXML.ОткрытьПоток
Возвращаемое значение
ОбъектXDTO, СписокXDTO - тип возвращаемого значения может быть любым из поддерживаемых сериализацию в XDTO.
Пример вызова
Результат = ЕХТ_ХТТП.КакXDTO(Ответ, ПараметрыЧтенияXML, НаборСхемXML, Кодировка)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает ответ сервера в двоичных данных.
Синтаксис
Функция КакДвоичныеДанные(Ответ) Экспорт
Параметры
Ответ - См. НовыйОтвет
Возвращаемое значение
Строка - ответ сервера в виде двоичных данных.
Пример вызова
Результат = ЕХТ_ХТТП.КакДвоичныеДанные(Ответ)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает ответ сервера в виде текста предназначенного для использования в ВызватьИсключение.
Синтаксис
Функция КакИсключение(Ответ, Знач ТекстДляПользователя = Неопределено) Экспорт
Параметры
Ответ - См. НовыйОтвет. ТекстДляПользователя - Строка - Текст пояснения причины для пользователя.
Возвращаемое значение
Строка - ответ сервера в виде текста исключения.
Пример вызова
Результат = ЕХТ_ХТТП.КакИсключение(Ответ, ТекстДляПользователя)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает ответ сервера в виде текста.
Синтаксис
Функция КакТекст(Ответ, Кодировка = Неопределено) Экспорт
Параметры
Ответ - См. НовыйОтвет
Кодировка - Строка, КодировкаТекста - определяет кодировку текста.
Если значение не задано, то кодировка извлекается из Ответ.Кодировка.
Возвращаемое значение
Строка - ответ сервера в виде текста.
Пример вызова
Результат = ЕХТ_ХТТП.КакТекст(Ответ, Кодировка)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает 102.
Синтаксис
Функция Код102_ВыполняетсяОбработка() Экспорт // 102
Пример вызова
Результат = ЕХТ_ХТТП.Код102_ВыполняетсяОбработка(// 102)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает 200.
Синтаксис
Функция Код200_ОК() Экспорт // 200
Пример вызова
Результат = ЕХТ_ХТТП.Код200_ОК(// 200)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает 201.
Синтаксис
Функция Код201_Создано() Экспорт // 201
Пример вызова
Результат = ЕХТ_ХТТП.Код201_Создано(// 201)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает 202.
Синтаксис
Функция Код202_Подтверждено() Экспорт // 202
Пример вызова
Результат = ЕХТ_ХТТП.Код202_Подтверждено(// 202)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает 204.
Синтаксис
Функция Код204_НетСодержимого() Экспорт // 204
Пример вызова
Результат = ЕХТ_ХТТП.Код204_НетСодержимого(// 204)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает 302.
Синтаксис
Функция Код302_Переадресация() Экспорт // 302
Пример вызова
Результат = ЕХТ_ХТТП.Код302_Переадресация(// 302)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает 400.
Синтаксис
Функция Код400_НекорректныйСинтаксис() Экспорт // 400
Пример вызова
Результат = ЕХТ_ХТТП.Код400_НекорректныйСинтаксис(// 400)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает 401.
Синтаксис
Функция Код401_НеАвторизован() Экспорт // 401
Пример вызова
Результат = ЕХТ_ХТТП.Код401_НеАвторизован(// 401)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает 409.
Синтаксис
Функция Код409_Конфликт() Экспорт // 409
Пример вызова
Результат = ЕХТ_ХТТП.Код409_Конфликт(// 409)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает 410.
Синтаксис
Функция Код410_Удален() Экспорт // 410
Пример вызова
Результат = ЕХТ_ХТТП.Код410_Удален(// 410)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает 423.
Синтаксис
Функция Код423_Заблокирован() Экспорт // 423
Пример вызова
Результат = ЕХТ_ХТТП.Код423_Заблокирован(// 423)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает Неопределено.
Синтаксис
Функция КодНетСоединения() Экспорт // Неопределено
Пример вызова
Результат = ЕХТ_ХТТП.КодНетСоединения(// Неопределено)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает структуру именованных кодов состояний HTTP.
Синтаксис
Функция КодыСостоянияHTTP() Экспорт
Возвращаемое значение
Структура - именованные коды состояний HTTP.
Пример вызова
Результат = ЕХТ_ХТТП.КодыСостоянияHTTP()
Доступность
Сервер, Вызов сервера, Внешнее соединение
Конструктор дополнительных параметров
Синтаксис
Функция НовыеПараметры() Экспорт
Возвращаемое значение
Структура - позволяет задать дополнительные параметры:
* Заголовки - Соответствие - см. описание Сессия.Заголовки.
* Аутентификация - Структура - см. описание Сессия.Аутентификация
* Прокси - ИнтернетПрокси - см. описание Сессия.Прокси.
* ПараметрыЗапроса - Структура, Соответствие - см. описание Сессия.ПараметрыЗапроса.
* ПроверятьSSL - Булево - см. описание Сессия.ПроверятьSSL.
* КлиентскийСертификатSSL - СертификатКлиентаФайл, СертификатКлиентаWindows - Значение по умолчанию: Неопределено.
* Cookies - Массив - см. описание Сессия.Cookies.
* Таймаут - Число - время ожидания осуществляемого соединения и операций, в секундах.
Значение по умолчанию - 30 сек.
* РазрешитьПеренаправление - Булево - Истина - редиректы будут автоматически разрешены.
Ложь - будет выполнен только один запрос к серверу.
* Json - Структура, Соответствие - данные, которые необходимо сериализовать в JSON.
* ПараметрыПреобразованияJSON - Структура - задает параметры преобразования JSON:
** ПрочитатьВСоответствие - Булево - Если Истина, чтение объекта JSON будет выполнено в Соответствие.
Если Ложь, объекты будут считываться в объект типа Структура.
** ФорматДатыJSON - ФорматДатыJSON - формат, в котором представлена дата в строке,
подлежащей преобразованию.
** ИменаСвойствСоЗначениямиДата - Строка, Массив Из Строка - имена свойств JSON,
для которых нужно вызывать восстановление даты из строки.
** ИмяФункцииВосстановления - Строка - определяет имя функции, которая будет вызывается при чтении
каждого свойства и должна иметь следующие параметры:
** Свойство - Строка - указывается только при чтении объектов JSON
** Значение - Произвольный - значение допустимого для сериализации типа
** ДополнительныеПараметры - Произвольный
Произвольный - значение, десериализованное из JSON.
** МодульФункцииВосстановления - Произвольный - определяет модуль, процедура которого будет использована для
восстановления значения.
** ДополнительныеПараметрыФункцииВосстановления - Произвольный - определяет дополнительные параметры, которые
будут переданы в функцию восстановления значений.
** ИменаСвойствДляОбработкиВосстановления - Массив - определяет массив имен свойств JSON, для которых
будет вызвана функция восстановления.
** МаксимальнаяВложенность - Число - определяет максимальный уровень вложенности объекта JSON.
* ПараметрыЗаписиJSON - ПараметрыЗаписиJSON - используемые при записи объекта JSON.
* Данные - Строка, ДвоичныеДанные - произвольные данные, которые необходимо отправить в запросе.
- Структура, Соответствие - поля формы, которые необходимо отправить в запрос:
** Ключ - Строка - имя поля.
** Значение - Строка - значение поля.
* Файлы - См. НовыйОтправляемыйФайл, Массив Из См. НовыйОтправляемыйФайл - файлы, к отправке
* МаксимальноеКоличествоПовторов - Число - количество повторных попыток соединения/отправки запроса.
Между попытками выполняется задержка, растущая по экспоненте.
Но если код состояния один из 413, 429, 503
и в ответе есть заголовок Retry-After,
то время задержки формируется из значения этого заголовка
Значение по умолчанию: 0 - повторы не выполняются.
* МаксимальноеВремяПовторов - Число - максимальное общее время (в секундах) отправки запроса с учетом повторов.
Значение по умолчанию: 600.
* КоэффициентЭкспоненциальнойЗадержки - Число - коэффициент изменения экспоненциальной задержки.
1 формирует последовательность задержек: 1, 2, 4, 8 и т.д.
2 формируется последовательность задержек: 2, 4, 8, 16 и т.д.
...
Значение по умолчанию: 1.
* ПовторятьДляКодовСостояний - Неопределено - повторы будут выполняться для кодов состояний >= 500.
- Массив - повторы будут выполняться для конкретных кодов состояний.
Значение по умолчанию: Неопределено.
Пример вызова
Результат = ЕХТ_ХТТП.НовыеПараметры()
Доступность
Сервер, Вызов сервера, Внешнее соединение
Пакет ответа результата вызова метода HTTP.
Синтаксис
Функция НовыйОтвет() Экспорт
Возвращаемое значение
* Метод - Строка - имя HTTP-метода запроса * URL - Строка - итоговый URL, по которому был выполнен запрос. * КодСостояния - Число - Код состояния ответа.. * Заголовки - Соответствие - Заголовки ответа. * Тело - ДвоичныеДанные - Тело ответа. * Кодировка - Строка - код кодировки ответа. * ВремяВыполнения - Число - время выполнения запроса в миллисекундах. * ЭтоПостоянныйРедирект - Булево - указывает что это постоянный редирект. * ЭтоРедирект - Булево - указывает что это редирект. * Cookies - Соответствие - хранилище cookies. * Ошибки - Массив Из Строка - Список ошибок возникших в ходе выполнения запроса.
Пример вызова
Результат = ЕХТ_ХТТП.НовыйОтвет()
Доступность
Сервер, Вызов сервера, Внешнее соединение
Конструктор описания отправляемого файла.
Синтаксис
Функция НовыйОтправляемыйФайл(Имя, ИмяФайла, Данные = Неопределено, Тип = Неопределено) Экспорт
Параметры
Имя - Строка - имя поля формы. ИмяФайла - Строка - имя файла. Данные - ДвоичныеДанные - двоичные данные файла. Тип - Строка - MIME-тип файла
Возвращаемое значение
Структура:
* Имя - Строка - имя поля формы.
* ИмяФайла - Строка - имя файла.
* Данные - ДвоичныеДанные - двоичные данные файла.
* Тип - Строка - MIME-тип файла.
* Заголовки - Соответствие - HTTP заголовки запроса.
Пример вызова
Результат = ЕХТ_ХТТП.НовыйОтправляемыйФайл(Имя, ИмяФайла, Данные, Тип)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Преобразование Объекта в JSON.
Синтаксис
Функция ОбъектВJson(Объект, Знач ПараметрыПреобразования = Неопределено, Знач ПараметрыЗаписи = Неопределено) Экспорт
Параметры
Объект - Произвольный - данные, которые необходимо преобразовать в JSON.
ПараметрыПреобразования - Структура - кодировка текста JSON. Значение по умолчанию - utf-8.
* ФорматДатыJSON - ФорматДатыJSON - определяет формат сериализации дат JSON-объектов.
* ВариантЗаписиДатыJSON - ВариантЗаписиДатыJSON - определяет вариант записи даты в формате JSON.
* ИмяФункцииПреобразования - Строка - функция, которая вызывается для всех свойств,
тип которых не поддерживает автоматическую сериализацию в JSON.
Функция должна быть экспортируемая и иметь следующие параметры:
** Свойство - Строка - свойство структуры данных, которое не может быть
автоматически сериализовано в JSON.
** Значение - Строка - значение свойства структуры данных, которое
не может быть автоматически сериализовано в JSON.
** ДополнительныеПараметры - Произвольный - в этом параметре будет передан
ДополнительныеПараметрыФункцииПреобразования.
** Отказ - Булево - отменяет операцию записи свойства.
Возвращаемое значение функции:
Произвольный - результат преобразования.
* МодульФункцииПреобразования - Произвольный - модуль, в котором определена функция ИмяФункцииПреобразования.
* ДополнительныеПараметрыФункцииПреобразования - Произвольный - параметры, которые будут переданы
в функцию ИмяФункцииПреобразования.
ПараметрыЗаписи - Структура - параметры преобразования JSON:
* ПереносСтрок - ПереносСтрокJSON - определяет способ переноса строк,
который будет использован при записи данных JSON.
* СимволыОтступа - Строка - определяет символы отступа, используемые при записи данных JSON.
* ИспользоватьДвойныеКавычки - Булево - определяет, будут ли при записи имена свойств JSON
записываться в двойных кавычках.
* ЭкранированиеСимволов - ЭкранированиеСимволовJSON - определяет используемый способ экранирования (замены)
символов при записи данных JSON.
* ЭкранироватьУгловыеСкобки - Булево - определяет, будут ли при записи экранироваться символы "<" и ">".
* ЭкранироватьРазделителиСтрок - Булево - определяет, будут ли экранироваться разделители строк
U+2028 (line-separator) и U+2029 (page-separator).
* ЭкранироватьАмперсанд - Булево - определяет, будет ли при записи экранироваться символ амперсанда "&".
* ЭкранироватьОдинарныеКавычки - Булево - определяет, будут ли экранироваться одинарные кавычки.
* ЭкранироватьСлеш - Булево - определяет, будет ли экранироваться слеш (косая черта) при записи значения.
Возвращаемое значение
Строка - объект в формате JSON.
Пример вызова
Результат = ЕХТ_ХТТП.ОбъектВJson(Объект, ПараметрыПреобразования, ПараметрыЗаписи)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает текстовое представление переданного кода состояния HTTP.
Синтаксис
Функция ПредставлениеКодаСостоянияHTTP(КодСостояния) Экспорт
Параметры
КодСостояния - Число - код состояния HTTP, для которого нужно получить текстовое представление.
Возвращаемое значение
Строка - текстовое представление кода состояния HTTP.
Пример вызова
Результат = ЕХТ_ХТТП.ПредставлениеКодаСостоянияHTTP(КодСостояния)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Преобразует значение типа к типу, сериализация которого поддерживается.
Синтаксис
Функция ПреобразованиеJson(Свойство, Значение, ДополнительныеПараметры, Отказ) Экспорт
Параметры
Свойство - Строка - имя свойства, если выполняется запись структуры или соответствия. Значение - Произвольный - исходное значение. ДополнительныеПараметры - Произвольный - дополнительные параметры, которые указаны в вызове метода ЗаписатьJSON. Отказ - Булево - отказ от записи свойства.
Возвращаемое значение
Произвольный - см. типы ЗаписатьJSON.
Пример вызова
Результат = ЕХТ_ХТТП.ПреобразованиеJson(Свойство, Значение, ДополнительныеПараметры, Отказ)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Выполняет чтение данных из архива GZip.
Синтаксис
Функция ПрочитатьGZip(СжатыеДанные) Экспорт
Параметры
СжатыеДанные - ДвоичныеДанные - данные упакованные GZip.
Возвращаемое значение
ДвоичныеДанные - распакованные данные.
Пример вызова
Результат = ЕХТ_ХТТП.ПрочитатьGZip(СжатыеДанные)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает структурированное представление URL.
Синтаксис
Функция РазобратьURL(Знач URL) Экспорт
Параметры
URL - Строка - URL ресурса, к которому будет отправлен запрос.
Возвращаемое значение
Структура - структура URL:
* Схема - Строка - схема обращения к серверу (http, https).
* Аутентификация - Структура - параметры аутентификации:
** Пользователь - Строка - имя пользователя.
** Пароль - Строка - пароль пользователя.
* Сервер - Строка - адрес сервера.
* Порт - Число - порт сервера.
* Путь - Строка - адрес ресурса на сервере.
* ПараметрыЗапроса - Соответствие - параметры запроса передаваемые на сервер в URL (часть после ?):
** Ключ - Строка - ключ параметра в URL.
** Значение - Строка - значение параметра URL;
- Массив - значения параметра (key=value1&key=value2).
* Фрагмент - Строка - часть URL после #.
Пример вызова
Результат = ЕХТ_ХТТП.РазобратьURL(URL)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает строку с расшифровкой кода состояния.
Синтаксис
Функция РасшифровкаКодаСостояния(Знач КодСостояния) Экспорт
Пример вызова
Результат = ЕХТ_ХТТП.РасшифровкаКодаСостояния(КодСостояния)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Создает объект для хранения параметров сессии.
Синтаксис
Функция СоздатьСессию() Экспорт
Возвращаемое значение
Структура - параметры сессии:
* Заголовки - Соответствие - HTTP заголовки запроса.
* Аутентификация - Структура - параметры аутентификации запроса.
** ИспользоватьАутентификациюОС - Булево - включает использование аутентификации NTLM или Negotiate.
Значение по умолчанию: Ложь.
** Тип - Строка - тип аутентификации. Для Basic Тип можно не указывать.
Если Тип = Digest или Basic:
** Пользователь - Строка - имя пользователя.
** Пароль - Строка - пароль пользователя.
Если Тип = AWS4-HMAC-SHA256:
** ИдентификаторКлючаДоступа - Строка - идентификатор ключа доступа.
** СекретныйКлюч - Строка - секретный ключ.
** Сервис - Строка - сервис, к которому выполняется подключение.
** Регион - Строка - регион, к которому выполняется подключение.
* Прокси - ИнтернетПрокси - параметры прокси, которые будут использованы при отправке запроса.
Значение по умолчанию: Неопределено. При этом если в конфигурации используется БСП,
то значения прокси будет взято из БСП.
* ПараметрыЗапроса - Структура, Соответствие - параметры, которые будут отправлены в URL (часть после ?):
* Ключ - Строка - ключ параметра в URL.
* Значение - Строка - значение параметра URL
- Массив - сформирует строку из нескольких параметров: key=value1&key=value2 и т.д.
* ПроверятьSSL - Булево - Ложь - проверка сертификата сервера не выполняется.
- Истина - используется значение СертификатыУдостоверяющихЦентровОС.
- СертификатыУдостоверяющихЦентровФайл - См. СертификатыУдостоверяющихЦентровФайл.
Значение по умолчанию: Истина.
* КлиентскийСертификатSSL - СертификатКлиентаФайл, СертификатКлиентаWindows - Значение по умолчанию: Неопределено.
* МаксимальноеКоличествоПеренаправлений - Число - максимальное количество редиректов. Защита от зацикливания.
Значение по умолчанию: 30
* Cookies - Соответствие - хранилище cookies.
Пример вызова
Результат = ЕХТ_ХТТП.СоздатьСессию()
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает строку ошибку без стека выполнения.
Синтаксис
Функция СократитьКраткоеПредставлениеОшибкиРаботыСИнтернет(Знач ТекстОшибки) Экспорт
Пример вызова
Результат = ЕХТ_ХТТП.СократитьКраткоеПредставлениеОшибкиРаботыСИнтернет(ТекстОшибки)
Доступность
Сервер, Вызов сервера, Внешнее соединение
Возвращает компоненты цвета по модели HSV, по переданным компонентам RGB
Синтаксис
Процедура HSVпоRGB(Знач Красный, Знач Зеленый, Знач Синий, Тон, Насыщенность, Светлота) Экспорт
Параметры
Красный - Число - от 0 до 255 Зеленый - Число - от 0 до 255 Синий - Число - от 0 до 255 Тон - Число - возвращается значение от 0 до 360 (градусов) Насыщенность - Число - возвращается значение от 0 до 100 (%) Светлота - Число - возвращается значение от 0 до 100 (%)
Пример вызова
ЕХТ_Цвет.HSVпоRGB(Красный, Зеленый, Синий, Тон, Насыщенность, Светлота)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает компоненты цвета по модели RGB, по переданным компонентам HSV
Синтаксис
Процедура RGBпоHSV(Знач Тон, Знач Насыщенность, Знач Светлота, Красный, Зеленый, Синий) Экспорт
Параметры
Тон - Число - от 0 до 360 (градусов) Насыщенность - Число - от 0 до 100 (%) Светлота - Число - от 0 до 100 (%) Красный - Число - возвращается значение от 0 до 255 Зеленый - Число - возвращается значение от 0 до 255 Синий - Число - возвращается значение от 0 до 255
Пример вызова
ЕХТ_Цвет.RGBпоHSV(Тон, Насыщенность, Светлота, Красный, Зеленый, Синий)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает строку вида #ffffff
Синтаксис
Функция вHex(Знач Цвет) Экспорт
Пример вызова
Результат = ЕХТ_Цвет.вHex(Цвет)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает массив с компонентами цвета, где Элемент[0] - красный, Элемент[1] - зеленый, Элемент[2] - синий. Если преобразование недоступно возвращает Неопределено.
Синтаксис
Функция вRGB(Знач Цвет) Экспорт
Пример вызова
Результат = ЕХТ_Цвет.вRGB(Цвет)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает компоненты дополнительного цвета по модели HSV, по переданным компонентам HSV
Синтаксис
Процедура ДополнительныйЦветПоHSV(Знач Тон, Знач Насыщенность, Знач Светлота, НовыйТон, НоваяНасыщенность, НоваяСветлота) Экспорт
Параметры
Тон - Число - от 0 до 360 (градусов) Насыщенность - Число - от 0 до 100 (%) Светлота - Число - от 0 до 100 (%) НовыйТон - Число - возвращается значение от 0 до 360 (градусов) НоваяНасыщенность - Число - возвращается значение от 0 до 100 (%) НоваяСветлота - Число - возвращается значение от 0 до 100 (%)
Пример вызова
ЕХТ_Цвет.ДополнительныйЦветПоHSV(Тон, Насыщенность, Светлота, НовыйТон, НоваяНасыщенность, НоваяСветлота)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает компоненты дополнительного цвета по модели HSV, по переданным компонентам RGB
Синтаксис
Процедура ДополнительныйЦветПоRGB(Знач Красный, Знач Зеленый, Знач Синий, НовыйКрасный, НовыйЗеленый, НовыйСиний) Экспорт
Параметры
Красный - Число - от 0 до 255 Зеленый - Число - от 0 до 255 Синий - Число - от 0 до 255 НовыйКрасный - Число - возвращается значение от 0 до 255 НовыйЗеленый - Число - возвращается значение от 0 до 255 НовыйСиний - Число - возвращается значение от 0 до 255
Пример вызова
ЕХТ_Цвет.ДополнительныйЦветПоRGB(Красный, Зеленый, Синий, НовыйКрасный, НовыйЗеленый, НовыйСиний)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает цвет из СтрокаHex вида #ffffff
Синтаксис
Функция ИзHex(Знач СтрокаHex) Экспорт
Пример вызова
Результат = ЕХТ_Цвет.ИзHex(СтрокаHex)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Функция возвращает цвет, отличающийся от исходного светлотой
Синтаксис
Функция ИзменитьСветлоту(Знач Цвет, Знач ДельтаСветлоты) Экспорт
Параметры
Цвет - Цвет - исходный цвет ДельтаСветлоты - Число - процент изменения светлоты цвета. Значение 100 белый цвет, -100 черный.
Возвращаемое значение
Цвет - цвет с измененной светлотой
Пример вызова
Результат = ЕХТ_Цвет.ИзменитьСветлоту(Цвет, ДельтаСветлоты)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Преобразовывает число в HEX строку.
Синтаксис
Функция вHEX(Знач Число) Экспорт
Параметры
Число - Десятичное число которое будет преобразовано в HEX.
Возвращаемое значение
- СтрокаHEX - Строка HEX содержащая символы.
Пример вызова
Результат = ЕХТ_Число.вHEX(Число)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Преобразовывает десятичное число в бинарную строку
Синтаксис
Функция вБинарнуюСтроку(Знач Число) Экспорт
Параметры
Число - Десятичное число которое будет преобразовано в бинарный вид.
Возвращаемое значение
- Текстовая строка в бинарном представлении (Пример "000010101").
Пример вызова
Результат = ЕХТ_Число.вБинарнуюСтроку(Число)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Выполняет преобразование арабского числа в римское.
Синтаксис
Функция вРимскуюНотацию(Знач АрабскоеЧисло, Знач ИспользоватьКириллицу = Истина) Экспорт
Параметры
АрабскоеЧисло - Число - число, целое, от 0 до 999; ИспользоватьКириллицу - Булево - использовать в качестве арабских цифр кириллицу или латиницу.
Возвращаемое значение
Строка - число в римской нотации.
Пример вызова
СтроковыеФункцииКлиентСервер.вРимскуюНотацию(17) = "ХVII".
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Преобразовывает HEX строку в число.
Синтаксис
Функция ИзHEX(Знач СтрокаHEX) Экспорт
Параметры
СтрокаHEX - Строка HEX содержащая символы.
Возвращаемое значение
- Десятичное число.
Пример вызова
Результат = ЕХТ_Число.ИзHEX(СтрокаHEX)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Преобразовывает бинарную строку в десятичное число
Синтаксис
Функция ИзБинарнойСтроки(Знач БинарнаяСтрока) Экспорт
Параметры
БинарнаяСтрока - Текстовая строка в бинарном представлении (Пример "000010101").
Возвращаемое значение
- Десятичное число.
Пример вызова
Результат = ЕХТ_Число.ИзБинарнойСтроки(БинарнаяСтрока)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Выполняет преобразование римского числа в арабское.
Синтаксис
Функция ИзРимскойНотации(Знач РимскоеЧисло, Знач ИспользоватьКириллицу = Истина) Экспорт
Параметры
РимскоеЧисло - Строка - число, записанное римскими цифрами; ИспользоватьКириллицу - Булево - использовать в качестве арабских цифр кириллицу или латиницу.
Возвращаемое значение
Число - преобразованное число.
Пример вызова
ЕХТ_Число.ИзРимскойНотации("ХVII") = 17.
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Преобразует исходную строку в число без вызова исключений.
Синтаксис
Функция ИзСтроки(Знач Значение, Знач ЧислоРазрядов = Неопределено, Знач ЧислоРазрядовДробнойЧасти = Неопределено) Экспорт
Параметры
Значение - Строка - Строка, которую необходимо привести к числу.
Например, "10", "+10", "010", вернет 10;
"(10)", "-10",вернет -10;
"10,2", "10.2",вернет 10.2;
"000", " ", "",вернет 0;
"10текст", вернет Неопределено.
Возвращаемое значение
Число, Неопределено - Полученное число, либо Неопределено, если строка не является числом.
Пример вызова
Результат = ЕХТ_Число.ИзСтроки(Значение, ЧислоРазрядов, ЧислоРазрядовДробнойЧасти)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает случайное целое число в заданном диапазоне.
Синтаксис
Функция Случайное(Знач НижняяГраница = 0, Знач ВерхняяГраница = 4294967295, Знач НачальноеЧислоГСЧ = Неопределено) Экспорт
Параметры
НижняяГраница - Число - Нижняя граница диапазона. Задается целым числом и не может быть меньше 0.
Значение по умолчанию: 0.
ВерхняяГраница - Число - Верхняя граница диапазона. Задается целым числом и не может быть больше 4294967295 (2^32 - 1), а также меньше значения параметра <НижняяГраница>.
Значение по умолчанию: 4294967295.
НачальноеЧислоГСЧ - Число - Начальное число, которым инициализируется генератор случайных чисел.
Возвращаемое значение
- Число
Пример вызова
Результат = ЕХТ_Число.Случайное(НижняяГраница, ВерхняяГраница, НачальноеЧислоГСЧ)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Функция возвращает параметры компиляции, наименование тегов.
Синтаксис
Функция ПараметрыОбработки() Экспорт
Пример вызова
Результат = ЕХТ_Шаблонизатор.ПараметрыОбработки()
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает заполненную строку из шаблона и параметров заполнения шаблона.
Синтаксис
Функция Получить(Знач Шаблон, ЗначенияПараметров = Неопределено, Знач ПараметрыОбработки = Неопределено) Экспорт
Параметры
Шаблон - Строка, шаблон для заполнения. ЗначенияПараметров - Структура, параметры заполнения шаблона. Ключи структуры не должны пересекаться с именами глобальных объектов, "Справочники", "Документы", именами общих модулей и т.д. ПараметрыОбработки - Структура, инициализированная в ПараметрыОбработки().
Возвращаемое значение
Структура - где Структура.Данные это заполненный шаблон.
Пример вызова
Результат = ЕХТ_Шаблонизатор.Получить(Шаблон, ЗначенияПараметров, ПараметрыОбработки)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает строку HTML из шаблона и параметров заполнения.
Синтаксис
Функция ПолучитьХТМЛ(Знач Шаблон, Знач ЗначенияПараметров = Неопределено, Знач ПараметрыОбработки = Неопределено) Экспорт
Параметры
Шаблон - Строка, шаблон для заполнения. ЗначенияПараметров - Структура, параметры заполнения шаблона. Ключи структуры не должны пересекаться с именами глобальных объектов, "Справочники", "Документы", именами общих модулей и т.д.
Возвращаемое значение
Строка - заполненный шаблон.
Пример вызова
Результат = ЕХТ_Шаблонизатор.ПолучитьХТМЛ(Шаблон, ЗначенияПараметров, ПараметрыОбработки)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Возвращает форму, в которой размещен элемент
Синтаксис
Функция Форма(Знач Элемент) Экспорт
Параметры
Элемент - ЭлементФормы - элемент, для которого надо получить форму.
Возвращаемое значение
- Форма - УправляемаяФорма
Пример вызова
Результат = ЕХТ_Элементы.Форма(Элемент)
Доступность
Сервер, Тонкий клиент
Возвращает общий модуль по имени.
Синтаксис
Функция ОбщийМодуль(Знач ИмяМодуля) Экспорт
Пример вызова
Результат = ЕХТ.ОбщийМодуль(ИмяМодуля)
Доступность
Сервер, Тонкий клиент, Внешнее соединение
Формирует и выводит сообщение, которое может быть связано с элементом управления формы.
Синтаксис
Процедура СообщитьПользователю(Знач ТекстСообщенияПользователю, Знач КлючДанных = Неопределено, Знач Поле = "", Знач ПутьКДанным = "", Отказ = Ложь) Экспорт
Параметры
ТекстСообщенияПользователю - Строка - текст сообщения. КлючДанных - ЛюбаяСсылка - объект или ключ записи информационной базы, к которому это сообщение относится. Поле - Строка - наименование реквизита формы. ПутьКДанным - Строка - путь к данным (путь к реквизиту формы). Отказ - Булево - выходной параметр, всегда устанавливается в значение Истина.
Пример вызова
1. Для вывода сообщения у поля управляемой формы, связанного с реквизитом объекта:
ЕХТ.СообщитьПользователю(
НСтр("ru = 'Сообщение об ошибке.'"), ,
"ПолеВРеквизитеФормыОбъект",
"Объект");
Альтернативный вариант использования в форме объекта:
ЕХТ.СообщитьПользователю(
НСтр("ru = 'Сообщение об ошибке.'"), ,
"Объект.ПолеВРеквизитеФормыОбъект");
2. Для вывода сообщения рядом с полем управляемой формы, связанным с реквизитом формы:
ЕХТ.СообщитьПользователю(
НСтр("ru = 'Сообщение об ошибке.'"), ,
"ИмяРеквизитаФормы");
3. Для вывода сообщения связанного с объектом информационной базы:
ЕХТ.СообщитьПользователю(
НСтр("ru = 'Сообщение об ошибке.'"), ОбъектИнформационнойБазы, "Ответственный",,Отказ);
4. Для вывода сообщения по ссылке на объект информационной базы:
ЕХТ.СообщитьПользователю(
НСтр("ru = 'Сообщение об ошибке.'"), Ссылка, , , Отказ);
Случаи некорректного использования:
1. Передача одновременно параметров КлючДанных и ПутьКДанным.
2. Передача в параметре КлючДанных значения типа отличного от допустимых.
3. Установка ссылки без установки поля (и/или пути к данным).
Доступность
Сервер, Тонкий клиент, Внешнее соединение