Расскажу в двух словах, как это реализовано.

То, что на скриншоте справа – это обычный prompt. Помимо трех видимых комбо-боксов, там есть еще один невидимый мультиселект для валюты, условно назовем его HIDDEN_CURRENCY ( о том, как его спрятать, будет ниже). Чекбоксы слева – это обычные чекбоксы, создаваемые html-тэгом <input type=”checkbox”>. Фрагмент макета дэшборда при этом выглядит следующим образом:

Элемент под названием «Javascript валюты» - это Static Text с включенным свойством Contains HTML-markup. В этом элементе создаются сами чекбоксы, а также опеределения следующих java-script функций:

• getCurrencyString - функция на базе текущего состояния чекбоксов строки вида формирует и возвращает строку вида ’RUR’,’USD’, содержащую коды отмеченных валют.
• setPromptValue – функция находит на странице элемент <input>, соответствующий prompt’у HIDDEN_CURRENCY и устанавливает ему value = getCurrencyString(). Затем надо вызвать у HIDDEN_CURRENCY обработчик onChange, т.к. в prompt’е Банки и Счета должны подрезаться при выборе валюты (для этого в prompt’e, напомню, используется галочка Constrain). На эту функцию устанавливается обработчик onClick для чекбоксов.
• initCurrencyChk – функция инициализирует значения чекбоксов на основании значения prompt’а HIDDEN_CURRENCY

Теперь немного о том, как сделать элемент HIDDEN_CURRENCY спрятанным. Для этого была написана javascript-функция hideElements, которая ищет на странице элементы <input>, и у которых в innerHTML элемента parentNode.previousSibling.previousSibling содержит подстроку HIDDEN. Т.е. ищутся input’ы, лежащие рядом с заголовками, которые мы специально помечаем префиксом HIDDEN в названии. У найденных элементов в стили дописывается display:none. Вызов этой функции нужно вставить в файл ajax.js в самый конец обработчика sawr.iFrameConnection._onLoad. Файл этот лежит на сервере, путь к нему зависит от того, используется ли OC4J или AS. На моем лэптопе этот файл лежит в папках c:\oracle\biee\oc4j_bi\j2ee\home\applications\analytics\analytics\res\b_mozilla\common\ и c:\oracle\biee\web\app\res\b_mozilla\common\.

Наконец, на дэшбород положен Static Text под названием Hide, в котором однократно вызываются функции initCurrencyChk и hideElements.

Вот собственно и все. Не самый простой путь, требующий неплохого знания html и javascript, но игра часто стоит свеч.

На семинаре демонстрировался Oracle Data Miner - инструмент аналитика для подготовки данных, разработки моделей (классификации, кластеризации и т.п.), оценки качества построенных моделей и применения моделей. Конкретно применения построенных моделей вызвало у слушателей большой вопрос. Дело в том, что сам Data Miner - это именно рабочее место аналитика, в нем модель можно применить только пакетно к какой-то таблице и на выходе получить другую таблицу. Понятно, что это не очень технологично.

А как сделать real-time скоринг и встроить его в какую-то систему (например в те же отчеты Oracle BI)? Здесь уже придется использовать API для java или для SQL. Есть специальное расширение ораклового SQL для применения моделей ODM’а, включающее такие функции как PREDICTION, PREDICTION_PROBABILITY и другие. Много примеров есть здесь. И есть интересная статья из трех частей о построении скоринговой системы на базе Oracle Data Mining.

Дело в следующем. Если создать EPT с помощью приведенного в документации скрипта, то опрос этой таблицы BI Server не выполняет, а в NQServer.log пишется сообщение об ошибке [56001] The cache polling event table … has an incorrect schema. Похоже при проверке структуры таблицы используются не названия столбцов, а их номера по порядку. А порядок в скрипте и на физическом уровне метаслоя разный - в метаслое столбцы отсортированы по алфавиту.

Проблема решается, если создавать EPT с помощью немного модифицированного скрипта. Например, так:

create table EPT
(
  f1_UpdateType Integer not null,
  f2_UpdateTime date default sysdate not null,
  f3_DBName char(40) null,
  f4_CatalogName varchar(40) null,
  f5_SchemaName varchar(40) null,
  f6_TableName varchar(40) not null,
  f7_Other varchar(80) default null
);

OMB+> source c:\\oracle\\owb_scripts\\insert_filter.tcl
OMB+> OMBCC ‘/MY_PROJECT/SH2′
Context changed.
OMB+> insert_filter MAPPING LOAD_SALES SALES FLT
OMB+> OMBCOMMIT
Commit complete.


Далее сам скрипт:

