новые
This commit is contained in:
wakadakawaka
parent
4430a3a350
commit
19af675bd5
@ -0,0 +1,16 @@
|
||||
---
|
||||
title: Добавить контактную информацию
|
||||
slug: общие-бсп-стандартные-подсистемы-контактная-информация-программный-интерфейс/добавить-контактную-информацию
|
||||
---
|
||||
|
||||
# Пример применения
|
||||
```bsl
|
||||
// Добавляет контактную информацию к объекту по представлению или JSON.
|
||||
|
||||
Организация = Справочники.Организации.ОрганизацияПоУмолчанию();
|
||||
ВидEmail = Справочники.ВидыКонтактнойИнформации.EmailОрганизации;
|
||||
Email = "info@testmail.ru";
|
||||
|
||||
УправлениеКонтактнойИнформацией.ДобавитьКонтактнуюИнформацию(Организация, Email, ВидEmail);
|
||||
ОбщегоНазначения.СообщитьПользователю("Для организации заполнен email");
|
||||
```
|
||||
@ -0,0 +1,40 @@
|
||||
---
|
||||
title: Контактная информация объекта
|
||||
slug: общие-бсп-стандартные-подсистемы-контактная-информация-программный-интерфейс/контактная-информация-объекта
|
||||
---
|
||||
# Описание
|
||||
|
||||
```bsl
|
||||
// Возвращает таблицу, содержащую контактную информацию объекта.
|
||||
// Поведение, при котором возвращалось представление контактной информации, теперь считается устаревшим
|
||||
// и сохранено для обратной совместимости. Для получения представления контактной информации рекомендуется
|
||||
// использовать функцию ПредставлениеКонтактнойИнформацииОбъекта.
|
||||
//
|
||||
// Параметры:
|
||||
// СсылкаИлиОбъект - ОпределяемыйТип.ВладелецКонтактнойИнформации
|
||||
// - СправочникОбъект
|
||||
// - ДокументОбъект - ссылка или объект-владелец контактной информации (организация,
|
||||
// контрагент, партнер и т.д.).
|
||||
// ВидИлиТипКонтактнойИнформации - СправочникСсылка.ВидыКонтактнойИнформации - отбор по виду контактной информации.
|
||||
// - ПеречислениеСсылка.ТипыКонтактнойИнформации - отбор по типу контактной информации.
|
||||
// Дата - Дата - дата с которой действует запись контактной информации,
|
||||
// используется при хранении истории изменения контактной информации.
|
||||
// Если владелец хранит историю изменений, то при несоответствии параметра
|
||||
// дате будет вызвано исключение.
|
||||
// ТолькоПредставление - Булево - если Истина, то возвращает только представление, иначе таблицу значений.
|
||||
// Для получения представления рекомендуется использовать функцию ПредставлениеКонтактнойИнформацииОбъекта.
|
||||
//
|
||||
// Возвращаемое значение:
|
||||
// ТаблицаЗначений:
|
||||
// * Объект - ЛюбаяСсылка - владелец контактной информации.
|
||||
// * Вид - СправочникСсылка.ВидыКонтактнойИнформации - вид контактной информации.
|
||||
// * Тип - ПеречислениеСсылка.ТипыКонтактнойИнформации - тип контактной информации.
|
||||
// * Значение - Строка - контактная информация во внутреннем формате JSON.
|
||||
// * Представление - Строка - представление контактной информации.
|
||||
// * Дата - Дата - дата, с которой действует запись контактной информации.
|
||||
// * ИдентификаторСтрокиТабличнойЧасти - Число - идентификатор строки этой табличной части
|
||||
// * ЗначенияПолей - Строка - устаревший XML, соответствующий XDTO пакетам КонтактнаяИнформация или Адрес. Для
|
||||
// обратной совместимости.
|
||||
//
|
||||
Функция КонтактнаяИнформацияОбъекта(СсылкаИлиОбъект, ВидИлиТипКонтактнойИнформации = Неопределено, Дата = Неопределено, ТолькоПредставление = Истина) Экспорт
|
||||
```
|
||||
@ -0,0 +1,36 @@
|
||||
---
|
||||
title: Контактная информация объектов
|
||||
slug: общие-бсп-стандартные-подсистемы-контактная-информация-программный-интерфейс/контактная-информация-объектов
|
||||
---
|
||||
# Описание
|
||||
|
||||
```bsl
|
||||
// Возвращает таблицу, содержащую контактную информацию нескольких объектов.
|
||||
//
|
||||
// Параметры:
|
||||
// СсылкиИлиОбъекты - Массив - владельцы контактной информации.
|
||||
// ТипыКонтактнойИнформации - Массив
|
||||
// - ПеречислениеСсылка.ТипыКонтактнойИнформации - если указаны, то будет получена
|
||||
// контактная информация только этих типов.
|
||||
// ВидыКонтактнойИнформации - Массив
|
||||
// - СправочникСсылка.ВидыКонтактнойИнформации - если указаны, то будет возвращена
|
||||
// контактная информация только этих видов контактной информации.
|
||||
// Дата - Дата - дата с которой действует запись контактной информации,
|
||||
// используется при хранении истории изменения контактной информации.
|
||||
// Если владелец хранит историю изменений, то при несоответствии параметра
|
||||
// дате будет вызвано исключение.
|
||||
//
|
||||
// Возвращаемое значение:
|
||||
// ТаблицаЗначений:
|
||||
// * Объект - ЛюбаяСсылка - владелец контактной информации.
|
||||
// * Вид - СправочникСсылка.ВидыКонтактнойИнформации - вид контактной информации.
|
||||
// * Тип - ПеречислениеСсылка.ТипыКонтактнойИнформации - тип контактной информации.
|
||||
// * Значение - Строка - контактная информация во внутреннем формате JSON.
|
||||
// * Представление - Строка - представление контактной информации.
|
||||
// * Дата - Дата - дата, с которой действует запись контактной информации.
|
||||
// * ИдентификаторСтрокиТабличнойЧасти - Число - идентификатор строки этой табличной части
|
||||
// * ЗначенияПолей - Строка - устаревший XML, соответствующий XDTO пакетам КонтактнаяИнформация или Адрес. Для
|
||||
// обратной совместимости.
|
||||
//
|
||||
Функция КонтактнаяИнформацияОбъектов(СсылкиИлиОбъекты, Знач ТипыКонтактнойИнформации = Неопределено, Знач ВидыКонтактнойИнформации = Неопределено, Дата = Неопределено) Экспорт
|
||||
```
|
||||
@ -0,0 +1,16 @@
|
||||
---
|
||||
title: Контактная информация по представлению
|
||||
slug: общие-бсп-стандартные-подсистемы-контактная-информация-программный-интерфейс/контактная-информация-по-представлению
|
||||
---
|
||||
|
||||
# Пример применения
|
||||
```bsl
|
||||
//Преобразует представление контактной информации во внутренний формат JSON.
|
||||
// Для адресов, введенных в свободной форме, корректное преобразование не гарантируется.
|
||||
|
||||
ВидЮрАдрес = Справочники.ВидыКонтактнойИнформации.ЮрАдресОрганизации;
|
||||
ЮрАдрес = "г. Москва, 3-й Самотечный пер., д. 23";
|
||||
|
||||
КонтактнаяИнформация = УправлениеКонтактнойИнформацией.КонтактнаяИнформацияПоПредставлению(ЮрАдрес, ВидЮрАдрес);
|
||||
ОбщегоНазначения.СообщитьПользователю(КонтактнаяИнформация);
|
||||
```
|
||||
@ -0,0 +1,15 @@
|
||||
---
|
||||
title: Объект подключен к подсистеме Контактная информация
|
||||
slug: общие-бсп-стандартные-подсистемы-контактная-информация-программный-интерфейс/объект-подключен-к-подсистеме-контактная-информация
|
||||
---
|
||||
# Пример применения
|
||||
```bsl
|
||||
// Возвращает признак, что объект подключен к подсистеме "Контактная информация"
|
||||
// и содержит табличную часть КонтактнаяИнформация.
|
||||
|
||||
Валюта = Справочники.Валюты.НайтиПоКоду("643");
|
||||
Организация = Справочники.Организации.ОрганизацияПоУмолчанию();
|
||||
|
||||
СодержитКонтакты = УправлениеКонтактнойИнформацией.СодержитКонтактнуюИнформацию(Организация);
|
||||
ОбщегоНазначения.СообщитьПользователю(СодержитКонтакты);
|
||||
```
|
||||
@ -0,0 +1,35 @@
|
||||
---
|
||||
title: Отбор контактной информации
|
||||
slug: общие-бсп-стандартные-подсистемы-контактная-информация-программный-интерфейс/отбор-контактной-информации
|
||||
---
|
||||
# Описание
|
||||
```bsl
|
||||
// Конструктор параметра Отбор для функции КонтактнаяИнформация.
|
||||
//
|
||||
// Возвращаемое значение:
|
||||
// Структура:
|
||||
// * ТипыКонтактнойИнформации - Массив из ПеречислениеСсылка.ТипыКонтактнойИнформации - отбор по типу контактной информации.
|
||||
// * ВидыКонтактнойИнформации - Массив из СправочникСсылка.ВидыКонтактнойИнформации - отбор по видам контактной информации.
|
||||
// * Дата - Дата - дата с которой действует запись контактной информации, используется при хранении
|
||||
// истории изменения контактной информации. Если владелец хранит историю изменений,
|
||||
// то при несоответствии параметра дате будет вызвано исключение.
|
||||
// * КодЯзыка - Строка - код языка, на котором необходимо получить представление контактной информации.
|
||||
// Представления контактной информации типа Адрес будет получено путем транслитерации, на остальные
|
||||
// типы контактной информации данных параметр не влияет.
|
||||
//
|
||||
ОтборКИ = УправлениеКонтактнойИнформацией.ОтборКонтактнойИнформации();
|
||||
```
|
||||
|
||||
# Пример применения
|
||||
```bsl
|
||||
// Возвращает таблицу, содержащую контактную информацию нескольких объектов.
|
||||
|
||||
Организация = Справочники.Организации.ОрганизацияПоУмолчанию();
|
||||
|
||||
ОтборКИ = УправлениеКонтактнойИнформацией.ОтборКонтактнойИнформации();
|
||||
ОтборКИ.ТипыКонтактнойИнформации.Добавить(Перечисления.ТипыКонтактнойИнформации.Телефон);
|
||||
ОтборКИ.ТипыКонтактнойИнформации.Добавить(Перечисления.ТипыКонтактнойИнформации.АдресЭлектроннойПочты);
|
||||
|
||||
ТаблицаКонтактов = УправлениеКонтактнойИнформацией.КонтактнаяИнформация(Организация, ОтборКИ);
|
||||
ТаблицаКонтактов.ВыбратьСтроку(); // для отладки (толстый клиент)
|
||||
```
|
||||
@ -0,0 +1,45 @@
|
||||
---
|
||||
title: Представление контактной информации объекта
|
||||
slug: общие-бсп-стандартные-подсистемы-контактная-информация-программный-интерфейс/представление-контактной-информации-объекта
|
||||
---
|
||||
# Описание
|
||||
|
||||
```bsl
|
||||
|
||||
// Возвращает представление контактной информации объекта.
|
||||
//
|
||||
// Параметры:
|
||||
// СсылкаИлиОбъект - Произвольный - владелец контактной информации.
|
||||
// ВидКонтактнойИнформации - СправочникСсылка.ВидыКонтактнойИнформации - вид контактной информации.
|
||||
// Разделитель - Строка - разделитель, который добавляется в представление между записями контактной информации.
|
||||
// По умолчанию это запятая с последующим пробелом, для исключения
|
||||
// пробела необходимо использовать признак БезПробелов у параметра ДополнительныеПараметры.
|
||||
// Дата - Дата - дата, с которой действует запись контактной информации. Если контактная информация
|
||||
// хранит историю изменения, то передача даты обязательна.
|
||||
// ДополнительныеПараметры - Структура - необязательные параметры для формирования представления контактной информации:
|
||||
// * ТолькоПервая - Булево - если Истина, то будет возвращено представление только основной(первой) записи
|
||||
// контактной информации. По умолчанию - Ложь;
|
||||
// * БезПробелов - Булево - если Истина, то после разделителя не будет автоматически добавляться пробел.
|
||||
// По умолчанию - Ложь;
|
||||
//
|
||||
// Возвращаемое значение:
|
||||
// Строка
|
||||
//
|
||||
Функция ПредставлениеКонтактнойИнформацииОбъекта(СсылкаИлиОбъект, ВидКонтактнойИнформации, Разделитель = ",", Дата = Неопределено, ДополнительныеПараметры = Неопределено) Экспорт
|
||||
|
||||
```
|
||||
|
||||
# Пример применения
|
||||
|
||||
```bsl
|
||||
|
||||
Организация = Справочники.Организации.ОрганизацияПоУмолчанию();
|
||||
ВидЮрАдрес = Справочники.ВидыКонтактнойИнформации.ЮрАдресОрганизации;
|
||||
ВидEmail = Справочники.ВидыКонтактнойИнформации.EmailОрганизации;
|
||||
|
||||
ЮрАдрес = УправлениеКонтактнойИнформацией.ПредставлениеКонтактнойИнформацииОбъекта(Организация, ВидЮрАдрес);
|
||||
Email = УправлениеКонтактнойИнформацией.ПредставлениеКонтактнойИнформацииОбъекта(Организация, ВидEmail);
|
||||
|
||||
ОбщегоНазначения.СообщитьПользователю(СтрШаблон("Юр. адрес: %1; Email: %2", ЮрАдрес, Email));
|
||||
|
||||
```
|
||||
@ -0,0 +1,20 @@
|
||||
---
|
||||
title: Представление контактной информации
|
||||
slug: общие-бсп-стандартные-подсистемы-контактная-информация-программный-интерфейс/представление-контактной-информации
|
||||
---
|
||||
|
||||
# Пример применения
|
||||
```bsl
|
||||
//Возвращает представление контактной информации (адреса, телефона, электронной почты и т.п.).
|
||||
|
||||
ВидЮрАдрес = Справочники.ВидыКонтактнойИнформации.ЮрАдресОрганизации;
|
||||
ЮрАдрес = "г. Москва, 3-й Самотечный пер., д. 23";
|
||||
|
||||
// Представление -> Строка JSON
|
||||
КонтактнаяИнформация = УправлениеКонтактнойИнформацией.КонтактнаяИнформацияПоПредставлению(ЮрАдрес, ВидЮрАдрес);
|
||||
|
||||
// Строка JSON -> Представление
|
||||
Представление = УправлениеКонтактнойИнформацией.ПредставлениеКонтактнойИнформации(КонтактнаяИнформация);
|
||||
|
||||
ОбщегоНазначения.СообщитьПользователю(Представление);
|
||||
```
|
||||
@ -0,0 +1,24 @@
|
||||
---
|
||||
title: Представление телефона
|
||||
slug: общие-бсп-стандартные-подсистемы-контактная-информация-программный-интерфейс/представление-телефона
|
||||
---
|
||||
# Пример применения
|
||||
```bsl
|
||||
// Формирует строковое представление телефона.
|
||||
//Синтаксис
|
||||
//
|
||||
// Функция СформироватьПредставлениеТелефона(КодСтраны, КодГорода, НомерТелефона, Добавочный, Комментарий) Экспорт
|
||||
//Параметры
|
||||
//
|
||||
// КодСтраны - Строка - код страны.
|
||||
// КодГорода - Строка - код города.
|
||||
// НомерТелефона - Строка - номер телефона.
|
||||
// Добавочный - Строка - добавочный номер.
|
||||
// Комментарий - Строка - комментарий.
|
||||
//Возвращаемое значение
|
||||
//
|
||||
// - Строка - представление телефона.
|
||||
|
||||
Телефон = УправлениеКонтактнойИнформациейКлиентСервер.СформироватьПредставлениеТелефона("+7", "495", "154-88-77", "7722", "с 9 до 17");
|
||||
ОбщегоНазначения.СообщитьПользователю(Телефон);
|
||||
```
|
||||
@ -0,0 +1,20 @@
|
||||
---
|
||||
title: Проверить адрес на соответствие требованиям
|
||||
slug: общие-бсп-стандартные-подсистемы-контактная-информация-программный-интерфейс/проверить-адрес-на-соответствие-требованиям
|
||||
---
|
||||
|
||||
# Пример применения
|
||||
```bsl
|
||||
//Проверяет адрес на соответствие требованиям к адресной информации.
|
||||
|
||||
ВидЮрАдрес = Справочники.ВидыКонтактнойИнформации.ЮрАдресОрганизации;
|
||||
ЮрАдрес = "г. Москва, 3-й Самотечный пер., д. 23";
|
||||
|
||||
АдресJSON = УправлениеКонтактнойИнформацией.КонтактнаяИнформацияПоПредставлению(ЮрАдрес, ВидЮрАдрес);
|
||||
|
||||
ДанныеПроверки = РаботаСАдресами.ПроверитьАдрес(АдресJSON);
|
||||
|
||||
Текст = СтрШаблон("Результат проверки: %1; Кол-во ошибок: %2", ДанныеПроверки.Результат, ДанныеПроверки.СписокОшибок.Количество());
|
||||
|
||||
ОбщегоНазначения.СообщитьПользователю(Текст);
|
||||
```
|
||||
@ -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", СтруктураСведений.КодСтраны, СтруктураСведений.КодГорода);
|
||||
ОбщегоНазначения.СообщитьПользователю(Текст);
|
||||
```
|
||||
@ -0,0 +1,19 @@
|
||||
---
|
||||
title: Сведения об адресе
|
||||
slug: общие-бсп-стандартные-подсистемы-контактная-информация-программный-интерфейс/сведения-об-адресе
|
||||
---
|
||||
|
||||
# Пример применения
|
||||
```bsl
|
||||
// Возвращает сведения об адресе в виде отдельных частей адреса и различных кодов (код региона, ОКТМО и др.).
|
||||
// Для преобразования полученных полей адреса в во внутренний формат JSON следует использовать функцию ПоляАдресаВJSON.
|
||||
|
||||
ВидЮрАдрес = Справочники.ВидыКонтактнойИнформации.ЮрАдресОрганизации;
|
||||
ЮрАдрес = "123056, г. Москва, 3-й Самотечный пер., д. 23";
|
||||
|
||||
АдресJSON = УправлениеКонтактнойИнформацией.КонтактнаяИнформацияПоПредставлению(ЮрАдрес, ВидЮрАдрес);
|
||||
|
||||
СтруктураСведений = РаботаСАдресами.СведенияОбАдресе(АдресJSON);
|
||||
Текст = СтрШаблон("Номер дома: %1; индекс: %2", СтруктураСведений.Здание.Номер, СтруктураСведений.Индекс);
|
||||
ОбщегоНазначения.СообщитьПользователю(Текст);
|
||||
```
|
||||
@ -0,0 +1,39 @@
|
||||
---
|
||||
title: Добавить значение свойства
|
||||
slug: общие-бсп-стандартные-подсистемы-свойства-программный-интерфейс/добавить-значение-свойства
|
||||
---
|
||||
|
||||
# Описание
|
||||
|
||||
```bsl
|
||||
//Добавляет доступное значение для реквизита с типом ЗначенияСвойствОбъектов
|
||||
// или ЗначенияСвойствОбъектовИерархия.
|
||||
//Синтаксис
|
||||
//
|
||||
// Функция ДобавитьЗначениеСвойства(Знач Владелец, Параметры, Иерархия = Ложь) Экспорт
|
||||
//
|
||||
// Параметры:
|
||||
// Владелец - Строка - имя дополнительного реквизита.
|
||||
// - ПланВидовХарактеристикСсылка.ДополнительныеРеквизитыИСведения - дополнительный реквизит,
|
||||
// для которого надо добавить значение.
|
||||
// Параметры - см. ПараметрыДобавленияЗначенияСвойства.
|
||||
// Иерархия - Булево
|
||||
//Возвращаемое значение
|
||||
//
|
||||
// СправочникСсылка.ЗначенияСвойствОбъектов
|
||||
// СправочникСсылка.ЗначенияСвойствОбъектовИерархия
|
||||
ЗначениеСвойства = УправлениеСвойствами.ДобавитьЗначениеСвойства(ИмяСвойства, ПараметрыЗначения);
|
||||
```
|
||||
|
||||
# Пример применения
|
||||
```bsl
|
||||
ПараметрыЗначения = УправлениеСвойствами.ПараметрыДобавленияЗначенияСвойства();
|
||||
ПараметрыЗначения.Наименование = "AMOLED";
|
||||
|
||||
ИмяСвойства = "ТехнологияЭкрана_d52aa705261143e68e2e30968b1e668b";
|
||||
|
||||
ЗначениеСвойства = УправлениеСвойствами.ДобавитьЗначениеСвойства(ИмяСвойства, ПараметрыЗначения);
|
||||
|
||||
ТекстСообщения = "Для дополнительного реквизита ""ТехнологияЭкрана"" добавлено значение " + ПараметрыЗначения.Наименование;
|
||||
ОбщегоНазначения.СообщитьПользователю(ТекстСообщения);
|
||||
```
|
||||
@ -0,0 +1,44 @@
|
||||
---
|
||||
title: Добавить свойство
|
||||
slug: общие-бсп-стандартные-подсистемы-свойства-программный-интерфейс/добавить-свойство
|
||||
---
|
||||
|
||||
# Описание
|
||||
|
||||
```bsl
|
||||
// Добавляет дополнительное свойство к переданному объекту.
|
||||
// Синтаксис
|
||||
//
|
||||
// Процедура ДобавитьСвойство(Владелец, Параметры, ЭтоСведение = Ложь) Экспорт
|
||||
// Параметры
|
||||
//
|
||||
// Владелец - ОбъектМетаданных
|
||||
// - Строка - полное имя объекта метаданных или имя набора свойств.
|
||||
// - СправочникСсылка.НаборыДополнительныхРеквизитовИСведений - ссылка на набор свойств.
|
||||
// Параметры - см. ПараметрыДобавленияСвойства.
|
||||
// ЭтоСведение - Булево - если Истина, будет добавлено дополнительное сведение.
|
||||
// Значение по умолчанию Ложь - добавляется дополнительный реквизит.
|
||||
УправлениеСвойствами.ДобавитьСвойство(НаборСвойств, ПараметрыСвойства);
|
||||
```
|
||||
|
||||
# Пример применения
|
||||
```bsl
|
||||
ВидНоменклатуры = Справочники.ВидыНоменклатуры.НайтиПоНаименованию("Смартфоны");
|
||||
Если НЕ ВидНоменклатуры.Пустая() Тогда
|
||||
|
||||
НаборСвойств = ОбщегоНазначения.ЗначениеРеквизитаОбъекта(ВидНоменклатуры, "НаборСвойств");
|
||||
|
||||
ПараметрыСвойства = УправлениеСвойствами.ПараметрыДобавленияСвойства();
|
||||
ПараметрыСвойства.Наименование = "Технология экрана";
|
||||
ПараметрыСвойства.Тип = Новый ОписаниеТипов("СправочникСсылка.ЗначенияСвойствОбъектов");
|
||||
ПараметрыСвойства.Имя = "ТехнологияЭкрана_" + СтрЗаменить(Новый УникальныйИдентификатор, "-", "");
|
||||
ПараметрыСвойства.ИдентификаторДляФормул = "ТехнологияЭкрана";
|
||||
|
||||
УправлениеСвойствами.ДобавитьСвойство(НаборСвойств, ПараметрыСвойства);
|
||||
|
||||
ОбщегоНазначения.СообщитьПользователю("Для вида номенклатуры ""Смартфоны"" добавлено новое свойство " + ПараметрыСвойства.Наименование);
|
||||
|
||||
Иначе
|
||||
ОбщегоНазначения.СообщитьПользователю("Вид номенклатуры ""Смартфоны"" не найден");
|
||||
КонецЕсли;
|
||||
```
|
||||
@ -0,0 +1,21 @@
|
||||
---
|
||||
title: Дополнительные реквизиты используются
|
||||
slug: общие-бсп-стандартные-подсистемы-свойства-программный-интерфейс/дополнительные-реквизиты-используются
|
||||
---
|
||||
|
||||
# Описание
|
||||
|
||||
```bsl
|
||||
// Проверяет, используются ли дополнительные реквизиты с объектом.
|
||||
// Синтаксис
|
||||
//
|
||||
// Функция ИспользоватьДопРеквизиты(ВладелецСвойств) Экспорт
|
||||
//
|
||||
// Параметры
|
||||
//
|
||||
// ВладелецСвойств - ЛюбаяСсылка - например, СправочникСсылка.Номенклатура, ДокументСсылка.ЗаказПокупателя, ...
|
||||
// Возвращаемое значение
|
||||
//
|
||||
// Булево - если Истина, тогда дополнительные реквизиты используются.
|
||||
ИспользуютсяДопРеквизиты = УправлениеСвойствами.ИспользоватьДопРеквизиты(ВладелецСвойств);
|
||||
```
|
||||
@ -0,0 +1,23 @@
|
||||
---
|
||||
title: Дополнительные сведения используются
|
||||
slug: общие-бсп-стандартные-подсистемы-свойства-программный-интерфейс/дополнительные-сведения-используются
|
||||
---
|
||||
|
||||
# Описание
|
||||
|
||||
```bsl
|
||||
// Проверяет, используются ли дополнительные сведения объектом.
|
||||
// Синтаксис
|
||||
//
|
||||
// Функция ИспользоватьДопСведения(ВладелецСвойств) Экспорт
|
||||
// Параметры
|
||||
//
|
||||
// ВладелецСвойств - ЛюбаяСсылка - например, СправочникСсылка.Номенклатура, ДокументСсылка.ЗаказПокупателя, ...
|
||||
// Возвращаемое значение
|
||||
//
|
||||
// Булево - если Истина, тогда дополнительные сведения используются.
|
||||
// Пример вызова
|
||||
//
|
||||
// Результат = УправлениеСвойствами.ИспользоватьДопСведения(ВладелецСвойств)
|
||||
ИспользуютсяДопСведения = УправлениеСвойствами.ИспользоватьДопСведения(ВладелецСвойств);
|
||||
```
|
||||
@ -0,0 +1,18 @@
|
||||
---
|
||||
title: Есть владельцы меток
|
||||
slug: общие-бсп-стандартные-подсистемы-свойства-программный-интерфейс/есть-владельцы-меток
|
||||
---
|
||||
|
||||
# Описание
|
||||
|
||||
```bsl
|
||||
// Возвращает признак наличия владельцев меток.
|
||||
// Синтаксис
|
||||
//
|
||||
// Функция ЕстьВладельцыМеток() Экспорт
|
||||
// Возвращаемое значение
|
||||
//
|
||||
// Булево - признак наличия владельцев меток.
|
||||
|
||||
ИспользуютсяМетки = УправлениеСвойствами.ЕстьВладельцыМеток();
|
||||
```
|
||||
@ -0,0 +1,51 @@
|
||||
---
|
||||
title: Записать свойства у объекта
|
||||
slug: общие-бсп-стандартные-подсистемы-свойства-программный-интерфейс/записать-свойства-у-объекта
|
||||
---
|
||||
# Описание
|
||||
|
||||
```bsl
|
||||
// Записывает дополнительные реквизиты и сведения владельцу свойств.
|
||||
// Изменения происходят в транзакции.
|
||||
// Синтаксис
|
||||
//
|
||||
// Процедура ЗаписатьСвойстваУОбъекта(ВладелецСвойств, ТаблицаСвойствИЗначений) Экспорт
|
||||
//
|
||||
// Параметры
|
||||
//
|
||||
// ВладелецСвойств - ЛюбаяСсылка - например, СправочникСсылка.Номенклатура, ДокументСсылка.ЗаказПокупателя и т.д.
|
||||
// ТаблицаСвойствИЗначений - ТаблицаЗначений:
|
||||
// * Свойство - ПланВидовХарактеристикСсылка.ДополнительныеРеквизитыИСведения - свойство владельца.
|
||||
// * Значение - Произвольный - любое значение, допустимое для свойства (указано в элементе свойства).
|
||||
УправлениеСвойствами.ЗаписатьСвойстваУОбъекта(ВладелецСвойств, ТаблицаСвойств);
|
||||
```
|
||||
|
||||
# Пример применения
|
||||
```bsl
|
||||
Номенклатура = Справочники.Номенклатура.НайтиПоКоду("000000001");
|
||||
Если НЕ Номенклатура.Пустая() Тогда
|
||||
|
||||
ТаблицаСвойств = Новый ТаблицаЗначений();
|
||||
ТаблицаСвойств.Колонки.Добавить("Свойство");
|
||||
ТаблицаСвойств.Колонки.Добавить("Значение");
|
||||
|
||||
ИмяСвойстваБеспроводной = "БеспроводнойИнтерфейс_1f84313ad678448db40fa1c403f26aba";
|
||||
|
||||
СтрокаТаблицы = ТаблицаСвойств.Добавить();
|
||||
СтрокаТаблицы.Свойство = ПланыВидовХарактеристик.ДополнительныеРеквизитыИСведения.НайтиПоРеквизиту("Имя", ИмяСвойстваБеспроводной);
|
||||
СтрокаТаблицы.Значение = Истина;
|
||||
|
||||
ИмяСвойстваШумоподавление = "АктивноеШумоподавление_d6d55617cc4746ff801c790c2ff8ca07";
|
||||
|
||||
СтрокаТаблицы = ТаблицаСвойств.Добавить();
|
||||
СтрокаТаблицы.Свойство = ПланыВидовХарактеристик.ДополнительныеРеквизитыИСведения.НайтиПоРеквизиту("Имя", ИмяСвойстваШумоподавление);
|
||||
СтрокаТаблицы.Значение = Истина;
|
||||
|
||||
УправлениеСвойствами.ЗаписатьСвойстваУОбъекта(Номенклатура, ТаблицаСвойств);
|
||||
|
||||
ОбщегоНазначения.СообщитьПользователю("Свойства номенклатуры успешно записаны");
|
||||
|
||||
Иначе
|
||||
ОбщегоНазначения.СообщитьПользователю("Номенклатура не найдена");
|
||||
КонецЕсли;
|
||||
```
|
||||
@ -0,0 +1,47 @@
|
||||
---
|
||||
title: Значение свойства
|
||||
slug: общие-бсп-стандартные-подсистемы-свойства-программный-интерфейс/значение-свойства
|
||||
---
|
||||
|
||||
# Описание
|
||||
|
||||
```bsl
|
||||
// Возвращает значение дополнительного свойства объекта.
|
||||
// Синтаксис
|
||||
//
|
||||
// Функция ЗначениеСвойства(Объект, Свойство, КодЯзыка = "") Экспорт
|
||||
//
|
||||
// Параметры:
|
||||
//
|
||||
// Объект - ЛюбаяСсылка - ссылка на объект, например, СправочникСсылка.Номенклатура,
|
||||
// ДокументСсылка.ЗаказПокупателя, ...
|
||||
// Свойство - ПланВидовХарактеристикСсылка.ДополнительныеРеквизитыИСведения - ссылка на
|
||||
// дополнительный реквизит, значение которого нужно получить.
|
||||
// - Строка - имя дополнительного свойства.
|
||||
// КодЯзыка - Строка - если указано, то вместо значения дополнительного свойства будет
|
||||
// возвращено его представление на указанном языке.
|
||||
//Возвращаемое значение
|
||||
//
|
||||
// Произвольный - любое значение, допустимое для свойства.
|
||||
Значение = УправлениеСвойствами.ЗначениеСвойства(Объект, ИмяСвойства);
|
||||
```
|
||||
|
||||
# Пример применения
|
||||
```bsl
|
||||
Номенклатура = Справочники.Номенклатура.НайтиПоКоду("000000001");
|
||||
Если НЕ Номенклатура.Пустая() Тогда
|
||||
|
||||
// вариант 1 - по имени свойства
|
||||
ИмяСвойства = "ОперационнаяСистема_ce01ea8bc2c34f4bad6f81092280c579";
|
||||
Значение = УправлениеСвойствами.ЗначениеСвойства(Номенклатура, ИмяСвойства);
|
||||
|
||||
// вариант 2 - по ссылке на свойство
|
||||
Свойство = ПланыВидовХарактеристик.ДополнительныеРеквизитыИСведения.НайтиПоРеквизиту("Имя", ИмяСвойства);
|
||||
Значение = УправлениеСвойствами.ЗначениеСвойства(Номенклатура, Свойство);
|
||||
|
||||
ОбщегоНазначения.СообщитьПользователю(Значение);
|
||||
|
||||
Иначе
|
||||
ОбщегоНазначения.СообщитьПользователю("Номенклатура не найдена");
|
||||
КонецЕсли;
|
||||
```
|
||||
@ -0,0 +1,74 @@
|
||||
---
|
||||
title: Значения свойств
|
||||
slug: общие-бсп-стандартные-подсистемы-свойства-программный-интерфейс/значения-свойств
|
||||
---
|
||||
|
||||
# Описание
|
||||
|
||||
```bsl
|
||||
// Возвращает значения дополнительных свойств объектов.
|
||||
// Синтаксис
|
||||
//
|
||||
// Функция ЗначенияСвойств(ОбъектыСоСвойствами,
|
||||
// ПолучатьДопРеквизиты = Истина,
|
||||
// ПолучатьДопСведения = Истина,
|
||||
// Свойства = Неопределено,
|
||||
// КодЯзыка = "") Экспорт
|
||||
// Параметры
|
||||
//
|
||||
// ОбъектыСоСвойствами - Массив - объекты, для которых нужно получить значения дополнительных свойств.
|
||||
// - ЛюбаяСсылка - ссылка на объект, например, СправочникСсылка.Номенклатура,
|
||||
// ДокументСсылка.ЗаказПокупателя, ...
|
||||
// ПолучатьДопРеквизиты - Булево - в результат включать дополнительные реквизиты. По умолчанию Истина.
|
||||
// ПолучатьДопСведения - Булево - в результат включать дополнительные сведения. По умолчанию Истина.
|
||||
// Свойства - Массив из ПланВидовХарактеристикСсылка.ДополнительныеРеквизитыИСведения - значения
|
||||
// которых следует получить.
|
||||
// - Массив из Строка - уникальное имя дополнительного свойства.
|
||||
// - Неопределено - по умолчанию, получить значения всех свойств владельца.
|
||||
// КодЯзыка - Строка - код языка, на котором будет получено представление значения свойства.
|
||||
// Если не указано - берется текущий язык.
|
||||
// Возвращаемое значение
|
||||
//
|
||||
// ТаблицаЗначений:
|
||||
// * Свойство - ПланВидовХарактеристикСсылка.ДополнительныеРеквизитыИСведения - свойство владельца.
|
||||
// * ИмяСвойства - Строка - уникальное имя свойства владельца.
|
||||
// * Значение - Произвольный - значения любого типа из описания типов свойства объекта метаданных:
|
||||
// "Метаданные.ПланВидовХарактеристик.ДополнительныеРеквизитыИСведения.Тип".
|
||||
// * Представление - Строка - представление значения на указанном языке.
|
||||
// * ВладелецСвойств - ЛюбаяСсылка - ссылка на объект.
|
||||
ТаблицаСвойств = УправлениеСвойствами.ЗначенияСвойств(ОбъектыСоСвойствами);
|
||||
```
|
||||
|
||||
# Пример применения
|
||||
```bsl
|
||||
// 1. Получение значений свойств одного объекта
|
||||
Номенклатура = Справочники.Номенклатура.НайтиПоКоду("000000001");
|
||||
Если НЕ Номенклатура.Пустая() Тогда
|
||||
|
||||
ТаблицаСвойств = УправлениеСвойствами.ЗначенияСвойств(Номенклатура);
|
||||
ТаблицаСвойств.ВыбратьСтроку();
|
||||
|
||||
Иначе
|
||||
ОбщегоНазначения.СообщитьПользователю("Номенклатура не найдена");
|
||||
КонецЕсли;
|
||||
|
||||
// 2. Получение значений свойств нескольких объектов
|
||||
Группа = Справочники.Номенклатура.НайтиПоКоду("000000001");
|
||||
|
||||
Если НЕ Группа.Пустая() Тогда
|
||||
|
||||
МассивТоваров = Новый Массив;
|
||||
Выборка = Справочники.Номенклатура.Выбрать(Группа);
|
||||
Пока Выборка.Следующий() Цикл
|
||||
Если НЕ Выборка.ЭтоГруппа Тогда
|
||||
МассивТоваров.Добавить(Выборка.Ссылка);
|
||||
КонецЕсли;
|
||||
КонецЦикла;
|
||||
|
||||
ТаблицаСвойств = УправлениеСвойствами.ЗначенияСвойств(МассивТоваров);
|
||||
ТаблицаСвойств.ВыбратьСтроку();
|
||||
|
||||
Иначе
|
||||
ОбщегоНазначения.СообщитьПользователю("Номенклатура не найдена");
|
||||
КонецЕсли;
|
||||
```
|
||||
@ -0,0 +1,39 @@
|
||||
---
|
||||
title: Проверить свойство у объекта
|
||||
slug: общие-бсп-стандартные-подсистемы-свойства-программный-интерфейс/проверить-свойство-у-объекта
|
||||
---
|
||||
# Описание
|
||||
|
||||
```bsl
|
||||
// Проверяет, есть ли у объекта свойство.
|
||||
// Синтаксис
|
||||
//
|
||||
// Функция ПроверитьСвойствоУОбъекта(ВладелецСвойств, Свойство) Экспорт
|
||||
//
|
||||
// Параметры
|
||||
//
|
||||
// ВладелецСвойств - ЛюбаяСсылка - например: СправочникСсылка.Номенклатура, ДокументСсылка.ЗаказПокупателя, ...
|
||||
// Свойство - ПланВидовХарактеристикСсылка.ДополнительныеРеквизитыИСведения - проверяемое свойство.
|
||||
// Возвращаемое значение
|
||||
//
|
||||
// Булево - если Истина, свойство у владельца есть.
|
||||
ЕстьСвойство = УправлениеСвойствами.ПроверитьСвойствоУОбъекта(Номенклатура, Свойство);
|
||||
```
|
||||
|
||||
# Пример применения
|
||||
```bsl
|
||||
Номенклатура = Справочники.Номенклатура.НайтиПоКоду("000000001");
|
||||
Если НЕ Номенклатура.Пустая() Тогда
|
||||
|
||||
ИмяСвойстваБеспроводной = "БеспроводнойИнтерфейс_1f84313ad678448db40fa1c403f26aba";
|
||||
Свойство = ПланыВидовХарактеристик.ДополнительныеРеквизитыИСведения.НайтиПоРеквизиту("Имя", ИмяСвойстваБеспроводной);
|
||||
|
||||
ЕстьСвойство = УправлениеСвойствами.ПроверитьСвойствоУОбъекта(Номенклатура, Свойство);
|
||||
|
||||
ТекстСообщения = СтрШаблон("У объекта %1", ?(ЕстьСвойство, "есть свойство", "нет свойства"));
|
||||
ОбщегоНазначения.СообщитьПользователю(ТекстСообщения);
|
||||
|
||||
Иначе
|
||||
ОбщегоНазначения.СообщитьПользователю("Номенклатура не найдена");
|
||||
КонецЕсли;
|
||||
```
|
||||
@ -0,0 +1,17 @@
|
||||
---
|
||||
title: Свойства доступны
|
||||
slug: общие-бсп-стандартные-подсистемы-свойства-программный-интерфейс/свойства-доступны
|
||||
---
|
||||
|
||||
```bsl
|
||||
// Проверяет доступность подсистемы для текущего пользователя.
|
||||
// Синтаксис
|
||||
//
|
||||
// Функция СвойстваДоступны() Экспорт
|
||||
// Возвращаемое значение
|
||||
//
|
||||
// Булево - Истина, если подсистема доступна.
|
||||
|
||||
Результат = УправлениеСвойствами.СвойстваДоступны();
|
||||
|
||||
```
|
||||
@ -0,0 +1,42 @@
|
||||
---
|
||||
title: Свойства объекта
|
||||
slug: общие-бсп-стандартные-подсистемы-свойства-программный-интерфейс/свойства-объекта
|
||||
---
|
||||
# Описание
|
||||
|
||||
```bsl
|
||||
// Возвращает свойства у указанного объекта.
|
||||
// Синтаксис
|
||||
//
|
||||
// Функция СвойстваОбъекта(ВладелецСвойств,
|
||||
// ПолучатьДопРеквизиты = Истина,
|
||||
// ПолучатьДопСведения = Истина) Экспорт
|
||||
// Параметры
|
||||
//
|
||||
// ВладелецСвойств - ЛюбаяСсылка - например: СправочникСсылка.Номенклатура, ДокументСсылка.ЗаказПокупателя, ...
|
||||
// - СправочникОбъект, ДокументОбъект - любой объект со свойствами.
|
||||
// - ДанныеФормыСтруктура - коллекция по типу объекта владельца свойств.
|
||||
// ПолучатьДопРеквизиты - Булево - в результат включать дополнительные реквизиты.
|
||||
// ПолучатьДопСведения - Булево - в результат включать дополнительные сведения.
|
||||
//
|
||||
// Возвращаемое значение
|
||||
//
|
||||
// Массив из ПланВидовХарактеристикСсылка.ДополнительныеРеквизитыИСведения
|
||||
МассивСвойств = УправлениеСвойствами.СвойстваОбъекта(Номенклатура);
|
||||
```
|
||||
|
||||
# Пример применения
|
||||
```bsl
|
||||
Номенклатура = Справочники.Номенклатура.НайтиПоКоду("000000001");
|
||||
Если НЕ Номенклатура.Пустая() Тогда
|
||||
|
||||
МассивСвойств = УправлениеСвойствами.СвойстваОбъекта(Номенклатура);
|
||||
|
||||
Для Каждого Свойство Из МассивСвойств Цикл
|
||||
ОбщегоНазначения.СообщитьПользователю(Свойство);
|
||||
КонецЦикла;
|
||||
|
||||
Иначе
|
||||
ОбщегоНазначения.СообщитьПользователю("Номенклатура не найдена");
|
||||
КонецЕсли;
|
||||
```
|
||||
@ -0,0 +1,11 @@
|
||||
---
|
||||
title: Общий модуль по имени
|
||||
slug: общие-общего-назначения/общий-модуль-по-имени
|
||||
---
|
||||
# Пример применения
|
||||
```bsl
|
||||
Если ОбщегоНазначения.ПодсистемаСуществует("СтандартныеПодсистемы.ВариантыОтчетов") Тогда
|
||||
МодульВариантыОтчетов = ОбщегоНазначения.ОбщийМодуль("ВариантыОтчетов");
|
||||
//МодульВариантыОтчетов.<Имя процедуры>();
|
||||
КонецЕсли;
|
||||
```
|
||||
@ -0,0 +1,18 @@
|
||||
---
|
||||
title: Описание подсистем
|
||||
slug: общие-общего-назначения/описание-подсистем
|
||||
---
|
||||
# Пример применения
|
||||
```bsl
|
||||
ВерсииПодсистем = ОбщегоНазначения.ОписанияПодсистем();
|
||||
Для Каждого ОписаниеПодсистемы Из ВерсииПодсистем Цикл
|
||||
ТекстСообщения = "";
|
||||
Для каждого ОписаниеСвойства Из ОписаниеПодсистемы Цикл
|
||||
ТекстСообщения = ТекстСообщения
|
||||
+ СтрШаблон("%1: %2", ОписаниеСвойства.Ключ, ОписаниеСвойства.Значение)
|
||||
+ "; ";
|
||||
КонецЦикла;
|
||||
ОбщегоНазначения.СообщитьПользователю(ТекстСообщения);
|
||||
КонецЦикла;
|
||||
|
||||
```
|
||||
@ -0,0 +1,14 @@
|
||||
---
|
||||
title: Подсистема существует
|
||||
slug: общие-общего-назначения/подсистема-существует
|
||||
---
|
||||
# Пример применения
|
||||
```bsl
|
||||
Если ОбщегоНазначения.ПодсистемаСуществует("СтандартныеПодсистемы.ВариантыОтчетов") Тогда
|
||||
ТекстСообщения = "Подсистема ""Вараинты отчетов"" внедрена в конфигурацию";
|
||||
Иначе
|
||||
ТекстСообщения = "Подсистема ""Вараинты отчетов"" не внедрена в конфигурацию";
|
||||
КонецЕсли;
|
||||
|
||||
ОбщегоНазначения.СообщитьПользователю(ТекстСообщения);
|
||||
```
|
||||
@ -0,0 +1,16 @@
|
||||
---
|
||||
title: Текст ошибки заполнения
|
||||
slug: общие-общего-назначения/текст-ошибки-заполнения
|
||||
---
|
||||
# Пример применения
|
||||
```bsl
|
||||
ВидПоля = "Колонка"; // "Колонка"; "Список"
|
||||
ВидСообщения = "Заполнение"; // "Корректность"
|
||||
ИмяПоля = "Номенклатура";
|
||||
|
||||
НомерСтроки = 2;
|
||||
ИмяСписка = "Товары";
|
||||
|
||||
ТекстОшибки = ОбщегоНазначенияКлиентСервер.ТекстОшибкиЗаполнения(ВидПоля, ВидСообщения, ИмяПоля, НомерСтроки, ИмяСписка);
|
||||
ОбщегоНазначения.СообщитьПользователю(ТекстОшибки);
|
||||
```
|
||||
@ -0,0 +1,12 @@
|
||||
---
|
||||
title: Добавить лидирующие нули
|
||||
slug: общие-работа-с-текстом/добавить-лидирующие-нули
|
||||
---
|
||||
# Пример применения
|
||||
```bsl
|
||||
// Пример: добавление в номер лидирующих нулей
|
||||
|
||||
НомерНаПечать = "14";
|
||||
НомерДокумента = СтроковыеФункцииКлиентСервер.ДополнитьСтроку(Номер, 10);
|
||||
ОбщегоНазначенияКлиент.СообщитьПользователю(НомерДокумента);
|
||||
```
|
||||
@ -0,0 +1,12 @@
|
||||
---
|
||||
title: Строка в дату
|
||||
slug: общие-работа-с-текстом/строка-в-дату
|
||||
---
|
||||
# Пример применения
|
||||
```bsl
|
||||
ДатаСтрокой = "04.09.2023 17:38:14";
|
||||
|
||||
// Формат даты должен быть в виде "ДД.ММ.ГГГГ" или "ДД/ММ/ГГ" или "ДД-ММ-ГГ ЧЧ:ММ:CC",
|
||||
Результат = СтроковыеФункцииКлиентСервер.СтрокаВДату(ДатаСтрокой, ЧастиДаты.ДатаВремя);
|
||||
ОбщегоНазначенияКлиент.СообщитьПользователю(Результат);
|
||||
```
|
||||
@ -0,0 +1,10 @@
|
||||
---
|
||||
title: Строка в число
|
||||
slug: общие-работа-с-текстом/строка-в-число
|
||||
---
|
||||
# Пример применения
|
||||
```bsl
|
||||
Сумма = "1 500,94";
|
||||
Результат = СтроковыеФункцииКлиентСервер.СтрокаВЧисло(Сумма);
|
||||
ОбщегоНазначенияКлиент.СообщитьПользователю(Результат);
|
||||
```
|
||||
@ -0,0 +1,15 @@
|
||||
---
|
||||
title: Строка латиницей
|
||||
slug: общие-работа-с-текстом/строка-латиницей
|
||||
---
|
||||
# Пример применения
|
||||
```bsl
|
||||
ФИО = "Макаров Виктор Семенович";
|
||||
|
||||
// на клиенте
|
||||
Транслит = СтроковыеФункцииКлиент.СтрокаЛатиницей(ФИО);
|
||||
ОбщегоНазначенияКлиент.СообщитьПользователю(Транслит);
|
||||
|
||||
// на сервере
|
||||
// Транслит = СтроковыеФункции.СтрокаЛатиницей(ФИО);
|
||||
```
|
||||
@ -0,0 +1,12 @@
|
||||
---
|
||||
title: Удалить повторяющиеся нули
|
||||
slug: общие-работа-с-текстом/удалить-повторяющиеся-нули
|
||||
---
|
||||
# Пример применения
|
||||
```bsl
|
||||
// Пример: удаление из номера лидирующих нулей
|
||||
|
||||
НомерДокумента = "00000000014";
|
||||
НомерНапечать = СтроковыеФункцииКлиентСервер.УдалитьПовторяющиесяСимволы(НомерДокумента, "0");
|
||||
ОбщегоНазначенияКлиент.СообщитьПользователю(НомерНапечать);
|
||||
```
|
||||
@ -0,0 +1,21 @@
|
||||
---
|
||||
title: Диалог выбора каталога
|
||||
slug: общие-работа-с-файловой-системой/диалог-выбора-каталога
|
||||
---
|
||||
# Описание
|
||||
|
||||
```bsl
|
||||
// Показывает диалог выбора каталога.
|
||||
//
|
||||
// Параметры:
|
||||
// ОбработчикЗавершения - ОписаниеОповещения - содержит описание процедуры, которая будет вызвана после
|
||||
// закрытия диалога выбора со следующими параметрами:
|
||||
// # ПутьККаталогу - Строка - полный путь к каталогу. Если не установлено расширение для работы с 1С:Предприятием
|
||||
// или пользователь отказался от выбора, возвращает пустую строку.
|
||||
// # ДополнительныеПараметры - Произвольный - значение, которое было указано при создании объекта ОписаниеОповещения.
|
||||
// Заголовок - Строка - заголовок диалога выбора каталога.
|
||||
// Каталог - Строка - начальное значение каталога, предлагаемое по умолчанию.
|
||||
//
|
||||
Процедура ВыбратьКаталог(ОбработчикЗавершения, Заголовок = "", Каталог = "") Экспорт
|
||||
|
||||
```
|
||||
@ -0,0 +1,23 @@
|
||||
---
|
||||
title: Диалог выбора файла
|
||||
slug: общие-работа-с-файловой-системой/диалог-выбора-файла
|
||||
---
|
||||
# Описание
|
||||
|
||||
```bsl
|
||||
// Показывает диалог выбора файла.
|
||||
// В веб-клиенте пользователю будет показан диалог установки расширения для работы с 1С:Предприятием,
|
||||
// если требуется.
|
||||
//
|
||||
// Параметры:
|
||||
// ОбработчикЗавершения - ОписаниеОповещения - содержит описание процедуры, которая будет вызвана после
|
||||
// закрытия диалога выбора с параметрами:
|
||||
// # Результат - Массив из Строка - выбранные имена файлов.
|
||||
// - Строка - пустая строка, если пользователь отказался от установки расширения.
|
||||
// - Неопределено - если пользователь отказался от выбора файла.
|
||||
// # ДополнительныеПараметры - Произвольный - дополнительные параметры оповещения.
|
||||
// Диалог - ДиалогВыбораФайла - свойства см. в синтакс-помощнике.
|
||||
//
|
||||
Процедура ПоказатьДиалогВыбора(ОбработчикЗавершения, Диалог) Экспорт
|
||||
|
||||
```
|
||||
@ -0,0 +1,41 @@
|
||||
---
|
||||
title: Загрузить файл во временное хранилище
|
||||
slug: общие-работа-с-файловой-системой/загрузить-файл-во-временное-хранилище
|
||||
---
|
||||
# Описание
|
||||
|
||||
```bsl
|
||||
|
||||
// Показывает диалог выбора файла и помещает выбранный файл во временное хранилище.
|
||||
// Совмещает работу методов глобального контекста НачатьПомещениеФайла и НачатьПомещениеФайлов,
|
||||
// возвращая идентичный результат вне зависимости от того, подключено или нет расширение для работы с 1С:Предприятием.
|
||||
// Ограничения:
|
||||
// Не используется для выбора каталогов - эта опция не поддерживается веб-клиентом.
|
||||
//
|
||||
// Параметры:
|
||||
// ОбработчикЗавершения - ОписаниеОповещения - содержит описание процедуры, которая будет вызвана после
|
||||
// загрузки файла со следующими параметрами:
|
||||
// # ПомещенныйФайл - Структура - пользователь выбрал файл:
|
||||
// ## Хранение - Строка - адрес временного хранилища с двоичными данными файла.
|
||||
// ## Имя - Строка - в тонком клиенте и в веб-клиенте с установленным
|
||||
// расширением работы с 1С:Предприятием - локальный путь, по которому
|
||||
// был получен файл. В веб-клиенте без расширения для работы с 1С:Предприятием
|
||||
// передается имя файла с расширением.
|
||||
// - Неопределено - пользователь отказался от выбора или файл занят другой программой.
|
||||
// # ДополнительныеПараметры - Произвольный - значение, которое было указано при создании объекта
|
||||
// ОписаниеОповещения.
|
||||
// ПараметрыЗагрузки - см. ФайловаяСистемаКлиент.ПараметрыЗагрузкиФайла.
|
||||
// ИмяФайла - Строка - полный путь к файлу, который будет предложен пользователю в начале
|
||||
// интерактивного выбора или помещен во временное хранилище в неинтерактивном.
|
||||
// Если выбран неинтерактивный режим и параметр не заполнен, будет вызвано исключение.
|
||||
// АдресВоВременномХранилище - Строка - адрес, по которому будет сохранен файл.
|
||||
//
|
||||
// Пример:
|
||||
// Оповещение = Новый ОписаниеОповещения("ВыбратьФайлПослеПомещенияФайла", ЭтотОбъект, Контекст);
|
||||
// ПараметрыЗагрузки = ФайловаяСистемаКлиент.ПараметрыЗагрузкиФайла();
|
||||
// ПараметрыЗагрузки.ИдентификаторФормы = УникальныйИдентификатор;
|
||||
// ФайловаяСистемаКлиент.ЗагрузитьФайл(Оповещение, ПараметрыЗагрузки);
|
||||
//
|
||||
Процедура ЗагрузитьФайл(ОбработчикЗавершения, ПараметрыЗагрузки = Неопределено, ИмяФайла = "",
|
||||
АдресВоВременномХранилище = "") Экспорт
|
||||
```
|
||||
@ -0,0 +1,48 @@
|
||||
---
|
||||
title: Загрузить файлы во временное хранилище
|
||||
slug: общие-работа-с-файловой-системой/загрузить-файлы-во-временное-хранилище
|
||||
---
|
||||
# Описание
|
||||
|
||||
```bsl
|
||||
// Показывает диалог выбора файлов и помещает выбранные файлы во временное хранилище.
|
||||
// Совмещает работу методов глобального контекста НачатьПомещениеФайла и НачатьПомещениеФайлов,
|
||||
// возвращая идентичный результат вне зависимости от того, подключено или нет расширение для работы с 1С:Предприятием.
|
||||
// Ограничения:
|
||||
// Не используется для выбора каталогов - эта опция не поддерживается веб-клиентом.
|
||||
// Не поддерживается множественный выбор в веб-клиенте, если не установлено расширение для работы с 1С:Предприятием.
|
||||
//
|
||||
// Параметры:
|
||||
// ОбработчикЗавершения - ОписаниеОповещения - содержит описание процедуры, которая будет вызвана после
|
||||
// загрузки файлов со следующими параметрами:
|
||||
// # ПомещенныеФайлы - Неопределено - пользователь отказался от выбора или файл занят другой программой.
|
||||
// - Массив из Структура - пользователь выбрал файл:
|
||||
// ## Хранение - Строка - адрес временного хранилища с двоичными данными файла.
|
||||
// ## Имя - Строка - в тонком клиенте и в веб-клиенте с установленным
|
||||
// расширением работы с 1С:Предприятием - локальный путь, по которому
|
||||
// был получен файл. В веб-клиенте без расширения для работы с 1С:Предприятием
|
||||
// передается имя файла с расширением.
|
||||
// ## ПолноеИмя - Строка - в тонком клиенте и в веб-клиенте с установленным
|
||||
// расширением работы с 1С:Предприятием - локальный путь, по которому
|
||||
// был получен файл. В веб-клиенте без расширения для работы с 1С:Предприятием
|
||||
// принимает значение "".
|
||||
// ## ИмяФайла - Строка - имя файла с расширением.
|
||||
// # ДополнительныеПараметры - Произвольный - значение, которое было указано при создании объекта ОписаниеОповещения.
|
||||
// ПараметрыЗагрузки - см. ФайловаяСистемаКлиент.ПараметрыЗагрузкиФайла.
|
||||
// ЗагружаемыеФайлы - Массив - содержит объекты типа ОписаниеПередаваемогоФайла. Может быть заполнен полностью,
|
||||
// в этом случае загружаемые файлы будут сохранены по указанным адресам. Может быть заполнен
|
||||
// частично - у элементов массива заполнены только имена. В этом случае, загружаемые файлы будут
|
||||
// размещены в новых временных хранилищах. Массив может быть не заполнен. В этом случае набор
|
||||
// помещаемых файлов определяется по значениям, указанным в параметре ПараметрыЗагрузки. Если в
|
||||
// параметрах загрузки выбран неинтерактивный режим и параметр ЗагружаемыеФайлы не заполнен,
|
||||
// будет вызвано исключение.
|
||||
//
|
||||
// Пример:
|
||||
// Оповещение = Новый ОписаниеОповещения("ЗагрузитьРасширениеПослеПомещенияФайлов", ЭтотОбъект, Контекст);
|
||||
// ПараметрыЗагрузки = ФайловаяСистемаКлиент.ПараметрыЗагрузкиФайла();
|
||||
// ПараметрыЗагрузки.ИдентификаторФормы = УникальныйИдентификатор;
|
||||
// ФайловаяСистемаКлиент.ЗагрузитьФайлы(Оповещение, ПараметрыЗагрузки);
|
||||
//
|
||||
Процедура ЗагрузитьФайлы(ОбработчикЗавершения, ПараметрыЗагрузки = Неопределено, ЗагружаемыеФайлы = Неопределено) Экспорт
|
||||
|
||||
```
|
||||
@ -0,0 +1,13 @@
|
||||
---
|
||||
title: Запустить программу
|
||||
slug: общие-работа-с-файловой-системой/запустить-программу
|
||||
---
|
||||
# Пример применения
|
||||
```bsl
|
||||
ПутьКФайлу = "C:\Program Files\1cv8\common\1cestart.exe";
|
||||
|
||||
ПараметрыЗапускаПрограммы = ФайловаяСистемаКлиент.ПараметрыЗапускаПрограммы();
|
||||
ПараметрыЗапускаПрограммы.ДождатьсяЗавершения = Истина;
|
||||
ФайловаяСистемаКлиент.ЗапуститьПрограмму(ПутьКФайлу);
|
||||
|
||||
```
|
||||
@ -0,0 +1,30 @@
|
||||
---
|
||||
title: Сохранить файл из временного хранилища
|
||||
slug: общие-работа-с-файловой-системой/сохранить-файл-из-временного-хранилища
|
||||
---
|
||||
# Описание
|
||||
|
||||
```bsl
|
||||
// Получает файл и сохраняет его в локальную файловую систему пользователя.
|
||||
//
|
||||
// Параметры:
|
||||
// ОбработчикЗавершения - Неопределено
|
||||
// - ОписаниеОповещения - содержит описание процедуры, которая будет вызвана после
|
||||
// завершения со следующими параметрами:
|
||||
// # ПолученныеФайлы - Массив из ОписаниеПереданногоФайла - сохраненные файлы.
|
||||
// - Неопределено - файлы не были получены.
|
||||
// # ДополнительныеПараметры - Произвольный - значение, которое было указано при создании объекта ОписаниеОповещения.
|
||||
// РасположениеФайла - Строка - адрес временного хранилища или навигационная ссылка на
|
||||
// реквизит типа ХранилищеЗначения, содержащий двоичные данные файла.
|
||||
// ИмяФайла - Строка - полный путь, по которому должен быть сохранен получаемый файл или имя файла
|
||||
// с расширением.
|
||||
// ПараметрыСохранения - см. ФайловаяСистемаКлиент.ПараметрыСохраненияФайла
|
||||
//
|
||||
// Пример:
|
||||
// Оповещение = Новый ОписаниеОповещения("СохранитьСертификатПослеПолученияФайлов", ЭтотОбъект, Контекст);
|
||||
// ПараметрыСохранения = ФайловаяСистемаКлиент.ПараметрыСохраненияФайла();
|
||||
// ФайловаяСистемаКлиент.СохранитьФайл(Оповещение, Контекст.АдресСертификата, ИмяФайла, ПараметрыСохранения);
|
||||
//
|
||||
Процедура СохранитьФайл(ОбработчикЗавершения, РасположениеФайла, ИмяФайла = "",
|
||||
ПараметрыСохранения = Неопределено) Экспорт
|
||||
```
|
||||
@ -0,0 +1,32 @@
|
||||
---
|
||||
title: Сохранить файлы из временного хранилища
|
||||
slug: общие-работа-с-файловой-системой/сохранить-файлы-из-временного-хранилища
|
||||
---
|
||||
# Описание
|
||||
|
||||
```bsl
|
||||
// Получает файлы и сохраняет их в локальную файловую систему пользователя.
|
||||
// Для сохранения файлов в неинтерактивном режиме свойство Имя параметра СохраняемыеФайлы должно содержать
|
||||
// полный путь к сохраняемому файлу или, если свойство Имя содержит только имя файла с расширением, необходимо
|
||||
// заполнить свойство Каталог элемента Диалог параметра ПараметрыСохранения. В иных случаях будет вызвано
|
||||
// исключение.
|
||||
//
|
||||
// Параметры:
|
||||
// ОбработчикЗавершения - Неопределено
|
||||
// - ОписаниеОповещения - содержит описание процедуры, которая будет вызвана
|
||||
// после завершения со следующими параметрами:
|
||||
// * ПолученныеФайлы - Массив из ОписаниеПереданногоФайла - сохраненные файлы.
|
||||
// - Неопределено - файлы не были получены.
|
||||
// * ДополнительныеПараметры - Произвольный - значение, которое было указано при создании объекта
|
||||
// ОписаниеОповещения.
|
||||
// СохраняемыеФайлы - Массив из ОписаниеПередаваемогоФайла
|
||||
// ПараметрыСохранения - см. ФайловаяСистемаКлиент.ПараметрыСохраненияФайла
|
||||
//
|
||||
// Пример:
|
||||
// Оповещение = Новый ОписаниеОповещения("СохранитьПечатнуюФормуВФайлПослеПолученияФайлов", ЭтотОбъект);
|
||||
// ПараметрыСохранения = ФайловаяСистемаКлиент.ПараметрыСохраненияФайлов();
|
||||
// ФайловаяСистемаКлиент.СохранитьФайлы(Оповещение, ПолучаемыеФайлы, ПараметрыСохранения);
|
||||
//
|
||||
Процедура СохранитьФайлы(ОбработчикЗавершения, СохраняемыеФайлы, ПараметрыСохранения = Неопределено) Экспорт
|
||||
|
||||
```
|
||||
@ -0,0 +1,19 @@
|
||||
---
|
||||
title: Уникальное имя файла
|
||||
slug: общие-работа-с-файловой-системой/уникальное-имя-файла
|
||||
---
|
||||
# Описание
|
||||
|
||||
```bsl
|
||||
// Формирует уникальное имя файла в указанной папке, при необходимости добавляя к имени файла порядковый номер,
|
||||
// например: "файл (2).txt", "файл (3).txt" и т.п.
|
||||
//
|
||||
// Параметры:
|
||||
// ИмяФайла - Строка - полное имя файла с папкой, например, "C:\Документы\файл.txt".
|
||||
//
|
||||
// Возвращаемое значение:
|
||||
// Строка - например, "C:\Документы\файл (2).txt", если "файл.txt" уже существует в указанной папке.
|
||||
//
|
||||
Функция УникальноеИмяФайла(Знач ИмяФайла) Экспорт
|
||||
|
||||
```
|
||||
Loading…
x
Reference in New Issue
Block a user