Функции в документе
Функции Словоформа можно использовать прямо в редакторе документов. Во время создания файлов указанная функция будет исполнена на ряду с другими функиями и результат будет подставлен в файл вместо этой функции.
Чтобы использовать Словоформ в редакторе следует соблюдать определённый синтаксис.
Функция Словоформа начинается со знака =, затем слово Словоформ. Далее в скобках - аргументы функции, отделённые запятыми. На первом месте всегда исходная переменная или текст, на втором - действие, на третьем и/или четвёртом - дополнительные параметры. Некоторые из параметров являются обязательными, а другие - нет. В качестве исходного текста может быть переменная, текст, либо другая функция, но не функция Словоформа.
Для составления функции можно использовать редактор функций, который открывается через "Вставка" - "Функции".
Пример функции:
В данном примере текст, содержащийся в переменной %фио этого же документа склоняется в родительный падеж, с учётом дополнииельных параметров: указано что в тексте одушевлённый объект, ФИО.
Другой пример:
В данном примере функция Словоформа применяется к результату функции NOW(), которая возвращает текущую дату и прописывает ёё полностью в именительном падеже.
Синтаксис функций
Чтобы увидеть синтаксис любой фунции выберите необходимую вам функцию:
- Склонение по падежам (в т.ч. сложные ФИО)
- Разделение ФИО на компоненты
- Определение рода слов и ФИО
- Транслитерирование текст
- Прописывание числительных словами
- Прописывание даты словами
- Разбивка строки на части
- Поиск и замена строк
- Изменение регистра букв
Вложенные функции
Вложенные функции не поддерживаются в редакторе документов. Для выполнения последовательных действий с текстом следует использовать таблицу или правила.
При этом в качестве источника данных в функциях в докумете можно использовать другие функции, например, NOW() или RND_NUM().
Редактирование файлов
После создания файла, при необходимости, результат работы функции Словоформа можно изменить. Для этого нужно выбрать файл, к контекстном меню нажать "Измениить данные" и в окне редактирования внести изменения в результат работы функции. Если удалить значение, то функция будет выполнена заново при создании файла. Если изменить данные в источнике функции, например переменную %фио, то следует очистить поля с результатом работы всех функций Словоформа, где источником была эта переменная.
Порядок работы правил и функций
Следует учитывать, что при создании файлов вначале исполняются правила Словоформа, которые или меняют переменные или создают новые, и только после этого исполняются функции Словоформа. Поэтому, если в функции используется какая-либо переменная, которая изменяется правилами, то функция будет работать уже с изменённым текстом в этой переменной.
Ошибки
Если какая-либо функция не работает, то нужно проверить, соблюдён ли синтаксис функции. Кроме того, в некоторых случаях в редакторе могут быть подставлены непечатаемые HTML-символы, которые могут повлиять на работу функции. В этом случае следует удалить функцию и написать заново. Для составления функции лучше воспользоваться редактором функций, который открывается в меню "Вставка" - "Функции".
Если не указать обязательные аргументы функции, или допустить ошибку (например, не закрыть скобку), это может привести к тому, что файл не будет создан.