proc insert_filter {map_type map_name src_op_name flt_op_name {flt_cond “”}} {

    # создаем фильтр
    OMBALTER $map_type ‘$map_name’ ADD FILTER OPERATOR ‘$flt_op_name’

    if {$flt_cond != “”} {
        OMBALTER $map_type ‘$map_name’ MODIFY OPERATOR ‘$flt_op_name’ SET PROPERTIES (FILTER_CONDITION) VALUES ($flt_cond)
    }

    # ищем в операторе src_op_name  исходящую группу и копируем её атрибуты в фильтр
    set l_groups [OMBRETRIEVE $map_type ‘$map_name’ OPERATOR ‘$src_op_name’ GET GROUPS]
    foreach g $l_groups {

        set grp_direction [OMBRETRIEVE $map_type ‘$map_name’ OPERATOR ‘$src_op_name’
                             GROUP ‘$g’ GET PROPERTIES (DIRECTION)]
        if {$grp_direction == 1} {
            continue
        }

        set l_atts [OMBRETRIEVE $map_type ‘$map_name’ OPERATOR ‘$src_op_name’ GROUP ‘$g’ GET ATTRIBUTES]
        OMBALTER $map_type ‘$map_name’ ADD CONNECTION 
            FROM GROUP ‘$g’ OF OPERATOR ‘$src_op_name’ TO GROUP ‘INOUTGRP1′ OF OPERATOR ‘$flt_op_name’ COPY ALL
        break
    }

    # цикл по всем операторам, подключенные к src_op_name
    set l_trg_ops [OMBRETRIEVE $map_type ‘$map_name’ GET OPERATORS CONNECTED FROM OPERATOR ‘$src_op_name’]
    foreach trg_op $l_trg_ops {
        if {$trg_op == $flt_op_name} {
            continue
        }

        # цикл по всем группам оператора
        set l_trg_groups [OMBRETRIEVE $map_type ‘$map_name’ OPERATOR ‘$trg_op’ GET GROUPS]
        foreach trg_grp $l_trg_groups {

            set l_src_attrs []
            set l_trg_attrs []

            # запоминаем все соединения между оператором src_op_name и текущей группой текущего оператора
            foreach a $l_atts {
                set l_connected [OMBRETRIEVE $map_type ‘$map_name’ OPERATOR ‘$trg_op’ GROUP ‘$trg_grp’
                                     GET ATTRIBUTES CONNECTED FROM ATTRIBUTE ‘$a’ OF GROUP ‘$g’ OF OPERATOR ‘$src_op_name’]
                foreach conn $l_connected {
                        lappend l_src_attrs $a
                        lappend l_trg_attrs $conn
                }
            }

            # удаляем соединения из исходного оператора к текущему
            for {set i 0} {$i < [llength $l_src_attrs]} {incr i} {
                OMBALTER $map_type ‘$map_name’ DELETE CONNECTION
                        FROM ATTRIBUTE ‘[lindex $l_src_attrs $i]’ OF GROUP ‘$g’ OF OPERATOR ‘$src_op_name’
                        TO ATTRIBUTE ‘[lindex $l_trg_attrs $i]’ OF GROUP ‘$trg_grp’ OF OPERATOR ‘$trg_op’
            }

            # создаем аналогичные соединения из фильтра
            for {set i 0} {$i < [llength $l_src_attrs]} {incr i} {
                OMBALTER $map_type ‘$map_name’ ADD CONNECTION
                        FROM ATTRIBUTE ‘[lindex $l_src_attrs $i]’ OF GROUP ‘INOUTGRP1′ OF OPERATOR ‘$flt_op_name’
                        TO ATTRIBUTE ‘[lindex $l_trg_attrs $i]’ OF GROUP ‘$trg_grp’ OF OPERATOR ‘$trg_op’
            }

        # конец цикла по группам оператора
        }

    # конец цикла по операторам    
    }

}

Итак, случай первый. Пару месяцев назад я делал демонстрационный пример для одной компании: мне нужно было настроить в OBI модель с замерами различных показателей нефтяных скважин (дебет жидкости, обводненность и т.д.) Я построил на логическом уровне таблицу фактов MEASUREMENTS c одним показателем Qp (дебет жидкости), образмерил её таблицами DM_TIME и DM_WELL (скважины). Затем я наполнил таблицы тестовыми данными:

Замеры по одной и той же скважине за разные дни должны усредняться. Замеры, проведенные в один и тот же день для разных скважин, должны суммироваться. Для настройки правил агрегации я открываю в BI Administration Tool свойства логической колонки Qp, на вкладке Aggregation устанавливаю галочку Based on dimensions, и устанавливаю правило агрегации AVG для измерения DM_WELLDim, и SUM для DM_TIMEDim.

