| Программа для склада, для магазина, для производства |
Vvs "Офис-Склад-Магазин"Редактирование форм документов и отчетов |
П.2. Вывод текста, формул и значений из базы данных.
Рассмотрим, какие строки могут быть в форме документа.
Самая простая строка - это строка, содержащая обычный текст. При формировании документа она просто будет скопирована:
Срок оплаты счета - 3 банковских дня.
Для того чтобы вставить в итоговый текст значения из базы данных или результат каких-либо вычислений, в строке используются
поля в квадратных скобках. Внутри квадратных скобок могут указываться значения из базы данных или формулы. (Для вывода списка всех доступных полей базы данных и конструкций макроязыка используйте клавишу F8). Например, следующая строка берет и выводит срок оплаты заказа из поля AP9:
Срок оплаты счета - [AP9] банковских дня.
Следует остановиться на длине выходной строки. Ширина между квадратными скобками определяет ширину выходной строки. Введя пробелы между квадратными скобками после формулы, можно расширить результат. Можно также задать ширину поля в символах, указав ее после формулы через запятую. Например, в следующей строке срок выводится в 3 символа:
Срок оплаты счета - [AP9,3] банковских дня.
Если надо вывести значение без лишних пробелов справа, то можно указать отрицательное значение длины:
Срок оплаты счета - [AP9,-1] банковских дня.
Цифровые значения выводятся с двумя знаками после запятой. Поля базы данных с типом "дата" выводятся в формате дд.мм.гг. Имеется возможность управлять форматом вывода. Для этого перед формулой, сразу после открывающей квадратной скобки можно вставить один из управляющих символов.
Для числовых значений это:
-
~ - целое число. Значение выводится без знаков после запятой. Дробные числа округляются.
-
%n, где n - количество знаков после запятой от 1 до 9. Используется для задания количества знаков после запятой.
-
! - число прописью.
-
$ - сумма прописью в рублях.
Для дат:
-
# - дата прописью, преобразует дату.
-
& - вывод в формате даты "дд.мм.гг", может использоваться для вывода числового значения в формате даты. Дата имеет внутреннее числовое значение, поэтому с датами можно проводить арифметические операции.
Для строк:
-
" - используется для вывода данных в формате XML. Заменяет в строке зарезервированные символы, например, кавычки на выражение "
Таким образом, для нашего примера нужно написать:
Срок оплаты счета - [~AP9,-1] банковских дня
Бывают случаи, когда одну длинную строку надо разнести по нескольким строкам. Для этого между квадратными скобками можно использовать еще один параметр. Он задается после ширины строки через запятую. Если этот параметр опущен или равен нулю, то выражение будет выдаваться с начала. Для выдачи второй части выражения он должен быть равен 1 и т.д. Если слово не помещается в поле целиком, то оно будет перенесено. Все части разделенного выражения должны иметь одинаковую длину. Например, сумма заказа прописью в рублях на трех строках выводится следующим способом:
[$AP25 ]
[$AP25,0,1 ]
[$AP25,0,2 ]
В этом примере в ширине строк указан 0. При этом ширина определяется расстоянием между скобками.
Формат поля для вывода значений следующий:
[<Форматирующий символ> выражение,<Длина>,<Номер строки>]
<Форматирующий символ> - необязательный символ, который используется для дополнительного преобразования вычисленного выражения,
выражение - вычисляемое выражение, которое может содержать числа, поля из базы данных, арифметические операции, функции. Выбрать и вставить в текст имена полей и функций из списка, можно нажав кнопку "Выбор поля" или клавишу F8 при редактировании формы документа.
<Длина> - необязательный параметр определяющий, до какой длины будет преобразовано поле при формировании документа.Если длина не указана или равна нулю, то длина будет определяться шириной между квадратными скобками, ограничивающее поле. Если длина равна -1, то поле не будет ограничиваться по длине.
<Номер строки> - используется для выдачи длинных выражений в несколько строк. Если этот параметр опущен или равен нулю, то выражение будет выдаваться с начала. Для выдачи второй части выражения он должен быть равен 1 и т.д. Если слово не помещается в поле целиком, то оно будет перенесено. ВНИМАНИЕ! Все части разделенного выражения должны иметь одинаковую длину.
Имеется возможность выводить часть строки. В строке может быть произведен поиск заданного текста, вывод будет сделан только до или после найденного текста.
Во второй части выражения в квадратных скобках вместо длины полученной строки можно задать подстроку, до которой или начиная с которой будет выводиться значение. Для этого, вместо цифрового значения длины, там можно указать символ ! и после него подстроку. Третий параметр в этом случае работает несколько иначе, чем в обычных выражениях. Если он отсутствует или равен 0, то берется часть значения до подстроки, если он равен 1, то начиная с подстроки, если 2 - то после подстроки.
Например:
[DP5,!_] выводится первая часть кода товара до символа _ .
[DTWR,!Столичная,1] Выводится название товара начиная с слова "Столичная".
[DTWR,!Замена->,2] Выводится часть названия товара после слова "Замена->".