URL の構文
特定の IBM® Analytical Decision Management プロジェクトを起動するための独自のカスタム URL を作成して、アプリケーション起動ページを迂回することができます。例えば、IBM SPSS® Modeler Advantage プロジェクトの特定のバージョンの特定のタブを開くことができます。以下の各セクションで、使用可能な URL の構文について詳しく説明します。
この機能は、IBM Analytical Decision Management とのカスタム統合を行う場合に便利です。
username パラメーター、password パラメーター、pass パラメーター、provider パラメーター
これらのパラメーターを併用して認証情報を指定すると、IBM Analytical Decision Management のログイン・ダイアログが表示されなくなります。
username パラメーターは、IBM Analytical Decision Management にログインするためのユーザー名を指定します。
username=<user id>
password パラメーターは、パスワードを指定します。
password=<password>
pass パラメーターは、password パラメーターの代わりに使用することができます。ただし、pass パラメーターの場合、セキュリティー目的で Base 64 エンコードを使用する点が異なります。64 ビット・エンコードを使用すると、パスワードが画面に表示されることはありません。ただし、パスワードは暗号化されません。パスワードの十分なセキュリティーを確保するには、SSL を使用する必要があります。
pass=<base 64 encoded password>
provider パラメーターは、資格情報の検証に使用されるセキュリティー・プロバイダーを指定します。username パラメーターと password パラメーターを使用する場合は、provider の値を指定する必要があります。
provider=<provider>
<provider> は、以下のいずれかの値になります。
- Native: 組み込みのセキュリティー・プロバイダーの場合。
- AD_<name>/<domain>: Active Directory の場合。<name> はシステム内のセキュリティー・プロバイダーの名前で、<domain> は DNS 名前空間です。
- ADL_<name>/<domain>: ローカルのオーバーライドを使用する Active Directory の場合。<name> はシステム内のセキュリティー・プロバイダーの名前で、<domain> は DNS 名前空間です。
- ldap_<name>: OpenLDAP の場合。<name> は、システム内のセキュリティー・プロバイダーの名前です。
スペースなどの特殊文字は、エスケープする必要があります。
http://yourserver:8080/DM/?username=admin&password=mypassword&provider=native
id パラメーターと version パラメーター
id パラメーターと version パラメーターを併用すると、特定のプロジェクト (ストリーム・ファイル) を指定してリポジトリーから開くことができます。
id パラメーターは、開くプロジェクトのリポジトリー・オブジェクト ID を指定します。プロジェクトのオブジェクト ID を調べるには、管理者に問い合わせてください。オブジェクト ID を取得するには、各種の API を使用するか、IBM SPSS Collaboration and Deployment Services Deployment Manager クライアントを使用してファイルを右クリックし、プロパティーを表示します。
version パラメーターは、バージョン・マーカーまたはバージョン・ラベルを使用して、開くプロジェクトのリポジトリー・バージョン を指定します。スペースなどの特殊文字は、エスケープする必要があります。このパラメーターを省略すると、プロジェクトの最新のバージョンが開きます。
id=<object id>
version=m.<version marker>
version=l.<label>
http://yourserver:8080/DM/?id=091e53590d73db3e0000013a5aea9840bf53&version=m.1:2006-12-04%2020:39:17.995
http://yourserver:8080/DM/?id=091e53590d73db3e0000013a5aea9840bf53&version=l.firstVersion
タブのフラグメント
#T_n フラグメントを使用すると、開く IBM Analytical Decision Management アプリケーションのタブ (ページ) を指定することができます。0 は最初のタブを示し、1 は 2 番目のタブを示します (以下同様)。 ホーム・ページを開くには -1 を使用します。このフラグメントはオプションです。指定する場合は、URL の末尾に指定する必要があります。
例えば、IBM SPSS Modeler Advantage を起動して「データ」タブを開くには、#T_0 を指定します。IBM SPSS Modeler Advantage を起動して「モデル作成」タブを開くには、#T_1 を指定します。 起動してホーム・ページを開くには #T_-1 を使用します。
http://yourserver:8080/DM/?id=091e53590d73db3e0000013a5aea9840bf53?username=admin&password=mypassword
&provider=native#T_1
datasourcename パラメーターと datasourcefile パラメーター
datasourcename パラメーターと datasourcefile パラメーターを併用して、指定された名前とソース・ファイルのデータ・ソースを作成するように IBM Analytical Decision Management に対して指示を出します。このデータ・ソースには、デフォルトの設定が使用されます。datasourcefile パラメーターでは、IBM SPSS Modeler Server マシンに存在するファイルの絶対パスを指定する必要があります。#T_ フラグメントと併用して特定のタブを起動する場合は、このデータ・ソースが、指定されたタブのデフォルト・データ・ソースになります。例えば #T_1 の場合、プロジェクトの 2 番目のタブでこのデータ・ソースがデフォルトで選択され、#T_2 の場合は、3 番目のタブでこのデータ・ソースがデフォルトで選択されます。指定したデータ・ソースが既に作成された状態でプロジェクトが開くことに注意してください。データ・ソースが存在しない場合は、IBM Analytical Decision Management によって作成されます。存在する場合は、指定したファイルが IBM Analytical Decision Management によって使用されます (以前のものは置き換えられます)。
これらの設定は、ユーザーが明示的にプロジェクトを保存しない限り保存されません。
&datasourcefile=<full path to data on Modeler Server>
&datasourcename=<name to give data source in UI>
http://yourserver:8080/DM/?id=091e53590d73db3e0000013a5aea9840bf53&datasourcefile= C:¥Program Files¥IBM¥SPSS¥
ModelerServer¥17¥Demos¥DRUG1n&datasourcename=DSDrug#T_2
template パラメーター
http://yourserver:8080/DM/?template=ModelerAdvantage
template=CampaignOptimization
template=ClaimsManagement
template=CustomerInteractionManagement
template=DemandOptimization
template=ModelerAdvantage
template=PredictiveMaintenance
template=RulesManagement
logout パラメーター
このパラメーターは、IBM Analytical Decision Management から強制的にログアウトするために使用します。
http://yourserver:8080/DM/logout
POST メソッドを使用したログイン情報の送信
前記の方法で URL を送信した場合、ユーザー名とパスワードがブラウザーの URL アドレス・バーに表示されます。ユーザー名とパスワードを画面に表示したくない場合は、ユーザー名とパスワードを「post」メッセージの内容の一部として送信します。
JavaScript を使用して、POST データの一部としてユーザー名、パスワード、およびセキュリティー・プロバイダーを渡す HTML の例を以下に示します。この方法では、Base 64 エンコードを使用して情報がエンコードされます。パスワードを暗号化してセキュリティーを確保するには、SSL を使用する必要があります。
このような HTML の例を、関連する JavaScript (*.js ) ファイルとともに使用すると、特定の IBM Analytical Decision Management プロジェクトを起動するボタンを、社内のイントラネットの Web ページに追加することができます。
<html>
<head>
<script type="text/javascript" language="javascript" src="base64.js"></script>
<script type="text/javascript">
function post_to_url(path, parameter, method, user, pass, provider) {
method = method || "post"; // Set method to post by default, if not specified.
// The rest of this code assumes you are not using a library.
// It can be made less wordy if you use one.
var form = document.createElement("form");
form.setAttribute("method", method);
form.setAttribute("action", path + parameter);
if (user != null && pass != null)
{
var userName = Base64.encode(encodeURI(user));
var password = Base64.encode(encodeURI(pass));
var userField = document.createElement("input");
userField.setAttribute("type", "hidden");
userField.setAttribute("name", "username");
userField.setAttribute("value", userName);
form.appendChild(userField);
var passField = document.createElement("input");
passField.setAttribute("type", "hidden");
passField.setAttribute("name", "pass");
passField.setAttribute("value", password);
form.appendChild(passField);
}
if (provider != null)
{
var providerField = document.createElement("input");
providerField.setAttribute("type", "hidden");
providerField.setAttribute("name", "provider");
providerField.setAttribute("value", provider);
form.appendChild(providerField);
}
document.body.appendChild(form);
form.submit();
}
</script>
</head>
<table>
<tr>
<td><button onclick="post_to_url('http://localhost:9084/DM/', '', 'post', 'admin', 'spss', 'Native');">
Test</button> </td>
<td>Post User Info</td>
<td>gethost() + ''</td>
</tr>
</table>
</html>