Merge branch 'main' of https://git.sinenikolsky.ru/admin/kb-personal

src/content/docs/knowledge-base/Примеры кода, шаблоны/БСП и типовые/1. Библиотека стандартных подсистем/Работа с запросами/Разделитель пакета запросов.md

@@ -0,0 +1,13 @@
+# Описание
+```bsl
+// Возвращает фрагмент текста запроса, отделяющего один запрос от другого.
+//
+// Возвращаемое значение:
+//  Строка - разделитель запросов.
+//
+Функция РазделительПакетаЗапросов() Экспорт
+```
+# Пример вызова
+```bsl
+ИтоговыйТекстЗапроса = СтрСоединить(МассивТекстовЗапроса, ОбщегоНазначения.РазделительПакетаЗапросов())
+```

src/content/docs/knowledge-base/Примеры кода, шаблоны/БСП и типовые/1. Библиотека стандартных подсистем/Сериализация/Сериализация JSON.md

@@ -0,0 +1,46 @@
+
+# Сериализация
+## Описание
+```bsl
+// Преобразует значение в строку JSON при помощи метода глобального контекста ЗаписатьJSON.
+// Допускаются не все типы значений, подробности см. в синтакс-помощнике.
+// Даты преобразуются в формат ISO (YYYY-MM-DDThh:mm:ssZ).
+//
+// Параметры:
+//  Значение - Произвольный
+//
+// Возвращаемое значение:
+//  Строка
+//
+Функция ЗначениеВJSON(Знач Значение) Экспорт
+```
+## Пример вызова
+```bsl
+Результат = ОбщегоНазначения.ЗначениеВJSON(Значение);
+```
+
+# Десериализация
+## Описание
+```bsl
+// Преобразует строку в формате JSON в значение при помощи метода глобального контекста ПрочитатьJSON.
+// См. ограничения в синтакс-помощнике.
+// Объекты JSON по умолчанию преобразует в значения типа Соответствие.
+// Имена свойств со значением типа Дата необходимо явно указывать, чтобы было выполнено преобразование.
+// Ожидаемый формат дат - ISO (YYYY-MM-DDThh:mm:ssZ).
+//
+// Параметры:
+//   Строка - Строка - значение в формате JSON.
+//   ИменаСвойствСоЗначениямиДата - Строка - имя свойства, содержащее значение типа Дата. Допустимо указывать несколько
+//                                           свойств через запятую.
+//                                - Массив из Строка
+//   ПрочитатьВСоответствие       - Булево - если Ложь, то объекты JSON будут преобразованы в значение типа Структура.
+//
+// Возвращаемое значение:
+//  Произвольный
+//
+Функция JSONВЗначение(Знач Строка, Знач ИменаСвойствСоЗначениямиДата = Неопределено, Знач ПрочитатьВСоответствие = Истина) Экспорт
+```
+## Пример вызова
+```bsl
+Результат = ОбщегоНазначения.JSONВЗначение(Строка, ИменаСвойствСоЗначениямиДата, ПрочитатьВСоответствие);
+```

src/content/docs/knowledge-base/Примеры кода, шаблоны/БСП и типовые/1. Библиотека стандартных подсистем/Сериализация/Сериализация XML.md

@@ -0,0 +1,40 @@
+
+
+# Сериализация
+## Описание
+```bsl
+// Преобразует (сериализует) любое значение в XML-строку.
+// Преобразованы в могут быть только те объекты, для которых в синтакс-помощнике указано, что они сериализуются.
+// См. также ЗначениеИзСтрокиXML.
+//
+// Параметры:
+//  Значение - Произвольный - значение, которое необходимо сериализовать в XML-строку.
+//
+// Возвращаемое значение:
+//  Строка - XML-строка.
+//
+Функция ЗначениеВСтрокуXML(Значение) Экспорт
+```
+## Пример вызова
+```bsl
+Результат = ОбщегоНазначения.ЗначениеВСтрокуXML(Значение)
+```
+
+# Десериализация
+## Описание
+```bsl
+// Выполняет преобразование (десериализацию) XML-строки в значение.
+// См. также ЗначениеВСтрокуXML.
+//
+// Параметры:
+//  СтрокаXML - Строка - XML-строка, с сериализованным объектом.
+//
+// Возвращаемое значение:
+//  Произвольный - значение, полученное из переданной XML-строки.
+//
+Функция ЗначениеИзСтрокиXML(СтрокаXML) Экспорт
+```
+## Пример вызова
+```bsl
+Результат = ОбщегоНазначения.ЗначениеИзСтрокиXML(СтрокаXML)
+```

src/content/docs/knowledge-base/Примеры кода, шаблоны/Общее/Регистры сведений/Как перед записью изменить измерение.md

@@ -0,0 +1,19 @@
+
+# Неправильно 
+```bsl
+Процедура ПередЗаписью(Отказ, Замещение)
+    Для Каждого Запись Из ЭтотОбъект Цикл
+        Запись.Измерение1 = "Новое значение измерения"; // посыпется по ошибке установки отбора
+    КонецЦикла;
+КонецПроцедуры
+```
+# Правильно 
+```bsl
+Процедура ПередЗаписью(Отказ, Замещение)
+    Для Каждого Запись Из ЭтотОбъект Цикл
+        НовоеЗначение = "Новое значение измерения";
+        Отбор.Измерение1.Значение = НовоеЗначение;
+        Запись.Измерение1 = "НовоеЗначение"; // посыпется по ошибке установки отбора
+    КонецЦикла;
+КонецПроцедуры
+```