Post on 04-Feb-2021
IBM Cognos Express Xceleratorバージョン 10.1.0
開発者ガイド
���
ご注意本書および本書で紹介する製品をご使用になる前に、 221ページの『特記事項』に記載されている情報をお読みください。
製品情報
このマニュアルは IBM Cognos Express バージョン 10.1.0 を対象として作成されています。また、その後のリリースも対象となる場合があります。このマニュアルの最新バージョンに関する情報は、IBM Cognos インフォメーション・センター (http://publib.boulder.ibm.com/infocenter/cogic/v1r0m0/index.jsp) で見ることができます。
Microsoft 製品のスクリーン・ショットは、Microsoft Corporation の許可を得て転載しています。
お客様の環境によっては、資料中の円記号がバックスラッシュと表示されたり、バックスラッシュが円記号と表示されたりする場合があります。
原典: IBM Cognos Express XceleratorVersion 10.1.0
Developer Guide
発行: 日本アイ・ビー・エム株式会社
担当: トランスレーション・サービス・センター
第1刷 2012.5
Licensed Materials - Property of IBM
© Copyright IBM Corporation 2007, 2012.
http://publib.boulder.ibm.com/infocenter/cogic/v1r0m0/index.jsp
目次
はじめに . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix
第 1 章 Xcelerator 開発の概要 . . . . . . . . . . . . . . . . . . . . . . . . . . 1マルチディメンションについて . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Durables キューブ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1開発者としての役割 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3Xcelerator オブジェクトの命名規則について . . . . . . . . . . . . . . . . . . . . . . . . . 3予約文字 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3規則ステートメント . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4オブジェクト名前付けの例外 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
第 2 章 キューブとディメンションの作成 . . . . . . . . . . . . . . . . . . . . . . 7キューブの設計 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7ディメンション数の選択 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8ディメンション階層を使用した詳細の集約 . . . . . . . . . . . . . . . . . . . . . . . . 10要素のタイプ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13要素の属性 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13キューブの設計 - まとめ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
ディメンションの作成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17ディメンション・エディター・ウィンドウを使用したディメンションの作成 . . . . . . . . . . . . . 18ディメンションの変更 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19ディメンション・エディターでの要素の表示の管理 . . . . . . . . . . . . . . . . . . . . . 25ディメンション・ワークシートを使用したディメンションの作成 . . . . . . . . . . . . . . . . 27Xcelerator ディメンションへの名前付き階層レベルの使用 . . . . . . . . . . . . . . . . . . . 32
キューブの作成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34キューブ内でのディメンションの順序設定 . . . . . . . . . . . . . . . . . . . . . . . . 35キューブの作成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35キューブ内でのディメンションの順序の最適化 . . . . . . . . . . . . . . . . . . . . . . 37キューブのプロパティーの編集 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
選択リストの作成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39選択リストの使用上の注意 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39選択リストのタイプ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40要素属性で選択リストを作成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40コントロール・キューブで選択リストを作成 . . . . . . . . . . . . . . . . . . . . . . . 41選択リストの Null 値 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43選択リスト優先順 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
サーバー間のキューブの複製 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44キューブの関係 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44サーバーの関係 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
第 3 章 ビジネス・データの高度な計算 . . . . . . . . . . . . . . . . . . . . . . 47キューブの規則の概要 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47Xcelerator 規則ステートメントを記述するためのガイドライン . . . . . . . . . . . . . . . . . . 48一般的な考慮事項 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48Area を記述する構文 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48書式の構文 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49キューブ参照の使用 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52規則ステートメントの配置 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53N: レベルと C: レベルでの異なる規則の指定 . . . . . . . . . . . . . . . . . . . . . . . 54規則のバイパス . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
© Copyright IBM Corp. 2007, 2012 iii
要素名の修飾 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55規則エディターと規則ワークシート . . . . . . . . . . . . . . . . . . . . . . . . . . . 55規則ワークシートの作成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56規則ワークシートの保存 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
規則とディメンションの集約 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57計算の順序 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57C: レベル要素の規則による上書き . . . . . . . . . . . . . . . . . . . . . . . . . . . 57規則の積み上げ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
サンプル・アプリケーション . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59比率の計算 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60キューブ間におけるデータの共有 . . . . . . . . . . . . . . . . . . . . . . . . . . . 62規則の単純な値への制限 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64平均価格の計算 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 662 つの非対称キューブのリンク . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
ドリルスルー・プロセスおよび規則の作成 . . . . . . . . . . . . . . . . . . . . . . . . . 68ドリル・プロセスの作成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68ドリル・プロセスの編集 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70ドリル・プロセスの削除 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71ドリル割り当て規則の作成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72ドリルスルーの例 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
規則のデバッグ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76計算のトレース . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76フィーダーのトレース . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
第 4 章 Xcelerator アプリケーションでのオブジェクトの構成 . . . . . . . . . . . . . 81Xcelerator アプリケーションの概要 . . . . . . . . . . . . . . . . . . . . . . . . . . . 81参照のタイプ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81参照の動作 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82アプリケーション内の参照の表示順序 . . . . . . . . . . . . . . . . . . . . . . . . . 82CXL Web でのアプリケーションと参照の使用. . . . . . . . . . . . . . . . . . . . . . . 83ICAS のアプリケーション・フォルダーとファイル . . . . . . . . . . . . . . . . . . . . . 83
アプリケーションの作成と表示に関するセキュリティー上の考慮事項 . . . . . . . . . . . . . . . . 84アプリケーションの作成と管理 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84最上位レベル・アプリケーションの作成 . . . . . . . . . . . . . . . . . . . . . . . . . 85アプリケーションの名前の変更 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86アプリケーションの削除 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86既存のアプリケーション内でのセカンダリー・レベル・アプリケーションの作成 . . . . . . . . . . . 87
Xcelerator オブジェクト参照のアプリケーションへの追加 . . . . . . . . . . . . . . . . . . . . 87参照を共有にする . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88個人用ビューと個人用サブセットに対する参照をアプリケーションに追加する . . . . . . . . . . . . 89新規オブジェクトの作成と並行した参照のアプリケーションへの追加 . . . . . . . . . . . . . . . 90
ファイル参照のアプリケーションへの追加 . . . . . . . . . . . . . . . . . . . . . . . . . 90共有参照と個人用参照について . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92ICAS にアップロードされたファイルの動作 . . . . . . . . . . . . . . . . . . . . . . . 93ICAS での Excel ファイルの更新 . . . . . . . . . . . . . . . . . . . . . . . . . . . 93ICAS での Excel 以外のファイルの更新 . . . . . . . . . . . . . . . . . . . . . . . . . 94
URL 参照のアプリケーションへの追加 . . . . . . . . . . . . . . . . . . . . . . . . . . 95Xcelerator アプリケーション内のオブジェクト、ファイル、および URL 参照での作業 . . . . . . . . . . 95
Xcelerator アプリケーションのプロパティーの表示 . . . . . . . . . . . . . . . . . . . . . 96Xcelerator アプリケーションからのオブジェクト、ファイル、および URL 参照の削除 . . . . . . . . . 98Xcelerator アプリケーション内のオブジェクト、ファイル、および URL 参照の名前の変更 . . . . . . . . 98Xcelerator アプリケーションによって参照されるソース・オブジェクトの削除 . . . . . . . . . . . . 99
Xcelerator アプリケーションのセキュリティーの管理 . . . . . . . . . . . . . . . . . . . . . 99Xcelerator アプリケーションと参照に関するセキュリティー権限のユーザー・グループへの割り当て . . . . . 99Xcelerator アプリケーションと参照の発行 . . . . . . . . . . . . . . . . . . . . . . . . 101Xcelerator アプリケーションと参照を個人用にする . . . . . . . . . . . . . . . . . . . . . 101
iv IBM Cognos Express Xcelerator バージョン 10.1.0: 開発者ガイド
Xcelerator アプリケーション内の論理グループの表示 . . . . . . . . . . . . . . . . . . . . . 102Xcelerator アプリケーションの CXL Web への発行 . . . . . . . . . . . . . . . . . . . . . 103
Xcelerator Web シートのプロパティーの設定 . . . . . . . . . . . . . . . . . . . . . . . 104CXL Web Server 上の Excel を使用しない Excel ファイルの CXL Web への発行 . . . . . . . . . . 104アップロードされたファイルに対するハイパーリンクの作成 . . . . . . . . . . . . . . . . . . 10616 進文字の 0x1A を含む Web シートの表示 . . . . . . . . . . . . . . . . . . . . . . 106
第 5 章 プロセス・ワークシートによるデータのインポート . . . . . . . . . . . . . 109プロセス・ワークシートの概要 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109プロセス・ワークシートを使用したデータのインポート . . . . . . . . . . . . . . . . . . . . 110最初の入力行の読み取り . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111入力レコードとキューブの構造の比較 . . . . . . . . . . . . . . . . . . . . . . . . . 111IF 書式を使用した変換 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113検索キューブを使用した変換 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113データベース送信 (DBS) 書式の作成 . . . . . . . . . . . . . . . . . . . . . . . . . 117データ・ソースのキューブへの取り込み . . . . . . . . . . . . . . . . . . . . . . . . 119
第 6 章 Xcelerator オブジェクトに対するアクセスの制御 . . . . . . . . . . . . . . 121セキュリティー権限のグループへの割り当て . . . . . . . . . . . . . . . . . . . . . . . . 121異なるオブジェクトのセキュリティー権限の相互作用 . . . . . . . . . . . . . . . . . . . . . 126キューブのセキュリティー保護 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127キューブに関するセキュリティー権限の割り当て . . . . . . . . . . . . . . . . . . . . . 127キューブの予約と解放 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128キューブのロックとロック解除 . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
要素のセキュリティー保護 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129要素に関するセキュリティー権限の割り当て . . . . . . . . . . . . . . . . . . . . . . . 129要素の予約と解放 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130要素のロックとロック解除 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
ディメンションのセキュリティー保護 . . . . . . . . . . . . . . . . . . . . . . . . . . 130ディメンションに関するセキュリティー権限の割り当て . . . . . . . . . . . . . . . . . . . 131ディメンションの予約と解放 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131ディメンションのロックとロック解除 . . . . . . . . . . . . . . . . . . . . . . . . . 132
プロセスのセキュリティー保護 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132プロセスに関するセキュリティー権限の割り当て . . . . . . . . . . . . . . . . . . . . . 133プロセスによるセキュリティー・データの変更許可 . . . . . . . . . . . . . . . . . . . . . 133
日課のセキュリティー保護 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134日課に関するセキュリティー権限の割り当て . . . . . . . . . . . . . . . . . . . . . . . 134
アプリケーションと参照のセキュリティー保護 . . . . . . . . . . . . . . . . . . . . . . . 135セルのセキュリティー保護 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136セル・セキュリティー・コントロール・キューブの作成 . . . . . . . . . . . . . . . . . . . 136規則を使用したセル・レベルのセキュリティーの定義 . . . . . . . . . . . . . . . . . . . . 138
第 7 章 Xcelerator 操作ボタンを使用したワークシート・アプリケーションの構築 . . . . 139概要 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139操作ボタンのワークシートへの追加 . . . . . . . . . . . . . . . . . . . . . . . . . . . 139操作ボタンを設定してプロセスを実行する . . . . . . . . . . . . . . . . . . . . . . . . . 141実行するプロセスの選択 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141プロセス・パラメーターの設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . 142計算用のプロセス・オプションの設定 . . . . . . . . . . . . . . . . . . . . . . . . . 144メッセージ表示のためのプロセス・オプションの設定 . . . . . . . . . . . . . . . . . . . . 144操作ボタンのサーバー名プロパティーの使用 . . . . . . . . . . . . . . . . . . . . . . . 145
操作ボタンを設定して別のワークシートにナビゲートする . . . . . . . . . . . . . . . . . . . 145ターゲット・ワークシートを選択する . . . . . . . . . . . . . . . . . . . . . . . . . 145「タイトル要素を照合」オプションを有効にする . . . . . . . . . . . . . . . . . . . . . 146「現在のブックを置換」オプションの設定 . . . . . . . . . . . . . . . . . . . . . . . . 147ワークシートへの移動後に計算オプションを設定する . . . . . . . . . . . . . . . . . . . . 147
目次 v
操作ボタンを設定して、プロセスを実行しワークシートにナビゲートする . . . . . . . . . . . . . . 147操作ボタンを設定して、ワークシートを再計算または再構築する . . . . . . . . . . . . . . . . . 148Xcelerator アクティブ・フォームでの操作ボタンの動作について . . . . . . . . . . . . . . . . . 148操作ボタンの基本的な動作 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148操作ボタンの追加動作 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
操作ボタンのアピアランスのプロパティーの設定 . . . . . . . . . . . . . . . . . . . . . . 149ナビゲーションとマッピングの高度なオプションの使用 . . . . . . . . . . . . . . . . . . . . 150ソースからターゲットへのマッピングの設定 . . . . . . . . . . . . . . . . . . . . . . . 150ソース値をターゲット・セルにマッピングする例 . . . . . . . . . . . . . . . . . . . . . 152ソース SUBNM をターゲット・セルにマッピングする例 . . . . . . . . . . . . . . . . . . . 153選択した DBRW をターゲット・ワークシートにマッピングする例 . . . . . . . . . . . . . . . 154
既存の操作ボタンの変更 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154既存の操作ボタンのキャプション、背景画像、およびプロパティーの編集 . . . . . . . . . . . . . 154既存の操作ボタンの移動とサイズ変更 . . . . . . . . . . . . . . . . . . . . . . . . . 155
第 8 章 URL API によるカスタム Web アプリケーションの開発 . . . . . . . . . . . 157URL API の概要 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157URL API の基本構文 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157基本 URL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157パラメーター . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158ObjectId パラメーター . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158URL エスケープ文字の使用 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
URL API の基本概念 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159管理ホスト名と CXL Web サーバー名のパラメーターを設定する . . . . . . . . . . . . . . . . 159ユーザーのログオンとログアウトを管理する . . . . . . . . . . . . . . . . . . . . . . . 159CXL Web オブジェクトで操作パラメーターを使用する . . . . . . . . . . . . . . . . . . . 161OpenObject パラメーターを使用して CXL Web オブジェクトを開く . . . . . . . . . . . . . . . 162既存の CXL Web オブジェクトを ObjectId パラメーターで操作する . . . . . . . . . . . . . . . 163
Web シート・オブジェクトへのアクセス . . . . . . . . . . . . . . . . . . . . . . . . . 163Web シート・オブジェクトを開く . . . . . . . . . . . . . . . . . . . . . . . . . . 163Web シート・オブジェクトのタイトル要素を選択する. . . . . . . . . . . . . . . . . . . . 165操作を Web シート・オブジェクトに適用する . . . . . . . . . . . . . . . . . . . . . . 165Web シート・オブジェクトの表示プロパティーを設定する . . . . . . . . . . . . . . . . . . 166
Cubeviewer オブジェクトへのアクセス . . . . . . . . . . . . . . . . . . . . . . . . . . 167Cubeviewer オブジェクトを開く . . . . . . . . . . . . . . . . . . . . . . . . . . . 167Cubeviewer オブジェクトの表示プロパティーを設定する . . . . . . . . . . . . . . . . . . . 168Cubeviewer オブジェクトのタイトル要素を選択する . . . . . . . . . . . . . . . . . . . . 169操作を Cubeviewer オブジェクトに適用する . . . . . . . . . . . . . . . . . . . . . . . 170Cubeviewer オブジェクトでグラフを表示する . . . . . . . . . . . . . . . . . . . . . . . 170
Cubeviewer オブジェクトと Web シート・オブジェクトに対するイベント・コールバック関数の設定 . . . . . 173Web シート・オブジェクトと Cubeviewer オブジェクトに対してコールバック関数を有効にする . . . . . 173すべてのタイトル・ディメンションに対してグローバル・コールバック関数を設定する . . . . . . . . . 175
ナビゲーション・ツリー・オブジェクトへのアクセス . . . . . . . . . . . . . . . . . . . . . 176ナビゲーション・ツリー・オブジェクトを開く . . . . . . . . . . . . . . . . . . . . . . 176ナビゲーション・ツリー・オブジェクトを HTML モードで使用する . . . . . . . . . . . . . . . 177ナビゲーション・ツリー・オブジェクトを XML モードで使用する . . . . . . . . . . . . . . . 179
第 9 章 データ予約の使用 . . . . . . . . . . . . . . . . . . . . . . . . . . . 183データ予約の概要 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183他の Xcelerator 機能とのデータ予約の動作について . . . . . . . . . . . . . . . . . . . . . 184データ予約とセキュリティー . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184データ予約と Xcelerator ユーザー・インターフェース . . . . . . . . . . . . . . . . . . . . 185データ予約とデータ・スプレッド . . . . . . . . . . . . . . . . . . . . . . . . . . . 185データ予約と TurboIntegrator プロセスおよび日課 . . . . . . . . . . . . . . . . . . . . . 185データ予約とサンドボックス . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187データ予約、サンドボックス、およびジョブ・キュー . . . . . . . . . . . . . . . . . . . . 187
vi IBM Cognos Express Xcelerator バージョン 10.1.0: 開発者ガイド
データ予約の有効化 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188キューブでのデータ予約の有効化 . . . . . . . . . . . . . . . . . . . . . . . . . . . 188ユーザー・グループによるデータ予約の管理の有効化 . . . . . . . . . . . . . . . . . . . . 189
データ予約のモニター . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190サーバー・エクスプローラーでのデータ予約のセルのステータスの表示 . . . . . . . . . . . . . . 191TM1 Top を使用した、データ予約を待機しているスレッドのモニター . . . . . . . . . . . . . . 191監査ログを使用したデータ予約イベントのモニター . . . . . . . . . . . . . . . . . . . . . 191TurboIntegrator および API 関数を使用したデータ予約のモニター . . . . . . . . . . . . . . . . 192
TurboIntegrator 関数を使用したデータ予約の管理 . . . . . . . . . . . . . . . . . . . . . . 192CubeDataReservationAcquire . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193CubeDataReservationRelease . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194CubeDataReservationReleaseAll . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194CubeDataReservationGet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195CubeDataReservationGetConflicts . . . . . . . . . . . . . . . . . . . . . . . . . . . 197
TM1 API 関数を使用したデータ予約の管理 . . . . . . . . . . . . . . . . . . . . . . . . 198TM1DataReservationAcquire . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198TM1DataReservationRelease . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199TM1DataReservationReleaseAll . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200TM1DataReservationGetAll . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201TM1DataReservationGetConflicts . . . . . . . . . . . . . . . . . . . . . . . . . . . 202TM1DataReservationValidate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202データ予約の API エラー・コード . . . . . . . . . . . . . . . . . . . . . . . . . . 203
付録 A. サポートされている Excel 関数 - CXL Web . . . . . . . . . . . . . . . . 205サポートされている関数 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205日付と時間関数 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205財務関数 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206情報関数 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206論理関数 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207検索/行列関数 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207数学/三角関数 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208文字列操作関数 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210統計関数 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211
付録 B. サポートされていない Excel 関数 - CXL Web . . . . . . . . . . . . . . . 215データベース/リスト管理関数 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215日付と時間関数 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215財務関数 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216情報関数 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217検索/行列関数 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218数学/三角関数 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218統計関数 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219文字列操作関数 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219
特記事項. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
索引 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225
目次 vii
viii IBM Cognos Express Xcelerator バージョン 10.1.0: 開発者ガイド
はじめに
このマニュアルは、IBM® Cognos® Express® Xcelerator の使用にあたって参照してください。
このマニュアルでは、 IBM Cognos Analytic Server (ICAS) 上でのオブジェクトの作成と保守、セキュリティーの管理、および Xcelerator アプリケーションの開発を行う方法について説明します。また、 Xcelerator セキュリティーの観点を説明します。
情報の検索
IBM Cognos の製品ドキュメント (各国語版のドキュメントを含む) を Web で入手するには、 IBM Cognos インフォメーション・センター (http://publib.boulder.ibm.com/infocenter/cogic/v1r0m0/index.jsp) にアクセスしてください。リリース・ノートはインフォメーション・センターで直接公開され、最新の技術情報と APAR へのリンクを含んでいます。
サンプルに関する特記事項
Great Outdoors 社、GO 営業、Great Outdoors 名の変形、およびプランニング・サンプルは、IBM および IBM 顧客のサンプル・アプリケーションを開発するために使用されたサンプル・データの架空の企業運営を表しています。これらの架空データには、販売取引、商品流通、財務、および人事のサンプル・データが含まれます。実際の名前、住所、電話番号、または取引額との類似は偶発的なものです。また、サンプル・ファイルの中には、手動またはコンピューターで生成された架空のデータ、学術的ソースまたは公共のソースを基に編集された実際のデータ、版権所有者の許可を得て使われているデータなどが、サンプル・アプリケーションを開発するためのサンプル・データとして使用されている場合もあります。参照される製品名は、それぞれの所有者の商標である可能性があります。無断の複写は禁止されています。
ユーザー補助機能
現在この製品では、ユーザー補助機能はサポートされていません。ユーザー補助機能とは、動作が制限されている方、視力の限られた方など、身体の不自由な方に製品をご使用いただけるように支援する機能のことです。
将来予想に関する記述
このマニュアルでは、本製品の現在の機能について説明しています。一部の内容で、現在利用できない項目について言及している可能性があります。これは、将来利用できるようになることを意味するものではありません。そのような内容は、資料、コード、または機能の提供に向けた取り組み、確約、あるいは法律上の義務を意味するものではありません。機能の開発、リリース、時期や機能性は IBM の独自の決定によるものとします。
© Copyright IBM Corp. 2007, 2012 ix
http://publib.boulder.ibm.com/infocenter/cogic/v1r0m0/index.jsp
x IBM Cognos Express Xcelerator バージョン 10.1.0: 開発者ガイド
第 1 章 Xcelerator 開発の概要
このセクションでは、マルチディメンションの概念と IBM Cognos ExpressXcelerator を使用する開発者の一般的な責任について紹介します。
マルチディメンションについてIBM Cognos Xcelerator を使用して作成できるマルチディメンション・データベースによって、ビジネス管理者や財務管理者は、複雑で動的なビジネス・モデルから即時に意味を見いだすことができるようになります。
マルチディメンションを理解するために、米国とカナダで展開している小売チェーン全体の製品販売の分析を試みる小売会社の販売担当副社長を例に説明します。各小売店は、耐久消費財の販売数量、販売金額、および割引を記録しています。
販売は、製品別、シナリオ (実績と予算) 別、地域別、数値データ (数量、販売金額、割引) 別、および週別に分析します。ここで特定したモデルは 5 つのディメンション・モデルです。このディメンションは、データの構成方法やデータ・タイプの追跡方法を特定します。
Xcelerator では、販売分析をキューブと呼ばれる 1 つ以上のマルチディメンション構造に常駐させることができます。一連のキューブがデータベースを形成します。キューブ内の各データ・ポイントは、キューブの各ディメンションの 1 つの要素によって識別されます。例えば、ボストン店の 1 月第 2 週のドライヤーの実際の販売金額です。 Xcelerator キューブには、最低 2 つ、最高 256 のディメンションを含める必要があります。
Durables キューブ次の図では、“Durables”キューブの各ディメンションは、縦線のセグメントで表されています。ディメンション内の要素は、単位間隔で表されています。
© Copyright IBM Corp. 2007, 2012 1
例えば、想定として販売担当副社長が、製品と店舗のパフォーマンスを素早く比較して、必勝戦略と問題点を特定する必要があるものとします。 Xcelerator のマルチディメンション・ビューを使用すると、特別なクエリーを無制限に作成できます。
次の例では、各週の販売の実績金額と予算額を素早く比較できます。“Region”は“Boston”で、製品は“Dryer”モデルです。
ビューを再配置すると、全地域の“Dryer”モデルの販売金額を比較できます。
2 IBM Cognos Express Xcelerator バージョン 10.1.0: 開発者ガイド
本書の後続のセクションでは、 Xcelerator を使用してビューを再構成し、マルチディメンション・データをドリルダウンして分析要件を満たす方法について説明します。
開発者としての役割IBM Cognos Express Xcelerator 開発者は、次の 4 つの主要なタスクを実行する責任があります。
v ビジネス分析機能を保持するキューブを設計および作成する。v 組織全体で共有できるようにキューブの格納場所を決定する。v トランザクション・システムや他のデータ・ソースからデータをキューブにインポートする。
v 平均価格、通貨換算、株価収益率などの計算を実行する書式を作成する。
これらのタスクを実行するには、 Xcelerator データに対するアクセス権限を持つ必要があります。通常、 Xcelerator の管理者がアクセス権限の設定を行います。次のセクションでは、ローカル・サーバーとリモート・サーバーの相違について説明し、リモート・サーバーでのタスクの実行に必要なアクセス権限をリスト表示します。
Xcelerator オブジェクトの命名規則について開発者として、IBM Cognos Express Xcelerator システムで多数のオブジェクトを作成し命名する責任があります。 Xcelerator オブジェクトに名前を付ける場合、次の規則を確認する必要があります。
予約文字この無効な文字リストは、オブジェクトに名前を付ける場合と、規則や規則ステートメントを作成する場合とで異なります。
次の文字は予約されています。 Xcelerator のアプリケーション、キューブ、ビュー、ディメンション、サブセット、プロセス、日課に名前を付ける場合、これらの予約文字は使用できません。
第 1 章 Xcelerator 開発の概要 3
文字 説明
/ スラッシュ
\ バックスラッシュ
: コロン
? 疑問符
" 二重引用符
< より小
> より大
| パイプ
* アスタリスク
注: 中括弧 (}) は、 Xcelerator オブジェクト名の先頭に指定することはできません。
規則ステートメント規則ステートメントの作成に関し、次の文字は予約されています。これらの予約文字は Xcelerator 規則ステートメントには使用できません。
文字 説明
, コンマ
) 閉じ括弧
| パイプ
~ チルダ
; セミコロン
@ アットマーク
"!dimension-name" 構成を使用して規則を作成する場合は、予約文字を使用しないでください。規則の作成に無効なディメンション名は、 , ) | ~ ; @ \ / : * ? " <> です。
詳細については、オブジェクト名前付けの例外を参照してください。
4 IBM Cognos Express Xcelerator バージョン 10.1.0: 開発者ガイド
オブジェクト名前付けの例外次の例外を除き、要素名、クライアント名、グループ名、別名に使用できる文字に制限はありません。
MDX 式
要素名に曲折アクセント記号 (^) を含めることはできない。この文字は、MDX 内の関係の表記に使用されるためです。IBM Cognos Express Xcelerator では、ビューのフィルター処理や動的サブセットの生成を行うために MDX を使用します。従って、要素名に曲折アクセント記号が含まれていると、フィルターを適用する場合や動的サブセットを作成する場合にエラーを発生させる原因になります。
要素名に右角括弧 ( ] ) を含めることができますが、この文字を含む要素名がMDX 式で参照されている場合は、これを二重に指定して文字をエスケープする必要があります。例えば、Array[N] Elements という名前の要素は、MDX 式では[Array[N]] Elements] として参照できます。
Xcelerator 規則
規則の式で使用する場合に、オブジェクト名のいくつかの特殊文字が競合する可能性があるので注意してください。例えば、@ 文字と感嘆符 ! 文字の両方はオブジェクト名に使用できますが、規則の式にも使用されます。
@ 文字は、任意の Xcelerator オブジェクト名で使用できます。ただし、@ 文字はXcelerator 規則では文字列比較演算子となっています。規則で @ 文字を含むオブジェクトを参照する場合、オブジェクト名を一重引用符で囲む必要があります。例えば、products@location という名前のディメンションは、規則では 'products@location'として参照する必要があります。
感嘆符 ! 文字は規則の式にも使用されるので、規則で使用されるオブジェクト名に使用しないでください。例えば、規則 DB 関数は ! ディメンション引数の一部として感嘆符を使用します。
DB(’MarketExchange’,!market,!date)
データ・ディレクトリーとオブジェクト名の最大文字列長
IBM Cognos Analytic Server (ICAS) のデータ・ディレクトリー名とオブジェクト名の組み合わせで表される文字列全体は、256 バイトに制限されます。例えば、データ・ディレクトリーが“C:¥Financial data¥TM1¥”(22 バイト) の場合、オブジェクト名は .cub や .rux などのファイル拡張子を含めて 234 バイトに制限されます。
ビュー、サブセット、アプリケーションなどのいくつかの Xcelerator オブジェクトは、 ICAS のデータ ディレクトリのサブディレクトリに格納されます。この場合、256 バイトの制限は、 ICAS のデータ ディレクトリ、サブディレクトリ、およびオブジェクト名の組み合わせに適用されます。
大文字と小文字を区別する
オブジェクト名には、大文字と小文字の区別はありません。例えば、ディメンション名 actvsbud は ActVsBud と同じです。
第 1 章 Xcelerator 開発の概要 5
オブジェクト名内の空白
すべてのオブジェクト名でスペースが許可されます。ただし、IBM Cognos AnalyticServer (ICAS) ではスペースは無視されます。 ICAS では、ディメンション名 ActVs Bud は、ActVsBud(または actvsbud)と同じと見なされます。
ユーザー名
予約文字を使用したユーザー名は個人用オブジェクトを保存できません。
6 IBM Cognos Express Xcelerator バージョン 10.1.0: 開発者ガイド
第 2 章 キューブとディメンションの作成
IBM Cognos Express Xcelerator では、ビジネス・データをキューブに格納します。このセクションでは、キューブ、およびその構成要素であるディメンションの作成方法について説明します。
注: このセクションに記載されたすべてのタスクでは、 Xcelerator または Architectが必要となります。 Xcelerator Client では、キューブの作成、ディメンションの作成/編集、または複製の設定を行うことはできません。
キューブの設計Xcelerator は、ビジネス分析をキューブに格納します。キューブ内の各セルには、分析で追跡する数値データが含まれています。キューブでは、1 つ以上の数値データに対してデータを格納できます。
キューブは、追跡するデータまたは数値データの構成方法を識別するディメンションを使用して作成します。各ディメンション内の 1 つの要素は、キューブ内の 1つのセルの場所を識別します。
次のキューブの例には、“Product”、“Measures”、および“Month”の 3 つのディメンションが含まれています。販売などの各数値データは、製品と月で構成またはディメンション化されています。例えば、セル値の“30000”は、1 月 (“Jan”) の“Sedan-1”の販売を表します。
Xcelerator では、すべてのディメンションは、数値データを識別する要素を含むかどうか、数値データの構成方法を記述しているかどうかに関係なく同様に処理されます。
© Copyright IBM Corp. 2007, 2012 7
ディメンション数の選択すべてのキューブには、少なくとも 2 つ、最高で 256 のディメンションがあります。例えば、2 ディメンション・キューブは、3 ディメンション以上の他のキューブで値を計算する場合、検索テーブルとして用いるのに最適です。また、為替レートを格納する 2 ディメンション・キューブを使用すると、現地通貨額を報告通貨に変換できます。レートを取得するには、 Xcelerator 規則を使用します。
キューブ内のディメンション数 は、主にデータのディメンションに依存します。損益計算書の勘定科目について検討します。
損益計算書 (千円単位)
会計年度 (2002 年 12 月 31 日)
純売上高 200,000
直接費 35,000
直接労務費 50,000
総利益 115,000
給与 30,000
給与手当 3,500
電気代 5,000
8 IBM Cognos Express Xcelerator バージョン 10.1.0: 開発者ガイド
損益計算書 (千円単位)
会計年度 (2002 年 12 月 31 日)
賃借料 10,000
減価償却費 6,000
収益と費用が係数によってどのように変化するかを調べる場合、勘定科目を次の 2つのグループに分ける必要があります。
v 総利益行より上の勘定科目(例:純売上高、直接費)。“product”、“region”、“scenario”(実績と予算)、および“months”のディメンションで構成できます。
v 総利益行より下の勘定科目 (例:給料手当、電気代、賃借料)。“region”、“scenario”(実績と予算)、および“months”のディメンションで構成できますが、製品のディメンションで構成することはできません。間接費は製品に直接賦課できないため、詳細と同じレベルで分析することはできません。
このディメンションの相違によって、次の 2 つのキューブが提示されます。
v 総利益行より上の勘定科目に対しては、5 つのディメンション・キューブv 総利益行より下の勘定科目に対しては、4 つのディメンション・キューブ
5 つのディメンション・キューブ次の図は、5 つのディメンション・キューブのディメンションと要素を表しています。各ディメンションは、縦線のセグメントで表されています。ディメンション内の要素は、単位間隔で表されています。
第 2 章 キューブとディメンションの作成 9
4 つのディメンション・キューブ次の図は、4 つのディメンション・キューブのディメンションと要素を表しています。各ディメンションは、縦線のセグメントで表されています。ディメンション内の要素は、単位間隔で表されています。
ディメンション階層を使用した詳細の集約データをキューブにインポートすると、特定の詳細レベルにおけるビジネスのスナップショットが得られます。例えば、市区町村別の製品の週単位または月単位の販売データをインポートできます。これらのデータ・ポイントを識別するディメンション要素は、各ディメンション内の単純要素またはリーフ・レベルの要素 (1 週間の販売、1 製品の販売、および 1 市区町村における販売) です。
ディメンション階層を使用すると、数値 データを分析で有意なカテゴリーに簡単に集計できます。各カテゴリーは、ディメンション内の複数の要素に関する詳細の集計に対応します。例えば、毎月の販売金額を合計した四半期要素を作成できます。Xcelerator では、集計を表す要素は、集約要素または集約と呼ばれます。
次の図は、“Region”ディメンションの要素に関する 3 つのレベルの集計を示しています。市区町村は、最下位レベルの詳細 (レベル 0) を表します。市区町村は都道府県集約 (レベル 1) に集計され、さらに地域集約、最終的に Eastern USA 集約 (レベル 3) に集計されます。
10 IBM Cognos Express Xcelerator バージョン 10.1.0: 開発者ガイド
ディメンション階層の移動ディメンション階層は、さまざまなレベルの詳細でデータを分析するためのナビゲーション・パスを提供します。ドリルダウンとは、1 つのディメンションに沿って、より下位の詳細レベルに移動することを指します。例えば、上記の“Region”ディメンションの“New England”からドリルダウンすると、その下の 2 つの都道府県、さらにその下の 4 つの市区町村データにアクセスできます。ドリルアップとは、ディメンション内の合計レベルに移動することです。
重み付けを使用した集約の表現重み付け係数は、集約に対する要素の寄与度を決定します。“Connecticut”販売合計が“Hartford”と“New Haven”の合計であることを示すには、“Hartford”と“New Haven”の両方に、デフォルトの重み付け係数 1.0 を割り当てます。
要素に関連付けられている値を減算して、要素を集約することもできます。例えば、“Net Profit”を“Market Value” - “Acquisition Value”と表現できます。この場合、“Market Value”に重み付け係数 1.0、“Acquisition Value”に重み付け係数 -1.0 を割り当てます。次の表に、集約の 4 つの重み付けの例を示します。
ディメンション 集約要素 集約方法 従属要素 重み付け係数
Account Net Profit 減算 Market Value
Acquisition Value
1.0
-1.0
第 2 章 キューブとディメンションの作成 11
ディメンション 集約要素 集約方法 従属要素 重み付け係数
月 1Quarter 加算 1 月
2 月
3 月
1.0
1.0
1.0
Period Yearly Budget 4-4-5 配布 1 月
2 月
3 月
.07692
.07692
.09615
Region Connecticut 加算 Hartford
New Haven
1.0
1.0
ディメンション内での複数の集計の作成ディメンション内に複数の階層を作成すると、販売や数量などの下位レベルの数値データを複数の方法で集計できます。ディメンション内に複数の集計を作成すると、ディメンション数およびキューブ内の空のセルの数を減らすことができます。
次の例では、“Region”ディメンション内の単純要素である“Hartford”は、地理と管理の 2 つのパスに沿って集計されます。
地理上の集計:
管理上の集計:
12 IBM Cognos Express Xcelerator バージョン 10.1.0: 開発者ガイド
複雑な計算式の作成Xcelerator は、ディメンション内に作成した集約を、割り当てられた重み付け係数によって集計します。要素間の比率を作成するか、要素に関連付けられている値を乗算するには、規則と呼ばれる複雑な計算式を作成する必要があります。次に、Xcelerator 規則を必要とする 2 つの計算式を示します。
v Gross Margin = (Gross Profit / Net Sales) x 100v Sales = (Price x Units)
規則を使用すると、要素を集計することもできます。ただし、特にキューブが大きいか疎らな場合、規則は集約に比べて処理に時間がかかります。疎らなキューブに、空のセルがかなりの割合で含まれています。
規則についての包括的な説明は、「IBM Cognos Analytic Server Rules Guide」を参照してください。
要素のタイプここまで、集計して集約できる単純要素またはベース・レベルの要素について学習してきました。 Xcelerator は、次の 3 つのタイプの要素をサポートしています。
要素 説明
数値 ディメンション内の最下位レベルの詳細を識別します。 Xcelerator では、数値しか含まないキューブでは、最下位レベルのすべての要素が数値として定義されます。
集約 下位レベルの詳細を集計したもの。例えば、“time”ディメンションの“1Quarter”要素を使用すると、年の最初の 3 カ月の販売金額を合計できます。
文字列 セル内のテキスト文字列を格納します。キューブ内のセルの文字列を格納するには、セルを定義している最後のディメンションの要素が文字列要素である必要があります。 Xcelerator では、最後のディメンション以外のディメンションに出現する文字列要素は、数値要素として処理されます。
文字列要素は、通常入力ファイル内のコードを正式な要素名に変換する 2 ディメンション・キューブで使用されます。例えば、アカウント・コードをアカウント名に変換する場合です。
要素の属性要素はキューブ内のデータを識別し、要素の属性は要素自身について記述します。
属性を使用すると、次の操作を実行できます。
v 要素の機能をリスト表示する。例:店舗の面積や自動車モデルのエンジン・サイズ。
v 代替名または別名を提供する。例:総勘定元帳科目の記述名、および現地語版の製品名。
第 2 章 キューブとディメンションの作成 13
v 数値データの表示形式を制御する。通常、キューブ内で追跡する数値データの表示形式を選択します。
「サブセット・エディター」で属性値により要素を選択できます。別名を使用すると、 Xcelerator ダイアログ・ボックスに要素名を表示することもできます。
属性を作成し、属性値を割り当てるには、「属性エディター」を使用します。
記述的な属性次の表に、自動車モデルを記述するサンプル属性を示します。
要素
属性
Horsepower(数値) Engine(テキスト) Audio(テキスト)
Sedan 1 190 V-8 Compact Disc
Sedan 2 140 Inline 4 Cassette / Radio
Sedan 3 120 Inline 4 Cassette / Radio
Sedan 4 180 V-8 Compact Disc
Sedan 5 140 Inline 4 Cassette / Radio
別名属性次の表に、英語の家具名のドイツ語版、スペイン語版、フランス語版を示します。
要素
別名属性
Deutsche Español Français
Chair Stuhl Silla Chaise
Desk Schreibtisch Escritorio Bureau
Lamp Lampe Lámpara Lampe
表示形式の属性「Cube Viewer」ウィンドウでは、数値データは次の表で示す形式で表示されます。
形式名 説明 例
通貨 数値は、通貨記号と指定された小数点以下の桁数(精度) で表示されます。 Xcelerator は、Microsoft Windows の「地域の設定」ダイアログ・ボックスに定義されている通貨記号を使用します。
$90.00
全般 数値は、指定された小数点以下の桁数 (精度) で表示されます。
-90
割合計算 数値は、パーセンテージとして指定された小数点以下の桁数 (精度) で表示されます。
90.00%
14 IBM Cognos Express Xcelerator バージョン 10.1.0: 開発者ガイド
形式名 説明 例
指数 数値は、指数形式で指定された小数点以下の桁数(精度) で表示されます。
9.0e+001
日付 数値は日付文字列(1=1900 年 1 月 1 日) として表示されます。多数の日付形式を利用できます。
2002 年 3 月 31 日
時刻 数値は時刻文字列として表示されます。多数の時刻形式を利用できます。
19:53:30 A
コンマ コンマを大きな数値の適切な場所に配置します。 1,000,000
カスタム ユーザー定義の形式。 カスタム
「属性エディター」ウィンドウを使用すると、キューブ内の各ディメンションのすべての要素に対して表示形式を選択できます。ただし、1 つのディメンション (キューブ内で追跡する数値データ) のみに対して表示形式を選択することをお勧めします。「Cube Viewer」ウィンドウでは、その要素に表示形式が定義されていないセルに適用する、形式を選択することもできます。
「Cube Viewer」ウィンドウで使用される形式は、 Xcelerator では次のように決定されます。
手順1. Xcelerator では、最初に列ディメンションの要素の表示形式が確認されます。ディメンションが積み上げられている場合は、 Xcelerator では下から上方向に確認されます。
2. 形式が見つからない場合、 Xcelerator では行ディメンションの要素の表示形式が確認されます。ディメンションが積み上げられている場合は、 Xcelerator では右から左方向に確認されます。
3. 形式が見つからない場合、 Xcelerator ではタイトル要素の表示形式が確認されます。要素は右から左方向に検査されます。
4. 形式が見つからない場合、 Xcelerator では現在のビューの形式が適用されます。
Xcelerator でキューブの数値データにこの形式を確実に適用するには、数値データを含むディメンションを一番下の列ディメンションに配置します。
行または列の表示形式の設定単一列または単一行内の数値を書式設定する場合があります。例えば、小数点以下2 桁までの値を持つ列または行の数値であっても、小数点なしの整数として表示した方が適切な場合があります。単一列または単一行内の数値を書式設定するには、「属性エディター」を使用します。
“Month”ディメンションは、ビューの列に表示されます。列ディメンションに割り当てた表示形式によって、行ディメンションに選択した表示形式は上書きされます。
最初のタスクとして、“Month”ディメンションの“Year”要素に表示形式が適用されていないことを確認します。次の手順に従います。
第 2 章 キューブとディメンションの作成 15
手順1. “SalesPriorCube”の“Format”ビューを開きます。
2. サーバー・エクスプローラーで、“SalesPriorCube”キューブを拡張して、ディメンションが表示されるようにします。
3. “Month”ディメンションを右クリックし、「要素属性の編集」を選択します。
「属性エディター」が開きます。
“Month”ディメンションに“Format”属性値がないことに注意してください。これで、行ディメンションに設定した表示形式が Cube Viewer (またはスプレッドシート内ブラウザー) で優先されることを確認できます。
4. 「キャンセル」をクリックして、属性エディターを閉じます。
このタスクでは、次の手順に従って、“Units”行内の数値を小数点以下 0 桁の整数として書式設定します。
5. サーバー・エクスプローラーで、“Account1”ディメンションを右クリックし、「要素属性の編集」を選択します。
「属性エディター」が開きます。
6. “Units”要素行と「表示形式」列の交点にあるセルをクリックします。
7. 「書式」ボタンをクリックします。
「数値の形式」ダイアログ・ボックスが開きます。
8. 「コンマ」カテゴリーを選択し、「精度」ボックスに「0」と入力して、「OK」をクリックします。
9. 「属性エディター」ダイアログ・ボックスの「OK」をクリックします。
10. 「再計算」 をクリックして、Format ビューを再計算します。
Units の値が小数点なしの整数として表示されます。
属性と要素単一要素の複数の属性値をリスト表示する場合、追加要素または追加ディメンションの作成を検討してください。例えば、外装色は自動車モデルの 1 つの属性です。赤色のモデルは、他の色のモデルよりよく売れます。自動車ごとに 1 つの要素、各色の要素を持つもう 1 つのディメンションを作成する場合、 Xcelerator を使用して色別の自動車販売を追跡できます。販売を単一モデルに合算すると、貴重な詳細を失う可能性があります。
別の例を検討します。自動車モデルの表には、エンジン構成の属性カテゴリーがあります。各自動車には、V-8 などの 1 つのエンジン構成があります。複数のエンジン構成のセダンを入手できる場合、エンジン構成ごとに 1 つの要素の作成を検討してください。
キューブの設計 - まとめ次に、キューブを設計する際のガイドラインを示します。
16 IBM Cognos Express Xcelerator バージョン 10.1.0: 開発者ガイド
手順1. ビジネス分析で追跡する数値データをリスト表示する。数値データの例としては、販売金額、販売数量、費用、取得価額、キャンペーン費用などが挙げられます。
2. 数値データを構成またはディメンション化する方法を決定する。ほとんどの分析では、長期にわたって数値データを追跡します。
v 基本の時間間隔は、日数、週数および月数のどれか。v 地理的なディメンションはあるか。v 数値データは、顧客や製品で変わるか。v シナリオ・ディメンション (実績と予算) はあるか。
3. ディメンション要素を集約する方法を決定します。
4. キューブの要素に関連付ける属性のリストを作成する。属性の例としては、店舗の面積、顧客 ID、現地語版の要素名などが挙げられます。
5. キューブ内の数値データの表示形式を定義する。例えば、“Gross Margin”を割合で、“Sales”を通貨額で定義します。
ディメンションの作成ディメンションを作成する場合、ディメンションおよびオプションでディメンション内の階層 (集約) を構成する、リーフ・レベルの要素を識別します。
ディメンションを作成するには、次の 4 つの方法があります。
v ディメンション・エディター - ディメンションの設計時に、要素の追加、および集約の作成と再配置を行います。詳細については、 18ページの『ディメンション・エディター・ウィンドウを使用したディメンションの作成』を参照してください。
v TurboIntegrator - 要素名を ASCII、ODBC、キューブ・ビュー、またはディメンション・サブセットのソースからインポートします。同時に、複数のディメンションを作成し、これらのディメンション内に集約を設定します。詳しくは、「IBM Cognos Analytic ServerTurboIntegrator ガイド」を参照してください。
注: Analytic Server では、Solaris または AIX® 上の Oracle ODBC ソースにアクセスするのに、DataDirect ドライバーが必要です。これらのドライバーはAnalytic Server には付属しておらず、別個に入手する必要があります。
v データの新規キューブへのインポート - TurboIntegrator を使用して、入力行をデータ・ソースからキューブにマッピングします。その後、セル値を提供する入力列とセルの場所を識別する要素を識別します。この処理について詳しくは、「IBM Cognos Analytic ServerTurboIntegrator ガイド」を参照してください。
v ディメンション・ワークシート - これらの変更済み Microsoft Excel ワークシートを使用して、1 つのディメンションの要素および階層関係をリスト表示します。詳細については、 27ページの『ディメンション・ワークシートを使用したディメンションの作成』を参照してください。
第 2 章 キューブとディメンションの作成 17
ディメンション・エディター・ウィンドウを使用したディメンションの作成
このセクションでは、「ディメンション・エディター」ウィンドウを使用して単純な“Area”ディメンションを作成する手順について説明します。“Area”ディメンションの階層に、“New England”集約要素、“Connecticut”、“Massachusetts”、“Vermont” の3 つの単純要素が含まれていることを想定します。
手順1. サーバー・エクスプローラーの「ツリー」ウィンドウで、ディメンションを格納するサーバーの下にある「ディメンション」を選択します。
2. 「ディメンション」→「新規ディメンションの作成」をクリックします。
ディメンション・エディターが開きます。
これで要素をディメンションに追加できます。
3. 「編集」→「要素の挿入」をクリックするか、「兄弟の挿入」 をクリックします。
「ディメンション要素の挿入」ダイアログ・ボックスが開きます。
4. 集約要素を追加するには、次の操作を実行します。
v 「要素名の挿入」フィールドに「New England」と入力します。v 「要素の型」リストから「集約」を選択します。v 「追加」をクリックします。v 「OK」をクリックします。
集約要素である“New England”がディメンションの最初の要素として表示されます。ここで、“New England”要素に 3 つの子要素を追加します。結果として、“New England”が 3 つの子要素の親要素になります。
5. “New England”要素を選択します。
6. 「編集」→「子の挿入」をクリックするか、「子の挿入」 をクリックします。
「ディメンション要素の挿入」ダイアログ・ボックスが開きます。 Xceleratorは“New England”という親名を表示し、作成するすべての要素が“New England”の子になることを示します。
7. 「要素名の挿入」フィールドに「Connecticut」と入力し、「追加」をクリックします。
8. 「要素名の挿入」フィールドに「Massachusetts」と入力し、「追加」をクリックします。
9. 「要素名の挿入」フィールドに「Vermont」と入力し、「追加」をクリックします。
これで、ダイアログ・ボックスに“New England”の 3 つの子が含まれ、それぞれにデフォルトの重み付けとして“1”が設定されます。
10. 「OK」をクリックします。
18 IBM Cognos Express Xcelerator バージョン 10.1.0: 開発者ガイド
ディメンション・エディターに、“New England”の子として新しい要素が表示されます。
11. 「ディメンション」→「保存」をクリックするか、または「保存」 をクリックします。
「ディメンション名を付けて保存」ダイアログ・ボックスが開きます。
12. ディメンション名を入力し、「保存」をクリックします。
ディメンション名には、最大 256 文字まで指定できます。常にディメンションの記述的な名前を使用してください。
新しいディメンションが、サーバーのディメンションのリストに表示されます。
ディメンションの変更ディメンションを作成したら、次の変更を行うことができます。
v 兄弟を既存の要素に追加する。v 子を既存の要素に追加する。v 階層構造を再配置する。例:集約内の要素の再配置v ディメンションから要素を削除する。v 集約から要素を削除する。v 要素のプロパティーを編集する。例:集約内の要素の重み付けの変更v ディメンション内の要素の順序を再配置する。
兄弟を既存の要素に追加するディメンション・エディターで兄弟を既存の要素に追加するには、次の手順を実行します。
手順1. 兄弟を追加する要素を右クリックし、「ディメンション構造の編集」を選択します。
2. 「編集」→「兄弟の挿入」をクリックします。
「ディメンション要素の挿入」ダイアログ・ボックスが開きます。
3. 「要素名の挿入」フィールドに、最初の兄弟の名前を入力します。
4. 適用可能な場合、「要素の重み付け」に該当する値を入力します。
要素のデフォルトの重み付けは“1”です。
5. 「追加」をクリックします。
6. 追加する各兄弟について、手順 3 ~ 5 を繰り返します。
7. 「OK」をクリックします。
Xcelerator は、新しい要素を手順 1 で選択した要素の兄弟として追加します。
第 2 章 キューブとディメンションの作成 19
子を既存の要素に追加するディメンション・エディターで子を既存の要素に追加するには、次の手順を実行します。
手順1. 兄弟を追加する要素を右クリックし、「ディメンション構造の編集」を選択します。
子を単純要素 (リーフ・レベルの要素) に追加すると、その要素は自動的に集約要素になります。
2. 「編集」→「子の挿入」をクリックします。
「ディメンション要素の挿入」ダイアログ・ボックスが開きます。
3. 「要素名の挿入」フィールドに、最初の子の名前を入力します。
4. 適用可能な場合、「要素の重み付け」に該当する値を入力します。
要素のデフォルトの重み付けは“1”です。
5. 「追加」をクリックします。
6. 追加する各子について、手順 3 ~ 5 を繰り返します。
7. 「OK」をクリックします。
Xcelerator は、新しい要素を手順 1 で選択した要素の子として追加します。
ディメンション階層を再配置するディメンション階層内の要素の位置を変更するには、次の手順を実行します。
手順1. 「ディメンション・エディター」で、移動する要素を選択します。
v 単一要素を選択するには要素をクリックします。v 隣接する複数の要素を選択するには、最初の要素をクリックし、Shift キーを押しながら最後の要素をクリックします。または、CTRL キーを押しながらA を押して、表示されているすべての要素を選択することもできます。
v 隣接しない複数の要素を選択するには、Ctrl キーを押しながら各要素をクリックします。
2. 要素をディメンション階層内の新しい場所までドラッグ・アンド・ドロップします。
要素をドラッグすると、カーソルが変化して Xcelerator が要素をドロップする場所を示します。また、ステータス・バーに、 Xcelerator が要素をドロップする場所を示すメッセージが表示されます。
要素を切り取り/貼り付けして、ディメンション階層を再配置することもできます。
ディメンションから要素を削除するディメンションから要素を削除するには、次の手順を実行します。
20 IBM Cognos Express Xcelerator バージョン 10.1.0: 開発者ガイド
手順1. 削除する要素を選択します。
v 単一要素を選択するには要素をクリックします。v 隣接する複数の要素を選択するには、最初の要素をクリックし、Shift キーを押しながら最後の要素をクリックします。
v 隣接しない複数の要素を選択するには、Ctrl キーを押しながら各要素をクリックします。
v 階層レベル、属性値、またはスペル・パターンで要素を選択する方法については、「IBM Cognos Express Xcelerator ユーザー・ガイド」を参照してください。
2. 「編集」→「要素の削除」をクリックします。
確認ダイアログボックスにはディメンション名がリスト表示され、選択したオブジェクトを削除するかどうか尋ねるメッセージが表示されます。削除する場合は、「はい」をクリックし、削除をキャンセルする場合は、「いいえ」または「キャンセル」をクリックします。
集約から要素を削除する集約から要素を削除するには、次の手順を実行します。
手順1. 削除する要素を選択します。
v 単一要素を選択するには要素をクリックします。v 隣接する複数の要素を選択するには、最初の要素をクリックし、Shift キーを押しながら最後の要素をクリックします。
v 隣接しない複数の要素を選択するには、Ctrl キーを押しながら各要素をクリックします。
2. 「編集」,「集約からの要素の削除」をクリックするか、「削除」 をクリックします。
確認ダイアログボックスにはディメンション名がリスト表示され、選択したオブジェクトを削除するかどうか尋ねるメッセージが表示されます。削除する場合は、「はい」をクリックし、削除をキャンセルする場合は、「いいえ」または「キャンセル」をクリックします。
Xcelerator は、集約から要素を削除し、要素の他のインスタンスはすべてディメンション内に保持します。
注: 要素を集約内でのみ定義した場合、 Xcelerator によって要素はディメンションからも削除されます。
要素のプロパティーを編集する要素のプロパティーを編集して、新しい重み付けを集約の要素に割り当てたり、リーフ・レベルの要素の型を変更したりできます。
注: ただし、集約要素の型は変更できず、要素の重み付けを集約のメンバーでない要素のインスタンスに割り当てることもできません。
第 2 章 キューブとディメンションの作成 21
手順1. 要素を選択します。
2. 「編集」→「要素のプロパティー」をクリックします。
「ディメンション要素のプロパティー」ダイアログ・ボックスが開きます。
3. 必要に応じて、「要素の型」リストから新しい要素の型を選択します。
4. 必要に応じて、「要素の重み付け」に新しい重み付けを入力します。
5. 「OK」をクリックします。
ディメンション内での要素の順序の設定Xcelerator では、ディメンション内の要素の順序を設定して、ディメンション内の各要素のインデックス値を決定できます。ディメンション内の最初の要素のインデックス値は 1、2 番目の要素のインデックス値は 2、以降同様になります。
Xcelerator の多くの関数 (ワークシート、規則、および TurboIntegrator) が要素のインデックス値を参照しているため、ディメンション内の要素の順序の設定は重要な機能です。
注: ディメンション内の要素の順序を変更すると、要素のインデックス値を参照する関数から新しい (場合によっては予期しない) 値が返されます。
手順1. ディメンション内で表示する順に要素の順序を設定します。
「ディメンション・エディター」のソート・オプションとドラッグ・アンド・ドロップ機能を使用すると、要素の順序を変更できます。
2. 「ディメンション順序の設定」ボタンをクリックします。
3. 「ディメンション」→「保存」をクリックします。
v ディメンションのソート・プロパティーが「自動」に設定されている場合、Xcelerator ではソート・プロパティーを「手動」に変更するよう要求されます。
v ディメンションのソート・プロパティーが「手動」に設定されている場合は、Xcelerator によってディメンションに追加した要素が「ディメンション・エディター」で手動で配置した場所に挿入されます。
4. 「はい」をクリックして、新しいディメンションの順序を保存し、ディメンションのソート・プロパティーを「手動」に設定します。
ディメンション・エディターにすべてのディメンション要素のサブセットしか表示されない場合でも、要素の順序を設定できます。例えば、ディメンションが大きい場合、ごく少数の要素の順序を変更および設定できます。「ディメンション・エディター」に表示されている要素のサブセットで要素の順序を設定しても、ディメンション全体に影響することに注意してください。
次の例では、サブセットの使用時に要素の順序を設定すると、サブセット・エディター内のディメンション全体にどのように影響するかを示します。
22 IBM Cognos Express Xcelerator バージョン 10.1.0: 開発者ガイド
単純化するために、このサンプル・ディメンションには、名前が 1 文字の 10個の要素を用意していますが、この例で示す概念は、より大きく複雑なディメンションに適用されます。
v av bv cv dv ev fv gv hv i
5. 要素として“c”、“d”、および“g”を選択し、「編集」→「維持」をクリックすると、ディメンション・エディターに選択された要素のサブセットが表示されます。
6. ここで、これら 3 つの要素の順序を変更することにします。“d”を最初の要素にし、“c”を最後の要素にします。
7. 要素が希望の順序で表示されたら、「ディメンション順序の設定」 をクリックします。
ディメンション全体の要素の順序が設定されます。ディメンション全体を確認すると、ディメンション・エディターに次のように表示されます。
v iv av bv dv gv cv ev fv hv i
この例の場合、サブセットの要素の順序を設定すると、新しい順序によってディメンション全体が次のように影響を受けます。
v 要素の順序の設定時にアクティブであった要素のサブセットは、陰影付きのアイコンで表示される。
v 最初のサブセット要素は、最も近接した先行要素を基準としてディメンション内の位置を維持する。
v この例では、“d”が、要素順序の設定時にサブセット内の最初の要素になっている。
第 2 章 キューブとディメンションの作成 23
v 要素“b”が、サブセット要素を除きディメンション内で“d”に最も近接した先行要素であるため、ディメンション構造では、“b”の後に“d”が続く。
v 他のサブセット要素は、ディメンション構造内では、サブセット内の最初の要素に対する相対位置を維持する。
サーバー・エクスプローラーからディメンション要素の順序を設定する:
「ディメンション・エディター」を開かずに、サーバー・エクスプローラーからディメンション要素の順序を設定することもできます。次の 3 つの自動ソート順から、ディメンションのソート・プロパティーを選択することもできます。
v 名前v レベルv 階層
ソート・プロパティーを設定すると、 Xcelerator はディメンションに追加した要素をソート順内の位置に従って挿入します。例えば、「名前」の自動ソート順を設定すると、 Xcelerator によってアルファベット順に新しい要素がディメンションに挿入されます。
手順
1. サーバー・エクスプローラーでディメンションを右クリックします。
2. 「要素の順序の設定」をクリックします。
「ディメンション要素の順序設定」ダイアログ・ボックスが開きます。
3. ソート・タイプを選択します。
ソート・タイプ 説明
自動 「自動ソート基準」オプションの「名前」、「レベル」、および「階層」が有効になります。
手動 ディメンション構造内での現在の位置に従って要素の順序を設定し、ディメンションのソート・プロパティーを「手動」に設定します。
4. 「手動」ソート・タイプを選択した場合、手順 7 に進みます。
5. 「自動ソート基準」オプションを選択します。
ソート基準 説明
名前 アルファベット順に要素をソートします。
レベル 階層レベルで要素をソートします。
階層 ディメンション階層に従って要素をソートします。
6. 適用可能な場合、「ソート順」を選択します。
7. 「OK」をクリックします。
24 IBM Cognos Express Xcelerator バージョン 10.1.0: 開発者ガイド
タスクの結果
これでディメンション要素の順序が設定されました。ディメンションを開くと、要素が手順 5 で指定した「自動ソート基準」オプションに従って要素が順に表示されます。
ディメンション・エディターでの要素の表示の管理ディメンション・エディターには、要素の表示方法を管理できるいくつかの機能が用意されています。例えば、大きなディメンションで作業する場合、特定の階層レベルの要素のみ表示する便利な機能や、要素をアルファベット順に表示する機能などがあります。
ディメンション・エディターで要素の表示を変更する場合、ディメンション構造は変更せず、 Xcelerator が要素をウィンドウに表示する方法を変更するだけです。
以降のセクションでは、ディメンション・エディターでの要素の表示を管理する方法について説明します。
要素の維持ディメンション・エディターで選択した要素のみ表示するには、次の手順を実行します。
手順1. 表示する要素を選択します。
v 単一要素を選択するには要素をクリックします。v 隣接する複数の要素を選択するには、最初の要素をクリックし、Shift キーを押しながら最後の要素をクリックします。
v 隣接しない複数の要素を選択するには、Ctrl キーを押しながら各要素をクリックします。
2. 「編集」→「維持」をクリックするか、または「維持」 をクリックします。
「ディメンション・エディター」に、選択した要素のみ表示されます。
要素の非表示ディメンション・エディターで選択した要素のみ非表示にするには、次の手順を実行します。
手順1. 非表示にする要素を選択します。
v 単一要素を選択するには要素をクリックします。v 隣接する複数の要素を選択するには、最初の要素をクリックし、Shift キーを押しながら最後の要素をクリックします。
v 隣接しない複数の要素を選択するには、Ctrl キーを押しながら各要素をクリックします。
2. 「編集」→「非表示」をクリックするか、または「非表示」 をクリックします。
第 2 章 キューブとディメンションの作成 25
ディメンション・エディターで、選択した要素が非表示になります。他のすべての要素は表示されたままです。
アルファベット順での要素のソートディメンション・エディターでは、要素をアルファベットの昇順または降順にソートすることができます。
ソート順 説明
アルファベット昇順 「編集」→「ソート基準」→「昇順」をクリックするか、「昇順に
ソート」 をクリックします。
アルファベット降順 「編集」→「ソート基準」→「降順」をクリックするか、「降順に
ソート」 をクリックします。
インデックス値による要素のソート「ディメンション・エディター」では、要素をインデックス値に従って昇順または降順にソートすることができます。
ソート順 説明
インデックス値による昇順
「編集」→「ソート基準」→「インデックスの昇順」をクリックす
るか、「インデックスによるソート、昇順」 をクリックします。
インデックス値による降順
「編集」→「ソート基準」→「インデックスの降順」をクリックす
るか、「インデックスによるソート、降順」 をクリックします。
階層順で要素をソートディメンション階層の表示順に要素をソートすることもできます。
ソート・タイプ 説明
ディメンション階層の表示順
「編集」→「ソート基準」→「階層」をクリックするか、「階層
のソート」 をクリックします。
別名による要素の表示ディメンションに対して別名属性を定義した場合、「ディメンション・エディター」で別名により要素を表示できます。
Xcelerator サンプル・データ・ディレクトリー内のディメンションでは、フランス語とドイツ語に対応する別名が定義されているため、すべての要素名を対応する外国語で表示できます。
手順1. ディメンション・エディターで“Month”ディメンションを開きます。
26 IBM Cognos Express Xcelerator バージョン 10.1.0: 開発者ガイド
2. 「表示」→「ツールバー」→「別名」をクリックして、「別名」ツールバーを表示します。
「別名」ツールバーには、「別名を使用」切り替えボタン、および別名を選択できる「別名を選択」リストの 2 つのオブジェクトが含まれています。
3. 「別名を選択」リストから“Monat”(“Month”に対応するドイツ語) を選択します。
4. 「別名を使用」ボタンをクリックします。
タスクの結果
Xcelerator では、デフォルトで別名は表示されません。ディメンション・エディターでは、すべての要素がドイツ語の別名で表示されるようになります。
ディメンション・ワークシートを使用したディメンションの作成ディメンション・ワークシートは、1 つのディメンションの要素および階層関係をリストする、変更済みの Microsoft Excel スプレッドシートです。 Xcelerator は、ディメンション・ワークシート (dimname.xdi) とコンパイル済みファイル(dimname.dim) の 2 つのファイルにワークシート・データを保存します。
v Xcelerator では、「ディメンション・エディター」ウィンドウまたはTurboIntegrator を使用してディメンションを作成する場合、“dimname.dim”(コンパイル済み) ファイルにのみ書き込まれます。
v Xcelerator では、ディメンション・エディターを使用してディメンションを変更する場合、変更内容は .dim ファイルに保存されます。 Xcelerator では、デ