logo

11 сент. 2009 г.

BIP: Доступ к отчетам через URL

В общем виде адрес опубликованного в BIP отчета выглядит так:

http://server:port/xmlpserver/<Каталог отчета>/<Имя отчета>/<Имя отчета>.xdo

где

server,port – имя и порт сервера, на котором запущен BIP;
xmlpserver – имя приложения (вы можете изменить его при ручном deploy приложения BIP);
Каталог отчета – папка, содержащая отчет;
Имя отчета – имя отчета (выводится 2 раза)

Для управления поведением публикуемого отчета можно (и нужно) использовать дополнительные параметры.

(Помните, что первый из параметров должен предваряться обязательным знаком «?», а все последующие – «&»)

Частично информацию о допустимых параметрах можно узнать с помощью ссылки «Link to this report», которая видна в интерфейсе BI Publisher в режиме просмотра отчета.



Система подсказывает нам, что для доступа по ссылке извне к этому отчету нужно использовать следующий URL:

http://localhost:9704/xmlpserver/Financials/Balance Letter/Balance Letter.xdo?_xpf=&_xpt=0&_xdo=%2FFinancials%2FBalance%20Letter%2FBalance%20Letter.xdo&_xt=Customer%20Letter&_xf=html&_xmode=4

Разберем их:

Во-первых, любой пользовательский параметр отчета может передаваться через URL Помните, что регистр имени параметра имеет значение.

_xpf – если задано любое значение, то запрещает запуск отчета (даже если выставлено свойство Autorun у отчета), появляется сообщение о необходимости явного нажатия кнопки «Просмотр»;

_xpt – задает как будет отображаться полученный документ, 0 – как вложение в текущем окне браузера, 1 – вовне браузера программой, ассоциированной с вложением по mime-type (для документов, выводимых в формате HTML, параметр не играет роли);

_xdo – путь до публикуемого отчета, можно не использовать;

_xt – указывает имя шаблона, который хотите применить к отчету, Standard или пустое значение приводит к использованию первого по порядку шаблона;

_xf – формат вывода отчета: rtf, pdf, excel, excel2000, xml, text, csv, html, mhtml;

_xmode – режим вывода отчета:
0 – обычный интерфейс BIP;
1 – показываются списки выбора шаблонов и форматов вывода, а также кнопки View/Export;
2 – то же, что 1 режим, плюс все пользовательские параметры отчета;
3 – доступны все кнопки/списки выбора 0-го режима, но недоступны пользовательские параметры;
4 – показывается только отчет, без управляющих элементов.


Но это далеко не все допустимые параметры.

id – логин пользователя;

passwd – пароль пользователя (наряду с параметром id не сработает, если есть SSO-cookie или cookie JSESSIONID, ссылающаяся на уже существующую сессию сервлета);

_xl – локаль отчета (может пригодится, если вы используете языковые XLIFF-файлы);

_xuil – локаль интерфейса (будет кнопка просмотра у вас с текстом «View» или «Просмотр»);

_xbscheduler – показывать (1) или нет (0) кнопку «Schedule»;

_xbsend – показывать (1) или нет (0) кнопку «Send»;

_xbbuilder – показывать (1) или нет (0) кнопку «Analyzer»;

_xbanalyzer – показывать (1) или нет (0) кнопку «Analyzer for Excel»;

2 комментария:

  1. Если запускать отчет напрямую через URL с указанием авторизации в id/passwd, то hidden-параметр xdo_user_name, использующйся внутри отчета не инициализируется как положено, а возвращает null... :(
    Напрямую задавать &xdo_user_name в URL тоже не помогает.

    ОтветитьУдалить
  2. А что если создать явно параметр отчета "P_USER_NAME"? И передавать его значение в URL...

    ОтветитьУдалить