| maple4_ru_rb.app
Мать и отец всех функций :) Maple4 Report Builder
Как и любую функцию FoxPro, можно запустить как процедуру
Параметры функции (точнее их наличие или отсутствие) определяют задачи выполнения.
Т.е.:
do maple4_ru_rb.app
Редактирование репорта или сценария
do maple4_ru_rb.app with "tester.m4rb"
Редактирование (или создание с таким именем) репорта tester.m4rb
do maple4_ru_rb.app with "m4rb.m4sc"
Редактирование (или создание с таким именем) скрипта m4rb.m4sc
DO maple4_ru_rb.app WITH "http://www.maple4.ru/index.html"
Открытие страницы HTML на просмотр
Если требуется ответ функции (т.е. она должна вернуть некое значение), запуск может быть вида:
LOCAL ss
ss=maple4_ru_rb(2,"phone_user.m4rb","","phonek")
Обратите внимание, что первым параметром в данном случае идет число (тип запуска).
1 параметр - тип запуска
0 - сгенерить отчет и вывести его на экран
1 - сгенерить отчет без вывода
2 - сгенерить текст (на основании репорта) и вернуть его основной программе
3 - сгенерить отчет и распечатать его на принтере по умолчанию без вывода на экран
4 -продолжить формирование файла cо вставкой ПОЛНОГО ПУТИ к КАРТИНКАМ.
Данная возможность необходима в случае формирования текста HTML для вставки в документ, который НЕ БУДЕТ находиться в том же каталоге, где находятся файлы графики.
Где это может пригодиться?
Ну, например, Вы сами формируете HTML документ и хотите вставить в него отчет, сформированный в Maple4 Report Builder-e.
Весьма вероятно, что открывать его Вы будете не в каталоге формирования программы (и не RB), следовательно, если в репорте будет некая графика, то в документе HTML Вы ее не увидите - по умолчанию пути к файлам графики - это только названия файлов.
Использование же специального синтаксиса запуска решает данную проблему.
5 - открыть html страницу modeless
6 - открыть html страницу modal
2 параметр - название репорта (скрипта, страницы HTML)
Название репорта обязательно должно быть с расширением m4rb
Скрипта - m4sc
Страницы HTM, HTML - htm, html (данное правило для страниц может не соблюдаться, но в этом случае ОБЯЗАТЕЛЬНО 1 параметр должен быть равен 5 или 6).
Следующие параметры - только для репорта (m4rb)
3 параметр - зарезервирован
4 параметр - селект, курсор или таблица, по которой строится отчет
ОБЯЗАТЕЛЬНО все должно быть открыто (т.е. что бы уже было, по чему строить отчет)
5 параметр - имя готовой страницы
Должно быть c расширением htm или html. Допускается опускать параметр - в этом случае, файлу автоматически присваивается имя репорта с расширением html.
6 параметр - заголовок окна
Допускается опускать параметр - в этом случае заголовок получает имя репорта.
7 параметр - при .t. - выводить отчет даже без наличия данных
Не обязательный параметр, в этом случае если нет данных (например, таблица пуста) - отчет не генерится, т.е. все как в стандартном редакторе.
8 параметр - параметр рефреша (а так же Init и Close)
Здесь можно задать значение, которое будет отрабатываться при запуске процедур обновления отчета, при начале формирования отчета и при выходе из отчета.
Не обязательный параметр
|
| m4rb_notes()
Данная функция вставляет в отчет редактируемое примечание. Т.е. без лишних затрат, разработок и т.д. Вы можете значительно расширить функциональность программы - значение как выводится, так и редактируется специальной формой редактирования.
Какие параметры передаются в функцию:
1 параметр - Имя таблицы, где хранятся примечания.
Если таблицы нет, она будет создана.
НЕ ДОПУСКАЕТСЯ применение таблиц с одинаковыми именами (в разных каталогах)
2 параметр - уникальный идентификатор примечания.
Идентификатор должен быть символьным, размер - не более 20 символов
Идентификатор отличает одно присечание от другого, в одной таблице не может быть двух одинаковых идентификаторов.
3 параметр - строка по умолчанию, если примечание не введено.
Данная строка никуда не вносится, она лишь отображается при пустом значении.
4 параметр - строка для помощи при вводе.
Отображается при редактировании в специальной форме.
При вызове функции Все параметры должны присутствовать.
Пример вызова (результат можно посмотреть вот здесь):
m4rb_notes('comment_for_m4rb.dbf',padl(phonek.phonenum,10,"0"),'<.....>','Edit notes for phone '+TRANSFORM(phonek.phonenum,"(999)-999-9999"))
|
| form_view_close()
Процедура вывода диалогового окна (View , Close)
В качестве первого параметра - код нажатия кнопки View
|
| m4rb_cnt()
Количество (аналог Calculate Cnt() to ...) в пределах той группы, в которой находится
Без параметра
|
| m4rb_np()
Вставка кода разрыва страницы
Без параметра
|
| m4rb_sum()
Сумма значения поля (в пределах той группы, в которой находится)
Обязательно наличие параметра - по какой таблице/селекту/курсору и полю эту сумму вычислить.
Например, m4rb_sum("test_.saldo") вернет сумму по полю saldo таблицы/селекту/курсора test_
|
| m4rb_num()
Порядковый номер
без параметра
|