Для вычисления общего итога по всем скважинам за месяц необходимо сперва вычислить средний дебет жидкости по каждой скважине, а затем просуммировать получившиеся значения. Здесь важен порядок, в котором указаны измерения. Но если попытаться вывести в отчет одновременно оба итога, то мы увидим ошибочный результат.

Здесь итоги по дням (значения в нижей строчке) считаются верно. Также правильно посчитан общий итог (правая нижняя ячейка): 374 = AVG(250+230+240) + AVG(130+138)=240+134=374. А вот итог по скважинам (правый столбец) посчитан неправильно - выводится сумма вместо среднего. В других подобных экспериментах я получал подобные некорректные результаты, вплоть до ошибки [nQSError: 46036] Internal Assertion.

Для решения этой проблемы можно использовать следующий обходной маневр. Дело в том, что BI Server пускает один SQL-запрос к базе данных, которым получаются как детальные значения отчета, так и вычисляются итоги, и именно этот запрос генерируется неправильно. Можно в Administration Tool открыть на физическом уровне свойства базы данных, и снять опцию SUBTOTALLING_SUPPORTED. И тогда для вычисления итогов BI Server будет пускать к базе данных отдельный запрос, что легко проверить посмотрев в NQQuery.log.

В итоге после отключения опции мы получаем верный отчет.

Теперь о другом примере. Представим себе таблицу транзакций по переводу сумм со счета на счет. Так же представим, что транзакции возникают не сами по себе, а порождаются документами. Один документ может породить несколько транзакций, и все транзакции одного документа имеют одинаковые суммы. Таблица фактов создается следующим скриптом:

create table TRANSACTIONS
(
DOCUMENT_IS INTEGER,
ACCOUNT_ID_FROM INTEGER,
ACCOUNT_ID_TO INTEGER,
AMOUNT INTEGER
);

Рассмотрим следующие детальные данные:

Предположим, что в отчетах требуется для определенного счета получать два показателя - “Сумма по транзакциям” и “Сумма по документам”. Сумму по транзакциям нужно вычислять как сумму всех транзакций, в которых участвовал счет. Сумму по документам нужно вычислять аналогично, но при этом брать сумму для каждого документа только один раз. Например в приведенных данных для счета 100 сумма по транзакциям должна составлять 190, а сумма по документам 120.

Для удовлетворения описанных требований поступим следующим образом. Для логической колонки AMOUNT установим правило агрегации SUM - это будет наша “Сумма по транзакциям”. Затем продублируем колонку AMOUNT (Right Click -> Duplicate), назовем новую колонку AMOUNT_BY_DOCUMENT, и для неё установим правило агрегации как MIN по всем измерениям, за исключением SUM по документам:

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

PS Все описанное проверялось на OBI 10.1.3.3.1 и Oracle Database 10.2.0.1

Итак, по-порядку. Я создал в OID нового пользователя, допустим Vasya. Пытаюсь зайти под этим пользователем в BI Presentation Services и  получаю отлуп: выводится сообщения You are not currently logged in to the Oracle BI Server. Смотрю в NQServer.log и вижу сообщение типа Initialization block “Authentication” has failed. И никакого описания почему он failed. Запускаю Administration Tool, открываю этот init-block, нажимаю кнопку Test - блок отрабатывает нормально, атрибуты пользователя из OID вытаскиваются. У меня ступор и разглядывание экрана на 10 минут.

Потом оказалось, что в самом репозитории уже имелcя пользователь Vasya, что и вызывало ошибку. Пользователь там появился для целей тестирования, когда репозиторий еще был на этапе разработки. А при переносе на боевой сервер забыли почистить лишнее.

В принципе сам процесс настройки описан в документации (Deployment Guide и Publisher User Guide). Я расскажу лишь о некоторых затруднительных моментах (хотя может это только меня они на некоторое время вводили в ступор).

Итак, начну с того, что для интеграции в SSO нужно разворачивать BI не в Standalone OC4J, а в Application Server. Для этого нужно установить на машине Oracle AS версии 10.1.3.1 или выше, а затем в процессе инсталляции выбрать Advanced Installation и указать путь к AS. После установки оказалось, что в AS задеплоились все компоненты, кроме паблишера. Нужно зайти в Enterprise Manager и задеплоить xmlpserver.ear ручками. Не всегда это может получиться - на одной машине процесс деплоя зависал, а в логах в %AS_HOME%\opmn\logs\ и %AS_HOME%\j2ee\<OC4J_name>\log\ можно было видеть сообщения об ошибках, какие-то конфликты имен классов, и прочее. Пришлось поиграть с настройками Deployment Plan в разделе Configure Class Loading. После того, как паблишер задеплоен, то при попытке логина может происходить ошибка, при которой вываливается сообщение oracle.apps.xdo.servlet.resources.ResourceNotFoundException: %s_Reports_Path%/Admin/Security/principals.xml. Для того чтобы это исправить, надо найти конфигурационный файл, в котором присутствует строка s_Reports_Path и подправить её на правильный путь к каталогу паблишера.

