1c/bsl_console
1
0
Fork 0
mirror of https://github.com/salexdv/bsl_console.git synced 2024-11-24 08:33:29 +02:00
Code Issues Releases Activity

Дополнение документации parseSnippets

Browse Source
This commit is contained in:
salexdv 2022-01-27 06:04:25 +03:00
parent b6a08152ee
commit c4b48e3aa9
1 changed files with 38 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

40
docs/parse_snippets.md
View File

@ -1,11 +1,47 @@
# Функция *parseSnippets*
## Назначение функции
Функция для загрузки шаблонов кода (сниппетов) в формате 1С:Предприятия
## Параметры функции
* **stData** - *string*, текстовое содержимое файла шаблона .st
## Пример вызова
```javascript
parseSnippets('{0,{"Пока",0,0,"Пока","Пока <?""Условие""> Цикл......');
```
```
## Особенности реализации
1. В списке подсказок появляются только те шаблоны кода, у которых в 1С заполнено поле `Автоматически заменять строку`.
2. В стандартных шаблонах 1С для списка выбора есть возможность указывать представление значение и само вставляемое значение, например, так:
```bsl
<?"", ВыборВарианта, "Основная таблица", "<?>", "СрезПервых", ".СрезПервых(<?>)", "СрезПоследних", ".СрезПоследних(<?>)">
```
При выборе значения `Основная таблица` в код фактически не вставляется ничего, а просто происходит перемещение курсора в текущую позицию. К сожалению, редактор не позволяет реализовать такую схему, поэтому указанный выше шаблон преобразуется в выбор из двух значений, а именно `СрезПервых` и `СрезПоследних`.
3. Шаблон `ДатаВремя` всегда преобразуется в текущую дату в формате `dd.MM.yyyy HH:mm:ss`
4. Шаблоны, предназначенные для выбора объекта метаданных, такие как `Справочник`, `Документ`, `РегистрСведений` и подобные преобразуются в список выбора соответствующих объектов, если для них ранее были загружены метаданные через функцию [`updateMetadata`](update_metadata.md). В случае отсутствия метаданных в шаблон просто вставляется аналогичное имя переменной для замены.
5. Перечисленные ниже шаблоны никак не обрабатываются, а просто вставляются в код с аналогичным именем переменной:
* ВыборТипа
* ЖурналДокументов
* ЗначениеПеречисления
* ИмяПользователя
* ПолноеИмяПользователя
* ИмяПользователяХранилищаКонфигурации
* КонструкторОписанияТипов
* КритерийОтбора
* ОбъектМетаданных
* Перерасчет
* ПланВидовРасчетаПредопределенныеДанные
* ПланВидовХарактеристикПредопределенныеДанные
* ПланСчетовПредопределенныеДанные
* Последовательность
* СправочникПредопределенныеДанные
* ТекстЗапроса
* ФорматнаяСтрока