 Функции в документе

Баспа әлеудегі машиналық оқу қолданылғанда құжаттамалардың түсініктемелері аударылады.

Функции Словоформа можно использовать прямо в редакторе документов. Во время создания файлов указанная функция будет исполнена на ряду с другими функиями и результат будет подставлен в файл вместо этой функции.

Чтобы использовать Словоформ в редакторе следует соблюдать определённый синтаксис.

Функция Словоформа начинается со знака =, затем слово Словоформ. Далее в скобках - аргументы функции, отделённые запятыми. На первом месте всегда исходная переменная или текст, на втором - действие, на третьем и/или четвёртом - дополнительные параметры. Некоторые из параметров являются обязательными, а другие - нет. В качестве исходного текста может быть переменная, текст, либо другая функция, но не функция Словоформа.

Для составления функции можно использовать редактор функций, который открывается через "Вставка" - "Функции".

Пример функции:

=Словоформ(%фио, склонять, род, одуш, имя)

В данном примере текст, содержащийся в переменной %фио этого же документа склоняется в родительный падеж, с учётом дополнииельных параметров: указано что в тексте одушевлённый объект, ФИО.

Другой пример:

=Словоформ(=NOW(), прописать дату, полн, им)

В данном примере функция Словоформа применяется к результату функции NOW(), которая возвращает текущую дату и прописывает ёё полностью в именительном падеже.

Синтаксис функций

Чтобы увидеть синтаксис любой фунции выберите необходимую вам функцию:

Вложенные функции

Вложенные функции не поддерживаются в редакторе документов. Для выполнения последовательных действий с текстом следует использовать таблицу или правила.

При этом в качестве источника данных в функциях в докумете можно использовать другие функции, например, NOW() или RND_NUM().

Редактирование файлов

После создания файла, при необходимости, результат работы функции Словоформа можно изменить. Для этого нужно выбрать файл, к контекстном меню нажать "Измениить данные" и в окне редактирования внести изменения в результат работы функции. Если удалить значение, то функция будет выполнена заново при создании файла. Если изменить данные в источнике функции, например переменную %фио, то следует очистить поля с результатом работы всех функций Словоформа, где источником была эта переменная.

Порядок работы правил и функций

Следует учитывать, что при создании файлов вначале исполняются правила Словоформа, которые или меняют переменные или создают новые, и только после этого исполняются функции Словоформа. Поэтому, если в функции используется какая-либо переменная, которая изменяется правилами, то функция будет работать уже с изменённым текстом в этой переменной.

Ошибки

Если какая-либо функция не работает, то нужно проверить, соблюдён ли синтаксис функции. Кроме того, в некоторых случаях в редакторе могут быть подставлены непечатаемые HTML-символы, которые могут повлиять на работу функции. В этом случае следует удалить функцию и написать заново. Для составления функции лучше воспользоваться редактором функций, который открывается в меню "Вставка" - "Функции".

Если не указать обязательные аргументы функции, или допустить ошибку (например, не закрыть скобку), это может привести к тому, что файл не будет создан.

Готовы начать?

Открыть Открыть веб-приложение