Список полезных функций из состава Библиотеки стандартных подсистем 3.1
Продолжение статьи нашего друга spec8s. (1 Часть)
1.
// Преобразует текст указанного формата XML в таблицу значений,
// при этом колонки таблицы формируются на основе описания в XML.
ОбщегоНазначения.ПрочитатьXMLВТаблицу(XML)
Пример:
ТаблицаЗначений = ОбщегоНазначения.ПрочитатьXMLВТаблицу(ЧтениеXML);
2.
// Выполняет попытку проведения документов.
ОбщегоНазначения.ПровестиДокументы(Документы)
Пример:
РезультатПроведения = ОбщегоНазначения.ПровестиДокументы(Запрос.Выполнить()Выгрузить());
3.
// Получает все места использования ссылок.
// Если какая-либо ссылка нигде не используется, то строк для нее в результирующей таблице не будет.
ОбщегоНазначения.МестаИспользования(Знач НаборСсылок, Знач АдресРезультата = "")
Пример:
Массив = новый Массив;
Массив.Добавить(ДокументСсылка);
ТаблицаИспользованияСсылки = ОбщегоНазначения.МестаИспользования(Массив);
4.
// Дополняет массив МассивПриемник значениями из массива МассивИсточник.
ОбщегоНазначенияКлиентСервер.ДополнитьМассив(МассивПриемник, МассивИсточник, ТолькоУникальныеЗначения = Ложь)
// Дополняет соответствие значениями из другого соответствия.
ОбщегоНазначенияКлиентСервер.ДополнитьСоответствие(Приемник, Источник, Заменять = Неопределено)
// Дополняет структуру значениями из другой структуры.
ОбщегоНазначенияКлиентСервер.ДополнитьСтруктуру(Приемник, Источник, Заменять = Неопределено)
// Дополняет таблицу значений - приемник данными из таблицы значений - источника.
// Типы ТаблицаЗначений, ДеревоЗначений, ТабличнаяЧасть не доступны на клиенте.
ОбщегоНазначенияКлиентСервер.ДополнитьТаблицу(ТаблицаИсточник, ТаблицаПриемник)
// Дополняет таблицу значений Таблица значениями из массива Массив.
ОбщегоНазначенияКлиентСервер.ДополнитьТаблицуИзМассива(Таблица, Массив, ИмяПоля)
Пример:
ОбщегоНазначенияКлиентСервер.ДополнитьМассив(МассивПриемник, МассивИсточник)
ОбщегоНазначенияКлиентСервер.ДополнитьСоответствие(СоответствиеПриемник, СоответствиеИсточник, ложь)
ОбщегоНазначенияКлиентСервер.ДополнитьСтруктуру(СтруктураПриемник, СтруктураИсточник, ложь)
ОбщегоНазначенияКлиентСервер.ДополнитьТаблицу(ТаблицаИсточник, ТаблицаПриемник)
ОбщегоНазначенияКлиентСервер.ДополнитьТаблицуИзМассива(Таблица, Массив, "ИмяПоляТаблицы")
5.
// Создает напоминание с произвольным временем или расписанием выполнения.
НапоминанияПользователя.УстановитьНапоминание(Текст, ВремяСобытия, ИнтервалДоСобытия = 0, Предмет = Неопределено, Идентификатор = Неопределено)
Пример:
Время = НачалоДня(ТекущаяДата()) + 50400; //14:00
ТаблицаИспользованияСсылки = НапоминанияПользователя.УстановитьНапоминание("Совещание в 14:00!",Время,3600)
6.
// Возвращает структуру, содержащую сведения об организации.
ОрганизацииСервер.СведенияОбОрганизации(Знач Организация, Знач Поля = "", Знач Дата = Неопределено)
Пример:
ОсновнаяОрганизация = Справочники.организации.ОрганизацияПоУмолчанию();
СведенияОбОрганизацииСтруктура = ОрганизацииСервер.СведенияОбОрганизации(ОсновнаяОрганизация);
7.
// Отправляет SMS через настроенного поставщика услуги, возвращает идентификатор сообщения.
ОтправкаSMS.ОтправитьSMS(НомераПолучателей, Знач Текст, ИмяОтправителя = Неопределено, ПеревестиВТранслит = Ложь)
Пример:
Если ОтправкаSMS.ДоступнаОтправкаSMS() тогда
Массив = новый Массив;
Массив.Добавить("+79990000333");
РезультатОтправки = ОтправкаSMS.ОтправитьSMS(Массив,"Тестовое SMS", "Администратор")
КонецЕсли;
8.
// Производит замену ссылок во всех данных информационной базы.
//
// Параметры:
// Параметры - Структура - где:
// * ПарыЗамен - Соответствие - Пары замен.
// * Ключ - ЛюбаяСсылка - Что ищем (дубль).
// * Значение - ЛюбаяСсылка - На что заменяем (оригинал).
// Ссылки сами на себя и пустые ссылки для поиска будут проигнорированы.
// * СпособУдаления - Строка - Необязательный. Что делать с дублем после успешной замены.
// "" - По умолчанию. Не предпринимать никаких действий.
// "Пометка" - Помечать на удаление.
// "Непосредственно" - Удалять непосредственно.
// АдресРезультата - Строка - адрес временного хранилища, куда будет помещен результат замены - ТаблицаЗначений:
// * Ссылка - ЛюбаяСсылка - Ссылка, которую заменяли.
// * ОбъектОшибки - Произвольный - Объект - причина ошибки.
// * ПредставлениеОбъектаОшибки - Строка - Строковое представление объекта ошибки.
// * ТипОшибки - Строка - Маркер типа ошибки. Возможны варианты:
// "ОшибкаБлокировки" - при обработке ссылки некоторые объекты были заблокированы
// "ДанныеИзменены" - в процессе обработки данные были изменены другим пользователем
// "ОшибкаЗаписи" - не смогли записать объект
// "НеизвестныеДанные" - при обработке были найдены данные, которые
// не планировались к анализу, замена не реализована
// "ЗаменаЗапрещена" - обработчик ВозможностьЗаменыЭлементов вернул отказ.
// * ТекстОшибки - Строка - Подробное описание ошибки.
ПоискИУдалениеДублей.ЗаменитьСсылки(Параметры, Знач АдресРезультата)
Пример:
СтруктураПараметровЗамены = новый Структура;
ПарыЗамен = новый Соответствие;
ПарыЗамен.Вставить(Справочники.Пользователи.НайтиПоКоду("01"),Справочники.Пользователи.ПустаяСсылка());
СтруктураПараметровЗамены.Вставить("ПарыЗамен",ПарыЗамен);
СтруктураПараметровЗамены.Вставить("СпособУдаления","Пометка");
Адрес = "";
ПоискИУдалениеДублей.ЗаменитьСсылки(СтруктураПараметровЗамены,Адрес);
Результат = ПолучитьИзВременногоХранилища(Адрес);
9.
// Возвращает текущего пользователя.
Пользователи.ТекущийПользователь();
//ПРИМЕР
ТекущийПользователь = Пользователи.ТекущийПользователь()
10.
// Определяет форму ФИО в заданном падеже.
СклонениеПредставленийОбъектов.ПросклонятьФИО(ФИО,Падеж,Объект,Пол)
Пример:
ФИО = "Иванов Иван Иванович";
Падеж = 2; //Родительный
Объект = Справочники.ФизическиеЛица.НайтиПоКоду("01");
Пол = 1; //Мужской
Результат = СклонениеПредставленийОбъектов.ПросклонятьФИО(ФИО,Падеж,Объект,Пол)