Далее интеграция с OID и SSO была настроена по документации, без особых проблем. Случилась только одна пакость. Когда я создавал пользователя Impersonator, я задал ему пароль secret на первое время (собственно, как в доке). Но при установке BI в режиме Advanced Installation в файле NQSConfig.ini устанавливается настройка MINIMUM_PASSWORD_LENGTH = 8. Пользователя-то я создал, но вот позже происходила ошибка, когда PresentationServer коннектился к BI Server от имени этого пользователя. Внешне это выглядело следующим образом: я открывал браузер, заходил в дэшборды, появлялся logon-экран SSO, я вводил логин/пароль, и меня сразу перекидывало на страничку с сообщением You are not currently logged in to the Oracle BI Server.

Надеюсь, кому-нибудь это сэкономит время.

На практике может возникнуть (и возникла) ситуация, когда на одном сервере ведется разработка двух проектов. Таким образом можно под каждый проект создать по rpd-файлу, а также поднять два презентационных сервера на каждый проект. Некоторые товарищи уже пробовали провернуть подобное под unix http://www.be-ice.eu/2007/09/11/managing-multiple-presentation-services-on-the-same-unix-box/#comments. У меня возникла задача провернуть подобное под Windows.

Presentation Services состоит из основного процесса (sawserver.exe) и плагина Presentation Services Plug-in, который суть джава сервлет. Основной процесс и плагин общаются между собой по TCP по порту 9710. У меня в результате установки, очевидно, уже был установлен сервлет, а основной процесс запускался в виде сервиса. Нужно было поднять аналогичную конструкцию по другому порту. Для этого я подправил в файле %SAROOTDIR%\web\app\WEB-INF\web.xml параметр oracle.bi.presentation.sawserver.Port на значение 9711. Затем, находясь в папке %SAROOTDIR%\web я выполнил команду “jar -cf analytics.war -C app .”, с помощью которой пересоздал файл analytics.war. Потом я зашел в веб-консоль OC4J и задеплоил свежесгенерированный war-файл, установив Context Root=analytics1.

Затем в папке %SAROOTDIR%\server\Repository я создал два репозитория с названиями paint1.rpd и paint2.rpd. Оба репозитория я подключил в NQSConfig.ini:

[ REPOSITORY ]
Star1    =    paint1.rpd, DEFAULT;
Star2    =    paint2.rpd;

Потом я перезапустил BI Server.

Далее, я создал два odbc-источника, назвал их AnalyticsWeb1 и AnalyticsWeb2, в настройках указал соответствующие репозитории:

Далее, в папке %SADATADIR%\web я создал две папки для веб-каталогов с навзаниями catalog1 и catalog2 - каждый Presentation Services должен иметь свой веб-каталог для хранения описания дэшбордов и отчетов. Затем в %SADATADIR%\web\config я откопировал файл instanceconfig.xml два раза, назвав их instanceconfig1.xml и instanceconfig2.xml. Начало первого файла я отредактировал следующим образом:

<WebConfig>
   <ServerInstance>
   <DSN>AnalyticsWeb1</DSN>
   <Listener port=”9710″ />
   <JavaHome>C:\Program Files\Java\jdk1.5.0_05</JavaHome>
   <CatalogPath>C:/oracle/OracleBIData/web/catalog1/paint</CatalogPath>

Второй начинался так:

<WebConfig>
   <ServerInstance>
   <DSN>AnalyticsWeb2</DSN>
   <Listener port=”9711″ />
   <JavaHome>C:\Program Files\Java\jdk1.5.0_05</JavaHome>
   <CatalogPath>C:/oracle/OracleBIData/web/catalog2/paint</CatalogPath>

В этих файлах я указал путь к веб-каталогу, odbc-источник, а так же порт, по которому сервер слушает запросы от плагина. Основной процесс sawserver я запустил не в виде сервиса, а просто как приложение из командной строки. Первый я запускал так:

copy c:\oracle\OracleBIData\web\config\instanceconfig1.xml c:\oracle\OracleBIData\web\config\instanceconfig.xml
c:\oracle\oraclebi\web\bin\sawserver.exe

Второй соответственно:

copy c:\oracle\OracleBIData\web\config\instanceconfig2.xml c:\oracle\OracleBIData\web\config\instanceconfig.xml
c:\oracle\oraclebi\web\bin\sawserver.exe

В итоге я добился того, что по адресу http://edemyanov:9704/analytics/ я получал доступ к презентационному серверу, работающему с репозиторием paint1.rpd, а по адресу http://edemyanov:9704/analytics1/ я работал с репозиторием paint2.rpd.