diff --git a/src/content/docs/knowledge-base/Общие/(БСП) Стандартные подсистемы/Контактная информация/Программный интерфейс/Добавить контактную информацию.md b/src/content/docs/knowledge-base/Общие/(БСП) Стандартные подсистемы/Контактная информация/Программный интерфейс/Добавить контактную информацию.md new file mode 100644 index 0000000..54e0565 --- /dev/null +++ b/src/content/docs/knowledge-base/Общие/(БСП) Стандартные подсистемы/Контактная информация/Программный интерфейс/Добавить контактную информацию.md @@ -0,0 +1,16 @@ +--- +title: Добавить контактную информацию +slug: общие-бсп-стандартные-подсистемы-контактная-информация-программный-интерфейс/добавить-контактную-информацию +--- + +# Пример применения +```bsl +// Добавляет контактную информацию к объекту по представлению или JSON. + +Организация = Справочники.Организации.ОрганизацияПоУмолчанию(); +ВидEmail = Справочники.ВидыКонтактнойИнформации.EmailОрганизации; +Email = "info@testmail.ru"; + +УправлениеКонтактнойИнформацией.ДобавитьКонтактнуюИнформацию(Организация, Email, ВидEmail); +ОбщегоНазначения.СообщитьПользователю("Для организации заполнен email"); +``` \ No newline at end of file diff --git a/src/content/docs/knowledge-base/Общие/(БСП) Стандартные подсистемы/Контактная информация/Программный интерфейс/Контактная информация объекта.md b/src/content/docs/knowledge-base/Общие/(БСП) Стандартные подсистемы/Контактная информация/Программный интерфейс/Контактная информация объекта.md new file mode 100644 index 0000000..ec47e23 --- /dev/null +++ b/src/content/docs/knowledge-base/Общие/(БСП) Стандартные подсистемы/Контактная информация/Программный интерфейс/Контактная информация объекта.md @@ -0,0 +1,40 @@ +--- +title: Контактная информация объекта +slug: общие-бсп-стандартные-подсистемы-контактная-информация-программный-интерфейс/контактная-информация-объекта +--- +# Описание + +```bsl +// Возвращает таблицу, содержащую контактную информацию объекта. +// Поведение, при котором возвращалось представление контактной информации, теперь считается устаревшим +// и сохранено для обратной совместимости. Для получения представления контактной информации рекомендуется +// использовать функцию ПредставлениеКонтактнойИнформацииОбъекта. +// +// Параметры: +// СсылкаИлиОбъект - ОпределяемыйТип.ВладелецКонтактнойИнформации +// - СправочникОбъект +// - ДокументОбъект - ссылка или объект-владелец контактной информации (организация, +// контрагент, партнер и т.д.). +// ВидИлиТипКонтактнойИнформации - СправочникСсылка.ВидыКонтактнойИнформации - отбор по виду контактной информации. +// - ПеречислениеСсылка.ТипыКонтактнойИнформации - отбор по типу контактной информации. +// Дата - Дата - дата с которой действует запись контактной информации, +// используется при хранении истории изменения контактной информации. +// Если владелец хранит историю изменений, то при несоответствии параметра +// дате будет вызвано исключение. +// ТолькоПредставление - Булево - если Истина, то возвращает только представление, иначе таблицу значений. +// Для получения представления рекомендуется использовать функцию ПредставлениеКонтактнойИнформацииОбъекта. +// +// Возвращаемое значение: +// ТаблицаЗначений: +// * Объект - ЛюбаяСсылка - владелец контактной информации. +// * Вид - СправочникСсылка.ВидыКонтактнойИнформации - вид контактной информации. +// * Тип - ПеречислениеСсылка.ТипыКонтактнойИнформации - тип контактной информации. +// * Значение - Строка - контактная информация во внутреннем формате JSON. +// * Представление - Строка - представление контактной информации. +// * Дата - Дата - дата, с которой действует запись контактной информации. +// * ИдентификаторСтрокиТабличнойЧасти - Число - идентификатор строки этой табличной части +// * ЗначенияПолей - Строка - устаревший XML, соответствующий XDTO пакетам КонтактнаяИнформация или Адрес. Для +// обратной совместимости. +// +Функция КонтактнаяИнформацияОбъекта(СсылкаИлиОбъект, ВидИлиТипКонтактнойИнформации = Неопределено, Дата = Неопределено, ТолькоПредставление = Истина) Экспорт +``` \ No newline at end of file diff --git a/src/content/docs/knowledge-base/Общие/(БСП) Стандартные подсистемы/Контактная информация/Программный интерфейс/Контактная информация объектов.md b/src/content/docs/knowledge-base/Общие/(БСП) Стандартные подсистемы/Контактная информация/Программный интерфейс/Контактная информация объектов.md new file mode 100644 index 0000000..83b222c --- /dev/null +++ b/src/content/docs/knowledge-base/Общие/(БСП) Стандартные подсистемы/Контактная информация/Программный интерфейс/Контактная информация объектов.md @@ -0,0 +1,36 @@ +--- +title: Контактная информация объектов +slug: общие-бсп-стандартные-подсистемы-контактная-информация-программный-интерфейс/контактная-информация-объектов +--- +# Описание + +```bsl +// Возвращает таблицу, содержащую контактную информацию нескольких объектов. +// +// Параметры: +// СсылкиИлиОбъекты - Массив - владельцы контактной информации. +// ТипыКонтактнойИнформации - Массив +// - ПеречислениеСсылка.ТипыКонтактнойИнформации - если указаны, то будет получена +// контактная информация только этих типов. +// ВидыКонтактнойИнформации - Массив +// - СправочникСсылка.ВидыКонтактнойИнформации - если указаны, то будет возвращена +// контактная информация только этих видов контактной информации. +// Дата - Дата - дата с которой действует запись контактной информации, +// используется при хранении истории изменения контактной информации. +// Если владелец хранит историю изменений, то при несоответствии параметра +// дате будет вызвано исключение. +// +// Возвращаемое значение: +// ТаблицаЗначений: +// * Объект - ЛюбаяСсылка - владелец контактной информации. +// * Вид - СправочникСсылка.ВидыКонтактнойИнформации - вид контактной информации. +// * Тип - ПеречислениеСсылка.ТипыКонтактнойИнформации - тип контактной информации. +// * Значение - Строка - контактная информация во внутреннем формате JSON. +// * Представление - Строка - представление контактной информации. +// * Дата - Дата - дата, с которой действует запись контактной информации. +// * ИдентификаторСтрокиТабличнойЧасти - Число - идентификатор строки этой табличной части +// * ЗначенияПолей - Строка - устаревший XML, соответствующий XDTO пакетам КонтактнаяИнформация или Адрес. Для +// обратной совместимости. +// +Функция КонтактнаяИнформацияОбъектов(СсылкиИлиОбъекты, Знач ТипыКонтактнойИнформации = Неопределено, Знач ВидыКонтактнойИнформации = Неопределено, Дата = Неопределено) Экспорт +``` \ No newline at end of file diff --git a/src/content/docs/knowledge-base/Общие/(БСП) Стандартные подсистемы/Контактная информация/Программный интерфейс/Контактная информация по представлению.md b/src/content/docs/knowledge-base/Общие/(БСП) Стандартные подсистемы/Контактная информация/Программный интерфейс/Контактная информация по представлению.md new file mode 100644 index 0000000..216c8da --- /dev/null +++ b/src/content/docs/knowledge-base/Общие/(БСП) Стандартные подсистемы/Контактная информация/Программный интерфейс/Контактная информация по представлению.md @@ -0,0 +1,16 @@ +--- +title: Контактная информация по представлению +slug: общие-бсп-стандартные-подсистемы-контактная-информация-программный-интерфейс/контактная-информация-по-представлению +--- + +# Пример применения +```bsl +//Преобразует представление контактной информации во внутренний формат JSON. +// Для адресов, введенных в свободной форме, корректное преобразование не гарантируется. + +ВидЮрАдрес = Справочники.ВидыКонтактнойИнформации.ЮрАдресОрганизации; +ЮрАдрес = "г. Москва, 3-й Самотечный пер., д. 23"; + +КонтактнаяИнформация = УправлениеКонтактнойИнформацией.КонтактнаяИнформацияПоПредставлению(ЮрАдрес, ВидЮрАдрес); +ОбщегоНазначения.СообщитьПользователю(КонтактнаяИнформация); +``` \ No newline at end of file diff --git a/src/content/docs/knowledge-base/Общие/(БСП) Стандартные подсистемы/Контактная информация/Программный интерфейс/Объект подключен к подсистеме Контактная информация.md b/src/content/docs/knowledge-base/Общие/(БСП) Стандартные подсистемы/Контактная информация/Программный интерфейс/Объект подключен к подсистеме Контактная информация.md new file mode 100644 index 0000000..ecf47d3 --- /dev/null +++ b/src/content/docs/knowledge-base/Общие/(БСП) Стандартные подсистемы/Контактная информация/Программный интерфейс/Объект подключен к подсистеме Контактная информация.md @@ -0,0 +1,15 @@ +--- +title: Объект подключен к подсистеме Контактная информация +slug: общие-бсп-стандартные-подсистемы-контактная-информация-программный-интерфейс/объект-подключен-к-подсистеме-контактная-информация +--- +# Пример применения +```bsl +// Возвращает признак, что объект подключен к подсистеме "Контактная информация" +// и содержит табличную часть КонтактнаяИнформация. + +Валюта = Справочники.Валюты.НайтиПоКоду("643"); +Организация = Справочники.Организации.ОрганизацияПоУмолчанию(); + +СодержитКонтакты = УправлениеКонтактнойИнформацией.СодержитКонтактнуюИнформацию(Организация); +ОбщегоНазначения.СообщитьПользователю(СодержитКонтакты); +``` \ No newline at end of file diff --git a/src/content/docs/knowledge-base/Общие/(БСП) Стандартные подсистемы/Контактная информация/Программный интерфейс/Отбор контактной информации.md b/src/content/docs/knowledge-base/Общие/(БСП) Стандартные подсистемы/Контактная информация/Программный интерфейс/Отбор контактной информации.md new file mode 100644 index 0000000..848dcac --- /dev/null +++ b/src/content/docs/knowledge-base/Общие/(БСП) Стандартные подсистемы/Контактная информация/Программный интерфейс/Отбор контактной информации.md @@ -0,0 +1,35 @@ +--- +title: Отбор контактной информации +slug: общие-бсп-стандартные-подсистемы-контактная-информация-программный-интерфейс/отбор-контактной-информации +--- +# Описание +```bsl +// Конструктор параметра Отбор для функции КонтактнаяИнформация. +// +// Возвращаемое значение: +// Структура: +// * ТипыКонтактнойИнформации - Массив из ПеречислениеСсылка.ТипыКонтактнойИнформации - отбор по типу контактной информации. +// * ВидыКонтактнойИнформации - Массив из СправочникСсылка.ВидыКонтактнойИнформации - отбор по видам контактной информации. +// * Дата - Дата - дата с которой действует запись контактной информации, используется при хранении +// истории изменения контактной информации. Если владелец хранит историю изменений, +// то при несоответствии параметра дате будет вызвано исключение. +// * КодЯзыка - Строка - код языка, на котором необходимо получить представление контактной информации. +// Представления контактной информации типа Адрес будет получено путем транслитерации, на остальные +// типы контактной информации данных параметр не влияет. +// +ОтборКИ = УправлениеКонтактнойИнформацией.ОтборКонтактнойИнформации(); +``` + +# Пример применения +```bsl +// Возвращает таблицу, содержащую контактную информацию нескольких объектов. + +Организация = Справочники.Организации.ОрганизацияПоУмолчанию(); + +ОтборКИ = УправлениеКонтактнойИнформацией.ОтборКонтактнойИнформации(); +ОтборКИ.ТипыКонтактнойИнформации.Добавить(Перечисления.ТипыКонтактнойИнформации.Телефон); +ОтборКИ.ТипыКонтактнойИнформации.Добавить(Перечисления.ТипыКонтактнойИнформации.АдресЭлектроннойПочты); + +ТаблицаКонтактов = УправлениеКонтактнойИнформацией.КонтактнаяИнформация(Организация, ОтборКИ); +ТаблицаКонтактов.ВыбратьСтроку(); // для отладки (толстый клиент) +``` \ No newline at end of file diff --git a/src/content/docs/knowledge-base/Общие/(БСП) Стандартные подсистемы/Контактная информация/Программный интерфейс/Представление контактной информации объекта.md b/src/content/docs/knowledge-base/Общие/(БСП) Стандартные подсистемы/Контактная информация/Программный интерфейс/Представление контактной информации объекта.md new file mode 100644 index 0000000..6585876 --- /dev/null +++ b/src/content/docs/knowledge-base/Общие/(БСП) Стандартные подсистемы/Контактная информация/Программный интерфейс/Представление контактной информации объекта.md @@ -0,0 +1,45 @@ +--- +title: Представление контактной информации объекта +slug: общие-бсп-стандартные-подсистемы-контактная-информация-программный-интерфейс/представление-контактной-информации-объекта +--- +# Описание + +```bsl + +// Возвращает представление контактной информации объекта. +// +// Параметры: +// СсылкаИлиОбъект - Произвольный - владелец контактной информации. +// ВидКонтактнойИнформации - СправочникСсылка.ВидыКонтактнойИнформации - вид контактной информации. +// Разделитель - Строка - разделитель, который добавляется в представление между записями контактной информации. +// По умолчанию это запятая с последующим пробелом, для исключения +// пробела необходимо использовать признак БезПробелов у параметра ДополнительныеПараметры. +// Дата - Дата - дата, с которой действует запись контактной информации. Если контактная информация +// хранит историю изменения, то передача даты обязательна. +// ДополнительныеПараметры - Структура - необязательные параметры для формирования представления контактной информации: +// * ТолькоПервая - Булево - если Истина, то будет возвращено представление только основной(первой) записи +// контактной информации. По умолчанию - Ложь; +// * БезПробелов - Булево - если Истина, то после разделителя не будет автоматически добавляться пробел. +// По умолчанию - Ложь; +// +// Возвращаемое значение: +// Строка +// +Функция ПредставлениеКонтактнойИнформацииОбъекта(СсылкаИлиОбъект, ВидКонтактнойИнформации, Разделитель = ",", Дата = Неопределено, ДополнительныеПараметры = Неопределено) Экспорт + +``` + +# Пример применения + +```bsl + +Организация = Справочники.Организации.ОрганизацияПоУмолчанию(); +ВидЮрАдрес = Справочники.ВидыКонтактнойИнформации.ЮрАдресОрганизации; +ВидEmail = Справочники.ВидыКонтактнойИнформации.EmailОрганизации; + +ЮрАдрес = УправлениеКонтактнойИнформацией.ПредставлениеКонтактнойИнформацииОбъекта(Организация, ВидЮрАдрес); +Email = УправлениеКонтактнойИнформацией.ПредставлениеКонтактнойИнформацииОбъекта(Организация, ВидEmail); + +ОбщегоНазначения.СообщитьПользователю(СтрШаблон("Юр. адрес: %1; Email: %2", ЮрАдрес, Email)); + +``` \ No newline at end of file diff --git a/src/content/docs/knowledge-base/Общие/(БСП) Стандартные подсистемы/Контактная информация/Программный интерфейс/Представление контактной информации.md b/src/content/docs/knowledge-base/Общие/(БСП) Стандартные подсистемы/Контактная информация/Программный интерфейс/Представление контактной информации.md new file mode 100644 index 0000000..5ff959c --- /dev/null +++ b/src/content/docs/knowledge-base/Общие/(БСП) Стандартные подсистемы/Контактная информация/Программный интерфейс/Представление контактной информации.md @@ -0,0 +1,20 @@ +--- +title: Представление контактной информации +slug: общие-бсп-стандартные-подсистемы-контактная-информация-программный-интерфейс/представление-контактной-информации +--- + +# Пример применения +```bsl +//Возвращает представление контактной информации (адреса, телефона, электронной почты и т.п.). + +ВидЮрАдрес = Справочники.ВидыКонтактнойИнформации.ЮрАдресОрганизации; +ЮрАдрес = "г. Москва, 3-й Самотечный пер., д. 23"; + +// Представление -> Строка JSON +КонтактнаяИнформация = УправлениеКонтактнойИнформацией.КонтактнаяИнформацияПоПредставлению(ЮрАдрес, ВидЮрАдрес); + +// Строка JSON -> Представление +Представление = УправлениеКонтактнойИнформацией.ПредставлениеКонтактнойИнформации(КонтактнаяИнформация); + +ОбщегоНазначения.СообщитьПользователю(Представление); +``` \ No newline at end of file diff --git a/src/content/docs/knowledge-base/Общие/(БСП) Стандартные подсистемы/Контактная информация/Программный интерфейс/Представление телефона.md b/src/content/docs/knowledge-base/Общие/(БСП) Стандартные подсистемы/Контактная информация/Программный интерфейс/Представление телефона.md new file mode 100644 index 0000000..f67d77d --- /dev/null +++ b/src/content/docs/knowledge-base/Общие/(БСП) Стандартные подсистемы/Контактная информация/Программный интерфейс/Представление телефона.md @@ -0,0 +1,24 @@ +--- +title: Представление телефона +slug: общие-бсп-стандартные-подсистемы-контактная-информация-программный-интерфейс/представление-телефона +--- +# Пример применения +```bsl +// Формирует строковое представление телефона. +//Синтаксис +// +// Функция СформироватьПредставлениеТелефона(КодСтраны, КодГорода, НомерТелефона, Добавочный, Комментарий) Экспорт +//Параметры +// +// КодСтраны - Строка - код страны. +// КодГорода - Строка - код города. +// НомерТелефона - Строка - номер телефона. +// Добавочный - Строка - добавочный номер. +// Комментарий - Строка - комментарий. +//Возвращаемое значение +// +// - Строка - представление телефона. + +Телефон = УправлениеКонтактнойИнформациейКлиентСервер.СформироватьПредставлениеТелефона("+7", "495", "154-88-77", "7722", "с 9 до 17"); +ОбщегоНазначения.СообщитьПользователю(Телефон); +``` \ No newline at end of file diff --git a/src/content/docs/knowledge-base/Общие/(БСП) Стандартные подсистемы/Контактная информация/Программный интерфейс/Проверить адрес на соответствие требованиям.md b/src/content/docs/knowledge-base/Общие/(БСП) Стандартные подсистемы/Контактная информация/Программный интерфейс/Проверить адрес на соответствие требованиям.md new file mode 100644 index 0000000..8300a6a --- /dev/null +++ b/src/content/docs/knowledge-base/Общие/(БСП) Стандартные подсистемы/Контактная информация/Программный интерфейс/Проверить адрес на соответствие требованиям.md @@ -0,0 +1,20 @@ +--- +title: Проверить адрес на соответствие требованиям +slug: общие-бсп-стандартные-подсистемы-контактная-информация-программный-интерфейс/проверить-адрес-на-соответствие-требованиям +--- + +# Пример применения +```bsl +//Проверяет адрес на соответствие требованиям к адресной информации. + +ВидЮрАдрес = Справочники.ВидыКонтактнойИнформации.ЮрАдресОрганизации; +ЮрАдрес = "г. Москва, 3-й Самотечный пер., д. 23"; + +АдресJSON = УправлениеКонтактнойИнформацией.КонтактнаяИнформацияПоПредставлению(ЮрАдрес, ВидЮрАдрес); + +ДанныеПроверки = РаботаСАдресами.ПроверитьАдрес(АдресJSON); + +Текст = СтрШаблон("Результат проверки: %1; Кол-во ошибок: %2", ДанныеПроверки.Результат, ДанныеПроверки.СписокОшибок.Количество()); + +ОбщегоНазначения.СообщитьПользователю(Текст); +``` \ No newline at end of file diff --git a/src/content/docs/knowledge-base/Общие/(БСП) Стандартные подсистемы/Контактная информация/Программный интерфейс/Сведения о телефоне.md b/src/content/docs/knowledge-base/Общие/(БСП) Стандартные подсистемы/Контактная информация/Программный интерфейс/Сведения о телефоне.md new file mode 100644 index 0000000..931d777 --- /dev/null +++ b/src/content/docs/knowledge-base/Общие/(БСП) Стандартные подсистемы/Контактная информация/Программный интерфейс/Сведения о телефоне.md @@ -0,0 +1,38 @@ +--- +title: Сведения о телефоне +slug: общие-бсп-стандартные-подсистемы-контактная-информация-программный-интерфейс/сведения-о-телефоне +--- + +# Пример применения +```bsl +// Возвращает сведения о телефоне или факсе. +//Синтаксис +// +// Функция СведенияОТелефоне(КонтактнаяИнформация = Неопределено) Экспорт +//Параметры +// +// КонтактнаяИнформация - Строка - телефон во внутреннем формате JSON или в XML, соответствующем XDTO-пакету контактная +// информация. +// - Неопределено - конструктор, возвращает список незаполненных полей телефона. +//Возвращаемое значение +// +// Структура: +// * Представление - Строка - полное представление телефона с добавочным номером и комментарием, например, "+7 495 +// 1234567 (+12) Звонить после 18:00". +// * КодСтраны - Строка - код страны. Например, +7. +// * КодГорода - Строка - код города. Например, 495. +// * НомерТелефона - Строка - номер телефона. Например, 1234567. +// * Добавочный - Строка - добавочный номер телефона. Например, +12. +// * Комментарий - Строка - комментарий к номеру телефона. Например, Звонить после 18:00. + + +ВидТелефон = Справочники.ВидыКонтактнойИнформации.ЮрАдресОрганизации; +Телефон = "+7 495 113-02-54"; + +ТелефонJSON = УправлениеКонтактнойИнформацией.КонтактнаяИнформацияПоПредставлению(Телефон, ВидТелефон); + +СтруктураСведений = УправлениеКонтактнойИнформацией.СведенияОТелефоне(ТелефонJSON); + +Текст = СтрШаблон("Код страны: %1; код города: %2", СтруктураСведений.КодСтраны, СтруктураСведений.КодГорода); +ОбщегоНазначения.СообщитьПользователю(Текст); +``` \ No newline at end of file diff --git a/src/content/docs/knowledge-base/Общие/(БСП) Стандартные подсистемы/Контактная информация/Программный интерфейс/Сведения об адресе.md b/src/content/docs/knowledge-base/Общие/(БСП) Стандартные подсистемы/Контактная информация/Программный интерфейс/Сведения об адресе.md new file mode 100644 index 0000000..84e6ce6 --- /dev/null +++ b/src/content/docs/knowledge-base/Общие/(БСП) Стандартные подсистемы/Контактная информация/Программный интерфейс/Сведения об адресе.md @@ -0,0 +1,19 @@ +--- +title: Сведения об адресе +slug: общие-бсп-стандартные-подсистемы-контактная-информация-программный-интерфейс/сведения-об-адресе +--- + +# Пример применения +```bsl +// Возвращает сведения об адресе в виде отдельных частей адреса и различных кодов (код региона, ОКТМО и др.). +// Для преобразования полученных полей адреса в во внутренний формат JSON следует использовать функцию ПоляАдресаВJSON. + +ВидЮрАдрес = Справочники.ВидыКонтактнойИнформации.ЮрАдресОрганизации; +ЮрАдрес = "123056, г. Москва, 3-й Самотечный пер., д. 23"; + +АдресJSON = УправлениеКонтактнойИнформацией.КонтактнаяИнформацияПоПредставлению(ЮрАдрес, ВидЮрАдрес); + +СтруктураСведений = РаботаСАдресами.СведенияОбАдресе(АдресJSON); +Текст = СтрШаблон("Номер дома: %1; индекс: %2", СтруктураСведений.Здание.Номер, СтруктураСведений.Индекс); +ОбщегоНазначения.СообщитьПользователю(Текст); +``` \ No newline at end of file diff --git a/src/content/docs/knowledge-base/Общие/(БСП) Стандартные подсистемы/Свойства/Программный интерфейс/Добавить значение свойства.md b/src/content/docs/knowledge-base/Общие/(БСП) Стандартные подсистемы/Свойства/Программный интерфейс/Добавить значение свойства.md new file mode 100644 index 0000000..31da901 --- /dev/null +++ b/src/content/docs/knowledge-base/Общие/(БСП) Стандартные подсистемы/Свойства/Программный интерфейс/Добавить значение свойства.md @@ -0,0 +1,39 @@ +--- +title: Добавить значение свойства +slug: общие-бсп-стандартные-подсистемы-свойства-программный-интерфейс/добавить-значение-свойства +--- + +# Описание + +```bsl +//Добавляет доступное значение для реквизита с типом ЗначенияСвойствОбъектов +// или ЗначенияСвойствОбъектовИерархия. +//Синтаксис +// +// Функция ДобавитьЗначениеСвойства(Знач Владелец, Параметры, Иерархия = Ложь) Экспорт +// +// Параметры: +// Владелец - Строка - имя дополнительного реквизита. +// - ПланВидовХарактеристикСсылка.ДополнительныеРеквизитыИСведения - дополнительный реквизит, +// для которого надо добавить значение. +// Параметры - см. ПараметрыДобавленияЗначенияСвойства. +// Иерархия - Булево +//Возвращаемое значение +// +// СправочникСсылка.ЗначенияСвойствОбъектов +// СправочникСсылка.ЗначенияСвойствОбъектовИерархия +ЗначениеСвойства = УправлениеСвойствами.ДобавитьЗначениеСвойства(ИмяСвойства, ПараметрыЗначения); +``` + +# Пример применения +```bsl +ПараметрыЗначения = УправлениеСвойствами.ПараметрыДобавленияЗначенияСвойства(); +ПараметрыЗначения.Наименование = "AMOLED"; + +ИмяСвойства = "ТехнологияЭкрана_d52aa705261143e68e2e30968b1e668b"; + +ЗначениеСвойства = УправлениеСвойствами.ДобавитьЗначениеСвойства(ИмяСвойства, ПараметрыЗначения); + +ТекстСообщения = "Для дополнительного реквизита ""ТехнологияЭкрана"" добавлено значение " + ПараметрыЗначения.Наименование; +ОбщегоНазначения.СообщитьПользователю(ТекстСообщения); +``` \ No newline at end of file diff --git a/src/content/docs/knowledge-base/Общие/(БСП) Стандартные подсистемы/Свойства/Программный интерфейс/Добавить свойство.md b/src/content/docs/knowledge-base/Общие/(БСП) Стандартные подсистемы/Свойства/Программный интерфейс/Добавить свойство.md new file mode 100644 index 0000000..caaf3ad --- /dev/null +++ b/src/content/docs/knowledge-base/Общие/(БСП) Стандартные подсистемы/Свойства/Программный интерфейс/Добавить свойство.md @@ -0,0 +1,44 @@ +--- +title: Добавить свойство +slug: общие-бсп-стандартные-подсистемы-свойства-программный-интерфейс/добавить-свойство +--- + +# Описание + +```bsl +// Добавляет дополнительное свойство к переданному объекту. +// Синтаксис +// +// Процедура ДобавитьСвойство(Владелец, Параметры, ЭтоСведение = Ложь) Экспорт +// Параметры +// +// Владелец - ОбъектМетаданных +// - Строка - полное имя объекта метаданных или имя набора свойств. +// - СправочникСсылка.НаборыДополнительныхРеквизитовИСведений - ссылка на набор свойств. +// Параметры - см. ПараметрыДобавленияСвойства. +// ЭтоСведение - Булево - если Истина, будет добавлено дополнительное сведение. +// Значение по умолчанию Ложь - добавляется дополнительный реквизит. +УправлениеСвойствами.ДобавитьСвойство(НаборСвойств, ПараметрыСвойства); +``` + +# Пример применения +```bsl +ВидНоменклатуры = Справочники.ВидыНоменклатуры.НайтиПоНаименованию("Смартфоны"); +Если НЕ ВидНоменклатуры.Пустая() Тогда + + НаборСвойств = ОбщегоНазначения.ЗначениеРеквизитаОбъекта(ВидНоменклатуры, "НаборСвойств"); + + ПараметрыСвойства = УправлениеСвойствами.ПараметрыДобавленияСвойства(); + ПараметрыСвойства.Наименование = "Технология экрана"; + ПараметрыСвойства.Тип = Новый ОписаниеТипов("СправочникСсылка.ЗначенияСвойствОбъектов"); + ПараметрыСвойства.Имя = "ТехнологияЭкрана_" + СтрЗаменить(Новый УникальныйИдентификатор, "-", ""); + ПараметрыСвойства.ИдентификаторДляФормул = "ТехнологияЭкрана"; + + УправлениеСвойствами.ДобавитьСвойство(НаборСвойств, ПараметрыСвойства); + + ОбщегоНазначения.СообщитьПользователю("Для вида номенклатуры ""Смартфоны"" добавлено новое свойство " + ПараметрыСвойства.Наименование); + +Иначе + ОбщегоНазначения.СообщитьПользователю("Вид номенклатуры ""Смартфоны"" не найден"); +КонецЕсли; +``` \ No newline at end of file diff --git a/src/content/docs/knowledge-base/Общие/(БСП) Стандартные подсистемы/Свойства/Программный интерфейс/Дополнительные реквизиты используются.md b/src/content/docs/knowledge-base/Общие/(БСП) Стандартные подсистемы/Свойства/Программный интерфейс/Дополнительные реквизиты используются.md new file mode 100644 index 0000000..1b7c197 --- /dev/null +++ b/src/content/docs/knowledge-base/Общие/(БСП) Стандартные подсистемы/Свойства/Программный интерфейс/Дополнительные реквизиты используются.md @@ -0,0 +1,21 @@ +--- +title: Дополнительные реквизиты используются +slug: общие-бсп-стандартные-подсистемы-свойства-программный-интерфейс/дополнительные-реквизиты-используются +--- + +# Описание + +```bsl +// Проверяет, используются ли дополнительные реквизиты с объектом. +// Синтаксис +// +// Функция ИспользоватьДопРеквизиты(ВладелецСвойств) Экспорт +// +// Параметры +// +// ВладелецСвойств - ЛюбаяСсылка - например, СправочникСсылка.Номенклатура, ДокументСсылка.ЗаказПокупателя, ... +// Возвращаемое значение +// +// Булево - если Истина, тогда дополнительные реквизиты используются. +ИспользуютсяДопРеквизиты = УправлениеСвойствами.ИспользоватьДопРеквизиты(ВладелецСвойств); +``` diff --git a/src/content/docs/knowledge-base/Общие/(БСП) Стандартные подсистемы/Свойства/Программный интерфейс/Дополнительные сведения используются.md b/src/content/docs/knowledge-base/Общие/(БСП) Стандартные подсистемы/Свойства/Программный интерфейс/Дополнительные сведения используются.md new file mode 100644 index 0000000..5cc326a --- /dev/null +++ b/src/content/docs/knowledge-base/Общие/(БСП) Стандартные подсистемы/Свойства/Программный интерфейс/Дополнительные сведения используются.md @@ -0,0 +1,23 @@ +--- +title: Дополнительные сведения используются +slug: общие-бсп-стандартные-подсистемы-свойства-программный-интерфейс/дополнительные-сведения-используются +--- + +# Описание + +```bsl +// Проверяет, используются ли дополнительные сведения объектом. +// Синтаксис +// +// Функция ИспользоватьДопСведения(ВладелецСвойств) Экспорт +// Параметры +// +// ВладелецСвойств - ЛюбаяСсылка - например, СправочникСсылка.Номенклатура, ДокументСсылка.ЗаказПокупателя, ... +// Возвращаемое значение +// +// Булево - если Истина, тогда дополнительные сведения используются. +// Пример вызова +// +// Результат = УправлениеСвойствами.ИспользоватьДопСведения(ВладелецСвойств) +ИспользуютсяДопСведения = УправлениеСвойствами.ИспользоватьДопСведения(ВладелецСвойств); +``` \ No newline at end of file diff --git a/src/content/docs/knowledge-base/Общие/(БСП) Стандартные подсистемы/Свойства/Программный интерфейс/Есть владельцы меток.md b/src/content/docs/knowledge-base/Общие/(БСП) Стандартные подсистемы/Свойства/Программный интерфейс/Есть владельцы меток.md new file mode 100644 index 0000000..03abb6c --- /dev/null +++ b/src/content/docs/knowledge-base/Общие/(БСП) Стандартные подсистемы/Свойства/Программный интерфейс/Есть владельцы меток.md @@ -0,0 +1,18 @@ +--- +title: Есть владельцы меток +slug: общие-бсп-стандартные-подсистемы-свойства-программный-интерфейс/есть-владельцы-меток +--- + +# Описание + +```bsl +// Возвращает признак наличия владельцев меток. +// Синтаксис +// +// Функция ЕстьВладельцыМеток() Экспорт +// Возвращаемое значение +// +// Булево - признак наличия владельцев меток. + +ИспользуютсяМетки = УправлениеСвойствами.ЕстьВладельцыМеток(); +``` \ No newline at end of file diff --git a/src/content/docs/knowledge-base/Общие/(БСП) Стандартные подсистемы/Свойства/Программный интерфейс/Записать свойства у объекта.md b/src/content/docs/knowledge-base/Общие/(БСП) Стандартные подсистемы/Свойства/Программный интерфейс/Записать свойства у объекта.md new file mode 100644 index 0000000..5479743 --- /dev/null +++ b/src/content/docs/knowledge-base/Общие/(БСП) Стандартные подсистемы/Свойства/Программный интерфейс/Записать свойства у объекта.md @@ -0,0 +1,51 @@ +--- +title: Записать свойства у объекта +slug: общие-бсп-стандартные-подсистемы-свойства-программный-интерфейс/записать-свойства-у-объекта +--- +# Описание + +```bsl +// Записывает дополнительные реквизиты и сведения владельцу свойств. +// Изменения происходят в транзакции. +// Синтаксис +// +// Процедура ЗаписатьСвойстваУОбъекта(ВладелецСвойств, ТаблицаСвойствИЗначений) Экспорт +// +// Параметры +// +// ВладелецСвойств - ЛюбаяСсылка - например, СправочникСсылка.Номенклатура, ДокументСсылка.ЗаказПокупателя и т.д. +// ТаблицаСвойствИЗначений - ТаблицаЗначений: +// * Свойство - ПланВидовХарактеристикСсылка.ДополнительныеРеквизитыИСведения - свойство владельца. +// * Значение - Произвольный - любое значение, допустимое для свойства (указано в элементе свойства). +УправлениеСвойствами.ЗаписатьСвойстваУОбъекта(ВладелецСвойств, ТаблицаСвойств); +``` + +# Пример применения +```bsl +Номенклатура = Справочники.Номенклатура.НайтиПоКоду("000000001"); +Если НЕ Номенклатура.Пустая() Тогда + + ТаблицаСвойств = Новый ТаблицаЗначений(); + ТаблицаСвойств.Колонки.Добавить("Свойство"); + ТаблицаСвойств.Колонки.Добавить("Значение"); + + ИмяСвойстваБеспроводной = "БеспроводнойИнтерфейс_1f84313ad678448db40fa1c403f26aba"; + + СтрокаТаблицы = ТаблицаСвойств.Добавить(); + СтрокаТаблицы.Свойство = ПланыВидовХарактеристик.ДополнительныеРеквизитыИСведения.НайтиПоРеквизиту("Имя", ИмяСвойстваБеспроводной); + СтрокаТаблицы.Значение = Истина; + + ИмяСвойстваШумоподавление = "АктивноеШумоподавление_d6d55617cc4746ff801c790c2ff8ca07"; + + СтрокаТаблицы = ТаблицаСвойств.Добавить(); + СтрокаТаблицы.Свойство = ПланыВидовХарактеристик.ДополнительныеРеквизитыИСведения.НайтиПоРеквизиту("Имя", ИмяСвойстваШумоподавление); + СтрокаТаблицы.Значение = Истина; + + УправлениеСвойствами.ЗаписатьСвойстваУОбъекта(Номенклатура, ТаблицаСвойств); + + ОбщегоНазначения.СообщитьПользователю("Свойства номенклатуры успешно записаны"); + +Иначе + ОбщегоНазначения.СообщитьПользователю("Номенклатура не найдена"); +КонецЕсли; +``` \ No newline at end of file diff --git a/src/content/docs/knowledge-base/Общие/(БСП) Стандартные подсистемы/Свойства/Программный интерфейс/Значение свойства.md b/src/content/docs/knowledge-base/Общие/(БСП) Стандартные подсистемы/Свойства/Программный интерфейс/Значение свойства.md new file mode 100644 index 0000000..2c0afba --- /dev/null +++ b/src/content/docs/knowledge-base/Общие/(БСП) Стандартные подсистемы/Свойства/Программный интерфейс/Значение свойства.md @@ -0,0 +1,47 @@ +--- +title: Значение свойства +slug: общие-бсп-стандартные-подсистемы-свойства-программный-интерфейс/значение-свойства +--- + +# Описание + +```bsl +// Возвращает значение дополнительного свойства объекта. +// Синтаксис +// +// Функция ЗначениеСвойства(Объект, Свойство, КодЯзыка = "") Экспорт +// +// Параметры: +// +// Объект - ЛюбаяСсылка - ссылка на объект, например, СправочникСсылка.Номенклатура, +// ДокументСсылка.ЗаказПокупателя, ... +// Свойство - ПланВидовХарактеристикСсылка.ДополнительныеРеквизитыИСведения - ссылка на +// дополнительный реквизит, значение которого нужно получить. +// - Строка - имя дополнительного свойства. +// КодЯзыка - Строка - если указано, то вместо значения дополнительного свойства будет +// возвращено его представление на указанном языке. +//Возвращаемое значение +// +// Произвольный - любое значение, допустимое для свойства. +Значение = УправлениеСвойствами.ЗначениеСвойства(Объект, ИмяСвойства); +``` + +# Пример применения +```bsl +Номенклатура = Справочники.Номенклатура.НайтиПоКоду("000000001"); +Если НЕ Номенклатура.Пустая() Тогда + + // вариант 1 - по имени свойства + ИмяСвойства = "ОперационнаяСистема_ce01ea8bc2c34f4bad6f81092280c579"; + Значение = УправлениеСвойствами.ЗначениеСвойства(Номенклатура, ИмяСвойства); + + // вариант 2 - по ссылке на свойство + Свойство = ПланыВидовХарактеристик.ДополнительныеРеквизитыИСведения.НайтиПоРеквизиту("Имя", ИмяСвойства); + Значение = УправлениеСвойствами.ЗначениеСвойства(Номенклатура, Свойство); + + ОбщегоНазначения.СообщитьПользователю(Значение); + +Иначе + ОбщегоНазначения.СообщитьПользователю("Номенклатура не найдена"); +КонецЕсли; +``` \ No newline at end of file diff --git a/src/content/docs/knowledge-base/Общие/(БСП) Стандартные подсистемы/Свойства/Программный интерфейс/Значения свойств.md b/src/content/docs/knowledge-base/Общие/(БСП) Стандартные подсистемы/Свойства/Программный интерфейс/Значения свойств.md new file mode 100644 index 0000000..0cae7f9 --- /dev/null +++ b/src/content/docs/knowledge-base/Общие/(БСП) Стандартные подсистемы/Свойства/Программный интерфейс/Значения свойств.md @@ -0,0 +1,74 @@ +--- +title: Значения свойств +slug: общие-бсп-стандартные-подсистемы-свойства-программный-интерфейс/значения-свойств +--- + +# Описание + +```bsl +// Возвращает значения дополнительных свойств объектов. +// Синтаксис +// +// Функция ЗначенияСвойств(ОбъектыСоСвойствами, +// ПолучатьДопРеквизиты = Истина, +// ПолучатьДопСведения = Истина, +// Свойства = Неопределено, +// КодЯзыка = "") Экспорт +// Параметры +// +// ОбъектыСоСвойствами - Массив - объекты, для которых нужно получить значения дополнительных свойств. +// - ЛюбаяСсылка - ссылка на объект, например, СправочникСсылка.Номенклатура, +// ДокументСсылка.ЗаказПокупателя, ... +// ПолучатьДопРеквизиты - Булево - в результат включать дополнительные реквизиты. По умолчанию Истина. +// ПолучатьДопСведения - Булево - в результат включать дополнительные сведения. По умолчанию Истина. +// Свойства - Массив из ПланВидовХарактеристикСсылка.ДополнительныеРеквизитыИСведения - значения +// которых следует получить. +// - Массив из Строка - уникальное имя дополнительного свойства. +// - Неопределено - по умолчанию, получить значения всех свойств владельца. +// КодЯзыка - Строка - код языка, на котором будет получено представление значения свойства. +// Если не указано - берется текущий язык. +// Возвращаемое значение +// +// ТаблицаЗначений: +// * Свойство - ПланВидовХарактеристикСсылка.ДополнительныеРеквизитыИСведения - свойство владельца. +// * ИмяСвойства - Строка - уникальное имя свойства владельца. +// * Значение - Произвольный - значения любого типа из описания типов свойства объекта метаданных: +// "Метаданные.ПланВидовХарактеристик.ДополнительныеРеквизитыИСведения.Тип". +// * Представление - Строка - представление значения на указанном языке. +// * ВладелецСвойств - ЛюбаяСсылка - ссылка на объект. +ТаблицаСвойств = УправлениеСвойствами.ЗначенияСвойств(ОбъектыСоСвойствами); +``` + +# Пример применения +```bsl +// 1. Получение значений свойств одного объекта +Номенклатура = Справочники.Номенклатура.НайтиПоКоду("000000001"); +Если НЕ Номенклатура.Пустая() Тогда + + ТаблицаСвойств = УправлениеСвойствами.ЗначенияСвойств(Номенклатура); + ТаблицаСвойств.ВыбратьСтроку(); + +Иначе + ОбщегоНазначения.СообщитьПользователю("Номенклатура не найдена"); +КонецЕсли; + +// 2. Получение значений свойств нескольких объектов +Группа = Справочники.Номенклатура.НайтиПоКоду("000000001"); + +Если НЕ Группа.Пустая() Тогда + + МассивТоваров = Новый Массив; + Выборка = Справочники.Номенклатура.Выбрать(Группа); + Пока Выборка.Следующий() Цикл + Если НЕ Выборка.ЭтоГруппа Тогда + МассивТоваров.Добавить(Выборка.Ссылка); + КонецЕсли; + КонецЦикла; + + ТаблицаСвойств = УправлениеСвойствами.ЗначенияСвойств(МассивТоваров); + ТаблицаСвойств.ВыбратьСтроку(); + +Иначе + ОбщегоНазначения.СообщитьПользователю("Номенклатура не найдена"); +КонецЕсли; +``` \ No newline at end of file diff --git a/src/content/docs/knowledge-base/Общие/(БСП) Стандартные подсистемы/Свойства/Программный интерфейс/Проверить свойство у объекта.md b/src/content/docs/knowledge-base/Общие/(БСП) Стандартные подсистемы/Свойства/Программный интерфейс/Проверить свойство у объекта.md new file mode 100644 index 0000000..2300999 --- /dev/null +++ b/src/content/docs/knowledge-base/Общие/(БСП) Стандартные подсистемы/Свойства/Программный интерфейс/Проверить свойство у объекта.md @@ -0,0 +1,39 @@ +--- +title: Проверить свойство у объекта +slug: общие-бсп-стандартные-подсистемы-свойства-программный-интерфейс/проверить-свойство-у-объекта +--- +# Описание + +```bsl +// Проверяет, есть ли у объекта свойство. +// Синтаксис +// +// Функция ПроверитьСвойствоУОбъекта(ВладелецСвойств, Свойство) Экспорт +// +// Параметры +// +// ВладелецСвойств - ЛюбаяСсылка - например: СправочникСсылка.Номенклатура, ДокументСсылка.ЗаказПокупателя, ... +// Свойство - ПланВидовХарактеристикСсылка.ДополнительныеРеквизитыИСведения - проверяемое свойство. +// Возвращаемое значение +// +// Булево - если Истина, свойство у владельца есть. +ЕстьСвойство = УправлениеСвойствами.ПроверитьСвойствоУОбъекта(Номенклатура, Свойство); +``` + +# Пример применения +```bsl +Номенклатура = Справочники.Номенклатура.НайтиПоКоду("000000001"); +Если НЕ Номенклатура.Пустая() Тогда + + ИмяСвойстваБеспроводной = "БеспроводнойИнтерфейс_1f84313ad678448db40fa1c403f26aba"; + Свойство = ПланыВидовХарактеристик.ДополнительныеРеквизитыИСведения.НайтиПоРеквизиту("Имя", ИмяСвойстваБеспроводной); + + ЕстьСвойство = УправлениеСвойствами.ПроверитьСвойствоУОбъекта(Номенклатура, Свойство); + + ТекстСообщения = СтрШаблон("У объекта %1", ?(ЕстьСвойство, "есть свойство", "нет свойства")); + ОбщегоНазначения.СообщитьПользователю(ТекстСообщения); + +Иначе + ОбщегоНазначения.СообщитьПользователю("Номенклатура не найдена"); +КонецЕсли; +``` \ No newline at end of file diff --git a/src/content/docs/knowledge-base/Общие/(БСП) Стандартные подсистемы/Свойства/Программный интерфейс/Свойства доступны.md b/src/content/docs/knowledge-base/Общие/(БСП) Стандартные подсистемы/Свойства/Программный интерфейс/Свойства доступны.md new file mode 100644 index 0000000..da72b53 --- /dev/null +++ b/src/content/docs/knowledge-base/Общие/(БСП) Стандартные подсистемы/Свойства/Программный интерфейс/Свойства доступны.md @@ -0,0 +1,17 @@ +--- +title: Свойства доступны +slug: общие-бсп-стандартные-подсистемы-свойства-программный-интерфейс/свойства-доступны +--- + +```bsl +// Проверяет доступность подсистемы для текущего пользователя. +// Синтаксис +// +// Функция СвойстваДоступны() Экспорт +// Возвращаемое значение +// +// Булево - Истина, если подсистема доступна. + +Результат = УправлениеСвойствами.СвойстваДоступны(); + +``` \ No newline at end of file diff --git a/src/content/docs/knowledge-base/Общие/(БСП) Стандартные подсистемы/Свойства/Программный интерфейс/Свойства объекта.md b/src/content/docs/knowledge-base/Общие/(БСП) Стандартные подсистемы/Свойства/Программный интерфейс/Свойства объекта.md new file mode 100644 index 0000000..c482872 --- /dev/null +++ b/src/content/docs/knowledge-base/Общие/(БСП) Стандартные подсистемы/Свойства/Программный интерфейс/Свойства объекта.md @@ -0,0 +1,42 @@ +--- +title: Свойства объекта +slug: общие-бсп-стандартные-подсистемы-свойства-программный-интерфейс/свойства-объекта +--- +# Описание + +```bsl +// Возвращает свойства у указанного объекта. +// Синтаксис +// +// Функция СвойстваОбъекта(ВладелецСвойств, +// ПолучатьДопРеквизиты = Истина, +// ПолучатьДопСведения = Истина) Экспорт +// Параметры +// +// ВладелецСвойств - ЛюбаяСсылка - например: СправочникСсылка.Номенклатура, ДокументСсылка.ЗаказПокупателя, ... +// - СправочникОбъект, ДокументОбъект - любой объект со свойствами. +// - ДанныеФормыСтруктура - коллекция по типу объекта владельца свойств. +// ПолучатьДопРеквизиты - Булево - в результат включать дополнительные реквизиты. +// ПолучатьДопСведения - Булево - в результат включать дополнительные сведения. +// +// Возвращаемое значение +// +// Массив из ПланВидовХарактеристикСсылка.ДополнительныеРеквизитыИСведения +МассивСвойств = УправлениеСвойствами.СвойстваОбъекта(Номенклатура); +``` + +# Пример применения +```bsl +Номенклатура = Справочники.Номенклатура.НайтиПоКоду("000000001"); +Если НЕ Номенклатура.Пустая() Тогда + + МассивСвойств = УправлениеСвойствами.СвойстваОбъекта(Номенклатура); + + Для Каждого Свойство Из МассивСвойств Цикл + ОбщегоНазначения.СообщитьПользователю(Свойство); + КонецЦикла; + +Иначе + ОбщегоНазначения.СообщитьПользователю("Номенклатура не найдена"); +КонецЕсли; +``` \ No newline at end of file diff --git a/src/content/docs/knowledge-base/Общие/Общего назначения/Общий модуль по имени.md b/src/content/docs/knowledge-base/Общие/Общего назначения/Общий модуль по имени.md new file mode 100644 index 0000000..47f2944 --- /dev/null +++ b/src/content/docs/knowledge-base/Общие/Общего назначения/Общий модуль по имени.md @@ -0,0 +1,11 @@ +--- +title: Общий модуль по имени +slug: общие-общего-назначения/общий-модуль-по-имени +--- +# Пример применения +```bsl +Если ОбщегоНазначения.ПодсистемаСуществует("СтандартныеПодсистемы.ВариантыОтчетов") Тогда + МодульВариантыОтчетов = ОбщегоНазначения.ОбщийМодуль("ВариантыОтчетов"); + //МодульВариантыОтчетов.<Имя процедуры>(); +КонецЕсли; +``` \ No newline at end of file diff --git a/src/content/docs/knowledge-base/Общие/Общего назначения/Описание подсистем.md b/src/content/docs/knowledge-base/Общие/Общего назначения/Описание подсистем.md new file mode 100644 index 0000000..64f634d --- /dev/null +++ b/src/content/docs/knowledge-base/Общие/Общего назначения/Описание подсистем.md @@ -0,0 +1,18 @@ +--- +title: Описание подсистем +slug: общие-общего-назначения/описание-подсистем +--- +# Пример применения +```bsl +ВерсииПодсистем = ОбщегоНазначения.ОписанияПодсистем(); +Для Каждого ОписаниеПодсистемы Из ВерсииПодсистем Цикл + ТекстСообщения = ""; + Для каждого ОписаниеСвойства Из ОписаниеПодсистемы Цикл + ТекстСообщения = ТекстСообщения + + СтрШаблон("%1: %2", ОписаниеСвойства.Ключ, ОписаниеСвойства.Значение) + + "; "; + КонецЦикла; + ОбщегоНазначения.СообщитьПользователю(ТекстСообщения); +КонецЦикла; + +``` \ No newline at end of file diff --git a/src/content/docs/knowledge-base/Общие/Общего назначения/Подсистема существует.md b/src/content/docs/knowledge-base/Общие/Общего назначения/Подсистема существует.md new file mode 100644 index 0000000..42b7f39 --- /dev/null +++ b/src/content/docs/knowledge-base/Общие/Общего назначения/Подсистема существует.md @@ -0,0 +1,14 @@ +--- +title: Подсистема существует +slug: общие-общего-назначения/подсистема-существует +--- +# Пример применения +```bsl +Если ОбщегоНазначения.ПодсистемаСуществует("СтандартныеПодсистемы.ВариантыОтчетов") Тогда + ТекстСообщения = "Подсистема ""Вараинты отчетов"" внедрена в конфигурацию"; +Иначе + ТекстСообщения = "Подсистема ""Вараинты отчетов"" не внедрена в конфигурацию"; +КонецЕсли; + +ОбщегоНазначения.СообщитьПользователю(ТекстСообщения); +``` \ No newline at end of file diff --git a/src/content/docs/knowledge-base/Общие/Общего назначения/Текст ошибки заполнения.md b/src/content/docs/knowledge-base/Общие/Общего назначения/Текст ошибки заполнения.md new file mode 100644 index 0000000..d7916e7 --- /dev/null +++ b/src/content/docs/knowledge-base/Общие/Общего назначения/Текст ошибки заполнения.md @@ -0,0 +1,16 @@ +--- +title: Текст ошибки заполнения +slug: общие-общего-назначения/текст-ошибки-заполнения +--- +# Пример применения +```bsl +ВидПоля = "Колонка"; // "Колонка"; "Список" +ВидСообщения = "Заполнение"; // "Корректность" +ИмяПоля = "Номенклатура"; + +НомерСтроки = 2; +ИмяСписка = "Товары"; + +ТекстОшибки = ОбщегоНазначенияКлиентСервер.ТекстОшибкиЗаполнения(ВидПоля, ВидСообщения, ИмяПоля, НомерСтроки, ИмяСписка); +ОбщегоНазначения.СообщитьПользователю(ТекстОшибки); +``` \ No newline at end of file diff --git a/src/content/docs/knowledge-base/Общие/Работа с текстом/Добавить лидирующие нули.md b/src/content/docs/knowledge-base/Общие/Работа с текстом/Добавить лидирующие нули.md new file mode 100644 index 0000000..3ad3cea --- /dev/null +++ b/src/content/docs/knowledge-base/Общие/Работа с текстом/Добавить лидирующие нули.md @@ -0,0 +1,12 @@ +--- +title: Добавить лидирующие нули +slug: общие-работа-с-текстом/добавить-лидирующие-нули +--- +# Пример применения +```bsl +// Пример: добавление в номер лидирующих нулей + +НомерНаПечать = "14"; +НомерДокумента = СтроковыеФункцииКлиентСервер.ДополнитьСтроку(Номер, 10); +ОбщегоНазначенияКлиент.СообщитьПользователю(НомерДокумента); +``` \ No newline at end of file diff --git a/src/content/docs/knowledge-base/Общие/Работа с текстом/Строка в дату.md b/src/content/docs/knowledge-base/Общие/Работа с текстом/Строка в дату.md new file mode 100644 index 0000000..c8ce24b --- /dev/null +++ b/src/content/docs/knowledge-base/Общие/Работа с текстом/Строка в дату.md @@ -0,0 +1,12 @@ +--- +title: Строка в дату +slug: общие-работа-с-текстом/строка-в-дату +--- +# Пример применения +```bsl +ДатаСтрокой = "04.09.2023 17:38:14"; + +// Формат даты должен быть в виде "ДД.ММ.ГГГГ" или "ДД/ММ/ГГ" или "ДД-ММ-ГГ ЧЧ:ММ:CC", +Результат = СтроковыеФункцииКлиентСервер.СтрокаВДату(ДатаСтрокой, ЧастиДаты.ДатаВремя); +ОбщегоНазначенияКлиент.СообщитьПользователю(Результат); +``` \ No newline at end of file diff --git a/src/content/docs/knowledge-base/Общие/Работа с текстом/Строка в число.md b/src/content/docs/knowledge-base/Общие/Работа с текстом/Строка в число.md new file mode 100644 index 0000000..a796ff3 --- /dev/null +++ b/src/content/docs/knowledge-base/Общие/Работа с текстом/Строка в число.md @@ -0,0 +1,10 @@ +--- +title: Строка в число +slug: общие-работа-с-текстом/строка-в-число +--- +# Пример применения +```bsl +Сумма = "1 500,94"; +Результат = СтроковыеФункцииКлиентСервер.СтрокаВЧисло(Сумма); +ОбщегоНазначенияКлиент.СообщитьПользователю(Результат); +``` \ No newline at end of file diff --git a/src/content/docs/knowledge-base/Общие/Работа с текстом/Строка латиницей.md b/src/content/docs/knowledge-base/Общие/Работа с текстом/Строка латиницей.md new file mode 100644 index 0000000..197e4d4 --- /dev/null +++ b/src/content/docs/knowledge-base/Общие/Работа с текстом/Строка латиницей.md @@ -0,0 +1,15 @@ +--- +title: Строка латиницей +slug: общие-работа-с-текстом/строка-латиницей +--- +# Пример применения +```bsl +ФИО = "Макаров Виктор Семенович"; + +// на клиенте +Транслит = СтроковыеФункцииКлиент.СтрокаЛатиницей(ФИО); +ОбщегоНазначенияКлиент.СообщитьПользователю(Транслит); + +// на сервере +// Транслит = СтроковыеФункции.СтрокаЛатиницей(ФИО); +``` \ No newline at end of file diff --git a/src/content/docs/knowledge-base/Общие/Работа с текстом/Удалить повторяющиеся нули.md b/src/content/docs/knowledge-base/Общие/Работа с текстом/Удалить повторяющиеся нули.md new file mode 100644 index 0000000..9df439b --- /dev/null +++ b/src/content/docs/knowledge-base/Общие/Работа с текстом/Удалить повторяющиеся нули.md @@ -0,0 +1,12 @@ +--- +title: Удалить повторяющиеся нули +slug: общие-работа-с-текстом/удалить-повторяющиеся-нули +--- +# Пример применения +```bsl +// Пример: удаление из номера лидирующих нулей + +НомерДокумента = "00000000014"; +НомерНапечать = СтроковыеФункцииКлиентСервер.УдалитьПовторяющиесяСимволы(НомерДокумента, "0"); +ОбщегоНазначенияКлиент.СообщитьПользователю(НомерНапечать); +``` \ No newline at end of file diff --git a/src/content/docs/knowledge-base/Общие/Работа с файловой системой/Диалог выбора каталога.md b/src/content/docs/knowledge-base/Общие/Работа с файловой системой/Диалог выбора каталога.md new file mode 100644 index 0000000..a4fd639 --- /dev/null +++ b/src/content/docs/knowledge-base/Общие/Работа с файловой системой/Диалог выбора каталога.md @@ -0,0 +1,21 @@ +--- +title: Диалог выбора каталога +slug: общие-работа-с-файловой-системой/диалог-выбора-каталога +--- +# Описание + +```bsl +// Показывает диалог выбора каталога. +// +// Параметры: +// ОбработчикЗавершения - ОписаниеОповещения - содержит описание процедуры, которая будет вызвана после +// закрытия диалога выбора со следующими параметрами: +// # ПутьККаталогу - Строка - полный путь к каталогу. Если не установлено расширение для работы с 1С:Предприятием +// или пользователь отказался от выбора, возвращает пустую строку. +// # ДополнительныеПараметры - Произвольный - значение, которое было указано при создании объекта ОписаниеОповещения. +// Заголовок - Строка - заголовок диалога выбора каталога. +// Каталог - Строка - начальное значение каталога, предлагаемое по умолчанию. +// +Процедура ВыбратьКаталог(ОбработчикЗавершения, Заголовок = "", Каталог = "") Экспорт + +``` \ No newline at end of file diff --git a/src/content/docs/knowledge-base/Общие/Работа с файловой системой/Диалог выбора файла.md b/src/content/docs/knowledge-base/Общие/Работа с файловой системой/Диалог выбора файла.md new file mode 100644 index 0000000..f11495a --- /dev/null +++ b/src/content/docs/knowledge-base/Общие/Работа с файловой системой/Диалог выбора файла.md @@ -0,0 +1,23 @@ +--- +title: Диалог выбора файла +slug: общие-работа-с-файловой-системой/диалог-выбора-файла +--- +# Описание + +```bsl +// Показывает диалог выбора файла. +// В веб-клиенте пользователю будет показан диалог установки расширения для работы с 1С:Предприятием, +// если требуется. +// +// Параметры: +// ОбработчикЗавершения - ОписаниеОповещения - содержит описание процедуры, которая будет вызвана после +// закрытия диалога выбора с параметрами: +// # Результат - Массив из Строка - выбранные имена файлов. +// - Строка - пустая строка, если пользователь отказался от установки расширения. +// - Неопределено - если пользователь отказался от выбора файла. +// # ДополнительныеПараметры - Произвольный - дополнительные параметры оповещения. +// Диалог - ДиалогВыбораФайла - свойства см. в синтакс-помощнике. +// +Процедура ПоказатьДиалогВыбора(ОбработчикЗавершения, Диалог) Экспорт + +``` \ No newline at end of file diff --git a/src/content/docs/knowledge-base/Общие/Работа с файловой системой/Загрузить файл во временное хранилище.md b/src/content/docs/knowledge-base/Общие/Работа с файловой системой/Загрузить файл во временное хранилище.md new file mode 100644 index 0000000..da5fbb9 --- /dev/null +++ b/src/content/docs/knowledge-base/Общие/Работа с файловой системой/Загрузить файл во временное хранилище.md @@ -0,0 +1,41 @@ +--- +title: Загрузить файл во временное хранилище +slug: общие-работа-с-файловой-системой/загрузить-файл-во-временное-хранилище +--- +# Описание + +```bsl + +// Показывает диалог выбора файла и помещает выбранный файл во временное хранилище. +// Совмещает работу методов глобального контекста НачатьПомещениеФайла и НачатьПомещениеФайлов, +// возвращая идентичный результат вне зависимости от того, подключено или нет расширение для работы с 1С:Предприятием. +// Ограничения: +// Не используется для выбора каталогов - эта опция не поддерживается веб-клиентом. +// +// Параметры: +// ОбработчикЗавершения - ОписаниеОповещения - содержит описание процедуры, которая будет вызвана после +// загрузки файла со следующими параметрами: +// # ПомещенныйФайл - Структура - пользователь выбрал файл: +// ## Хранение - Строка - адрес временного хранилища с двоичными данными файла. +// ## Имя - Строка - в тонком клиенте и в веб-клиенте с установленным +// расширением работы с 1С:Предприятием - локальный путь, по которому +// был получен файл. В веб-клиенте без расширения для работы с 1С:Предприятием +// передается имя файла с расширением. +// - Неопределено - пользователь отказался от выбора или файл занят другой программой. +// # ДополнительныеПараметры - Произвольный - значение, которое было указано при создании объекта +// ОписаниеОповещения. +// ПараметрыЗагрузки - см. ФайловаяСистемаКлиент.ПараметрыЗагрузкиФайла. +// ИмяФайла - Строка - полный путь к файлу, который будет предложен пользователю в начале +// интерактивного выбора или помещен во временное хранилище в неинтерактивном. +// Если выбран неинтерактивный режим и параметр не заполнен, будет вызвано исключение. +// АдресВоВременномХранилище - Строка - адрес, по которому будет сохранен файл. +// +// Пример: +// Оповещение = Новый ОписаниеОповещения("ВыбратьФайлПослеПомещенияФайла", ЭтотОбъект, Контекст); +// ПараметрыЗагрузки = ФайловаяСистемаКлиент.ПараметрыЗагрузкиФайла(); +// ПараметрыЗагрузки.ИдентификаторФормы = УникальныйИдентификатор; +// ФайловаяСистемаКлиент.ЗагрузитьФайл(Оповещение, ПараметрыЗагрузки); +// +Процедура ЗагрузитьФайл(ОбработчикЗавершения, ПараметрыЗагрузки = Неопределено, ИмяФайла = "", + АдресВоВременномХранилище = "") Экспорт +``` \ No newline at end of file diff --git a/src/content/docs/knowledge-base/Общие/Работа с файловой системой/Загрузить файлы во временное хранилище.md b/src/content/docs/knowledge-base/Общие/Работа с файловой системой/Загрузить файлы во временное хранилище.md new file mode 100644 index 0000000..61a9b24 --- /dev/null +++ b/src/content/docs/knowledge-base/Общие/Работа с файловой системой/Загрузить файлы во временное хранилище.md @@ -0,0 +1,48 @@ +--- +title: Загрузить файлы во временное хранилище +slug: общие-работа-с-файловой-системой/загрузить-файлы-во-временное-хранилище +--- +# Описание + +```bsl +// Показывает диалог выбора файлов и помещает выбранные файлы во временное хранилище. +// Совмещает работу методов глобального контекста НачатьПомещениеФайла и НачатьПомещениеФайлов, +// возвращая идентичный результат вне зависимости от того, подключено или нет расширение для работы с 1С:Предприятием. +// Ограничения: +// Не используется для выбора каталогов - эта опция не поддерживается веб-клиентом. +// Не поддерживается множественный выбор в веб-клиенте, если не установлено расширение для работы с 1С:Предприятием. +// +// Параметры: +// ОбработчикЗавершения - ОписаниеОповещения - содержит описание процедуры, которая будет вызвана после +// загрузки файлов со следующими параметрами: +// # ПомещенныеФайлы - Неопределено - пользователь отказался от выбора или файл занят другой программой. +// - Массив из Структура - пользователь выбрал файл: +// ## Хранение - Строка - адрес временного хранилища с двоичными данными файла. +// ## Имя - Строка - в тонком клиенте и в веб-клиенте с установленным +// расширением работы с 1С:Предприятием - локальный путь, по которому +// был получен файл. В веб-клиенте без расширения для работы с 1С:Предприятием +// передается имя файла с расширением. +// ## ПолноеИмя - Строка - в тонком клиенте и в веб-клиенте с установленным +// расширением работы с 1С:Предприятием - локальный путь, по которому +// был получен файл. В веб-клиенте без расширения для работы с 1С:Предприятием +// принимает значение "". +// ## ИмяФайла - Строка - имя файла с расширением. +// # ДополнительныеПараметры - Произвольный - значение, которое было указано при создании объекта ОписаниеОповещения. +// ПараметрыЗагрузки - см. ФайловаяСистемаКлиент.ПараметрыЗагрузкиФайла. +// ЗагружаемыеФайлы - Массив - содержит объекты типа ОписаниеПередаваемогоФайла. Может быть заполнен полностью, +// в этом случае загружаемые файлы будут сохранены по указанным адресам. Может быть заполнен +// частично - у элементов массива заполнены только имена. В этом случае, загружаемые файлы будут +// размещены в новых временных хранилищах. Массив может быть не заполнен. В этом случае набор +// помещаемых файлов определяется по значениям, указанным в параметре ПараметрыЗагрузки. Если в +// параметрах загрузки выбран неинтерактивный режим и параметр ЗагружаемыеФайлы не заполнен, +// будет вызвано исключение. +// +// Пример: +// Оповещение = Новый ОписаниеОповещения("ЗагрузитьРасширениеПослеПомещенияФайлов", ЭтотОбъект, Контекст); +// ПараметрыЗагрузки = ФайловаяСистемаКлиент.ПараметрыЗагрузкиФайла(); +// ПараметрыЗагрузки.ИдентификаторФормы = УникальныйИдентификатор; +// ФайловаяСистемаКлиент.ЗагрузитьФайлы(Оповещение, ПараметрыЗагрузки); +// +Процедура ЗагрузитьФайлы(ОбработчикЗавершения, ПараметрыЗагрузки = Неопределено, ЗагружаемыеФайлы = Неопределено) Экспорт + +``` \ No newline at end of file diff --git a/src/content/docs/knowledge-base/Общие/Работа с файловой системой/Запустить программу.md b/src/content/docs/knowledge-base/Общие/Работа с файловой системой/Запустить программу.md new file mode 100644 index 0000000..3deb960 --- /dev/null +++ b/src/content/docs/knowledge-base/Общие/Работа с файловой системой/Запустить программу.md @@ -0,0 +1,13 @@ +--- +title: Запустить программу +slug: общие-работа-с-файловой-системой/запустить-программу +--- +# Пример применения +```bsl +ПутьКФайлу = "C:\Program Files\1cv8\common\1cestart.exe"; + +ПараметрыЗапускаПрограммы = ФайловаяСистемаКлиент.ПараметрыЗапускаПрограммы(); +ПараметрыЗапускаПрограммы.ДождатьсяЗавершения = Истина; +ФайловаяСистемаКлиент.ЗапуститьПрограмму(ПутьКФайлу); + +``` \ No newline at end of file diff --git a/src/content/docs/knowledge-base/Общие/Работа с файловой системой/Сохранить файл из временного хранилища.md b/src/content/docs/knowledge-base/Общие/Работа с файловой системой/Сохранить файл из временного хранилища.md new file mode 100644 index 0000000..fcb221d --- /dev/null +++ b/src/content/docs/knowledge-base/Общие/Работа с файловой системой/Сохранить файл из временного хранилища.md @@ -0,0 +1,30 @@ +--- +title: Сохранить файл из временного хранилища +slug: общие-работа-с-файловой-системой/сохранить-файл-из-временного-хранилища +--- +# Описание + +```bsl +// Получает файл и сохраняет его в локальную файловую систему пользователя. +// +// Параметры: +// ОбработчикЗавершения - Неопределено +// - ОписаниеОповещения - содержит описание процедуры, которая будет вызвана после +// завершения со следующими параметрами: +// # ПолученныеФайлы - Массив из ОписаниеПереданногоФайла - сохраненные файлы. +// - Неопределено - файлы не были получены. +// # ДополнительныеПараметры - Произвольный - значение, которое было указано при создании объекта ОписаниеОповещения. +// РасположениеФайла - Строка - адрес временного хранилища или навигационная ссылка на +// реквизит типа ХранилищеЗначения, содержащий двоичные данные файла. +// ИмяФайла - Строка - полный путь, по которому должен быть сохранен получаемый файл или имя файла +// с расширением. +// ПараметрыСохранения - см. ФайловаяСистемаКлиент.ПараметрыСохраненияФайла +// +// Пример: +// Оповещение = Новый ОписаниеОповещения("СохранитьСертификатПослеПолученияФайлов", ЭтотОбъект, Контекст); +// ПараметрыСохранения = ФайловаяСистемаКлиент.ПараметрыСохраненияФайла(); +// ФайловаяСистемаКлиент.СохранитьФайл(Оповещение, Контекст.АдресСертификата, ИмяФайла, ПараметрыСохранения); +// +Процедура СохранитьФайл(ОбработчикЗавершения, РасположениеФайла, ИмяФайла = "", + ПараметрыСохранения = Неопределено) Экспорт +``` \ No newline at end of file diff --git a/src/content/docs/knowledge-base/Общие/Работа с файловой системой/Сохранить файлы из временного хранилища.md b/src/content/docs/knowledge-base/Общие/Работа с файловой системой/Сохранить файлы из временного хранилища.md new file mode 100644 index 0000000..60ca16c --- /dev/null +++ b/src/content/docs/knowledge-base/Общие/Работа с файловой системой/Сохранить файлы из временного хранилища.md @@ -0,0 +1,32 @@ +--- +title: Сохранить файлы из временного хранилища +slug: общие-работа-с-файловой-системой/сохранить-файлы-из-временного-хранилища +--- +# Описание + +```bsl +// Получает файлы и сохраняет их в локальную файловую систему пользователя. +// Для сохранения файлов в неинтерактивном режиме свойство Имя параметра СохраняемыеФайлы должно содержать +// полный путь к сохраняемому файлу или, если свойство Имя содержит только имя файла с расширением, необходимо +// заполнить свойство Каталог элемента Диалог параметра ПараметрыСохранения. В иных случаях будет вызвано +// исключение. +// +// Параметры: +// ОбработчикЗавершения - Неопределено +// - ОписаниеОповещения - содержит описание процедуры, которая будет вызвана +// после завершения со следующими параметрами: +// * ПолученныеФайлы - Массив из ОписаниеПереданногоФайла - сохраненные файлы. +// - Неопределено - файлы не были получены. +// * ДополнительныеПараметры - Произвольный - значение, которое было указано при создании объекта +// ОписаниеОповещения. +// СохраняемыеФайлы - Массив из ОписаниеПередаваемогоФайла +// ПараметрыСохранения - см. ФайловаяСистемаКлиент.ПараметрыСохраненияФайла +// +// Пример: +// Оповещение = Новый ОписаниеОповещения("СохранитьПечатнуюФормуВФайлПослеПолученияФайлов", ЭтотОбъект); +// ПараметрыСохранения = ФайловаяСистемаКлиент.ПараметрыСохраненияФайлов(); +// ФайловаяСистемаКлиент.СохранитьФайлы(Оповещение, ПолучаемыеФайлы, ПараметрыСохранения); +// +Процедура СохранитьФайлы(ОбработчикЗавершения, СохраняемыеФайлы, ПараметрыСохранения = Неопределено) Экспорт + +``` \ No newline at end of file diff --git a/src/content/docs/knowledge-base/Общие/Работа с файловой системой/Уникальное имя файла.md b/src/content/docs/knowledge-base/Общие/Работа с файловой системой/Уникальное имя файла.md new file mode 100644 index 0000000..3136a49 --- /dev/null +++ b/src/content/docs/knowledge-base/Общие/Работа с файловой системой/Уникальное имя файла.md @@ -0,0 +1,19 @@ +--- +title: Уникальное имя файла +slug: общие-работа-с-файловой-системой/уникальное-имя-файла +--- +# Описание + +```bsl +// Формирует уникальное имя файла в указанной папке, при необходимости добавляя к имени файла порядковый номер, +// например: "файл (2).txt", "файл (3).txt" и т.п. +// +// Параметры: +// ИмяФайла - Строка - полное имя файла с папкой, например, "C:\Документы\файл.txt". +// +// Возвращаемое значение: +// Строка - например, "C:\Документы\файл (2).txt", если "файл.txt" уже существует в указанной папке. +// +Функция УникальноеИмяФайла(Знач ИмяФайла) Экспорт + +``` \ No newline at end of file