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