BIEE11g: Mapviewer + OpenStreetMap как WMS + HttpProxy

    Привет всем!

    Когда-то давно я описал решение по использованию в Oracle BI11g представлений-карт с подложкой от OpenStreetMap

    Сам до сих пор пользуюсь описанной методикой. Но что меня всегда смущало - на клиентских машинах необходим доступ в Интернет. Так как подложка от OSM отображается с помощью javascript, т.е. картинки со всем, что мы привыкли видеть на карте (административные границы; реки и озера; железные и автомобильные дороги; ландшафт...), подгружаются браузером пользователя.

    Это далеко не всегда удобно.

    Сегодня я хочу рассказать как решить эту проблему в OBIEE 11.1.1.6
На скриншоте ниже показан отчет с представлением-картой у пользователя без доступа в Интернет.

1. Создадим карту-подложку 

В режиме администрирования Mapviewer добавим новую карту-подложку с типом External

В свойствах подложки укажем:

1. адрес WMS-ресурса (Web Map Service) - http://osm.wheregroup.com/cgi-bin/mapserv
2. класс адаптера, отвечающего за получение "картинок" от WMS - mcsadapter.WMSAdapter
3. путь до jar-файла с классом-адаптером - c:\Middleware\Oracle_BI1\bifoundation\jee\mapviewer.ear\web.war\WEB-INF\tileserver\mvadapter\mvadapter.jar
4. свойства адаптера (параметры формируемого URL):
• service       -   WMS
• srs             -   EPSG:4326
• format        -   image/png
• map           -   /data/umn/osm/osm_basic.map
• layers         -   OSM_Basic
5. путь до каталога с кешем (полученными картинками-элементами пазла) - c:\Middleware\Oracle_BI1\bifoundation\jee\mapviewer.ear\web.war\tilecache\DWH19.OSM

    На этом можно было бы и закончить. WMS-сервис мы настроили - изображения с базовой подложкой от OpenStreetMap он уже сможет получать (складировать в папку-кеш).

Но только в том случае, если с машины-сервера BI возможен прямой доступ к Интернету.

    На практике же чаще всего используется корпоративный proxy-сервер.

2. Научим BI работать с PROXY

1. Внесем ряд изменений в файл c:\Middleware\user_projects\domains\bifoundation_domain\bin\setDomainEnv.cmd 

(у меня все сервера на Windows, если вы используете *nix, то править нужно setDomainEnv.sh)

Перед строками

set JAVA_OPTIONS=%JAVA_OPTIONS%

@REM SET THE CLASSPATH

добавьте следующие:

@REM Jack Carver start
set JAVA_OPTIONS=%JAVA_OPTIONS% -Dweblogic.net.proxyAuthenticatorClassName=ru.servplus.common.XxProxyAuthenticator
set PRE_CLASSPATH=%WL_HOME%\server\lib\servplus.jar;%PRE_CLASSPATH%

set JAVA_OPTIONS=%JAVA_OPTIONS% -Dhttp.proxyHost=HOST
set JAVA_OPTIONS=%JAVA_OPTIONS% -Dhttp.proxyPort=PORT
set JAVA_OPTIONS=%JAVA_OPTIONS% -Dhttp.proxyUser=USER
set JAVA_OPTIONS=%JAVA_OPTIONS% -Dhttp.proxyPassword=PASSWORD
set JAVA_OPTIONS=%JAVA_OPTIONS% -Dhttp.noProxyHosts="localhost"
@REM Jack Carver end

Разумеется , замените под ваше окружение значения HOST, PORT, USER, PASSWORD.

Также рекомендую прописать в исключениях для прокси (http.noProxyHosts) доменные имена вашего сервера (/ов в случае кластера). Через разделитель |

2. Скопируйте jar-файл servplus.jar в каталог c:\Middleware\wlserver_10.3\server\lib

Внутри servplus.jar класс, предназначенный для аутентификации на прокси.

package ru.servplus.common;

import weblogic.common.ProxyAuthenticator;

public class XxProxyAuthenticator implements ProxyAuthenticator {

 public void init(String proxyHost, int proxyPort, String authType, String loginPrompt) {  
 }

 public String[] getLoginAndPassword() {
  String[] auth = new String[2];
  auth[0] = System.getProperty("http.proxyUser");
  auth[1] = System.getProperty("http.proxyPassword");
  return auth;
 }
}

3. Скорректируем XML определение подложки

    Чтобы безболезненно перейти от прошлой реализации карт к новой. Следует убедиться, что определения карт-подложек совпадают. А именно - равно ли общее количество и свойства каждого уровня детализации.

    Я рекомендую вам просто скопировать значения узлов zoom_levels из существующей рабочей карты и вставить в определение новой WMS-карты.

4. Определим новую карту в Oracle BI

Не забудьте добавить созданную карту-подложку в список доступных для Oracle BI. А также добавьте привязку геометрических слоев (вкладка Layers) к новой карте.

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