TM1 for Developerspublic.dhe.ibm.com/.../docs/ja/2.0.0/tm1_dg_dvlpr.pdfTM1 for Developers 注記...

IBM Planning Analytics最終更新: 2017-05-23

TM1 for Developers

��

注記本書および本書で紹介する製品をご使用になる前に、 273ページの『特記事項』に記載されている情報をお読みください。

この資料は IBM Planning Analytics バージョン 2.0.0 を対象として作成されています。また、その後のリリースも対象となる場合があります。

お客様の環境によっては、資料中の円記号がバックスラッシュと表示されたり、バックスラッシュが円記号と表示されたりする場合があります。

　

原典： IBM Planning Analytics

Last updated: 2017-05-23

TM1 for Developers

発行：日本アイ・ビー・エム株式会社

担当：トランスレーション・サービス・センター

Licensed Materials - Property of IBM

© Copyright IBM Corporation 2007, 2017.

目次

はじめに . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix

第 1 章 TM1 開発の概要 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1マルチディメンションについて . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

Durables キューブ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1開発者としての役割 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3TM1 オブジェクトの命名規則 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

第 2 章キューブとディメンションの作成 . . . . . . . . . . . . . . . . . . . . . . 7キューブの設計 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7ディメンション数の選択 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8ディメンション階層を使用した詳細の集約 . . . . . . . . . . . . . . . . . . . . . . . . 9要素のタイプ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13要素の属性 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13キューブの設計 - まとめ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

ディメンションの作成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16ディメンション・エディター・ウィンドウを使用したディメンションの作成 . . . . . . . . . . . . . 17ディメンションの変更 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18ディメンション・エディターでの要素の表示の管理 . . . . . . . . . . . . . . . . . . . . . 24ディメンション・ワークシートを使用したディメンションの作成 . . . . . . . . . . . . . . . . 26TM1 ディメンションへの名前付き階層レベルの使用 . . . . . . . . . . . . . . . . . . . . . 31複数階層の使用 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

キューブの作成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35キューブ内でのディメンションの順序設定 . . . . . . . . . . . . . . . . . . . . . . . . 35キューブの作成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35キューブ内でのディメンションの順序の最適化 . . . . . . . . . . . . . . . . . . . . . . 37キューブのプロパティーの編集 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

選択リストの作成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39選択リストの使用上の注意 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39選択リストのタイプ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40要素属性で選択リストを作成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41コントロール・キューブで選択リストを作成 . . . . . . . . . . . . . . . . . . . . . . . 41選択リストの Null 値 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44選択リスト優先順 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

サーバー間のキューブの複製 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44キューブの関係 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45サーバーの関係 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

第 3 章モデルの翻訳 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47キューブ名の翻訳 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48ディメンション名の翻訳 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49メンバー名の翻訳 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

第 4 章ビジネス・データの高度な計算 . . . . . . . . . . . . . . . . . . . . . . 53キューブの規則の概要 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53TM1 規則ステートメントを記述するためのガイドライン . . . . . . . . . . . . . . . . . . . . 54一般的な考慮事項 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54Area を記述する構文 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54書式の構文 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55キューブ参照の使用 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

© Copyright IBM Corp. 2007, 2017 iii

規則ステートメントの配置 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59N: レベルと C: レベルでの異なる規則の指定 . . . . . . . . . . . . . . . . . . . . . . . 59規則のバイパス . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60要素名の修飾 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

規則エディターと規則ワークシート . . . . . . . . . . . . . . . . . . . . . . . . . . . 61規則ワークシートの作成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61規則ワークシートの保存 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

規則とディメンションの集約 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62計算の順序 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62C: レベル要素の規則による上書き . . . . . . . . . . . . . . . . . . . . . . . . . . . 62規則の積み上げ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64

サンプル・アプリケーション . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64比率の計算 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65キューブ間におけるデータの共有 . . . . . . . . . . . . . . . . . . . . . . . . . . . 67規則の単純な値への制限 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69平均価格の計算 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 712 つの非対称キューブのリンク . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72

ドリルスルー・プロセスおよび規則の作成 . . . . . . . . . . . . . . . . . . . . . . . . . 73ドリル・プロセスの作成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73ドリル・プロセスの編集 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75ドリル・プロセスの削除 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76ドリル割り当て規則の作成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76ドリルスルーの例 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77

規則統計のモニター . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81規則のデバッグ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83計算のトレース . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83フィーダーのトレース . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86

第 5 章 TM1 Applications でのオブジェクトの構成 . . . . . . . . . . . . . . . . . 89TM1 アプリケーションの概要 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89参照のタイプ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89参照の動作 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90アプリケーション内の参照の表示順序 . . . . . . . . . . . . . . . . . . . . . . . . . 90TM1 Web でのアプリケーションと参照の使用. . . . . . . . . . . . . . . . . . . . . . . 91TM1 サーバーのアプリケーション・フォルダーとファイル . . . . . . . . . . . . . . . . . . 91

アプリケーションの作成と表示に関するセキュリティー上の考慮事項 . . . . . . . . . . . . . . . . 92アプリケーションの作成と管理 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92最上位レベル・アプリケーションの作成 . . . . . . . . . . . . . . . . . . . . . . . . . 93アプリケーションの名前の変更 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94アプリケーションの削除 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94既存のアプリケーション内でのセカンダリー・レベル・アプリケーションの作成 . . . . . . . . . . . 95

TM1 オブジェクト参照のアプリケーションへの追加 . . . . . . . . . . . . . . . . . . . . . . 95参照を共有にする . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96個人用ビューと個人用サブセットに対する参照をアプリケーションに追加する . . . . . . . . . . . . 97新規オブジェクトの作成と並行した参照のアプリケーションへの追加 . . . . . . . . . . . . . . . 98

ファイル参照のアプリケーションへの追加 . . . . . . . . . . . . . . . . . . . . . . . . . 98共有参照と個人用参照について . . . . . . . . . . . . . . . . . . . . . . . . . . . 100TM1 サーバーにアップロードされたファイルの動作 . . . . . . . . . . . . . . . . . . . . 100TM1 サーバーでの Excel ファイルの更新 . . . . . . . . . . . . . . . . . . . . . . . . 101TM1 サーバーでの Excel 以外のファイルの更新 . . . . . . . . . . . . . . . . . . . . . 102

URL 参照のアプリケーションへの追加 . . . . . . . . . . . . . . . . . . . . . . . . . . 102TM1 アプリケーション内のオブジェクト、ファイル、および URL 参照での作業 . . . . . . . . . . . 103

TM1 アプリケーションのプロパティーの表示 . . . . . . . . . . . . . . . . . . . . . . 104TM1 アプリケーションからのオブジェクト、ファイル、および URL 参照の削除 . . . . . . . . . . 105TM1 アプリケーション内のオブジェクト、ファイル、および URL 参照の名前の変更 . . . . . . . . . 105TM1 アプリケーションによって参照されるソース・オブジェクトの削除 . . . . . . . . . . . . . 106

iv TM1 for Developers

TM1 アプリケーションのセキュリティーの管理 . . . . . . . . . . . . . . . . . . . . . . . 106TM1 アプリケーションと参照に関するセキュリティー権限のユーザー・グループへの割り当て . . . . . . 106TM1 アプリケーションと参照の発行 . . . . . . . . . . . . . . . . . . . . . . . . . 108TM1 アプリケーションと参照を個人用にする . . . . . . . . . . . . . . . . . . . . . . 108

TM1 アプリケーション内の論理グループの表示 . . . . . . . . . . . . . . . . . . . . . . . 109TM1 アプリケーションの TM1 Web への発行 . . . . . . . . . . . . . . . . . . . . . . . 110

TM1 Web シートのプロパティーの設定 . . . . . . . . . . . . . . . . . . . . . . . . 111アップロードされたファイルに対するハイパーリンクの作成 . . . . . . . . . . . . . . . . . . 11116 進文字の 0x1A を含む Web シートの表示 . . . . . . . . . . . . . . . . . . . . . . 112

第 6 章プロセス・ワークシートによるデータのインポート . . . . . . . . . . . . . 113プロセス・ワークシートの概要 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113プロセス・ワークシートを使用したデータのインポート . . . . . . . . . . . . . . . . . . . . 114最初の入力行の読み取り . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115入力レコードとキューブの構造の比較 . . . . . . . . . . . . . . . . . . . . . . . . . 115IF 書式を使用した変換 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117検索キューブを使用した変換 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117データベース送信 (DBS) 書式の作成 . . . . . . . . . . . . . . . . . . . . . . . . . 121データ・ソースのキューブへの取り込み . . . . . . . . . . . . . . . . . . . . . . . . 123

第 7 章 TM1 オブジェクトに対するアクセスの制御 . . . . . . . . . . . . . . . . . 125セキュリティー権限のグループへの割り当て . . . . . . . . . . . . . . . . . . . . . . . . 125異なるオブジェクトのセキュリティー権限の相互作用 . . . . . . . . . . . . . . . . . . . . . 130キューブのセキュリティー保護 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131キューブに関するセキュリティー権限の割り当て . . . . . . . . . . . . . . . . . . . . . 131キューブの予約と解放 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132キューブのロックとロック解除 . . . . . . . . . . . . . . . . . . . . . . . . . . . 132

要素のセキュリティー保護 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133要素に関するセキュリティー権限の割り当て . . . . . . . . . . . . . . . . . . . . . . . 133要素の予約と解放 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133要素のロックとロック解除 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134

セルのセキュリティー保護 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134セル・セキュリティー・コントロール・キューブの作成 . . . . . . . . . . . . . . . . . . . 135規則を使用したセル・レベルのセキュリティーの定義 . . . . . . . . . . . . . . . . . . . . 137

ディメンションのセキュリティー保護 . . . . . . . . . . . . . . . . . . . . . . . . . . 137ディメンションに関するセキュリティー権限の割り当て . . . . . . . . . . . . . . . . . . . 138ディメンションの予約と解放 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138ディメンションのロックとロック解除 . . . . . . . . . . . . . . . . . . . . . . . . . 138

プロセスのセキュリティー保護 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139プロセスに関するセキュリティー権限の割り当て . . . . . . . . . . . . . . . . . . . . . 139プロセスによるセキュリティー・データの変更許可 . . . . . . . . . . . . . . . . . . . . . 140

日課のセキュリティー保護 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141日課に関するセキュリティー権限の割り当て . . . . . . . . . . . . . . . . . . . . . . . 141

アプリケーションと参照のセキュリティー保護 . . . . . . . . . . . . . . . . . . . . . . . 141

第 8 章 TM1 操作ボタンを使用したワークシート・アプリケーションの構築. . . . . . . 143概要 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143操作ボタンのワークシートへの追加 . . . . . . . . . . . . . . . . . . . . . . . . . . . 143操作ボタンを設定してプロセスを実行する . . . . . . . . . . . . . . . . . . . . . . . . . 145実行するプロセスの選択 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145プロセス・パラメーターの設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . 146計算用のプロセス・オプションの設定 . . . . . . . . . . . . . . . . . . . . . . . . . 148メッセージ表示のためのプロセス・オプションの設定 . . . . . . . . . . . . . . . . . . . . 148操作ボタンのサーバー名プロパティーの使用 . . . . . . . . . . . . . . . . . . . . . . . 149

操作ボタンを設定して別のワークシートにナビゲートする . . . . . . . . . . . . . . . . . . . 149ターゲット・ワークシートを選択する . . . . . . . . . . . . . . . . . . . . . . . . . 149

目次 v

「タイトル要素を照合」オプションを有効にする . . . . . . . . . . . . . . . . . . . . . 150「現在のブックを置換」オプションの設定 . . . . . . . . . . . . . . . . . . . . . . . . 151ワークシートへの移動後に計算オプションを設定する . . . . . . . . . . . . . . . . . . . . 151

操作ボタンを設定して、プロセスを実行しワークシートにナビゲートする . . . . . . . . . . . . . . 151操作ボタンを設定して、ワークシートを再計算または再構築する . . . . . . . . . . . . . . . . . 152TM1 アクティブ・フォームでの操作ボタンの動作について . . . . . . . . . . . . . . . . . . . 152操作ボタンの基本的な動作 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152操作ボタンの追加動作 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153

操作ボタンのアピアランスのプロパティーの設定 . . . . . . . . . . . . . . . . . . . . . . 153ナビゲーションとマッピングの高度なオプションの使用 . . . . . . . . . . . . . . . . . . . . 154ソースからターゲットへのマッピングの設定 . . . . . . . . . . . . . . . . . . . . . . . 154ソース値をターゲット・セルにマッピングする例 . . . . . . . . . . . . . . . . . . . . . 156ソース SUBNM をターゲット・セルにマッピングする例 . . . . . . . . . . . . . . . . . . . 157選択した DBRW をターゲット・ワークシートにマッピングする例 . . . . . . . . . . . . . . . 157

既存の操作ボタンの変更 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158既存の操作ボタンのキャプション、背景画像、およびプロパティーの編集 . . . . . . . . . . . . . 158既存の操作ボタンの移動とサイズ変更 . . . . . . . . . . . . . . . . . . . . . . . . . 158

第 9 章データ予約の使用 . . . . . . . . . . . . . . . . . . . . . . . . . . . 161データ予約の概要 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161データ予約モード . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162他の TM1 機能とのデータ予約の動作について . . . . . . . . . . . . . . . . . . . . . . . 164データ予約とセキュリティー . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164データ予約と TM1 ユーザー・インターフェース . . . . . . . . . . . . . . . . . . . . . 165データ予約とデータ・スプレッド . . . . . . . . . . . . . . . . . . . . . . . . . . . 165データ予約と TurboIntegrator プロセスおよび日課 . . . . . . . . . . . . . . . . . . . . . 165データ予約とサンドボックス . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167データ予約、サンドボックス、およびジョブ・キュー . . . . . . . . . . . . . . . . . . . . 167

データ予約の有効化 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167キューブでのデータ予約の有効化 . . . . . . . . . . . . . . . . . . . . . . . . . . . 168DataReservationMode プロパティー . . . . . . . . . . . . . . . . . . . . . . . . . . 168ユーザー・グループによるデータ予約の管理の有効化 . . . . . . . . . . . . . . . . . . . . 170

データ予約のモニター . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171サーバー・エクスプローラーでのデータ予約のセルのステータスの表示 . . . . . . . . . . . . . . 171TM1 Top を使用した、データ予約を待機しているスレッドのモニター . . . . . . . . . . . . . . 171監査ログを使用したデータ予約イベントのモニター . . . . . . . . . . . . . . . . . . . . . 171TurboIntegrator および API 関数を使用したデータ予約のモニター . . . . . . . . . . . . . . . . 172

TurboIntegrator 関数を使用したデータ予約の管理 . . . . . . . . . . . . . . . . . . . . . . 173CubeDataReservationAcquire . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173CubeDataReservationRelease . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174CubeDataReservationReleaseAll . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175CubeDataReservationGet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176CubeDataReservationGetConflicts . . . . . . . . . . . . . . . . . . . . . . . . . . . 177

TM1 API 関数を使用したデータ予約の管理 . . . . . . . . . . . . . . . . . . . . . . . . 178TM1DataReservationAcquire . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178TM1DataReservationRelease . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179TM1DataReservationReleaseAll . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180TM1DataReservationGetAll . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181TM1DataReservationGetConflicts . . . . . . . . . . . . . . . . . . . . . . . . . . . 182TM1DataReservationValidate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183データ予約の API エラー・コード . . . . . . . . . . . . . . . . . . . . . . . . . . 183

第 10 章セキュリティー・オーバーレイ . . . . . . . . . . . . . . . . . . . . . 185SecurityOverlayCreateGlobalDefault . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185SecurityOverlayDestroyGlobalDefault . . . . . . . . . . . . . . . . . . . . . . . . . . . 186SecurityOverlayGlobalLockNode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187

vi TM1 for Developers

第 11 章 TM1 Web API . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189TM1 Web API セッション・ログオン . . . . . . . . . . . . . . . . . . . . . . . . . . 190セッション・トークン・ログオン . . . . . . . . . . . . . . . . . . . . . . . . . . . 190TM1 セッション ID ログオン . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193session モジュールおよび LoginDialog モジュール . . . . . . . . . . . . . . . . . . . . . 194

TM1 Web URL API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197Cognos TM1 Web URL API の概要 . . . . . . . . . . . . . . . . . . . . . . . . . . 197Cognos TM1 Web URL API 入門. . . . . . . . . . . . . . . . . . . . . . . . . . . 198Cognos TM1 Web URL API の概念 . . . . . . . . . . . . . . . . . . . . . . . . . . 201URL API による Websheet オブジェクトの表示 . . . . . . . . . . . . . . . . . . . . . . 207URL API による CubeViewer オブジェクトの表示 . . . . . . . . . . . . . . . . . . . . . 210以前の URL API プロジェクトを新しい Cognos TM1 Web 10.2.2 URL API にアップグレードする . . . . 214Cognos TM1 Web URL API パラメーター・リファレンス . . . . . . . . . . . . . . . . . . 216

TM1 Web JavaScript ライブラリー . . . . . . . . . . . . . . . . . . . . . . . . . . . 223JavaScript ライブラリーを使用するための必須 HTML <head> および <body> タグ . . . . . . . . . . 225JavaScript Library 用の AMD ローダーの構成 . . . . . . . . . . . . . . . . . . . . . . 225JavaScript ライブラリーによる Websheet オブジェクトのロード . . . . . . . . . . . . . . . . 229JavaScript ライブラリーによる CubeViewer オブジェクトのロード. . . . . . . . . . . . . . . . 230JavaScript ライブラリーのコールバック関数 . . . . . . . . . . . . . . . . . . . . . . . 231JavaScript ライブラリーのプロパティーとメソッドのサンプル・コード . . . . . . . . . . . . . . 233Cognos TM1 Web JavaScript ライブラリーの Workbook クラス. . . . . . . . . . . . . . . . . 236Cognos TM1 Web JavaScript ライブラリーの CubeViewer クラス . . . . . . . . . . . . . . . . 246

付録 A. サポートされている Microsoft Excel 関数 - TM1 Web . . . . . . . . . . . 257日付と時刻関数 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257財務関数 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258情報関数 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259論理関数 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259検索/行列関数 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259数学/三角関数 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260文字列操作関数 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262統計関数 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263

付録 B. サポートされていない Microsoft Excel 関数 - TM1 Web . . . . . . . . . . 267データベース/リスト管理関数 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267日付と時刻関数 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267財務関数 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268情報関数 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269検索/行列関数 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270数学/三角関数 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270統計関数 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271文字列操作関数 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272

特記事項. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273

索引 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277

目次 vii

viii TM1 for Developers

はじめに

この資料は、IBM® Cognos® TM1® を使用する際に参照してください。

この資料では、IBM Cognos TM1 サーバーでのオブジェクトの作成と保守、セキュリティーの管理、および TM1 アプリケーションの開発を行う方法について説明します。また、この資料では TM1 セキュリティーのさまざまな側面についても説明します。

情報の検索

資料 (各国語版のドキュメントを含む) を Web で入手するには、IBM Knowledge

Center (http://www.ibm.com/support/knowledgecenter) にアクセスしてください。

サンプルに関する特記事項

Sample Outdoors 社、Great Outdoors 社、GO 販売、Sample Outdoors または Great

Outdoors の名前のすべてのバリエーション、および Planning サンプルは、IBM および IBM のお客様向けのサンプル・アプリケーションを開発するために使用されるサンプル・データによる架空のビジネス・オペレーションを表します。これらの架空データには、販売取引、商品流通、財務、および人事のサンプル・データが含まれます。実際の名前、住所、電話番号、または取引額との類似は偶発的なものです。また、サンプル・ファイルの中には、手動またはコンピューターで生成された架空のデータ、学術的ソースまたは公共のソースを基に編集された実際のデータ、版権所有者の許可を得て使われているデータなどが、サンプル・アプリケーションを開発するためのサンプル・データとして使用されている場合もあります。参照される製品名は、それぞれの所有者の商標である可能性があります。無断の複写は禁止されています。

ユーザー補助機能

ユーザー補助機能は、運動障害または視覚障害など身体に障害を持つユーザーが情報技術製品を快適に使用できるようにサポートします。

現在この製品では、ユーザー補助機能はサポートされていません。ユーザー補助機能とは、動作が制限されている方、視力の限られた方など、身体の不自由な方に製品をご使用いただけるように支援する機能のことです。

将来予想に関する記述

このマニュアルでは、本製品の現在の機能について説明しています。一部の内容で、現在利用できない項目について言及している可能性があります。これは、将来利用できるようになることを意味するものではありません。そのような内容は、資料、コード、または機能の提供を確約、保証または法的に義務付けるものではありません。機能の開発、リリース、時期や機能性は IBM の独自の決定によるものとします。

© Copyright IBM Corp. 2007, 2017 ix

http://www.ibm.com/support/knowledgecenter/

http://www.ibm.com/support/knowledgecenter/

x TM1 for Developers

第 1 章 TM1 開発の概要

このセクションでは、マルチディメンションの概念と IBM Cognos TM1 を使用する開発者の一般的な責任について紹介します。

マルチディメンションについてIBM Cognos TM1 を使用して作成できるマルチディメンション・データベースによって、ビジネス管理者や財務管理者は、複雑で動的なビジネス・モデルから即時に意味を見いだすことができるようになります。

マルチディメンションを理解するために、米国とカナダで展開している小売チェーン全体の製品販売の分析を試みる小売会社の販売担当副社長を例に説明します。各小売店は、耐久消費財の販売数量、販売金額、および割引を記録しています。

販売は、製品別、シナリオ (実績と予算) 別、地域別、数値データ (数量、販売金額、割引) 別、および週別に分析します。この例は、5 ディメンションのモデルを示します。このディメンションは、データの構成方法やデータ・タイプの追跡方法を特定します。

TM1 では、販売分析をキューブと呼ばれる 1 つ以上のマルチディメンション構造に常駐させることができます。一連のキューブがデータベースを形成します。キューブ内の各データ・ポイントは、キューブの各ディメンションの 1 つの要素によって識別されます。例えば、ボストン店の 1 月第 2 週のドライヤーの実際の販売金額です。TM1 キューブには、最低 2 つ、最高 256 のディメンションを含める必要があります。

Durables キューブ次の図では、“Durables”キューブの各ディメンションは、縦線のセグメントで表されています。ディメンション内の要素は、単位間隔で表されています。

© Copyright IBM Corp. 2007, 2017 1

例えば、想定として販売担当副社長が、製品と店舗のパフォーマンスを素早く比較して、必勝戦略と問題点を特定する必要があるものとします。TM1 のマルチディメンション・ビューを使用すると、特別なクエリーを無制限に作成できます。

次の例では、各週の販売の実績金額と予算額を素早く比較できます。“Region”は“Boston”で、製品は“Dryer”モデルです。

ビューを再配置すると、全地域の“Dryer”モデルの販売金額を比較できます。

2 TM1 for Developers

TM1 を使用して、ビューを再構成し、マルチディメンション・データをドリルダウンして分析要件を満たすことができます。

開発者としての役割IBM Cognos TM1 開発者は、4 つの主要なタスクを実行する責任があります。

v ビジネス分析機能を保持するキューブを設計および作成する。

v 組織全体で共有できるようにキューブの格納場所を決定する。

v トランザクション・システムや他のデータ・ソースからデータをキューブにインポートする。

v 平均価格、通貨換算、株価収益率などの計算を実行する書式を作成する。

これらのタスクを実行するには、TM1 データに対するアクセス権限を持つ必要があります。通常、TM1 の管理者がアクセス権限の設定を行います。次のセクションでは、ローカル・サーバーとリモート・サーバーの相違について説明し、リモート・サーバーでのタスクの実行に必要なアクセス権限を一覧表示します。

TM1 オブジェクトの命名規則開発者として、IBM Cognos TM1 システムで多数のオブジェクトを作成し命名する責任があります。TM1 には、命名に関していくつかの制限があります。また、ベスト・プラクティスを示す指針もあります。TM1 オブジェクトに名前を付けるときには、以下の規則に従ってください。

以下のすべての文字が予約済みというわけではありませんが、ほとんどの場合、オブジェクトおよび要素に名前を付ける際に以下の特殊文字を使用しないようお勧めします。要素の命名に関する特定の情報については、 4ページの『要素名およびMDX 式』を参照してください。

表 1. オブジェクトおよび要素の名前で避けるべき特殊文字

文字説明

’ アポストロフィ

* アスタリスク

@ アットマーク - 5ページの『TM1 規則におけるオブジェクト名』を参照。

\ バックスラッシュ

第 1 章 TM1 開発の概要 3

表 1. オブジェクトおよび要素の名前で避けるべき特殊文字 (続き)

文字説明

: コロン

, コンマ

{ 中括弧 - 『オブジェクト名における中括弧』を参照。

" 二重引用符

! 感嘆符 - 5ページの『TM1 規則におけるオブジェクト名』を参照。

> より大

< より小

- 負符号 - 要素名にて。『要素名および MDX 式』を参照してください。

| パイプ

+ 正符号 - 要素名にて。『要素名および MDX 式』を参照してください。

? 疑問符

; セミコロン

/ スラッシュ

~ 波形記号 - 5ページの『TM1 規則におけるオブジェクト名』を参照。

コンポーネントごとの予約文字

以下の文字は、次のコンポーネントのために明示的に予約されているため、それらのコンテキストにおいてオブジェクトに名前を付けるために使用しないでください。

v TM1 Architect における予約文字は以下のとおりです。

\ / : * ? " < > | }

v TM1 Server がこれらの文字を予約するオブジェクトは、キューブ、ディメンション、サブセット、ビュー、プロセス、日課です。

\ / : * ? " < > | ’ ; ,

v プロセス変数名では、次のものを除くいかなる特殊文字も識別子に含めることはできません。

AllowableChars[] = ".$%_`";

オブジェクト名における中括弧

ユーザーが作成するどのような TM1 オブジェクト名においても、右中括弧 (}) を先頭文字として使用しないことをお勧めします。 TM1 コントロール・オブジェクト名は常に右中括弧で始まります。ユーザー作成のオブジェクト名が右中括弧で始まる場合、オブジェクトは、「コントロール・オブジェクトを表示」パラメーターがオフにされた場合、非表示になります。

要素名および MDX 式

要素名の先頭文字として + または - を使用することはできません。要素名の先頭文字として + または - を使用できないのは、アクティブ・フォームへスライスする際のサブセット内の最初の要素においてのみですが、要素名の先頭文字として +

または - を一切使用しないことをお勧めします。


要素名に使用可能なその他のすべての文字については、技術的には制限されていませんが、要素に名前をつける際、前述の表にリストされている特殊文字を避けることをお勧めします。

要素名に右角括弧 ( ] ) を含めることができますが、この文字を含む要素名がMDX 式で参照されている場合は、これを二重に指定して文字をエスケープする必要があります。例えば、Array[N] Elements という名前の要素は、MDX 式では[Array[N]] Elements] として参照できます。

TM1 規則におけるオブジェクト名

オブジェクト名にこれらの特殊文字を使用することは、技術的には可能ですが、規則の式で使用される場合に競合が発生するおそれがあるため、使用しないことをお勧めします。以下のガイドラインでは、オブジェクトまたは要素が、これらの特殊文字の使用が許可されていない規則ステートメントの一部になる場合の対処方法を示します。

v 例えば、) | ~ ; @ ¥ / : * ? " < > は規則ステートメントで頻繁に見られるため、オブジェクト名に使用するべきではありません。

v @ は、技術的には制限されていませんが、@ 記号は TM1 規則における文字列比較演算子でもあるため、オブジェクト名または要素名に @ 記号を使用しないことをお勧めします。規則で @ 文字を含むオブジェクトを参照する場合、オブジェクト名を一重引用符で囲む必要があります。例えば、products@location という名前のディメンションは、規則では 'products@location' として参照する必要があります。引用符によるエスケープは、すべての場合に有効とは限らないため、オブジェクトに名前を付ける際には @ の使用を一切避けることが最善です。

v 引用符を使用した特殊文字のエスケープは、! または特定の規則の式で無効です。

v 感嘆符 ! 文字は、規則の式でも使用されるため、オブジェクト名に使用できません。以下に例を挙げます。

DB(’MarketExchange’,!market,!date)

データ・ディレクトリーとオブジェクト名の最大文字列長

IBM Cognos TM1 サーバーのデータ・ディレクトリー名とオブジェクト名の組み合わせで表される文字列全体は、128 バイトに制限されます。例えば、データ・ディレクトリーが“C:¥Financial data¥TM1¥”(22 バイト) の場合、オブジェクト名は .cub

や .rux などのファイル拡張子を含めて 106 バイトに制限されます。

ビュー、サブセット、アプリケーションなどのいくつかの TM1 オブジェクトは、TM1 サーバーのデータ・ディレクトリーのサブディレクトリーに格納されます。この場合、128 バイトの制限は、TM1 サーバーのデータ・ディレクトリー、サブディレクトリー、およびオブジェクト名の組み合わせに適用されます。

大文字と小文字を区別する

オブジェクト名に大文字小文字の区別はありません。例えば、ディメンション名actvsbud は ActVsBud と同じです。

第 1 章 TM1 開発の概要 5

オブジェクト名内のスペース

すべてのオブジェクト名でスペースが許可されます。ただし、IBM Cognos TM1 サーバーはスペースを無視します。TM1 サーバーは、ディメンション名 Act Vs Bud

を、ActVsBud (または actvsbud) と同じものと見なします。

ユーザー名

予約文字を含むユーザー名は、個人用オブジェクトを保存できません。


第 2 章キューブとディメンションの作成

IBM Cognos TM1 はビジネス・データをキューブに格納します。この資料では、キューブ、およびその構成要素であるディメンションの作成方法について説明します。

注: この資料で説明されているすべてのタスクで、TM1 Perspectives または TM1

Architect が必要です。 TM1 Client では、キューブの作成、ディメンションの作成または編集、または複製の設定を行うことはできません。

キューブの設計TM1 はビジネス分析をキューブに格納します。キューブ内の各セルには、分析で追跡する数値データが含まれています。キューブでは、1 つ以上の数値データに対してデータを格納できます。

キューブは、追跡するデータまたは数値データの構成方法を識別するディメンションを使用して作成します。各ディメンション内の 1 つの要素は、キューブ内の 1

つのセルの場所を識別します。

次のキューブの例には、「製品」、「数値データ」、および「月」の 3 つのディメンションが含まれています。販売などの各数値データは、製品と月で構成またはディメンション化されています。例えば、セル値の「300000」は、1 月 (「Jan」) の「Sedan-1」の売上高を表します。

TM1 では、すべてのディメンションは、数値データを識別する要素を含む場合も、数値データの構成方法を記述する要素を含む場合も同様に処理されます。

300000

400510

280500

310500

420500

290500

400500

420500

300500

420500

422500

280500

月

Sedan-3

Sedan-2

Sedan-1

Sales

Units

Variable Costs数値データ

製品

Jan Feb Mar Apr


ディメンション数の選択すべてのキューブには、少なくとも 2 つ、最高で 256 のディメンションがあります。例えば、2 ディメンション・キューブは、3 ディメンション以上の他のキューブで値を計算する場合、検索テーブルとして用いるのに最適です。また、為替レートを格納する 2 ディメンション・キューブを使用すると、現地通貨額を報告通貨に変換できます。レートを取得するには、TM1 規則を使用します。

キューブ内のディメンション数は、主にデータのディメンションに依存します。損益計算書の勘定科目について検討します。

損益計算書 (千円単位)

会計年度 (2002 年 12 月 31 日)

純売上高 200,000

直接費 35,000

直接労務費 50,000

総利益 115,000

給与 30,000

給与手当 3,500

電気代 5,000

賃借料 10,000

減価償却費 6,000

収益と費用が係数によってどのように変化するかを調べる場合、勘定科目を次の 2

つのグループに分ける必要があります。

v 総利益行より上の勘定科目(例：純売上高、直接費)。“product”、“region”、“scenario”(実績と予算)、および“months”のディメンションで構成できます。

v 総利益行より下の勘定科目 (例：給料手当、電気代、賃借料)。“region”、“scenario”(実績と予算)、および“months”のディメンションで構成できますが、製品のディメンションで構成することはできません。間接費は製品に直接賦課できないため、詳細と同じレベルで分析することはできません。

このディメンションの相違によって、次の 2 つのキューブが提示されます。

v 総利益行より上の勘定科目に対しては、5 つのディメンション・キューブ

v 総利益行より下の勘定科目に対しては、4 つのディメンション・キューブ


5 つのディメンション・キューブ次の図は、5 つのディメンション・キューブのディメンションと要素を表しています。各ディメンションは、縦線のセグメントで表されています。ディメンション内の要素は、単位間隔で表されています。

4 つのディメンション・キューブ次の図は、4 つのディメンション・キューブのディメンションと要素を表しています。各ディメンションは、縦線のセグメントで表されています。ディメンション内の要素は、単位間隔で表されています。

ディメンション階層を使用した詳細の集約データをキューブにインポートすると、特定の詳細レベルにおけるビジネスのスナップショットが得られます。例えば、市区町村別の製品の週単位または月単位の販

第 2 章キューブとディメンションの作成 9

売データをインポートできます。これらのデータ・ポイントを識別するディメンション要素は、各ディメンション内の単純要素またはリーフ・レベルの要素 (1 週間の販売、1 製品の販売、および 1 市区町村における販売) です。

ディメンション階層を使用すると、数値データを分析で有意なカテゴリーに簡単に集計できます。各カテゴリーは、ディメンション内の複数の要素に関する詳細の集計に対応します。例えば、毎月の販売金額を合計した四半期要素を作成できます。TM1 では、集計を表す要素は、集約要素または集約と呼ばれます。

次の図は、“Region”ディメンションの要素に関する 3 つのレベルの集計を示しています。市区町村は、最下位レベルの詳細 (レベル 0) を表します。市区町村は都道府県集約 (レベル 1) に集計され、さらに地域集約、最終的に Eastern USA 集約 (レベル 3) に集計されます。

ディメンション階層の移動ディメンション階層は、さまざまなレベルの詳細でデータを分析するためのナビゲーション・パスを提供します。ドリルダウンとは、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

月 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 つのパスに沿って集計されます。

地理上の集計:


管理上の集計:

複雑な計算式の作成TM1 は、ディメンション内に作成した集約を、割り当てられた重み付け係数によって集計します。要素間の比率を作成するか、要素に関連付けられている値を乗算するには、規則と呼ばれる複雑な計算式を作成する必要があります。

以下の 2 つの計算では、TM1 規則が必要です。

v Gross Margin = (Gross Profit / Net Sales) x 100

v Sales = (Price x Units)

規則を使用すると、要素を集計することもできます。ただし、特にキューブが大きいか疎らな場合、規則は集約に比べて処理に時間がかかります。疎らなキューブに、空のセルがかなりの割合で含まれています。

IBM® Cognos® TM1® は、規則に従う集計処理もサポートします。この機能は、主に IBM® Cognos® Business Intelligence® (BI) クライアントで利用されます。Cognos

TM1 のこれまでのバージョンでは、デフォルトの集計は、Cognos TM1 の規則計算セルに適用されたときに、Cognos BI サーバーによって計算されませんでした。以前のリリースでは、デフォルトの集計が Cognos TM1 の規則計算セルに適用された結果として、Cognos BI レポートはエラーのセルを戻していました。規則に従う集計を使用すると、集計番号は Cognos TM1 規則のセマンティクスに基づいてレポートされます。

デフォルトの集計を規則計算セルに対して計算する際に、以下の制限が残っています。

v マルチディメンションの組セットは、それが単一ディメンションのメンバー・セットをクロス結合した結果でない限り、計算セルに対して集計することはできません。この場合、集計結果はエラー・セルのままです。

v 規則に従う集計を、MDX 計算メンバーに対して適用することはできません。これは、計算メンバーが、集計メンバー・セットにおいても集計コンテキストにおいても、サポートされていないことを意味します。この例で、計算セルに対する集計は引き続きエラー・セルの結果になります。

v 集計セルは、システムが集計結果に対して規則を再使用できるようするため、同じ規則と関連付けられている必要があります。規則の範囲は、集計メンバー・セットのディメンションに属する UDC (ユーザー定義集約) 要素を含むことができるように、一般的であるべきです。

規則についての包括的な説明は、「TM1 規則」を参照してください。


要素のタイプここまで、集計して集約できる単純要素またはベース・レベルの要素について学習してきました。TM1 は、3 つのタイプの要素をサポートしています。

要素説明

数値ディメンション内の最下位レベルの詳細を識別します。TM1 では、数値しか含まないキューブでは、最下位レベルのすべての要素が数値として定義されます。

集約下位レベルの詳細を集計したもの。例えば、“time”ディメンションの“1Quarter”要素を使用すると、年の最初の 3 カ月の販売金額を合計できます。

文字列セル内のテキスト文字列を格納します。キューブ内のセルの文字列を格納するには、セルを定義している最後のディメンションの要素が文字列要素である必要があります。TM1 では、最後のディメンション以外のディメンションに出現する文字列要素は、数値要素として処理されます。

文字列要素は、通常入力ファイル内のコードを正式な要素名に変換する 2 ディメンション・キューブで使用されます。例えば、アカウント・コードをアカウント名に変換する場合です。

要素の属性要素はキューブ内のデータを識別し、要素の属性は要素自身について記述します。

属性を使用すると、次の操作を実行できます。

v 要素の機能をリスト表示する。例：店舗の面積や自動車モデルのエンジン・サイズ。

v 代替名または別名を提供する。例：総勘定元帳科目の記述名、および現地語版の製品名。

v 数値データの表示形式を制御する。通常、キューブ内で追跡する数値データの表示形式を選択します。

「サブセット・エディター」で属性値により要素を選択できます。別名を使用すると、TM1 ダイアログ・ボックスに要素名を表示することもできます。

属性を作成し、属性値を割り当てるには、「属性エディター」を使用します。

記述的な属性次の表に、自動車モデルを記述するサンプル属性を示します。

要素

属性

Horsepower(数値) Engine(テキスト) Audio(テキスト)

Sedan 1 190 V-8 Compact Disc

Sedan 2 140 Inline 4 Cassette / Radio



要素

属性

Horsepower(数値) Engine(テキスト) Audio(テキスト)

Sedan 4 180 V-8 Compact Disc


別名属性次の表に、英語の家具名のドイツ語版、スペイン語版、フランス語版を示します。

要素

別名属性

Deutsche Español Français

Chair Stuhl Silla Chaise

Desk Schreibtisch Escritorio Bureau

Lamp Lampe Lámpara Lampe

表示形式の属性「Cube Viewer」ウィンドウでは、数値データは次の表で示す形式で表示されます。

形式名説明例

通貨数値は、通貨記号と指定された小数点以下の桁数(精度) で表示されます。TM1 は、Microsoft

Windows の「地域の設定」ダイアログ・ボックスに定義されている通貨記号を使用します。

$90.00

全般数値は、指定された小数点以下の桁数 (精度) で表示されます。

-90

割合計算数値は、パーセンテージとして指定された小数点以下の桁数 (精度) で表示されます。

90.00%

指数数値は、指数形式で指定された小数点以下の桁数(精度) で表示されます。

9.0e+001

日付数値は日付文字列(1=1900 年 1 月 1 日) として表示されます。多数の日付形式を利用できます。

ある要素が日付として形式設定される場合、その要素が TM1 Web または TM1 Application Web

で表示されるときに、カレンダー日付セレクターを使用して新しい日付値を選択できます。

2002 年 3 月 31 日

時刻数値は時刻文字列として表示されます。多数の時刻形式を利用できます。

19:53:30 A

コンマコンマを大きな数値の適切な場所に配置します。 1,000,000

カスタムユーザー定義の形式。カスタム

「属性エディター」ウィンドウを使用すると、キューブ内の各ディメンションのすべての要素に対して表示形式を選択できます。ただし、1 つのディメンション (キューブ内で追跡する数値データ) のみに対して表示形式を選択することをお勧めします。「Cube Viewer」ウィンドウでは、その要素に表示形式が定義されていないセルに適用する、形式を選択することもできます。


「Cube Viewer」ウィンドウで使用される形式は、TM1 では次のように決定されます。

1. TM1 では、最初に列ディメンションの要素の表示形式が確認されます。ディメンションが積み上げられている場合は、TM1 では下から上方向に確認されます。

2. 形式が見つからない場合、TM1 では行ディメンションの要素の表示形式が確認されます。ディメンションが積み上げられている場合は、TM1 では右から左方向に確認されます。

3. 形式が見つからない場合、TM1 ではタイトル要素の表示形式が確認されます。要素は右から左方向に検査されます。

4. 形式が見つからない場合、TM1 では現在のビューの形式が適用されます。

TM1 でキューブの数値データにこの形式を確実に適用するには、数値データを含むディメンションを一番下の列ディメンションに配置します。

行または列の表示形式の設定単一列または単一行内の数値を書式設定する場合があります。例えば、小数点以下2 桁までの値を持つ列または行の数値であっても、小数点なしの整数として表示した方が適切な場合があります。単一列または単一行内の数値を書式設定するには、「属性エディター」を使用します。

“Month”ディメンションは、ビューの列に表示されます。列ディメンションに割り当てた表示形式によって、行ディメンションに選択した表示形式は上書きされます。

最初のタスクとして、“Month”ディメンションの“Year”要素に表示形式が適用されていないことを確認します。次の手順に従います。

手順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 つのディメンションを作成する場合、TM1 を使用して色別の自動車販売を追跡できます。販売を単一モデルに合算すると、貴重な詳細を失う可能性があります。

別の例を検討します。自動車モデルの表には、エンジン構成の属性カテゴリーがあります。各自動車には、V-8 などの 1 つのエンジン構成があります。複数のエンジン構成のセダンを入手できる場合、エンジン構成ごとに 1 つの要素の作成を検討してください。

キューブの設計 - まとめ次に、キューブを設計する際のガイドラインを示します。

手順1. ビジネス分析で追跡する数値データをリスト表示する。数値データの例としては、販売金額、販売数量、費用、取得価額、キャンペーン費用などが挙げられます。

2. 数値データを構成またはディメンション化する方法を決定する。ほとんどの分析では、長期にわたって数値データを追跡します。

v 基本の時間間隔は、日数、週数および月数のどれか。

v 地理的なディメンションはあるか。

v 数値データは、顧客や製品で変わるか。

v シナリオ・ディメンション (実績と予算) はあるか。

3. ディメンション要素を集約する方法を決定します。

4. キューブの要素に関連付ける属性のリストを作成する。属性の例としては、店舗の面積、顧客 ID、現地語版の要素名などが挙げられます。

5. キューブ内の数値データの表示形式を定義する。例えば、“Gross Margin”を割合で、“Sales”を通貨額で定義します。

ディメンションの作成ディメンションを作成する場合、ディメンションおよびオプションでディメンション内の階層 (集約) を構成する、リーフ・レベルの要素を識別します。

ディメンションを作成するには、次の 4 つの方法があります。


v ディメンション・エディター - ディメンションの設計時に、要素の追加、および集約の作成と再配置を行います。詳細については、『ディメンション・エディター・ウィンドウを使用したディメンションの作成』を参照してください。

v TurboIntegrator - 要素名を ASCII、ODBC、キューブ・ビュー、またはディメンション・サブセットのソースからインポートします。同時に、複数のディメンションを作成し、これらのディメンション内に集約を設定します。詳しくは、「TM1 TurboIntegrator」を参照してください。

注: TM1 では、Solaris または AIX® 上の Oracle ODBC ソースにアクセスするのに、DataDirect ドライバーが必要です。これらのドライバーは TM1 には付属しておらず、別個に入手する必要があります。

v データの新規キューブへのインポート - TurboIntegrator を使用して、入力行をデータ・ソースからキューブにマッピングします。その後、セル値を提供する入力列とセルの場所を識別する要素を識別します。このプロセスについて詳しくは、「TM1 TurboIntegrator」を参照してください。

v ディメンション・ワークシート - これらの変更済み Microsoft Excel ワークシートを使用して、1 つのディメンションの要素および階層関係をリスト表示します。詳細については、 26ページの『ディメンション・ワークシートを使用したディメンションの作成』を参照してください。

ディメンション・エディター・ウィンドウを使用したディメンションの作成

このセクションでは、「ディメンション・エディター」ウィンドウを使用して単純な“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. 「編集」→「子を挿入」をクリックするか、「子を挿入」をクリックします。

「ディメンション要素の挿入」ダイアログ・ボックスが開きます。TM1 は“New England”という親名を表示し、作成するすべての要素が“New England”の子になることを示します。

7. 「要素名の挿入」フィールドに「Connecticut」と入力し、「追加」をクリックします。

8. 「要素名の挿入」フィールドに「Massachusetts」と入力し、「追加」をクリックします。

9. 「要素名の挿入」フィールドに「Vermont」と入力し、「追加」をクリックします。

これで、ダイアログ・ボックスに“New England”の 3 つの子が含まれ、それぞれにデフォルトの重み付けとして“1”が設定されます。

10. 「OK」をクリックします。

ディメンション・エディターに、“New England”の子として新しい要素が表示されます。

11. 「ディメンション」→「保存」をクリックするか、または「保存」をクリックします。

「ディメンション名を付けて保存」ダイアログ・ボックスが開きます。

12. ディメンション名を入力し、「保存」をクリックします。

ディメンション名には、最大 256 文字まで指定できます。常にディメンションの記述的な名前を使用してください。

新しいディメンションが、サーバーのディメンションのリストに表示されます。

ディメンションの変更ディメンションを作成したら、次の変更を行うことができます。

v 兄弟を既存の要素に追加する。

v 子を既存の要素に追加する。

v 階層構造を再配置する。例：集約内の要素の再配置

v ディメンションから要素を削除する。

v 集約から要素を削除する。

v 要素のプロパティーを編集する。例：集約内の要素の重み付けの変更

v ディメンション内の要素の順序を再配置する。


兄弟を既存の要素に追加するディメンション・エディターで兄弟を既存の要素に追加するには、次の手順を実行します。

手順1. 兄弟を追加する要素を右クリックし、「ディメンション構造の編集」を選択します。

2. 「編集」→「兄弟の挿入」をクリックします。


3. 「要素名の挿入」フィールドに、最初の兄弟の名前を入力します。

4. 適用可能な場合、「要素の重み付け」に該当する値を入力します。

要素のデフォルトの重み付けは“1”です。

5. 「追加」をクリックします。

6. 追加する各兄弟について、手順 3 ～ 5 を繰り返します。


TM1 は、新しい要素を手順 1 で選択した要素の兄弟として追加します。

子を既存の要素に追加するディメンション・エディターで子を既存の要素に追加するには、次の手順を実行します。

手順1. 兄弟を追加する要素を右クリックし、「ディメンション構造の編集」を選択します。

子を単純要素 (リーフ・レベルの要素) に追加すると、その要素は自動的に集約要素になります。

2. 「編集」→「子を挿入」をクリックします。


3. 「要素名の挿入」フィールドに、最初の子の名前を入力します。

4. 適用可能な場合、「要素の重み付け」に該当する値を入力します。

要素のデフォルトの重み付けは“1”です。


6. 追加する各子について、手順 3 ～ 5 を繰り返します。


TM1 は、新しい要素を手順 1 で選択した要素の子として追加します。

ディメンション階層を再配置するディメンション階層内の要素の位置を変更するには、次の手順を実行します。


手順1. 「ディメンション・エディター」で、移動する要素を選択します。

v 単一要素を選択するには要素をクリックします。

v 隣接する複数の要素を選択するには、最初の要素をクリックし、Shift キーを押しながら最後の要素をクリックします。または、CTRL キーを押しながらA を押して、表示されているすべての要素を選択することもできます。

v 隣接しない複数の要素を選択するには、Ctrl キーを押しながら各要素をクリックします。

2. 要素をディメンション階層内の新しい場所までドラッグ・アンド・ドロップします。

要素をドラッグすると、カーソルが変化して TM1 が要素をドロップする場所を示します。また、ステータス・バーに、TM1 が要素をドロップする場所を示すメッセージが表示されます。

要素を切り取り/貼り付けして、ディメンション階層を再配置することもできます。

ディメンションから要素を削除するディメンションから要素を削除するには、次の手順を実行します。

手順1. 削除する要素を選択します。


v 隣接する複数の要素を選択するには、最初の要素をクリックし、Shift キーを押しながら最後の要素をクリックします。


v 階層レベル、属性値、またはスペル・パターンで要素を選択する方法については、「TM1 Perspectives, TM1 Architect, and TM1 Web」を参照してください。

2. 「編集」→「要素の削除」をクリックします。

確認ダイアログボックスにはディメンション名がリスト表示され、選択したオブジェクトを削除するかどうか尋ねるメッセージが表示されます。削除する場合は、「はい」をクリックし、削除をキャンセルする場合は、「いいえ」または「キャンセル」をクリックします。

集約から要素を削除する集約から要素を削除するには、次の手順を実行します。

手順1. 削除する要素を選択します。





2. 「編集」,「集約からの要素の削除」をクリックするか、「削除」をクリックします。

確認ダイアログボックスにはディメンション名がリスト表示され、選択したオブジェクトを削除するかどうか尋ねるメッセージが表示されます。削除する場合は、「はい」をクリックし、削除をキャンセルする場合は、「いいえ」または「キャンセル」をクリックします。

TM1 は、集約から要素を削除し、要素の他のインスタンスはすべてディメンション内に保持します。

注: 要素を集約内でのみ定義した場合、TM1 によって要素はディメンションからも削除されます。

要素のプロパティーを編集する要素のプロパティーを編集して、新しい重み付けを集約の要素に割り当てたり、リーフ・レベルの要素の型を変更したりできます。

注: ただし、集約要素の型は変更できず、要素の重み付けを集約のメンバーでない要素のインスタンスに割り当てることもできません。

手順1. 要素を選択します。

2. 「編集」→「要素のプロパティー」をクリックします。

「ディメンション要素のプロパティー」ダイアログ・ボックスが開きます。

3. 必要に応じて、「要素の型」リストから新しい要素の型を選択します。

4. 必要に応じて、「要素の重み付け」に新しい重み付けを入力します。


ディメンション内での要素の順序の設定TM1 では、ディメンション内の要素の順序を設定して、ディメンション内の各要素のインデックス値を決定できます。ディメンション内の最初の要素のインデックス値は 1、2 番目の要素のインデックス値は 2、以降同様になります。

TM1 の多くの関数 (ワークシート、規則、および TurboIntegrator) が要素のインデックス値を参照しているため、ディメンション内の要素の順序の設定は重要な機能です。

注: ディメンション内の要素の順序を変更すると、要素のインデックス値を参照する関数から新しい (場合によっては予期しない) 値が返されます。

手順1. ディメンション内で表示する順に要素の順序を設定します。

「ディメンション・エディター」のソート・オプションとドラッグ・アンド・ドロップ機能を使用すると、要素の順序を変更できます。


2. 「ディメンション順序の設定」ボタンをクリックします。

3. 「ディメンション」→「保存」をクリックします。

v ディメンションのソート・プロパティーが「自動」に設定されている場合、TM1 ではソート・プロパティーを「手動」に変更するよう要求されます。

v ディメンションのソート・プロパティーが「手動」に設定されている場合は、TM1 によってディメンションに追加した要素が「ディメンション・エディター」で手動で配置した場所に挿入されます。

4. 「はい」をクリックして、新しいディメンションの順序を保存し、ディメンションのソート・プロパティーを「手動」に設定します。

ディメンション・エディターにすべてのディメンション要素のサブセットしか表示されない場合でも、要素の順序を設定できます。例えば、ディメンションが大きい場合、ごく少数の要素の順序を変更および設定できます。「ディメンション・エディター」に表示されている要素のサブセットで要素の順序を設定しても、ディメンション全体に影響することに注意してください。

次の例では、サブセットの使用時に要素の順序を設定すると、サブセット・エディター内のディメンション全体にどのように影響するかを示します。

単純化するために、このサンプル・ディメンションには、名前が 1 文字の 10

個の要素を用意していますが、この例で示す概念は、より大きく複雑なディメンションに適用されます。

v a

v b

v c

v d

v e

v f

v g

v h

v i

5. 要素として“c”、“d”、および“g”を選択し、「編集」→「維持」をクリックすると、ディメンション・エディターに選択された要素のサブセットが表示されます。

6. ここで、これら 3 つの要素の順序を変更することにします。“d”を最初の要素にし、“c”を最後の要素にします。

7. 要素が希望の順序で表示されたら、「ディメンション順序の設定」をクリックします。

ディメンション全体の要素の順序が設定されます。ディメンション全体を確認すると、ディメンション・エディターに次のように表示されます。

v i

v a

v b


v d

v g

v c

v e

v f

v h

v i

この例の場合、サブセットの要素の順序を設定すると、新しい順序によってディメンション全体が次のように影響を受けます。

v 要素の順序の設定時にアクティブであった要素のサブセットは、陰影付きのアイコンで表示される。

v 最初のサブセット要素は、最も近接した先行要素を基準としてディメンション内の位置を維持する。

v この例では、“d”が、要素順序の設定時にサブセット内の最初の要素になっている。

v 要素“b”が、サブセット要素を除きディメンション内で“d”に最も近接した先行要素であるため、ディメンション構造では、“b”の後に“d”が続く。

v 他のサブセット要素は、ディメンション構造内では、サブセット内の最初の要素に対する相対位置を維持する。

サーバー・エクスプローラーからディメンション要素の順序を設定する:

「ディメンション・エディター」を開かずに、サーバー・エクスプローラーからディメンション要素の順序を設定することもできます。次の 3 つの自動ソート順から、ディメンションのソート・プロパティーを選択することもできます。

v 名前

v レベル

v 階層

ソート・プロパティーを設定すると、TM1 はディメンションに追加した要素をソート順内の位置に従って挿入します。例えば、「名前」の自動ソート順を設定すると、TM1 によってアルファベット順に新しい要素がディメンションに挿入されます。

手順

1. サーバー・エクスプローラーでディメンションを右クリックします。

2. 「要素の順序の設定」をクリックします。

「ディメンション要素の順序設定」ダイアログ・ボックスが開きます。

3. ソート・タイプを選択します。

ソート・タイプ説明

自動「自動ソート基準」オプションの「名前」、「レベル」、および「階層」が有効になります。



手動ディメンション構造内での現在の位置に従って要素の順序を設定し、ディメンションのソート・プロパティーを「手動」に設定します。

4. 「手動」ソート・タイプを選択した場合、手順 7 に進みます。

5. 「自動ソート基準」オプションを選択します。

ソート基準説明

名前アルファベット順に要素をソートします。

レベル階層別レベルで要素をソートします。

階層ディメンション階層に従って要素をソートします。

6. 適用可能な場合、「ソート順」を選択します。


タスクの結果

これでディメンション要素の順序が設定されました。ディメンションを開くと、要素が手順 5 で指定した「自動ソート基準」オプションに従って要素が順に表示されます。

ディメンション・エディターでの要素の表示の管理ディメンション・エディターには、要素の表示方法を管理できるいくつかの機能が用意されています。例えば、大きなディメンションで作業する場合、特定の階層レベルの要素のみ表示する便利な機能や、要素をアルファベット順に表示する機能などがあります。

ディメンション・エディターで要素の表示を変更する場合、ディメンション構造は変更せず、TM1 が要素をウィンドウに表示する方法を変更するだけです。

以降のセクションでは、ディメンション・エディターでの要素の表示を管理する方法について説明します。

要素の維持ディメンション・エディターで選択した要素のみ表示するには、次の手順を実行します。

手順1. 表示する要素を選択します。





2. 「編集」→「維持」をクリックするか、または「維持」をクリックします。

「ディメンション・エディター」に、選択した要素のみ表示されます。

要素の非表示ディメンション・エディターで選択した要素のみ非表示にするには、次の手順を実行します。

手順1. 非表示にする要素を選択します。




2. 「編集」→「非表示」をクリックするか、または「非表示」をクリックします。

ディメンション・エディターで、選択した要素が非表示になります。他のすべての要素は表示されたままです。

アルファベット順での要素のソートディメンション・エディターでは、要素をアルファベットの昇順または降順にソートすることができます。

ソート順説明

アルファベット昇順「編集」→「ソート基準」→「昇順」をクリックするか、「昇順に

ソート」をクリックします。

アルファベット降順「編集」→「ソート基準」→「降順」をクリックするか、「降順に

ソート」をクリックします。

インデックス値による要素のソート「ディメンション・エディター」では、要素をインデックス値に従って昇順または降順にソートすることができます。

ソート順説明

インデックス値による昇順

「編集」→「ソート基準」→「インデックスの昇順」をクリックす

るか、「インデックスによるソート、昇順」をクリックします。

インデックス値による降順

「編集」→「ソート基準」→「インデックスの降順」をクリックす

るか、「インデックスによるソート、降順」をクリックします。


階層別要素をソートディメンション階層の表示順に要素をソートすることもできます。


ディメンション階層の表示順

「編集」→「ソート基準」→「階層」をクリックするか、「階層

のソート」をクリックします。

別名による要素の表示ディメンションに対して別名属性を定義した場合、「ディメンション・エディター」で別名により要素を表示できます。

TM1 サンプル・データ・ディレクトリー内のディメンションでは、フランス語とドイツ語に対応する別名が定義されているため、すべての要素名を対応する外国語で表示できます。

手順1. ディメンション・エディターで“Month”ディメンションを開きます。

2. 「表示」→「ツールバー」→「別名」をクリックして、「別名」ツールバーを表示します。

「別名」ツールバーには、「別名を使用」切り替えボタン、および別名を選択できる「別名の選択」リストの 2 つのオブジェクトが含まれています。

3. 「別名の選択」リストから“Monat”(“Month”に対応するドイツ語) を選択します。

4. 「別名を使用」ボタンをクリックします。

タスクの結果

TM1 では、デフォルトで別名は表示されません。ディメンション・エディターでは、すべての要素がドイツ語の別名で表示されるようになります。

ディメンション・ワークシートを使用したディメンションの作成ディメンション・ワークシートは、1 つのディメンションの要素および階層関係をリスト表示した、変更済みの Microsoft Excel スプレッドシートです。TM1 は、ディメンション・ワークシート (dimname.xdi) とコンパイル済みファイル(dimname.dim) の 2 つのファイルにワークシート・データを保存します。

v TM1 では、「ディメンション・エディター」ウィンドウまたは TurboIntegrator

を使用してディメンションを作成する場合、“dimname.dim”(コンパイル済み) ファイルにのみ書き込まれます。

v TM1 では、ディメンション・エディターを使用してディメンションを変更する場合、変更内容は .dim ファイルに保存されます。TM1 では、ディメンションに.xdi ファイルが存在している場合は、変更内容をディメンション・ワークシート


に保存するよう要求されます。ディメンション・ワークシートの更新を拒否すると、.dim ファイル内のディメンション構造が .xdi ファイルのものと違うものになります。

v TM1 からディメンションの変更内容すべてにアクセスできるようにするには、ディメンション・ワークシートまたはディメンション・エディターを使用して、ディメンションを作成および保守します。方法を混在させないでください。データが失われる可能性があります。

データの同期の維持TM1 は、「オプション」ダイアログ・ボックスの「ローカル・サーバーのデータ・ディレクトリー」フィールドにリスト表示されている最初のディレクトリーにディメンション・ワークシート・ファイルを保存します。このため、TM1 ではディメンション・ワークシート (.xdi) が、ディメンション・ファイル (.dim) と異なるディレクトリーに保存される可能性があります。

注: ワークシートを使用してディメンションを編集する場合、十分注意してください。適切な予防策をとらないと、データが失われる場合がいくつかあります。次に、ディメンション・データが失われる可能性がある 2 つの例を示します。

v 月曜日に、“Account1”ディメンションのディメンション・ワークシートを編集し、ディメンションを保存します。火曜日に、別の管理者がディメンション・エディターを使用して、ディメンションを変更します。別の管理者が行った変更内容は、ディメンション・ワークシート・ファイルに伝播しません。水曜日に、古いディメンション・ワークシートを使用して、ディメンションに別の変更を加えます。この場合、この変更によって他の管理者が行った変更内容が上書きされます。

v 2 人の管理者が、2 つの異なるディメンション・ワークシートを使用して、同じサーバー上のディメンションを更新することにします。これは非常に危険です。TM1 は非常に簡単に変更を上書きできてしまいます。1 つのセットのディメンション・ワークシートを使用してください。任意のディメンションに複数の .xdi ファイルを設定しないようにしてください。

混乱とデータ損失を避けるため、ディメンション・ワークシートの編集時には、十分注意してください。次のいずれかの手順を使用することをお勧めします。

v リモート・サーバーのデータ・ディレクトリーを使用して、ディメンション・ワークシートを格納する。

v 特別なディレクトリーを使用して、ディメンション・ワークシートを格納する。

リモート・サーバーのデータ・ディレクトリーの使用:

リモート・サーバーのデータ・ディレクトリーでディメンション・ワークシートを編集するには、次の手順に従います。

手順

1. 「オプション」ダイアログ・ボックスの「ローカル・サーバーのデータ・ディレクトリー」に、リモートの IBM Cognos TM1 サーバーが使用するデータ・ディレクトリーを設定します。

2. 「始動時にローカル・サーバーに接続」オプションをクリアします。


3. コンピューター上で実行中のローカル・サーバーがシャットダウンされていることを確認します。

4. リモート TM1 サーバーにログオンします。

5. リモート・サーバーのデータ・ディレクトリーにあるワークシート・ファイルを使用して、ディメンションに対するすべての変更を行います。

6. Excel で、「TM1」>「ディメンション・ワークシート」>「保存」をクリックします。

TM1 では、.dim ファイルと .xdi ファイルが、リモート・サーバーのデータ・ディレクトリーに書き込まれます。

ワークシート・ディレクトリーの使用:

特別なワークシート・ディレクトリーを使用すると、ディメンション・ワークシートへのアクセスを厳しく制限できます。セキュリティー重視のインストールでは、これは非常に便利です。ワークシート・ディレクトリーを設定するには、次の手順に従います。

手順

1. ファイル・システムのいずれかの場所にワークシート・ディレクトリーを作成します。

2. すべてのワークシート・ファイル (ディメンションの場合、.xdi、規則の場合、.xru) をワークシート・ディレクトリーに移動します。

3. 「オプション」ダイアログ・ボックスの「ローカル・サーバーのデータ・ディレクトリー」をワークシート・ディレクトリーに設定します。

4. 更新するディメンションを含むリモート・サーバー、および必要なその他のサーバーに接続します。

5. ワークシート・ディレクトリーにあるワークシート・ファイルを使用して、ディメンションに対するすべての変更を行います。

6. Excel で、「TM1」>「ディメンション・ワークシート」>「保存」をクリックします。

「サーバー名を選択」ダイアログ・ボックスが開きます。

7. コンパイル済みディメンションを保存するサーバーを選択します。


ディメンション・ワークシートの作成ディメンション・ワークシートを使用してディメンションを作成するには、次の手順を実行します。

手順1. Excel で、「TM1」>「ディメンション・ワークシート」>「新規作成」をクリックします。

「ディメンションを作成」ダイアログ・ボックスが開きます。

2. 一番上のボックスに、次のようにディメンションの名前を入力します。


v ローカル・サーバー上にディメンションを作成するには、ディメンションの名前を入力します。例：Product。

v リモート・サーバー上にディメンションを作成するには、サーバー名、コロン(:)、ディメンション名の順に入力します。例えば、「sales:Product」と入力すると、sales サーバー上に“Product”ディメンションが作成されます。

注: リモート・サーバー上にディメンションを作成するには、TM1 管理者である必要があります。


Excel に空白のディメンション・ワークシートが開きます。

ディメンション・ワークシートの入力次のワークシートは、“Month”ディメンションの構造を定義しています。


次のセクションでは、ディメンション・ワークシートでの単純要素と集約要素の定義方法について説明します。

単純要素の定義:

ディメンションの単純要素 (リーフ・レベルの要素) を定義することで、行 1 からディメンション・ワークシートの入力を開始します。

手順

1. 列 A に、要素の型を指定します。

v 数値要素の場合、「N」と入力します。

v 文字列要素の場合、「S」と入力します。

この例では、すべての要素は数値です。

2. 列 B に、要素名を入力します。

集約要素の定義:

ディメンション内に単純要素を定義したら、集約要素を定義できます。

手順

1. 最後の単純要素下の空の行で、列 A に「C」と入力します。

2. 列 B に集約要素の名前を入力します。

3. 後続の行で、列 B に集約要素の子の名前を入力します。

例えば、ディメンション・ワークシートの次の抜粋は、集約要素“1 Quarter”が子“Jan”、“Feb”、および“Mar”の集約として定義されていることを示します。

集約内の要素の重み付け:

列 C を使用して、集約内の要素に重みを付けます。例えば、“Gross Margin”を計算するには、“Sales”から“Variable Costs”を減算します。この計算式を表記するには、重み“-1”を集約内の“Variable Costs”要素に割り当てます。次のワークシートは、“Account1”ディメンションの重み付けを示しています。


ディメンション・ワークシートの保存ディメンション・ワークシートを保存し、ディメンションをコンパイルするには、Excel で「TM1」>「ディメンション・ワークシート」、「保存」をクリックします。 TM1 は、ディメンション・ワークシート・ファイル (“dimname.xdi”) を更新し、コンパイルされたディメンション・ファイル (“dimname.dim”) を作成します。

注: Excel で「ファイル」、「保存」を使用しないでください。この操作では、.xdi

ファイルしか保存されません。TM1 は、ディメンションをコンパイルせず、.dim

ファイルを保存しません。

TM1 ディメンションへの名前付き階層レベルの使用}HierarchyProperties コントロール・キューブを使用して、TM1 ディメンションの階層レベルに独自の名前を割り当てることができます。作成する名前付きレベルは、IBM Cognos Report Authoring、MDX ステートメント、またはその他 MDX

OLAP ツールの TM1 データへ外部からアクセスする場合に使用することができます。さらにディメンションのデフォルト・メンバーを割り当てることもできます。

例えば、level000、level001、level002 の全般階層レベル名を使用する代わりに、次の表のように”Customers”のレベルを表す名前を割り当てることができます。

TM1 ディメンション・レベル名前付きディメンション・レベルの例

level000 すべて

level001 ステータス

level002 City

level003 Individual


名前付きレベルを設定する”}HierarchyProperties”コントロール・キューブを使用して名前付きレベルを設定します。

}HierarchyProperties コントロール・キューブの詳細については、「TM1 操作」のコントロール・キューブに関するセクションを参照してください。

手順1. TM1 Architect で、「表示」メニューをクリックし、「コントロール・オブジェクトを表示」を選択します。

2. ナビゲーション・ウィンドウで、「キューブ」ノードをクリックして展開します。

3. ”}HierarchyProperties” コントロール・キューブをダブルクリックします。

”}HierarchyProperties”コントロール・キューブが開きます。

4. タイトル・ディメンション・リストをクリックして、名前付きレベルを割り当てるディメンションを選択します。

5. defaultMember セルに既存の要素名を入力して、このディメンションのデフォルト・メンバーとして設定します。

IBM Cognos Report Authoring のような外部アプリケーションから TM1 データが取得される場合は、ここに入力した要素名は、そのディメンションをフィルターする可能性があります。

ディメンション階層の中の一番上の要素の名前を入力すると、既定ではすべてのディメンション要素が取得されます。

例えば、”Region”ディメンションのデフォルト・メンバーとして”World”を設定します。

6. level000 から level020 セルに、ディメンションに存在する各階層レベルの独自の名前を入力します。

注: 名前付きレベルの文字長は、255 バイトに制限されています。詳細については、 33ページの『名前付きレベルの文字列長の制限』を参照してください。

7. 名前付きレベルを設定したら、次のいずれかを行って変更を適用する必要があります。

v IBM Cognos TM1 サーバーを起動します。

v TurboIntegrator プロセスで RefreshMdxHierarchy 関数を実行します。詳細については、 33ページの『名前付きレベルでの RefreshMdxHierarchy

TurboIntegrator 関数の使用』を参照してください。

タスクの結果

注: 要素名やディメンション構造への変更は、名前付きレベル機能によって自動的に検出されません。ディメンションを変更する場合は、はじめに”}HierarchyProperties”コントロール・キューブの名前付きレベルの割り当てを手動で更新し、TM1 サーバーを再起動するか、RefreshMdxHierarchy TurboIntegrator 関数を実行して、TM1 サーバーの MDX 階層を更新します。


名前付きレベルの文字列長の制限名前付きレベルの文字長は、255 バイトに制限されています。}HierarchyProperties コントロール・キューブが長い文字列をサポートしている場合でも、MDX ステートメントでは、255 バイトより長い名前付きレベルはエラーになります。

255 バイトより長い名前付きレベルを力すると、TM1 はサーバーの起動時に次のエラーを表示します。

4648 ERROR 2008-06-27 13:50:04,532 TM1.Hierarchy User-defined level name

modified from ...

名前付きレベルでの RefreshMdxHierarchy TurboIntegrator 関数の使用”}HierarchyProperties”コントロール・キューブに名前付きレベルを設定または編集したら、RefreshMdxHierarchy 関数を使用して、サーバーを再起動しないで TM1 サーバーの MDX 階層を更新します。

手順1. 新規 TI プロセスを作成します。

2. 「プロローグ」タブにRefreshMdxHierarchy 関数を次の形式で入力します。

RefreshMdxHierarchy(dimensionName)

オプション・パラメーターの dimensionName には、アップデートする特定のディメンションを指定するか、空白にしてすべてのディメンションを更新することができます。

例えば、すべてのディメンションを更新する場合は:

RefreshMdxHierarchy(’’);

カスタマー・ディメンションのみを更新するには、次のようにします。

RefreshMdxHierarchy(’customers’);

3. 新規 TI プロセスを実行します。

複数階層の使用IBM Cognos TM1 ディメンションに 1 つ以上の階層を含めることができます。このセクションでは、複数階層ディメンションの特性、単一階層ディメンションとの比較、複数階層を管理および活用するために使用できる関数について説明します。現在、複数階層は TurboIntegrator または Planning Analytics Workspace を使用して実装できます。しかし、ディメンション・エディターおよびディメンション・ワークシートでは実装できません。

注: デフォルトでは、複数階層は有効になっていません。複数階層を扱い、関連する TurboIntegrator (TI) と規則の関数を使用するためには、事前に管理者がEnableNewHierarchyCreation tm1s.cfg 設定を構成しておく必要があります。

すべてのディメンションが単一階層であるディメンション・モデル作成アプローチでは、通常、キューブ 1 つあたりのディメンション数が多くなります。場合によっ


ては、「リピーティング・グループ」ができることもあります。例えば、ProductCategory ディメンションの Commercial カテゴリーに Product1 が含まれ、Retail カテゴリーに Product2 が含まれているとします。値が Product1 によってアドレッシングされる場合、ProductCategory 座標は常に Commercial です。製品カテゴリーが真の属性であれば、これらの「リピーティング・グループ」は必要ありません。1 つの製品が Commercial と Retail の両方のカテゴリーに存在することはないからです。

その代わりに、複数階層アプローチを使用して、Product ディメンションにByCategory 階層を含め、ByPriceRange や ByRegion などの他の階層も含めることができます。この方法を使用すると、キューブ内のディメンションの数が減少します。クエリーでも、TI やキューブ規則でも、要素に関係する階層を指定しなければならないという複雑さは増します。

複数階層を使用すると、クエリー時の柔軟性も非常に高まります。単一階層モデルの場合に、10 ディメンションのキューブに対してクエリーを実行するには、すべてのクエリーに厳密に 10 の階層が必要になります。複数階層の場合は、必要に応じて 10 以上の階層をクエリーで使用できます。クエリーに複数の階層を含めると、交点効果が得られます。例：

SELECT { [Products].[ByPriceRange].[PriceRange1] } ON ROWS, { [Measures].[Target] } ONCOLUMNS FROM [Cube]

この例では、PriceRange1 製品の合計 Target が表示されます。このクエリーに追加の階層を含めて、合計を絞り込むことができます。例：

SELECT { [Products].[ByPriceRange].[PriceRange1] } ON ROWS, { [Measures].[Target] } ONCOLUMNS FROM [Cube] WHERE ( [Products].[ByCategory].[Retail] )

この例では、Retail カテゴリーに現れる PriceRange1 製品のみを含めるようにして合計を絞り込んでいます。

明示的な階層指定ができるように、TurboIntegrator 関数およびキューブ規則関数が追加されました。単一階層用と複数階層用に別々の関数が用意されています。キューブに単一階層ディメンションしか含まれていない場合は、どちらのバリアントも使用できます。例えば、次の 2 つのステートメントはまったく同じです。

DimensionElementInsert(’dimension’, ’’, ’element’, ’c’);HierarchyDimensionElementInsert(’dimension’, ’dimension’, ’element’, ’c’);

単一階層ディメンションの場合、階層はディメンションと同じ名前になります。HierarchyDimensionElementInsert 関数の 2 番目のパラメーターは階層名です。上記ステートメントのどちらも、単一階層ディメンションに使用できます。ただし、ディメンションに 2 つ目の階層 (例えば hierarchy2 など) がある場合は、複数階層用の関数を使用して、特定の階層名を指定する必要があります。例：

HierarchyDimensionElementInsert(’dimension’, ’hierarchy2, ’element’, ’c’);

サポートされる TI およびキューブ規則関数について詳しくは、「TM1 リファレンス」を参照してください。


キューブの作成ローカル・サーバーでは、常にキューブを作成できます。リモート・サーバー上にキューブを作成するには、TM1 管理者である必要があります。

キューブを作成するには、次の 2 つの方法があります。

v 空のキューブ - 「キューブを作成」ウィンドウの既存のディメンションのリストから選択し、データなしの新しいキューブを作成します。

v 外部データ・ソース - TurboIntegrator を使用して、既存のデータ・ソースからディメンションとデータを識別し、新規または既存のキューブにマッピングします。

このセクションでは、「キューブを作成」ウィンドウでのキューブの作成方法について説明します。TurboIntegrator でのキューブの作成方法については、「TM1

TurboIntegrator」を参照してください。

キューブ内でのディメンションの順序設定キューブ内のディメンションには、キューブの作成時に選択した順序が設定されています。選択した順序はシステム・パフォーマンスに影響を与えるため、キューブを作成する前にディメンションの順序について考慮する必要があります。

ディメンションの順序を設定する最初の手順として、ディメンションを疎らなディメンションと密なディメンションの 2 つのグループに分けます。密なディメンションには、その要素に対してかなりの割合で値が設定されています。次の質問に答えることで、その密度を推定できます。ディメンション内の 1 つの要素に値が設定されていて、他のディメンションの要素を一定に保つ場合、ディメンション内の他の要素に値が設定されている確率はどの程度ですか。

例えば、指定された勘定科目と地域で 1 月の予算が設定されている場合、残りの月にも通常値が設定されています。このため、“Month”ディメンションは通常密です。同様に、指定された月、勘定科目、地域に予算値が設定されている場合、通常実績値も設定されているため、“ActVsBud”は密なディメンションになります。

ただし、世界全体の販売キューブの場合、通常、すべての製品が全地域で販売されているわけではありません。このため、“Product”と“Region”を疎らなディメンションとして処理します。

ディメンションの順序は、通常、最小の疎から最大の疎へ、続いて最小の密から最大の密にすることをお勧めします。ただし、ある程度の柔軟性が必要です。例えば、数千の要素を持つ“Product”などの非常に大きいが疎らなディメンションの前に、2～3 の要素しかない“ActVsBud”などの非常に小さく密なディメンションを配置すると、通常適切です。

キューブの作成キューブを作成するには、次の手順を実行します。

手順1. サーバー・エクスプローラーを開きます。


2. 「ツリー」ウィンドウで、キューブを作成するサーバーの下にある「キューブ」を選択します。

3. 「キューブ」→「新規キューブの作成」をクリックします。

「キューブを作成」ダイアログ・ボックスが開きます。左側の「使用できるディメンション」ボックスに、サーバーに格納されているディメンションがリスト表示されます。

4. 「キューブ名」フィールドに、キューブ名を入力します。

注: 名前を入力しない場合、TM1 は新しいキューブに名前なしという名前を付けます。

5. 「使用できるディメンション」ボックスで、新しいキューブの最初のディメンションとして使用するディメンション名をダブルクリックします。

ディメンション名が「新規キューブのディメンション」ボックスに移動します。

ボタンを使用しても、選択した名前を「使用できるディメンション」ボックスから「新規キューブのディメンション」ボックスに移動できます。隣接する複数の名前を選択するには、先頭の名前をクリックしてから末尾の名前までドラッグします。隣接しない複数のセルを選択するには、Ctrl キーを押しながら各名前をクリックします。

6. 新しいキューブに含めるすべてのディメンションについて、選択プロセスを繰り返します。少なくとも 2 つのディメンションを選択する必要があります。ディメンションの最大数は 256 です。

7. 上矢印および下矢印を使用して、ディメンションの順序を変更します (必要な場合)。リストからディメンションを削除するには、ディメンション名をダブルクリックします。

8. キューブのプロパティーを指定する場合、「プロパティー」をクリックします。キューブのプロパティーを指定しない場合は、手順 13 に進みます。

「キューブのプロパティー」ダイアログ・ボックスが開きます。

ここから、キューブの“Measures”と“Time”ディメンションを設定し、キューブを自動的または要求時にロードするかどうかを指定できます。

注: OLE DB for OLAP クライアントには、“Measures”と“Time”ディメンションを参照するための規定を含めることができます。TM1 では、“Measures”と“Time”ディメンションを参照しませんが、キューブにアクセスする可能性がある他の OLAP クライアントに対してこれらのプロパティーを設定できます。

9. “Measures”ディメンションを設定するには、「数値データ・ディメンション」リストからディメンションを選択します。

10. “Time”ディメンションを設定するには、「時間ディメンション」リストからディメンションを選択します。

11. キューブのロード方法を指定します。


v クライアントがキューブ・データを要求時にのみキューブをサーバー・メモリーにロードするには、「要求時ロード」ボックスをオンにします。

v サーバーの起動時にキューブをメモリーに自動的にロードするには、「要求時ロード」ボックスをオフにします。

12. 「OK」をクリックして、プロパティーを保存し、「キューブを作成」ダイアログ・ボックスに戻ります。

13. 「キューブの作成」をクリックして、キューブを作成します。

「サーバー・エクスプローラー」ウィンドウが開きます。新しいキューブが「ツリー」ウィンドウの「キューブ」リストにアルファベット順に表示されます。

キューブ内でのディメンションの順序の最適化ビジネス・データにあまり慣れていない場合、キューブの作成中に、パフォーマンスを低下させるディメンションの順序を指定する可能性があります。同様に、キューブ内のデータの分布が長い間に変わり、キューブの作成中に指定したディメンションの順序が最適でなくなる可能性があります。これらの問題に対処するため、TM1 には、キューブ内のディメンションの順序を最適化することで、メモリーの使用量を減らしパフォーマンスを向上する機能が用意されています。

キューブ内のディメンションの順序を最適化する場合、TM1 ではキューブ構造内のディメンションの実際の順序は変更されません。TM1 は、サーバー上でのディメンションの内部的な順序設定方法は変更しますが、キューブ構造は変更されないため、キューブを参照する規則、関数、アプリケーションは有効に保たれます。

ディメンションの順序を変更すると、キューブのメモリー使用量に対する変更内容の影響を詳細に示す、レポートを即座に表示できます。

次の理由から、最適なキューブの設定を決定する際、開発環境でのみキューブ内のディメンションの順序を最適化する必要があります。

v キューブ内のディメンションの順序を再設定するには、IBM Cognos TM1 サーバーにかなりのメモリー・リソースが必要です。順序再設定プロセス中、TM1 サーバー上の一時 RAM は、順序再設定しているキューブに対して 2 の係数で増加します。例えば、50 MB のキューブでは、再設定に 100 MB の RAM が必要となります。

v 順序再設定では、サーバーに読み取りロックがかかるため、再設定の実行中、すべてのユーザー要求がロックされます。

注: キューブ内のディメンションの順序を最適化するには、ADMIN グループのメンバーである必要があります。最適化オプションは、リモート・サーバー上のキューブに対してのみ使用できます。ローカル・サーバー上のキューブのディメンションの順序を最適化することはできません。また、キューブ内のディメンションの順序を最適化する場合、文字列ディメンションを最後の位置から移動したり、文字列ディメンションを最後の位置に移動したりしないでください。

手順1. サーバー・エクスプローラーの「ツリー」ウィンドウで、最適化するキューブを選択します。


2. 「キューブ」→「ディメンションの並べ替え」をクリックします。

「キューブ・オプティマイザー」ダイアログ・ボックスが開きます。

3. 「ディメンションの新規順序」ボックスのリストでディメンションを選択します。

4. 上方向または下方向をクリックして、キューブ内のディメンションの順序を変更します。

5. 「テスト」をクリックします。

「変動率」ラベルの横にある値に注意してください。この値が負の場合、ディメンションの新しい順序によりメモリー使用量が減るため、効率が向上します。

6. ディメンションの最も効率的な順序を実現するまで、手順 3 ～ 5 を繰り返します。


キューブのプロパティーの編集TM1 を使用すると、OLE DB for OLAP アプリケーションで使用する数値データ・ディメンションと時間ディメンションを指定するキューブのプロパティーや、キューブを自動的または要求時にロードするかどうかを指定するキューブのプロパティーを設定できます。通常、キューブの作成時にこれらのキューブのプロパティーを設定しますが、プロパティーはいつでも編集できます。

数値データ・ディメンションと時間ディメンションの編集OLE DB for OLAP クライアント・アプリケーションには、数値データ・ディメンションと時間ディメンションの規定が含まれています。TM1 クライアントにはこのような規定は含まれていませんが、TM1 を使用して、OLE DB for OLAP クライアントによってアクセスするキューブに数値データ・ディメンションと時間ディメンションを設定できます。

手順1. サーバー・エクスプローラーの「ツリー」ウィンドウで、キューブを選択します。

2. 「キューブ」→「プロパティー」をクリックします。


3. 「数値データ・ディメンション」リストで、数値データ・ディメンションを選択します。

4. 「時間ディメンション」リストで、時間ディメンションを選択します。


要求時ロード・プロパティーの編集デフォルトでは、サーバーの起動時に、TM1 によってすべてのキューブがメモリーにロードされます。これで TM1 データへの高速アクセスが可能になりますが、大量のサーバー・リソースが使用される可能性があります。サーバーにめったにアク


セスされないキューブが含まれている場合、クライアントがキューブ・データにアクセスを試みた場合にのみ、これらのキューブをロードするように設定すれば、リソースを節約できます。

手順1. サーバー・エクスプローラーの「ツリー」ウィンドウで、キューブを選択します。

2. 「キューブ」→「プロパティー」をクリックします。


3. キューブのロード方法を指定します。

v 要求時にキューブをロードするには、「要求時ロード」ボックスをオンにします。

v サーバーの起動時にキューブを自動的にロードするには、「要求時ロード」ボックスをオフにします。


選択リストの作成選択リストは、特定の要素やキューブ・セルに対して有効な値のリストです。管理者が要素やセルの選択リストを定義する場合は、TM1 クライアントのいずれかのキューブを参照する際に指定されたセルで、定義済みの値を含むドロップダウン・メニューを使用することができます。

選択リストが含まれているセルの値は検証済みです。ユーザーはセル用に事前定義された値のいずれかを選択しなくてはなりません。セルに対して有効でない値を入力すると、選択リストの値しかセルに入力できないことを示すエラーが表示されます。

選択リストの使用上の注意次の要件と選択リストを使用する場合の動作に注意してください。

v 配分操作と TurboIntegrator プロセスを介して適用されたセル編集は、検証されません。このいずれかの方法で編集を行うと、有効な選択リストの値に対応していないセル値になることがあります。データ・スプレッド・ダイアログ・ボックスを介してのみ、選択リストを含むセルにデータ・スプレッドを適用することができます。データ・スプレッド・ショートカットを選択リストを含むセルに対して使用することはできません。

v 数値を含む選択リストを定義する場合は、文化的共通のスタイルを使用する必要があります。小数点を表す文字としてピリオド (.) を使用します。文化的共通スタイルは英語スタイルに相当します。

v Excel 2007 で選択リストを使用する場合に、自動計算モードと併せて選択リストを使用する場合は、Excel 2007 Service Pack 2 をインストールする必要があります。Service Pack 2 なしで Excel 2007 を実行する場合は、Excel の計算モードを手動に設定する必要があります。Service Pack 2 なしで自動計算を使用すると、選択リストを含んでいるセルでアクセス・エラーが発生します。


v TM1 Web または TM1 Application Web Cube Viewer で表示される可能性のある選択リスト値に、二重引用符を使用しないでください。 TM1 Web または TM1

Application Web では、選択リスト値に二重引用符が含まれていると、選択リストのコンテンツが表示できず、ビューが使用できなくなる場合があります。選択リストに二重引用符が含まれていても、TM1 Web シートでは問題なく機能します。

v TM1 Web および TM1 Application Web のすべての選択リストには、選択可能なNull 値が自動的に含められます。 TM1 Architect および Perspectives の選択リストで Null 値を使用できるようにするには、静的選択リストで Null 値を明示的に定義する必要があります。 Null 値は、TM1 Architect および Perspectives のディメンションやサブセット選択リストでは使用できません。

v TM1 Web および TM1 Application Web の選択リストでは、特殊文字の HTML

コードはサポートされません。 TM1 Web または TM1 Application Web の選択リストで特殊文字を表示するには、選択リストの作成時に特殊文字そのものを入力しなければなりません。　例えば、選択リストに「より大」の記号を含める場合は、選択リストの作成時に HTML コード > ではなく > を入力する必要があります。

選択リストのタイプ静的、サブセットおよびディメンションの 3 つのタイプの選択リストを作成することができます。

静的選択リスト静的選択リストは、構文 static:value1:value2:value3:value4 を使用する、値のコンマ区切りリストで構成されます。

例えば、static:red:orange:yellow:green とすると、選択リストにred、orange、yellow、および green の値を含むことになります。

静的選択リストの先頭または中間に Null 値を含めるには、選択リストの定義に文字を挿入しないで 2 つのコロンを連続で使用します。例えば、static::value1:value2::value3:value4 とすると、選択リストの value1 の前にNull 値を含むことになります。同様に、static:value1:value2::value3:value4 とすると、選択リストの value2 と value3 の間に Null 値を含むことになります。

静的選択リストの最後に Null 値を含めるには、選択リストの定義の最後にコロンを挿入し、その後に続く値を置きません。例えば、static:value1:value2::value3:value4: とすると、選択リストの value4 の後にNull 値を含むことになります。

サブセット選択リストサブセット選択リストには、規定のサブセットのあらゆる要素に対応する値が含まれています。サブセットのメンバーが変わると、それに応じて選択リストで使用できる値も変わります。

サブセット選択リストは、構文 subset:dimension_name:subset_name を使用して定義されます。


例えば、subset:Products:Winter にすると、Products ディメンションの Winter サブセットのすべての要素を含んだ選択リストになります。

ディメンション選択リストディメンション選択リストには、ディメンションのあらゆる要素に対応する値が含まれています。ディメンションのメンバーが変わると、それに応じて選択リストで使用できる値も変わります。

ディメンション選択リストは、構文 dimension:dimension_name を使用して定義されます。

例えば、dimension:Months は、Months ディメンションのすべての要素を含んだ選択リストになります。

要素属性で選択リストを作成選択リストを作成する最も簡単な方法は、ディメンションのテキスト属性”Picklist”

を定義することです。次に、上述の選択リストのいずれかのタイプを使用してディメンション内の各要素の選択リストのメンバーを指定します。要素に定義された選択リストがある場合は、その要素で識別されるキューブ・セルに、選択リスト値を含むドロップダウン・リストが表示されます。

手順1. サーバー・エクスプローラーで、選択リストを定義するディメンションを右クリックして、「要素の属性の編集」をクリックします。

2. 属性エディターで、「編集」 → 「新規属性の追加」の順にクリックします。

3. 「新規属性」ダイアログボックスに、属性名として"Picklist"と入力します。

4. 属性の型として「テキスト」を選択します。


属性エディターには、”Picklist”というタイトルの新しい列が表示されます。

6. 選択リストを作成する各要素について、要素名と”Picklist”列の交点に有効な選択リストの定義を入力します。

a. 静的選択リストを入力する場合は、static:value1:value2:value3:value4 という構文を使用して値のコンマ区切りのリストを入力します。

b. サブセットの選択リストを入力する場合は、subset:dimension_name:subset_name という構文を使用して選択リストの定義を入力します。

c. ディメンションの選択リストを入力する場合は、dimension:dimension_name

という構文を使用して選択リストの定義を入力します。

7. 「OK」をクリックして属性エディターを閉じ、選択リストの定義を保存します。

コントロール・キューブで選択リストを作成コントロール・キューブで選択リストを作成することもできます。選択リストを含むキューブ・セルをよりよく制御して、個々のセルの選択リストを柔軟に定義する


ことができるようになります。さらに、選択リスト・コントロール・キューブの規則を作成し、1 つのセルからキューブ全体まで、キューブのセクションの選択リストを定義することもできます。

選択リスト・コントロール・キューブは、追加のディメンション”}Picklist”とともに、関連する正規キューブと同じディメンションで構成されています。”}Picklist”ディメンションには、1 つの文字列要素 (Value) が含まれます。

選択リスト・コントロール・キューブの作成以下の手順を使用して、選択リスト・コントロール・キューブを作成します。

手順

サーバー・エクスプローラーで、選択リスト・コントロール・キューブを作成する正規キューブを右クリックし、「選択リスト・キューブの作成」をクリックします。}Picklist_キューブ名の命名規則を使用して新しいコントロール・キューブが作成されます。例えば、”Orders”キューブの選択リスト・コントロール・キューブを作成する場合のコントロール・キューブの名前は、”}Picklist_Orders”になります。

注: サーバー・エクスプローラーでコントロール・キューブを表示できない場合は、「表示」 → 「コントロール・オブジェクトを表示」の順にクリックし、コントロール・キューブとその他のコントロール・オブジェクトを表示します。

コントロール・キューブの各セルの選択リストの定義コントロール・キューブの各セルの選択リストを定義するには、次の手順を実行してください。コントロール・キューブで定義された選択リストは、関連する正規キューブに選択リスト値を表示するために使用されます。

手順1. サーバー・エクスプローラーでコントロール・キューブをダブルクリックします。

Cube Viewer でコントロール・キューブが開きます。

2. 選択リストを定義するセルを表示する場合は、必要に応じてコントロール・キューブのビューを設定します。キューブ・ビューの構成について詳しくは、「TM1

Perspectives, TM1 Architect, and TM1 Web」を参照してください。

3. 選択リストを作成する各セルで、選択リストの定義を入力します。コントロール・キューブには、静的、サブセットまたはディメンションの選択リスト・タイプを入力できます。

4. 「ファイル」 → 「再計算」の順にクリックして、キュー・ビューを再計算します。

規則を使用してコントロール・キューブで選択リストを定義選択リストを定義する規則は、他のすべての TM1 規則と同じ規約に従います。選択リストを定義する規則ステートメントには、領域定義 (規則が適用されるキューブの一部)、文字列修飾子、および式を含め必要があります。選択リスト規則の場合、式は、適用する選択リストの定義になります。


複数の規則ステートメントが重なっている領域に適用される場合は、制限が多い領域から少ない領域にステートメントを並べ替える必要があります。

領域の定義方法の詳細などを含む、規則の作成に関する詳細については、「TM1 規則」を参照してください。

手順1. サーバーエクスプローラで、規則を作成する”}Picklist”コントロールキューブを右クリックし、「規則を作成」をクリックします。

規則エディターが開きます。

2. 標準の規則領域定義を使用して、選択リストを表示するセルを指定します。

3. 領域定義の後に、=S: と入力します。これは文字列修飾子で、規則が文字列セルに適用されることを示します。

4. 文字列修飾子の後に、選択リストの定義を一重引用符で囲み、次に括弧で囲んで入力します。例えば、(’static:spring:summer:winter:fall’) のように入力します。

5. 選択リストの定義の後にセミコロン (;) を入力して、規則ステートメントを終了します。

これらの手順で説明した手順を使用して作成した規則ステートメントは、次の例のようになります。これは、"fabric"要素によって定義されたセルに、"wool"、"cotton"、"silk"、"nylon"の値を含む静的選択リストが表示されることを示しています。

[’fabric’]=S:(’static:wool:cotton:silk:nylon’);

その他の選択リストの例:

次の例では、選択リストを定義する規則ステートメントの例を示します。

規則ステートメント説明

[’size’,’shirts’]=S:(’static:16:17:18’); この規則ステートメントは、size と shirts

の要素で定義されたセルでは、16、17、および 18 の値で構成された静的選択リストが表示されることを示しています。

[’size’,{’sweaters’,’vests’,’jackets’}]=S:(’static:XS:S:M:L:XL’);

この規則ステートメントは、"size"要素と、"sweaters"、"vests"、"jackets"の要素のいずれかで定義されたセルでは、XS、S、M、L、および XL の値で構成された静的選択リストが表示されることを示しています。

[’fabric’]=S:(’dimension:materials’); この規則ステートメントは、"fabric"要素で定義されたセルでは、"materials"ディメンションのすべての要素で構成された選択リストが表示されることを示しています。

選択リストからのセルの除外選択リストを使用する場合、キューブの個々のセルや特定領域が必要でないこともあります。選択リストの表示からセルを除外する場合は、適切な選択リスト・コン


トロール・キューブのセルに none を入力するか、規則ステートメントに式として('none') を使用します。例えば、['season']=S:('none'); のように入力します。

選択リストの Null 値TM1 Web のすべての選択リスト (Web シートと Cube Viewer の両方) には、ユーザーが選択できる Null 値が常に含まれます。Null 値は TM1 Web の全ての選択リストに自動的に挿入されます。定義する必要はありません。

選択リストが静的タイプで、選択リストに対して Null 値が明示的に定義されている場合、TM1 Architect と TM1 Perspectives の選択リストには Null 値のみが含まれます。TM1 Architect と TM1 Perspectives で使用する場合、ディメンション選択リストとサブセット選択リストに Null 値を含むことはできません。

選択リストで Null 値を選択する選択リストから Null 値を選択するには、2 つの方法があります。

手順1. TM1 クライアントのいずれかで、選択リストをクリックして Null 値をクリックすることができます。

重要: TM1 Perspectives スライスとアクティブ・フォームでは文字列セルの Null

値をクリックしないでください。セルから DBRW 書式が削除され、IBM

Cognos TM1 サーバーからそのセルのデータを取得できなくなります。数値セルの Null 値は問題なくクリックすることができます。

2. TM1 Web と TM1 Architect では、選択リストを含んでいるセルで Deleteキーを押して Null 値を選択することができます。

重要: Delete キーを押して TM1 Perspectives スライスやアクティブ・フォームの Null 値を選択しないでください。セルから DBRW 数式が削除され、TM1

Server からそのセルのデータを取得できなくなります。

選択リスト優先順複数の選択リストが個々のキューブ・セルに適用される場合、次の優先順を使用して、セルに使用される選択リストが決定されます。

v 選択リスト・コントロール・キューブが存在し、現在のキューブ・セルの選択リスト定義が含まれている場合は、選択リスト・コントロール・キューブの定義が使用されます。

v 選択リスト・コントロール・キューブが存在しない場合は、”Picklist”要素属性を検索するために逆の順序で現在のセルを識別する要素が調べられます。この検索で検出された最初の”Picklist”要素属性がセルで使用されます。

サーバー間のキューブの複製TM1 の複製機能を使用すると、キューブやその他の関連オブジェクトを、リモート・サーバーからローカル・サーバーに、または 2 台のリモート・サーバー間でコピーできます。指定された間隔で、または要求時に、コピーされたキューブ間のデータ更新を同期することもできます。


複製には、次のような利点があります。

v ネットワークを介して通信せずにキューブをローカルに更新できるため、応答時間を改善できます。

v 最新の共有データをラップトップにコピーして、組織外でプレゼンテーションできる。

TM1 には、複製データを双方向に同期する機能が用意されています。同期プロセス中、TM1 では、複製に関与しているサーバーでデータに対する最新の更新が確認され、最新の更新が他のサーバーにコピーされます。

複製によって、2 つのキューブ間、および 2 台のサーバー間に関係が作成されます。これらの関係については、『キューブの関係』を参照してください。

キューブの関係複製によって、2 つのキューブ間に関係が作成されます。

v ソース・キューブ - 複製における元のキューブ

v ミラー・キューブ - ソース・キューブのコピー

アクセス権限に応じて、多数の異なるサーバー上に単一キューブを複製し、複製されたキューブを複製できます。

サーバーの関係キューブを複製する前に、リモート・サーバーにログオンし、複製接続を作成します。複製によって、2 つのサーバー間に関係が作成されます。

v ソース・サーバー - ログオン先のリモート・サーバー

v ターゲット・サーバー - ログオン元のサーバー

「サーバー・エクスプローラー」ウィンドウの「複製」アイコンの下に、現在の複製接続がリスト表示されます。この例では、regions 1 がターゲット・サーバーで、sales がソース・サーバーです。

必要なアクセス権限キューブを複製するには、次のアクセス権限が必要になります。

v セキュリティー・グループには、複製するキューブに対して、少なくとも読み取り権限が必要となる。

v ターゲット・サーバー上の TM1 管理者である必要がある。ローカル・サーバーでは、常に TM1 管理者となっています。


第 3 章モデルの翻訳

IBM Cognos TM1 は、TM1 Server 上のオブジェクトを他の言語で表示するメカニズムを提供しているので、ユーザーは設定を行わなくても、自分の言語でオブジェクト名を表示できます。

Cognos TM1 では翻訳はキャプション属性を通して行われ、これによって TM1

Server 上のキューブ、ディメンション、メンバー、メンバー属性に翻訳された名前を割り当てることができます。TM1 でサポートされているすべての言語ロケールのキャプション属性値を割り当てることができます。この値は }Cultures コントロール・ディメンション内の各メンバーに対応します。

翻訳をサポートしている TM1 クライアントのいずれかをユーザーが開始すると、設定を行わなくても、ユーザーの現在のロケールに関連付けられている言語のキャプション属性値を使用してオブジェクト名が表示されます。翻訳された値をキューブに追加した場合は、翻訳された属性値がフィルター・ダイアログ・ボックスにも表示されます。

次の TM1 クライアントが翻訳をサポートしています。

v IBM Cognos TM1 Web

v IBM Cognos TM1 Application Web

v IBM Cognos Insight

v IBM Planning Analytics for Microsoft Excel

TM1 Web と TM1 Application Web は、現在のブラウザーの言語設定を使用して、表示する言語を判別します。

IBM Planning Analytics for Microsoft Excel は Windows の「場所」の設定を使用して、表示する言語を判別します。

Cognos Insight は、Windows の「場所」の設定を使用して、Windows のスタート・メニューから開かれた時に表示する言語を判別します。Cognos Insight を TM1

Application Web ワークフロー画面から開くときには、ポータルのユーザー設定で定義されたコンテンツ言語が使用されます。

注: IBM Cognos Performance Modeler は、オプションで TM1 Server 上のオブジェクトの翻訳された名前か不変名を表示できます。不変名とは、元の作成時にオブジェクトに割り当てられた名前のことです。翻訳された名前を表示するには、「モデル設計」ウィンドウでルートを右クリックしてから、「キャプションの表示」をクリックします。不変名を表示するには、「モデル設計」ウィンドウでルートを右クリックしてから、「不変名の表示」をクリックします。

Caption 属性

キャプション属性は、「別名」タイプまたは「テキスト」タイプとして設定できます。キャプション属性が「別名」タイプの場合は、翻訳されたオブジェクト名の表示に属性値が使用されます。さらに、TM1 によりキャプション属性値の固有性が強


制されるので、キャプション値を使用して、関連付けられているディメンション、キューブ、メンバーを検索したり、TM1 Server との間でデータの取得や送信を行う関数に対する引数としてキャプション値を使用したりすることが可能です。

キャプション属性が「テキスト」タイプの場合は、属性値は翻訳されたオブジェクト名を表示するためにのみ使用されます。値が固有である必要はないので、必要に応じて複数の属性に同じ値を使用できます。

注: TM1 Web、TM1 Application Web、または IBM Planning Analytics for Microsoft

Excel で使用するキャプション属性を定義する場合は、キャプション属性を「別名」タイプとして定義してください。TM1 Web および TM1 Application Web では、別名のみ表示するようにキューブ・ビュー・ディメンションを設定できます。さらに、Web シートに表示する SUBNM を定義する場合は、引数として別名のみを使用できます。同じように、IBM Planning Analytics for Microsoft Excel において、SUBNM は別名を引数として取ります。

言語ロケール・コードと Caption 属性の動作

TM1 は、ISO 639-1 で定義されている国際言語コードを使用して主要言語を識別し、IETF 言語タグを使用して特定のロケールを識別します。例えば、「fr」はフランス語を識別しますが、「fr-CA」はカナダ・フランス語を識別します。

「fr」などの主要言語コードの Caption 属性値を割り当てることもできますし、「fr-FR」や「fr-CA」などの関連付けられている特定のロケールの値を割り当てることもできます。

指定された特定のロケールの Caption 属性値が存在しない場合は、関連付けられている主要言語コードの値が TM1 で自動的に取得されます。例えば、「pt-BR」のCaption 属性値が存在していない場合は、TM1 は「pt」の値を取得します。

Caption 属性の値が見つからない場合は、デフォルト基準の属性値が返されます。

}Cultures コントロール・ディメンション内の要素のリストを参照して、TM1 でサポートされている ISO 639-1 と IETF の組み合わせに精通してください。

キューブ名の翻訳キューブ名を他の言語で表示するには、IBM Cognos TM1 サーバー上のすべてのキューブに対してキャプション属性を作成して、翻訳するキューブ名のキャプション値を割り当てる TurboIntegrator プロセスを作成します。

始める前に

TurboIntegrator の使用についての詳細は、「TM1 TurboIntegrator」を参照してください。CubeAttrInsert および CubeAttrPutS を含む、すべての TurboIntegrator 関数の詳細については、「TM1 リファレンス」を参照してください。

このタスクについて

キャプション属性は、別名属性または文字列 (テキスト) 属性のいずれかとして作成できます。キャプション属性を別名として作成することの利点は、別名属性値であ


れば、他の TM1 関数に引数として渡すことができることです。文字列属性値ではこれを行うことはできません。

手順1. 新しい TurboIntegrator プロセスを作成します。

2. 「プロローグ」タブで、キャプション属性を作成します。

Caption を別名属性として作成するには、CubeAttrInsert( ’’, ’Caption’,

’A’); と入力します。

キャプションを文字列属性として作成するには、CubeAttrInsert( ’’,

’Caption’, ’S’); と入力します。

これは、キューブ }LocalizedCubeAttributes dimensioned by }Cubes, }Cultures,

}CubeAttributes を作成します。

3. 翻訳するキューブごとに、TM1 サーバーで使用可能にする各言語につき 1 つのCubeAttrPutS 関数を挿入します。

例えば、Sales キューブと Price キューブをフランス語およびドイツ語で表示する場合、プロセスに以下の 4 つの関数を組み込みます。

CubeAttrPutS( ’Ventes’, ’Sales’, ’Caption’, ’fr’ );CubeAttrPutS( ’Vertrieb’, ’Sales’, ’Caption’, ’de’ );CubeAttrPutS( ’Prix’, ’Price’, ’Caption’, ’fr’ );CubeAttrPutS( ’Preis’, ’Price’, ’Caption’, ’de’ );

4. TurboIntegrator プロセスを保存して実行します。

タスクの結果

プロセスが正常に完了すると、翻訳をサポートする TM1 クライアントには、そのクライアントが実行されているロケール用の翻訳されたキューブ名が表示されます。

ディメンション名の翻訳ディメンション名を他の言語で表示するには、IBM Cognos TM1 サーバー上のすべてのディメンションに対してキャプション属性を作成して、翻訳するディメンション名のキャプション値を割り当てる TurboIntegrator プロセスを作成します。

始める前に

TurboIntegrator の使用についての詳細は、「TM1 TurboIntegrator」を参照してください。DimensionAttrInsert および DimensionAttrPutS を含む、すべてのTurboIntegrator 関数の詳細については、「TM1 リファレンス」を参照してください。


キャプション属性は、別名属性または文字列属性のいずれかとして作成できます。Caption 属性を別名属性値として作成することの利点は、他の TM1 関数に引数として渡すことができることです。文字列属性値ではこれを行うことはできません。

第 3 章モデルの翻訳 49



Caption を別名属性として作成するには、DimensionAttrInsert( ’’, ’Caption’,

’A’); と入力します。

キャプションを文字列属性として作成するには、DimensionAttrInsert( ’’,

’Caption’, ’S’); と入力します。

これは、キューブ }LocalizedDimensionAttributes dimensioned by }Dimensions,

}Cultures, }DimensionAttributes を作成します。

3. 翻訳するディメンションごとに、TM1 サーバーで使用可能にする各言語につき1 つの DimensionAttrPutS 関数を挿入します。

例えば、Model ディメンションをフランス語およびポルトガル語で表示する場合、プロセスに以下の関数を組み込むことができます。

DimensionAttrPutS( ’Modèle’, ’Model’, ’Caption’, ’fr’ );DimensionAttrPutS( ’Modelo’, ’Model’, ’Caption’, ’pt’ );


タスクの結果

プロセスが正常に完了すると、翻訳をサポートする TM1 クライアントには、そのクライアントが実行されているロケール用の翻訳されたディメンション名が表示されます。

メンバー名の翻訳メンバー名を他の言語で表示するには、IBM Cognos TM1 サーバー上の特定のディメンションのすべてのメンバーに対してキャプション属性を作成して、翻訳するメンバー名のキャプション値を割り当てる TurboIntegrator プロセスを作成します。

始める前に

TurboIntegrator の使用についての詳細は、「TM1 TurboIntegrator」を参照してください。AttrInsert および AttrPutS を含む、すべての TurboIntegrator 関数の詳細については、「TM1 リファレンス」を参照してください。


キャプション属性は、別名属性または文字列属性のいずれかとして作成できます。Caption 属性を別名属性値として作成することの利点は、他の TM1 関数に引数として渡すことができることです。文字列属性値ではこれを行うことはできません。




キャプションを別名属性として作成するには、AttrInsert( ’<dim_name>’, ’’,

’Caption’, ’A’); と入力します。この関数は、TM1 サーバー上の <dim_name

のメンバーの別名属性としてキャプション属性を作成します。

キャプションを文字列属性として作成するには、AttrInsert( ’<dim_name>’,

’’, ’Caption’, ’S’); と入力します。

3. 翻訳するメンバー名ごとに、TM1 サーバーで使用可能にする各言語につき 1 つの AttrPutS 関数を挿入します。

例えば、January メンバーをフランス語、ドイツ語、およびポルトガル語で表示する場合、プロセスに以下の関数を組み込むことができます。

AttrPutS(’Janvier’, ’Month’, ’January’, ’Caption’, ’fr’);AttrPutS(’Januar’, ’Month’, ’January’, ’Caption’, ’de’);AttrPutS(’Janeiro’, ’Month’, ’January’, ’Caption’, ’pt’);

初めてオプションの 4 番目の Culture のパラメーター・セットを指定して属性を追加する時、次のようなキューブが作成されます。}LocalizedElementAttributes_yourDimension dimensioned by yourDimension,

}Cultures, }ElementAttributes_yourDimension


タスクの結果

プロセスが正常に完了すると、翻訳をサポートする TM1 クライアントには、そのクライアントが実行されているロケール用の翻訳されたメンバー名が表示されます。

TM1 Web および TM1 Application Web 上では、ビューまたは SUBNM で翻訳された値が選択されるようにするためには、キャプション (または他の翻訳された)別名を表示することを選択する必要があります。翻訳された値をキューブに追加した場合は、フィルター・ダイアログにも翻訳された属性値が表示されます。

第 3 章モデルの翻訳 51

第 4 章ビジネス・データの高度な計算

このセクションでは、関連データを持つセルにリンクして、キューブ値の詳細またはコンテキストを提供できる、「ドリルスルー」のプロセスと規則を作成する方法について説明します。

ビジネス・シナリオの規則の詳細については、「TM1 規則」を参照してください。この資料には、ビジネス環境における規則の作成方法をステップごとに説明するチュートリアルが含まれています。

注: このセクションの規則エディターの画像は、古い規則エディターのものです。新しい規則エディターの画像を見るには、「TM1 規則」を参照してください。

プラットフォームによっては、用意されているサンプル・データのいくつかは、一部のユーザーが利用できない場合があります。

キューブの規則の概要OLAP アプリケーションの最も一般的な計算には、ディメンションに沿ったデータの集計が関わります。TM1 では、集約階層を使用してこれらの計算式を作成します。例えば、“Month”ディメンションでは、1 月、2 月、および 3 月の値を合計した四半期合計を定義できます。

多くのアプリケーションでは、コスト割り当てや為替換算などの集計を含まない計算を実行する必要があります。キューブの規則では、これらの計算を実行する書式を作成できます。

キューブの規則では、次のタスクを実行できます。

v 価格を数量で乗算して、販売金額を算出する。

v 必要に応じて集約を上書きする。例えば、四半期の価格で各月の価格の集計を表示しないようにできます。

v あるキューブのデータを使用して別のキューブで計算を実行するか、キューブ間でデータを共有する。例えば、販売データを損益情報を含むキューブにプルできます。

v 同じ値を複数のセルに割り当てる。

注: TM1 規則を作成または編集するには、ADMIN グループのメンバーである必要があります。

キューブの規則は個々のキューブに関連付けます。コンパイルされた規則はcube_name.rux というファイルに保管されます。規則を定義したキューブがメモリーにロードされると、TM1 はそのキューブが含まれるデータ・ディレクトリーでそのキューブの .rux ファイルを検索します。 .cub ファイルとそれに関連する .rux ファイルは、同じディレクトリー内に存在していなければなりません。そうでないと、規則はロードされません。


規則を作成すると、TM1 は cube_name.blb というファイルも生成します。これには規則エディターのフォーマット情報が含まれています。

注: 規則エディター以外のテキスト・エディターで rux ファイルを編集する場合、対応する .blb ファイルを必ず削除してください。ファイルを削除しない場合、規則エディターの表示は .blb ファイルによって決まるため、.rux ファイルの内容と規則エディターの表示の間に不一致が生じます。

TM1 規則ステートメントを記述するためのガイドライン規則ステートメントの一般的な形式を以下のステートメントに示します。

[Area]=Formula;

変数説明

Area 規則の影響を受けるキューブの部分を指定する。

Formula TM1 がキューブ領域内のセルを計算する方法について説明する。

規則を Area 内の単純な値に制限するには、次のステートメントを使用します。

[Area]=N:>Formula;

規則を Area 内の集約値に制限するには、次のステートメントを使用します。

[Area]=C:>Formula;

一般的な考慮事項v 構文に大文字と小文字の区別はありません。大文字と小文字の両方を使用できます。

v 規則内にスペースを使用して分かりやすくできます。

v 規則ステートメントは、規則エディターの 1 つ以上の行を占有できます。ステートメントには、1 つ以上の書式を含めることもできます。

v 各ステートメントはセミコロン (；) で終了する必要があります。

v コメントを追加し、ステートメントを処理の対象から除外するには、行またはステートメントの先頭に番号記号 (#) を挿入します。以下に例を挙げます。

#The following rule is not active

# [’Gross Margin’]=[’Sales’]*0.53;

Area を記述する構文Area には、キューブ内の 1 つ以上のセルを指定します。

Area 定義を作成する場合、次のガイドラインを考慮する必要があります。

v ディメンション要素を指定しないか、1 つ以上のディメンション要素を指定する。

v 各要素は、キューブの別のディメンションの要素である必要がある。

v 各要素を一重引用符で囲む。


v コンマを使用して各要素を区切る。

v Area 定義全体を括弧で囲む。

次の表に 4 つの Area の例を示します。連続した各例によって範囲が絞り込まれます。

サンプル Area 有効範囲

[ ] キューブ内のすべてのセル。

['January'] “January”要素で指定されるすべてのセル。

['Sales','January'] “Sales”要素と“January”要素で指定されるすべてのセル。

['Germany','Sales','January'] “Germany”要素、“Sales”要素、および“January”要素で指定されるすべてのセル。

Area 定義でのサブセットの使用Area 定義で 1 つの要素の代わりにサブセットを使用するには、すべてのサブセット・メンバーを中括弧で囲みます。

例えば、次の Area 定義は、“Sales”要素に加えて、“January”、“February”、または“March”要素で指定されるキューブのすべてのセルに規則を適用します。

[’Sales’, {’January’, ’February’, ’March’}] =

Area 定義での特殊文字と固有でない要素名の使用1 つのディメンションに固有でない要素を指定する規則、または特殊文字を含むディメンション名用の規則の Area 定義では、構文 'dimensionname':'elementname' を使用できます。

例：

[’Units’,’Mar’,’}Groups’:’ADMIN’]

では、中括弧 (}) 特殊文字を含む“}Groups”ディメンション用の規則を記述できます。

同様に、

[’Units’,’Mar’, ’Region’:’North America’]

では、“North America”要素が“Region”ディメンションに固有でない場合の規則を記述できます。

書式の構文規則書式は、次の項目から構成される式です。

v 数値定数

v 算術演算子と括弧

v 数値関数と文字列関数 -- 「TM1 リファレンス」を参照してください。

v 条件ロジック

v キューブ参照

第 4 章ビジネス・データの高度な計算 55

数値定数規則書式の最も簡単なコンポーネントは、数値定数です。

v 数字、オプションの先行マイナス記号 (-)、およびオプションの小数点から構成される。例えば、5.0、6、-5 です。無効な数値定数の例には、1-、1A、3..4 などがあります。

v 最大 20 文字まで指定できる。

v 指数表記を使用して数値定数を入力できる。

例えば、次の規則ステートメントは、値“200”をキューブ内のすべてのセルに割り当てます。

[ ] = 200;

算術演算子数値定数は、次の算術演算子と組み合わせることができます。

演算子意味

+(プラス記号) 加算

-(マイナス記号) 減算

*(アスタリスク) 乗算

/(スラッシュ) 除算 - ゼロで除算した場合、未定義の値を返し、ビューに N/A と表示します

¥(バックスラッシュ) ゼロ表示除算 - 除算演算子と同じだが、ゼロで割る場合、ゼロを返す。

^(キャレット) べき乗

条件ロジックの使用規則に条件ロジックを組み込むには、IF 関数を使用します。一般的な形式は、次のとおりです。

IF(test, value1, value2)

v IF 関数は、論理テストの結果に応じて 2 つの値のいずれかを返します。

v 式 Test が真の場合、IF 関数は“Value1”を返します。

v 式 Test が偽の場合、IF 関数は“Value2”を返します。

v IF 関数から返されるデータ型は、Value1 と Value2 のデータ型によって決まります。

v Value1 と Value2 は、文字列か数値の同じデータ型である必要があります。

v Value1 が文字列で Value2 が数値の IF 関数を実行すると、エラー・ステートメントが生成されます。

IF ステートメントは、ネストさせることもできます。

IF(test1, value1, IF (test2, value2, value3))


次の表に IF の 2 つの例を示します。

式検索結果

IF (7>6,1,0) 1 になります

IF (7>6, 'True', 'False') 'True' になります

比較演算子の使用次の演算子を使用すると、数値を比較できます。

演算子意味

> より大きい

< より小さい

>= より大きいか等しい

<= 以下

= 等しい

<> と等しくない

2 つのストリング値を比較するには、次の例に示すように比較演算子の前に @ 記号を挿入します。

IF (’A’@=’B’,0,1) yields the number 1.

論理式は、論理演算子と組み合わせることができます。

演算子意味例

& (アンパーサンド) AND (Value1 > 5) & (Value1 < 10)

値が 5 より大きく 10 より小さい場合、“TRUE”を返します。

%(パーセント記号) OR (Value1 > 10) % (Value1 < 5)

値が 10 より大きいか 5 より小さい場合、“TRUE”を返します。

~(チルダ) NOT ~(Value1 > 5)

(Value1 <= 5) と同じです。

パイプ文字 (|) を使用すると、文字列を連結できます。

例えば、次の式は“Rheingold”を返します。


(Rhein | gold)

連結結果の文字列が 254 バイトより長い場合、TM1 はエラーを返します。

キューブ参照の使用すべての規則書式には、キューブ内のデータ用の領域をポイントするキューブ参照が含まれています。キューブ参照は、規則を記述しているキューブ (内部キューブ参照)、または他のキューブ内の領域 (外部キューブ参照) をポイントできます。

内部キューブ参照内部キューブ参照は、規則を記述している領域と同じ構文を使用します。例：

[’January’]

[’Sales’,’January’]

[’Germany’,’Sales’,’January’]

次の例では、TM1 は同じキューブ内の“Germany”の“Sales”に“0.53”を乗算して、“Germany”の“Gross Margin”を計算します。

[’Gross Margin’,’Germany’]=[’Sales’]*0.53;

外部キューブ参照外部キューブをポイントするには、DB 関数を使用します。

DB(’cube’, dimension1, dimension2,...dimensionn)

引数説明

キューブ外部キューブの名前

ディメンション次のいずれかの引数：

v 一重引用符で囲まれた外部キューブのディメンション内の要素の名前。

v 変数表記と呼ばれる、先頭に感嘆符 (!) が付いたディメンションの名前。変数表記を使用した引数は、規則ステートメントが適用されるセル内の現在のディメンション要素を返します。例えば、“Region”ディメンションの“Germany”要素で指定される規則算出セルでは、“!Region”は“Germany”を返します。

v 要素名に解決される式。

外部キューブの各ディメンションに対して dimension 引数を指定します。dimension

引数の順序は、外部キューブ内のディメンションの順序に対応するように指定する必要があります。

次の規則ステートメントでは、内部キューブ内の“Sales”のすべての値は、内部キューブの“Units”を“PriceTab”外部キューブの値で乗算して計算されます。

[’Sales’]=[’Units’]*DB(’PriceTab’,!Region,!Product,!Month)

v “PriceTab”キューブには、価格のみ含まれています。各セルは、“Region”、“Product”、“Month”の 3 つのディメンション内の要素で指定されま


す。内部キューブには、これらのディメンションと少なくとも 1 つの他のディメンション (“Sales”要素と“Units”要素を持つ) が含まれています。

v 内部キューブ内のすべての Sales セルは、“Sales”および内部キューブが“PriceTab”

を共有している 3 つのディメンション内の要素で指定されます。“Sales”セルにデータを移入するために、TM1 によって共有されているディメンションの対応する要素の交点にある“PriceTab”の値がプルされます。

v 外部キューブは、ディメンション数と各ディメンションの要素数の点では、内部キューブと異なる可能性があります。ただし、変数として参照するディメンション (“!Region”や“!Product”など) には、少なくとも内部キューブの対応するディメンションにあるすべての要素が含まれている必要があります。

規則ステートメントの配置規則内の複数のステートメントを同じ領域に適用すると、最初のステートメントが優先されます。

次の例を検討します。Priority という名前のキューブには、Region と Year の 2 つのディメンションがあります。規則には、次の 4 つのステートメントがあります。

[’Germany’, ’Year1’] = 10;[’Year1’] = 5;[’United States’]= 6;[ ] = 2;

次に、“Priority”キューブのサンプル値を示します。すべて前述の規則から算出されたものです。

Region Year 1 Year 2 Year 3

France 5 2 2

Germany 10 2 2

United States 5 6 6

TM1 は、この規則ステートメントを次のように処理します。

v 最初のステートメントは、値“10”を“Germany”の“Year1”セルに割り当てます。最初のステートメントは、すべての“Year1”セルに値“5”の格納を指定する 2 番目のステートメントより優先されます。

v 2 番目のステートメントは、3 番目のステートメントより優先されます。このため、3 番目のステートメントに“United States”のすべての値を“6”にすると指定されていても、“United States”の“Year 1”セルには“5”が格納されます。

v 最後のステートメント [ ] = 2 は、キューブの中のすべての値に 2 を格納することを指定しますが、この規則が適用されるのは、先行ステートメントの対象ではないセルのすべて (France や Year2 など) です。

N: レベルと C: レベルでの異なる規則の指定多くの場合、領域内の C: レベルと N: レベルのセルの処理方法を区別する必要があります。

v N: レベル・セル - 単純要素でのみ指定される。


v C: レベル・セル - 少なくとも 1 つの集約要素で指定される。

領域内の N: レベル・セルにのみ適用される規則ステートメントを記述するには、次の構文を使用します。

[Area] = N:[Formula];

以下に例を挙げます。

[’Sales’] = N:[’Price’]*[’Units’]\1000;

領域内の C: レベル・セルにのみ適用される規則ステートメントを記述するには、次の構文を使用します。

[Area] = C:[Formula];


[’Price’] = C:[’Sales’]\[’Units’]*1000;

キューブ内の特定の領域について C: レベルと N: レベルで異なる計算方法を使用する場合、次の構文を使用できます。

[Area] = N:[Formula A]; C:[Formula B];


[’Price’] =

N:DB(’PriceCube’, !Actvsbud, !Region, !Model, !Month);

C:[’Sales’]\[’Units’]*1000;

規則のバイパスSTET 関数を使用すると、キューブの特定の領域で規則ステートメントの影響をバイパスできます。

例えば、“France”以外のすべての地域に適用される、“Gross Margin”用の規則ステートメントを記述する場合があります。一般的な規則と例外を次の 2 つの方法で記述できます。

v 最初に STET ステートメント、続いて一般的なステートメントを記述する。

[’GrossMargin’, ’France’] = STET;

[’Gross Margin’] = [’Sales’] * 0.53;

v IF 関数を含む 1 つの規則ステートメントを記述する。

[’GrossMargin’] = IF(!Region @= ’France’, STET, [’Sales’]* 0.53);

要素名の修飾規則ステートメントを複数のディメンションに出現する要素で指定される値に制限する場合、次の構文を使用して要素名をディメンション名で修飾します。

[’dimname’:’element’]


例えば、“Total”が“Region”ディメンションと“Product”ディメンションの両方に出現し、規則を“Region”ディメンションの“Total”で指定されるセルに制限する場合、次のように指定します。

[’Region’:’Total’]=

規則エディターと規則ワークシート規則は、次の 2 つのインターフェースを介して作成できます。

v 規則エディター - このセクションの前述のすべての例は、このインターフェースを使用しています。

v 規則ワークシート - 変更済みの Excel ワークシートで、1 つのキューブの規則ステートメントを列 A に入力します。

TM1 は、規則を次の 2 つのファイルに保存します。

cube .xru - 規則ワークシート cube .rux - コンパイル済みファイル

注: 規則エディターを使用すると、規則ワークシートを介して作成した規則を変更することができます。この場合、TM1 は変更内容をワークシートに保存するよう要求します。変更内容を保存しない場合、.xru ファイルと .rux ファイルが同期しなくなります。このため、規則ワークシートを編集して、変更内容をさらに変更できなくなります。該当するセクションに記述したすべての規則は、規則ワークシートおよびディメンション・ワークシートに適用されます。

TM1 がすべての変更内容にアクセスできるようにするには、1 つのインターフェースを規則の作成と保守専用に使用します。

規則ワークシートの作成規則ワークシートを使用して、ローカルまたはリモートのいずれかの IBM Cognos

TM1 サーバー上に規則を作成する場合、TM1 Client の有効なディレクトリーが、「TM1 オプション」ダイアログ・ボックスの「ローカル・サーバーのデータ・ディレクトリー」ボックスに設定されている必要があります。このディレクトリーは、TM1 Client が規則ワークシート (.xru ファイル) を保存する場所です。

注: ディレクトリーを設定しないか、ディレクトリーが無効な場合、TM1 では規則ワークシートを保存できません。

手順1. Excel で、「TM1」 > 「規則ワークシート」 > 「新規作成」をクリックします。

「規則のキューブを選択」ダイアログ・ボックスが開きます。リストには、ローカル・サーバーおよび現在の TM1 セッション中にログオンした任意のサーバー上のキューブが含まれています。

2. キューブを選択して、「OK」をクリックします。

TM1 によって、最初の列幅が 100 であること以外は他の Excel ワークシートと類似した空白の規則ワークシートが表示されます。

3. 次の例のように、各規則ステートメントを列 A の別々の行に配置します。


[’Gross Margin%’]=[’Gross Margin’]\[’Sales’]*100;

[’Price’]=N:DB(’PriceCube’,!actvsbud,!region,!model,!month);

C:[’Sales’]\[’Units’]*1000;

[’Sales’]=N:[’Price’]*[’Units’]\1000;

「TM1」>「書式の編集」をクリックすると、「TM1 の書式の編集 (TM1 EditFormula)」ダイアログ・ボックスにアクセスできます。正確な規則ステートメントの作成に役立つこのダイアログ・ボックスには、規則エディターに備わっているすべての機能があります。規則エディターについては、このセクションの後で説明します。

規則ワークシートの保存規則を TM1 が使用できる形式で保存するには、Excel で「TM1」>「規則ワークシート」>「保存」の順にクリックします。

「保存」オプションは、規則ワークシート・ファイル (cube.xru) を更新し、コンパイル済みの規則ファイル (cube.rux) を作成します。TM1 は、ローカル・サーバーのデータ・ディレクトリーに .xru ファイルを保存し、IBM Cognos TM1 サーバーのデータ・ディレクトリーに .rux ファイルを保存します。TM1 では、新しい規則は直ちにキューブに適用されます。

注: Excel で「ファイル」>「保存」をクリックすると、cube.xru ファイルのみが更新されます。キューブ内で新しい規則を使用するには、コンパイル済みの規則ファイルを作成する必要があります。

規則とディメンションの集約規則は、ディメンション内に定義した集約と協調して動作します。規則を使用して集約を定義することもできますが、パフォーマンス上の理由からお勧めできません。ディメンション内に定義した集約は、非常に大きいが疎らなキューブでは特に、規則算出値に比べてはるかに素早く計算されます。

計算の順序規則は、ディメンション内の集約より優先されます。

TM1 がキューブ・セルおよび集約を規則で算出する場合、TM1 によって最初に規則ステートメントが検査されます。ただし、規則ステートメントが集約結果のセルを参照している場合、TM1 では最初に集約が実行され、結果を使用して規則ステートメントが計算されます。

反対に、集約のみでセルを定義すると、TM1 では集約の実行に必要な値が確認されます。一部の値が計算規則の結果である場合、TM1 では集約を実行する前に規則計算が実行されます。

C: レベル要素の規則による上書き別の集約のコンポーネントである集約値を上書きする規則の記述は、避ける必要があります。


簡単な例でこの問題を説明します。“Product”ディメンションと“Month”ディメンションで構成される“Sales”という名前の 2 ディメンション・キューブがあり、製品(“Total”) と四半期 (“1 Quarter”) 集約が定義されているとします。

Total1 Quarter

1 月

2 月

3 月Prod 4

Prod 3

Prod 2

Prod 1n

n

n

n

n

n

n

総計 (“Total”、“1 Quarter”) を計算するために、TM1 は、各月の製品合計を集約するか、各製品の四半期合計を集約できます。

各月の製品合計を

集約して計算した

総計

各製品の四半期合計を


総計

さらに“Jan”の“Total”製品販売の値を計算する規則を記述し、規則算出値によって“Jan”の個々の製品値が合計されないものとします。図に、“Jan”の“Total”製品の値を“999”として定義する規則を示しています。

[’Jan’,’Total’]=999;

各月の製品合計を集約して総計を計算すると、その値は各月の四半期合計の集約とは異なります。その理由は、“Jan”の製品販売合計の規則算出値によって、“Product”

ディメンションに定義されている自然集約が上書きされるためです。

各月の製品合計を集約して

計算した総計は

正しくないように見える

各月の製品合計を集約して

計算した実際の総計は

1,318

各製品の製品合計を

集約して計算した総計は

正しい

['Jan','Total']=999

規則ステートメントで

計算した

1 月の合計値


TM1 が実行するディメンション集約の順序は、制御できません。さらに、所定の瞬間にどの集約パスが最適であるかに応じて、TM1 がパスを切り替える可能性があります。そのため、Total、1 Quarter の値を同じセッションで 2 回要求して、異なる結果が出ることがあります。

この状況を解決するには、“Total”、“1 Quarter”集約の値を“Month”ディメンションの直接の子の合計として計算する規則ステートメントを記述することで、“Product”ディメンション集約を上書きします。['Total']=ConsolidateChildren('Month') というステートメントで、この計算を実行できます。

ただし、キューブの表示時に、各製品の四半期合計の合計が各月の製品合計の合計と異なるという暗黙の不整合は残ります。このため、他の集約のコンポーネントである C: レベル値の上書きはお勧めできません。

['Jan','Total']=999


計算した

1 月の合計値



総計は正しくない

ように見える



総計は

正しい

規則ステートメント

['Total']=ConsolidateChildren('Month') で

計算した第 1 四半期の合計の集約

規則の積み上げ規則ステートメントは、他の規則ステートメントで定義されたキューブ内のセルを参照できます。TM1 では、最終値を取得するまでこれらの規則ステートメントを積み上げてから、結果を返します。TM1 が対応できる積み上げのレベル数は、使用可能なメモリーでのみ制限されます。

規則スタック内で循環参照が発生するか、積み上げの最大数を超えた場合、TM1 ではエラー・メッセージが表示されます。

Error Evaluating Rule: Possible Circular Reference

次に循環参照の例を示します。

[’Sales’] = [’Units’] * [’Price’] ;

[’Price’] = [’Sales’] / [’Units’] ;

サンプル・アプリケーションこのセクションには、よく使用される規則アプリケーションの例を記載しています。これらの例を調べて、規則の構文と範囲を理解してください。


比率の計算次の例では、規則によって“Gross Margin”を“SalesCube”キューブ内の“Sales”の割合として計算します。この比率を“Gross Margin%”(“Account1”ディメンションの新しい数値要素) に関連付けます。

最初に“Gross Margin%”要素を作成する必要があります。

Margin% 要素の作成"SalesCube" ディメンションに既に "GrossMargin" 要素が含まれているなら、次のセクションにスキップします。“GrossMargin%”要素を“Account1”ディメンションに追加する必要がある場合は、次の手順に従います。


2. “Account1”ディメンションを選択します。

3. 「ディメンション」→「ディメンション構造の編集」をクリックします。


4. 「編集」→「要素の挿入」をクリックします。


5. 「Gross Margin%」と入力し、「追加」をクリックします。


7. ディメンションを保存します。

Margin% 規則の作成Gross Margin% 書式を作成するには、次の手順を実行します。

手順1. サーバー・エクスプローラーで、「Sales Cube」を右クリックします。規則が既にある場合は、「規則の編集」をクリックします。まだ規則を作成していない場合は、「規則を作成」をクリックします。


2. 「領域」をクリックします。

「キューブの参照」ダイアログ・ボックスに、“SalesCube”キューブのディメンションが表示されます。

3. 「Account1」をクリックします。

「サブセット・エディター」ウィンドウが開きます。

4. 左のウィンドウで「Gross Margin%」を選択し、「OK」をクリックします。

「キューブの参照」ダイアログ・ボックスが再度開きます。


規則エディターの入力フィールドに ['Gross Margin%'] と表示されます。


6. 「等号」をクリックします。

7. 「領域」を再度クリックし、「Account1」をクリックします。

8. 「サブセット・エディター」ウィンドウで、「Gross Margin」を選択し、「OK」をクリックします。

9. 「キューブの参照を編集」ダイアログ・ボックスの「OK」をクリックします。

10. 「ゼロ表示除算」をクリックします。

TM1 は、['Gross Margin'] の後に除算記号を配置します。

規則エディターには、2 つの除算ボタンがあることに注意してください。

「除算演算子」 - 結果的にゼロで除算する規則でこの除算演算子を使用すると、TM1 によって未定義の値が返され、ビューに“N/A”と表示されます。

「ゼロ表示除算演算子」 - 結果的にゼロで除算する規則でこの除算演算子を使用すると、TM1 によって値“0”が返されます。

11. 「領域」を再度クリックし、「Account1」をクリックします。

12. 「サブセット・エディター」ウィンドウで、「Sales」を選択し、「OK」をクリックします。

13. 「キューブの参照を編集」ダイアログ・ボックスの「OK」をクリックします。

14. 「乗算」をクリックします。

15. 書式の最後に「100」と入力します。

16. 「セミコロン」をクリックします。

注: すべての規則ステートメントはセミコロンで終了する必要があります。

完全な規則は次のようになります。

[’Gross Margin%’]*[’Gross Margin’]\[’Sales’]*100;

17. 「保存」をクリックします。

タスクの結果

TM1 で規則が保存され、キューブに適用されます。“SalesCube”キューブの下に、新しい Rule オブジェクトが開きます。規則には、常に関連付けられているキューブと同じ名前が付けられます。

生成される規則について新しい規則ステートメントのコンポーネントについて確認します。

v 領域 - TM1 が計算するキューブ領域を指定します。この例では、“Gross

Margin%”要素が規則を介して算出されるすべてのセル値を指定しています。

v 書式 - 計算式を定義します。

v ターミネーター - すべての規則ステートメントをセミコロン (;) で終了します。


['Gross Margin%']=['Gross Margin']¥['Sales']*100;

領域数式ターミネーター

規則の構文について詳しくは、「TM1 規則」を参照してください。

Gross Margin% 値参照サンプル・ビューの“salesmargin%”に、“GrossMargin%”用に計算された値が表示されます。

手順1. 「サーバー・エクスプローラー」ウィンドウで、“SalesCube”キューブの「ビュー」アイコンをクリックします。

2. 「salesmargin%」ビューをダブルクリックします。

Cube Viewer にビューが開きます。

作成した規則を介して算出された“Gross Margin%”の値がビューに表示されます。

キューブ間におけるデータの共有“SalesCube”キューブには価格データは格納されません。このキューブの価格情報は、“PriceCube”と呼ばれる別の 4 ディメンション・キューブに格納されています。

DB 規則関数を使用すると、キューブ間で値を共有できます。値は 1 つのキューブに格納され、他のキューブで参照されます。次の例は、あるキューブの規則が別のキューブの値を参照する方法を示しています。

手順1. サーバー・エクスプローラーで SalesCube 規則をダブルクリックします。


2. 2 行目の入力行にカーソルを置きます。

3. 「領域」をクリックします。

「キューブの参照」ダイアログ・ボックスに、“SalesCube”キューブのディメンションが表示されます。

4. 「Account1」をクリックします。


5. 左のウィンドウで「Price」を選択し、「OK」をクリックします。

「キューブの参照」ダイアログ・ボックスが再度開きます。


規則エディターの入力フィールドに ['Price'] と表示されます。



8. 「データベース参照」をクリックします。

「キューブを選択」ダイアログ・ボックスが開きます。

9. 「PriceCube」を選択して「OK」をクリックします。

「キューブの参照」ダイアログ・ボックスに、“PriceCube”キューブのディメンションが表示されます。


「規則エディター」に次の書式が開きます。

[’Price’]=DB(’PriceCube’,!Actvsbud,!Region,!Model,!Month)

書式は次のように読みます：“Price”要素で指定される“SalesCube”内のすべてのセルは、その値を“PriceCube”キューブ内のセルから取得する。“PriceCube”セルの場所は、“PriceCube”が“SalesCube”と共有している 4 つのディメンションの対応する要素の交点にあります。

例えば、“Actual”、“Germany”、“S Series 1.8 L Sedan”、“Jan”の各要素で指定される“SalesCube”セルは、その値を“Actual”、“Germany”、“S Series 1.8 L

Sedan”、“ Price”、“Jan”の各要素で指定される“PriceCube”セルから取得します。

11. 「セミコロン」をクリックして、書式の最後にセミコロンを配置します。

12. 「保存」をクリックして規則を保存します。

これで“PriceCube”キューブ内の価格を変更し、変更内容が“SalesCube”キューブに反映されていることを確認できます。ただし、“SalesCube”内の価格は、作成した規則を介して算出されているため、編集できません。

サンプル・ビュー“SalesPrice”には、価格値が含まれています。

サンプル・ビュー“SalesPrice”を開くには：

13. 「サーバー・エクスプローラー」ウィンドウで、“SalesCube”キューブの「ビュー」アイコンをクリックします。

14. 「SalesMargin%」ビューをダブルクリックします。

「Cube Viewer」に、Price 値が“PriceCube”キューブからプルされて完備した状態のビューが開きます。

販売の計算前の演習では、価格を“SalesCube”キューブに取り込みました。PriceCube の価格を変更しても、TM1 は SalesCube の、対応する販売の値を変更しません。その理由は、SalesCube の販売の値がキューブ内のデータ値として存在しているためです。“SalesCube”の販売の値を価格と数量から算出する規則を作成する必要があります。

手順1. “SalesCube”キューブで「規則エディター」を再度開きます。

2. ['Price'] 書式の下に、次の規則を入力します。

['Sales']=['Price']*['Units']¥1000;


注: “SalesCube”キューブ内のすべての値は、実際の数値である“Price”値を除き、千円単位です。“Sales”の数値は千円単位のままであるため、規則ステートメントでは 1000 で除算します。

3. 「保存」をクリックして“SalesCube”を保存します。

4. サンプル・ビュー“SalesPrice”を再度開きます。

TM1 によって“Sales”要素で指定されるすべてのセルには陰影が付けられ、これらのセルの値が規則を介して算出されることを示します。

5. “Units”と“Jan”の交点にあるセルに「10000」と入力して、1 月の数量値を 10,000

に変更します。

6. F9 キーを押してセル値を再計算します。

7. 1 月の新しい販売値を確認します。

注: 1 月の Gross Margin% 値が更新されています。この値は、Sales 要素を参照する規則によって算出されるためです。

8. 値 313 を“Jan”と“Sales”の交点にあるセルに復元します。

規則の単純な値への制限前の演習では、販売数値を含むすべてのセルに適用される規則を作成しました。このタイプの規則は、ディメンション内の集約より優先するため、正しくない結果が生成されます。次の演習では、スライス・ワークシートを介して四半期合計を検査し、“SalesCube”規則を単純な値に制限して、集約が正しく機能できるようにします。

手順1. SalesCube の“Sales1qtr”サンプル・ビューを開きます。

2. 「スライス」をクリックして、ビューを Excel ワークシートにスライスします。


スライスは次のようになります。

3. スライス・ワークシートを“Test”という名前で保存します。

4. セル B10 の“1Quarter”の“Sales”値を調べます。

“SalesCube”規則に従うと、この値は四半期価格に四半期数量の 1/1000 を乗算した積です。代わりに、この値は年初 3 カ月の販売の集約である必要があります。ただし、“SalesCube”規則 (現在存在している) から算出された値は、集約を介して算出された値より優先します。これを修正するには、規則を変更して、集約要素の値を計算しないようにする必要があります。

5. 規則エディターに“SalesCube”規則を開きます。

6. 3 行目で、次の書式のように ['Price'] の前に N: を挿入します。

[’Sales’]=N:>[’Price’]*[’Units’]\1000;

制限子 N: は、規則を単純要素のみで指定されるセルに制限します。規則が集約要素に適用されなくなるため、集約が正しく機能します。

7. 「保存」をクリックして、編集された規則を保存します。

8. 「F9」キーを押してテスト・ワークシートを再計算します。

正しい値が“Sales”と“1Quarter”の交点に開きます。


平均価格の計算“Test”ワークシートの“Price”、“1Quarter”の値を調べます。この数値は、1 月、2

月、3 月の価格の合計です。ただし、この数値は 3 カ月の平均価格を反映している必要があります。次の規則ステートメントで目的の値を生成できます。

[’Price’]=C:[’Sales’]\[’Units’]*1000;

制限子 C: は、この規則ステートメントを集約に制限します。つまり、“Price”セルを指定する 1 つ以上の要素が集約要素である場合のみに制限します。

手順1. “SalesCube”キューブで「規則エディター」を再度開きます。

2. 入力フィールドの 3 行目として、Area 定義なしの次のステートメントを入力します。

['Price']=DB('PriceCube',!actvsbud,!region,!model,!month);C:['Sales']¥['Units']*1000;

2 行目に既に“Price”領域を定義しているため、Area 定義は省略します。異なる書式を同じ領域に適用する場合、領域を定義してから、書式を指定します。

3. 「保存」をクリックして、編集された規則を保存します。

4. テスト・ワークシートで、F9 キーを押して再計算し値を更新します。

“Price”、“1Quarter”の値を確認します。まだ値 76、132.59 が表示されています。これは、最初に出現する“Price”、“1 Quarter”セルに適用される次の規則書式がTM1 によって使用されるためです。

[’Price’]=DB(’PriceCube’,!actvsbud,!region,!model,!month);

このステートメントは、“Price”、“Jan”などの N: レベル・セルに対してのみ有用です。“Price”集約値は、2 番目の Price ステートメントを介して計算する必要があります。最初の Price 書式を N: レベル・セルにのみ制限することで、TM1

が 2 番目の Price 書式を集約に適用できるようになります。

注: 規則ステートメントは TM1 によって規則内の出現順に評価されますが、指定された Area の最初の書式が同じ領域の後続の書式より優先します。複数の規則ステートメントが同じ Area に対応している場合、それらを制限の最も少ないものから制限の最も多いものの順に並べる必要があります。詳細については、59ページの『規則ステートメントの配置』を参照してください。

5. 最初の Price 書式を N: レベル・セルに制限するには、「規則エディター」で“SalesCube”規則を開きます。

6. 最初の Price ステートメントの最初の書式部分の前に N: を挿入します。

[’Price’]=N:>DB(’PriceCube’,!actvsbud,!region,!model,!month);

Price 領域の規則全体は次のようになります。

[’Price’]=N:DB(’PriceCube’,!actvsbud,!region,!model,!month);C:[’Sales’]\[’Units’]*1000;


8. “Test”ワークシートで、F9 キーを押して再計算して更新された値を表示します。


すべての“Price”値が正しい計算式を反映し、“1 Quarter”、“Price”の値は、年の最初の 3 カ月の平均となります。

2 つの非対称キューブのリンクほとんどの企業では、“Gross Margin”行の下で間接費を製品別に区分していません。賃借料や光熱費などのこれらの数値は、地域または部門ベースでのみ使用可能です。つまり、コスト数値の構造は、販売数値とは対称的でありません。このため、通常データは別のキューブに格納します。

“SalesCube”キューブ内の販売データに対応するコスト・データは、“PnLCube”キューブで使用可能です。次に 2 つのキューブの比較を示します。

v “PnLCube”は 4 つのディメンションである。コスト・データは、バージョン (実績と予算“Actvsbud”)、地域 (“Region”)、勘定科目 (“Account”)、月 (“Month”) の 4

つのディメンションで構成されます。

v “SalesCube”は 5 つのディメンションである。販売データは、バージョン (実績と予算“Actvsbud”)、地域 (“Region”)、製品 (モデル“Model”)、勘定科目(“Account”)、月 (“Month”) の 5 つのディメンションで構成されます。

v 2 つのキューブは“Region”、“Actvsbud”および“Month”の 3 つのディメンションを共有しています。

v これらのキューブで追跡される数値データは、異なるディメンション内の要素で指定される。“SalesCube”は、“Account1”ディメンションを使用します。“PnLCube”

は、“Account2”ディメンションを使用します。

v “PnLCube”には、“Sales”または“Variable Costs”用のデータはない。これらの値は既に“SalesCube”で詳細に計算されています。

次の演習では、“SalesCube”から販売データと変動費データをプルする、“PnLCube”の規則を記述します。

手順1. 「サーバー・エクスプローラー」ウィンドウで、「PnLCube」を右クリックし、「規則を作成」をクリックします。


2. “PnLCube”の“Sales”値と“Variable Costs”値について、“SalesCube”から対応する値をプルすることを指定する 2 つのステートメントを入力します。

v 入力フィールドの最初の行に、次の Sales 書式を作成します。

[’Sales’]=DB(’SalesCube’, !Actvsbud,!Region, ’Total’,’Sales’, !Month);

v 2 行目に、次の Variable Costs 書式を作成します。

[’VariableCosts’]=DB(’SalesCube’, !Actvsbud, !Region,’Total’, ’Variable Costs’, !Month);


注: “Sales”値と“Variable Costs”値がキューブに表示されます。“Grooss Margin”値も使用可能になっています。その理由は、“account2”ディメンション内に、“Sales”と“VariableCosts”間の差異として“Gross Margin”を定義したためです。


4. Microsoft Excel で、サンプル・ワークシートの“TwoCubes”を開きます。

“TwoCubes”ワークシートは、“SalesCube”と“PnLCube”から数値を同時にプルするように設定されています。このワークシートは、数値が 2 つのキューブ間でどのようにフローするかを示します。

変更の影響がワークシート全体に波及するのを確認できるように、セル B6 の“Units”数値を非常に大きな数に変更してみましょう。

5. セル B6 をクリックして、「100000」を入力します。

6. F9 キーを押してワークシートを再計算します。

“S Series 2.5 L Sedan”の“Units”値の変更によって、このモデルとモデル合計の“Sales”値が変更されます。これらの変更は“PnLCube”の Sales 値に影響を与え、“PnLCube”の“Earnings Before Taxes”値まで波及します。

注: このワークシート内のすべてのセル値は、“SalesCube”または“PnLCube”の 2

つのキューブに対する参照の結果です。ワークシートで値を計算しているわけではありません。

ドリルスルー・プロセスおよび規則の作成セルをより詳細なデータに関連付けるドリル・プロセスとドリル規則を作成できます。このデータは、セルの基礎となる詳細またはセルに関連する他の情報を提供できます。

TM1 ドリルスルーは、次の 2 つのコンポーネントから構成されています。

v ドリル・プロセス - セルに関連付ける詳細データを定義する。

v ドリル割り当て規則 - セルと詳細データ間の関係を定義する。

キューブのドリル・プロセスとドリル割り当て規則を作成したら、プロセスを実行し、詳細データを新しいウィンドウに開くことができます。つまり、新しいレベルの詳細に「ドリルスルー」できます。

ドリル・プロセスの作成ドリル・プロセスは TurboIntegrator プロセスで、新しいウィンドウに開かれる詳細データを定義します。ドリルスルーの開始元のキューブは、起点キューブと呼ばれます。

ドリル・プロセスを作成する前に、起点キューブからのドリル時に開くデータに習熟している必要があります。

手順1. 「サーバー・エクスプローラー」で起点キューブを右クリックします。

2. 「ドリル」→「ドリル・プロセスの作成」をクリックします。

「ドリル・プロセス設定」ウィザードの最初のウィンドウが開きます。

ウィザードには、起点キューブとそのすべてのディメンション用のパラメーター値付きテーブルが表示されます。TM1 は、これらのパラメーター値を使用して


ドリル・プロセスを設定します。ドリル・プロセスを実行して起点キューブから詳細データにドリルすると、TM1 によってパラメーター値が更新され、ドリルスルーが開始するキューブの場所を反映するようになります。

3. 「次へ」をクリックします。

「ドリル・プロセス設定」ウィザードの 2 番目のウィンドウが開きます。

4. 起点キューブからドリルスルーする詳細データの「データ・ソース・タイプ」を選択します。

次の 3 つの「データ・ソース・タイプ」オプションがあります。

オプション説明

ODBC 起点キューブから ODBC ソースにドリルします。ODBC ソースには、IBM Cognos TM1 サーバーが稼働しているコンピューターからアクセスする必要があります。注: 注: TM1 では、Solaris または AIX 上の Oracle ODBC ソースにアクセスするのに、DataDirect ドライバーが必要です。これらのドライバーは TM1 には付属しておらず、別個に入手する必要があります。

キューブ・ビュー起点キューブから別のキューブ・ビューにドリルします。起点キューブと同じサーバーにある任意のキューブにドリルできます。

ビューへのアクセス時に TM1 で割り当て可能な最大メモリー量を超えるキューブ・ビュー・データ・ソースを定義できます。デフォルトでは、“Tm1s.cfg”ファイルの MaximumViewSize パラメーターのメモリーしきい値は、32 ビット・システムでは 100MB、64 ビット・システムでは 500 MB です。

重要：設定ファイルに最大ビュー・サイズを指定しない場合、キューブ・ビューにドリルしようとすると、TM1 によってエラー・メッセージが表示されます。

その他起点キューブから TurboIntegrator がサポートする任意のデータ・ソースにドリルします。

TM1 に、ウィザードで選択したデータ・ソース・タイプのデータ・ソース・オプションが表示されます。

5. データ・ソースを定義します。

v 「ODBC」データ・ソースの場合、次の情報を入力する必要があります。


データ・ソース名起点キューブからのドリル時にアクセスする ODBC データ・ソース名 (DSN)。

ユーザー名 ODBC ソースにログオンするための有効なユーザー名。

パスワード上記のユーザー名で使用するパスワード。



クエリー ODBC ソースから返すデータを定義するクエリー。クエリー結果データは、起点キューブからのドリル時に別のウィンドウに表示されます。

v 「キューブ・ビュー」データ・ソースの場合、次の情報を入力する必要があります。

要素説明

データ・ソース名起点キューブからのドリル時に開くビューの名前。「参照」をクリックしてビュー名を選択するか、ビューを作成します。

v 「その他」データ・ソースの場合、「TurboIntegrator の起動」をクリックしてデータ・ソースを定義します。

6. 「終了」をクリックします。

「プロセスに名前を付けて保存」ダイアログ・ボックスが開きます。

7. 「名前」ボックスにドリル・プロセスの名前を入力します。

注: 最適な方法として、ドリル・プロセスに関連付けられている起点キューブを識別するドリル・プロセス名を使用することをお勧めします。例えば、PriceCube

という名前のキューブから ODBC ソースにドリルするプロセスを作成する場合、ドリル・プロセスに PriceCubeToODBCSource という名前が付けられます。このタイプの命名規則を使用すると、ドリル・プロセスの編集時またはキューブに関連付けられている複数のドリル・プロセスからの選択時に、ドリル・プロセスの指定が簡単になります。


ドリル・プロセスは TM1 によって TurboIntegrator プロセスとして保存されますが、手順 7 で割り当てた名前に文字列 }Drill_ のプレフィックスが付けられます。例えば、ドリル・プロセスを PriceCubeToODBCSource という名前で保存すると、そのプロセスは TM1 によって }Drill_PriceCubeToODBCSource として保存されます。

ドリル・プロセスの編集キューブ・ビュー・データ・ソースでドリル・プロセスを作成すると、TurboIntegrator によって「Generated Statements」領域の上または下にReturnViewHandle('Cube','View') 関数が挿入されます。この領域は、「TurboIntegrator」ウィンドウの「詳細」タブの「エピローグ」サブタブにあります。

ドリル・プロセスのデータ・ソースを変更しても、TurboIntegrator では、関を新しいデータ・ソースで更新しません。この関数が Generated Statements 領域外にあるためです。ReturnViewHandle 関数内のドリル・プロセス用のキューブ・ビュー・データ・ソースを編集する必要があります。


注: ODBC データ・ソースを使用するドリル・プロセスの場合、TurboIntegrator はReturnViewHandle 関数を挿入しません。このため、ドリル・プロセス用の ODBC

データ・ソースを変更する場合、この関数を編集する必要はありません。

手順1. サーバー・エクスプローラーで、ドリル・プロセスが関連付けられている起点キューブを右クリックします。

2. 「ドリル」→「ドリル・プロセスの編集」をクリックします。

「選択」ダイアログ・ボックスが開きます。

3. ドリル・プロセスを選択して、「OK」をクリックします。

「TurboIntegrator」ウィンドウが開きます。

4. 「詳細」タブをクリックします。

5. 「エピローグ」タブをクリックします。

6. 「ReturnViewHandle」関数を編集して新しいビューを反映するようにします。

例えば、“Sales”キューブの“Europe_1Q”ビューをデータ・ソースとして使用する場合、ReturnViewHandle 関数は次のようになります。

ReturnViewHandle(’Sales’,’Europe_1Q’)


8. 「TurboIntegrator」ウィンドウを閉じます。

ドリル・プロセスの削除ドリル・プロセスを削除するには、次の手順を実行します。

手順1. サーバー・エクスプローラーで、ドリル・プロセスが関連付けられている起点キューブを右クリックします。

2. 「ドリル」→「ドリル・プロセスの削除」をクリックします。

「ドリル・プロセスの削除」ダイアログ・ボックスが開きます。

3. 削除するプロセスを選択します。

v 隣接する複数のドリル・プロセスを選択するには、先頭のドリル・プロセスをクリックしてから末尾のドリル・プロセスまでドラッグします。

v 隣接しない複数のプロセスを選択するには、Ctrl キーを押しながら各ドリル・プロセスをクリックします。


ドリル割り当て規則の作成ドリル割り当て規則は、キューブ・セルを関連詳細データにリンクする TM1 規則です。前述のように、関連データには、キューブ・ビュー、ODBC ソース、またはTurboIntegrator 経由でアクセスできる他のデータ・ソースを指定できます。


手順1. サーバー・エクスプローラーで、ドリル割り当て規則を作成する起点キューブを選択します。

2. 「キューブ」→「ドリル」→「ドリル割り当て規則の作成」をクリックします。


詳細データに関連付ける各キューブ領域について、手順 3 ～ 8 を続行します。

3. 「領域」をクリックして、詳細データに関連付けるキューブ・セル(領域) を定義します。

「領域」ボタンをクリックすると、「キューブの参照」ダイアログ・ボックスが開きます。

4. 領域を定義するには、次のいずれかを実行します。

v 領域をキューブ全体として定義するには、「OK」をクリックします。

v 領域定義を絞り込むには、ディメンション・ボタンをクリックし、詳細データに関連付けるセルを定義する要素を選択して、「OK」をクリックします。


6. 「文字列」をクリックします。

7. ドリル・プロセスの名前を一重引用符で囲んで入力し、領域に関連付ける詳細データを定義します。例えば、「'PriceCubeToSource'」と入力します。

注意：ドリル・プロセス名には、}Drill_ プレフィックスを指定しないでください。例えば、}Drill_PriceCubeToSource という名前のドリル・プロセスには、「'PriceCubeToSource'」と入力します。

複数のドリル・プロセスを領域に関連付けることができます。これには、すべてのドリル・プロセスをコンマで区切り、一組の一重引用符で囲みます。

注: 条件ロジックまたは他の関数を使用して、ドリル・プロセスの名前を返すこともできます。

8. 「セミコロン」をクリックします。

セミコロンは、1 つの規則ステートメントの末尾を示します。


タスクの結果

これで、ドリル・プロセスとドリル割り当て規則を作成した詳細データまでドリルスルーできます。

ドリルスルーの例このセクションでは、“SalesByQuarter”キューブからキューブ・データの元のソースであるリレーショナル表にドリルできる、ドリル・プロセスとドリル割り当て規則の作成方法について説明します。このテーブルには月レベルのデータがあり、


“SalesByQuarter”キューブには四半期レベルのデータがあります。リレーショナル・ソースまでドリルスルーすることで、キューブ・データの基礎となる詳細を表示できます。

ODBC データ・ソースの設定このセクションの例では、ODBC ソース (Access データベース) までドリルスルーします。例を確認する前に、ODBC データ・ソースを設定する必要があります。

手順1. Microsoft Windows の「ODBC データ・ソース・アドミニストレーター」ダイアログ・ボックスを開きます。

このダイアログ・ボックスを開く手順は、実行している Microsoft Windows のバージョンに応じて異なります。詳細については、Microsoft Windows のヘルプを参照してください。

2. 「システム DSN」タブの「追加」をクリックします。

「データ・ソースの新規作成」ダイアログ・ボックスが開きます。

3. 「Microsoft Access ドライバー」を選択し、「終了」をクリックします。

「ODBC Access セットアップ」ダイアログ・ボックスが開きます。

4. 「データ・ソース名」ボックスに「TM1 _sample_data」と入力します。

5. 「選択」をクリックします。

「データベースの選択」ダイアログ・ボックスが開きます。

6. “¥install_dir¥Custom¥TM1Data¥PData¥RelationalData”ディレクトリーに移動し、“Sales.mdb”を選択します。

7. 「OK」をクリックして、「データベースの選択」ダイアログ・ボックスを閉じます。

8. 「OK」をクリックして、「ODBC アドミニストレーター」ダイアログ・ボックスを閉じます。

Sales という名前の Access データベースが ODBC ソースとして使用可能になります。例のドリル・プロセスは、この ODBC データ・ソースを使用しています。

ドリル・プロセスの作成これで、“SalesByQuarterCube”キューブ用のドリル・プロセスを作成できます。このドリル・プロセスは、ODBC データ・ソースを、“SalesByQuarterCube”キューブからのドリル時に表示できる詳細データとして定義します。

手順1. サーバー・エクスプローラーで、“SalesByQuarterCube”を右クリックします。

2. 「ドリル」→「ドリル・プロセスの作成」をクリックします。

「ドリル・プロセス設定」ウィザードが開きます。テーブルには、ドリル・プロセス用のデフォルトのパラメーターがあります。

3. 「Year」パラメーター値を選択します。


4. 「要素を選択」をクリックします。

サブセット・エディターが開きます。

5. 「1 Quarter」を選択して「OK」をクリックします。

6. 手順 3～5 を繰り返し、Gross Margin% パラメーター値を「Units」に変更します。

7. 「次へ」をクリックします。

ウィザードの 2 番目の画面が開きます。

8. 「データ・ソース・タイプ」として「ODBC」を選択します。

9. 「データ・ソース名」ボックスの横にある「参照」をクリックし、「TM1_sample_data」を選択します。

10. 「ユーザー名」として「admin」と入力します。

11. 「クエリー」ボックスに、次のクエリーを入力します。

このクエリーは、サンプル Access データベース固有のものです。Access 固有の IIF 関数を使用しており、他のデータベースには使用できません。

SELECT ActvsBud, Region, Model, Account1, Month, DataFROM Sales WHERE ( ActvsBud = ’?actvsbud?’ AND Region = ’?region?’AND Model = ’?model?’ AND Account1 = ’?account1?’ AND

(

IIF( ’?quarter?’= ’1 Quarter’, Month = ’Jan’ OR Month= ’Feb’ OR Month = ’Mar’,

IIF( ’?quarter?’= ’2 Quarter’, Month = ’Apr’ OR Month= ’May’ OR Month = ’Jun’,

IIF( ’?quarter?’= ’3 Quarter’, Month = ’Jul’ OR Month= ’Aug’ OR Month = ’Sep’,

IIF( ’?quarter?’= ’4 Quarter’, Month = ’Oct’ OR Month= ’Nov’ OR Month = ’Dec’,

IIF( ’?quarter?’= ’Year’,TRUE,TRUE)))))

)

)

注: TM1 パラメーター名に対する参照は、必ず疑問符 (?) で囲んでください。

12. 「終了」をクリックします。

「プロセスに名前を付けて保存」ダイアログ・ボックスが開きます。

13. プロセスを RELATIONALTABLE_SalesByMonth として保存します。

タスクの結果

新しいドリル・プロセスが、サーバー上で使用可能なプロセスとして表示されます。プロセス名に、ドリル・プロセスであることを示す }Drill_ プレフィックスが指定されています。

これでドリル割り当て規則を作成して、ODBC データ・ソースを“SalesByQuarterCube”キューブから使用可能にできます。


SalesByMonth のドリル割り当て規則の作成次の手順に従って、RELATIONALTABLE_SalesByMonth プロセスを“SalesByQuarterCube”キューブから使用可能にするドリル割り当て規則を作成します。

手順1. サーバー・エクスプローラーで、“SalesByQuarterCube”を右クリックします。

2. 「ドリル」→「ドリル割り当て規則の作成」をクリックします。


3. 大きなボックスに、次の規則を入力します。

[’Year’] = S:IF( ( ELLEV( ’actvsbud’, !actvsbud ) = 0) &( ELLEV( ’region’, !region)= 0 ) &( ELLEV( ’model’, !model)= 0 ) &( ELLEV( ’account1’, !account1) = 0),’RELATIONALTABLE_SalesByMonth’, ’’ );[] = S:IF( ISLEAF= 1, ’RELATIONALTABLE_SalesByMonth’,’’);

この規則は、次のいずれかのセルから「ドリル」オプションを選択したときに、RELATIONALTABLE_SalesByMonth ドリル・プロセスが実行されることを示します。

v “Year”要素と他のすべてのディメンションの 0 レベル要素で指定されたセル

v すべての 0 レベル要素で指定されたセル

4. 規則を保存します。

これで“SalesByQuarterCube”キューブのドリルスルー機能をテストできます。

ドリルスルー例の表示ドリル・プロセスとドリル割り当て規則の結果を表示するには、次の手順を実行します。

手順1. “SalesByQuarterCube”の“Drill_relational”ビューを開きます。

2. “Units”と“Year”の交点にあるセルを右クリックします。

3. 「ドリル」をクリックします。

TM1_sample_data データ・ソースの抽出が開き、セルの月別詳細が表示されます。

4. 「OK」をクリックして、ウィンドウを閉じます。

5. “Drill_relational”ビュー内の他のセルをドリルスルーして、月別詳細を表示します。ビュー内のすべてのセルをドリルスルーできるはずです。

6. “Region”タイトル要素を“Germany”から“Europe”に変更します。

7. ビュー内の任意のセルを右クリックします。

タスクの結果

「ドリル」オプションは使用不可になっています。“SalesByQuarterCube”のドリル割り当て規則で、「ドリル」オプションを使用できるのが、0 レベル要素で指定されるセル、または“Year”要素と 0 レベル要素で指定されるセルのみとなっているため


です。“Europe”は集約であるため、「ドリル」オプションは使用できません。

規則統計のモニター規則に含まれる個々の規則ステートメントが実行される頻度や実行の所要時間に関する洞察を提供する、規則統計をモニターできます。


規則の実行に関する統計は、}StatsByRule コントロール・キューブに保管されます。

規則が変更またはコンパイルされるたびに、}StatsByRule コントロール・キューブ内のその規則のデータが消去されて更新されます。そのため、規則の変更による影響を即時に確認できます。}StatsByRule コントロール・キューブ内のデータは、サーバー・セッション間で保持されません。つまり、TM1 サーバーを再始動するたびに消去されます。

}StatsByRule キューブには、次の 3 つのディメンションが含まれています。

v }Cubes - TM1 サーバー上の各キューブに対応する要素を格納します。

v }LineNumber - TM1 規則 .rux ファイル内の行番号に対応する要素 1 から要素10,000 までを格納します。

ヒント: TM1 規則エディターに行番号は表示されません。規則の行番号を表示するには、行番号をサポートしているテキスト・エディターで .rux ファイルを開いてください。

v }Rules Stats - 規則に関して収集された、以下の情報および統計に対応する要素を格納します。

– 規則のテキスト - ステートメントを識別できるように提供されている、規則ステートメントの最初の部分。

– 合計実行回数 - 規則ステートメントが実行された合計回数。

– 最小時間 - 規則ステートメントの実行に費やされた最小時間 (ミリ秒数)。

– 最大時間 - 規則ステートメントの実行に費やされた最大時間 (ミリ秒数)。

– 合計時間 - 規則ステートメントの実行に費やされた合計時間 (ミリ秒数)。

– 最終実行時間 - 規則ステートメントの最後の実行に費やされた時間 (ミリ秒数)。

規則統計の収集は、}CubeProperties コントロール・キューブの RULE_STATS プロパティーを「はい」に設定することにより、キューブごとに有効にされます。

注: 規則統計の収集には、わずかなパフォーマンス・コストがかかります。このパフォーマンス・コストは、規則の実行頻度によって増加します。統計の収集は、規則のデバッグや調整をするときにのみ有効にしてください。通常の操作中は、統計の収集を無効にする必要があります。

手順1. }CubeProperties コントロール・キューブを開きます。


2. 統計を収集する規則ごとに、キューブ名と RULE_STATS プロパティーの交点にあるセルに「はい」と入力します。

注: RULE_STATS は動的パラメーターです。サーバーを再始動しなくても適用されますが、プロパティーが適用されるまでに最大 60 秒の遅延が生じる可能性があります。

これで、TM1 サーバーが、RULE_STATS プロパティーが「はい」に設定された規則の統計を収集するようになります。この時点から、規則が実行されると、}StatsByRule コントロール・キューブにデータが保管されることになります。

規則統計の収集を無効にするには、RULE_STATS プロパティーを「いいえ」に設定します。

3. }StatsByRule コントロール・キューブを開きます。

4. TM1 規則のステートメントごとに保管された統計を確認します。これらの統計は、意図された頻度より頻繁に実行されているステートメントや、実行時間が長いステートメントを特定するのに役立ちます。この情報を使用して、規則を変更できます。

このビューの }LineNumber 要素は、関連付けられている .rux ファイル内の行番号に対応します。規則ステートメントが .rux ファイル内で複数の行を占めている場合、このビューに示される行番号は、その規則ステートメントが開始する行の番号です。


最小時間、最大時間、平均時間、最終実行時間、合計時間として記録される時間は、ミリ秒 (1/1000 秒) 単位です。規則ステートメントが 1 ミリ秒未満で実行された場合、時間のエントリーは 0 となります。合計時間は 0 として示されていても、単純な規則ステートメントが複数回実行されている場合があります。

5. 別の規則の統計を表示するには、ビューの最上部にある }Cubes ディメンションから、関連するキューブ名を選択します。

規則のデバッグTM1 には、規則の開発とデバッグに役立つ規則トレーサーと呼ばれるツールが用意されています。規則トレーサー機能は、Cube Viewer のみで使用可能です。

規則トレーサーを使用すると、次の操作を実行できます。

計算のトレース規則が選択したセルに割り当てられ、正しく計算されていることを確認するか、集約要素のパスをトレースします。

フィーダーのトレース選択したリーフ・セルが他のセルに正しくフィードしていることを確認します。

フィーダーのチェック選択した集約セルの子に正しくフィードされることを確認します。

計算のトレース集約であれ規則計算であれ、計算をトレースするには、計算式を含むセルを右クリックし、「計算のトレース」をクリックします。

「規則トレーサー」ウィンドウが開きます。ここから、計算をリーフ・レベルのコンポーネントまでトレースできます。「規則トレーサー」ウィンドウには、次の 2

つのウィンドウがあります。

v 計算のトレース (上部のウィンドウ) - 現在のセルの場所の定義を、セルの値の

算出元が集約または規則を示すアイコン付きで表示します。セルの現在の値も表示します。値が規則から算出された場合、「計算のトレース」ウィンドウのステータス・バーに規則が表示されます。

v トレース (下部のウィンドウ) - 最初の集約要素のコンポーネント、またはセル定義の最初の規則を表示します。下部のウィンドウの任意のアイテムをダブルクリックし、セルを定義しているリーフ・レベル要素へのパスをトレースできます。

規則計算のトレース例 (単純)規則計算をトレースする単純な例を表示するには、次の手順を実行します。

手順1. “SalesCube”キューブの“Trace_simple”ビューを開きます。

このビューには、このセクションの前で作成した規則から算出した“Price”値があります。


2. “Price”と“Jan”の交点にあるセルを右クリックします。

3. 「計算のトレース」を選択します。

「規則トレーサー」ウィンドウが開きます。

上部の「計算のトレース」ウィンドウに、TM1 は現在のセルの定義を、セル値が規則を介して算出されることを示す規則アイコンと共に表示します。セルに適用される規則には陰影が付けられ、セルの算出値がウィンドウの右下隅に表示されます。

TM1 では、下部の「トレース」ウィンドウに、現在のセルに適用される規則の評価が表示されます。例：


この規則は次のように評価されます。

[’Price’]=PriceCube(Actual, Germany, L Series 1.8L Sedan,Jan)

その理由は、現在のセルの場所が N: レベルであるためです (集約で定義されていない)。

セル SalesCube(Actual, Germany, L Series 1.8L Sedan, Price, Jan) の値がPriceCube(Actual, Germany, L Series 1.8L Sedan, Jan) から取得されることがわかります。

集約のトレース例 (複雑)前の単純な例では、規則トレーサーが N: レベルのセルに対してどのように機能するかを示しました。次の例では、規則トレーサーを使用して集約を含む値をトレースする方法を示します。

手順1. “SalesCube”キューブの“Trace_complex”ビューを開きます。

2. “Sales”と“1 Quarter”の交点にあるセルを右クリックします。

3. 「計算のトレース」をクリックします。

規則トレーサーが開きます。

上部の「計算のトレース」ウィンドウに、TM1 は現在のセルの定義を、セル値

が集約を介して算出されることを示す「集約」アイコンと共に表示します。集約セルの値がウィンドウの右下隅に表示されます。

TM1 では、下部の「トレース」ウィンドウに、セル定義の最初の集約要素のコンポーネントが表示されます。この例では、“T Series”が SalesCube(Actual,

Germany, T Series, Sales, 1Quarter) の最初の集約要素です。TM1 では、T Series

コンポーネントがその値と共に表示されます。

4. 「トレース」ウィンドウの“T Series 2.8L Coupe”をダブルクリックします。

ここで、“T Series 2.8L Coupe”を介して SalesCube(Actual, Germany, T Series,

Sales, 1Quarter) の値をトレースします。


「計算のトレース」ウィンドウに、ダブルクリックした要素のセル定義が表示されます。

SalesCube(Actual, Germany, T Series 2.8L Coupe, Sales,1 Quarter)

「トレース」ウィンドウに、このセル定義の最初の集約要素のコンポーネントが表示されます。SalesCube(Actual, Germany, T Series 2.8L Coupe, Sales, 1

Quarter) の最初の集約要素は“1 Quarter”です。TM1 に、“Jan”、“Feb”、および“Mar”の 3 つのコンポーネントがその値と共に表示されます。

「トレース」ウィンドウでは、各コンポーネント名の前に、その値が規則を介して算出されることを示す「規則」アイコンが付いています。

5. 「トレース」ウィンドウの“Jan”をダブルクリックします。

ここで、“T Series 2.8L Coupe”および“Jan”を介して SalesCube(Actual, Germany,

T Series, Sales, 1Quarter) の値をトレースします。

「計算のトレース」に、ダブルクリックした要素のセル定義が表示されます。この場合、“SalesCube(Actual, Germany, T Series 2.8L Coupe, Sales, Jan)”です。このセルは、陰影が付けられた規則 ['Sales']=N:['Price']¥['Units']*1000 によって計算されます。セルの集約値、“18730.0772”がウィンドウの右下隅に表示されます。

「トレース」ウィンドウに、規則書式のコンポーネントと値が表示されます。Price コンポーネントの値は 43156.86 で、別の規則によって算出されたものです。Units コンポーネントの値は 434 で、これはグレー・ブレットで示された入力値です。

これらの値を規則書式にプラグインすると、(43156.86 X 434)¥1000 =

18730.0772 となり、SalesCube(Actual, Germany, T Series 2.8L Coupe, Sales, Jan)

の値を確認できます。

6. 「Price」をダブルクリックして、“Price”値の算出に使用される規則を表示します。

次の規則で“Price”が計算されます。


この規則は次のように評価されます。

PriceCube(Actual, Germany, T Series 2.8L Coupe, Jan)

これは、「トレース」ウィンドウに、グレー・ブレットで示された入力値として表示されます。つまり、これ以上計算をトレースできません。

新しい計算経路のトレース規則トレーサーの「計算のトレース」ウィンドウのセル定義をクリックして、新しい計算経路のトレースを開始します。

例えば、前の複雑な例を使用し、「計算のトレース」ウィンドウの最初のセル定義をクリックすると、“T Series”集約を介して新しいパスのトレースを開始できます。


「計算のトレース」ウィンドウのセル定義をクリックすると、「トレース」ウィンドウに、セル定義の最初の集約要素のコンポーネントが表示されます。次に、任意のコンポーネントをダブルクリックして、新しい計算経路のトレースを開始します。

フィーダーのトレース規則トレーサーを使用すると、選択したセルが他のセルにフィードする方法をトレースできます。

他のセルにフィードできるのはリーフ要素のみであるため、「フィーダーのトレース」コマンドは、規則で定義したリーフ・セルには使用可能ですが、集約セルには使用できません。

手順1. Cube Viewer で、トレースするセルを右クリックします。

2. 「フィーダーのトレース」をクリックします。

「規則トレーサー」ウィンドウが開きます。このウィンドウには、次の 2 つのウィンドウがあります。

v フィーダーのトレース (上部のウィンドウ) - 現在のセルの場所の定義と現在のセルに関連付けられているフィーダー規則を表示します。

v トレース (下部のウィンドウ) - 現在のセルによってフィードされる場所を表示します。

3. 「トレース」ウィンドウの場所をダブルクリックします。

この場所が「フィーダーのトレース」ウィンドウの現在のセルの場所になり、「トレース」ウィンドウに現在のセルによってフィードされる場所が表示されます。

4. フィーダーを必要なレベルまでトレースするまで、「トレース」ウィンドウ内の場所のダブルクリックを続行します。

フィーダーのチェックキューブに SKIPCHECK ステートメントと FEEDERS ステートメントを使用した規則が含まれている場合、規則トレーサーを使用して、TM1 によって集約のコンポーネントに正しくフィードされていることをチェックできます。

手順1. Cube Viewer で、チェックする集約セルを右クリックします。

2. 「フィーダーのチェック」をクリックします。

規則トレーサーが開きます。このウィンドウには、次の 2 つのウィンドウがあります。

v フィーダーのチェック (上部のウィンドウ) - 現在のセル (集約) の定義を表示します。

v トレース (下部のウィンドウ) - 正しくフィードされていない集約のすべてのコンポーネントを表示します。


「トレース」ウィンドウは空になっています。つまり、集約は正しくフィードされており、キューブの値は正確です。

「トレース」ウィンドウに集約のコンポーネントが表示される場合、現在のキューブに関連付けられている規則を編集して、リストされているすべてのコンポーネントにフィードする FEEDERS ステートメントを追加する必要があります。

注: TM1 セッションごとに一度だけ、セルの FEEDERS をチェックできます。FEEDERS をチェックする操作で、集約のコンポーネントに実際にフィードが行われます。その後 FEEDERS をチェックしても、正確な結果は得られません。セルに対して複数回 FEEDERS をチェックする場合、それぞれのチェック前にIBM Cognos TM1 サーバーをリサイクルする必要があります。


第 5 章 TM1 Applications でのオブジェクトの構成

IBM Cognos TM1 では、オブジェクトをアプリケーション別、タイプ別に論理的に構成できます。このセクションでは、TM1 アプリケーションを作成する方法について説明します。

TM1 アプリケーションの概要TM1 アプリケーションは、仮想フォルダーとして機能するオブジェクトであり、他の TM1 オブジェクト、ファイル、および URL へのショートカットを、論理的なジョブ特有のグループ別に構成します。

例えば、北米販売組織用にすべての TM1 オブジェクトと関連ファイルを構成するアプリケーションを作成することもできます。

オブジェクト、ファイル、URL をアプリケーションに挿入するには、ショートカットまたは参照を作成します。アプリケーションや参照を使用すると、参照がポイントするターゲット・オブジェクトを素早く系統的に開くことができます。

['Jan','Total']=999


計算した

1 月の合計値



総計は正しくない

ように見える



総計は

正しい

規則ステートメント

['Total']=ConsolidateChildren('Month') で

計算した第 1 四半期の合計の集約

参照のタイプIBM Cognos TM1 アプリケーションには、次の任意のアイテムへの参照を含めることができます。

TM1 オブジェクトアプリケーションには、規則と複製以外の任意のタイプの TM1 オブジェクトへの参照を含めることができます。

アプリケーションを含む同じ IBM Cognos TM1 サーバーまたはアクセス権限がある他の TM1 サーバー上で、TM1 オブジェクトを参照できます。

ファイルアプリケーションは、Excel スプレッドシート、Word 文書、他のファイルなど任意のファイル・タイプを参照できます。Excel ファイルは、TM1 スライス、関数、または他の TM1 機能を組み込んでいるかどうかに無関係に参照できます。


外部ファイルとアップロードされたファイルの両方を参照できます。

外部ファイルの参照では、ネットワーク上の任意の共有ディレクトリーに存在できるファイルへのショートカットが提供されます。

アップロードされたファイルの参照では、TM1 サーバー上に元のファイルのコピーが保存されます。ただし、TM1 外の元のソースファイルに対する変更は、TM1 サーバー上のアップロードされたファイルのコピーには自動的に反映されません。サーバー上のファイルを更新して、変更を使用可能にする必要があります。

URL アプリケーションには、HTTP または HTTPS プロトコルを使用する任意のWeb ページまたはリソースへのリンクを含めることができます。

参照の動作オブジェクト参照とファイル参照をアプリケーションに追加する場合、これらの参照は元の IBM Cognos TM1 オブジェクトまたはファイルを開くショートカットとして、参照用にのみ存在することを理解することが重要です。アプリケーション内の参照の削除は、ソースの TM1 オブジェクトやファイルの削除とは異なります。

v アプリケーションから参照を削除しても、対応するソースの TM1 オブジェクトやファイルに影響はありません。参照のみ削除されます。

v TM1 内のソース・オブジェクト、またはディスク上のファイルを削除すると、アプリケーション内の対応する参照が解除されますが、参照は削除されません。参照は残りますが、ソース・オブジェクトやファイルが削除されると、機能しなくなります。

上記の 1 つの例外は、アップロードされたファイルの参照です。この場合、ファイルは実際に IBM Cognos TM1 サーバーにコピーされます。アップロードされたファイルへの参照を削除すると、アップロードされたファイルのコピーが、TM1 によって TM1 サーバーから削除されます。

ファイル参照の詳細については、 98ページの『ファイル参照のアプリケーションへの追加』を参照してください。

アプリケーション内の参照の表示順序TM1 は、アプリケーション内の参照を次の順序で表示します。各参照グループ内では、TM1 によってアルファベットの降順でソートされます。

v キューブ

v ビュー

v ディメンション

v サブセット

v プロセス

v 日課

v ファイルと URL

注: 参照グループの表示順序や参照グループ内のソート順を設定することはできません。


TM1 Web でのアプリケーションと参照の使用サーバー・エクスプローラーで TM1 アプリケーションと参照を作成すると、自動的に TM1 Web で使用可能になります。これはキューブ、ビュー、ファイル、および URL への参照に適用されます。

詳細については、 110ページの『TM1 アプリケーションの TM1 Web への発行』を参照してください。

TM1 サーバーのアプリケーション・フォルダーとファイルTM1 アプリケーションをサポートするフォルダーとファイルは、IBM Cognos TM1

サーバーのデータ・ディレクトリー内に保存されます。

フォルダー

TM1 アプリケーション・フォルダーの構造は、以下の場所に組織されています。

TM1 Data Directory \ }applications

参照およびアップロードの両方のファイルに関する情報は、関連するここのサブフォルダーに保存されます。

参照したファイル

参照ファイルに関する情報は、.extr 拡張子の付いたプレースホルダー・ファイルに保存されます。

例えば、sheet1.xls という名前のファイルへのアプリケーション参照を作成した場合、TM1 は、このエントリーを追跡するために sheet1.xls.extr という名前のプレースホルダー・ファイルを作成します。

アップロード・ファイル

アップロード・ファイルに関する情報は、.blob 拡張子の付いたプレースホルダー・ファイルに保存されます。

TM1 サーバーにアップロードする実際のファイルは、以下の場所に保存されます。

TM1 Data Directory \ }Externals

例えば、ファイルを Planning Sample データベースにアップロードする場合は、以下の場所に保存されます。

C:\Program Files\Cognos\TM1\Custom\TM1Data\PlanSamp\}Externals\

TM1 は自動的に日付と時刻を、アップロードするファイルのファイル名の後に付けます。接尾辞は、年月日時間.ファイル拡張子を使用します。

例えば、ファイル Sample_Budget.xls を Planning Sample Database にアップロードすると、TM1 はその名前を Sample_Budget.xls_20090617155650.xls に変更し、以下の場所に保存します。

C:\Program Files\Cognos\TM1\Custom\TM1Data\PlanSamp\}Externals\Sample_Budget.xls_20090617155650.xls

第 5 章 TM1 Applications でのオブジェクトの構成 91

アプリケーションの作成と表示に関するセキュリティー上の考慮事項次の表では、TM1 アプリケーションに関連する操作の実行に必要なセキュリティー権限について説明します。

詳細については、 106ページの『TM1 アプリケーションのセキュリティーの管理』を参照してください。

操作必要なセキュリティー権限

最上位レベルのアプリケーションを作成する ADMIN または DataAdmin グループのメンバーである必要がある

セカンダリー・レベルのアプリケーションを作成する

親アプリケーションに対する Admin アクセス権限

アプリケーションと参照を表示し使用する読み取り

アプリケーションに個人用参照を追加する読み取り

個人用アプリケーションを発行する ADMIN または DataAdmin グループのメンバーである必要がある

共有オブジェクトに対する個人用参照を発行する

Admin

個人用オブジェクトに対する個人用参照を発行する

実行不可

共有アプリケーションまたは参照を個人用にする

Admin

共有アプリケーションまたは参照を削除する Admin

個人用アプリケーションを削除する Admin

個人用参照を削除する読み取り

アプリケーションの作成と管理アプリケーションを IBM Cognos TM1 サーバーに追加するには、まず ADMIN または DataAdmin グループのメンバーが最上位レベル・アプリケーションを 1 つ以上作成する必要があります。

最上位レベル・アプリケーションとは、サーバー・エクスプローラーの“アプリケーション”グループのすぐ下に表示されるアプリケーションです。セカンダリー・レベル・アプリケーションは、 98ページの『新規オブジェクトの作成と並行した参照のアプリケーションへの追加』で説明されているように、親アプリケーション内に表示されます。


次の例では、アプリケーション・グループ (“アプリケーション”)、3 つの最上位レベル・アプリケーション (European Sales、North American Sales、および PacRim

Sales)、および PacRim Sales 最上位レベル・アプリケーションの下に 2 つのセカンダリー・レベル・アプリケーション (China と Indonesia) があります。

最上位レベル・アプリケーションの作成最上位レベル・アプリケーションを作成するには、次の手順を実行します。

手順1. アプリケーション・グループが IBM Cognos TM1 サーバーに表示されることを確認します。グループが表示されない場合は、サーバー・エクスプローラーで「表示」→「アプリケーション」をクリックします。

2. サーバー・エクスプローラーで、アプリケーションを作成するサーバー上の“アプリケーション”グループを右クリックし、「新規アプリケーションの作成」をクリックします。

TM1 では、選択した“アプリケーション”グループに、「新しいフォルダー」という名前の新しい最上位レベル・アプリケーションが一時的に挿入されます。

3. 新しいアプリケーションに名前を割り当てます。

注意：Microsoft Windows には予約されたデバイス名がいくつかあり、それらをフォルダーやファイルの名前として使用することはできません。予約デバイス名の最新リストに関しては、MS Windows の Web サイトを参照してください。

すべてのアプリケーションは、作成したユーザーだけがアクセスできる個人用オブジェクトです。他の TM1 ユーザーに使用可能にするには、アプリケーションを発行する必要があります。TM1 Architect と TM1 Perspectives のユーザーのみ、共有アプリケーションを作成できます。TM1 Client ユーザーは個人用アプリケーションのみ作成できます。

4. アプリケーションを右クリックし、「セキュリティー」→「共有にする」をクリックして、アプリケーションを他のユーザーが使用できるようにします。

注: アプリケーションに使用されるアイコンのタイプは、アプリケーションの個人用または共有ステータスによって異なります。

v 個人用アプリケーションには、右上隅に鍵を持つ「個人用アプリケーショ

ン」アイコンが表示されます。

v 共有アプリケーションには、「共有アプリケーション」アイコンが表示されます。


これで、参照やセカンダリー・レベル・アプリケーションをアプリケーションに追加することができます。

アプリケーションの名前の変更アプリケーションの名前を変更するには、次の手順を実行します。

手順1. サーバー・エクスプローラーでアプリケーションを右クリックします。

2. 「名前を変更」をクリックします。

現在のアプリケーション名が選択され、編集できるようになります。

3. アプリケーションの新しい名前を入力します。

4. Enter キーを押します。

アプリケーションの削除ADMIN 権限を持つアプリケーションについては、共有または個人用を問わず、削除できます。

注: アプリケーションを削除すると、IBM Cognos TM1 はそのアプリケーションに含まれているすべてのサブアプリケーションと参照を削除します。

アプリケーションに対して ADMIN 権限を持つ場合、TM1 によって「TM1 セキュリティー割り当て」ウィンドウ経由で適用されるセキュリティー権限に無関係に、アプリケーション内のすべての参照とサブアプリケーションに対しても ADMIN 権限を持つ必要があります。このため、アプリケーションに ADMIN アクセスを行う場合、読み取りまたはなし権限しか割り当てられていないサブアプリケーションと参照を削除できます。

アプリケーションを削除するための ADMIN 権限を説明するために、次の例を検討します。サーバー上に 3 つのアプリケーション (App1、App2、および App3) があり、すべて ADMIN グループのメンバーによって作成されたものです。

管理者は、“North America”ユーザー・グループについて、アプリケーションに対する次のセキュリティー権限を定義しています。

アプリケーション名North America ユーザー・グループのセキュリティー権限

App1 Admin

App2 読み取り

App3 なし

この場合、“North America”ユーザー・グループのメンバーが IBM Cognos TM1 サーバーにログオンすると、ADMIN 権限を持つ App1、および読み取り権限を持つApp2 が表示されます。App3 は、権限がなしのため表示されません。


ここで、“North America”ユーザー・グループのメンバーが App1 の削除を試みると、削除は成功します。“North America”ユーザー・グループは、App1 に対してADMIN 権限 (アプリケーションを削除できる) を持つため、これは想定どおりです。ただし、“North America”ユーザー・グループには、App2 と App3 に対してそれぞれ読み取り権限となし権限が割り当てられているにも関わらず、これらのアプリケーションもその中に格納されている参照と共に警告なしで削除されます。


2. 「削除」をクリックします。

3. 確認を要求されたら、「はい」をクリックします。

既存のアプリケーション内でのセカンダリー・レベル・アプリケーションの作成

既存のアプリケーションへの管理権限を持つ IBM Cognos TM1 ユーザーは、セカンダリー・レベル・アプリケーションを作成できます。

手順1. 既存のアプリケーションを右クリックします。

2. 「新規作成」→「アプリケーション」をクリックします。

TM1 では、既存のアプリケーションに、「新しいフォルダー」という名前の新しいセカンダリー・レベル・アプリケーションが一時的に挿入されます。

3. 新しいアプリケーションに名前を割り当てます。

TM1 では、アプリケーションが自分しかアクセスできない個人用オブジェクトとして作成されます。

4. ADMIN または DataAdmin グループのメンバーであって、アプリケーションを発行して他の TM1 ユーザーがアクセスできるようにする場合、アプリケーションを右クリックし、「セキュリティー」→「共有にする」をクリックします。

セカンダリー・レベル・アプリケーションを発行する場合、そのセキュリティー権限は親アプリケーションに定義されたセキュリティー権限から継承されます。このセキュリティー権限を変更するには、 106ページの『TM1 アプリケーションと参照に関するセキュリティー権限のユーザー・グループへの割り当て』の手順に従います。

TM1 オブジェクト参照のアプリケーションへの追加アプリケーションが置かれている IBM Cognos TM1 サーバーのオブジェクト、および接続している他のサーバーのオブジェクトに対する参照を追加できます。

手順1. サーバー・エクスプローラーでオブジェクトを選択します。

2. そのオブジェクトをアプリケーションまでドラッグ・アンド・ドロップします。

オブジェクトに対する参照がアプリケーションに表示されます。


デフォルトでは、アプリケーションに追加するすべての参照は、オブジェクトの上に鍵が重なったアイコンで示される、個人用参照となります。つまり、参照にのみアクセスできます。

アイコン説明

North American Sales アプリケーションに追加されたSalesCube キューブへの参照。

TM1 によって、オブジェクトのアイコンに参照を表すショートカット矢印の画像が追加されます。

鍵の画像は、個人用参照であることを表すために参照アイコンの下の隅に追加されます。また、個人用オブジェクトであることを表すためにオブジェクト・アイコンの右下隅と右上隅の両方に追加されます。

参照を共有にする参照を他の IBM Cognos TM1 ユーザーにも使用可能にする場合、参照を発行する必要があります。それには、参照を右クリックし、「アプリケーション・アイテム」→「セキュリティー」→「共有にする」の順にクリックします。

TM1 では、オブジェクトのアイコンとショートカット矢印を組み合わせて、共有オブジェクトに対する共有参照を指定します。

アイコン説明

共有サブセットに対する共有参照

共有ビューに対する共有参照

共有参照の作成プロセスを簡単にするために、サーバー・エクスプローラーでオブジェクトを右クリックし、右マウス・ボタンを押したまま、オブジェクトをアプリケーションまでドラッグ・アンド・ドロップできます。オブジェクトをドロップすると、TM1 にショートカット・メニューが表示されます。「共有参照の作成」をクリックします。

参照は共有アプリケーションにのみ発行できます。参照をアプリケーションに発行する場合、参照のセキュリティー権限は、親アプリケーションに定義されたセキュリティー権限から継承されます。このセキュリティー権限を変更するには、 106ページの『TM1 アプリケーションと参照に関するセキュリティー権限のユーザー・グループへの割り当て』にまとめた手順に従います。


個人用ビューと個人用サブセットに対する参照をアプリケーションに追加する

個人用のビューまたはサブセットに対する参照をアプリケーションに追加すると、参照は個人用参照として作成されます。これは、アプリケーションに参照を作成する場合のデフォルトの動作です。

IBM Cognos TM1 は、個人用オブジェクトへの個人用参照であることを示すために、2 つの鍵の画像を参照アイコンに追加します。

アイコン説明

個人用サブセットに対する個人用参照

個人用ビューに対する個人用参照

これらのアイコンは、次の 2 つの参照の区別に役立ちます。

v 個人用オブジェクトに対する個人用参照

v 共有オブジェクトに対する個人用参照

TM1 は、共有オブジェクトに対する個人用参照を示す、1 つの鍵を参照アイコンに追加します。

アイコン説明

共有サブセットに対する個人用参照

共有ビューに対する個人用参照

参照が存在する個人用ビューまたは個人用サブセットを発行すると、参照は無効になり、アクセス時にエラー・メッセージが表示されます。

例えば、View1 という名前の個人用ビューに対する参照を作成し、View1 を共有にすると、参照が解除され、ビューを開くことができなくなります。次のエラー・メッセージが表示されます：個人用ビュー 'View1'(キューブ: 'plan_BudgetPlan'、サーバー: 'planning sample') が見つかりません。

このような状況では、古い参照を削除し、現在共有になったビューまたはサブセットに対する新しい参照を挿入する必要があります。


新規オブジェクトの作成と並行した参照のアプリケーションへの追加

アプリケーション内から IBM Cognos TM1 オブジェクトを作成できます。この場合、TM1 ではアプリケーションが置かれているサーバーにオブジェクトが作成され、オブジェクトに対する個人用参照がアプリケーションに挿入されます。アプリケーション内からディメンション、キューブ、プロセス、および日課を作成できます。

手順1. サーバー・エクスプローラーで、オブジェクトの作成元となるアプリケーションを右クリックし、ショートカット・メニューで「新規作成」<＜オブジェクト・タイプ＞>をクリックします。例えば、新しいキューブを作成するには、「新規作成」→「キューブ」をクリックします。

オブジェクト・タイプを選択すると、ダイアログ・ボックスまたはウィンドウが開きます。例えば、「新規作成」→「キューブ」をクリックすると、「キューブを作成」ダイアログ・ボックスが開きます。

2. 選択したオブジェクト・タイプの作成に必要な手順を実行します。

完了すると、TM1 によってサーバーにオブジェクトが作成され、オブジェクトに対する個人用参照がアプリケーションに挿入されます。

次の例は、North American Sales アプリケーション内から“New Cube”キューブを作成した結果を示します。

ファイル参照のアプリケーションへの追加IBM Cognos TM1 アプリケーションには、コンピューターまたはネットワーク上の任意のファイル・タイプ (Excel、Word、PowerPoint、PDF など) のファイル参照を追加できます。

注:

v 任意の Excel ファイルに対する参照をアプリケーションに追加できます。TM1

スライスまたは他の TM1 機能を含む Excel ファイルでのみ作業する必要はありません。

v ファイルは、Microsoft Windows ファイル・タイプの設定に応じて、関連付けられているプログラムで開きます。TM1 では、この関連付けに基づいて、各ファイルのアイコンが表示されます。


手順1. サーバー・エクスプローラーで、ファイル参照を追加するアプリケーションを右クリックし、ショートカット・メニューで「ファイルの追加」をクリックします。

「ファイルの追加」ダイアログ・ボックスが開きます。

2. ファイルを含むディレクトリーを参照し、アプリケーションに追加するファイルを選択します。

3. TM1 によるファイルのアプリケーションへの追加方法を決定するオプションを選択します。

ファイルを参照として添付 - ファイルを現在の場所に保持し、ファイルへの参照を TM1 アプリケーションに挿入します。

ファイルを参照として追加すると、TM1 には矢印付きのアイコンとして表示されます。例えば、「ファイルを参照として添付」オプションを使用して追加したExcel ファイルのアイコンは、TM1 アプリケーション・オブジェクト・ツリーに

のように表示されます。

このオプションの主な利点は、Excel ファイルに対する編集や変更内容がアプリケーションで即座に使用可能になることです。このオプションを選択する場合、Excel ファイルは共有フォルダーに存在する必要があり、ネットワークを介してファイルにナビゲートしてファイルへの UNC パスを作成する必要があります。

ファイルを TM1 サーバーにコピー - ファイルをアプリケーションが置かれている TM1 サーバーにコピーします。

このタイプの参照は、TM1 に矢印なしのアイコンとして表示されます。例えば、「ファイルを TM1 サーバーにコピー」オプションを使用して追加された

Excel ファイルは、TM1 アプリケーション内でこのようなアイコンで表示されます。

アップロードされたファイルは、TM1 によって、TM1 サーバーのデータディレクトリの“}Externals”サブディレクトリにコピーされます。例えば、Excel ファイルを TM1 サンプル・データベースの一部である sdata サーバー上のアプリケーションに追加すると、TM1 によってファイルは次の場所に保存されます。

C:¥Program Files¥Cognos¥TM1¥Custom¥TM1Data¥sdata¥}Externals

このオプションの主な利点は、TM1 サーバーの実行中、常にファイルが使用可能なことです。ただし、元のソースファイルに対する変更は、TM1 サーバー上のファイルには自動的に反映されません。サーバー上のファイルを更新して、変更を使用可能にする必要があります。

v TM1 にコピーされた Excel ファイルの更新の詳細については、 101ページの『TM1 サーバーでの Excel ファイルの更新』を参照してください。

v TM1 にコピーされた Excel 以外のファイルの更新の詳細については、 102ページの『TM1 サーバーでの Excel 以外のファイルの更新』を参照してください。


注: 「ファイルを TM1 サーバーにコピー」オプションを選択している場合、アップロードするファイルは別のプログラムによって現在使用中であってはなりません。開いているファイルをアップロードしようとすると、TM1 ではエラー・メッセージが表示されます。ファイルを TM1 にアップロードする前に、必ず閉じてください。

4. 「共有」または「個人用」のいずれかのオプションを選択します。

v 共有 - ファイル参照を TM1 アプリケーションにアクセスできる他のユーザーに使用可能にします。

v 個人用 - ファイルへの参照にアクセスできるのは、自身のみです。

5. 「開く」をクリックします。

ファイルが TM1 アプリケーション内から使用可能になります。

TM1 Web から TM1 アプリケーション内のファイルにアクセスすることもできます。詳細については、このセクション以降の次のセクションを参照してください。

v 108ページの『TM1 アプリケーションと参照の発行』.

v 110ページの『TM1 アプリケーションの TM1 Web への発行』.

共有参照と個人用参照についてIBM Cognos TM1 では、次のアイコン形式を使用して TM1 アプリケーション内の共有ファイル参照と個人用ファイル参照を区別して表示します。

アイコン説明

TM1 に参照として追加されたファイルに対する共有参照。

TM1 に参照として追加されたファイルに対する個人用参照。

TM1 サーバーにコピーされたファイルに対する共有参照。

TM1 サーバーにコピーされたファイルに対する個人用参照。

TM1 サーバーにアップロードされたファイルの動作アップロードされたファイルとは、「ファイルを TM1 Server にコピー」オプションを使用して、IBM Cognos TM1 アプリケーションに追加されたファイルのことです。

アップロードされたファイルは、実際に IBM Cognos TM1 サーバー内にコピーされて保管されるため、参照されるファイルとは異なる動作をします。


v TM1 は、アップロードされたファイルを TM1 サーバーの<server_data_dir>¥}Externals ディレクトリーにコピーし保存します。

v ファイルを TM1 サーバーにアップロードすると、ファイル名に時刻/日付スタンプが追加されます。

例えば、“US Budget.xls”ファイルを TM1 サーバーにアップロードすると、ファイルは“US Budget.xls_20040702193054.xls”として保存されます。

v TM1 アプリケーションからアップロードされたファイルを削除すると、TM1 によって“}Externals”ディレクトリーからアップロードされたファイルのコピーが削除されます。アップロードされたファイルのコピー元である、TM1 外の元のファイルは削除されません。

v TM1 Web 内の Web シートまたはその他の TM1 アプリケーション・ファイルからアップロードされたファイルを開くハイパーリンクを作成する場合、そのハイパーリンクには、アップロードされたファイルの TM1 割り当て名を組み込む必要があります。詳細については、 111ページの『アップロードされたファイルに対するハイパーリンクの作成』を参照してください。

TM1 サーバーでの Excel ファイルの更新

IBM Cognos TM1 には、IBM Cognos TM1 サーバーにアップロードされた Excel

ファイルを更新するためだけに専用のプロセスが用意されています。Excel 以外のファイル (Word、PowerPoint、その他のファイル・タイプ) の更新の詳細については、 102ページの『TM1 サーバーでの Excel 以外のファイルの更新』を参照してください。

手順1. サーバー・エクスプローラーでファイルをダブルクリックします。

Excel にファイルが開かれます。このとき、タイトル・バーには“TM12C5D.xls”

などの一時的なファイル名が表示されます。

注: (一時的なファイル名とは異なり) 更新しているファイルの元の名前を記憶しておくことが重要です。後の手順 4 で元のファイルを選択する必要があります。

2. 編集内容を Excel ドキュメントに適用します。

3. 「TM1」>「ブックを TM1 サーバーに保存」>「既存のアプリケーション・ファイルを TM1 サーバー上で更新」をクリックします。

「更新する TM1 外部ファイルを選択します。」ダイアログ・ボックスが開きます。

4. 更新する元の Excel ファイルを選択します。

手順 1 で開いた元の Excel ファイルを必ず選択してください。他のファイルを選択すると、TM1 によって、警告が表示されずにその選択したファイルが上書きされます。



TM1 によって、TM1 サーバー上のファイルが更新されます。Excel ファイルが親アプリケーション内から使用可能になります。

TM1 サーバーでの Excel 以外のファイルの更新IBM Cognos TM1 サーバーにアップロードされた Excel 以外のファイルを更新するには、ファイルを外部ファイルとして保存し、そのファイルを手動でサーバーに再度追加します。

手順1. サーバー・エクスプローラーでファイルをダブルクリックします。

関連付けられているプログラムにファイルが開かれます。このとき、タイトル・バーには“TM163.doc”などの一時的なファイル名が表示されます。

例えば、アップロードされた Word ファイルは、Microsoft Word に開かれます。

2. ファイルに関連付けられているプログラムを使用して、ファイルを変更し、プログラムの「名前を付けて保存」機能を使用して、ファイルを新しい場所に新しいファイル名で保存します。

注: 新規のアップロードされたファイルは、次の手順で TM1 に再度追加できるように、その名前と場所を記憶しておいてください。

3. サーバー・エクスプローラーで、古いバージョンのファイルを右クリックし、「削除」をクリックします。

TM1 によって「削除の確認」ダイアログ・ボックスが表示され、古いファイルを削除できます。

4. 98ページの『ファイル参照のアプリケーションへの追加』の説明に従って、更新されたファイルを再度追加します。

URL 参照のアプリケーションへの追加http:// および https:// プロトコルの URL アドレスをアプリケーションに追加できます。

IBM Cognos TM1 アプリケーション内の URL 参照を、TM1 サーバー・エクスプローラーまたは TM1 Web 内で開くと、その URL のターゲット・ソースがシステムのデフォルトの Web ブラウザーに表示されます。

手順1. サーバー・エクスプローラーで、URL 参照を追加するアプリケーションを右クリックし、ショートカット・メニューで「URL の追加」をクリックします。

「URL の追加」ダイアログが開きます。

2. http:// または https:// プロトコルを含む完全な URL を入力します。

例: http://www.Company.com

3. URL の説明的な名前を入力します。


例: 会社の Web サイト

4. 「OK」をクリックして、URL を追加します。

URL リンク用のシステムのデフォルト・アイコンを使用して、URL が TM1 アプリケーションに追加されます。

TM1 アプリケーション内のオブジェクト、ファイル、および URL 参照での作業

IBM Cognos TM1 アプリケーション内のオブジェクト、ファイル、URL への参照をダブルクリックすることで、そのオブジェクトに関するデフォルトの操作を実行できます。

オブジェクト参照を右クリックし、ショートカット・メニューからオブジェクトに関してサポートされている操作を選択できます。

次の表では、TM1 アプリケーションからアクセスできるすべてのオブジェクト、ファイル、および URL に関するデフォルトの操作について説明します。

参照タイプデフォルトの操作

キューブ Cube Viewer にキューブのデフォルト・ビューを開く。

キューブ・ビュー Cube Viewer にビューを開く。

ディメンションサブセット・エディターにディメンションのデフォルト・サブセットを開く。デフォルトのサブセットが定義されていない場合、すべてのサブセットが開きます。

サブセットサブセット・エディターにサブセットを開く。

プロセス TurboIntegrator ウィンドウに編集用のプロセスを開く。

日課日課がアクティブでない場合、日課設定ウィザードで日課を開きます(アクティブな日課を開くことはできません)。

ファイル Microsoft Windows ファイル・タイプの設定に応じて、ファイルに関連付けられているプログラムで、ファイルを開きます。例えば、.xls ファイルは Excel で開きます。

URL システムのデフォルトの Web ブラウザーに URL を開く。

注: 別の IBM Cognos TM1 サーバーにある TM1 オブジェクトにアクセスする場合、そのサーバーが実行中であり、そのサーバーにログオンしている必要があります。

v 実行中のサーバーでも、現在接続していないサーバーに置かれているオブジェクトへの参照にアクセスしようとすると、TM1 によってサーバーにログオンするよう要求されます。

v 実行中でないサーバーに置かれているオブジェクトへの参照にアクセスしようとすると、TM1 によって「このオブジェクトが置かれているサーバーからの応答がありません。サーバー・エクスプローラーの表示を更新しますか？」という警告が発行されます。

参照へのアクセスを復元するには、ソース・オブジェクトが置かれているサーバーを起動します。


TM1 アプリケーションのプロパティーの表示IBM Cognos TM1 アプリケーション内の参照およびサブアプリケーションのプロパティーを表示するには、次の手順を実行します。

手順1. サーバー・エクスプローラーでアプリケーションを選択します。

2. サーバー・エクスプローラーに「プロパティー」ウィンドウが表示されていない

場合、「表示」→「プロパティー・ウィンドウ」をクリックします。

「プロパティー」ウィンドウには、少なくとも読み取りアクセス権限があるすべての参照とサブアプリケーションに関する情報が表示されます。アクセス権限なしの参照とサブアプリケーションは、サーバー・エクスプローラーに表示されないため、これらのアイテムのプロパティーは表示できません。

「プロパティー」ウィンドウには、選択した TM1 アプリケーションの直接のサブアプリケーションのみ表示されます。

3. 「プロパティー」ウィンドウ内のアイテムをプロパティー値のアルファベット順にソートするには、ソートを適用する列ラベルをクリックします。例えば、アイテムを現在のステータスのアルファベット順にソートするには、「ステータス」列ラベルをクリックします。

それぞれの参照とサブアプリケーションについて、次のプロパティーが表示されます。

プロパティー説明

名前選択したアプリケーションに表示される参照またはサブアプリケーションの名前。

ソース・オブジェクト名に直接対応する必要がない参照名は、編集できます。例えば、前述の図では、Price 参照は、“PriceCube”という名前のソース・キューブを参照します。

システム名v ほとんどの参照では、「システム名」は、参照がポイントするソース・オブジェクトの実際の名前です。

v IBM Cognos TM1 サーバーにアップロードされたファイルの場合、「システム名」は、TM1 サーバー上でファイルに割り当てられた名前です。TM1 サーバーにアップロードされたファイルの命名規則については、 100ページの『TM1 サーバーにアップロードされたファイルの動作』を参照してください。

v 参照として添付されたファイルの場合、「システム名」はファイルへの UNC パスとなります。

v 「システム名」プロパティーは、サブアプリケーションには適用されません。

サーバー参照のソースオブジェクトが置かれている TM1 サーバー。

例えば、前述の図では、Currency 参照のソース・キューブは、インベントリー・サーバーに置かれています。


プロパティー説明

個人用このプロパティーは、サブセットとビューにのみ適用されます。

「個人用」プロパティーは、サブセットまたはビュー参照のソースが個人用オブジェクトかどうかを示します。プロパティー値が「はい」の場合、ソースが個人用オブジェクトであることを示します。「いいえ」は共有オブジェクトを示します。

例えば、前述の図では、North American Currencies サブセット参照のソースは、North American Price Plan や North American Models ビュー参照のソースと共にすべて個人用オブジェクトです。

ステータスこのプロパティーは、参照とサブアプリケーションの現在の可用性を示します。「ステータス」には、次の 3 つの値が考えられます。

v 使用可能 - 参照またはサブアプリケーションは使用可能です。

v 未接続 - 参照のソースオブジェクトが置かれている TM1 サーバーに接続されていません。サーバーにログオンして、参照へのアクセスを復元してください。

v 使用不可 - 参照のソースオブジェクトが置かれている TM1 サーバーは実行されていないため、参照にアクセスできません。

セキュリティーこのプロパティーは、参照またはサブアプリケーションのセキュリティー権限を示します。

TM1 アプリケーションからのオブジェクト、ファイル、およびURL 参照の削除

IBM Cognos TM1 アプリケーションからオブジェクト参照を削除するには、次の手順を実行します。

手順1. アプリケーション内のオブジェクト参照を右クリックします。

注: アプリケーション内のオブジェクト参照を選択する必要があります。サーバー階層の他の場所にあるソース・オブジェクトを選択した場合、アプリケーションからオブジェクトを削除できません。

2. 「アプリケーション・アイテム」→「削除」をクリックします。

アプリケーションからファイル参照または URL 参照を削除するには：

v アプリケーション内のファイルを右クリックします。

v 「削除」をクリックします。

TM1 アプリケーション内のオブジェクト、ファイル、および URL参照の名前の変更

IBM Cognos TM1 アプリケーション内のオブジェクト参照またはファイル参照に、その関連付けられているソース・ファイルの名前を使用する必要はありません。ア


プリケーション内のオブジェクト参照またはファイル参照の名前を変更しても、ソース・ファイルへの接続を維持できます。

手順1. アプリケーション内の参照を右クリックします。

2. 次のように「名前を変更」オプションを選択します。

v 「アプリケーション・アイテム」→「名前を変更」をクリックして、オブジェクト参照の名前を変更します。

v 「名前を変更」をクリックして、ファイル参照または URL 参照の名前を変更します。

参照名が選択され、編集できるようになります。

3. 参照の新しい名前を入力します。

4. Enter キーを押します。

TM1 アプリケーションによって参照されるソース・オブジェクトの削除

IBM Cognos TM1 アプリケーションで参照されるソース・オブジェクトが削除されても、TM1 は、対応するオブジェクト参照をアプリケーションから削除しません。

例えば、“sdata”サーバーから“Canada Sales”ビューを削除しても、“Canada Sales”ビューは North American Sales アプリケーションに残ります。

オブジェクトまたはファイルのソースが IBM Cognos TM1 サーバーから削除されている場合に、アプリケーション内でそのオブジェクトまたはファイルへの参照を開こうとすると、TM1 に、サーバー 'sdata' 上のオブジェクト 'US Sales' が見つからないことを示すエラー・メッセージが表示され、参照を削除するよう要求されます。

アプリケーション内のオブジェクトまたはファイルのソースがサーバーから削除されている場合、アプリケーションから対応する参照を削除する必要があります。詳細については、 105ページの『TM1 アプリケーションからのオブジェクト、ファイル、および URL 参照の削除』を参照してください。

TM1 アプリケーションのセキュリティーの管理次のセクションでは、IBM Cognos TM1 のアプリケーションと参照に関するセキュリティー権限を IBM Cognos TM1 サーバーのユーザー・グループに割り当てる方法と、TM1 のアプリケーションと参照を発行する方法および個人用にする方法について説明します。

TM1 アプリケーションと参照に関するセキュリティー権限のユーザー・グループへの割り当て

共有の IBM Cognos TM1 アプリケーション内の共有アイテム (参照またはサブアプリケーションのいずれか) に関するセキュリティー権限を、IBM Cognos TM1 サー


バー上のユーザー・グループに割り当てることができます。セキュリティーをアプリケーション内のアイテムに割り当てるには、アプリケーションに対する管理権限がある必要があります。

個人用アプリケーションと個人用参照に関するセキュリティーを割り当てることはできません。アイテムにアクセスできるのは、個人用アイテムを作成したユーザーのみです。

手順1. サーバー・エクスプローラーで、セキュリティーを割り当てるアイテムを含む

TM1 アプリケーションを右クリックします。

2. 「セキュリティー」→「セキュリティー割り当て」をクリックします。

「セキュリティー割り当て」ウィンドウが開きます。このウィンドウには、現在のアプリケーションに存在しているすべての共有アイテム (TM1 オブジェクト、ファイル、URL、およびサブアプリケーション) がリスト表示されます。

3. セキュリティーを定義するアイテム、およびセキュリティーを割り当てるユーザー・グループの交点にあるセルをクリックします。

4. 使用可能なセキュリティー権限のいずれかをクリックします。

セキュリティー権限 TM1 アプリケーションに適用する場合参照に適用する場合

なしこのユーザー・グループのメンバーは、アプリケーションまたはその内容を表示できません。

このユーザー・グループのメンバーは、参照を表示できません。

読み取りこのユーザー・グループのメンバーは、アプリケーションを表示し、グループに少なくとも読み取り権限のあるアプリケーション内の参照を使用できます。メンバーは、アプリケーション内に個人用参照を作成することもできます。

このユーザー・グループのメンバーは、参照を使用できます。

Admin このユーザー・グループのメンバーは、アプリケーションの表示、アプリケーション内の参照の使用、およびアプリケーション内での共有参照と個人用参照の作成を行うことができます。個人用サブアプリケーションを作成することもできます。

アプリケーションに対して管理権限を持つメンバーは、アプリケーション内のすべての参照とサブアプリケーションに対してセキュリティー権限を設定できます。

このユーザー・グループのメンバーは、参照を使用できます。参照の更新や削除を行うこともできます。個人用参照を発行したり、共有参照を個人用にしたりできます。

5. セキュリティーを定義する他のアイテムについて、手順 3 および 4 を繰り返します。



タスクの結果

任意の指定されたユーザー・グループについて、参照に関連付けられているオブジェクトに割り当てられている権限がなしの場合、参照に対して読み取りまたは管理権限を割り当てることができます。このシナリオでは、ユーザー・グループのメンバーは、アプリケーション内の参照を表示できません。

例えば、ユーザー・グループに対してキューブのなし権限を割り当てたが、同じキューブに対して参照の読み取り権限を割り当てた場合、ユーザー・グループのメンバーには、アプリケーション内のキューブに対する参照が表示されません。

TM1 アプリケーションと参照の発行次のセクションでは、IBM Cognos TM1 のアプリケーションと参照の発行方法について説明します。これらの手順の実行に必要なセキュリティー権限を判断するには、「アプリケーションの作成と表示に関するセキュリティー上の考慮事項」を参照してください。

個人用 TM1 アプリケーションの発行個人用アプリケーションを発行するには、次の手順を実行します。


2. 「セキュリティー」→「共有にする」をクリックします。

注: 個人用アプリケーションを発行すると、IBM Cognos TM1 によってそのアプリケーション内の共有オブジェクトへの個人用参照もすべて発行されます。

共有オブジェクトに対する個人用参照の発行共有アプリケーション内にある個人用参照を発行できます。

手順1. サーバー・エクスプローラーで参照を右クリックします。

2. 「アプリケーション・アイテム」→「セキュリティー」→「共有にする」を選択します。

TM1 アプリケーションと参照を個人用にする共有の IBM Cognos TM1 アプリケーションと参照を個人用にできます。アプリケーションまたは参照を個人用にすると、アイテムにアクセスすることだけができます。

TM1 共有アプリケーションを個人用にする共有アプリケーションを個人用にするには、次の手順を実行します。


2. 「セキュリティー」→「個人用にする」を選択します。


共有アプリケーションを個人用にすると、アプリケーション内のすべての共有参照も自動的に個人用になります。

共有アプリケーションに 1 つのオブジェクト・タイプに対する同じ名前の参照(1 つの共有参照と 1 つの個人用参照) が含まれている場合、アプリケーションを個人用にすると、共有参照に文字列 _Public が追加されます。

例えば、次の図に、“Northern Europe Sales”という名前のビューに対する 1 つの共有参照と 1 つの個人用参照の 2 つの参照を含む、“European Sales”アプリケーションを示します。

共有アプリケーション

同じビュー・オブジェクトへの

共有参照と

個人用参照

“European Sales”アプリケーションを個人用にすると、共有参照が個人用参照に変換され、その名前が“Northern Europe Sales_Public”に変更され、共有オブジェクトに対する個人用参照であることを示します。

個人用アプリケーション

同じビュー・オブジェクトへの

2 つの個人用参照

名前の変更が必要なのは、アプリケーション内に 1 つのオブジェクト・タイプに対して同じ名前の個人用参照を 2 つ格納できないためです。

共有参照を個人用にする共有参照を個人用にするには、次の手順を実行します。

手順1. サーバー・エクスプローラーで参照を右クリックします。

2. 「アプリケーション・アイテム」→「セキュリティー」→「個人用にする」を選択します。

TM1 アプリケーション内の論理グループの表示IBM Cognos TM1 アプリケーションの主な利点の 1 つに、オブジェクトとファイルを論理グループにまとめて表示および管理できることがあります。オブジェクトをタイプ別に配置した大きなリストをスキャンせずに、ジョブ特有のアプリケーションでファイルとオブジェクトを簡単に特定し検索できるため、TM1 を使用するタスクが簡単になります。

TM1 の使用をさらに簡単にするには、オブジェクトの表示をタイプ別に無効にできます。これで、サーバー・エクスプローラーの表示がすっきりし、より簡単にナビゲートできるようになります。(デフォルトでは、すべてのオブジェクト・タイプがサーバー・エクスプローラーに表示されます)。


特定のオブジェクト・タイプの表示を無効にするには、サーバー・エクスプローラーから「表示」→「＜オブジェクト・タイプ＞」をクリックします。これで、「表示」メニューのオブジェクト・タイプの横にあるチェック・マークがクリアされ、サーバー・エクスプローラーでのオブジェクト・タイプの表示が無効になります。次のサンプルでは、アプリケーション以外のすべてのオブジェクトの表示が無効になっています。

注: サーバー・エクスプローラーで指定したオブジェクト・タイプの表示を無効にしても、そのオブジェクト・タイプへの参照は TM1 アプリケーション内に表示されます。ただし、コントロール・オブジェクトの場合、サーバー・エクスプローラーでその表示を無効にすると、アプリケーション内での表示は無効になります。

TM1 アプリケーションの TM1 Web への発行IBM Cognos TM1 アプリケーション内の、キューブ、ビュー、ファイル、およびURL への参照がすべて、自動的に TM1 Web 内で使用可能になります。

IBM Cognos TM1 バージョン 10.2 の時点では、Cognos TM1 Web の Web シートとして Microsoft Excel ワークシートを表示するには、ファイルが Microsoft Excel

2007 以降の .xlsx 形式または .xlsm 形式である必要があります。

“North American Sales”は、一連の TM1 オブジェクトと Excel ファイルへの参照を含む共有アプリケーションです。TM1 Web 経由で sdata IBM Cognos TM1 サーバーにアクセスすると、アプリケーションの下にこれらの参照が表示されます。

TM1 Web で作業する場合、参照をクリックして次のように開き表示できます。

v キューとビューは TM1 Web に直接表示される。

v Excel ファイルは TM1 Web シートとして TM1 Web に直接表示される。

注: Excel コマンドの「ツール」→「保護」を使用して保護されている Excel ファイルには、TM1 Web からアクセスできません。

v Excel 以外のファイルは、関連付けられているプログラムで開かれ表示される。

注: 一部のファイル・タイプとプログラムは、TM1 Web から表示できない可能性があります。

v URL 参照は、別の Web ブラウザーで開かれ表示される。

例えば、Excel ファイルをクリックすると、TM1 Web シート形式で開きます。

注: TM1 では、Web シートの列幅は、Web シートを生成した Excel ファイルに基づいて決定されます。Excel ファイルの列に行ラベルと例ラベルを完全に表示できない場合、Web シートの対応するラベルは切り捨てられます。

TM1 Web からは、共有と個人用のアプリケーションと参照にアクセスできます。個人用アプリケーションまたは個人用参照には、それを作成したユーザーのみ、TM1 Web からアクセスできます。TM1 Web での共有アプリケーションと共有参照へのアクセス権限は、TM1 サーバー上でのソースアプリケーションとソース参照に定義されたセキュリティ権限によって決まります。セキュリティー権限設定の詳細については、 106ページの『TM1 アプリケーションと参照に関するセキュリティー権限のユーザー・グループへの割り当て』を参照してください。


TM1 Web シートのプロパティーの設定Web シートのプロパティーをサーバー・エクスプローラーで設定すると、IBM

Cognos TM1 Web の Web シートとして表示される場合の Excel ファイルの表示方法および動作を制御できます。

手順1. サーバー・エクスプローラーで、TM1 Web シートを生成した Excel ファイルを含む TM1 アプリケーションを開きます。

2. Excel ファイルを右クリックします。

3. 「プロパティー」をクリックします。

「TM1 Web のプロパティー」ダイアログ・ボックスが開きます。

4. 「全般」タブと「表示プロパティー」タブのオプションを使用して、TM1 Web

シートのプロパティーを設定します。

TM1 Web のプロパティー・オプションについて詳しくは、「TM1 Perspectives,

TM1 Architect, and TM1 Web」を参照してください。


アップロードされたファイルに対するハイパーリンクの作成Web シートにアップロードされたファイルに対するハイパーリンクを含める場合、そのハイパーリンクには、IBM Cognos TM1 がアップロードされたファイルに割り当てる場所と名前を組み込む必要があります。

アップロードされたファイルを TM1 アプリケーションに追加する場合、ファイルのコピーは IBM Cognos TM1 サーバーに保存され、ファイル名に日付/時刻スタンプが追加されます。以下に例を挙げます。

Report_2006.xls_20070123212746.xls

ハイパーリンクに TM1 割り当てファイル名を組み込まないと、リンクは TM1

Web では機能せず、エラーが表示されます。

「ファイルがありません: TM1://planning sample/blob/PUBLIC/

.¥}Externals¥upload_test_2.xls」。

手順1. サーバー・エクスプローラーの「プロパティー」ウィンドウを使用して、ハイパーリンクの対象となるアップロードされた Excel ファイルに対する TM1 割り当て名であるシステム名を検索します。

2. 次の形式を使用して、アップロードされた Excel ファイルへのハイパーリンクを作成します。

TM1://ServerName/blob/PUBLIC/.\}Externals\Filename

ここで：

v ServerName は、Excel ファイルが置かれている TM1 サーバー名です。

v Filename は、アップロード済みの Excel に TM1 が割り当てた名前です。



TM1://sdata/blob/PUBLIC/.\}Externals\Report_2006.xls_20070123212746.xls

3. Excel で、ハイパーリンクをそのリンクを配置するワークシートに追加します。

4. ワークシートを TM1 アプリケーションに追加し、ファイルを TM1 Web のWeb シートとして表示します。

16 進文字の 0x1A を含む Web シートの表示IBM Cognos TM1 Web は、16 進文字 0x1A を含む Web シートを開くことはできません。16 進文字の 0x1A を含む Web シートを開こうとすると、TM1 Web によって次のエラーが発行されます。

MS Excel ワークブックを XML 形式に変換する際にエラーが発生しました。16 進文字値 0x1A は無効な文字です。行 54、位置 34。

この場合、Web シートから 16 進文字の 0x1A を削除すると、ファイルが TM1

Web で開かれます。

注: ASCIIOutput TurboIntegrator 関数は、生成されたすべてのファイルの末尾に、16

進文字 0x1A を置きます。ASCIIOutput を使用して、TM1 データを ASCII ファイルにエクスポートして、TM1 Web シートでファイルを開こうとすると、このエラーが表示されます。


第 6 章プロセス・ワークシートによるデータのインポート

このセクションでは、プロセス・ワークシートを使用して IBM Cognos TM1 キューブにデータをインポートする方法について説明します。プロセス・ワークシートは、TM1 関数を使用して値を既存のキューブ内の場所に送信する、変更済みのExcel ワークシートです。

注: プロセス・ワークシート機能は、データをインポートする有効な方法ではありますが、現在の TM1 リリースでは推奨されていません。TurboIntegrator を使用してデータを TM1 キューブにインポートすることを強くお勧めします。

このセクションでは、次の内容について説明します。

v プロセス・ワークシートの概要

v プロセス・ワークシートを使用したデータのインポート

プロセス・ワークシートの概要プロセス・ワークシートは、関数を使用して入力値を既存の TM1 キューブ内の場所に送信する、変更済みの Excel ワークシートです。

プロセス・ワークシートを使用すると、既存の要素に直接マッピングされない入力値を変換できます。例えば、次の表では、最初の 2 列にキューブ内の値の送信先の要素に直接対応しないコードが含まれています。

Scenario Region Model 数値データ 1 月 2 月 3 月

001 R54 S Series 1.8 L

...

Price 25259.93 25830.76 25041.90


...

Price 25259.93 25830.76 25041.90


...

Price 25259.93 25830.76 25041.90


...

Price 25259.93 25830.76 25041.90

001 R1A S Series 1.8 L

...

Price 25259.93 25830.76 25041.90

002 R1A S Series 1.8 L

...

Price 25259.93 25830.76 25041.90


...

Price 25259.93 25830.76 25041.90


Scenario Region Model 数値データ 1 月 2 月 3 月


...

Price 25259.93 25830.76 25041.90

この例の最初の列のコードは、“Actvsbud”ディメンション内の要素を表します。簡単な IF 関数を使用すると、“001”を“Actual”に、“002”を“Budget”に変換できます。

2 番目の列には、Argentina、United States、Greece などの地域にマッピングされる4 つの地域コードが含まれています。これらが唯一の値である場合、ネストされたIF 書式を作成して、値を要素に変換することもできます。指定可能な値の数が増えるにつれ、ネストされた IF 書式の作成が厄介になり、エラーが発生しやすくなります。代わりに、要素名を取得する検索テーブルとして機能する 2 ディメンション・キューブを作成できます。

プロセス・ワークシートを使用したデータのインポートプロセス・ワークシートを作成して、次のタスクを実行できます。

v 変換が必要な入力行からデータをインポートする。

v キューブを更新するが、キューブの作成や集約の作成は行わない。

v データをインポートするためのステージング領域として使用する。

TM1 は、一度に 1 件ずつ入力レコードをプロセス・ワークシートの最初の行に読み込み、レコードに関連付けられているデータ値を TM1 キューブに送信します。

プロセス・ワークシートには、ワークシートの最初の行の下に次のものがあります。

v 要素名にマッピングされるが、要素名のスペルに一致しない値の変換指示。

v インポートの前にデータ値を変更する任意のデータ変換計算式。

v 入力データをキューブ内のセルにマッピングするデータベース送信 (DBS) 書式。各書式は、最初の行の値をキューブの各ディメンション内の 1 つの要素で指定されたキューブ内の場所に送信します。

注: プロセス・ワークシートでは、DBSW 書式ではなく、DBS 書式を使用する必要があります。また、DBRW 書式でなく、DBR 書式を使用する必要があります。

v 各入力行の他の値は、要素名を直接または変換指示を介して提供します。

次のプロセスにデータのインポートに必要な手順をまとめます。

v 最初の入力レコードを例としてプロセス・ワークシートに読み込む。

v 入力をキューブ構造と比較する。

v 必要に応じて、入力値を要素名にマッピングする。

v キューブのセルに移入する各入力値用の DBS 書式を作成する。

v すべての入力レコードを処理する。


最初の入力行の読み取りプロセス・ワークシートを使用すると、次のデータ・ソースからのデータを処理できます。

v ASCII ファイル

v ODBC データ・ソース

v TM1 キューブ

次の 3 つのセクションでは、各データ・ソースから最初のレコードを読み取る手順について説明します。

手順1. Excel の新規ワークシートを作成し、他のワークシートを閉じます。

2. 「TM1」>「プロセス・データ」>「例」をクリックします。

「キューブ、ODBC またはフラット・ファイルを選択」ダイアログ・ボックスが開きます。

3. データ・ソースを選択するには、「キューブ」、「ODBC」、または「フラット・ファイル」をクリックします。

選択ダイアログ・ボックスが開きます。

4. ソース・キューブ、データ・ソース、または入力ファイルを選択して、「OK」をクリックします。

例えば、入力ファイルの場合、“¥install_dir¥PData”ディレクトリーの“price.cma”ファイルを選択します。ODBC データ・ソースの場合、必要に応じてクライアントとパスワードを変更します。

入力ファイルの場合、入力ファイルの最初のレコードが、プロセス・ワークシートの最初の行に表示されます。

5. 入力ファイルの場合、「編集」→「保存」をクリックして、プロセス・ワークシートを“PriceProcessing.xls ”として保存します。

6. ODBC データ・ソースの場合、表を選択して、「OK」をクリックします。

ODBC ソースの最初のレコードが、ワークシートの最初の行に表示されます。

7. ソース・キューブの場合、「エクスポート」をクリックします。

ソース・キューブの最初のレコードが、ワークシートの最初の行に表示されます。

入力レコードとキューブの構造の比較このマニュアルの例では、データを次の構造を持つ“SalesCube”サンプル・キューブに取り込みます。

ディメンションサンプル要素

Actvsbud Actual、Budget

Region Argentina、Belgium、United States

Model S Series 1.8 L Sedan、S Series 2.0 L Sedan

第 6 章プロセス・ワークシートによるデータのインポート 115

ディメンションサンプル要素

Account1 Units、Sales、Price

月 Jan、Feb、Mar、Apr

“SalesCube”キューブにデータを移入するには、データ・ソース内の各レコードに次の詳細情報が含まれている必要があります。

v 1 つ以上のセルの値。

v インポートされた各値のセルの場所を識別する異なるディメンションの要素名、または要素名にマッピングできる入力値。

要素情報は不完全な場合があります。例えば、ソース・レコードに単一の数値データに対して複数の値が含まれている場合、数値データはオプションとなります。DBS 書式を使用して、不足している数値データを入力することができます。

次のレコードがプロセス・ワークシートに表示されるものとします。このレコードには、1 つの自動車モデルの月別価格データが格納されています。このデータを“SalesCube”キューブにマッピングするには、最初に 2 つの入力値を要素名に変換し、欠落した要素名を入力する必要があります。

Actvsbud コードモデル名月別価格データ地域コード

それぞれの入力値を確認します。

v セル A1 には、価格データを実績金額または予算金額として識別するコードが格納されています。コード 001 は“Actual”を表し、コード 002 は“Budget”を表します。これらの項目は、“Actvsbud”ディメンションの 2 つの要素です。Excel の IF

関数を使用すると、これらの値を要素名に変換できます。

v セル B1 は、“Region”ディメンションの要素名に対応する地域コードを提供します。入力として変換が必要な 21 個の地域コードがあるものとします。これらの値を変換するには、検索テーブルとして機能する 2 ディメンション・キューブを作成できます。

v セル C1 は、“Model”ディメンションにあるとおりの自動車モデル名を提供します。変換は不要です。

v セル D1 ～ I1 は、月別データを提供します。このデータは、“Month”ディメンションの要素にマッピングする必要があります。

各ソース・レコードから欠落しているのは、“Price”(“Account1”ディメンションの要素) を含むセルです。この値は、データ値をキューブに送信する DBS 書式に直接指定します。


IF 書式を使用した変換“price.cma”の最初の列には、シナリオ・コード (実績は 001、予算は 002) が格納されています。Excel の IF 関数を使用して、このコードを“Actvsbud”ディメンションの対応する要素名に変換できます。

手順1. プロセス・ワークシートのセル A3 をクリックします。

2. 次の書式を入力します。

=IF(A1="001","Actual","Budget")

固定ラベルを使用したマッピングセル D1～O1 には、“Month”ディメンションの 12 個の要素 (Jan～Dec) にマッピングされる値が格納されています。これらの入力列は常に同じ月にマッピングされるため、要素名をプロセス・ワークシートに直接入力できます。

要素名は、ディメンション内のスペルに正確に一致する必要があります。「サブセット・エディター」ウィンドウからコピーすると、名前のスペルミスを回避できます。

次の手順は、「サブセット・エディター」ウィンドウから要素名をコピーする方法を示しています。


2. “Month”ディメンションをダブルクリックします。


3. 「ツリー」ウィンドウで、Jan～Dec の 12 カ月を選択します。

4. 「編集」 → 「要素の選択」 → 「横」の順にクリックします。

5. プロセス・ワークシートに戻ります。

6. セル D3 を右クリックして「貼り付け」をクリックします。

TM1 は、要素名をセル D3 から横に貼り付けます。

検索キューブを使用した変換2 番目の入力列である列 B は、自動車モデルが販売される 21 の地域を識別するコードを提供します。例えば、R54 は“Argentina”を表します。これらのコードを要素名に変換するには、次の 2 つの選択肢があります。

v ネストされた IF 書式を作成する。コードのリストが増えるにつれ、これは扱いにくくなります。

v 地域名の検索キューブとして機能する 2 ディメンション・キューブを作成し、DBR 書式を使用して名前を取得する。

“RegCodes”と“RegName”という 2 つのディメンションを含む、“Translate”という名前の検索キューブを作成します。


一意な名前のインポートTurboIntegrator を使用すると、入力列からその要素が一意な値のディメンションを作成できます。この例では、2 番目の列は“price.cma”です。


2. 「ツリー」ウィンドウで「プロセス」を右クリックし、「新規プロセスの作成」をクリックします。

「TurboIntegrator」ダイアログ・ボックスが開きます。

3. 「ASCII」データ・ソース・タイプを指定します。

4. データ・ソース名の「参照」ボタンをクリックし、“¥install_dir¥Pdata”ディレクトリーの“price.cma”ファイルを参照します。

5. 「変数」タブをクリックします。

6. インポートするコードを提供する列以外のすべての列に対して、「無視」の「内容」タイプを指定します。この例では、列 2 (R54 のサンプル値で指定される) がインポートするコードを提供します。

7. 「マップ」タブをクリックします。

8. 「キューブ」サブタブの「キューブの操作」と「データ操作」の両方のセクションで、「未対処」を指定します。

9. 「ディメンション」サブタブをクリックして、次の操作を実行します。

v 「ディメンション」フィールドに「変換」と入力します。

v 「操作」リストから「作成」を選択します。

v 「要素の型」リストから「数値」を選択します。

10. 「ファイル」→「保存」をクリックし、プロセスを create_RegCodes_dimension

として保存します。

11. 「ファイル」→「実行」をクリックし、“RegCodes”ディメンションを作成します。

タスクの結果

“RegCodes”がサーバー・エクスプローラーでディメンションとして使用可能になります。

RegName ディメンションの作成単一の文字列要素で“RegName”ディメンションを作成するには、次の手順を実行します。


2. 「ツリー」ウィンドウで「ディメンション」を右クリックし、「新規ディメンションの作成」をクリックします。


3. 「編集」→「要素の挿入」をクリックします。



4. 「要素名」フィールドに「名前」と入力します。

5. 「要素の型」リストから「文字列」を選択します。


Name 要素が文字列要素として開きます。


8. 「編集」→「保存」をクリックし、ディメンションを“RegName”として保存します。

Translate キューブの作成“Translate”キューブを作成するには、次の手順を実行します。

手順1. サーバー・エクスプローラーで「キューブ」を右クリックし、「新規キューブの作成」をクリックします。

「キューブを作成」ウィンドウが開きます。

2. 「キューブ名」フィールドに「Translate」と入力します。

3. 「使用できるディメンション」ボックスで、「RegCodes」をダブルクリックします。

“RegCodes”が新規キューブ・ボックスの「ディメンション」に移動します。

4. 「使用できるディメンション」ボックスで、「RegName」をダブルクリックします。

“RegCodes”が新規キューブ・ボックスの「ディメンション」に移動します。

5. 「OK」をクリックし、2 つのディメンションの“Translate”キューブを保存します。

Translate キューブへのデータ移入Cube Viewer を使用して、地域コードに対応する地域名を入力できます。

次の手順は、“Translate”キューブに地域名を移入する方法を示しています。

手順1. サーバー・エクスプローラーの「ツリー」ウィンドウで、「Translate」をダブルクリックします。

Cube Viewer が開きます。

2. F9 キーを押して、“Translate”キューブの各ディメンションの要素を参照します。

3. ガイドとして表を使用して、地域コードに対応する地域名を入力します。

RegCode 名前

R54 Argentina

R32 Belgium

R55 Brazil


RegCode 名前

R1B Canada

R56 Chile

R45 Denmark

R33 France

R49 Germany

R44 Great Britain

R30 Greece

R353 Ireland

R39 Italy

R352 Luxemburg

R52 Mexico

R31 Netherlands

R47 Norway

R351 Portugal

R34 Spain

R46 Sweden

R1A United States

R598 Uruguay

4. 「ファイル」→「閉じる」をクリックし、サーバー・エクスプローラーに戻ります。

5. サーバー・エクスプローラーで、「ファイル」→「全データの保存」をクリックして、セルの値を保存します。

DBR 書式の作成これで、プロセス・ワークシートに読み込まれる各地域コードの地域名を取得する、DBR 書式を作成できます。

注: プロセス・ワークシートでは、DBRW 書式ではなく、DBR 書式を使用する必要があります。

手順1. プロセス・ワークシートで、セル B3 をクリックします。

2. 「TM1」>「書式の編集」をクリックします。

「書式の編集」バーが開きます。

3. 「DB 参照」をクリックします。

「キューブを選択」ダイアログ・ボックスが開きます。


別の「キューブを選択」ダイアログ・ボックスが開きます。

5. 「local:Translate」を選択して「OK」をクリックします。


TM1 では、“RegCodes”ディメンションの要素がセル B1 にあると確かに仮定しますが、“RegName”の要素を発見できません。

6. 「RegName」をクリックします。


7. 要素「Name」を選択して、「OK」をクリックします。

「regname」フィールドに、「選択済み」と表示されます。

8. 「Translate の参照を編集」ダイアログ・ボックスの「OK」をクリックします。

「書式の編集」バーに完全書式が表示されます。

=DBR("local:Translate", $B$1, "Name")

この書式は、セル B1 の“Regcodes”要素と、“Regname”要素の“Name”との交点にある、“Translate”キューブの値を返します。

9. 「OK」をクリックしてセル B3 に書式を挿入します。

タスクの結果

セル B3 に、コード R54 に対応した正しい地域の“Argentina”が表示されます。

データベース送信 (DBS) 書式の作成次の理由から、数値データの値をキューブに送信する DBS 書式を作成できます。

v “Actvsbud”ディメンション内の要素にマッピングされるコードを変換した。

v “Region”ディメンション内の要素にマッピングされるコードを変換した。

v 複数のデータ値を適切な月にマッピングした。

DBS 書式を、データ指示とマッピング指示を含む行の下の行に挿入します。書式を最初の行に挿入しないでください。TM1 がレコードをプロセス・ワークシートに読み込む際に上書きされるためです。

手順1. セル D4(最初の DBS 書式を格納する空のセル) をクリックします。

2. 「TM1」>「書式の編集」をクリックします。

「書式の編集」バーが開きます。

3. 「DB 送信」をクリックします。

TM1 によって、キューブに送信する値を選択するよう要求されます。

4. Jan のセル値を含むセル D1 をダブルクリックします。

TM1 によって、セル参照の種類を選択するよう要求されます。

5. 「列相対」をクリックします。

DBS 書式は常に行 1 を参照しますが、列の参照は書式の場所を基準に相対的になります。

TM1 によって、セルのデータ・タイプを指定するよう要求されます。


6. 「数値」をクリックします。

「キューブを選択」ダイアログ・ボックスで、データ移入するキューブを選択するよう要求されます。


別の「キューブを選択」ダイアログ・ボックスが開きます。

8. 「local:SalesCube」を選択して「OK」をクリックします。

「キューブの参照を編集」ダイアログ・ボックスに、キューブに送信する値(セル D1) のマッピング指示がほとんど表示されます。

セル A3 は、“Actvsbud”ディメンション内の要素を提供します。

v セル B1 は、“Region”ディメンション内の要素を提供します。

v セル C1 は、“Model”ディメンション内の要素を提供します。

v セル D3 は、“Month”ディメンション内の要素を提供します。

マッピングを完了するには、“Account1”ディメンションの要素を指定する必要があります。“Price.cma”には価格値が含まれているため、すべての DBS 書式を“price”要にマッピングする必要があります。

9. 「account1」をクリックします。


10. 「Price」を選択して「OK」をクリックします。

「キューブの参照を編集」ダイアログ・ボックスの「account1」フィールドに、「選択済み」と表示されます。


「書式の編集」バーに、生成された DBS 関数が表示されます。

DBS(D$1,"local:SalesCube",$A$3,$B$3,$C$1,"Price",D$3)

書式の詳細については、『DBS 構文』を参照してください。

12. 「OK」をクリックして、書式をプロセス・ワークシートに配置します。

13. D3 の書式を範囲 E3:O3 にコピーします。

14. PriceProcessing ワークシートを保存します。

DBS 構文DBS 関数は、次の構文を使用します。

DBS (value, server:cube, e1, e2[,...en]):

引数説明

value キューブに送信される数値。

server:cube 送信された値を受け取るキューブの名前。キューブ名には、キューブが存在するサーバー名のプレフィックスが必要です。例：sdata:SalesCube.


引数説明

e1,...en 値を受け取るキューブ内のセルの場所を指定する要素。要素の引数をディメンションの順序で指定します。例えば、e1 はキューブ内の最初のディメンションの要素であり、e2 はキューブの 2 番目のディメンションの要素である必要があります。

データ・ソースのキューブへの取り込みプロセス・ワークシートを作成したら、データをキューブに取り込むことができます。

このセクションの演習を完了すると、”PriceProcessing”ワークシートによって価格値が“SalesCube”キューブに取り込まれることが理解できるようになります。

規則算出のセル値は編集できないため、プロセス・ワークシートを使用して、規則算出値をキューブのセルに書き込むことはできません。

v “SalesCube”内の“Price”の値が規則算出値でないことを確認する必要があります。

v データ・ソースをキューブに取り込むことができます。


2. “SalesCube”キューブをダブルクリックします。

3. キューブに規則がアタッチされているかどうかを確認します。アタッチされていない場合、手順 8 を参照してください。

4. 規則がアタッチされている場合は、規則エディターで規則を開きます。

5. 規則を調べ、“Price”が規則算出かどうかを確認します。

注: 規則には、“Price”の値を数値レベルと集約レベルで算出する次のステートメントがあることに注意してください。


このステートメントは、“Price”の値を数値レベルと集約レベルで算出します。

6. 両方のステートメントの先頭にポンド記号 (#) を挿入して、“Price”の算出を無効にします。

#[’Price’]=N:DB(’PriceCube’,!actvsbud,!region,!model,!month);#C:[’Sales’]\[’Units’]*1000;

7. 規則を保存します。

ここでプロセス・ワークシートを使用して、“Price.cma”ソース・ファイルを“SalesCube”に取り込むことができます。

8. 規則がアタッチされていない場合、DBS 書式とマッピング指示が含まれるプロセス・ワークシートを開きます。

このセクションの前述の例に従った場合は、”PriceProcessing”プロセス・ワークシートを開きます。

9. 他のすべてのワークシートを閉じます。


10. 「TM1」>「プロセス・データ」>「プロセス」をクリックします。

「キューブ、ODBC またはフラット・ファイルを選択」ダイアログ・ボックスが開きます。

11. 「フラット・ファイル」をクリックします。

「入力ファイルを選択」ダイアログ・ボックスが開きます。

12. 「Price.cma」ソース・ファイルを選択して「OK」をクリックします。

TM1 によって、ソース・ファイルが処理されます。処理中、進捗バーが表示されます。

TM1 では、ソース・ファイルの各レコードは、プロセス・ワークシートの最初の行に順次読み込まれます。プロセス・ワークシートは、各レコードの読み込み後に再計算を行い、DBS 書式によって最初の行の値がキューブの適切なセルに送信されます。

13. “SaleCube”を参照し、“Price”値が“Price.cma”の値によって更新されていることを確認します。


第 7 章 TM1 オブジェクトに対するアクセスの制御

このセクションでは、すべての IBM Cognos TM1 インストール済み環境で、認証方法にかかわらず、IBM Cognos TM1 サーバー上のオブジェクトへのアクセスを制限する方法について説明します。

セキュリティー権限のグループへの割り当てTM1 の管理者以外のユーザー・グループに対して、オブジェクト・レベルのセキュリティーを割り当てることができます。セキュリティー権限をグループに割り当てることで、TM1 オブジェクトに対するユーザー・アクセスを制御できます。

注: ADMIN、DataAdmin、または SecurityAdmin グループに対しては、セキュリティー権限を割り当てることはできません。これらのグループの権限はあらかじめ定義されており、「TM1 セキュリティー割り当て」ダイアログ・ボックスでは無効になっています。

英語バージョンのセキュリティー・レベルのエントリーのみが許可されることにも注意してください。手動でセキュリティー・レベルを TM1 セル・セキュリティー・コントロール・キューブに入力する場合は、ここで説明されているように以下のキーワードを使用する必要があります。

TM1 グループのオブジェクト・レベルのセキュリティー権限は、次のとおりです。

v Admin - このグループは、キューブ、要素、ディメンション、その他のオブジェクトに対する完全なアクセス権限を持っている。

v Lock - このグループは、キューブ、要素、ディメンション、その他のオブジェクトを表示および編集でき、他のユーザーがオブジェクトを更新しないように永久にロックできる。

v Read - このグループは、キューブ、要素、ディメンション、プロセス、または日課を表示できるが、オブジェクト上で操作を実行できない。

v Reserve - このグループは、キューブ、要素、ディメンション、その他のオブジェクトを表示および編集でき、他のユーザーがオブジェクトを更新しないように一時的に予約できる。

v Write - このグループは、キューブ、要素、ディメンション、プロセス、または日課を表示および更新できる。

v None - このグループは、キューブ、要素、ディメンション、プロセス、または日課を表示できず、またオブジェクト上で操作の実行もできない。

次の表では、グループに割り当てることができるセキュリティー権限について説明します。


権限オブジェクト説明

Admin キューブこのグループのメンバーは、キューブの読み取り、書き込み、予約、ロック、および削除を行うことができます。共有キューブ・ビューを保存できます。また、セキュリティー権限をこのオブジェクトの他のユーザーに付与することもできます。

要素このグループのメンバーは要素へのアクセス、更新、予約、ロック、および削除を行うことができます。また、セキュリティー権限をこのオブジェクトの他のユーザーに付与することもできます。

ディメンションこのグループのメンバーは、ディメンション内で要素の追加、削除、および並べ替えを行うことができ、ディメンションの予約やロックも行うことができます。共有ディメンション・サブセットを保存できます。また、セキュリティー権限をこのオブジェクトの他のユーザーに付与することもできます。

アプリケーション

このグループのメンバーは、アプリケーションの表示、アプリケーション内の参照の使用、およびアプリケーション内での共有参照と個人用参照の作成を行うことができます。

グループにアプリケーションに対するAdmin権限がある場合、このグループのメンバーは、自身のグループでなく他のグループのアプリケーション内の、すべての参照とサブアプリケーションに対してセキュリティー権限を設定できます。

参照このグループのメンバーは、参照の使用、および参照の更新または削除を行うことができます。個人用参照を発行したり、共有参照を個人用にしたりできます。



Lock キューブこのグループのメンバーは、Write 権限に含まれているすべての権限を持ち、キューブもロックできます。キューブをロックすると、どのユーザーもそのデータを更新できなくなります。

ロックを削除できるのは、キューブのAdmin権限を持っているユーザーのみです。

リモート・サーバーのシャットダウン後、ロックはそのまま保持されます。

要素このグループのメンバーは、Write 権限に含まれているすべての権限を持ち、要素もロックできます。要素をロックすると、どのユーザーも、その要素で指定されたキューブ・セルを更新できなくなります。

ロックを削除できるのは、要素のAdmin権限を持っているユーザーのみです。


ディメンションこのグループのメンバーは、Write 権限に含まれているすべての権限を持ち、ディメンションもロックできます。ディメンションをロックすると、どのユーザーもそのディメンション構造を編集できなくなります。

ロックを削除できるのは、ディメンションのAdmin権限を持っているユーザーのみです。


第 7 章 TM1 オブジェクトに対するアクセスの制御 127


Read キューブこのグループのメンバーは、キューブ内のセルを表示できますが、データを変更できません。

要素このグループのメンバーは、要素で指定されたセルを表示できますが、データを変更できません。

ディメンションこのグループのメンバーは、ディメンション内の要素を表示できますが、要素の追加、削除、または並べ替えを行うことができません。

プロセスこのグループのメンバーは、サーバー・エクスプローラーでプロセスを表示し、手動でプロセスを実行できますが、編集はできません。注: 日課内からプロセスが実行される場合、プロセスに割り当てられた権限は無視されます。

日課このグループのメンバーは、サーバー・エクスプローラーで日課を表示し、手動で日課を実行できますが、編集はできません。


このグループのメンバーは、アプリケーションを表示し、少なくともRead権限のあるアプリケーション内の共有参照を使用できます。アプリケーション内に個人用参照を作成し、個人用サブアプリケーションを作成することもできます。

参照このグループのメンバーは、参照を開くことができますが、アプリケーション内の参照を更新できません。ただし、「名前を付けて保存」操作を実行して、新しい個人用バージョンの参照を保存できます。



Reserve キューブこのグループのメンバーは、Write権限に含まれているすべての権限を持ち、他のユーザーが編集しないようにキューブを予約することもできます。予約を削除できるのは、キューブを予約したユーザー、またはキューブのAdmin権限を持っているユーザーです。

予約しているユーザーがリモート・サーバーから切断するか、サーバーがシャットダウンすると、予約は自動的に期限切れになります。

要素このグループのメンバーは、Write権限に含まれているすべての権限を持ち、他のユーザーが要素で指定されたキューブ・セルを更新しないように、要素を予約することもできます。予約を削除できるのは、要素を予約したユーザー、または要素のAdmin権限を持っているユーザーです。


ディメンションこのグループのメンバーは、Write権限に含まれているすべての権限を持ち、他のユーザーがディメンションを再定義しないようにディメンションを予約することもできます。予約を削除できるのは、ディメンションを予約したユーザー、またはディメンションのAdmin権限を持っているユーザーです。


Write キューブこのグループのメンバーは、セルの読み取りおよび更新を行うことができます。個人用キューブ・ビューを保存できます。Writeアクセス権限は、集約要素で指定されたセル、または規則から導出されたセルには適用されません。

要素このグループのメンバーは、要素で指定されたセルを読み取りおよび更新し、要素の属性を編集できます。

ディメンションこのグループのメンバーは、要素の属性の編集、要素の書式の編集、およびディメンションの個人用サブセットの作成を行うことができます。また、ディメンション自身の属性も編集できます。



None キューブこのグループのメンバーは、サーバー・エクスプローラーでキューブを表示できないため、キューブを参照できません。

要素このグループのメンバーは、サブセット・エディターまたはディメンション・エディターで要素を表示できず、キューブの参照時に要素で指定されたセルを表示できません。

ディメンションこのグループのメンバーは、サーバー・エクスプローラーでディメンションを表示できず、ディメンションを含むキューブを参照できません。

プロセスこのグループのメンバーは、サーバー・エクスプローラーでプロセスを表示できないため、プロセスを実行できません。注: 日課内からプロセスが実行される場合、プロセスに割り当てられた権限は無視されます。

日課このグループのメンバーは、サーバー・エクスプローラーで日課を表示できないため、日課を実行できません。


このグループのメンバーは、サーバー・エクスプローラーでアプリケーションまたはその内容を表示できません。

参照このグループのメンバーは、サーバー・エクスプローラーで参照を表示できません。

異なるオブジェクトのセキュリティー権限の相互作用データのセルを識別するオブジェクトに異なるセキュリティー権限を適用すると、TM1 によって、そのセルに最も制限の厳しいセキュリティー権限が適用されます。

シナリオ 1

ユーザーに、“SalesCube”キューブに対するReadアクセス権限、およびこのキューブ内の要素に対するWriteアクセス権限を割り当てるものとします。このシナリオでは、キューブのReadアクセス権限は要素のWriteアクセス権限より優先されるため、ユーザーはキューブ・データを表示できますが、更新はできません。

シナリオ 2

“SalesPriorCube”キューブには、次のディメンションが含まれています。

v Actvsbud

v Region

v Model

v Account1

v 月


ユーザーには、“SalesPriorCube”キューブへのWriteアクセス権限、“Actvsbud”ディメンション内のすべての要素へのReadアクセス権限、他のディメンション内のすべての要素へのWriteアクセス権限があるものとします。“Actvsbud”ディメンション内の要素は、キューブ内のすべてのセルを識別するため、ユーザーはキューブ・データを更新できません。

シナリオ 3

キューブとディメンションの両方のセキュリティー権限は、変更可能です。グループにキューブに対するアクセス権限がある場合、特定のディメンションまたは要素に対するアクセス権限をさらに制限しない限り、これらの権限はキューブ内のすべてのディメンションに適用されます。

複数の地域のユーザー・グループに、“SalesPriorCube”キューブ内のすべてのデータの読み取り権限を付与するものとします。また、各グループが自分の地域のデータを更新できるようにします。例えば、“North America”グループの販売員が North

America のデータを更新できるようにします。

このセキュリティー・スキームを実装するには、次の手順を実行できます。

v 販売地域を反映したグループを作成する。

v ユーザーを適切なグループに追加する。

v 各地域グループに、“SalesPriorCube”キューブへのWriteアクセス権限を付与する。

v “North America”グループに、North America 地域のデータを反映しない要素へのReadアクセス権限を付与する。

次の TM1 サンプル・データは、このセキュリティー・スキームを反映しています。Usr1 は North America グループに属し、このグループには、North America 地域内の区域に関連付けられたデータへの Write アクセス権限と、他の地域内の区域に関連付けられたデータへの Read アクセス権限があります。

キューブのセキュリティー保護個々のキューブに対するグループのアクセス権限を拡張または制限できます。新しいキューブを作成した場合、他のグループは、最初その新しいキューブに対してNoneアクセス権限を持ちます。このため、他のグループに関して、新しいキューブに対するセキュリティー権限を割り当てる必要があります。

キューブに関するセキュリティー権限の割り当てキューブに関するセキュリティー権限を割り当てるには、次の手順を実行します。


2. 作業しているサーバーの「キューブ」アイコンを選択します。

3. 「キューブ」→「セキュリティー割り当て」をクリックします。

「TM1 セキュリティー割り当て」ダイアログ・ボックスが開きます。

4. キューブ名と権限を割り当てるグループ名の交点にあるセルをクリックします。


セルの範囲を選択すると、複数のキューブに関する権限を割り当てたり、権限を複数のグループに割り当てたりできます。セルの範囲を選択するには、範囲の上端を構成するセルをクリックし、Shift キーを押しながら、列または行を下方に移動して範囲の下端を構成するセルまでクリックします。

5. 割り当てるアクセス・レベルを選択します。

セルに割り当てられたアクセス権限の名前が表示されます。


キューブの予約と解放ユーザーがキューブを予約すると、そのユーザーは、キューブ内のデータを更新する排他的な権限を取得します。他のユーザーは、そのキューブが解放されるまでキューブ・データを更新できません。キューブを解放できるのは、キューブを予約したユーザー、またはそのキューブのAdmin権限を持っているユーザーです。

キューブのデータを一時的に固定する方法として、キューブの予約を検討してください。予約しているユーザーがリモート・サーバーから切断するか、サーバーがシャットダウンすると、予約は自動的に期限切れになります。


2. 予約するキューブを選択します。

3. 「キューブ」→「セキュリティー」→「予約」をクリックします。

キューブを解放するには：

4. キューブを予約するための手順 1 および 2 に従います。

5. 「キューブ」→「セキュリティー」→「解放」をクリックします。

キューブのロックとロック解除キューブがロックされていると、ユーザーはデフォルトの Admin グループのメンバーでない限り、キューブ・データの更新もキューブのロック解除も行えません。Admin 権限のあるユーザー定義グループのメンバーは、キューブのロックを解除できません。キューブのロック解除は、デフォルトの Admin (または DataAdmin) グループのメンバーに制限されています。

キューブのデータを永久にアーカイブする方法として、キューブのロックを検討してください。サーバーのシャットダウン後、ロックはそのまま保持されます。


2. ロックするキューブを選択します。

3. 「キューブ」→「セキュリティー」→「ロック」をクリックします。

キューブをロック解除するには：

4. キューブをロックするための手順 1 および 2 に従います。

5. 「キューブ」→「セキュリティー」→「ロック解除」をクリックします。


要素のセキュリティー保護「要素のセキュリティー割り当て」ダイアログ・ボックスを使用すると、個々の要素に対するグループのアクセス権限を拡張または制限できます。

要素に関するセキュリティー権限の割り当て要素に関するセキュリティー権限を割り当てるには、次の手順を実行します。


2. 作業するディメンションを選択します。

3. 「ディメンション」→「セキュリティー」→「要素のセキュリティー割り当て」をクリックします。

「TM1 セキュリティー割り当て」ダイアログ・ボックスが表示されます。

4. 要素名とグループ名の交点にあるセルをクリックします。

セルの範囲を選択すると、複数の要素に関する権限を割り当てたり、権限を複数のグループに割り当てたりできます。セルの範囲を選択するには、範囲の上端を構成するセルをクリックし、Shift キーを押しながら、列または行を下方に移動して範囲の下端を構成するセルまでクリックします。



6. 「保存」または「OK」をクリックします。

注: 「保存」をクリックすると、セキュリティー権限の別の要素への割り当てを続行できます。他のディメンション内の要素にアクセスするには、「ディメンションを選択」フィールドでディメンションを選択します。

リーフ要素と集約要素のセキュリティー権限の相互作用集約要素および集約に属するリーフ要素には、異なるレベルのセキュリティーを設定できます。

例えば、サンプル・データの“Region”ディメンションには、次の要素階層があります。

Usr4 には、“Canada”リーフ要素への Read アクセス権限、“North America”集約要素へのNoneアクセス権限があるとします。この場合、Usr4 は、“Canada”要素で指定されたデータを表示できますが、“North America”要素で指定された集約データを表示できません。

要素の予約と解放ユーザーが要素を予約すると、そのユーザーは、要素で指定されたデータを更新する排他的な権限を取得します。他のユーザーは、要素が解放されるまで要素のデー


タを更新できません。要素を解放できるのは、キューブを予約したユーザー、またはその要素のAdmin権限を持ているユーザーです。

要素が指定するデータを一時的に固定する方法として、要素の予約を検討してください。予約しているユーザーがリモート・サーバーから切断するか、サーバーがシャットダウンすると、予約は自動的に期限切れになります。


2. 作業するディメンションをダブルクリックします。

サブセット・エディターが表示されます。

3. 予約する要素を選択します。

4. 「編集」→「セキュリティー」→「予約」をクリックします。

要素を解放するには：

5. 要素を予約するための手順 1 ～ 3 に従います。

6. 「編集」→「セキュリティー」→「解放」をクリックします。

要素のロックとロック解除ユーザーが要素をロックした場合、要素が指定するデータを更新できるのは、その要素のAdmin権限を持つユーザーのみです。要素をロックしたユーザーでも、その要素のAdmin権限を持たない限り、そのデータを更新できません。

要素が指定するデータを永久にアーカイブする方法として、要素のロックを検討してください。リモート・サーバーのシャットダウン後、ロックはそのまま保持されます。


2. 作業するディメンションをダブルクリックします。

サブセット・エディターが表示されます。

3. ロックする要素を選択します。

4. 「編集」→「セキュリティー」→「ロック」をクリックします。

要素をロック解除するには：

5. 要素をロックするための手順 1 ～ 3 に従います。

6. 「編集」→「セキュリティー」→「ロック解除」をクリックします。

セルのセキュリティー保護セル・レベルのセキュリティーは、指定されたセルに適用され、他のすべての TM1

セキュリティーを上書きします。セル・レベルのセキュリティーでは、次の操作が必要となります。


v セル・レベルのセキュリティーを構成しようとしているキューブのディメンションのサブセットを含む、セル・セキュリティー・コントロール・キューブを作成します。

v TM1 セキュリティー・グループに関するセキュリティー権限を割り当てることで、セキュリティー・コントロール・キューブ内の適切なセルのセキュリティーを設定する。

注: 要素レベルのセキュリティーをセルに適用する場合、TM1 セキュリティー・グループに対してセルのセキュリティー権限を割り当てることはできません。セル・レベルのセキュリティーが要素レベルのセキュリティーを上書きするため、セルに対するセル・レベルのセキュリティーは未定義にする必要があります。

セル・レベルのセキュリティーはリーフ要素に適用され、通常集約には適用されません。ただし、NoneおよびReadセキュリティー権限を使用して、集約の表示または編集を制御できます。

セル・セキュリティー・コントロール・キューブの作成セル・セキュリティー・コントロール・キューブを作成するには、次の手順を実行します。

手順1. TM1 Architect または TM1 Perspectives で、セル・レベルのセキュリティーを定義するキューブを右クリックし、「セキュリティー」→「セル・セキュリティー・キューブの作成」を選択します。

TM1 では、“}CellSecurity_CubeName”(CubeName は、選択したキューブの名前)

という命名形式を使用して、自動的にセキュリティー・コントロール・キューブを作成します。例えば、“SalesCube”キューブを選択した場合、TM1 では“}CellSecurity_SalesCube”というセキュリティー・コントロール・キューブが作成されます。

TM1 によって、元のキューブからセキュリティーの設定に必要なディメンションが新たに作成されたセキュリティー・コントロール・キューブに追加され、さらに“}Groups”ディメンションが新しいキューブの最後のディメンションとして追加されます。

2. コントロール・キューブが表示されていない場合、「表示」→「コントロール・オブジェクトを表示」をクリックします。

TM1 では、元のキューブと共に新しいセキュリティー・コントロール・キューブが表示されます。


セル・セキュリティー

コントロール・キューブ

元のキューブ

セキュリティーを TM1 セキュリティー・グループ別にセキュリティー・コントロール・キューブ内のセルに適用するには：

3. 作成したセキュリティー・コントロール・キューブをダブルクリックして開きます。例えば、

4. 「再計算」をクリックしてセキュリティー・コントロール・グループを表示するか、「オプション」→「自動再計算」をクリックします。

5. 行を拡張して、セキュリティー権限を割り当てるセルを表示します。

注: セル・レベルのセキュリティーはリーフ要素に適用されます。

6. キューブ・セル内にセキュリティー・レベルを入力して、ユーザー・グループ別にセキュリティー権限を割り当てます。

詳細については、 125ページの『セキュリティー権限のグループへの割り当て』を参照してください。

例えば、“Inspectors”グループの第 2 四半期の各月には、Noneのセキュリティーが割り当てられています。

7. セキュリティー・コントロール・キューブを閉じます。

8. ビューを保存します。

9. 影響を受けるセキュリティー・グループのメンバーとしてログオンし、セキュリティーを設定したキューブを表示することで、セキュリティー・レベルをテストします。


規則を使用したセル・レベルのセキュリティーの定義セキュリティー・コントロール・キューブでは、セキュリティー権限をセキュリティー・コントロール・キューブのセルに入力する代わりに、TM1 規則を使用してセル・レベルのセキュリティーを適用できます。

セル・レベルのセキュリティーを適用するための規則の使用方法について詳しくは、「TM1 操作」を参照してください。

“}CellSecurity_SalesCube”キューブのセル・レベルのセキュリティーを適用する規則を作成するものとします。次の規則を適用すると、“Inspectors”グループのすべてのユーザーは、“Greece”要素で指定されたセルを表示できなくなります。

[’Greece’,’Inspectors’] = S:’NONE’;

注: セキュリティー・グループ名が一意で、他のディメンションまたは要素が同じ名前を使用していないことを確認してください。

規則を使用してセキュリティーを実装する利点は、次のとおりです。

v セキュリティー権限をセキュリティー・コントロール・キューブのセルに入力しないため、データ入力時間を節約できる。

v TM1 では文字列規則の値はメモリーやディスクに保存されないため、メモリー使用量やディスク領域を節約できる。

ディメンションのセキュリティー保護個々のディメンションに対するグループのアクセス権限を拡張または制限できます。

デフォルトでは、TM1 は、IBM Cognos TM1 サーバーのディメンションについて次のようなセキュリティー制御を行います。

v ADMIN グループと DataAdmin グループのメンバーのみ、TM1 サーバー上でディメンションの作成および削除ができる。

v ディメンションに対してReadアクセス権限を持つグループは、サーバー・エクスプローラー経由でディメンションと要素の属性を表示できるが、属性値を編集することはできない。

v 他のグループは、新しいディメンションに対して最初Noneアクセス権限を持つ。

v ディメンション内の要素にセキュリティーが割り当てられていない場合、グループはそのディメンション内の新しい要素に対してWriteアクセス権限を持つ。

v ディメンション内の少なくとも 1 つの要素にセキュリティー権限を割り当てると、グループはそのディメンション内の新しい要素に対してNoneアクセス権限を持つ。既存の要素は、アクセス権限を変更しない限り、元のアクセス権限 (Write)

を保持します。

注: ディメンション内のセキュリティーを変更し、そのセキュリティーをデフォルト設定 (グループには、ディメンションに追加された新しい要素への Write アクセス権限がある) にリセットする場合は、TM1 サーバーをシャットダウンし、手動で「}ElementSecurity＜ディメンション名＞.cub」ファイルを削除してください。


ディメンションに関するセキュリティー権限の割り当てディメンションに関するセキュリティー権限を割り当てるには、次の手順を実行します。


2. 作業しているサーバーの「ディメンション」アイコンを選択します。

3. 「ディメンション」→「セキュリティー割り当て」をクリックします。

「TM1 セキュリティー割り当て」ダイアログ・ボックスが表示されます。

4. ディメンション名とグループ名の交点にあるセルをクリックします。

セルの範囲を選択すると、複数のディメンションに関する権限を割り当てたり、権限を複数のグループに割り当てたりできます。セルの範囲を選択するには、範囲の上端を構成するセルをクリックし、Shift キーを押しながら、列または行を下方に移動して範囲の下端を構成するセルまでクリックします。




ディメンションの予約と解放ユーザーがディメンションを予約すると、そのユーザーは、そのディメンション内で要素の追加、削除、および並べ替えを行う排他的な権限を取得します。他のユーザーは、解放されるまでディメンションを変更できません。ディメンションを解放できるのは、キューブを予約したユーザー、またはそのディメンションのAdmin権限を持っているユーザーです。

ディメンションを再定義する前に、ディメンションの予約を検討してください。予約しているユーザーがリモート・サーバーから切断するか、サーバーがシャットダウンすると、予約は自動的に期限切れになります。



3. 「ディメンション」→「セキュリティー」→「予約」をクリックします。

ディメンションを解放するには：

4. ディメンションを予約するための手順 1 および 2 に従います。

5. 「ディメンション」→「セキュリティー」→「解放」をクリックします。

ディメンションのロックとロック解除ユーザーがディメンション・ロックした場合、そのディメンション内で要素の追加、削除、または並べ替えを行うことができるのは、そのディメンションのAdmin権限を持つユーザーのみです。ディメンションをロックするユーザーは、そのディメンションに対するAdmin権限を持たない限り、修正できません。


ディメンションの定義を排他的に制御する場合、ディメンションのロックを検討してください。



3. ポップアップ・メニューから「ディメンション」→「セキュリティー」→「ロック」をクリックします。

ディメンションを解放するには：

4. ディメンションをロックするための手順 1 および 2 に従います。

5. マウスを右クリックし、「ディメンション」→「セキュリティー」→「ロック解除」をクリックします。

プロセスのセキュリティー保護個々の TurboIntegrator プロセスに対するグループのアクセス権限を拡張または制限できます。

注: 日課からプロセスを実行する場合、TM1 は TurboIntegrator プロセスに割り当てたセキュリティー権限を無視します。日課に割り当てるセキュリティー権限によって、日課からプロセスを実行する際のグループの能力が決まります。例えば、グループに Process1 への None アクセス権限、Process1 を含む日課への Read アクセス権限がある場合、グループは日課から Process1 を実行できます。

プロセスに関するセキュリティー権限の割り当てプロセスに関するセキュリティー権限を割り当てるには、次の手順を実行します。


2. 作業しているサーバーの「プロセス」アイコンを選択します。

3. 「プロセス」→「セキュリティー割り当て」をクリックします。


4. プロセス名とグループ名の交点にあるセルをクリックします。

複数のセルを選択すると、複数のプロセスに関する権限を割り当てたり、権限を複数のグループに割り当てたりできます。

隣接するセルの範囲を選択するには、範囲の上端を構成するセルをクリックし、Shift キーを押しながら、列または行を下方に移動して範囲の下端を構成するセルまでクリックします。

隣接しない複数のセルを選択するには、CTRL キーを押しながら各セルをクリックします。





プロセスによるセキュリティー・データの変更許可TM1 の「セキュリティー・アクセス」オプションは、プロセスでそのスクリプト内のセキュリティー・データを変更できるかどうかを制御します。このオプションを設定できるのは、ADMIN グループと SecurityAdmin グループのメンバーのみです。このオプションは、サーバー・エクスプローラーの「プロセス」メニューからプロセスごとに設定されます。

プロセスに対して「セキュリティー・アクセス」オプションが有効になっている場合：

v DataAdmin グループのメンバーは、TM1 セキュリティーを変更できるスクリプトを含んでいる可能性があるため、プロセスを編集できない。

v 完全な ADMIN グループのメンバーのみ、「セキュリティー・アクセス」オプションを有効にした後にプロセスを編集できる。

v SecurityAdmin グループのメンバーは、プロセスを表示し、このオプションのオン/オフを切り替えられるが、プロセスの内容は編集できない。

v 「プロセス」メニューの「表示」オプションが使用可能になり、DataAdmin グループと SecurityAdmin グループのユーザーが、読み取り専用モードでプロセスを表示できるようになる。

ADMIN、SecurityAdmin、および DataAdmin グループの詳細については、「TM1 操作」を参照してください。

プロセスのセキュリティー・アクセス・オプションの有効化デフォルトでは、新しいプロセスに対して「セキュリティー・アクセス」オプションは無効になっています。新しいプロセスで TM1 セキュリティーを変更できるようにする場合、そのプロセスの「セキュリティー・アクセス」オプションを手動で有効にする必要があります。

手順1. サーバー・エクスプローラーで、プロセスを選択します。

2. 「プロセス」→「セキュリティー・アクセス」をクリックします。

「セキュリティー・アクセス」オプションの横にあるチェック・マークは、TM1

では選択したプロセスがセキュリティー・データを変更できることを示します。

注: 以前のバージョンの TM1 データベースから TM1 9.4 以降のバージョンにアップグレードした場合、既存の TM1 プロセスすべてに対して、「セキュリティー・アクセス」オプションが自動的に有効になります。このため、各プロセスに対して「セキュリティー・アクセス」オプションを個々に設定せずに、既存のプロセスを実行し続けることができます。

読み取り専用モードでのプロセスの表示プロセスに対して「セキュリティー・アクセス」オプションを有効にした場合、DataAdmin グループと SecurityAdmin グループのユーザーのみ、プロセスを読み取り専用モードで表示できます。


手順1. サーバー・エクスプローラーで、プロセスを選択します。

2. プロセスを右クリックし、「表示」をクリックします。

プロセスが読み取り専用モードで表示されます。

日課のセキュリティー保護個々の日課に対するグループのアクセス権限を拡張または制限できます。

日課に関するセキュリティー権限の割り当て日課に関するセキュリティー権限を割り当てるには、次の手順を実行します。


2. 作業しているサーバーの「日課」アイコンを選択します。

3. 「日課」→「セキュリティー割り当て」をクリックします。


4. 日課名とグループ名の交点にあるセルをクリックします。

複数のセルを選択すると、複数の日課に関する権限を割り当てたり、権限を複数のグループに割り当てたりできます。

隣接するセルの範囲を選択するには、範囲の上端を構成するセルをクリックし、Shift キーを押しながら、列または行を下方に移動して範囲の下端を構成するセルまでクリックします。

隣接しない複数のセルを選択するには、CTRL キーを押しながら各セルをクリックします。




アプリケーションと参照のセキュリティー保護共有の TM1 アプリケーション内の共有アイテム (参照またはサブアプリケーション) に関するセキュリティー権限を、IBM Cognos TM1 サーバー上のユーザー・グループに割り当てることができます。アプリケーション内のアイテムにセキュリティーを割り当てるには、そのアプリケーションに対する Admin 権限が必要です。

個人用アプリケーションと個人用参照に関するセキュリティーを割り当てることはできません。アイテムにアクセスできるのは、個人用アイテムを作成したユーザーのみです。


手順1. サーバー・エクスプローラーで、セキュリティーを割り当てるアイテムを含むアプリケーションを右クリックします。

2. 「セキュリティー」→「セキュリティー割り当て」をクリックします。

「TM1 セキュリティー割り当て」ウィンドウが開きます。「名前」リストには、現在のアプリケーションに含まれているすべての共有アイテム (TM1 オブジェクト、Excel ファイル、およびサブアプリケーション) が示されます。

3. セキュリティーを定義するアイテム、およびセキュリティーを割り当てるユーザー・グループの交点にあるセルをクリックします。

4. 使用可能なセキュリティー権限のいずれかをクリックします。

詳細については、 125ページの『セキュリティー権限のグループへの割り当て』を参照してください。

5. セキュリティーを定義する他のアイテムについて、手順 3 および 4 を繰り返します。


任意のユーザー・グループについて、その参照に対する Read 権限または Admin

権限をこのユーザー・グループに割り当てることができます (ある参照に関連付けられているソース・オブジェクトに関する権限が None である場合)。このシナリオでは、ユーザー・グループのメンバーは、アプリケーション内の参照を表示できません。

例えば、ユーザー・グループにキューブのNone権限を割り当て、同じキューブに参照のRead権限を割り当てた場合、ユーザー・グループのメンバーは、アプリケーション内のキューブへの参照を表示できません。


第 8 章 TM1 操作ボタンを使用したワークシート・アプリケーションの構築

このセクションでは、プロセスを実行しワークシートと Web シート間をナビゲートするための IBM Cognos TM1 操作ボタンの機能について説明します。

概要操作ボタンをワークシートに挿入すると、ユーザーが TurboIntegrator プロセスを実行したり、別のワークシートにナビゲートしたりできるようにできます。ユーザーがこれらのボタンにアクセスできるのは、TM1 を使用して Microsoft Excel のワークシートで作業する場合、または TM1 Web の Web シートで作業する場合です。

操作ボタンでは、次のいずれかのタスクを実行できます。

v TurboIntegrator プロセスを実行する。

v 別のワークシートにナビゲートする。

v TurboIntegrator プロセスを実行してから、別のワークシートにナビゲートする。

v ワークシートを再計算するか、ワークシート内に TM1 アクティブ・フォームを再構築する。

次の図は、ワークシート内の操作ボタンの例を示しています。

TM1 プロセスを実行

TM1 操作

ボタンのある

Excel ワークシート

操作ボタンのワークシートへの追加次の手順を使用して、ワークシート内の空のセルに操作ボタンを挿入できます。

手順1. Excel で、操作ボタンを挿入するワークシート内の空のセルを選択します。

注: 操作ボタンは、データを含むセルには挿入できません。


2. 「TM1」メニューから「操作ボタンを挿入」を選択するか、TM1 ツールバーの

「操作ボタンを挿入」をクリックします。

現在選択されているセルに操作ボタンが挿入され、「操作ボタンのプロパティー」ダイアログ・ボックスが表示されます。

3. 「操作ボタンのプロパティー」ダイアログ・ボックスで、「TM1 Server」リストをクリックして、データが配置されたサーバーを選択します。

操作ボタンが実行されるたびに、セルまたは既定の範囲から IBM Cognos TM1

サーバーの名前を動的に取得する場合は、「参照を使用」チェック・ボックスをクリックし、セルまたは既定の範囲の参照を入力します。

v セル参照を選択するには、「Excel 参照」ボタンをクリックして、サーバー名が配置されている現在のワークシートのセルをクリックします。

v Excel の既定の範囲を参照することによってプロセス名を取得するためには、次の形式を使用します。

=NameOfRange

既定の範囲では、サーバー名のテキストを含む 1 つのセルのみを示す必要があります。

使用するサーバーに現在接続していない場合、「接続」をクリックしてログオンします。

4. 操作ボタンが実行する「操作」オプションをクリックします。

次に、選択した操作に応じて、操作ボタンを設定する必要があります。詳細な手順については、次のセクションを参照してください。

操作参照

TurboIntegrator プロセスの実行 145ページの『操作ボタンを設定してプロセスを実行する』

別のワークシートに移動 149ページの『操作ボタンを設定して別のワークシートにナビゲートする』

プロセスを実行してから別のワークシートに移動する

151ページの『操作ボタンを設定して、プロセスを実行しワークシートにナビゲートする』

再計算/再構築 152ページの『操作ボタンを設定して、ワークシートを再計算または再構築する』

5. 操作ボタンのアピアランスのプロパティーを設定します。 153ページの『操作ボタンのアピアランスのプロパティーの設定』を参照してください。

6. 操作ボタンを終了し、ワークシートに戻るためには、「操作ボタンのプロパティー」ダイアログ・ボックスで「OK」をクリックします。

タスクの結果

ワークシートの操作ボタンが更新され、使用できるようになります。


操作ボタンを設定してプロセスを実行する次の手順は、操作ボタンを設定して TurboIntegrator プロセスを実行する方法の概要を示します。

手順1. 「操作ボタンのプロパティー」ダイアログ・ボックスで、「TurboIntegrator プロセスを実行」オプションを選択します。

「プロセス」タブが表示されます。

2. 実行するプロセスを選択します。『実行するプロセスの選択』を参照してください。

3. プロセス・パラメーターを設定します。 146ページの『プロセス・パラメーターの設定』を参照してください。

4. 操作ボタンがプロセスを実行する前に、TM1 が適用する計算オプションを選択します。 152ページの『操作ボタンを設定して、ワークシートを再計算または再構築する』を参照してください。

5. プロセスが完了した後に TM1 が適用する計算オプションを選択します。 148ページの『計算用のプロセス・オプションの設定』を参照してください。

6. プロセスの実行前と後に TM1 が表示するメッセージを設定します。 148ページの『メッセージ表示のためのプロセス・オプションの設定』を参照してください。

実行するプロセスの選択次の 2 つの方法のいずれかで実行するプロセスを選択できます。

v 「プロセス」リストからプロセス名を選択します。

v Excel 参照を使用してプロセス名を動的に取得します。

プロセス・リストからプロセス名を選択する現在の IBM Cognos TM1 サーバー上で使用できるプロセスのリストからプロセス名を選択するには、次の手順に従います。

手順

「操作ボタンのプロパティー」ダイアログの「プロセス」タブで、「プロセス」リストをクリックして、現在の接続先の TM1 Server から使用可能なプロセスを選択します。「パラメーター」グリッドが開き、選択したプロセスのパラメーターが表示されます。

タスクの結果

次に、「パラメーター」グリッドで選択したプロセスのパラメーター値を入力する必要があります。 146ページの『パラメーター値を「パラメーター」グリッドに入力する』を参照してください。

第 8 章 TM1 操作ボタンを使用したワークシート・アプリケーションの構築 145

Excel 参照を使用したプロセス名の取得現在のワークシートでセルまたは既定の範囲を参照することによってプロセス名を動的に取得するには、次の手順を実行します。プロセス名は、操作ボタンの実行時に取得されます。

手順1. 「操作ボタンのプロパティー」ダイアログ・ボックスで、「プロセス」リストから「ワークシートからプロセス情報を取得」を選択します。

2. 「プロセス名」ボックスの横にある「Excel 参照」ボタンをクリックして、現在のワークシートからセルを選択します。

「セルを選択」ダイアログ・ボックスが開きます。

3. プロセス名が置かれている現在のワークシートのセルをクリックします。

場所が自動的に「セルを選択」ダイアログ・ボックスに入力されます。

4. 「OK」をクリックして、「セルを選択」ダイアログ・ボックスを閉じます。

「プロセス名」ボックスにセルの参照が表示されます。

5. Excel の既定の範囲を参照することによってプロセス名を取得するためには、次の形式を使用します。

=NameOfRange

既定の範囲は、プロセス名のテキストを含む 1 つのセルのみポイントしている必要があります。

プロセス・パラメーターの設定実行するプロセスの名前が選択された方法に応じて、次の 2 つの方法のいずれかでパラメーター値を入力します。

v 「パラメーター」グリッドにパラメーター値を入力します。

v Excel 参照を作成してパラメーター値を取得します。

パラメーター値を「パラメーター」グリッドに入力する「プロセス」リストから直接プロセス名を選択した場合、次の手順を使用して、パラメーター値を「パラメーター」グリッドに入力できます。パラメーターごとに値をグリッドに入力することも、操作ボタンがクリックされたときに現在のワークシートからパラメーター値を動的に取得する Excel 参照を使用することも可能です。

手順1. 「操作ボタンのプロパティー」ダイアログの「プロセス」タブで、「パラメーター」グリッドにパラメーター値を入力します。

パラメーター値を直接入力するには、パラメーターごとにグリッドに値を入力します。

2. 現在のワークシートからパラメーター値を動的に取得する参照を作成するに

は、「値」セルを選択してからボタンをクリックします。


「セルを選択」ダイアログ・ボックスが開きます。

3. 「セルを選択」ダイアログ・ボックスを使用して、パラメーター値を検索できるワークシート内のセルを選択します。

パラメーター値に対する

セル参照

Excel 参照を使用したパラメーター値の取得「プロセス」リストから「ワークシートからプロセス情報を取得」オプションを選択した場合、プロセス・パラメーターをワークシートから動的に取得する Excel 参照を作成する必要があります。

手順

1. 「パラメーター」ボックスの横にある「Excel 参照」ボタンをクリックして、現在のワークシートから参照を選択します。

「範囲を選択」ダイアログ・ボックスが開きます。

2. パラメーター値が置かれているワークシートのセルの範囲を選択します。各セルは 1 つのパラメーターのみの値を含む必要があります。

注: パラメーターは、プロセスと同じ順序とタイプ (文字列、数値) を入力する必要があります。

3. 「OK」をクリックして、「範囲を選択」ダイアログを閉じます。

「パラメーター」ボックスに選択したセルの参照が表示されます。

Excel の既定の範囲を参照する場合、次の形式を使用します。

=NameOfRange

既定の範囲は、プロセスが予期しているパラメーターに応じて、1 つのセルまたはセルの範囲をポイントしている必要があります。


プロセスのパラメーターを変更した場合、操作ボタンのプロセス名およびパラメーター設定も更新して、ボタンが正しくプロセスを実行できるようにする必要があります。

注: パラメーター入力付きの TurboIntegrator プロセスを実行する操作ボタンがExcel 2007 ワークシートで作成および保存されている場合、Microsoft Excel の問題が原因で、そのファイルを保存してから再び開くと、操作ボタンが機能しなくなります。パラメーターが必要な TI プロセスを実行するために操作ボタンをExcel 2007 で使用する場合、回避策として、ワークシート・ファイルを .xls 形式で保存してください。

計算用のプロセス・オプションの設定「プロセス・オプション」ダイアログ・ボックスを使用して、プロセスの実行後に実行される計算操作を選択します。

手順1. 「オプション」をクリックして、「プロセス・オプション」ダイアログ・ボックスを表示します。

2. プロセスが実行された後に実行する計算操作を選択します。使用可能な計算オプションを次に示します。

v 「シートを自動的に再計算」 - 現在のワークシート内の値を再計算する。

v 「シートの再構築」 - TM1 アクティブ・フォームを元のレポート定義設定に再ロードする。

v 「なし」 - 操作ボタンは、ワークシートに対する計算または再構築の操作を実行しない。

メッセージ表示のためのプロセス・オプションの設定「プロセス・オプション」ダイアログ・ボックスを使用して、プロセス実行の前後に TM1 が表示する各種メッセージ・ボックスを制御します。

手順1. 「プロセス」タブで、「オプション」をクリックして「プロセス・オプション」ダイアログ・ボックスを開きます。

2. TM1 に表示する確認およびステータス・メッセージを選択します。

v 「成功メッセージを表示」 - プロセスの実行成功後にメッセージを表示する。

v 「失敗メッセージを表示」 - プロセスの実行失敗後にメッセージを表示する。

v 「確認ダイアログを表示」 - プロセスの実行前に確認メッセージを表示する。ユーザーは、「はい」または「いいえ」をクリックできます。

3. 選択したメッセージ用のテキストを入力または編集します。セルまたは既定の範囲を参照して、メッセージ・テキストを動的に取得することもできます。以下に例を挙げます。

v 現在のワークシートでセル A1 の内容からメッセージ・テキストを取得するには、メッセージ・テキスト・ボックスに「=A1」と入力します。


v Excel で既定の範囲を参照するには、書式 =NameOfRange を使用します。

既定の範囲は、メッセージのテキストを含む 1 つのセルのみポイントしている必要があります。

操作ボタンのサーバー名プロパティーの使用「操作ボタンのプロパティー」ダイアログ・ボックスには、操作ボタンに対応するIBM Cognos TM1 サーバーの名前を動的に取得するために、セルや既定の範囲の参照を入力するフィールドが含まれています。この機能を使用するには、「操作ボタンのプロパティー」ダイアログ・ボックスの「TM1 サーバー」セクションの「参照を使用」チェック・ボックスをクリックし、セルや既定の範囲の参照を入力します。

操作ボタンを設定して別のワークシートにナビゲートする操作ボタンを使用すると、同じブックの別のワークシート、または別のブックのワークシートにナビゲートできます。

次の手順は、操作ボタンを設定して別のワークシートに移動する方法の概要を示します。

手順1. 「操作ボタンのプロパティー」ダイアログ・ボックスで、「別のワークシートに移動」オプションをクリックします。

「ワークシート」タブが表示されます。

2. ターゲット・ワークシートを選択します。『ターゲット・ワークシートを選択する』を参照してください。

3. 「タイトル要素を照合」オプションを設定します。 150ページの『「タイトル要素を照合」オプションを有効にする』を参照してください。

4. 「現在のブックを置換」オプションを設定します。 151ページの『「現在のブックを置換」オプションの設定』を参照してください。

5. 操作ボタンによって別のワークシートにナビゲートする前に、TM1 が適用する計算オプションを選択します。 152ページの『操作ボタンを設定して、ワークシートを再計算または再構築する』を参照してください。

6. ナビゲーションが完了した後に TM1 が適用する計算オプションを選択します。151ページの『ワークシートへの移動後に計算オプションを設定する』を参照してください。

ターゲット・ワークシートを選択するワークシートを選択するには、リストから選択するか、直接名前を入力します。

手順1. 「TM1 アプリケーション」オプションをクリックしてから、「参照」をクリックします。

「ワークシートを選択」ダイアログが開きます。


注: ターゲット・ブックを選択するには、「ファイル」オプションをクリックしてから「参照」をクリックすることもできます。次に、「開く」ダイアログからワークシート・ファイルを選択し、「開く」をクリックします。ターゲット・ブ

ックを選択する別の方法は、「Excel 参照」をクリックすることです。

2. ワークシートを選択し、「OK」をクリックして、「操作ボタンのプロパティー」ダイアログに戻ります。

「ブック」ボックスに、アプリケーション・フォルダーのパスと選択したワークシートの名前が表示されます。

3. ブックへのアプリケーション・フォルダーのパスを手動で入力するには、「ブック」ボックスにパスを入力します。

v アプリケーション下の最初のフォルダー名から始めて、フォルダーの区切りにバックスラッシュ文字 (¥) を使用します。パスにアプリケーション・フォルダーは含めないでください。以下に例を挙げます。

PlanningSample\Bottom Up Input\Budget Input

v ナビゲート先のワークシートとセルの場所を指定するには、「シート」ボックスに次の形式でワークシート名と場所を入力します。

=SheetName!ColumnNameRowName

注: スペースを含むワークシート名を入力する場合、次の例に示すように、名前を一重引用符で囲む必要があります。

='My First Sheet'!$A$2

「タイトル要素を照合」オプションを有効にする「タイトル要素を照合」オプションは、ターゲット・ワークシートに移動する操作ボタンをユーザーがクリックしたときに、自動的にターゲット・ワークシート内のタイトル・ディメンションのテキストを照合し設定します。

「タイトル要素を照合」オプションが有効になっている場合、ソース・ワークシートとターゲット・ワークシート内のディメンションは、次のように TM1 のSUBNM 関数と DBRW 関数によって自動的に照合されます。

v TM1 では、セル内の SUBNM 書式に基づいて、ソース・ワークシートとターゲット・ワークシートのタイトル・ディメンションが自動的に照合されます。

例えば、ソース・ワークシートとターゲット・ワークシートの両方に同じディメンションが存在する場合、ソース・ワークシートで選択されている要素が、ターゲットの同じディメンションに設定されます。ソース・ワークシートで列を選択すると、ターゲット・ワークシートの同じタイトル・ディメンションを持つ列と照合されます。

v TM1 では、ソース・ワークシートで現在選択されている DBRW セルの行と列のディメンションが、ターゲット・ワークシートの一致するタイトル・ディメンション (存在する場合) と自動的に照合されます。

例えば、ソース・ワークシートの現在選択されている要素の行と列のディメンション要素が Operating Expense と Feb-2004 である場合、ナビゲートするとき


に、これらのディメンション要素がターゲット・ワークシートのタイトル・ディメンションと照合されます。行 Operating Expense と列 Feb-2004 の両方がソース・ワークシートで選択されている場合の DBRW セルは、行 Operating Expense

と列 Feb-2004 の両方に存在するセルです。この DBRW セルの行および列のディメンションが、その後ターゲット・ワークシートのタイトル・ディメンションと照合されます。

「現在のブックを置換」オプションの設定「現在のブックを置換」オプションは、ターゲット・ワークシートが新しいウィンドウまたは同じウィンドウで開かれているかを判断して、ソース・ワークシートを置換します。


v 「現在のブックを置換」が選択されておらず (デフォルト)、TM1 Web で作業している場合、ソース・ワークシートは開いたままで、ターゲット・ワークシートは新しいタブに開かれます。

v 「現在のブックを置換」が選択されていて、TM1 Web で作業している場合、ソース・ワークシートは同じタブでターゲット・ワークシートで置換され、新しいタブは開かれません。

重要: 「現在のブックを置換」オプションを有効にした場合、新しいボタンをテストする前に必ずワークブックを保存してください。ボタンをクリックして、現在のブックを閉じると、変更内容が失われる可能性があります。

ワークシートへの移動後に計算オプションを設定する移動の後にターゲット・ワークシートに適用するように計算オプションを設定します。

手順

「ワークシート」タブで、使用する「計算」オプションを選択します。




操作ボタンを設定して、プロセスを実行しワークシートにナビゲートするTurboIntegrator プロセスを実行してから別のワークシートにナビゲートする操作を設定するには、次の手順を実行します。

手順1. 「操作ボタンのプロパティー」ダイアログ・ボックスで、「プロセスを実行してからワークシートに移動」オプションをクリックします。

「プロセス」タブが表示されます。


2. 操作ボタンが実行するプロセスを選択します。 145ページの『操作ボタンを設定してプロセスを実行する』を参照してください。

3. 操作ボタンの移動先にするワークシートを選択します。 149ページの『操作ボタンを設定して別のワークシートにナビゲートする』を参照してください。

操作ボタンを設定して、ワークシートを再計算または再構築する操作ボタンを使用すると、TI プロセスを実行したり新規ワークシートにナビゲートしたりせずに、再計算または再構築のみを実行できます。これは、現在のシートを更新するか、アクティブ・フォームの元のバージョンを再ロードすることだけ行う場合に役に立ちます。

また、「計算」タブを使用して、TI プロセスを実行したり別のワークシートにナビゲートしたりする前に TM1 が実行する計算操作を選択することもできます。

手順1. 143ページの『操作ボタンのワークシートへの追加』の説明に従って、ワークシートに操作ボタンを挿入します。

2. 「操作ボタンのプロパティー」ダイアログ・ボックスで、「計算」タブをクリックします。

3. 「計算」タブで、使用する計算オプションを選択します。




4. 153ページの『操作ボタンのアピアランスのプロパティーの設定』の説明に従って、ボタンのアピアランスを設定します。

5. 「操作ボタンのプロパティー」ダイアログ・ボックスで、「OK」をクリックして、ダイアログを閉じてワークシートに操作ボタンを挿入します。

TM1 アクティブ・フォームでの操作ボタンの動作についてこのセクションでは、アクティブ・フォームで操作ボタンを使用した場合の動作と操作の順序についてまとめます。

操作ボタンの基本的な動作操作ボタンをクリックするたびに、次の手順が記載順に実行されます。

1. DBRW 書式が、ソース・ワークシートの現在選択されているセル用に取得される。

DBRW セル書式は、次の「再計算 (F9)」操作の前に取得します。その理由は、再計算のゼロ消去や MDX ベースの行サブセットによってアクティブ・フォームの行数が変更される可能性があるためです。


2. 「操作ボタンのプロパティー」ダイアログ・ボックスの「計算」タブで選択した計算オプションに応じて、再計算 (F9) または再構築の操作が現在のワークシートに実行される。

3. 高度なマッピング・オプションで参照される他のセルについて、更新された値が取得される。

操作ボタンの追加動作上記の基本的な手順が完了したら、操作ボタンが TI プロセスを実行しているか、別のワークシートにナビゲートしているか、またはこの両方かによって、次の追加手順が実行されます。

操作ボタンを使用して TI プロセスのみ実行している場合：

1. TI プロセスが実行される。

2. 操作ボタンの「プロセス・オプション」ダイアログ・ボックスで選択した計算操作が実行される。

操作ボタンを使用してナビゲートだけしている場合：

1. ナビゲーション操作が開始される。

2. ターゲット・ワークシートでターゲット値が設定される。

3. 「操作ボタンのプロパティー」ダイアログ・ボックスの「ワークシート」タブで選択した計算操作がターゲット・ワークシートに実行される。

操作ボタンを使用して TI プロセスを実行しワークシートにナビゲートしている場合：

1. TI プロセスが実行される。

2. 操作ボタンの「プロセス・オプション」ダイアログ・ボックスで選択した計算操作が実行される。

3. ナビゲーション操作が開始される。

4. ターゲット・ワークシートでターゲット値が設定される。

5. 「操作ボタンのプロパティー」ダイアログ・ボックスの「ワークシート」タブで選択した計算操作がターゲット・ワークシートに実行される。

操作ボタンのアピアランスのプロパティーの設定操作ボタンのキャプション、背景画像、その他の視覚的な機能を設定するには、「アピアランス」タブを使用します。

「アピアランス」タブをクリックして、ボタンのアピアランスのプロパティーを調整します。

「アピアランス」タブには、次のオプションがあります。

v 「キャプション」 - ボタンに表示されるキャプション・テキストを設定します。

v 「フォント」 - ボタン・テキストのフォントのタイプとサイズを変更できる、標準のフォント・ダイアログを表示します。

v 「背景画像を表示」 - ボタンに合うように拡張できる画像ファイル (bmp、gif、または jpg 形式) を選択できます。


v 「ハイパーリンクとして表示」 - 有効にすると、ボタンが標準のボタンでなく、青色の下線テキスト付きハイパーリンクとして表示されます。

v 「プレビュー」 - この領域にはボタンの例が表示されます。

v 「色」 - ボタンのテキストと背景色を設定できます。色のサンプルをクリックして、標準色の選択またはカスタム色の定義ができる「色」ダイアログを表示します。

ナビゲーションとマッピングの高度なオプションの使用ワークシート間を移動する操作ボタンの挿入時に、ソース・ワークシートとターゲット・ワークシート間のフィールドを手動でマッピングするには、「詳細オプション」ダイアログを使用します。このツールは、ソース・ワークシートからターゲット・ワークシートにディメンション、セル、および値をマッピングする際、役に立ちます。

注: 詳細マッピングは、自動マッピングが「タイトル要素を照合」オプションによって実行された後に適用されます。

「詳細オプション」ダイアログを開くには、「ワークシート」タブの「詳細オプション」をクリックします。

「詳細オプション」ダイアログには、ソース・ワークシートとターゲット・ワークシート間のフィールドのマッピングを定義するグリッドが含まれています。グリッドの行を管理するには、「追加」ボタンと「削除」ボタンを使用します。

ソースからターゲットへのマッピングの設定ソース・ワークシートからターゲット・ワークシートにマッピングするには、「詳細マッピング」グリッドの「ソース・タイプ」、「ソース・オブジェクト」、「ターゲット・タイプ」、および「ターゲット・オブジェクト」の各フィールドの値を設定します。

グリッドを使用すると、ターゲット・ワークシートが開いたときにソースおよびターゲットのワークシート内の要素を照合する方法を指定できます。グリッド内の各行は、1 つのマッピング設定を定義します。

次の手順を使用して、詳細マッピングを設定します。

手順参照

マッピングするオブジェクトの種類を指定する。

155ページの『ソース・タイプの設定』

使用するオブジェクト・タイプの値を決定する。

155ページの『ソース・オブジェクトの設定』

マッピングするセルのタイプを指定する。 155ページの『ターゲット・タイプの設定』

「ソース・オブジェクト」の値を挿入する場所を指定する。

156ページの『ターゲット・オブジェクトの設定』

さらにマッピング設定を作成するには、これらの手順を繰り返します。


ソース・タイプの設定「ソース・タイプ」フィールドは、マッピングする値のオブジェクトのタイプを表します。

「ソース・タイプ」で次のように選択します。

v 「SUBNM」 - ソース・ワークシート内のタイトル・ディメンションを含むセルからマッピングすることを示します。

v 選択した DBRW - ソース・ワークシート内の DBRW 書式を含むセルからマッピングすることを示します。

v 「値」 - ターゲットに送信される文字列または数値を入力することを示します。

ソース・オブジェクトの設定「ソース・オブジェクト」フィールドには、「ソース・タイプ」フィールドで選択されている項目に応じて、値または値として評価される Excel 式を指定します。

「ソース・オブジェクト」に次のように入力します。

v 「ソース・タイプ」が「SUBNM」に設定されている場合、ソース・ワークシート内に存在するタイトル・ディメンションの名前を指定する必要があります。

v 「ソース・タイプ」が「選択した DBRW」に設定されている場合、ソース・ワークシート内に存在する行または列のタイトル・ディメンションの名前を指定する必要があります。

v 「ソース・タイプ」が「値」に設定されている場合、ターゲット・ワークシートに送信される文字列または数値を入力する必要があります。

注: 「=」記号を使用してこれらの値をソース・ワークシートから取得して、Excel

参照を作成することもできます。

ターゲット・タイプの設定「ターゲット・タイプ」は、「ソース・オブジェクト」フィールドの値が挿入されるターゲット・ワークシート内のセルのタイプです。

「ターゲット・タイプ」で次のように選択します。

v SUBNM - ターゲットがターゲット・ワークシート内のタイトル・ディメンションであることを示す。

v 既定の範囲 - ターゲットがターゲット・ワークシート内の既定の範囲であることを示す。

v 範囲 - ターゲットの場所がターゲット・ワークシート内のセルであることを示す。

注: 「ターゲット・タイプ」を「既定の範囲」または「範囲」に設定した場合、移動するのに操作ボタンを使用するとターゲット・セル内に既に存在するデータまたは式は上書きされます。ターゲット・セルに DBRW 関数が含まれる場合、関数が失われると同時に、IBM Cognos TM1 サーバーとの間での接続、読み取り、書き込みを実行できなくなります。


ターゲット・オブジェクトの設定「ターゲット・オブジェクト」は、「ソース・オブジェクト」の値が挿入されるターゲット・ワークシート内の場所です。この場所は、「ターゲット・タイプ」で選択した項目に応じて、ターゲット・ワークシート内のタイトル・ディメンションの名前、特定のセルの場所、既定の範囲となります。

「ターゲット・オブジェクト」に次のように入力します。

v 「ターゲット・タイプ」が「SUBNM」に設定されている場合、ターゲット・ワークシート内のタイトル・ディメンションの名前を指定します。「ターゲット・タイプ」が「SUBNM」に設定されている場合、「サブセット」フィールドと「別名」フィールドの値も入力する必要があります。

v 「ターゲット・タイプ」が「既定の範囲」に設定されている場合、ターゲット・ワークシート内の範囲の名前を指定します。

v 「ターゲット・タイプ」が「範囲」に設定されている場合、ターゲット・ワークシート内のセルの場所を指定します。

「ターゲット・オブジェクト」に値を入力するには、直接場所の値を入力するか、Excel 参照を使用して場所を取得します。

v 直接値を入力する

ターゲット・ワークシート内の場所を指定するには、= 記号なしで直接値を「ターゲット・オブジェクト」フィールドに入力します。例えば、「ターゲット・オブジェクト」の場所としてターゲット・ワークシートのセル C3 を指定するには、「C3」と入力します。

v Excel セルを参照する

「ターゲット・オブジェクト」の場所を含むソース・ワークシート内のセルを参照するには、= 記号を指定します。例えば、ソース・ワークシート内のセル A1

に C3 という値を指定して、ターゲット・ワークシート内の「ターゲット・オブジェクト」のセルの場所を表すことができます。

さらにマッピング設定を作成するには、上記のすべての手順を繰り返します。

ソース値をターゲット・セルにマッピングする例この例は、ハードコーディングされた値をターゲット・ワークシート内の 1 つのセルにマッピングする方法を示します。


ソース・ワークシートターゲット・ワークシート

ナビゲーション

ソース SUBNM をターゲット・セルにマッピングする例ソース・ワークシートに「SUBNM」タイトル・ディメンションを指定すると、ターゲット・ワークシート内の対応する SUBNM、既定の範囲、または範囲 (セル) にマッピングできます。

例えば、次の図では、“S Series 2.0 L Wagon”タイトル要素をターゲット・ワークシート内のセル B2 に書式設定済みのキャプションとして挿入しています。

ソース・ワクシト・タゲッ・ナワ・ビョ・スンビゲッ・ナワ・ビ

選択した DBRW をターゲット・ワークシートにマッピングする例この例では、選択した DBRW セルの行と列のタイトル・ディメンションがターゲット・ワークシートに表示されています。


ソース・ワクシートターワゲーックシートターワナビスータョン

既存の操作ボタンの変更操作ボタンを挿入したら、次のセクションで説明するように、そのプロパティー、サイズ、および場所を編集できます。

既存の操作ボタンのキャプション、背景画像、およびプロパティーの編集

操作ボタンのプロパティーを編集するには、ボタンを右クリックし、メニューからオプションを選択します。

右クリック・メニューには、次の主要なオプションがあります。

v 「キャプション」 - ボタンのキャプションを編集する「ボタンのキャプション」ダイアログを開く。

v 「背景画像」 - ボタンの背景として使用する画像を参照し選択できる、ファイル選択ダイアログを開く。

v 「プロパティー」 - ユーザーがボタンをクリックしたときに、実行する操作を設定する「操作ボタンのプロパティー」ダイアログを開く。

既存の操作ボタンの移動とサイズ変更新しい操作ボタンをクリックするだけで、ボタンが有効になり、デザイン・モードではなくなります。ボタンをサイズ変更または移動する場合、次のように Excel でデザイン・モードをオンにする必要があります。

手順1. Excel で、「表示」 → 「ツールバー」 → 「コントロールツールボックス」をクリックします。


Excel の「コントロールツールボックス」が開きます。

2. 「デザイン・モード」をクリックします。

現在のワークシートの操作ボタンのテキスト・ラベルが消えます。

3. 移動またはサイズ変更する「操作」ボタンをクリックします。

ボタンにハンドルが表示され、サイズ変更と移動が可能なことを示します。

v ボタンのサイズを変更するには、いずれかのハンドルをクリックしドラッグします。

v ボタンを移動するには、ボタンをクリックし新しい場所までドラッグします。

4. 「デザインモード」をクリックして、デザインモードを終了します。

操作ボタンのハンドルが消え、ボタンがアクティブ・モードになります。


第 9 章データ予約の使用

このセクションでは、IBM Cognos TM1 で使用可能なデータ予約機能の有効化および実装に関連した、管理者、モデラー、開発者、およびプログラマーの作業のすべてを説明します。

注: デフォルトでは、データ予約は無効になっています。関連する TurboIntegrator

(TI) 関数および API 関数を使用してデータ予約を管理できるようにするには、管理者が事前にこの機能を有効にし、構成しておく必要があります。

データ予約の概要データ予約 (DR) は、TM1 のサーバー関連の機能です。これを使用すると、個々のユーザーに対してキューブの領域への排他的書き込みアクセス権を構成することができます。その領域のデータが予約されると、予約が解放されるまで特定のユーザーだけがそのデータを変更できるようになります。

DR を使用すると、データ予約を必要に応じて、または動的に取得および解放することによって、特定のビジネス・プロセスをサポートしたり、データ入力を制御したりすることができます。例えば、DR を使用すると、TM1 セキュリティーを動的に調整しようとする代わりに、キューブ・データへの書き込みアクセス権を動的に制御して、同様の書き込みアクセス制限を実施することができます。

注: DR はすべて、提供されている TurboIntegrator (TI) および API 関数を使用して開発したカスタム・アプリケーションによって管理する必要があります。必要なビジネス・プロセスに基づいて、DR を取得、解放、および管理するアプリケーションを設計します。

どんな時にデータ予約を使用するか

本来、データ予約は、ビジネス・プロセスに関連してユーザーによる TM1 データへの書き込みアクセス権を手動で、または動的に管理する場合に使用します。正確な必要に基づき、TurboIntegrator および API 関数を使用して必要に応じて、または動的に機能を適用することができます。

例えば、DR を使用して以下を行うこともできます。

v データ予約を使用する一度限りの TurboIntegrator プロセスを手動で実行して、特定のプロジェクトを完了した後、または最新の予算を成立させた後、ユーザーによって特定のデータが編集されないようにします。

v TM1 操作ボタンおよび TurboIntegrator プロセスを Microsoft Excel スプレッドシートまたは TM1 Web シートで使用してデータ予約を適用し、ユーザーがその役割や会社のビジネス・プロセスに基づいてデータと対話する際にデータへの書き込みアクセス権を制御します。

v カスタム外部アプリケーション内の TM1 API 関数を使用して、データ予約を動的に取得および解放します。


データ予約の使用方法

データ予約を使用するには、まず個々のキューブおよびユーザーグループの機能を有効にして構成し、その後 TurboIntegrator 関数または API 関数を使用して DR をプログラマチックに適用および管理する必要があります。

DR を有効にするには、以下の TM1 ツールを使用します。

v }CubeProperties コントロール・キューブ - 個々のキューブのデータ予約を有効にして構成します。詳細については、 168ページの『キューブでのデータ予約の有効化』を参照してください。

v 機能の割当 - ユーザー・グループのメンバーが自身や他のユーザーのデータ予約を管理 (取得および解放) できるかどうかを決定します。詳細については、 170

ページの『ユーザー・グループによるデータ予約の管理の有効化』を参照してください。

データ予約を適用および管理するには、予約をプログラマチックに取得、解放、および管理するための TurboIntegrator および TM1 API 関数を使用する必要があります。詳細については、以下のトピックを参照してください。

v 173ページの『TurboIntegrator 関数を使用したデータ予約の管理』

v 178ページの『TM1 API 関数を使用したデータ予約の管理』

データ予約が他の TM1 機能と対話する方法

データ予約が他の TM1 機能 (データ・スプレッド、TurboIntegrator プロセス、およびセキュリティなど) と対話する方法の詳細については、 164ページの『他の TM1

機能とのデータ予約の動作について』を参照してください。

セキュリティー・オーバーレイも DR を処理します。詳しくは、 185ページの『第10 章セキュリティー・オーバーレイ』を参照してください。

データ予約のモニタリング・ツール

サーバー・エクスプローラ、TM1Top ユーティリティー、TM1 監査ログ、および特定の TurboIntegrator 関数および API 関数を使用して、データ予約のアクティビティーや割り当てをモニターすることができます。詳細については、 171ページの『データ予約のモニター』を参照してください。

データ予約モードデータ予約モードでは、データの書き込み権をコントロールする方法に応じて、データ予約機能を構成できます。キューブでデータ予約機能を有効にする場合、使用可能なデータ予約モードを 1 つ選択します。

使用可能なデータ予約モードは以下のとおりです。

v オフ (OFF)

v 必須 (REQUIRED)

v 共有必須 (REQUIREDSHARED)

v 許可 (ALLOWED)


デフォルトでは、すべてのキューブでデータ予約は OFF に設定されています。

キューブごとにデータ予約モードをそれぞれ構成するには、}CubeProperties コントロール・キューブの DataReservationMode プロパティーにキーワードを入力します。詳細については、 168ページの『DataReservationMode プロパティー』を参照してください。

必須モード

REQUIRED モードは、キューブ全体に関してすべてのユーザーの書き込みアクセス権を無効にします。このモードでは、このキューブに書き込みを行う必要があるすべてのユーザーに対してデータ予約を明示的に割り当てる必要があります。

例えば、ユーザーがある特定のセルへの書き込みを行う場合、そのセルのデータ予約が必要です。

このモードに設定するには、特定のキューブの }CubeProperties に値 REQUIRED を入力します。

共有必須モード

REQUIREDSHARED モードは、REQUIRED モードのバリエーションで、別々のユーザーが重複してデータ予約を行えるようにするモードです。このモードのその他のすべての振る舞いは REQUIRED モードと同じです。

このモードに設定するには、特定のキューブの }CubeProperties に値REQUIREDSHARED を入力します。

REQUIREDSHARED モードは、IBM Cognos TM1 アプリケーションにおけるマルチノード編集機能を有効にする、重複要求に対応するために実装されました。このモードは、TM1 アプリケーションでキューブ・ビューまたは手動依存関係によって表されるすべてのキューブについて、デフォルトとして割り当てられている DR モードです。

REQUIRED モードでは、TM1 Server は、単一のユーザーが一度に 1 つのノードに対してのみ予約できるようにすることによって、スライスへの書き込みアクセス権を制限します。REQUIREDSHARED モードでは、アプリケーションは必要に応じてこの制約を適用する必要があります。

例えば、複数のユーザーが同一の集約ノードにアクセスできるようにするために、REQUIREDSHARED モードを使用できます。ただし、アプリケーションは、TM1

セキュリティー権限を関連する要素に割り当てることによって、集約のリーフ・ノードへのアクセスを制限する必要が生じる可能性があります。この例を以下の階層に示します。

表 2. データ予約に REQUIREDSHARED モードを使用した階層の例

集約: New England ユーザー A ユーザー B

リーフ・ノード:

MA WRITE アクセス

READ アクセス

CT WRITE アクセス

READ アクセス

第 9 章データ予約の使用 163

表 2. データ予約に REQUIREDSHARED モードを使用した階層の例 (続き)

集約: New England ユーザー A ユーザー B

VT WRITE アクセス

READ アクセス

NH READ アクセス

WRITE アクセス

RI READ アクセス

WRITE アクセス

ME READ アクセス

WRITE アクセス

アプリケーションは、ユーザー A についてリーフ・ノード MA、CT、および VT

への書き込みアクセス権を、ユーザー B についてリーフ・ノード NH、RI およびME への書き込みアクセス権を制限できます。この制限は要素レベルのセキュリティーを使用して適用されます。ユーザー A およびユーザー B は両方とも、New

England という名前の集約について共有データ予約を取得できます。この予約は、スライスへの両方のユーザーによる書き込みアクセスを許可しますが、基礎となるセキュリティーは、各ユーザーのリーフ・ノードのセットへのアクセスを制限します。

許可モード

ALLOWED モードでは、キューブ全体のすべてのユーザーの書き込みアクセス権をセキュリティーに基づいて保守しますが、必要に応じて個々のユーザーにデータ予約を割り当てることにより、キューブの領域への書き込みアクセス権を選択的に制限することができます。

例えば、ALLOWED モードでは、データ予約を使用して特定のユーザーに対してキューブのある特定のセクションを取り分けつつ、他のすべてのユーザーがキューブの残りの部分に書き込みを行えるようにすることができます。

このモードに設定するには、特定のキューブの }CubeProperties に値 ALLOWED を入力します。

他の TM1 機能とのデータ予約の動作についてこのセクションでは、データ予約 (DR) が他の TM1 機能 (セキュリティー、データ・スプレッド、TurboIntegrator (TI) プロセス、およびサンドボックスなど) と相互作用する方法を説明します。

データ予約とセキュリティーデータ予約は、以下の点で TM1 セキュリティーと異なります。

v DR は TM1 セキュリティー割り当てをオーバーライドせず、書き込み制限のレイヤーをキューブ・オブジェクトの標準セキュリティーの上部に 1 つ追加するだけです。

v DR が個々のユーザーに適用されるのに対し、TM1 セキュリティーはユーザーのグループに適用されます。


v DR はキューブ・データおよび個々のユーザーにのみ、制限を適用します。その他の TM1 オブジェクトは制御しません。

この動作は、REQUIRED と ALLOWED の両方のデータ予約モードに共通します。

データ予約と TM1 ユーザー・インターフェースデータ予約は、各種 TM1 ユーザー・インターフェース (サーバー・エクスプローラー、TM1 Perspectives および TM1 Web など) のキューブ・ビューのセルの外観に影響を与えます。

この動作は、データ予約モードによって異なります。

REQUIRED モード

REQUIRED モードでデータ予約を使用するようにキューブが構成されると、セルの背景がすべてグレイで表示され、DR 領域に含まれているセルを除き、書き込みを行えなくなります。現行ユーザーの DR 内のセルだけが書き込み可能になり、背景が白で表示されます。

ALLOWED モード

ALLOWED モードでデータ予約を使用するようにキューブが構成されると、他のユーザーのデータ予約に含まれているセルを除き、すべてのセルが書き込み可能になり (セキュリティーによって異なる)、背景が白で表示されます。他のユーザーによって予約されるセルは、背景がグレイで表示され、書き込み可能になりません。

セルが DR の一部になっているかどうかを確認する方法の詳細については、 171ページの『サーバー・エクスプローラーでのデータ予約のセルのステータスの表示』を参照してください。

データ予約とデータ・スプレッドデータ・スプレッドは、以前と同じように動作します。つまり、書き込み可能でないセル (算出セルや保留セル) は、配分プロセス中にスキップされます。ユーザーがデータ予約を持ち、データ・スプレッド操作を実行する際、そのユーザーの DR 領域にあるセルだけが書き込み可能と見なされ、その他のセルはすべてスキップされます。

この動作は、REQUIRED と ALLOWED の両方のデータ予約モードに共通します。

データ予約と TurboIntegrator プロセスおよび日課データ予約を使用しながら対話式 (非スケジュール) およびスケジュール済みTurboIntegrator (TI) 日課/プロセスも実行する場合には、以下の考慮事項を理解しておく必要があります。

この動作のいくつかは、どちらのデータ予約モードが使用されるか、また日課の実行が対話式か、スケジュール済みかによって異なります。


対話式のプロセスおよび日課

ユーザーがプロセスまたは処理を対話式に (例えば TM1 ユーザー・インターフェースから) 実行する場合、そのプロセス/日課はそのユーザーとして実行されます。

v REQUIRED モードの場合、これはプロセス/日課がそのユーザーによって保持される DR で定義されているデータにのみ書き込みを行えることを意味します。

v ALLOWED モードの場合、プロセス/日課は、そのユーザーの DR に含まれているセルまたはそのユーザーについての適切なセキュリティ権限を持つセルには書き込みを行えますが、別のユーザーの DR に含まれているセルには書き込みを行えません。

以下の動作は、REQUIRED および ALLOWED の両方のデータ予約モードで同じです。

v 対話式のプロセス/日課の書き込み操作が別のユーザーのデータ予約と競合する場合、プロセス/日課は失敗し、ユーザーに対してエラー・メッセージが表示されます。

v DR を取得および解放するプロセスを実行するために、プロセスを実行しているユーザーは、ManageDataReservation 機能が GRANT に設定されているユーザー・グループに属している必要があります。

スケジュールされた日課

スケジュールされた日課が自動的に実行されると、それは管理ユーザーとして実行されます。そのため、セルが別のユーザーのデータ予約にある場合、日課はそれらのセルに書き込みを行えない場合があります。

スケジュールされた日課でデータ予約の競合が発生したときの動作は、キューブで使用されているデータ予約モードによって異なります。

v REQUIRED モードの場合、スケジュールされた日課の書き込み操作がデータ予約と競合すると、日課は失敗します。

REQUIRED モードで DR を使用するときに、スケジュールされた日課が予約済みセルに書き込みを行えるようにするには、管理ユーザーが予約済みセルに書き込みを行えるようにすることによって、TurboIntegrator プロセスでこれをプログラマチックに処理する必要があります。管理に必要な DR を取得および解放するよう TurboIntegrator プロセスを変更したり、プロセスで適用可能なキューブのDR 機能を一時的にオフ/オンにしたりすることもできます。

v ALLOWED モードの場合、スケジュールされた日課の書き込み操作がデータ予約と競合すると、日課はデータのロールバックを実行し、予約が解放されるのを待ちます。予約が解放されると、日課は操作を再試行します。

データ予約モードを REQUIRED または OFF に変更することによって待機中の日課をキャンセルすることはできません。日課は、以下のいずれかのイベントが発生するまで待ち続けます。

– 日課をブロックしているデータ予約を解放し、日課を続行できるようにする。

– TM1 Top ユーティリティーを使用して日課をキャンセルする。

– サーバーを終了して日課をキャンセルする。

– スケジュールされた日課を無効にする。


データ予約とサンドボックス特定のキューブのデータ予約の取得および解放に関する、またそれと同じキューブのサンドボックスへのデータ入力に関する以下の考慮事項を理解しておく必要があります。

DR は、キューブの基本バージョンおよびそのキューブから作成されるすべてのサンドボックスに適用されます。

以下のサンドボックスの動作は、REQUIRED データ予約モードにのみ当てはまります。

v キューブの DR 機能が有効な場合、基本データまたはそのキューブのサンドボックスに書き込みを行うための DR がそのキューブになければなりません。

例えば、ユーザーが Sales キューブへの DR を持つ場合、そのユーザーは、Sales

キューブから作成されるすべてのサンドボックス内の、その同一セル・セットに対してのみ書き込みを行えます。

v キューブの DR が解放されると、そのキューブのどのサンドボックスにも書き込みを行えなくなります。

v DR が解放された後、基本データに対してサンドボックスをコミットすることは可能ですが、予約が解放された、編集済みのセルの値はエラーによって除去され、変更は失われます。編集済みの値を基本データに対して正常にコミットするには、サンドボックスのコミットを試行する前に、そのキューブで必要な DR を再び取得する必要があります。

データ予約、サンドボックス、およびジョブ・キューサンドボックスおよびジョブ・キュー機能とデータ予約を同時に使用している場合、基本データにサンドボックス・データをコミットするときに、キューブによって使用されているデータ予約モードに応じて、以下の動作が適用されます。

v REQUIRED モードの場合、サンドボックス・データを基本データに正常に保存するために、キューに入れられた操作が完了するまで、必要なデータ予約をすべて保持する必要があります。ジョブ・キューでデータを保存する前に必要なデータ予約が解放されるか、データ予約の競合が発生する場合、競合しているセルの値は保存されません。

v ALLOWED モードの場合、ジョブ・キューのサンドボックスのコミットがデータ予約と競合する場合、ジョブ・キューはその操作に対してデータのロールバックを実行し、競合している予約が解放されるのを待ちます。ジョブ・キューにあるジョブはすべて、待機しているジョブが続行可能になるまでブロックされます。ジョブ・キューのブロックを解除する唯一の方法は、競合しているデータ予約を解放することです。

データ予約の有効化デフォルトでは、データ予約は無効になっています。関連する TurboIntegrator (TI)

関数および API 関数を使用してデータ予約を管理できるようにするには、管理者が事前にこの機能を有効にし、構成しておく必要があります。

データ予約を使用する前に、以下を行う必要があります。


v 個々のキューブの機能を有効にします (}CubeProperties コントロール・キューブで構成される)。

詳細については、『キューブでのデータ予約の有効化』を参照してください。

v ユーザー・グループが自身および他のユーザーの DR を管理、取得、および解放できるようにします (「機能の割当」ウィンドウで構成される)。

詳細については、 170ページの『ユーザー・グループによるデータ予約の管理の有効化』を参照してください。

キューブの DR を有効にした後、機能はそのキューブのすべてのユーザーに適用されますが、その管理を行えるのは「機能の割当」ウィンドウで権限が付与されているユーザー・グループのメンバーだけです。

キューブでのデータ予約の有効化特定のキューブでデータ予約を有効または無効にするには、}CubeProperties コントロール・キューブの DataReservationMode プロパティーを使用します。

}CubeProperties コントロール・キューブの詳細については、「TM1 操作」の『コントロール・キューブ』セクションを参照してください。

手順1. サーバー・エクスプローラーで、「表示」メニューをクリックし、「コントロール・オブジェクトを表示」をクリックして選択します。

サーバー・エクスプローラーで表示されるすべての TM1 コントロール・キューブは、必ず右の中括弧 } で始まります。例えば、}CubeProperties などです。

2. サーバー・エクスプローラーのツリー・ウィンドウで、「キューブ」ノードをクリックして展開し、}CubeProperties コントロール・キューブをダブルクリックします。

3. DataReservationMode 要素 (プロパティー) とキューブ名の交点にある使用可能なデータ予約モードのいずれかに値を入力し、そのキューブのデータ予約機能を有効にします。

DataReservationMode プロパティー個々のキューブのデータ予約機能を構成するため、DataReservationMode プロパティーは }CubeProperties コントロール・キューブで以下の値を使用します。

}CubeProperties コントロール・キューブにこれらの値を入力するには、英語のみが使用できます。これらのキーワードの値は翻訳されません。

各データ予約モードの違いの詳細については、 164ページの『他の TM1 機能とのデータ予約の動作について』を参照してください。


値説明

OFF 特定のキューブのデータ予約機能をオフにします。

デフォルト値は OFF です。

REQUIRED 特定のキューブのデータ予約機能を REQUIRED モードに設定します。

このモードは、キューブ全体に関してすべてのユーザーの書き込みアクセス権を無効にします。このモードでは、このキューブに書き込みを行う必要があるすべてのユーザーに対してデータ予約を明示的に割り当てる必要があります。

例えば、ユーザーがある特定のセルへの書き込みを行う場合、そのセルのデータ予約が必要です。

REQUIREDSHARED 特定のキューブのデータ予約機能を REQUIREDSHARED モードに設定します。

このモードは、REQUIRED モードのバリエーションで、別々のユーザーが重複してデータ予約を行えるようにするモードです。このモードのその他のすべての振る舞いはREQUIRED モードと同じです。

REQUIREDSHARED モードは、IBM Cognos TM1 アプリケーションにおけるマルチノード編集機能を有効にする、重複要求に対応するために実装されました。このモードは、TM1

アプリケーションでキューブ・ビューまたは手動依存関係によって表されるすべてのキューブについて、デフォルトとして割り当てられている DR モードです。

REQUIRED モードでは、TM1 Server は、単一のユーザーが一度に 1 つのノードに対してのみ予約できるようにすることによって、スライスへの書き込みアクセス権を制限します。REQUIREDSHARED モードでは、アプリケーションは必要に応じてこの制約を適用する必要があります。

ALLOWED 特定のキューブのデータ予約機能を ALLOWED モードに設定します。

このモードでは、キューブ全体のすべてのユーザーの書き込みアクセス権をセキュリティーに基づいて保守しますが、必要に応じて個々のユーザーにデータ予約を割り当てることにより、キューブの領域への書き込みアクセス権を選択的に制限することができます。

例えば、ALLOWED モードでは、データ予約を使用して特定のユーザーに対してキューブのある特定のセクションを取り分けつつ、他のすべてのユーザーがキューブの残りの部分に書き込みを行えるようにすることができます。


ユーザー・グループによるデータ予約の管理の有効化TM1 の「機能の割当」ウィンドウにある以下の機能を使用して、ユーザー・グループのメンバーが自身および他のユーザーのデータ予約を管理 (取得および解放) できるようにします。

これらの機能は、個々のユーザーではなく、ユーザー・グループ全体に対して構成されます。機能を適用するには、ユーザーはグループのメンバーでなければなりません。

注: 「機能の割当」ウィンドウへのアクセス権限があるのは、TM1 管理者だけです。

「機能の割当」の詳細については、「TM1 操作」を参照してください。

機能説明

ManageDataReservation グループのメンバーがデータ予約を取得および解放できるようにします。

この機能は、サーバー全体に対するものです。特定のキューブまたはユーザーに機能を適用することはできません。

標準の ADMIN、DataAdmin、および SecurityAdmin グループでは、この機能は常に GRANT に設定され、変更できません。

非管理者グループの値は、次のとおりです。

DENY - 非管理者グループすべてのデフォルト値。

GRANT - ユーザー・グループでこの機能を有効にします。

DataReservationOverride グループのメンバーが、他のユーザーによって保持されている予約を解放できるようにします。

標準の ADMIN、DataAdmin、および SecurityAdmin グループでは、この機能は常に GRANT に設定され、変更できません。

非管理者グループの値は、次のとおりです。

DENY - 非管理者グループすべてのデフォルト値。

GRANT - ユーザー・グループでこの機能を有効にします。

手順1. サーバー・エクスプローラーで、サーバーを右クリックし、「機能の割当」を選択します。

2. 「機能の割当」ウィンドウの、構成するユーザー・グループの交点にある「ManageDataReservation」および「DataReservationOverride」機能に対して値を入力します。


データ予約のモニター以下のツールを使用して、データ予約のアクティビティーとステータスをモニターすることができます。

v サーバー・エクスプローラー

v TM1 Top ユーティリティー

v TM1 監査ログ

v TurboIntegrator および API 関数

サーバー・エクスプローラーでのデータ予約のセルのステータスの表示

次のようにして、サーバー・エクスプローラーのキューブ・ビューで任意のセルのステータスを確認します。

手順

サーバー・エクスプローラーで、キューブ・ビューを開き、セルを右クリックし、「ステータスの編集」をクリックします。セルの値を編集できるかどうか、またはデータ予約あるいはその他のデータ・アクセス制限によりセルを編集できないことを示すメッセージ・ボックスが表示されます。

TM1 Top を使用した、データ予約を待機しているスレッドのモニター

TM1 Top ユーティリティーを使用して、データ予約の解放を待機しているスレッドをモニターすることができます。この状態にあるスレッドはすべて、TM1 Top で「State」フィールドのデータ予約解放 (DDR) 値によって示されます。

Wait:DRR

TM1 Top の待ち状態の詳細については、「TM1 操作」の『システムおよびパフォーマンスのモニター』の章のセクション『スレッド処理状態について』を参照してください。

監査ログを使用したデータ予約イベントのモニターTM1 サーバーの監査ログ記録を有効にすると、Cognos TM1 はデータ予約イベントを記録します。その後、TM1 監査ログを使用して、データ予約の割り当ての履歴をクエリーおよび表示することができます。

TM1 監査ログの使用の詳細については、「TM1 操作」の『システムおよびパフォーマンスのモニター』の章を参照してください。

データ予約に固有の 5 つの監査ログ・イベントを以下の表にリストします。


監査ログ・イベントイベントの説明

設定されるプロパティー:

CubeDataReservationEnable

キューブの CubeDataReservationEnable プロパティーの値が変更されたときに記録されます。

データ予約: 獲得済みデータ予約を取得するときに記録されます。

データ予約: 解放済みデータ予約を解放するときに記録されます。

データ予約: 獲得のロールバック予約の取得のロールバックが発生したときに記録されます。

データ予約: 解放のロールバック予約の解放のロールバックが発生したときに記録されます。

ロールバック・イベントに関する注v データ予約の取得のロールバック操作とは、予約を解放することです。

v データ予約の解放のロールバック操作とは、予約を再取得することです。

データ予約イベントのクエリーデータ予約イベントはすべて、TM1 キューブ・オブジェクトと関連付けられ、監査ログでキューブ・イベントとしてグループ化されます。「監査ログ」ウィンドウでこれらのイベントをクエリーするには、次のようにします。

手順1. サーバー・エクスプローラーで、「監査ログ」ウィンドウを開きます。

2. 「イベント・タイプ」セクションで、「オブジェクト」オプションを選択します。

3. 「オブジェクト・タイプ」フィールドを「キューブ」に設定します。

4. 「イベント」ドロップダウン・リストをいずれかのデータ予約イベント・タイプに設定します。

5. クエリーを実行します。

TurboIntegrator および API 関数を使用したデータ予約のモニター

カスタム・ソリューションとして、以下の TM1 TurboIntegrator および API 関数を使用して、キューブ・オブジェクトをプログラマチックに繰り返し、各キューブの関連するデータ予約に関する情報を取得することもできます。

v TurboIntegrator - 176ページの『CubeDataReservationGet』。

v TM1 API - 181ページの『TM1DataReservationGetAll』。


TurboIntegrator 関数を使用したデータ予約の管理以下の TurboIntegrator (TI) 関数を使用して、データ予約をプログラマチックに取得、解放、および管理することができます。

v CubeDataReservationAcquire

v CubeDataReservationRelease

v CubeDataReservationReleaseAll

v CubeDataReservationGet

v CubeDataReservationGetConflicts

データ予約は、特定のキューブ、ユーザー、および組 (要素の番号付きリスト) によって定義されます。

CubeDataReservationAcquireCubeDataReservationAcquire は、指定されたキューブ、ユーザー、および組のデータ予約を取得します。

これは、TurboIntegrator 関数で、TurboIntegrator プロセスにおいてのみ有効です。

構文

CubeDataReservationAcquire(Cube, User, bForce, Address, [AddressDelimiter])

引数説明

Cube キューブの名前。

User 新規予約の所有者の名前。

指定されるユーザー名は、既存のユーザーであることを確認するために検証されます。

bForce 要求された予約が既存の予約と競合する場合の動作を決定するブール値。

0 (false) に設定される場合、既存の予約と競合する場合に要求は却下されます。

1 (true) に設定され、TurboIntegrator プロセスを実行しているユーザーの DataReservationOverride 機能が有効になっている場合、競合している予約は解放され、要求された予約が認可されます。

Address 組を定義するエレメント名の、トークン化されたストリング・シーケンス。順序は、キューブの元のディメンション順序と一致する必要があります。

組に含まれるキューブのセルはすべて、予約される領域を構成します。各ディメンションから要素を 1 つ選択することも、区切り文字の間に空ストリングを使用してディメンション全体を選択することもできます。要素が階層のどの場所にあるかに応じて、要求によって単一のセル、スライス、またはキューブ全体が予約されます。


引数説明

AddressDelimiter Address パラメーターで要素名を区切るために使用されるオプションの文字ストリング。

デフォルト値は '|' です。

戻り値

ブール値 - 取得に成功した場合、true を戻します。

例CubeDataReservationAcquire(’DRTestCube’,’User1’,0,’ElemX|ElemY|ElemZ’);

以下の例では、bForce パラメーターを 1 に設定して、競合が存在する場合に DR

要求を強制し、AddressDelimiter パラメーターに対して別の区切り文字を使用しています。

CubeDataReservationAcquire(’DRTestCube’,’User2’,1,’ElemX*ElemY*ElemZ’,’*’);

CubeDataReservationReleaseCubeDataReservationRelease は、指定されたデータ予約を解放します。


指定されたユーザーが予約の所有者と同一人物でない場合は、指定されたユーザーの DataReservationOverride 機能が有効になっている場合のみ、解放に成功します。

構文CubeDataReservationRelease(Cube, User, Address,[AddressDelimiter])

引数説明


User 予約の所有者の名前。

指定されるユーザー名は、既存のユーザーであることを確認するために検証されます。





戻り値

ブール値 - 解放に成功した場合、true を戻します。

例CubeDataReservationRelease(’DRTestCube’,’User1’,’ElemX|ElemY|ElemZ’);

以下の例では、AddressDelimiter パラメーターに対して別の文字を使用しています。

CubeDataReservationRelease(’DRTestCube’,’User2’,’ElemX*ElemY*ElemZ’,’*’);

CubeDataReservationReleaseAllCubeDataReservationReleaseAll は、複数の既存のデータ予約を解放します。


ユーザー・フィルターと一致する指定アドレスに完全に含まれるすべての予約が解放されます。ブランクのユーザー・フィルターは、すべてのユーザーを意味します。

指定されたユーザー・フィルターが、TurboIntegrator プロセスを実行しているユーザーと同じでない場合は、DataReservationOverride 機能が有効になっている必要があります。

ブランクのユーザー・フィルターを使用したり、アドレス・フィールドをすべてワイルドカードにしたりすると、すべての予約が解放されます。

構文CubeDataReservationReleaseAll(Cube, UserFilter, Address, [AddressDelimiter])

引数説明


UserFilter 既存の予約と突き合わせるユーザー名フィルター。




戻り値

ブール値 - エラーがない場合、true を返します。


例CubeDataReservationReleaseAll(’DRTestCube’,’User1’,’ElemX|ElemY|ElemZ’);

以下の例では、すべてのユーザーの指定キューブのすべての予約を解放します。

CubeDataReservationReleaseAll(’DRTestCube’,’’,’||’);

CubeDataReservationGetCubeDataReservationGet は、すべてのユーザーまたは 1 ユーザーの既存の予約を特定のキューブで探します。


構文

CubeDataReservationGet(Index, Cube, User, [AddressDelimiter]) returns

Address;

引数説明

Index 指定されたキューブの予約を繰り返すために使用する、1 をベースとするループ・インデックス。

Cube 検索するキューブの名前。

User フィルターとして使用する予約所有者名。

ブランクのままにする場合、関数はすべての所有者の予約を返します。

名前を指定する場合、関数は指定された所有者だけを求めて結果をフィルターに掛けます。

AddressDelimiter 返される Address パラメーターで要素名を区切るために使用されるオプションの文字ストリング。


戻り値

Address - 予約の作成時間、予約所有者の名前、および予約の要素アドレス。まず作成時間、その後に区切り文字、ユーザー ID、区切り記号、そして要素 ID が続きます。要素 ID は、キューブのディメンションの順番 (元の順番) で並べられ、区切り文字によって区切られます。

指定されたインデックスにエントリーがない場合、空ストリングが返されます。

戻り値の形式は、次のとおりです。

[creation time][delimiter][owner

name][delimiter][element1][delimiter][element2][delimiter]...[elementN]



"20100622211601|Fred Bloggs|Element1|Element2|Element3"

注: 予約のリストを繰り返す間に予約が変更される可能性があります。そのため、予約の完全なリストを提供するためのインデックスの使用は保証されません。予約はリスト内のどこにでも追加され、どこからでも削除される可能性があるので、インデックスの値をループするときに予約がスキップされたり、繰り返されたりする可能性があります。

所有者フィルターが指定される場合、インデックスはフィルターに掛けられたリストのメンバーに対してのみ適用されます。予約のリストの所有者がUser1、User1、User2 となっており、要求が User2 の所有者を指定する場合、インデックス 1 はリストの 3 番目のメンバーを取得します。

例CubeDataReservationGet(1,’DRTestCube’,’User1’,’*’);

CubeDataReservationGet(1,’DRTestCube’,’’);

以下のサンプルは、Expense Input キューブのユーザー Fred Bloggs が所有するすべての予約を探し、“何か有益なこと”を行います。

vIndex = 1;vCube = ’Expense Input’;vUserFilter = ’Fred Bloggs’;vDelim = ’|’;vAddress = CubeDataReservationGet( vIndex, vCube, vUserFilter,vDelim);WHILE (vAddress @<> ’’);

vSep1 = SCAN( vDelim, vAddress);vDRUser = SUBST( vAddress, 1, vSep1 - 1);vDRAddress = SUBST( vAddress, vSep1 + 1, LONG(vDRAddress) - vSep1);

# do something meaningful with theuser and reservation address here

vIndex = vIndex + 1;vAddress = CubeDataReservationGet( vIndex, vCube, vUserFilter,vDelim);

END;

CubeDataReservationGetConflictsCubeDataReservationGetConflicts は、指定されたユーザー、アドレス、および組と競合する既存の予約を特定のキューブで探します。


構文CubeDataReservationGetConflicts(Index, Cube, User,Address, [AddressDelimiter])returns ConflictAddress;

引数説明

Index このクエリーを満たす競合を繰り返すために使用する、1 をベースとするループ・インデックス。

Cube 検索するキューブの名前。

User クエリーにより、このユーザーと競合する予約が検索されます。


引数説明




戻り値

ConflictAddress - 予約の作成時間、予約所有者の名前、および予約の要素アドレス。まず作成時間、その後に区切り文字、ユーザー ID、区切り記号、そして要素ID が続きます。要素 ID は、キューブのディメンションの順番 (元の順番) で並べられ、区切り文字によって区切られます。

指定されたインデックスにエントリーがない場合、空ストリングが返されます。

戻り値の形式は、次のとおりです。

[creation time][delimiter][owner name][delimiter][element1][delimiter][element2][delimiter]...[elementN]


"20100622211601|Fred Bloggs|Element1|Element2|Element3"

注: 競合する予約のリストを繰り返す間に予約が変更される可能性があります。そのため、予約の完全なリストを提供するためのインデックスの使用は保証されません。予約はリスト内のどこにでも追加され、どこからでも削除される可能性があるので、インデックスの値をループするときに予約がスキップされたり、繰り返されたりする可能性があります。

TM1 API 関数を使用したデータ予約の管理以下の TM1 C API 関数を使用して、データ予約をプログラマチックに取得、解放、および管理することができます。

v TM1DataReservationAcquire

v TM1DataReservationRelease

v TM1DataReservationReleaseAll

v TM1DataReservationGetAll

v TM1DataReservationGetConflicts

v TM1DataReservationValidate

TM1DataReservationAcquire特定の IBM Cognos TM1 キューブ、ユーザー、および組の DR を要求します。


別のユーザーが所有する予約が既に存在しており、そのユーザーの領域が要求された予約とオーバーラップしている場合、bForce フラグが使用されなければ予約要求は却下されます。 bForce フラグが true であり、API を実行しているユーザーがDataReservationOverride 機能を持っている場合、競合している予約はすべて解放され、新しい予約が認可されます。

構文

TM1DataReservationAcquire(TM1P hPool, TM1V hCube, TM1VhClient, TM1V bForce,

TM1V elementArray);

パラメーター説明

hPool すべての API コマンドによって使用される標準メモリー・プール。

hCube アクセスするキューブのハンドル。

hClient 予約に使用する所有者。

bForce 要求された予約が既存の予約と競合する場合の動作を決定するブール値。

0 (false) に設定される場合、既存の予約と競合する場合に要求は却下されます。

1 (true) に設定される場合、競合している予約はすべて関数によって置き換えられます。

elementArray 組を定義する要素ハンドルの配列。順序は、ディメンションの順序と一致する必要があります。

戻り値

要求が認可された場合はブール値の true、却下された場合は false。

発生する可能性のあるエラーv TM1ErrorCubeNumberOfKeysInvalid

v TM1ErrorObjectHandleInvalid

v TM1ErrorCubeKeyInvalid

v TM1ErrorObjectSecurityNoReserveRights

TM1DataReservationRelease特定の IBM Cognos TM1 キューブ、ユーザー、および組の既存の DR を解放します。

API を呼び出しているユーザーの DataReservationOverride 機能が有効になっていない場合、コマンドを正常に実行するには、hClient に使用される所有者が DR の保有者と一致していなければなりません。

指定されるアドレスは、完全に一致しなければなりません。


構文

TM1DataReservationRelease(TM1P hPool, TM1V hCube, TM1V hClient,TM1V

elementArray);




hClient 予約の所有者。

elementArray 組を定義する要素ハンドルの配列。順序は、ディメンションの順序と一致する必要があります。

戻り値

要求が成功した場合はブール値の true、失敗した場合は false。予約が見つからない場合、それは失敗を意味し、false が返されます。必要な権限がない場合、エラーとして処理されます。




v TM1ErrorObjectSecurityNoAdminRights


TM1DataReservationReleaseAll指定された IBM Cognos TM1 ユーザーの複数のデータ予約を解放します。

指定されたアドレスの組により、検索の開始点が指定されます。アドレスによって定義される領域内に完全に含まれる、指定ユーザーが所有するすべての予約が解放されます。アドレスがオーバーラップしているものの、完全には含まれていない予約は解放されません。

NULL クライアントを指定すると、すべてのユーザーの予約が削除されます。所有者が、コマンドを実行しているユーザーと同一人物でない場合、ユーザーにDataReservationOverride 機能が必要になります。別のユーザーまたはすべてのユーザーに対するこのコマンドの実行の試行は、オーバーライド機能を持たない場合、既存の予約を検索することなく却下されます。

管理者は、アドレスのすべての要素に NULL クライアントおよびワイルドカードを指定することにより、キューブのすべての予約を解放することができます。


構文

TM1DataReservationReleaseAll(TM1P hPool, TM1V hCube, TM1V hClient,TM1V

elementArray);




hClient 予約の所有者。

elementArray 解放操作の開始点を定義する要素ハンドルの配列。順序は、ディメンションの順序と一致する必要があります。

戻り値

エラーがなかった場合はブール値の true。





v TM1ErrorObjectSecurityNoAdminRights

TM1DataReservationGetAllIBM Cognos TM1 キューブで現在保持されているデータ予約を判別します。

クライアント・パラメーターはオプションです。これが指定されない場合 (パラメーターは TM1ObjectNull に設定される)、キューブのすべての DR が返されます。

クライアント・パラメーターが指定される場合、その特定のユーザーによって保持される DR だけが返されます。

構文

TM1DataReservationGetAll(TM1P hPool, TM1V hCube, TM1VhClient);




hClient クエリー対象のユーザーのオプション・ハンドル。


戻り値

DR データの配列。形式は次のとおりです。

v [1] キューブ名 (TM1ValTypeString)

v [2-n] DR 情報の配列 (TM1ValTypeArray)

– [1] 作成時間

– [2] ユーザー名 (TM1ValTypeString)

– [3-n] 組を定義する要素名の配列 (TM1ValTypeArray)

- [1-n] 要素名 (TM1ValTypeString)

発生する可能性のあるエラー

TM1ErrorObjectHandleInvalid

TM1DataReservationGetConflictsIBM Cognos TM1 キューブで現在保持されている予約のうち、指定されたクライアント (ユーザー) およびアドレスと競合するものを判別します。

却下の原因となった予約がまだ存在していると仮定し、このコマンドを使用して、予約の取得試行が失敗した理由を判別するのに必要な情報を収集することができます。

構文

TM1DataReservationGetConflicts(TM1P hPool, TM1V hCube, TM1V hClient, TM1V

elementArray)




hClient 現行の予約所有者と比較するクライアント (ユーザー)。

elementArray 比較対照の組を定義する要素ハンドルの配列。順序は、ディメンションの順序と一致する必要があります。

戻り値

以下の形式の DR データの配列を返します。

v [1] キューブ名 (TM1ValTypeString)

v [2-n] DR 情報の配列 (TM1ValTypeArray)

– [1] 作成時間

– [2] ユーザー名 (TM1ValTypeString)

– [3-n] 組を定義する要素名の配列 (TM1ValTypeArray)

- [1-n] 要素名 (TM1ValTypeString)


TM1DataReservationValidateIBM Cognos TM1 キューブのすべてのデータ予約を検証します。

クライアント (ユーザー) が所有する予約のうち、存在しなくなったものはすべて削除されます。

構文

TM1DataReservationValidate(TM1P hPool, TM1V hCube);




戻り値

ブール値の true。

発生する可能性のあるエラー

TM1ErrorObjectNotFound (無効なキューブ)

データ予約の API エラー・コード次の表は、データ予約に関して IBM Cognos TM1 C API 関数から返される可能性のあるエラー・コードを示しています。

エラー説明

TM1ErrorCubeNumberOfKeysInvalid 要素の数がキューブ・ディメンションの数と一致しません。

TM1ErrorObjectHandleInvalid キューブ、クライアント、または要素のハンドルが、既存のオブジェクトにマップしません。

TM1ErrorCubeKeyInvalid 指定された要素が、その位置にあるディメンションの要素と一致しません。指定された要素は UDC です。

TM1ErrorObjectSecurityNoReserveRights 予約を使用する機能が認可されていません。

TM1ErrorObjectSecurityNoAdminRights 所有者ではなく、オーバーライド機能が認可されていないのに、予約を解放しようとしています。


第 10 章セキュリティー・オーバーレイ

セキュリティー・オーバーレイは、キューブのディメンションの競合を発生させることもなければ、基礎となる TM1 セキュリティーを変更することもなく、ユーザーがキューブに書き込む機能を制限するメカニズムを提供します。セキュリティー・オーバーレイの効果は、管理者を除くすべてのユーザーがセル・データを更新できないようにすることです。セルのセキュリティーと同様に、セキュリティー・オーバーレイでは、制限をデータ・キューブのディメンションの一部にのみ定義できます。

セキュリティー・オーバーレイは管理ユーザーには適用されません。セキュリティー・オーバーレイ・キューブはセキュリティー・キューブと見なされるため、これを変更するには TurboIntegrator プロセスに GrantSecurityAccess が必要です。セキュリティー・オーバーレイの制限は管理ユーザーには適用されません。この機能は、管理者に適用される権限ステータス (LOCK および RESERVE) とは異なります。

セキュリティー・オーバーレイ・キューブは文字列接頭部を付けて作成され、この接頭部によってセキュリティー・オーバーレイ・キューブとして識別されます。これはセル・セキュリティー・キューブが識別されるのと同じ方法です。}SecurityOverlayGlobal_<Data Cube Name>

最初の N ディメンションは、データ・キューブからマッピングされたディメンションです。最後のディメンションは }SecurityOverlay ディメンションです。この最後のディメンションは、オーバーレイ・キューブに格納されるデータを定義します。要素は 1 つしか含まれません。OverlayData 要素は、オーバーレイを実装するために使用されるデータを格納します。OverlayData にはアクセス権限を制限する値が入ります。この要素は文字列要素です。TM1 はディメンションが 1 つしかないキューブをサポートしないため、}SecurityOverlay ディメンションが必要です。

SecurityOverlayCreateGlobalDefaultこの関数は、セキュリティー・オーバーレイ・キューブを作成または破棄する場合、およびデータ・キューブの特定の領域にオーバーレイを設定する場合に使用します。

オーバーレイ・キューブを示す名前でデータ・キューブを作成すると、サーバーを再始動した場合にそのデータ・キューブがオーバーレイになることに注意してください。キューブがロードされるときに一致するデータ・キューブが見つかると、ロードされるキューブはオーバーレイとして設定されます。

これは、TM1 TurboIntegrator 関数であり、TurboIntegrator プロセスにおいてのみ有効です。

構文SecurityOverlayCreateGlobalDefault (Cube,

DimensionMap)


引数説明


DimensionMap 各位置のディメンションをオーバーレイで使用するかどうかを指定する文字列。ディメンションの順序は元のキューブの順序です。含めるディメンションにはそれぞれ 1 を、除外するものには 0 を指定します。各値はコロンで区切ります。

ブール値戻り操作が成功した場合には TRUE。成功しない場合には大きなエラー。

追加情報この TurboIntegrator プロセスが成功するには、GrantSecurityAccess プロパティーを設定する必要があります。この関数はデフォルトのグローバル・セキュリティー・オーバーレイ・キューブを作成します。グローバル・オーバーレイはすべてのユーザーに適用されます。

例SecurityOverlayCreateGlobalDefault('DataCube',

'0:0:1:0');

SecurityOverlayDestroyGlobalDefaultこの関数は、セキュリティー・オーバーレイ・キューブを破棄する場合、およびデータ・キューブの特定の領域にオーバーレイを設定する場合に使用します。

オーバーレイ・キューブを示す名前でデータ・キューブを作成すると、サーバーを再始動した場合にそのデータ・キューブがオーバーレイになることに注意してください。キューブがロードされるときに一致するデータ・キューブが見つかると、ロードされるキューブはオーバーレイとして設定されます。


構文SecurityOverlayDestroyGlobalDefault (Cube)

引数説明




引数説明


例SecurityOverlayDestroyGlobalDefault('DataCube');

SecurityOverlayGlobalLockNodeこの関数は、ノードをロックすることによってそのアクセス権限を読み取り専用に制限する場合に使用します。これは、グローバル・オーバーレイを使用するため、すべてのユーザーに影響します。このコマンドを使用する前に、オーバーレイ・キューブを作成しておく必要があります。アドレスに指定する要素は、オーバーレイで使用されるディメンション専用でなければなりません。


構文SecurityOverlayGlobalLockNode(bLock, Cube, Address, [AddressDelimiter])

引数説明

bLock1 の場合はロックします。0 の場合はロック解除します。

Cubeキューブの名前。

Address組を定義するオーバーレイ要素名の、トークン化された文字列シーケンス。順序は、キューブの元のディメンション順序と一致する必要があります。

アドレス戻りAddress パラメーターで要素名を区切るために使用されるオプションの文字列。

デフォルト値は‘|’です。


第 10 章セキュリティー・オーバーレイ 187

引数説明


例SecurityOverlayGlobalLockNode(1,'Sales','MA');SecurityOverlayGlobalLockNode(0,'Products','MA | 2011');SecurityOverlayGlobalLockNode(0,'Products', 'MA : 2011', ':');

最初の例では、オーバーレイに使用されるのは 1 つのディメンションのみです。他の 2 つの例では、2 つのディメンションが使用されています。


第 11 章 TM1 Web API

IBM Cognos TM1 Web をスタンドアロン・アプリケーションとして使用することに加えて、独自のカスタム Web アプリケーション内で使用することもできます。Web プログラマーおよび TM1 アプリケーション開発者は、Cognos TM1 Web アプリケーション・プログラミング・インターフェース (API) を使用して、カスタムの Web ページ、アプリケーション、およびダッシュボードに TM1 Web オブジェクトを取り込むことができます。

Cognos TM1 Web API には、2 つの異なる API のセットが組み込まれています。これらの API でも、セッション・トークンまたは TM1 セッション ID を使用する共通のログオン方式が使用されます。

具体的な開発要件に応じて、以下の 2 つの異なる API の中から選択し、どちらを使用しても同じログオン方式を使用できます。

Cognos TM1 Web API セッション・ログオンCognos TM1 Web の各 API では、Cognos セッション・トークン (TM1

Web セッションを一意に識別して分離する) または TM1 セッション ID

(TM1 サーバーを一意に識別する) を使用する、共通のログオン方式が使用されます。どちらの API を使用しても、このログオン方式を使用できます。

詳細については、 190ページの『TM1 Web API セッション・ログオン』を参照してください。

Cognos TM1 Web URL APIURL API では、URL とパラメーターの特別なセットを使用することにより、Websheet オブジェクトおよび CubeViewer オブジェクトにアクセスできます。簡単な例は Web ブラウザーのアドレス・バーに直接入力できます。 URL API を使用してソリューションを作成するには、HTML に関する知識と、必要に応じて JavaScript に関する知識が必要です。

197ページの『TM1 Web URL API』を参照してください。

Cognos TM1 Web JavaScript ライブラリーJavaScript ライブラリーでは、HTML、JavaScript、および Dojo の組み合わせの Web ページ開発環境で、TM1 Web の Websheet オブジェクトおよびCubeViewer オブジェクトにプログラマチックにアクセスできます。JavaScript ライブラリーを使用するには、HTML、JavaScript、Dojo、およびHTML Document Object Model (DOM) に関する知識が必要です。

223ページの『TM1 Web JavaScript ライブラリー』を参照してください。


TM1 Web API セッション・ログオンセッション・トークン・ログオン方式を使用すると、Cognos TM1 Web セッションを一意的に識別できます。このログオン方式は、URL API に推奨の方式です。複数の TM1 Web セッションが含まれる可能性がある Cognos TM1 サーバー・セッションを一意に識別するには、TM1 セッション ID ログオンの方式を使用します。セッションおよびログオン・モジュールを使用すると、JavaScript ライブラリーでのセッション管理が容易になります。

セッション・トークン・ログオン

セッション・トークン・ログオンは、特定のユーザー、管理ホスト、TM1 Server の組み合わせのログオン・セッションを表す固有のセッション・トークンを返します。

重要: 各 TM1 Web セッションが HTTP セッションと関連付けられます。TM1

Web セッション・トークンは、そのトークンが作成された HTTP セッションでのみ使用できます。TM1 Web セッション・トークンを保存し、別のデバイスでブラウザーを開いて、そのセッション・トークンに対応する TM1 Web セッションにアクセスすることはできません。その理由は、 HTTP セッションが異なるためです。

JavaScript XMLHttpRequest API を使用して、HTTP ログオン要求を Cognos TM1

Web サーバーに送信できます。送信後、要求から JavaScript Object Notation (JSON)

形式のセッション・トークンが返されます。セッション・トークンを受け取った後、TM1 Web オブジェクトを開く際にそのセッション・トークンを使用できます。

HTTP セッションで非アクティブ・タイムアウトが発生すると、Cognos TM1 Web

セッションと関連トークンは有効ではなくなります。

TM1 セッション ID ログオン

ユーザーは、TM1SessionId で TM1 サーバー・セッションを指定してログオンすることもできます。TM1 Web セッションが使用する TM1 サーバー・セッションは変更されることはなく、作成時に生成または指定する必要があります。複数の TM1

Web セッションで同じ TM1 サーバー・セッションを使用できます。

セッションおよびログオン・モジュール

JavaScript ライブラリーでは、session および LoginDialog の API を使用して、セッションおよびログオンの各ダイアログ・ボックスを管理できます。

詳細については、 194ページの『session モジュールおよび LoginDialog モジュール』を参照してください。

セッション・トークン・ログオン

セッション・トークンによるログオンの全プロセスには、以下のステップが含まれます。

1. URL API を使用している場合は、tm1web_config.xml ファイルでLegacyUrlApiSessionDiscoveryEnabled 設定パラメーターを設定します。


注: JavaScript ライブラリーを使用している場合は、この設定パラメーターは不要です。

2. Cognos TM1 で使用している認証のタイプに基づき、ログオン要求のパラメーターのセットを組み立てます。

3. JavaScript XMLHttpRequest API か他の同様の方式を使用して、Cognos TM1 Web

サーバーにログオン要求を送ります。

4. JSON 応答を処理して、返されるセッション・トークンを入手します。

5. Websheet オブジェクトや CubeViewer オブジェクトを開く際に、そのセッション・トークンを使用します。

セッション・トークン・ログオンに関する設定パラメーター

セッション・トークン・ログオン方式を URL API と併用している場合は、tm1web_config.xml ファイル内の LegacyUrlApiSessionDiscoveryEnabled 設定パラメーターを False に設定しなければなりません。

このパラメーターを使用すると、指定された管理ホスト、TM1 Server、および (オプションで) ユーザー名に基づいて URL API セッションを再利用できます。

<add key="LegacyUrlApiSessionDiscoveryEnabled" value="False"/>

ログオン要求パラメーター

セッション・トークン方式を使用するには、Cognos TM1 で使用している認証のタイプ用のパラメーターのセットを要求内に組み込んで送信します。

TM1 標準の認証および統合ログオンの場合、以下のパラメーター・フォーマットを使用します。

v param0=TM1_Admin_host

v param1=TM1_server_name

v param2=username

v param3=password


param0=localhost&param1=SData&param2=admin&param3=apple

IBM Cognos Business Intelligence セキュリティーを使用して認証を行う場合は、以下のフォーマットを使用し、camPassport の値を組み込みます。

v param0=TM1_Admin_host

v param1=TM1_Server_name

v param2=camPassport

セッション・トークン・ログオンに関する JSON 応答

ログオン要求の結果は、JSON 形式の文字列で返されます。

ログオン要求が成功した場合、以下のフォーマットの応答が返されます。

第 11 章 TM1 Web API 191

{"reply":{"adminHost":adminHost,"sessionToken":sessionToken,"tm1Server":tm1Server,"username":username}}


{"reply":{"adminHost":"localhost","sessionToken":"06974cbd-ff2d-408b-8181-87bddd3f9048","tm1Server":"Planning Sample","username":"admin"}}

ログオン要求が失敗した場合、以下の応答が返されます。

{ "reply":null}

例

以下の例では、JavaScript XMLHttpRequest API を使用して、ログオン要求を TM1

Web サーバーに送り、割り当てられたセッション・トークンを取得します。

<script type="text/javascript">

function login() {var xhr = new XMLHttpRequest();xhr.open("POST", "http://localhost:9510/tm1web/api/TM1Service/login", true);xhr.setRequestHeader("Content-type", "application/x-www-form-urlencoded");xhr.onload = function() {

var response = JSON.parse(xhr.responseText).reply;

if(response != null) {var sessionToken = response.sessionToken;console.debug("Session token: " + sessionToken);

}else {

console.error("Login failed.");}

}

var params = "param0=localhost&param1=Planning+Sample&param2=admin&param3=apple";

xhr.send(params);};

</script>

LegacyUrlApiSessionDiscoveryEnabled 設定パラメーターLegacyUrlApiSessionDiscoveryEnabled 設定パラメーターを使用して、TM1 Web

URL API がログオン・セッションを処理する方法を制御します。このパラメーターを設定して、URL API が個別で固有なログオン・セッションを追跡するかどうかを指定します。

このパラメーターを使用すると、指定された管理ホスト、TM1 Server、および (オプションで) ユーザー名に基づいて URL API セッションを再利用できます。


セッション・トークン・ログオン方式を URL API と併用している場合は、tm1web_config.xml ファイル内の LegacyUrlApiSessionDiscoveryEnabled 設定パラメーターを False に設定しなければなりません。セッション・トークンでのログオンについて詳しくは、 190ページの『TM1 Web API セッション・ログオン』を参照してください。

形式

<add key="LegacyUrlApiSessionDiscoveryEnabled" value=True or False/>


<add key="LegacyUrlApiSessionDiscoveryEnabled" value="False"/>

値

デフォルト値は True です。

True TM1 Web は、指定された情報 (TM1 管理ホスト、TM1 Server、ユーザー名) に基づいて、新しいログオン要求と既存のログオン・セッションのマッチングを試行します。

TM1 管理ホスト、TM1 Server、ユーザー名の固有の組み合わせでシングル・ログオンを行う場合は、このパラメーターを必ず True に設定してください。

False TM1 Web URL API を使用して TM1 Web オブジェクトを開くたびにセッション・トークンを提供しなければならないということを指定します。提供しないと、ユーザーに対してプロンプトが出されます。

TM1 Web URL API で複数のログオン・セッションを使用する計画がある場合は、このパラメーターを False に設定してください。複数のログオン・セッションを URL API および TM1 Web や TM1 Application Web などの他の TM1 Web クライアントで使用する場合も、この設定を使用できます。この設定は、セッション・トークンを使用して、ユーザー・セッションをそれぞれ別個で固有な状態に保ちます。

TM1 セッション ID ログオン

ユーザーは、管理ホスト、TM1 サーバー名、および TM1SessionId で TM1 サーバー・セッションを指定してログオンできます。TM1SessionId は、TM1 サーバーでのユーザー・セッションに対応します。TM1 サーバーからデータを取得するには、有効なユーザー・セッションが必要です。すべての TM1 Web セッションには、TM1 サーバー・セッションが必要です。TM1 セッション ID によるログオンの全プロセスは、TM1SessionID パラメーターによって sessionToken パラメーターが置き換えられること以外は、セッション・トークンでログオンするプロセスと同様です。

TM1SessionId=valid TM1 session ID

このログオン方式では、新しい TM1 Web セッションを作成し、TM1SessionId に対応する TM1 サーバー・セッションを再利用します。TM1 サーバー・セッション


が複数の TM1 Web セッションで共有されている場合、その TM1 サーバー・セッションを無効にすると、それらの TM1 Web セッションも無効にされます。

例

以下の例では、このタイプのログオン認証をサポートするために、TM1SessionId パラメーターが URL に含まれています。

http://localhost:9510/tm1web/UrlApi.jsp#Action=Open&Type=WebSheet&Workbook=Applications/Planning Sample/Bottom Up Input/Budget Input&AdminHost=localhost&TM1Server=Planning Sample&TM1SessionId=<valid TM1 session ID>

session モジュールおよび LoginDialog モジュールsession および LoginDialog の API を使用すると、JavaScript ライブラリーでｃユーザー・セッションおよびログオン・ダイアログを容易に管理できます。

sessiontm1web/api/session/session を使用して、TM1 Web セッションに関連する情報を取得できます。TM1 Web セッションにログオン、ログアウトしたり、TM1 Web セッションの情報を取得したりできます。

メソッド

login(params)TM1 Web へのログオンを実行します。

パラメーター: params。以下のいずれかのオブジェクト形式を使用するログオン情報オブジェクト。

{adminHost: "localhost",tm1Server: "Planning Sample",username: "admin",password: "apple"

}

または

{adminHost: "localhost",tm1Server: "Planning Sample",camPassport: "8sdf83uijsjdfsd903sd"

}

または

{adminHost: "localhost",tm1Server: "Planning Sample",tm1SessionId: "D3■lJLw50uvh2jtbAc■IYyVA"

}

ログオン操作の完了時に解決される promise として dojo/promise/Promise

を返します。ログオンに失敗すると、promise は拒否されます。成功すると解決されます。ログオンに成功すると、promise に以下の形式のオブジェクトが渡されます。

{sessionToken: "7118fad5-bbeb-4b3e-8bea-4b4a45ca2735",tm1SessionId: "D3■lJLw50uvh2jtbAc■IYyVA",


adminHost: "localhost",tm1Server: "Planning Sample",username: "Admin"

}

getInfo(sessionToken)指定されたセッション・トークンに対応する TM1 Web セッションに関連する情報を取得します。

パラメーター: sessionToken。情報の取得元となる、TM1 Web セッションに対応するセッション・トークン。

操作の完了時に解決される promise として dojo/promise/Promise を返します。取得に失敗すると、promise は拒否されます。成功すると解決されます。取得に成功すると、promise に以下の形式のオブジェクトが渡されます。

{sessionToken: "7118fad5-bbeb-4b3e-8bea-4b4a45ca2735",tm1SessionId: "D3■lJLw50uvh2jtbAc■IYyVA",adminHost: "localhost",tm1Server: "Planning Sample",username: "Admin"

}

logout(sessionToken)ログアウトを実行し、指定されたセッション・トークンに対応する TM1

Web セッションを無効にします。

パラメーター: sessionToken。無効化する TM1 Web セッションに対応するセッション・トークン。

操作の完了時に解決される promise として dojo/promise/Promise を返します。取得に失敗すると、promise は拒否されます。成功すると解決されます。セッションが存在しない場合や、すでに無効化されている場合でも、アクションは正常に完了します。

詳しくは、dijit._WidgetBase に関する Dojo の資料 (https://dojotoolkit.org/reference-

guide/1.10/dijit/_WidgetBase.html) を参照してください。

例// loginrequire([

"tm1web/api/session/session"], function(session) {

session.login({adminHost: "localhost",

tm1Server: "Planning Sample",username: "admin",password: "apple"}).then(function(sessionInfo) {

// Create Workbook or CubeViewer using sessionInfo.sessionToken}, function() {

// Handle login failure appropriately});});

// getInforequire([



https://dojotoolkit.org/reference-guide/1.10/dijit/_WidgetBase.html

session.getInfo("sessionToken").then(function(sessionInfo) {// Continue using obtained sessionInfo

});});

// logoutrequire([


session.logout("sessionToken").then(function() {// Logout has successfully completed

});});

LoginDialogtm1web/api/session/LoginDialog を使用して、ログオン・ダイアログ・ボックスを表示または破棄できます。

例var dialog = new LoginDialog({

onLogin: function(sessionInfo) {console.log(sessionInfo);

},tm1Server: "Planning Sample",adminHost: "localhost"

});

dialog.show();

構造

LoginDialog モジュールには、その構造に複数のパラメーターを含めることができます。

onLoginタイプ: 関数

ログオンが成功した場合はコールバック。セッション情報を含むオブジェクトが、実行時にパラメーターとして関数に渡されます。

このオブジェクトの例を以下に示します。

{tm1SessionId : "JcFxniSEzsJZVlQQhYDLDQ",sessionToken : "baa4ff9a-ddfb-41d1-9c71-f0add92325fd",adminHost : "localhost",tm1Server : "Planning Sample",username : "Admin"}

このオブジェクトの形式は、tm1web/api/session/session の login メソッドからの応答と同じ形式です。

adminHostタイプ: String (オプション)

デフォルト値: localhost

TM1 サーバー・リストの取得元の管理ホスト。管理ホストのパラメーターが指定されていない場合、tm1web_config.xml ファイルの AdminHost パラメーター値が指定されていればそれが使用されます。


tm1Serverタイプ: String (オプション)

ログオン先の TM1 サーバー。

adminHostVisibleタイプ: Boolean (オプション)

デフォルト値: true

false の場合、ログオン・ダイアログに管理ホストのテキスト・ボックスが表示されません。

tm1ServersVisibleタイプ: Boolean (オプション)

デフォルト値: true

false の場合、ログオン・ダイアログに TM1 サーバーのリストが表示されません。

adminHost、tm1Server、adminHostVisible、および tm1ServersVisible の各プロパティーは、set メソッドと共に構成できます。


loginDialog.set("adminHost", "Planning Sample");

メソッド

show() ログオン・ダイアログ・ボックスを表示します。

destroy()ログオン・ダイアログ・ボックスを破棄します。

詳しくは、dijit._WidgetBase に関する Dojo の資料 (https://dojotoolkit.org/reference-

guide/1.10/dijit/_WidgetBase.html) を参照してください。

TM1 Web URL APICognos TM1 Web URL API を使用して、Cognos TM1 Web Websheet オブジェクトおよび CubeViewer オブジェクトを任意の HTML ベースのドキュメントまたはWeb ページ・ソリューションに組み込みます。

Cognos TM1 Web URL API の概要URL API は、Cognos TM1 Web Websheet オブジェクトおよび CubeViewer オブジェクトを独自のカスタム Web ページに表示する URL を作成するためのフレームワークを提供します。

URL API を使用して、Websheet オブジェクトおよび CubeViewer オブジェクトを、Web ページ、Web アプリケーション、およびダッシュボードなどの任意のHTML ベース・ソリューションに組み込むことができます。URL API では、URL

とパラメーターの特別なセットを使用することにより、Websheet オブジェクトおよび CubeViewer オブジェクトにアクセスできます。



開発ツール

URL API を使用してソリューションを作成するには、HTML に関する知識と、必要に応じて JavaScript に関する知識が必要です。

テスト目的の場合や簡単な例の場合は、Web ブラウザーのアドレス・バーで直接URL API を使用できます。URL API を使用してソリューションを作成するには、単純なテキスト・エディター、または HTML および JavaScript を処理する他の開発環境を使用できます。

URL API は、CubeViewer オブジェクトおよび Websheet オブジェクトをカスタムWeb ページに表示するための主要な方法として HTML インライン・フレーム(<iframe> タグ) を使用します。

機能

カスタム Web ページで以下の機能を提供する URL を組み立てることができます。

v Websheet および CubeViewer

– CubeViewer オブジェクトおよび Websheet オブジェクトのアクセスと表示

– タイトル・ディメンション要素の設定

– ツールバーをオンまたはオフにするなどの制御プロパティー

v CubeViewer

– グリッド・モード、グラフ・モード、またはグリッドとグラフのモードでの表示

– グラフ・タイプの変更

– 自動再計算の有効化/無効化

– キューブ・ビューのレイアウトの保存

– ビューの再計算

v Websheet

– アクティブ・フォームの再構築

Cognos TM1 Web URL API 入門基本 URL と特定の TM1 パラメーターを使用して URL を作成し、完成した URL

を TM1 Web サーバーに渡します。完成した URL によって Websheet オブジェクトまたは CubeViewer オブジェクトが開いて表示されます。 URL API を使用して、これらのオブジェクトに対してさまざまな操作を適用することもできます。

基本 URL とパラメーターはハッシュタグ記号 (#) で区切られ、次の形式で組み立てられます。

BaseUrl#Parameters

複数のパラメーターを同じ URL に組み込む場合は、それらをアンパーサンド記号(&) で区切ります。

BaseUrl#Parameter1=value&Parameter2=value&Parameter3=value


Web ブラウザーのアドレス・バーの例

次の URL を Web ブラウザーのアドレス・バーにコピー・アンド・ペーストして、単純な URL API の例を確認してください。

http://localhost:9510/tm1web/UrlApi.jsp#Action=Open&Type=CubeViewer&Cube=plan_BudgetPlan&View=Budget%20Input%20Detailed&AccessType=Public&AdminHost=localhost&TM1Server=Planning%20Sample&Username=admin&Password=apple

Web ページでの URL API の使用

URL API は HTML インライン・フレーム (<iframe> タグ) を使用して、CubeViewer オブジェクトおよび Websheet オブジェクトをカスタム Web ページに表示します。<iframe> タグは、URL API を使用して CubeViewer オブジェクトおよび Websheet オブジェクトを表示する主要な方法です。

TM1 Web オブジェクトが iframe に表示されたら、新しい URL で iframe の src

(ソース) プロパティーを更新することにより、そのオブジェクトに対する操作を適用できます。

詳細については、 201ページの『HTML <iframe> タグを使用して Cognos TM1

Web オブジェクトを表示する』を参照してください。

Cognos TM1 Web URL API の基本 URL要求のすべてを Cognos TM1 Web URL API で作成するための基盤として、基本URL を使用します。

次のサンプルで基本 URL の例を示します。

http://localhost:9510/tm1web/UrlApi.jsp

基本 URL と 1 つ以上のパラメーターを組み合わせて、完全な要求を作成します。

基本 URL の形式は、次のとおりです。

http://WebServerName:PortNumber/tm1web/UrlApi.jsp

WebServerName

Cognos TM1 Web サーバーをホスティングするコンピューターのドメイン名または IP アドレス。

例えば、現在 Cognos TM1 Web サーバーを実行しているコンピューターで直接作業している場合は、WebServerName パラメーターに localhost を使用できます。

http://localhost:9510/tm1web/UrlApi.jsp

TM1 Web サーバーがリモート・コンピューターで実行されている場合は、そのシステムの名前を次のように使用します。

http://MyWebServer:9510/tm1web/UrlApi.jsp

http://www.example.com:9510/tm1web


PortNumber

Web アプリケーション・サーバーのポート番号。

TM1 の標準インストール済み環境では、ポート番号 9510 が使用されます。

UrlApi.jspCognos TM1 Web URL API の機能は UrlApi.jsp ファイルを介して提供されます。

Cognos TM1 Web URL API パラメーターパラメーターは、開く Cognos TM1 Web オブジェクトとそれらのオブジェクトに対して適用する操作を定義します。基本 URL にパラメーターを追加することにより、完全な URL 文字列を作成します。

基本 URL とパラメーターはハッシュタグ記号 (#) で区切られ、次の形式で組み立てられます。

BaseUrl#Parameters


http://localhost:9510/tm1web/UrlApi.jsp#HideDimensionBar=true

複数のパラメーターを組み込む場合は、アンパーサンド記号 (&) で区切ります。

BaseUrl#Parameter1=value&Parameter2=value&Parameter3=value

注: パラメーターに大文字小文字の区別はありません。『Action』と『action』はどちらも同じように作用しますが、読みやすさのために大文字化をお勧めします。

最も一般的なパラメーターとしては、Workbook オブジェクトおよび CubeViewer

オブジェクトを開くために使用される Action と Type があります。例えば、次のURL はパラメーターを使用して CubeViewer オブジェクトを開く例を示しています。

http://localhost:9510/tm1web/UrlApi.jsp#Action=Open&Type=CubeViewer&Cube=plan_BudgetPlan&View=Budget%20Input%20Detailed&AccessType=Public&AdminHost=localhost&TM1Server=Planning%20Sample

Websheet オブジェクトまたは CubeViewer オブジェクトを Web ページで開いたら、パラメーターを使用して追加の操作をそのオブジェクトに適用できます。例えば、次の URL は、AutoRecalc パラメーターと HideDimensionBar パラメーターを使用しています。

http://localhost:9510/tm1web/UrlApi.jsp#AutoRecalc=true


パラメーターの処理について詳しくは、以下のトピックを参照してください。

v 205ページの『TM1 Web オブジェクトと一緒に Action パラメーターを使用する』.


v 206ページの『Open パラメーターを使用して TM1 Web オブジェクトを開く』.

v 206ページの『既存の TM1 Web オブジェクトへのパラメーターと操作の適用』.

URL API での URL エスケープ文字の使用スペースなどの特殊文字を含んだ URL を作成するときは、URL エスケープ文字を使用します。

URL エスケープ文字の一般的な例としては、以下の項目があります。

文字エスケープ文字

スペース %20

$ %24

% %25

& %26

= %3D

Cognos TM1 Web URL API の概念URL API の使用に関する基本概念には、HTML iframes でのオブジェクトの表示、ログオン資格情報の指定、オブジェクトのオープン、および操作の適用が含まれます。

HTML <iframe> タグを使用して Cognos TM1 Web オブジェクトを表示するURL API で CubeViewer オブジェクトおよび Websheet オブジェクトをカスタムWeb ページに表示するには、HTML インライン・フレーム (<iframe> タグ) を使用します。

<iframe> タグは、URL API を使用して CubeViewer オブジェクトおよび Websheet

オブジェクトをカスタム Web ページに表示する主要な方法です。

TM1 Web オブジェクトが iframe に表示されたら、新しい URL で iframe の src

(ソース) プロパティーを更新することにより、そのオブジェクトに対する操作を適用できます。

例

以下の例では、標準 HTML ボタンおよび JavaScript 関数を使用して Websheet をiframe にロードします。

<button onClick="loadWebsheet();">Load Websheet</button>

<iframe id="websheetId" style="width:100%; height:100%;"></iframe>


// The function to assemble the required URL and display the Websheetfunction loadWebsheet() {

// Get a reference to the iframewebSheet = document.getElementById("websheetId");

// Assemble the URL that specifies the Websheet you want to openbaseUrl = "http://localhost:9510/tm1web/UrlApi.jsp";var websheetURL = baseUrl + "#Action=Open&Type=WebSheet";websheetURL = websheetURL + "&Workbook=Applications/Planning Sample/";websheetURL = websheetURL + "Management Reporting/Actual v Budget";websheetURL = websheetURL + "&AdminHost=localhost&TM1Server=Planning Sample";

// Assign the URL to the iframe to display the WebsheetwebSheet.src = websheetURL;

};</script>

URL API による TM1 管理ホスト・パラメーターと TM1 Server パラメーターの指定AdminHost パラメーターと TM1Server パラメーターを使用することによって、Cognos TM1 管理ホストとサーバー名を URL 文字列内に設定できます。

AdminHost パラメーターと TM1Server パラメーターは、#Action=Open コマンドと共に URL に組み込むことも、セッション・トークンの使用で暗黙的に指定することもできます。

これらの値は URL のオプションですが、以下のいずれかによって TM1 に対して指定する必要があります。

v tm1web_config.xml ファイル

v セッション・トークン

v URL 文字列

v フォーム・ベースのログオンを使用して TM1 Web サーバーに送る

v TM1 Web からプロンプトが出されたときにユーザーが指定する

これらの値が見つからない場合、TM1 はミニポップアップ・ウィンドウでその情報をユーザーに要求します。

管理ホストとサーバー名は、以下の順序で決まります。

1. セッション・トークンが指定されている場合、まずそこから管理ホストと TM1

Server が判別されます。セッション・トークンは特定のセッションを指しているからです。

2. AdminHost パラメーターと TM1Server パラメーターが URL に設定されている場合は、これらの値が tm1web_config.xml ファイル内の値をオーバーライドします。

3. これらの値が URL 文字列にない場合、TM1 Web はそれらがtm1web_config.xml ファイルに設定されているかどうかを判別しようとします。

4. AdminHost パラメーターと TM1Server パラメーターが URL 文字列にもtm1web_config.xml ファイルにもない場合、システムはポップアップ・ウィンドウでその情報をユーザーに要求します。

例

これらのパラメーターの形式は、次のとおりです。

&AdminHost=AdminHostName&TM1Server=TM1ServerName


ここで：

AdminHostName

TM1 管理ホストが実行されているシステムの名前。

TM1ServerName

ログオンする TM1 Server の名前。

例えば、次のサンプル・コードは、ローカル・システムと TM1 Planning Sample データベースを使用します。

&AdminHost=localhost&TM1Server=Planning Sample

URL API を使用したユーザーのログオンとログアウトの管理URL API を使用して TM1 Web オブジェクトを表示するには、IBM Cognos TM1

サーバーにログオンする必要があります。

ユーザー・ログオン・プロセスは以下のさまざまな方法で管理できます。

セッション・トークン・ログオンセッション・トークン・ログオンは、複数の TM1 Web インスタンス、TM1 管理ホスト、および TM1 Servers の間で一意のユーザー・セッションを追跡します。

セッション・トークン・ログオンは推奨されているログオン方式です。ユーザーが複数の TM1 Web インスタンス、または複数の別個の TM1 サーバーに同時にログオンする場合は、このログオン方式を使用します。


TM1 セッション ID ログオンユーザーは、管理ホスト、TM1 サーバー名、および TM1SessionId で TM1

サーバー・セッションを指定してログオンすることもできます。TM1SessionId は、TM1 サーバーでのユーザー・セッションに対応します。すべての TM1 Web セッションには、TM1 サーバー・セッションが必要です。TM1 Web セッションが使用する TM1 サーバー・セッションは変更されることはなく、作成時に生成または指定する必要があります。複数のTM1 Web セッションで同じ TM1 サーバー・セッションを使用できます。

このログオン方式では、新しい TM1 Web セッションを作成し、TM1SessionId に対応する TM1 サーバー・セッションを再利用します。TM1 サーバー・セッションが複数の TM1 Web セッションで共有されている場合、その TM1 サーバー・セッションを無効にすると、それらの TM1

Web セッションも無効にされます。

URL に TM1SessionId パラメーターを含めることで、このタイプのログオン認証をサポートできます。以下に例を挙げます。

http://localhost:9510/tm1web/UrlApi.jsp#Action=Open&Type=WebSheet&Workbook=Applications/Planning Sample/Bottom Up Input/Budget Input&AdminHost=localhost&TM1Server=Planning Sample&TM1SessionId=<valid TM1 session ID>

URL にユーザー資格情報を含めるTM1 Web オブジェクトにアクセスするときに、URL にログオン情報を指


定できます。URL には、AdminHost、TM1Server、UserName、またはPassword の値が含まれていなければなりません。

注意:URL 内にパスワードを指定することは、安全ではありません。

ポップアップ・ログオン・ウィンドウログオン情報のすべてまたは一部が他の方法で提供されない場合は、Cognos

TM1 Web オブジェクトが表示される前に、ユーザーにログオンを要求するポップアップ・ウィンドウが表示されます。

フォーム・ベースのログオン入力フィールドを含む標準 HTML フォームを使用してユーザーのログオン資格情報を収集し、情報を Cognos TM1 Web サーバーに送ることができます。詳細については、『Cognos TM1 Web URL API フォーム・ベースのログオン』を参照してください。

IBM Cognos Business Intelligence セキュリティー認証を使用する場合は、CamPassport パラメーターを指定できます。

Cognos TM1 Web URL API フォーム・ベースのログオン:

入力フィールドを含む標準 HTML フォームを使用してユーザーのログオン資格情報を収集し、情報を Cognos TM1 Web サーバーに送ることができます。

以下の名前を持つ <input> フィールドがフォームに含まれていることを確認してください。フィールド名とそれに関連した値は、フォームを送る時に Cognos TM1

Web サーバーに送信されます。

v AdminHost

v TM1Server

v Username

v Password

例

<form id="loginInfoForm" method="post">

Admin Host: <input type="text" value="localhost" name="AdminHost" /><br>TM1 Server: <input type="text" value="Planning Sample" name="TM1Server" /><br>User Name: <input type="text" value="admin" name="Username" /><br>Password: <input type="password" value="apple" name="Password" /><br><input type="button" value="Submit" onclick="loadCubeview();" />

</form>

<iframe id="cubeviewId" name="cubeviewIFrame" style="width:100%; height:100%;"></iframe>


// This function submits the login form and opens a CubeViewerfunction loadCubeview() {

// Get a reference to the login formvar loginForm = document.getElementById("loginInfoForm");

var baseUrl = "http://localhost:9510/tm1web/UrlApi.jsp";

var params = "#Action=Open&Type=CubeViewer&Cube=plan_BudgetPlan";params = params + "&View=Budget Input Detailed&AccessType=Public";

// Assign the URL to the action property of the login formloginForm.action = baseUrl + params;

// NOTE: Be sure to use the iframe name for the target of the login formloginForm.target = "cubeviewIFrame";

// Submit the form to login and display the TM1 Web objectloginForm.submit();

};</script>

Cognos TM1 Web URL API からのログアウト:

URL API を使用して現在のユーザー・セッションを終了するには、Action=Logout

パラメーターを使用します。

ログアウト操作は、TM1 Web オブジェクトが既に表示されている iframe に適用されます。ログアウト操作により、その特定の TM1 Web オブジェクトを開いていたセッションは終了し、その同じセッションの下の他のすべての URL API インスタンスのセッションも終了します。

Logout 操作の形式は、次のとおりです。

http://localhost:9510/tm1web/UrlApi.jsp#Action=Logout

例

以下の例では、iframe および関連した TM1 Web オブジェクトと関連付けられているセッションを終了します。

function logout() {

var baseUrl = "http://localhost:9510/tm1web/UrlApi.jsp";

var webSheet = document.getElementById("websheetId");webSheet.src = baseUrl + "#Action=Logout";

};

TM1 Web オブジェクトと一緒に Action パラメーターを使用するAction パラメーターは、TM1 Web オブジェクトに対して実行する操作のタイプを指定します。

最も一般的な操作タイプは、CubeViewer オブジェクトかまたは Websheet オブジェクトを開くことができる #Action=Open コマンドです。

Action パラメーターは、URL 文字列の中で次のように使用します。

#Action=TypeOfAction

TypeOfAction の値は、Open、Recalc、Close などの、サポートされるいずれかの操作にすることができます。

使用可能な操作タイプの完全なリストについては、 217ページの『URL API のAction パラメーター』を参照してください。


例

例えば、次の URL は TM1 Web CubeViewer オブジェクトを開きます。

http://localhost:9510/tm1web/UrlApi.jsp#Action=Open&Type=CubeViewer&Cube=plan_BudgetPlan&View=Budget Input Detailed&AccessType=Public

&AdminHost=localhost&TM1Server=Planning Sample

Open パラメーターを使用して TM1 Web オブジェクトを開くTM1 Web オブジェクトを開いて表示するには、Action=Open コマンドと Type パラメーターを使用します。

Open パラメーターは TM1 Web オブジェクトを開いて表示することを指定し、Type パラメーターはオブジェクトのタイプを指定します。

Action=Open&Type=object_type

object_type は、WebSheet または CubeViewer のいずれかにすることができます。オブジェクト・タイプによっては、開くオブジェクトを正確に指定するために追加のパラメーターが必要になります。Open コマンドを使用するときに、同じ URL にタイトル選択などの表示プロパティーを設定することもできます。

例えば、次の URL は Open パラメーターおよび Type パラメーターを使用してCubeViewer オブジェクトを開く例を示しています。


オブジェクトのオープンについて詳しくは、以下のトピックを参照してください。

v 207ページの『URL API による Websheet オブジェクトの表示』.

v 210ページの『URL API による CubeViewer オブジェクトの表示』.

Websheet オブジェクトまたは CubeViewer オブジェクトを Web ページで開いたら、パラメーターを使用して追加の操作をそのオブジェクトに適用できます。詳細については、『既存の TM1 Web オブジェクトへのパラメーターと操作の適用』を参照してください。

既存の TM1 Web オブジェクトへのパラメーターと操作の適用Cognos TM1 Web オブジェクトが Web ページに表示されたら、パラメーターを使用して、その特定のオブジェクトの URL を更新することにより、そのオブジェクトに追加の操作を適用できます。

既に表示されている Websheet オブジェクトまたは CubeViewer オブジェクトに追加の操作を適用するには、希望するパラメーターを指定して新しい URL を作成します。次に、新しい URL を、オブジェクトが表示されている iframe の src (ソース) プロパティーに適用します。

オブジェクトが既に iframe に表示されている場合、新しい URL を作成するには、action パラメーターのみを基本 URL に追加する必要があります。


例えば、次の URL は、AutoRecalc パラメーターと HideDimensionBar パラメーターを基本 URL に追加したものです。

http://localhost:9510/tm1web/UrlApi.jsp#AutoRecalc=true


注:

AutoRecalc パラメーターは CubeViewer にのみ適用できます。Websheet ではサポートされません。

Websheet では、UseBookRecalcSetting パラメーター、および Excel ブックの設定によって自動再計算が処理されます。詳しくは、Cognos TM1 Web 設定パラメーターを参照してください。

例

次の例は、既に CubeViewer オブジェクトが表示されている iframe の src プロパティーに、更新された URL を適用する JavaScript 関数を示しています。

<iframe id="cubeviewId"></iframe>

<script type="text/javascript">// This function updates an existing CubeViewer objectfunction toggleDimensionBar() {

// Get a reference to the existing iframe and CubeViewercubeView = document.getElementById("cubeviewId");

// Create an updated URL and apply it to the iframebaseUrl = "http://localhost:9510/tm1web/UrlApi.jsp";cubeView.src = baseUrl + "#HideDimensionBar=True";

};</script>

URL API による Websheet オブジェクトの表示Websheet とは、Cognos TM1 データが入っていて、Web ブラウザーで表示できるMicrosoft Excel スプレッドシート・ファイルのことです。 URL API を使用して、Websheet を HTML iframe に表示してから、追加の操作およびパラメーターをWebsheet に適用できます。

Websheet オブジェクトを開くURL API を使用して Websheet オブジェクトを開くには、TM1 アプリケーション・フォルダーに編成されている Websheet のロケーション・パスを使用します。

手順1. Cognos TM1 Web を開き、「アプリケーション」ノードを展開して、開く

Websheet を見つけます。

2. Websheet のパスを表すテキスト文字列を作成します。

パスの先頭には Applications/ を指定し、サブフォルダーはスラッシュ / 記号で区切ります。

例: Applications/My Reports/Report_2014.xls

3. URL 内の Workbook パラメーターを、組み立てたパスに設定します。


http://www.ibm.com/support/knowledgecenter/SS9RXT_10.2.2/com.ibm.swg.ba.cognos.tm1_inst.10.2.2.3.doc/c_tm1web_cfg_params_v10r2.html

#Action=Open&Type=WebSheet&Workbook=Applications/My Reports/Report_2014

4. パラメーターを基本 URL と結合して、完全な URL 要求を作成します。

例

次の URL を Web ブラウザーのアドレス・バーに直接コピー・アンド・ペーストして、この例を確認してください。

http://localhost:9510/tm1web/UrlApi.jsp#Action=Open&Type=WebSheet

&Workbook=Applications/Planning%20Sample/Management%20Reporting/Actual%20v

%20Budget&AdminHost=localhost&TM1Server=Planning%20Sample

以下の JavaScript 関数は iframe に Websheet をロードします。

function loadWebsheet() {

// Get a reference to an existing iframe that has this IDwebSheet = document.getElementById("websheetId");

// Assemble the URL and assign it to the iframewebSheet.src = baseUrl + "#Action=Open&Type=WebSheet&Workbook=Applications/Planning Sample/Management Reporting/Actual v Budget&AdminHost=localhost&TM1Server=Planning Sample";

};

Websheet オブジェクトの表示プロパティーの設定関連パラメーターを URL に組み込むことにより、Websheet オブジェクトの表示プロパティーを設定できます。

以下のパラメーターを使用して、Websheet オブジェクトの表示を変更できます。

HideToolbarツールバーをオンまたはオフにします。デフォルトはオンです。

例

Websheet オブジェクトの表示プロパティーを制御するには、URL 内で次の形式を使用します。

property=value

例えば、ツールバーの表示をオフにするには、URL に次の行を追加します。

HideToolbar=True

Websheet オブジェクトのディメンション・タイトル要素の選択SUBNM 関数が含まれている任意のセルに合わせて、Websheet オブジェクトのタイトル・ディメンション内の現行要素を設定できます。

ディメンションはシート番号、行番号、および列番号、またはディメンション名のいずれかで指定できます。

新しい要素は要素名または要素インデックスのいずれかで選択できます。


形式および値

シート、行、および列番号でディメンションを指定するには、以下の形式を使用します。

Title_S#-R#-C#=elementNameOrIndex

ディメンション名でディメンションを指定するには、以下の形式を使用します。

Title_dimensionName=elementNameOrIndex

以下のパラメーターを使用します。

Title_S#-R#-C#タイトル・ディメンションをシート番号、行番号、および列番号で指定します。

# 記号を、Websheet 内のディメンションの SUBNM セル位置を示すシート、行、および列の値に置き換えてください。

Title_dimensionNameタイトル・ディメンションをディメンション名で指定します。

elementNameOrIndex選択する新しいタイトル要素の名前または数値 (インデックスの場合) を表す文字列値。

新しいタイトル要素を要素名ではなく要素インデックスで選択する場合は、次のように UseIndex パラメーターを URL に組み込みます。

Title_S#-R#-C#=ElementIndexNumber&UseIndex=true

例

以下の例を使用して、まず Websheet を開き、次にタイトル要素を変更してください。

1. 次の URL を Web ブラウザーのアドレス・バーに直接コピー・アンド・ペーストして、まず Websheet を開きます。


&Workbook=Applications/Planning%20Sample/Management%20Reporting/Actual

%20v%20Budget&AdminHost=localhost&TM1Server=Planning%20Sample

2. タイトル要素を変更するには、同じ Web ブラウザー・セッションに次の URL

をコピー・アンド・ペーストします。

http://localhost:9510/tm1web/UrlApi.jsp#Title_S0-R11-C2=Canada

3. 基本 URL の末尾に Title_S#-R#-C# パラメーターのみコピー・アンド・ペーストしても同様の結果が得られます。

ヒント: パラメーターを使用して変更を適用する場合は、URL のパラメーター・セクションを更新するだけで済みます。基本 URL はそのままにしておくことができます。

Title_S0-R11-C2=US


4. 要素インデックスで新しいタイトルを選択するには、UseIndex パラメーターを指定した以下のサンプルを使用します。

Title_S0-R11-C2=3&UseIndex=true

URL API による CubeViewer オブジェクトの表示CubeViewer オブジェクトは、カスタム Web ページに TM1 キューブ・ビューを表示します。 URL API を使用して、CubeViewer オブジェクトを HTML iframe に表示してから、必要に応じて追加の操作およびパラメーターをオブジェクトに適用できます。

CubeViewer オブジェクトを開くCognos TM1 Web CubeViewer オブジェクトを特定して開くには、URL の中でAction=Open コマンドと Type、Cube、View、および AccessType パラメーターを組み合わせます。

CubeViewer オブジェクトを開くには、次の形式を使用します。

#Action=Open&Type=CubeViewer&Cube=CubeName&View=ViewName&AccessType=Status

ここで：

v CubeName は、ビューが属するキューブの名前です。

v ViewName は、キューブ・ビューの名前です。

v Status は、キューブ・ビューのステータス (共有または個人用) です。開きたい特定のキューブ・ビューを正しく指定するには、Public または Private のいずれかの値を含める必要があります。


http://localhost:9510/tm1web/UrlApi.jsp#Action=Open&Type=CubeViewer

&Cube=plan_BudgetPlan&View=Budget%20Input%20Detailed&AccessType=Public

&AdminHost=localhost&TM1Server=Planning%20Sample

CubeViewer を iframe にロードするには、次の JavaScript 関数を使用します。

function loadCubeview() {

// Get a reference to an existing iframe that has this IDcubeView = document.getElementById("cubeviewId");

// Assemble the URL and assign it to the iframecubeView.src = baseUrl + "#Action=Open&Type=CubeViewer&Cube=plan_BudgetPlan&View=Budget Input Detailed&AccessType=Public";

};

CubeViewer オブジェクトの表示プロパティーの設定任意の関連パラメーターを URL に組み込むことにより、CubeViewer オブジェクトの表示プロパティーを設定できます。

以下のパラメーターを使用して、CubeViewer オブジェクトの表示を変更できます。


AutoRecalc自動再計算をオンまたはオフにします。デフォルトはオフです。

注:

AutoRecalc パラメーターは CubeViewer にのみ適用できます。Websheet ではサポートされません。自動再計算モードは、ピボット、タイトル変更、ゼロ消去変更などのジェスチャーに適用されます。リーフ・セルに対するデータ変更には、自動再計算モードは適用されません。リーフ・セルは、変更されると必ず緑色になります。

CubeViewer では、AutoRecalc パラメーターは「自動再計算モード(Automatic Recalculation Mode)」ツールバー・ボタン (Websheet の場合はない) と同じ目的を果たします。自動再計算モードがオフの場合 (手動再計算モード)、ピボット、タイトル変更、ゼロ消去変更などのジェスチャーでは、データの再計算を更新する必要があります。

Websheet では、UseBookRecalcSetting パラメーター、および Excel ブックの設定によって自動再計算が処理されます。詳しくは、Cognos TM1 Web

設定パラメーターを参照してください。

HideDimensionBarタイトル・バーをオンまたはオフにします。デフォルトはオンです。

注: この設定は、CubeViewer オブジェクトのみに適用されます。

HideToolbarツールバーをオンまたはオフにします。デフォルトはオンです。

例

CubeViewer オブジェクトの表示プロパティーを制御するには、URL 内で次の形式を使用します。

property=value

例えば、CubeViewer オブジェクトの表示プロパティーを変更するには、URL に次の行を追加します。

AutoRecalc=False

HideDimensionBar=True

HideToolbar=True

CubeViewer オブジェクトのタイトル要素の選択CubeViewer オブジェクトのタイトル要素の設定は、URL にタイトル・パラメーターを追加してディメンションおよび要素名を指定することによって行えます。

次の書式とパラメーターを使用します。

Title_DimensionName=ElementNameOrIndex

パラメーター:

DimensionName

変更するタイトル・ディメンションの名前。




ElementNameOrIndex

選択する新しいタイトル要素の要素名または要素インデックス。

新しいタイトル要素を要素名ではなく要素インデックスで選択する場合は、次のように UseIndex パラメーターを URL に組み込みます。

&Title_DimensionName=ElementIndex&UseIndex=True

例

以下の例を使用して、まず CubeViewer を開き、次にタイトル要素を変更してください。

1. 次の URL を Web ブラウザーのアドレス・バーに直接コピー・アンド・ペーストして、まず CubeViewer を開きます。



&AdminHost=localhost&TM1Server=Planning%20Sample

2. タイトル要素を変更するには、同じ Web ブラウザー・セッションのアドレス・バーに次の URL をコピー・アンド・ペーストします。

http://localhost:9510/tm1web/UrlApi.jsp#Title_plan_version=FY 2003 Budget

3. 基本 URL の末尾にパラメーターのみコピー・アンド・ペーストしてタイトル要素を更新します。

Title_plan_business_unit=Canada

ヒント: パラメーターを使用して変更を適用する場合は、URL のパラメーター・セクションを更新するだけで済みます。基本 URL はそのままにしておくことができます。

4. UseIndex パラメーターを使用して、要素インデックスで新しいタイトルを選択してみてください。

Title_plan_business_unit=7&UseIndex=True

CubeViewer オブジェクトによるグラフの表示TM1 Web と同様に、CubeViewer オブジェクトは TM1 データをグリッドのみのモード、グラフのみのモード、またはグリッドとグラフの組み合わせのモードで表示できます。 DisplayMode パラメーターおよび ChartType パラメーターを使用して、グリッドとグラフの表示オプションを制御します。

グリッドおよびグラフの表示オプションの設定:

DisplayMode パラメーターを使用して、CubeViewer オブジェクトの表示をグリッドのみ、グラフのみ、またはグリッドとグラフの組み合わせに設定できます。

DisplayMode パラメーターの形式は、次のとおりです。

DisplayMode=value

使用可能なオプションには、以下の値があります。

v Grid


v Chart

v GridAndChart

例

DisplayMode=Chart

DisplayMode=Grid

DisplayMode=GridAndChart

URL API によるグラフ・タイプの設定:

ChartType パラメーターを使用して、CubeViewer オブジェクト用に表示するグラフ・タイプを設定します。

ChartType パラメーターの形式は、次のとおりです。

ChartType=ChartName

ここで、ChartName は、Column または Pie などの、使用可能なグラフ・タイプの文字列値にすることができます。使用可能なグラフ・タイプの完全なリストについては、 219ページの『URL API の ChartType パラメーター』を参照してください。

URL の例




&AdminHost=localhost&TM1Server=Planning%20Sample&DisplayMode=GridAndChart&ChartType=Pie

JavaScript の例

<body><select title="Chart Type" onchange="setChartType(this.value);>

<option></option><option value="Point">Point</option><option value="Bubble">Bubble</option><option value="Line">Line</option><option value="Spline">Spline</option><option value="StepLine">Step Line</option><option value="Bar">Bar</option><option value="StackedBar">Stacked Bar</option ><option value="Column">Column</option><option value="StackedColumn">Stacked Column</option><option value="Area">Area</option><option value="SplineArea">Spline Area</option ><option value="StackedArea">Stacked Area</option><option value="Pie">Pie</option><option value="Doughnut">Doughnut</option><option value="Range">Range</option ><option value="SplineRange">Spline Range</option>

</select>


Cognos TM1 Web 10.2.2 URL API での変更点

Cognos TM1 Web 10.2.2 URL API には以下の変更および更新が含まれます。

オブジェクト

v 10.2.2 URL API では、Cognos TM1 Web ナビゲーション・ツリー・オブジェクトはサポートされません。

v 10.2.2 URL API では、Web ページ内の既存オブジェクトに対する操作を追跡および適用する際に、ObjectId パラメーターを使用しません。代わりに、新しい URL API は現在のオブジェクトの状態を内部で維持し、クロスドメインの使用を改善します。オブジェクトが表示されている iframe

を使用して、TM1 Web オブジェクトで追加の操作を適用できるようになりました。

パラメーター

v パラメーターを基本 URL から区切るために、疑問符 (?) ではなく、ハッシュ・タグ記号 (#) が使用されるようになりました。

例: http://localhost:9510/tm1web/UrlApi.jsp#Parameters

v OpenObject パラメーターは Open に名前変更されました。

v パラメーター値の Yes と No が、True と False に置き換えられました。値 0 および 1 は引き続き有効です。

v 10.2.2 では、Action=Save パラメーターの動作が異なり、CubeViewer オブジェクトにのみ適用されます。この操作では、ビューのレイアウトのみが保存され、データの変更は保存されません。CubeViewer オブジェクトのデータを保存するには、Recalc 操作を使用します。

v HideTitlebar パラメーターは HideDimensionBar に名前変更されました。

v HideTabs パラメーターは使用されなくなりました。

v ChartType パラメーターは数値ではなく文字列値を使用するようになりました。

10.2.2 URL API への更新に必要なコード変更

新しい URL API にプロジェクトをアップグレードするには、以下のコード変更を確認して適用します。

基本 URL を変更するCognos TM1 Web 10.2.2 の新しい形式を使用するには、既存の基本 URL

を変更します。

v 置換前の URL: http://HostName/TM1Web/TM1WebMain.aspx

v 置換後の URL: http://HostName:9510/tm1web/UrlApi.jsp

UrlApi.jsp ファイルによって TM1WebMain.aspx ハンドラー・ファイルが置き換えられます。

URL パラメーターの更新Cognos TM1 Web 10.2.2 URL API での変更点のリストを確認します。

例えば、パラメーターを基本 URL から区切るためにハッシュ・タグ記号(#) が使用されるようになり、一部のパラメーターは名前変更されました。


ログオン・プロセスの更新10.2.2 URL は新しいセッション・トークン・ログオン方式を使用してログオン・セッションを一意的に識別します。新しいフォーム・ベースのログオンも使用可能です。

ObjectId パラメーターの置換コード中で、開いたオブジェクトを追跡するために ObjectId パラメーターを使用していた箇所を更新します。

代わりに、新しい URL API は現在のオブジェクトの状態を内部で維持し、クロスドメインの使用を改善します。この機能を使用して、オブジェクトを更新するたびに iframe の src プロパティーを更新することによって、TM1

Web オブジェクトに追加の操作を適用します。

Cognos TM1 Web URL API パラメーター・リファレンス開く IBM Cognos TM1 Web オブジェクトとそのオブジェクトに対して実行する操作を定義するには、パラメーターを使用します。基本 URL にパラメーターを追加することにより、完全な URL 文字列を作成します。

注: パラメーター・フォーマットは、&<parameter>=<value> です。例では、パラメーターは #<parameter> のように表示されます。例では、パラメーターを分離するのに & が使用され、パラメーターの先頭を示すのに # が使用されます。

URL API の AccessType パラメーターAccessType パラメーターは、表示するキューブ・ビューのステータス (共有または個人用) を指定します。

このパラメーターは、CubeViewer オブジェクトを開くときに Action パラメーターと組み合わせて使用します。

形式

&AccessType=Value

値

値説明

Private キューブ・ビューに個人用ステータスを指定します。

Public キューブ・ビューに共有ステータスを指定します。

例function loadCubeview() {

cubeView = document.getElementById("cubeviewId");

cubeView.src = baseUrl + "#Action=Open&Type=CubeViewer&Cube=plan_BudgetPlan&View=Budget Input Detailed&AccessType=Public&AdminHost=localhost&TM1Server=Planning Sample";

};


URL API の Action パラメーターAction パラメーターは、IBM Cognos TM1 Web オブジェクトに対して実行する操作のタイプを指定します。

形式

&Action=Type_Of_Action

値

値説明

Close 既存のオブジェクトを閉じます。

Logout 同じセッションの下にある他のすべての URL API インスタンスのセッションを終了します。

Open Cognos TM1 Web オブジェクトを開きます。

Rebuild Websheet に含まれる Cognos TM1 アクティブ・フォームのすべての値を再計算して、すべてのサブセットを再構築します。

この操作は、Cognos TM1 Web ツールバーの「再構築」ボタンをクリックした場合と同じ操作を実行します。

Recalc 既存の Websheet オブジェクトまたは CubeViewer オブジェクトを再計算します。

Reload CubeViewer オブジェクトのみを再ロードします。

Save キューブ・ビューのレイアウトを保存します。CubeViewer オブジェクトにのみ適用されます。

注: Save 操作では、ビュー内のデータの変更は保存されません。変更されたデータを保存するには、Recalc 操作を使用します。

URL の例

以下の URL の例は、Web ページに既に表示されている CubeViewer オブジェクトまたは Websheet オブジェクトに対して実行する操作の一部を示しています。

http://localhost:9510/tm1web/UrlApi.jsp#Action=Save

http://localhost:9510/tm1web/UrlApi.jsp#Action=Reset

http://localhost:9510/tm1web/UrlApi.jsp#Action=Close

JavaScript の例

以下の例は、それぞれ CubeViewer オブジェクトまたは Websheet オブジェクトに対して異なる操作を実行する一連の JavaScript 関数を示しています。


function loadWebsheet() {webSheet = document.getElementById("websheetId");

webSheet.src = baseUrl + "#Action=Open&Type=WebSheet&Workbook=Applications/Planning Sample/Management Reporting/Actual v Budget&AdminHost=localhost&TM1Server=Planning Sample";

};


値

値説明

0, false 自動再計算を無効にします。

1, true 自動再計算を有効にします。

例function toggleAutoRecalcMode(enabled) {

getActiveIFrame().src = baseUrl + "#AutoRecalc=" + enabled;};

URL API の ChartType パラメーターChartType パラメーターを使用して、表示するグラフのタイプを設定します。

形式

&ChartType=chart_type

値

値グラフのタイプ

Point 点グラフ

Bubble バブル・チャート

Line 折れ線グラフ

Spline スプライン・グラフ

Stepline ステップ・ライン・グラフ

Bar 横棒グラフ

Stackedbar 積み上げ横棒グラフ

Column 縦棒グラフ

Stackedcolumn 積み上げ縦棒グラフ

Area 面

Splinearea スプライン面グラフ

Stackedarea 積み上げ面グラフ

Pie 円グラフ

Doughnut ドーナツ・グラフ

Range 範囲グラフ

Splinerange スプライン範囲グラフ

例function setChartType(value) {

if(!value) {return;}

cubeView.src = baseUrl + "#ChartType=" + value;};


URL API の Cube パラメーターCube パラメーターを使用して、ビューが属するキューブの名前を指定します。

形式

&Cube=cube_name

値

Cube パラメーターの値は、開くビューが含まれているキューブの名前です。

例http://localhost:9510/tm1web/UrlApi.jsp#Action=Open&Type=CubeViewer&Cube=plan_BudgetPlan&View=Budget%20Input%20Detailed&AccessType=Public&AdminHost=localhost&TM1Server=Planning%20Sample&DisplayMode=GridAndChart&ChartType=Pie

URL API の DisplayMode パラメーターCubeViewer オブジェクトをグリッド・モード、グラフ・モード、またはグリッドとグラフのモードで表示するには、DisplayMode パラメーターを使用します。

形式

&DisplayMode=display_type

値

値説明

Chart グラフのみのモードで CubeViewer オブジェクトを表示します。

Grid グリッドのみのモードで CubeViewer オブジェクトを表示します。

GridAndChart グリッドとグラフの両方で CubeViewer オブジェクトを表示します。

例

以下の例は、既に表示されている CubeViewer オブジェクトに適用するための URL

を示しています。

http://localhost:9510/tm1web/UrlApi.jsp#DisplayMode=Chart

以下の例では、JavaScript 関数を使用して表示モードを変更します。

function setDisplayMode(value) {if(!value) {

return;}

cubeView.src = baseUrl + "#DisplayMode=" + value;};


URL API の HideDimensionBar パラメーターHideDimensionBar パラメーターを使用して、CubeViewer オブジェクトのディメンション・タイトル・バーの表示を制御します。この設定は、CubeViewer オブジェクトのみに適用されます。

形式

&HideDimensionBar=value

値

値説明

1, true ディメンション・バーを非表示にします。

0, false ディメンション・バーを表示します。

例#HideDimensionBar=true

URL API の HideToolbar パラメーターHideToolbar パラメーターを使用して、CubeViewer オブジェクトおよび Websheet

オブジェクトのツールバーの表示を制御します。

形式

&HideToolbar=value

値

値説明

1, false ツールバーを非表示にします。

0, true ツールバーを表示します。

例#HideToolbar=1

URL API の TM1Server パラメーターTM1Server パラメーターは、ログオンする IBM Cognos TM1 サーバーを指定します。

形式

&TM1Server=TM1_server_name

値

TM1Server パラメーターの値は、ログオンする Cognos TM1 Server の名前です。

例&TM1Server=Planning Sample


URL API の TM1SessionId パラメーターTM1SesionId パラメーターは、ログオンする IBM Cognos TM1 サーバーを指定します。

形式

&TM1SessionId=valid_TM1_session_ID

値

ユーザーは、管理ホスト、TM1 サーバー名、および TM1SessionId で TM1 サーバー・セッションを指定してログオンできます。TM1SessionId パラメーターは、TM1

サーバーでのユーザー・セッションに対応します。


例http://localhost:9510/tm1web/UrlApi.jsp#Action=Open&Type=WebSheet&Workbook=Applications/Planning Sample/Bottom Up Input/Budget Input&AdminHost=localhost&TM1Server=Planning Sample&TM1SessionId=<valid TM1 session ID>

URL API の Type パラメーターType パラメーターは、Action パラメーターと共に使用され、開くオブジェクトのタイプを指定します。

形式

&Type=object_type

値

値説明

CubeViewer オブジェクトを CubeViewer として定義します。

Websheet オブジェクトを Websheet として定義します。

例http://localhost:9510/tm1web/UrlApi.jsp#Action=Open&Type=CubeViewer&Cube=plan_BudgetPlan&View=Budget%20Input%20Detailed&AccessType=Public&AdminHost=localhost&TM1Server=Planning%20Sample

URL API の View パラメーターView パラメーターを使用して、開くキューブ・ビューの名前を指定します。

形式

&View=view_name

値

View パラメーターの値は、キューブ・ビューの名前です。


例View=Budget%20Input%20Detailed

以下の例に完全な URL を示します。


URL API の Workbook パラメーターWorkbook パラメーターは、ロードするブックの IBM Cognos TM1 Server ツリー内のパスを指定します。

形式

&Workbook=path_to_workbook

値

Workbook パラメーターの値は、TM1 Application フォルダーに編成されているCognos TM1 Websheet のパスです。

例

&Workbook=Applications/Planning Sample/Management Reporting/Actual v Budget

以下の例に完全な URL を示します。


&Workbook=Applications/Planning%20Sample/Management%20Reporting/Actual%20v%20Budget&AdminHost=localhost&TM1Server=Planning%20Sample

TM1 Web JavaScript ライブラリーCognos TM1 Web JavaScript ライブラリーを使用して、HTML、JavaScript、およびDojo の組み合わせの Web ページ開発環境で、TM1 Web の Websheet オブジェクトおよび CubeViewer オブジェクトにプログラマチックにアクセスできます。JavaScript ライブラリーを使用するには、JavaScript、Dojo Toolkit、および HTML

Document Object Model (DOM) に関する実際上の知識が必要です。

概要

Cognos TM1 Web JavaScript ライブラリーには、以下のメインクラスが含まれています。

Workbook クラスTM1 Web の Websheet を表します。

CubeViewer クラスTM1 Web CubeViewer を表します。

これらのメインクラスは、dijit._WidgetBase という Dojo Toolkit ウィジェット・クラスを継承します。この継承により、Workbook オブジェクトおよび CubeViewer


オブジェクトを Dojo タブ・コンテナーなどのコンテナーのような他の Dojo オブジェクトの子として割り当てることができます。

Dojo について詳しくは、http://dojotoolkit.org/documentation/ の Dojo の資料を参照してください。

Websheet オブジェクトおよび CubeViewer オブジェクトには、プログラマチックにアクセスできる関連するプロパティーとメソッドのセットもあります。これらのオブジェクトは非同期でロードされます。ロードが終わらないとコードはオブジェクトと相互作用できません。

注:

Cognos TM1 Web JavaScript ライブラリーの以下のオブジェクトは非推奨になっています。

v tm1web/cubeview/CubeViewer

v tm1web/websheet/Workbook

代わりに tm1web/api/CubeViewer および tm1web/api/Workbook を使用してください。 tm1web/cubeview および tm1web/websheet のパッケージ内のモジュールは、tm1web/api package 内のモジュールの別名になりました。

設定

Cognos TM1 Web JavaScript ライブラリーを使用するには、以下の設定が必要です。

1. Cognos TM1 Web をインストールし、Web ブラウザーを使用して標準ユーザー・インターフェースにログオンできることを確認します。

2. JavaScript ライブラリーを使用するカスタム Web ページ・ファイルの head セクションに、必須の参照を追加します。

詳細については、 225ページの『JavaScript ライブラリーを使用するための必須HTML <head> および <body> タグ』を参照してください。

JavaScript ライブラリーの導入

Cognos TM1 Web 環境の設定が済んだら、JavaScript ライブラリーを使用して、オブジェクトにアクセスするための Web ページのコーディングを開始できます。詳細と例については、以下のトピックを参照してください。

v 229ページの『JavaScript ライブラリーによる Websheet オブジェクトのロード』.

v 230ページの『JavaScript ライブラリーによる CubeViewer オブジェクトのロード』.

JavaScript Library 用の AMD ローダーの構成

IBM Planning Analytics Local 2.0.0 では、TM1 Web JavaScript ライブラリー・モジュールをロードするのに、TM1 Web で提供されるバージョンの Dojo を使用する必要はなくなりました。


http://dojotoolkit.org/documentation/

TM1 Web では、Dojo バージョン 1.7 以降の AMD ローダーを使用して、JavaScript ライブラリー・モジュールをロードできるようになりました。

詳細については、『JavaScript Library 用の AMD ローダーの構成』を参照してください。

JavaScript ライブラリーを使用するための必須 HTML <head>および <body> タグ

Cognos TM1 JavaScript ライブラリーを使用する各カスタム Web ページの HTML

<head> セクションと <body> セクションには、必須のタグと参照のセットが含まれていなければなりません。

JavaScript ライブラリーを使用するすべての HTML 文書に、以下の参照を追加します。

v HTML 5 DOCTYPE 宣言を組み込みます。

v meta 参照を <head> セクションに追加します。

v class 参照を <body> セクションに追加します。

v JS Library モジュールが正しく検出されるように AMD ローダーの構成を操作する追加のコードを追加します。

これらの参照は Cognos TM1 Web インストール・ディレクトリーの下にあるファイルを指します。

TM1_Installation_Location¥webapps¥tm1web¥...

例

次のタグと参照を、テンプレートとして使用します。

<!DOCTYPE html><html><head><meta charset="UTF-8"><meta http-equiv="X-UA-Compatible" content="IE=edge"></head><body class="claro tm1web"></body></html>

JavaScript Library 用の AMD ローダーの構成Dojo バージョン 1.7 以降の AMD ローダーを使用して、JavaScript ライブラリー・モジュールをロードできます。

AMD require 関数を使用して JavaScript ライブラリー・モジュールをインポートする前に、モジュールを検出してマップできるように AMD ローダーを構成する必要があります。以下の例では、サポートされているバージョンの Dojo 用の AMD

ローダーを構成する方法を示しています。

注: 以下の例で、location/to/tm1web/scripts/tm1web は TM1 Web URI を表しています。この場所は例えば、 http://localhost:9510/tm1web/scripts/tm1web などになります。


以下の例では、Dojo バージョン 1.8、1.9 および 1.10 の AMD ローダーを構成する方法を示しています。

require({packages: [

{name: "tm1web",location: "location/to/tm1web/scripts/tm1web"

},{

name: "tm1webCom",location: "location/to/tm1web/scripts/com"

},{

name: "tm1webDojo",location: "location/to/tm1web/scripts/dojo"

},{

name: "tm1webDijit",location: "location/to/tm1web/scripts/dijit"

},{

name: "tm1webDojox",location: "location/to/tm1web/scripts/dojox"

}],map: {

tm1web: {dojo: "tm1webDojo",dijit: "tm1webDijit",dojox: "tm1webDojox",com: "tm1webCom"

},tm1webCom: {

dojo: "tm1webDojo",dijit: "tm1webDijit",dojox: "tm1webDojox",com: "tm1webCom"

},tm1webRave: {


},tm1webDojo: {


},tm1webDijit: {


},tm1webDojox: {


}}

});

以下の例では、Dojo 1.7 の AMD ローダーを構成する方法を示しています。



{name: "tm1web",location: "location/to/tm1web/scripts/tm1web",packageMap: {


}},{

name: "tm1webCom",location: "location/to/tm1web/scripts/com",packageMap: {


}},{

name: "tm1webRave",location: "location/to/tm1web/scripts/com",packageMap: {


}},{

name: "tm1webDojo",location: "location/to/tm1web/scripts/dojo",packageMap: {

dojo: "tm1webDojo",dijit: "tm1webDijit",dojox: "tm1webDojox"

}},{

name: "tm1webDijit",location: "location/to/tm1web/scripts/dijit",packageMap: {


}},{

name: "tm1webDojox",location: "location/to/tm1web/scripts/dojox",packageMap: {


}}

]});

以下の例は、完全な構成の例です。

<!DOCTYPE html><html><head>


require(["tm1web/api/Workbook"

], function(Workbook) {// Create and work with Workbook object

});</script></head><body class="claro tm1web"></body></html>

JavaScript ライブラリーによる Websheet オブジェクトのロード

JavaScript を使用して Websheet オブジェクトをインスタンス化します。オブジェクトのロード後に、そのオブジェクトをドキュメントの本文の子として割り当てて、Web ページ内に表示できます。

Websheet オブジェクトをロードするには、以下の形式を使用して、オブジェクトを定義する必須のプロパティーとオプションの関数を指定します。

new Workbook({properties ..., functions ...});

properties には、ログオン資格情報と、開こうとしている Websheet オブジェクトを指定する値を組み込みます。

functions には、オブジェクトに関する onLoad イベントとonTitleDimensionElementChange イベントについて通知するオプション・コードを組み込むことができます。

詳細については、 236ページの『Cognos TM1 Web JavaScript ライブラリーのWorkbook クラス』を参照してください。

例

次の例は、Websheet オブジェクトをロードする JavaScript 関数を示しています。

オブジェクトをインスタンス化するコードでは、特定の AMD (Asynchronous

Module Definition) 構文と AMD require キーワードを使用する必要があります。オブジェクトが作成されると、関数はそのオブジェクトをドキュメントの本文の子として割り当てます。

// Load Websheet with parameters for adminHost, tm1Server, username and passwordfunction loadWebsheet() {


], function(Workbook){var loadedWebsheet = new Workbook({

adminHost: "localhost",tm1Server: "Planning Sample",username: "admin",password: "apple",path: "Applications/Planning Sample/Management Reporting/Actual v Budget",onLoad: function() {

console.debug("Workbook loaded successfully.");}

});

// Add websheet to the document bodydocument.body.appendChild(loadedWebsheet.domNode);


loadedWebsheet.startup();});

};

次の例では、ログオン用にセッション・トークンを使用して、Websheet オブジェクトをロードします。

// Load Websheet with a session tokenfunction loadWebsheet() {



sessionToken: "yourSessionToken",path: "Applications/Planning Sample/Management Reporting/Actual v Budget",onLoad: function() {


});// Add websheet to the document bodydocument.body.appendChild(loadedWebsheet.domNode);


};

JavaScript ライブラリーによる CubeViewer オブジェクトのロード

JavaScript を使用して CubeViewer オブジェクトをインスタンス化します。オブジェクトの作成後に、そのオブジェクトをドキュメントの本文の子として割り当てて、Web ページ内に表示できます。

CubeViewer オブジェクトをロードするには、以下の形式を使用して、オブジェクトを定義する必須のプロパティーとオプションの関数を指定します。

new CubeViewer({properties ..., functions ...});

properties には、ログオン資格情報と、開こうとしている CubeViewer オブジェクトを指定する値を組み込みます。

functions には、オブジェクトに関する onLoad イベントとonTitleDimensionElementChange イベントについて通知するオプション・コードを組み込むことができます。

詳細については、 246ページの『Cognos TM1 Web JavaScript ライブラリーのCubeViewer クラス』を参照してください。

例

次の例は、CubeViewer オブジェクトをロードする JavaScript 関数を示しています。

オブジェクトをインスタンス化するコードでは、特定の AMD 構文と Dojo

require キーワードを使用する必要があります。オブジェクトが作成されると、関数はそのオブジェクトをドキュメントの本文の子として割り当てます。


onTitleDimensionElementChange: function(elementInfo) {

// Add your code here to handle the title change event}

タイトル・ディメンションに対する変更が検出されると、elementInfo オブジェクトがコールバック関数に渡されます。elementInfo の内容は、Websheet オブジェクトと CubeViewer オブジェクトで違います。この情報を利用して、どのディメンション・タイトルが変更されたか調べます。

Websheet の elementInfo オブジェクトは以下のとおりです。

sheetIndexタイプ: Integer

変更された SUBNM セルが含まれるシートのゼロから始まる索引。

rowIndexタイプ: Integer

変更された SUBNM セルが含まれる行のゼロから始まる索引。

columnIndexタイプ: Integer

変更された SUBNM セルが含まれる列のゼロから始まる索引。

dimensionタイプ: String

ディメンションの名前。

elementタイプ: String

要素の名前。

elementIndexタイプ: Integer

ディメンション要素の 1 から始まる索引。

CubeViewer の elementInfo オブジェクトは以下のとおりです。




要素の名前。



Websheet コールバック関数の例

次の例は、Websheet オブジェクトをロードする関数内で定義されているコールバック関数を示しています。


v Websheet の再計算

CubeViewer オブジェクト

v 自動再計算モードのオン/オフ

v ディメンション・タイトル・バーのオン/オフ

v CubeViewer オブジェクトの元のビューへのリセット

v ビューの保存

v 表示モードとグラフのタイプの設定

Websheet オブジェクトと CubeViewer オブジェクト

v Websheet オブジェクトまたは CubeViewer オブジェクトを閉じる

v ログアウト

例<script type="text/javascript">

// Rebuild the active form in a Websheet// ----------------------function rebuildActiveForms() {

loadedWebsheet.rebuildActiveForms().then(function() {console.debug("Active form rebuild completed.");

},function(message) {

console.error(message);});

};

// Recalculate a Websheet// ----------------------function recalculate() {

loadedWebsheet.recalculate().then(function() {console.debug("Recalculate completed successfully.");



};

// Set the AutoRecalcMode for a CubeViewer object// ----------------------function toggleAutoRecalcMode(enabled) {

loadedCubeview.set("automaticRecalculation", enabled).then(function() {

var message = enabled ?"Enabling auto recalc completed successfully." :"Disabling auto recalc completed successfully.";

console.debug(message);},function(message) {


};

// Turn on/off the dimension title bar for a CubeViewer object// ----------------------


};

// Logout from the session associated with the specified TM1 Web object// ----------------------function logout() {

loadedCubeview.logout().then(function() {

console.debug("Session destroyed.");},function(message) {

console.error(message);}

);};

</script>

Cognos TM1 Web JavaScript ライブラリーの Workbook クラス

Workbook クラスは、Cognos TM1 Web Websheet オブジェクトを表します。

Workbook オブジェクトは Dojo ウィジェット・オブジェクト (dijit._WidgetBase)

を継承し、Dojo タブ・コンテナー (dijit.layout.TabContainer) などのコンテナーの子オブジェクトとして割り当てることができます。詳しくは、Dojo 資料(http://dojotoolkit.org/documentation/) を参照してください。

Workbook オブジェクトには、Dojo ウィジェット・オブジェクトの使用可能なプロパティーとメソッドに加えて、プログラマチックにアクセスできる TM1 関連のプロパティーとメソッドもあります。

Workbook オブジェクトは非同期でロードされます。ロードが終わらないとコードはオブジェクトと相互作用できません。

形式

Websheet オブジェクトをロードするには、以下の形式を使用して、オブジェクトを定義する必須のプロパティーとオプションの関数を指定します。

new Workbook({properties ..., functions ...});

プロパティー

properties には、Websheet オブジェクトを定義する以下の値が組み込まれます。

v adminHost

v tm1Server

v username

v password

v camPassport

v sessionToken

v objectId

v path



注: ログオン資格情報は、セッション・トークンおよびオブジェクト ID として指定することも、TM1 管理ホスト、TM1 サーバー、ユーザー名、パスワード、または camPassport の個々の値を含めて指定することもできます。

関数

functions には以下のオプション・コードを組み込むことができます。

v onLoad 関数を使用すると、オブジェクトがロードされて対話可能になった時点で通知が受けられるようになります。

v onTitleDimensionElementChange 宣言を使用すると、ユーザーが関連オブジェクト内のディメンション・タイトルを変更したときにイベントを処理できるようになります。

v OnActionButtonExecution 宣言を使用すると、操作ボタンが実行されたときにイベントを処理できるようになります。

例

次の例は、Websheet オブジェクトをロードする JavaScript 関数を示しています。

セッション・トークンを使用してログオン資格情報を提供できます。

注: Workbook クラスは、構成時にパラメーターとして objectId を受け入れます。TM1 Web セッションを識別するためには、sessionToken とともに objectId を含める必要があります。

// Load Websheet with a session tokenfunction loadWebsheet() {



sessionToken: "yourSessionToken",objectId: "objectIdOfNewWorkbook"onLoad: function() {


});

// Add websheet to the document bodydocument.body.appendChild(loadedWebsheet.domNode);

loadedWebsheet.startup();

});};

Workbook のプロパティーこの Workbook クラスには、以下のプロパティーがあります。

CubeViewer または Workbook のどちらかをインスタンス化する場合、以下のプロパティーはこの 2 つのオブジェクト間で共通です。

sessionTokenタイプ: String

このオブジェクトに使用する TM1 Web セッションを指定します。このプロパティーは、adminHost、tm1Server、username、password、camPassport

のプロパティーと併用しないでください。このプロパティーを指定しない場


合は、追加の資格情報を提供しないと、始動時にユーザーに対してログオン・ダイアログで入力するよう求められます。

objectIdタイプ: String

Workbook の ID。特定の Workbook を参照するために使用できる一意のID。

TM1 Web セッションを識別するためには、sessionToken とともにobjectId を含める必要があります。


new Workbook({sessionToken: "previousSessionToken",objectId: "objectIdOfNewWorkbook"

});

adminHostタイプ: String

デフォルト: localhost

オブジェクトのロード時に使用する管理ホスト。このプロパティーは、sessionToken プロパティーと併用しないでください。

tm1Serverタイプ: String

オブジェクトのロード時に使用する TM1 Server。このプロパティーは、sessionToken プロパティーと併用しないでください。指定しない場合は、sessionToken を提供しないと、始動時にユーザーに対してログオン・ダイアログで入力するよう求められます。

usernameタイプ: String

オブジェクトのロード時に使用するユーザー名。このプロパティーは、sessionToken または camPassport プロパティーと併用しないでください。指定しない場合は、sessionToken または camPassport を提供しないと、始動時にユーザーに対してログオン・ダイアログで入力するよう求められます。

passwordタイプ: String

オブジェクトのロード時に使用するパスワード。指定しない場合は、sessionToken を提供しないと、始動時にユーザーに対してログオン・ダイアログで入力するよう求められます。

camPassportタイプ: String

オブジェクトのロード時に使用する Cognos BI 認証パスポート (CAM パスポート)。このプロパティーは、username または sessionToken と併用しないでください。

domNodeタイプ: HTMLElement


ウィジェットを表す、基礎となる HTML 要素。このプロパティーは、オブジェクトの構築中に自動的に定義されます。インスタンス化時には提供できません。

詳しくは、dijit._WidgetBase に関する Dojo の資料 (https://dojotoolkit.org/

reference-guide/1.10/dijit/_WidgetBase.html) を参照してください。

以下のプロパティーは、Workbook オブジェクトのインスタンス化時にのみ使用します。

path タイプ: String

ロードするブックの TM1 Server アプリケーション・フォルダー・ツリー内のパス。

例: "Applications/Planning Sample/Bottom Up Input/Budget Input"

replaceOnNavigateタイプ: Boolean (デフォルトは true)

true の場合、新規 Workbook への操作ボタン・ナビゲーション時に、このウィジェットは新規 Workbook に置き換えられ、既存の Workbook は閉じられます。

false の場合、新しい Workbook を作成したり、onActionButtonExecution

メソッドに指定する情報を使用してこのウィジェットを置き換えたりすることは、コンシューマーの責任で行われることになります。

get のプロパティー

値を取得するすべてのプロパティーは、次の形式で呼び出されます。

get("property_Name").

例: get("sandboxes");

sandboxes使用可能なすべてのサンドボックスを取得します。

サンドボックスの取得時に解決される promise としてdojo.promise.Promise を返します。promise が解決されると、使用可能なサンドボックスを表すオブジェクトの配列が、promise に登録されたコールバックに渡されます。

各オブジェクトの形式は、次のとおりです。

name (String) - サンドボックスの名前。

active (Boolean) - このサンドボックスがオブジェクトのアクティブ・サンドボックスである場合は True、それ以外の場合は false。

baseSandbox(Boolean) - このサンドボックスが基本サンドボックスである場合はTrue、それ以外の場合は false。

defaultSandbox(Boolean) - このサンドボックスがデフォルト・サンドボックスである場合は True、それ以外の場合は false。



set のプロパティー

値を設定するすべてのプロパティーは、次の形式で呼び出されます。

set("property_Name", value)

例: set("activeSandbox", "theSandbox");

activeSandbox指定したサンドボックスをアクティブとして設定します。

パラメーター: (String) sandbox。アクティブとして設定するサンドボックスの名前。

アクティブ・サンドボックスの設定時に解決される promise としてdojo.promise.Promise を返します。

subset サブセット・オブジェクトを設定します。

パラメーター: (Object) subset。設定するディメンション・サブセットを表すオブジェクト。このオブジェクトの形式は、以下のとおりです。


ディメンション・サブセットを変更する SUBNM セルが含まれるシートのゼロから始まる索引。


ディメンション・サブセットを変更する SUBNM セルが含まれる行のゼロから始まる索引。


ディメンション・サブセットを変更する SUBNM セルが含まれる列のゼロから始まる索引。


ディメンションの名前。sheetIndex、rowIndex、および columnIndex

と併用しないでください。

setExpressionタイプ: String

サブセットを定義するために使用する MDX 式。subset と併用しないでください。つまり、setExpression かサブセット名のどちらかを入力します。

subset タイプ: String

設定するディメンション・サブセットのサブセット名。setExpression


alias タイプ: String

設定するディメンション・サブセットの別名。



要素の名前。elementIndex と併用しないでください。


設定するディメンション要素の 1 から始まる索引。element と併用しないでください。

サブセット・オブジェクトの設定時に解決される promise としてdojo.promise.Promise を返します。promise に登録されたコールバックには、このメソッドに渡されたサブセットの形式と一致するオブジェクトが渡されます。サブセットが変更されなかった場合は、Null の値が渡されます。

subsets複数のサブセット・オブジェクトを設定します。

パラメーター: (Object[]) subsets。設定するサブセット・オブジェクトの配列。各オブジェクトの形式は、以下のとおりです。


ディメンション・サブセットを変更する SUBNM セルが含まれるシートのゼロから始まる索引。


ディメンション・サブセットを変更する SUBNM セルが含まれる行のゼロから始まる索引。


ディメンション・サブセットを変更する SUBNM セルが含まれる列のゼロから始まる索引。


ディメンションの名前。sheetIndex、rowIndex、および columnIndex



サブセットを定義するために使用する MDX 式。subset と併用しないでください。つまり、setExpression か subset のどちらかを入力します。











サブセット・オブジェクトの設定時に解決される promise としてdojo.promise.Promise を返します。サブセットが正常に設定された場合、promise に登録されたコールバックには、このメソッドに渡されたサブセット・オブジェクトの形式と一致するオブジェクトの配列が渡されます。

titleDimensionElementタイトル・ディメンション要素を設定します。

パラメーター: (Object) element。設定するタイトル・ディメンション要素を表すオブジェクト。このオブジェクトの形式は、以下のとおりです。


ディメンション要素を変更する SUBNM セルが含まれるシートのゼロから始まる索引。


ディメンション要素を変更する SUBNM セルが含まれる行のゼロから始まる索引。


ディメンション要素を変更する SUBNM セルが含まれる列のゼロから始まる索引。





タイトル・ディメンション要素の設定時に解決される promise としてdojo.promise.Promise を返します。promise に登録されたコールバックには、このメソッドに渡された要素の形式と一致するオブジェクトが渡されます。要素が変更されなかった場合は、Null の値が渡されます。

titleDimensionElements複数のタイトル・ディメンション要素を設定します。


パラメーター: (Object[]) elements。設定するタイトル・ディメンション要素の配列。各オブジェクトの形式は、以下のとおりです。


変更するディメンション要素に対応する SUBNM セルが含まれるシートのゼロから始まる索引。dimension と併用する場合はオプションですが、rowIndex および columnIndex の場合は必須です。


変更するディメンション要素に対応する SUBNM セルが含まれる行のゼロから始まる索引。このパラメーターは、dimension パラメーターと併用しないでください。


変更するディメンション要素に対応する SUBNM セルが含まれる列のゼロから始まる索引。このパラメーターは、dimension パラメーターと併用しないでください。


ディメンションの名前。このパラメーターは、rowIndex およびcolumnIndex と併用しないでください。





タイトル・ディメンション要素の設定時に解決される promise としてdojo.promise.Promise を返します。要素が正常に設定された場合、promise

に登録されたコールバックには、このメソッドに渡された要素オブジェクトの形式と一致するオブジェクトの配列が渡されます。

Workbook のメソッドWorkbook クラスには、以下のメソッドがあります。

startupこのオブジェクトの始動シーケンスを開始します。この関数は、オブジェクトをドキュメントに追加した後に呼び出します。始動シーケンスの完了後にonLoad メソッドが実行されます。

CubeViewer オブジェクトと Workbook オブジェクトの両方に適用されます。

構文: startup()


例:

document.body.appendChild(loadedWebsheet.domNode);loadedWebsheet.startup();

dijit._WidgetBase#startup については、Dojo の資料を参照してください。

commitActiveSandbox

アクティブ・サンドボックス内の変更済みデータを基本サンドボックスにコミットします。

dojo.promise.Promise を返します。サンドボックスのコミット試行の完了時に解決される promise です。サンドボックス・コミットが正常に完了した場合は値が true のブール値、コミットが失敗した場合は値が false のブール値が、promise に登録されたコールバックに渡されます。

copy 選択したセルをクリップボードにコピーします (選択項目が存在する場合)。

destroyこのオブジェクトを破棄し、ガーベッジ・コレクションのために準備をします。

dijit._WidgetBase#destroy については、Dojo の資料を参照してください。

logout このオブジェクトの sessionToken に関連付けられている TM1 Web セッションを破棄します。

ログアウトの完了時に解決される promise として dojo.promise.Promise

を返します。

onActionButtonExecution操作ボタンが実行されたときに呼び出されます。

構文: onActionButtonExecution: function(executionResults){}

パラメーター: 以下の形式を使用する executionResults オブジェクト。

calculationタイプ: String

操作ボタンの実行が発生する前に現在の Workbook で行われていた計算のタイプ。

値は、「None」、「Recalculate」、「Rebuild」のいずれかです。

navigationタイプ: Object

このプロパティーは、ブックまたはシートのナビゲーションが操作ボタン実行の一部として行われた場合のみ存在します。


操作ボタン・ナビゲーションが発生した後にターゲットWorkbook で行われた計算のタイプ。





ナビゲート先だったブックの objectId。同じブック内のワークシートに対して操作が行われた場合、objectId は現在のブックと同じです。

path タイプ: String

ナビゲート先だったブックのパス。

name タイプ: String

ターゲット・ブックの名前。


ナビゲート先だったワークシートのゼロから始まる索引。

replaceタイプ: Boolean

既存のブックと置き換わるように操作ボタンが構成されていたかどうか。

tiProcessタイプ: Object

このプロパティーは、TI プロセスが操作ボタンの実行の一部として実行された場合のみ存在します。


TI プロセスが実行された後に現在のブックで行われた計算のタイプ。


name タイプ: String

実行された TI プロセスの名前。

executionSucceededタイプ: Boolean

TI プロセス実行が正常に完了したかどうか。

onLoadオブジェクトのロードの終了後に実行されます。

onTitleDimensionElementChangeタイトル・ディメンション要素の変更時に実行されます。オブジェクトの構成中にオーバーライドしたり、dojo/aspect モジュールを使用してアタッチしたりできます。

構文: onTitleDimensionElementChange: function(elementInfo){}

パラメーター: 以下の形式を使用する elementInfo オブジェクト。



変更された SUBNM セルが含まれるシートのゼロから始まる索引。


変更された SUBNM セルが含まれる行のゼロから始まる索引。


変更された SUBNM セルが含まれる列のゼロから始まる索引。




要素の名前。



paste クリップボードの内容を現在選択している領域に貼り付けます (選択項目が存在する場合)。

rebuildActiveFormsブック内のアクティブ・フォームを再作成します。

アクティブ・フォームの再作成時に解決される promise としてdojo.promise.Promise を返します。

redo やり直し操作を実行します。

やり直し操作の完了時に解決される promise として dojo.promise.Promise

を返します。

replaceobjectId を受け入れ、既存のブックを、指定された objectId で表されるブックに置き換えます (ただし、既存の Web シートと同じ場合を除きます。この場合、操作は何も行われません)

置換では、既存のブックと置き換わるブックはこれまでのブックと同じTM1 Web セッションを使用すると見なされます。

undo 元に戻す操作を実行します。

元に戻す操作の完了時に解決される promise として dojo.promise.Promise

を返します。

Cognos TM1 Web JavaScript ライブラリーの CubeViewer クラス

CubeViewer クラスは、Cognos TM1 Web CubeViewer オブジェクトを表します。


CubeViewer オブジェクトは Dojo ウィジェット・オブジェクト(dijit._WidgetBase) を継承し、Dojo タブ・コンテナー(dijit.layout.TabContainer) などのコンテナーの子オブジェクトとして割り当てることができます。詳しくは、Dojo 資料 (http://dojotoolkit.org/documentation/) を参照してください。

CubeViewer オブジェクトには、Dojo ウィジェット・オブジェクトの使用可能なプロパティーとメソッドに加えて、プログラマチックにアクセスできる TM1 関連のプロパティーとメソッドもあります。

CubeViewer オブジェクトは非同期でロードされます。ロードが終わらないとコードはオブジェクトと相互作用できません。

形式

CubeViewer オブジェクトをロードするには、以下の形式を使用して、オブジェクトを定義する必須のプロパティーとオプションの関数を指定します。

new CubeViewer({properties ..., functions ...});

プロパティー

properties には、CubeViewer オブジェクトを定義する以下の値が組み込まれます。

v adminHost

v tm1Server

v username

v password

v camPassport

v sessionToken

v objectId

v view

v cube

v isPublic

注: ログオン資格情報は、セッション・トークンおよびオブジェクト ID として指定することも、TM1 管理ホスト、TM1 サーバー、ユーザー名、パスワード、または camPassport の個々の値を含めて指定することもできます。

関数

functions には以下のオプション・コードを組み込むことができます。

v onLoad 関数を使用すると、オブジェクトがロードされて対話可能になった時点で通知が受けられるようになります。

v onTitleDimensionElementChange 宣言を使用すると、ユーザーが関連オブジェクト内のディメンション・タイトルを変更した時にイベントを処理できるようになります。



例

次の例は、CubeViewer オブジェクトをロードする JavaScript 関数を示しています。

セッション・トークンを使用してログオン資格情報を提供します。


"tm1web/api/CubeViewer"], function(CubeViewer) {


console.debug("CubeViewer loaded successfully.");},

});


loadedCubeview.startup();

});};

CubeViewer のプロパティーCubeViewer クラスには、以下のプロパティーがあります。

CubeViewer オブジェクトか Workbook オブジェクトのどちらかをインスタンス化する場合、以下のプロパティーはこの 2 種類のオブジェクト間で共通です。

sessionTokenタイプ: String

このオブジェクトに使用する TM1 Web セッションを指定します。このプロパティーは、adminHost、tm1Server、username、password、camPassport

のプロパティーと併用しないでください。このプロパティーを指定しない場合は、追加の資格情報を提供しないと、始動時にユーザーに対してログオン・ダイアログで入力するよう求められます。


CubeViewer の ID。特定の CubeViewer の参照に使用できる一意の番号。

adminHostタイプ: String

デフォルト: localhost

オブジェクトのロード時に使用する管理ホスト。このプロパティーは、sessionToken プロパティーと併用しないでください。

tm1Serverタイプ: String


オブジェクトのロード時に使用する TM1 Server。このプロパティーは、sessionToken プロパティーと併用しないでください。指定しない場合は、sessionToken を提供しないと、始動時にユーザーに対してログオン・ダイアログで入力するよう求められます。

usernameタイプ: String

オブジェクトのロード時に使用するユーザー名。このプロパティーは、sessionToken または camPassport プロパティーと併用しないでください。指定しない場合は、sessionToken または camPassport を提供しないと、始動時にユーザーに対してログオン・ダイアログで入力するよう求められます。

passwordタイプ: String

オブジェクトのロード時に使用するパスワード。指定しない場合は、sessionToken を提供しないと、始動時にユーザーに対してログオン・ダイアログで入力するよう求められます。

camPassportタイプ: String

オブジェクトのロード時に使用する Cognos BI 認証パスポート (CAM パスポート)。このプロパティーは、username または sessionToken と併用しないでください。

domNodeタイプ: HTMLElement

ウィジェットを表す、基礎となる HTML 要素。このプロパティーは、オブジェクトの構築中に自動的に定義されます。インスタンス化時には提供できません。

詳しくは、dijit._WidgetBase に関する Dojo の資料 (https://dojotoolkit.org/

reference-guide/1.10/dijit/_WidgetBase.html) を参照してください。

以下のプロパティーは、CubeViewer オブジェクトのインスタンス化時にのみ使用します。

view タイプ: String

ロードするキューブ・ビューの名前。

cube タイプ: String

ロードするビューが含まれるキューブの名前。

isPublicタイプ: Boolean

デフォルト: true

ロードするキューブ・ビューのアクセス・タイプ。

値が true の場合は、共有キューブ・ビューをロードすることを示します。

値が false の場合は、個人用キューブ・ビューをロードすることを示します。



get のプロパティー

値を取得するすべてのプロパティーは、次の形式で呼び出されます。

get("property_Name").

例: get("sandboxes");

sandboxes使用可能なすべてのサンドボックスを取得します。

サンドボックスの取得時に解決される promise としてdojo.promise.Promise を返します。promise が解決されると、使用可能なサンドボックスを表すオブジェクトの配列が、promise に登録されたコールバックに渡されます。

各オブジェクトの形式は、次のとおりです。

v name: (String) - サンドボックスの名前。

v active: (Boolean) - このサンドボックスがオブジェクトのアクティブ・サンドボックスである場合は true、それ以外の場合は false。

v baseSandbox: (Boolean) - このサンドボックスが基本サンドボックスである場合は true、それ以外の場合は false。

v defaultSandbox: (Boolean) - このサンドボックスがデフォルト・サンドボックスである場合は true、それ以外の場合は false。

set のプロパティー

値を設定するすべてのプロパティーは、次の形式で呼び出されます。

set("property_Name", value)

例: set("activeSandbox", "theSandbox");

activeSandbox指定したサンドボックスをアクティブとして設定します。

パラメーター: (String) sandbox。アクティブとして設定するサンドボックスの名前。

アクティブ・サンドボックスの設定時に解決される promise としてdojo.promise.Promise を返します。

automaticRecalculation自動再計算をオンまたはオフに設定します。

パラメーター: Boolean。

v True は、自動再計算をオンにします。

v False は、自動再計算をオフにします。

戻り値: dojo.promise.Promise。自動再計算の有効化または無効化時に解決される promise。

chartTypeCubeViewer オブジェクトのグラフのタイプを設定します。

パラメーター: tm1web.cubeview.ChartType。設定するグラフのタイプ。


戻り値: dojo.promise.Promise。グラフのタイプの設定時に解決されるpromise。

dimensionBarVisibleディメンション・バーの可視性を設定します。

パラメーター: Boolean。

v True は、ディメンション・バーの表示をオンにします。

v False は、ディメンション・バーの表示をオフにします。

displayModeCubeViewer オブジェクトの表示モードを設定します。

パラメーター: tm1web.cubeview.DisplayMode。設定する表示モード。

戻り値: dojo.promise.Promise。表示モードの設定時に解決されるpromise。

subset サブセット・オブジェクトを設定します。

パラメーター: (Object) subset。設定するディメンション・サブセットを表すオブジェクト。このオブジェクトの形式は、以下のとおりです。




サブセットを定義するために使用する MDX 式。subset と併用しないでください。つまり、setExpression かサブセット名のどちらかを入力します。










サブセット・オブジェクトの設定時に解決される promise としてdojo.promise.Promise を返します。promise に登録されたコールバックには、このメソッドに渡されたサブセットの形式と一致するオブジェクトが渡されます。サブセットが変更されなかった場合は、Null の値が渡されます。


subsets複数のサブセット・オブジェクトを設定します。

パラメーター: (Object[]) subsets。設定するサブセット・オブジェクトの配列。各オブジェクトの形式は、以下のとおりです。




サブセットを定義するために使用する MDX 式。subset と併用しないでください。つまり、setExpression か subset のどちらかを入力します。










サブセット・オブジェクトの設定時に解決される promise としてdojo.promise.Promise を返します。サブセットが正常に設定された場合、promise に登録されたコールバックには、このメソッドに渡されたサブセット・オブジェクトの形式と一致するオブジェクトの配列が渡されます。

titleDimensionElementタイトル・ディメンション要素を設定します。

パラメーター: 要素オブジェクト。設定するタイトル・ディメンション要素。このオブジェクトの形式は、次のとおりです。

ディメンション文字列


element文字列

要素の名前。このパラメーターは、elementIndex と併用しないでください。

elementIndexInteger


設定するディメンション要素の 1 から始まる索引。このパラメーターは、element パラメーターと併用しないでください。

戻り値: dojo.promise.Promise。タイトル・ディメンション要素の設定時に解決される promise。promise に登録されたコールバックには、このメソッドに渡された要素の形式と一致するオブジェクトが渡されます。要素が変更されなかった場合は、Null の値が渡されます。

titleDimensionElements複数のタイトル・ディメンション要素を設定します。

パラメーター: object[] elements。設定するタイトル・ディメンション要素の配列。各オブジェクトの形式は、次のとおりです。



element文字列

要素の名前。このパラメーターは、elementIndex と併用しないでください。

elementIndexInteger

設定するディメンション要素の 1 から始まる索引。このパラメーターは、element パラメーターと併用しないでください。

dojo.promise.Promise を返します。タイトル・ディメンション要素の設定時に解決される promise。promise に登録されたコールバックには、このメソッドに渡された要素オブジェクトの形式と一致するオブジェクトの配列が渡されます。渡される配列は、正常に設定された要素に関する報告を返します。

CubeViewer のメソッドCubeViewer クラスには、以下のメソッドがあります。

startupこのオブジェクトの始動シーケンスを開始します。この関数は、オブジェクトをドキュメントに追加した後に呼び出します。始動シーケンスの完了後にonLoad メソッドが実行されます。

CubeViewer オブジェクトと Workbook オブジェクトの両方に適用されます。

構文: startup()

例:

document.body.appendChild(loadedCubeViewer.domNode);loadedCubeViewer.startup();

dijit._WidgetBase#startup については、Dojo の資料を参照してください。

commitActiveSandbox



アクティブ・サンドボックス内の変更済みデータを基本サンドボックスにコミットします。

dojo.promise.Promise を返します。これは、サンドボックスのコミット試行の完了時に解決される promise です。サンドボックス・コミットが正常に完了した場合は値が true のブール値が、promise に登録されたコールバックに渡されます。コミットが失敗した場合は、false の値が渡されます。

copy 選択したセルをクリップボードにコピーします (選択項目が存在する場合)。

destroyこのオブジェクトを破棄し、ガーベッジ・コレクションのために準備をします。

dijit._WidgetBase#destroy については、Dojo の資料を参照してください。

logout このオブジェクトの sessionToken に関連付けられている TM1 Web セッションを破棄します。

ログアウトの完了時に解決される promise として dojo.promise.Promise

を返します。

onLoadオブジェクトのロードの終了後に実行されます。

onTitleDimensionElementChangeタイトル・ディメンション要素の変更時に実行されます。オブジェクトの構成中にオーバーライドしたり、dojo/aspect モジュールを使用してアタッチしたりできます。

構文: onTitleDimensionElementChange: function(elementInfo){}

パラメーター: elementInfo オブジェクト。このオブジェクトの形式は、次のとおりです。


変更されたディメンションの名前。

element文字列

変更された要素の名前。

elementIndexInteger

変更されたディメンション要素の 1 から始まる索引。

paste クリップボードの内容を現在選択している領域に貼り付けます (選択項目が存在する場合)。

redo やり直し操作を実行します。

やり直し操作の完了時に解決される promise として dojo.promise.Promise

を返します。

reset

キューブ・ビューをその元の保存状態にリセットします。


戻り値: dojo.promise.Promise。キューブ・ビューのリセット時に解決される promise。

save

キューブ・ビューのレイアウトを保存し、既存のレイアウトを上書きします。

戻り値: dojo.promise.Promise。キューブ・ビューの保存時に解決されるpromise。

undo 元に戻す操作を実行します。

元に戻す操作の完了時に解決される promise として dojo.promise.Promise

を返します。


付録 A. サポートされている Microsoft Excel 関数 - TM1 Web

IBM Cognos TM1 Web は、多数の Excel ワークシート関数をサポートしています。この付録では、サポートされている Excel 関数をカテゴリー別、アルファベット順にリスト表示し、Excel 関数と TM1 Web 関数とのパフォーマンスの相違について説明します。

日付と時刻関数次の表に、日付と時刻関数を示します。

関数説明

DATE 特定の日付を表すシリアル値を返します。

DATEVALUE テキスト形式の日付をシリアル値に変換します。

DAY シリアル値を日付に変換します。

DAYS360 1 年を 360 日として 2 つの日付の間の日数を計算します。

HOUR シリアル値を時に変換します。

MINUTE シリアル値を分に変換します。

MONTH シリアル値を月に変換します。

NOW 現在の日付と時刻を表すシリアル値を返します。

SECOND シリアル値を秒に変換します。

TIME 特定の時刻を表すシリアル値を返します。

TIMEVALUE テキスト形式の時刻をシリアル値に変換します。

TODAY 今日の日付を表すシリアル値を返します。

WEEKDAY シリアル値を曜日に変換します。

YEAR シリアル値を年に変換します。


財務関数次の表に、財務関数を示します。

関数説明

DB 定率法を使用して計算した指定期間の資産の減価償却費を返します。

DDB 倍率逓減法または指定したその他の方法を使用して、計算した指定期間の資産の減価償却費を返します。

FV 投資の将来価値を返します。

IPMT 対象となる期間に行われた投資に対する支払金利を返します。

IRR 一連のキャッシュ・フローに対する内部収益率を返します。

ISPMT 投資の特定期間に支払われる利息を計算します。

MIRR 正負のキャッシュ・フローが異なる利率で調達される場合の内部収益率を返します。

NPER 投資に対する支払回数を返します。

NPV 一連の定期的なキャッシュ・フローと割引率に基づいて投資の正味現在価値を返します。

PMT 投資に対する定期支払額を返します。

PPMT 指定した期間における投資に対する元金の支払額を返します。

PV 投資の現在価値を返します。

RATE 一定の期間の投資に対する金利を返します。

SLN 定額法を使用して計算した、1 期間あたりの資産の減価償却費を返します。

SYD 級数法を使用して計算した、指定期間の資産の減価償却費を返します。


情報関数次の表に、TM1 Web でサポートされている情報関数を示します。

関数説明

CELL セルの書式設定、位置、内容に関する情報を返します。

CELL 関数のサポートは、address、col、row、protect、contents、type の情報タイプのみに限定されています。

ISERR セルの内容が #N/A 以外のエラー値の場合に“TRUE”を返します。

ISERROR セルの内容がエラー値の場合に“TRUE”を返します。

ISNA セルの内容がエラー値 #N/A の場合に“TRUE”を返します。

該当なしエラー値“#N/A”を返します。

論理関数次の表に、論理関数を示します。

関数説明

AND すべての引数が TRUE のとき、“TRUE”を返します。

FALSE 論理値“FALSE”を返します。

IF 実行する論理テストを指定します。

NOT 引数の論理値を反転します。

OR いずれかの引数が TRUE であれば、“TRUE”を返します。

TRUE 論理値“TRUE”を返します。

検索/行列関数次の表に、検索/行列関数を示します。

注: LOOKUP や ROWS などのいくつかの関数は、引数に 2 次元配列を指定できます。TM1 Web は 2 次元配列をサポートしていません。データの編成や要件によっては、これらの関数で正しい値を取得できる場合があります。例えば、取り出すデータが配列の最初の部分にあたる場合です。 TM1 Web でこれらの関数を処理して正しい値を取得するには、場合によっては、1 次元配列を引数とする関数を反復して使用するように、入力データを再編成する必要があります。または、直接セル参照を使用する必要があります。

付録 A. サポートされている Microsoft Excel 関数 - TM1 Web 259

関数説明

ADDRESS ワークシートの 1 つのセルの参照を文字列で返します。

CHOOSE 値のリストから値を選択します。

COLUMN 参照の列番号を返します。

COLUMNS 参照に含まれる列の数を返します。

HLOOKUP 配列の先頭行を検索し、指定したセルの値を返します。

HYPERLINK ネットワーク・サーバー、イントラネット、またはインターネットに保存されているドキュメントを開くショートカットまたはジャンプを作成します。

INDEX インデックスを使用して、参照または配列から抽出した値を選択します。

LOOKUP ベクトルまたは配列から値を検索します。

MATCH 参照または配列から値を検索します。

OFFSET 任意の参照から参照オフセットを返します。

ROW 参照の行番号を返します。

ROWS 参照に含まれる行の数を返します。

VLOOKUP 配列の左端の列を検索し、その行内の対応するセルの値を返します。

数学/三角関数次の表に、数学/三角関数を示します。

関数説明

ABS Abs 関数により、指定した数値式の絶対値が返されます。

ACOS 数値のアークコサインを返します。

ACOSH 数値の双曲線逆余弦を返します。

ASIN 数値のアークサインを返します。

ASINH 数値の双曲線逆正弦を返します。

ATAN 数値のアークタンジェントを返します。


関数説明

ATAN2 x 座標、y 座標で表される x-y 座標のアークタンジェントを返します。

ATANH 数値の双曲線逆正接を返します。

CEILING 基準値に一番近い次の整数または一番近い倍数になるように数値を切り上げます。

COMBIN すべての対象から指定された個数を選択するときの組み合わせの数を返します。

COS 数値のコサインを返します。

COSH 数値の双曲線余弦を返します。

DEGREES ラジアンを度に変換します。

EVEN 数値を最も近い偶数の整数に切り上げます。

EXP e を底とする数値のべき乗を返します。

FACT 数値の階乗を返します。

FLOOR 数値を 0 に近い数値に切り下げます。

INT 数値を最も近い整数に切り下げます。

LN 数値の自然対数を返します。

LOG 指定された数を底とする数値の対数を返します。

LOG10 数値の常用対数を返します。

MOD 数値を除算した剰余を返します。

ODD 数値を最も近い奇数の整数に切り上げます。

PI 円周率πの値を返します。

POWER 数値をべき乗した値を返します。

PRODUCT 引数の積を返します。

RADIANS 度をラジアンに変換します。

RAND 0 から 1 の間の乱数を返します。

ROMAN アラビア数字を、ローマ数字を表す文字列に変換します。

ROUND 数値を指定された桁数で四捨五入します。


関数説明

ROUNDDOWN 数値を 0 に近い数値に切り下げます。

ROUNDUP 数値を 0 から遠い数値に切り上げます。

SIGN 数値の符号を返します。

SIN 指定した角度のサインを返します。

SINH 数値の双曲線正弦を返します。

SQRT 正の平方根を返します。

SUM 引数の合計を返します。

SUMIF 範囲内の、検索条件に一致する数値の合計を求めます。

TAN 数値のタンジェントを返します。

TANH 数値の双曲線正接を返します。

文字列操作関数次の表に、文字列操作関数を示します。

関数説明

CHAR コード番号で指定した文字を返します。

CLEAN 文字列から印刷できない文字を削除します。

CODE 文字列の先頭文字を表す数値コードを返します。

CONCATENATE 複数の文字列を結合して 1 つの文字列にまとめます。

DOLLAR 数値を $ 記号を付けた文字列に変換します。

EXACT 2 つの文字列を比較してまったく同じかどうかを確認します。

FIND 指定された文字列を他の文字列の中で検索し、その文字列の位置を返します。大文字と小文字は区別されます。

FIXED 数値を小数点以下の桁数を固定した文字列に変換します。

LEFT 文字列の先頭から指定した数の文字を返します。

LEN 文字列の文字数を返します。

LOWER 文字列を小文字に変換します。


関数説明

MID 文字列の指定した位置から、指定された数の文字を返します。

PROPER 文字列中の各単語の先頭文字を大文字に変換します。

REPLACE 文字列中の指定された文字数の文字を他の文字に置き換えます。

REPT 文字列を指定した回数繰り返します。

RIGHT 文字列の末尾から指定した数の文字を返します。

SEARCH 指定された文字列を他の文字列の中で検索し、その文字列の位置を返します。大文字と小文字は区別されません。

SUBSTITUTE 文字列中の指定した文字を他の文字で置き換えます。

T 引数を文字列に変換します。

TEXT 数値に指定した書式を設定し、文字列に変換します。

TRIM 指定した文字列から不要なスペースを削除します。

UPPER 文字列を大文字に変換します。

VALUE 文字列として入力されている引数を数値に変換します。

統計関数次の表に、統計関数を示します。

関数説明

AVEDEV データ全体の平均値に対する個々のデータの絶対偏差の平均を返します。

AVERAGE 引数の平均値を返します。

AVERAGEA 数値、文字列、および論理値を含む引数の平均値を返します。

BINOMDIST 個別項の二項分布の確率を返します。

CONFIDENCE 母集団に対する信頼区間を返します。

CORREL 2 つのデータの相関係数を返します。

COUNT 引数リストに含まれる数値の個数を返します。

COUNTA 引数リストに含まれる、空白でないセルの個数を返します。


関数説明

COUNTIF 指定した範囲に含まれる空白以外のセルのうち、検索条件に一致するセルの個数を返します。

COVAR 共分散 (1 組の分散の積を平均したもの) を返します。

DEVSQ 偏差の平方和を返します。

EXPONDIST 指数分布を返します。

FISHER フィッシャー変換の結果を返します。

FISHERINV フィッシャー変換の逆関数を返します。

FORECAST 線形トレンドに沿った値を返します。

GEOMEAN 幾何平均を返します。

GROWTH 指数トレンドに沿った値を返します。

HARMEAN 調和平均を返します。

INTERCEPT 線形回帰直線の切片を返します。

KURT データの尖度を返します。

LARGE データの中から k 番目に大きな値を返します。

LINEST 線形トレンドのパラメーターを返します。

LOGEST 指数トレンドのパラメーターを返します。

MAX 引数リストの最大値を返します。

MATCH 指定された順序で指定された値に一致する配列での項目の相対位置を返します。

MAXA 数値、文字列、および論理値を含む引数リストの最大値を返します。

MEDIAN 指定した数値の中央値を返します。

MIN 引数リストの最小値を返します。

MINA 数値、文字列、および論理値を含む引数リストの最小値を返します。

NEGBINOMDIST 負の二項分布 (成功の確率が Probability_f である場合に、Number_s 回の「成功」を得るまでに、Number_f 回の「失敗」が発生する確率) を返します。

MODE データの最頻値を返します。


関数説明

NORMDIST 正規累積分布を返します。

NORMINV 正規累積分布の逆関数を返します。

NORMSDIST 標準正規累積分布を返します。

NORMSINV 標準正規累積分布の逆関数を返します。

PEARSON ピアソンの積率相関係数を返します。

PERMUT すべての対象から指定された個数を選択するときの順列の数を返します。

RSQ ピアソンの積率相関係数を 2 乗した値を返します。

SKEW 分布の歪度を返します。

SLOPE 線形回帰直線の傾きを返します。

SMALL データの中から k 番目に小さな値を返します。

STANDARDIZE 正規化された値を返します。

STDEV 標本に基づいて予測した標準偏差を返します。

STDEVA 数値、文字列、および論理値を含む、標本に基づいて予測した標準偏差を返します。

STDEVP 母集団全体に基づいて計算した標準偏差を返します。

STDEVPA 数値、文字列、および論理値を含む、母集団全体に基づいて計算した標準偏差を返します。

STEYX 回帰における個別の x の値に対する y の予測値の標準誤差を返します。

TREND 線形トレンドに沿った値を返します。

VAR 標本に基づいて予測した分散を返します。

VARA 数値、文字列、および論理値を含む、標本に基づいて予測した分散を返します。

VARP 母集団全体に基づいて計算した分散を返します。

VARPA 数値、文字列、および論理値を含む、母集団全体に基づいて計算した分散を返します。

WEIBULL Weibull 分布を返します。


付録 B. サポートされていない Microsoft Excel 関数 - TM1Web

IBM Cognos TM1 Web は、多数の Excel ワークシート関数をサポートしています。この付録では、TM1 Web でサポートされていない Excel 関数をカテゴリー別、アルファベット順にリスト表示します。

データベース/リスト管理関数この表は、TM1 Web でサポートされていない管理関数を示します。

関数説明

DAVERAGE 選択したデータベース・エントリーの平均値を返します。

DCOUNT データベース内の数値が入力されているセルの個数を返します。

DCOUNTA データベース内の空白でないセルの個数を返します。

DGET データベースの中から指定した条件を満たす 1 つのレコードを抽出します。

DMAX 選択したデータベース・エントリーの最大値を返します。

DMIN 選択したデータベース・エントリーの最小値を返します。

DPRODUCT データベース内の条件を満たすレコードの、特定のフィールドに入力されている数値の積を返します。

DSTDEV 選択したデータベース・エントリーの標本に基づいて予測した標準偏差を返します。

DSTDEVP 選択したデータベース・エントリーの母集団全体に基づいて計算した標準偏差を返します。

DSUM 条件を満たすデータベース内のレコードのフィールド列に入力されている数値を合計します。

DVAR 選択したデータベース・エントリーの標本に基づいて予測した分散を返します。

DVARP 選択したデータベース・エントリーの母集団全体に基づいて計算した分散を返します。

日付と時刻関数この表は、TM1 Web でサポートされていない日付と時刻関数を示します。

関数説明

EDATE 開始日から起算して、指定された月数だけ前または後の日付に対応するシリアル値を返します。

EOMONTH 指定された月数だけ前または後の月の最終日に対応するシリアル値を返します。


関数説明

NETWORKDAYS 2 つの日付 (開始日と終了日) の間に含まれる稼働日の日数を返します。

WEEKNUM 日付を表すシリアル値を、その年の第何週目かを示す数値に変換します。

WORKDAY 指定された稼働日数だけ前または後の日付に対応するシリアル値を返します。

YEARFRAC start_date と end_date の間の期間が、1 年間に対して占める割合を返します。

財務関数この表は、TM1 Web でサポートされていない財務関数を示します。

関数説明

ACCRINT 定期的に利息が支払われる証券の未収利息額を返します。

ACCRINTM 満期日に利息が支払われる証券の未収利息額を返します。

AMORDEGRC 減価償却係数を使用して計算した、各会計期における減価償却費を返します。

AMORLINC 各会計期における減価償却費を返します。

COUPDAYBS 利払期間の第 1 日目から受渡日までの日数を返します。

COUPDAYS 受渡日を含む利払期間内の日数を返します。

COUPDAYSNC 受渡日から次の利払日までの日数を返します。

COUPNCD 受渡日後の次の利払日を返します。

COUPNUM 受渡日から満期日までの利払回数を返します。

COUPPCD 受渡日の直前の利払日を返します。

CUMIPMT 開始から終了までの期間に、貸付金に対して支払われる利息の累計を返します。

CUMPRINC 開始から終了までの期間に、貸付金に対して支払われる元金の累計を返します。

DISC 証券の割引率を返します。

DOLLARDE 分数で表されたドル価格を小数表示に変換します。

DOLLARFR 小数で表されたドル価格を分数表示に変換します。

DURATION 定期的に利子が支払われる証券の年間のデュレーションを返します。

EFFECT 実効年利率を返します。

FVSCHEDULE 投資期間内の一連の金利を複利計算することにより、初期投資の元金の将来価値を返します。

INTRATE 全額投資された証券の利率を返します。

MDURATION 額面を $100 と見なした証券のマコーレー・デュレーションを返します。

NOMINAL 名目年利率を返します。

ODDFPRICE 1 期目の日数が半端な証券に対して、額面 $100 あたりの価格を返します。


関数説明

ODDFYIELD 1 期目の日数が半端な証券の利回りを返します。

ODDLPRICE 最終期の日数が半端な証券に対して、額面 $100 あたりの価格を返します。

ODDLYIELD 最終期の日数が半端な証券の利回りを返します。

PRICE 定期的に利息が支払われる証券に対して、額面 $100 あたりの価格を返します。

PRICEDISC 割引証券の額面 $100 あたりの価格を返します。

PRICEMAT 満期日に利息が支払われる証券に対して、額面 $100 あたりの価格を返します。

RECEIVED 全額投資された証券に対して，満期日に支払われる金額を返します。

TBILLEQ 米国財務省短期証券 (TB) の債券換算利回りを返します。

TBILLPRICE 米国財務省短期証券 (TB) の額面 $100 あたりの価格を返します。

TBILLYIELD 米国財務省短期証券 (TB) の利回りを返します。

VDB 倍額定率法を使用して計算した、指定した期間または一部の期間における資産の減価償却費を返します。

XIRR 定期的でないキャッシュ・フローに対する内部利益率を返します。

XNPV 定期的でないキャッシュ・フローに対する正味現在価値を返します。

YIELD 定期的に利息が支払われる証券の利回りを返します。

YIELDDISC 米国財務省短期証券 (TB) などの割引債の年利回りを返します。

YIELDMAT 満期日に利息が支払われる証券の年利回りを返します。

情報関数この表は、TM1 Web でサポートされていない情報関数を示します。

関数説明

ERROR.TYPE エラー値に対応する数値を返します。

INFO 現在の操作環境に関する情報を返します。

ISBLANK セルの内容が空白の場合に“TRUE”を返します。

ISEVEN 数値が偶数の場合に“TRUE”を返します。

ISLOGICAL セルの内容が論理値の場合に“TRUE”を返します。

ISNONTEXT セルの内容が文字列以外の値である場合に“TRUE”を返します。

ISNUMBER セルの内容が数値の場合に“TRUE”を返します。

ISODD 数値が奇数の場合に“TRUE”を返します。

ISREF セルの内容が参照である場合に“TRUE”を返します。

付録 B. サポートされていない Microsoft Excel 関数 - TM1 Web 269

関数説明

ISTEXT セルの内容が文字列である場合に“TRUE”を返します。

N 引数を数値に変換して返します。

TYPE 値のデータ・タイプを表す数値を返します。

検索/行列関数この表は、TM1 Web でサポートされていない検索/行列関数を示します。

関数説明

AREAS 参照に含まれる領域の数を返します。

INDIRECT 文字列として指定された参照を返します。

RTD COM オートメーションをサポートするプログラムからリアルタイム・データを取り込みます。

TRANSPOSE 配列の行、列を入れ替えて返します。

数学/三角関数この表は、TM1 Web でサポートされていない数学/三角関数を示します。

関数説明

FACTDOUBLE 数値の二重階乗を返します。

GCD 最大公約数を返します。

LCM 最小公倍数を返します。

MDETERM 配列の行列式を返します。

MINVERSE 配列の逆行列を返します。

MMULT 2 つの配列の積を返します。

MROUND 数値を指定した基準値の倍数に切り上げまたは切り捨てた数値を返します。

MULTINOMIAL 数値の多項係数を返します。

QUOTIENT 除算の商の整数部を返します。

RANDBETWEEN 指定された範囲内の整数の乱数を返します。

SERIESSUM 式に基づき、べき級数の和を返します。

SQRTPI 数値 x πの平方根の値を返します。

SUBTOTAL リストまたはデータベースの集計値を返します。

SUMPRODUCT 指定された配列の対応する要素の積の合計を返します。

SUMSQ 引数の平方の合計を返します。

SUMX2MY2 2 つの配列で対応する要素の平方差の合計を返します。

SUMX2PY2 2 つの配列で対応する要素の平方和の合計を返します。

SUMXMY2 2 つの配列で対応する要素の差を 2 乗し、その合計を返します。


関数説明

TRUNC 数値の整数部を返します。

統計関数この表は、TM1 Web でサポートされていない統計関数を示します。

関数説明

BETADIST 累積β確率密度関数を返します。

BETAINV 累積β確率密度関数の逆関数を返します。

CHIDIST カイ 2 乗分布の片側確率を返します。

CHIINV カイ 2 乗分布の片側確率の逆関数を返します。

CHITEST カイ 2 乗分布から値を抽出して返します。

COUNTBLANK 範囲に含まれる空白セルの個数を返します。

CRITBINOM 累積二項分布が基準値以上になる最小値を返します。

FDIST F 確率分布を返します。

FINV F 確率分布の逆関数を返します。

FREQUENCY 度数分布を垂直配列で返します。

FTEST F- 検定の結果を返します。

GAMMADIST γ分布を返します。

GAMMAINV γ累積分布の逆関数を返します。

GAMMALN γ関数 G(x) の自然対数を返します。

HYPGEOMDIST 超幾何分布を返します。

LOGINV 対数正規分布の逆関数を返します。

LOGNORMDIST 対数正規累積分布を返します。

NEGBINOMDIST 負の二項分布を返します。

PERCENTILE 配列に含まれる値の k 番目の百分位を返します。

PERCENTRANK 指定したデータの中で、百分率に基づく順位を返します。

POISSON ポワソン分布を返します。

PROB 指定した範囲内の値が上限と下限との間に収まる確率を返します。

QUARTILE 配列に含まれるデータから四分位数を返します。

RANK 数値リスト内での指定した数値の順位を返します。

TDIST スチューデントの t-分布を返します。

TINV スチューデントの t-分布の逆関数を返します。

TRIMMEAN データの中間項平均を返します。

TTEST スチューデントの t-検定に関連する確率を返します。

ZTEST z-検定の片側確率の値を返します。

付録 B. サポートされていない Microsoft Excel 関数 - TM1 Web 271

文字列操作関数この表は、TM1 Web でサポートされていない文字列操作関数を示します。

関数説明

ASC 文字列内の全角の英数カナ文字を、半角の英数カナ文字に変換します。

BAHTTEXT 数値をタイ語の通貨表示記号を付けた文字列に変換します。

JIS 文字列に含まれる半角の英数カナ文字を、全角の英数カナ文字に変換します。

PHONETIC 文字列からふりがなを取り出します。

AutoShapes TM1 Web は、Microsoft Office のオートシェイプをサポートしていません。


特記事項

本書は IBM が世界各国で提供する製品およびサービスについて作成したものです。

この資料の他の言語版を IBM から入手できる場合があります。ただし、これを入手するには、本製品または当該言語版製品を所有している必要がある場合があります。

本書に記載の製品、サービス、または機能が日本においては提供されていない場合があります。日本で利用可能な製品、サービス、および機能については、日本 IBM

の営業担当員にお尋ねください。本書で IBM 製品、プログラム、またはサービスに言及していても、その IBM 製品、プログラム、またはサービスのみが使用可能であることを意味するものではありません。これらに代えて、IBM の知的所有権を侵害することのない、機能的に同等の製品、プログラム、またはサービスを使用することができます。ただし、IBM 以外の製品とプログラムの操作またはサービスの評価および検証は、お客様の責任で行っていただきます。本書には、お客様が購入されたプログラムまたはライセンス資格に含まれない製品、サービス、または機能に関する説明が含まれる場合があります。

IBM は、本書に記載されている内容に関して特許権 (特許出願中のものを含む) を保有している場合があります。本書の提供は、お客様にこれらの特許権について実施権を許諾することを意味するものではありません。実施権についてのお問い合わせは、書面にて下記宛先にお送りください。

〒103-8510

東京都中央区日本橋箱崎町19番21号日本アイ・ビー・エム株式会社法務・知的財産知的財産権ライセンス渉外

以下の保証は、国または地域の法律に沿わない場合は、適用されません。 IBM およびその直接または間接の子会社は、本書を特定物として現存するままの状態で提供し、商品性の保証、特定目的適合性の保証および法律上の瑕疵担保責任を含むすべての明示もしくは黙示の保証責任を負わないものとします。国または地域によっては、法律の強行規定により、保証責任の制限が禁じられる場合、強行規定の制限を受けるものとします。

この情報には、技術的に不適切な記述や誤植を含む場合があります。本書は定期的に見直され、必要な変更は本書の次版に組み込まれます。 IBM は予告なしに、随時、この文書に記載されている製品またはプログラムに対して、改良または変更を行うことがあります。

本書において IBM 以外の Web サイトに言及している場合がありますが、便宜のため記載しただけであり、決してそれらの Web サイトを推奨するものではありません。それらの Web サイトにある資料は、この IBM 製品の資料の一部ではありません。それらの Web サイトは、お客様の責任でご使用ください。


IBM は、お客様が提供するいかなる情報も、お客様に対してなんら義務も負うことのない、自ら適切と信ずる方法で、使用もしくは配布することができるものとします。

本プログラムのライセンス保持者で、(i) 独自に作成したプログラムとその他のプログラム (本プログラムを含む) との間での情報交換、および (ii) 交換された情報の相互利用を可能にすることを目的として、本プログラムに関する情報を必要とする方は、下記に連絡してください。

IBM Software Group

Attention: Licensing

3755 Riverside Dr.

Ottawa, ON

K1V 1B7

Canada

本プログラムに関する上記の情報は、適切な使用条件の下で使用することができますが、有償の場合もあります。

本書で説明されているライセンス・プログラムまたはその他のライセンス資料は、IBM 所定のプログラム契約の契約条項、IBM プログラムのご使用条件、またはそれと同等の条項に基づいて、IBM より提供されます。

この文書に含まれるいかなるパフォーマンス・データも、管理環境下で決定されたものです。そのため、他の操作環境で得られた結果は、異なる可能性があります。一部の測定が、開発レベルのシステムで行われた可能性がありますが、その測定値が、一般に利用可能なシステムのものと同じである保証はありません。さらに、一部の測定値が、推定値である可能性があります。実際の結果は、異なる可能性があります。お客様は、お客様の特定の環境に適したデータを確かめる必要があります。

IBM 以外の製品に関する情報は、その製品の供給者、出版物、もしくはその他の公に利用可能なソースから入手したものです。IBM は、それらの製品のテストは行っておりません。したがって、他社製品に関する実行性、互換性、またはその他の要求については確証できません。IBM 以外の製品の性能に関する質問は、それらの製品の供給者にお願いします。

IBM の将来の方向または意向に関する記述については、予告なしに変更または撤回される場合があり、単に目標を示しているものです。

本書には、日常の業務処理で用いられるデータや報告書の例が含まれています。より具体性を与えるために、それらの例には、個人、企業、ブランド、あるいは製品などの名前が含まれている場合があります。これらの名称はすべて架空のものであり、名称や住所が類似する企業が実在しているとしても、それは偶然にすぎません。

この情報をソフトコピーでご覧になっている場合は、写真やカラーの図表は表示されない場合があります。

この「ソフトウェア・オファリング」は、Cookie もしくはその他のテクノロジーを使用して個人情報を収集することはありません。


商標

IBM、IBM ロゴ、および ibm.com は、世界の多くの国で登録された International

Business Machines Corp. の商標です。他の製品名およびサービス名等は、それぞれIBM または各社の商標である場合があります。現時点での IBM の商標リストについては、www.ibm.com/legal/copytrade.shtml の「Copyright and trademark

information」をご覧ください。

他の会社名、製品名およびサービス名等はそれぞれ各社の商標です。

v Microsoft、Windows、Windows NT および Windows ロゴは、Microsoft

Corporation の米国およびその他の国における商標です。

v Java およびすべてのJava 関連の商標およびロゴは Oracleやその関連会社の米国およびその他の国における商標または登録商標です。

Microsoft 製品のスクリーン・ショットは、Microsoft Corporation の許可を得て転載しています。

特記事項 275

http://www.ibm.com/legal/copytrade.shtml

http://www.ibm.com/legal/copytrade.shtml

索引日本語, 数字, 英字, 特殊文字の順に配列されています。なお, 濁音と半濁音は清音と同等に扱われています。

［ア行］アクセス権限書き込み 129

管理 125

キューブに対する割り当て 131

集約要素 133

相互作用 130

ディメンションに対する割り当て 138

なし 130

日課に対する割り当て 141

複製権限 45

プロセスに対する割り当て 139

要素に対する割り当て 133

読み取り 128, 130

予約 129

ロック 127, 129

アクセス権限なし 130

値規則で算出 53

アプリケーションアクセス権限なし 130

オブジェクト参照の追加 95

概要 89

管理アクセス権限 126

共有 108

共有アプリケーションを個人用にする 108

共有から個人用に変換 108

共有を個人用にする 109

個人用 108

個人用から共有への変換 108

個人用サブセットに対する参照 97

個人用参照の発行 108

個人用ビューに対する参照 97

サーバー上の場所 91

最上位レベル 92

作成と管理 92

参照での作業 103

参照の削除 105

参照の名前の変更 106

セカンダリー・レベルの作成 95

セキュリティー権限 92, 107, 142

発行 93, 108

ファイル参照の追加 99

読み取りアクセス権限 128

論理グループの表示 109

アプリケーション (続き)

Web クライアントに発行 111

アプリケーション参照の名前の変更 106

ウィンドウキューブの作成 35

ディメンション・エディター 17

演算子 (規則)

算術 56

比較 57

論理 57

オブジェクトサーバー・エクスプローラーでの表示 109

オブジェクト参照アプリケーションから削除 105

デフォルトの操作 103

名前の変更 106

重み付け係数集約 10

［カ行］階層複数 33

階層レベルの概要 10

書き込みアクセス権限 129

関数検索/行列 259

財務 258

サポートされていない 267, 268, 269, 270, 271, 272

サポートされている Excel ワークシート 257

情報 259

数学/三角 260

統計 263

日付と時刻 257

文字列操作 262

論理 259

DB 58, 67

IF 56

STET 60

規則値の算出 53

概要 53

規則と集約 12

規則トレーサー 83

選択リスト 43

デバッグ 83

ファイル名 53

規則書式外部キューブ参照 58

キューブ参照 58

構文 55


規則書式 (続き)

算術演算子 56

式の比較 57

条件ロジック 56

数値定数 56

内部キューブ参照 58

比較演算子 57

論理演算子 57

規則ステートメントガイドライン 54

キューブ・データ共有用の DB 規則関数 67

計算の順序 62

構文 54, 66

サンプル 66

サンプル・アプリケーション 65

集約要素と数値要素 59

循環参照 64

数式 54

ターゲットの指定 54

単純な値への制限 69

ディメンション集約に対する優先 62

ディメンション集約の上書き 63

配置 59

バイパス 60

範囲の制限 60

非対称キューブのリンク 72

比率の計算 65

平均の計算 71

面 54

DB 関数 67

STET 関数 60

規則ステートメントのバイパス 60

規則トレーサー概要 83

計算のトレース 83

単純な例 83

複雑な例 84

FEEDERS のチェック 86

FEEDERS のトレース 86

規則内の & (アンパーサンド) 57

規則内の / (スラッシュ) 56

規則内の | (パイプ) 57

規則内の % (パーセント記号) 57

規則内の ~ (チルダ) 57

規則内の ¥¥ (バックスラッシュ) 56

規則に従う集計 12

規則のデバッグ概要 83

計算のトレース 83

FEEDERS のチェック 86

FEEDERS のトレース 86

規則ワークシート概要 61

作成 61

使用 61

規則ワークシート (続き)

ファイル名 61

保存 62

キューブアクセス権限なし 130

アクセス権限の割り当て 131

値の表示形式 14

外部データ・ソースを使用して作成 35

解放 132



規則書式参照 58

キューブを作成ダイアログ・ボックス 35

検索テーブルとして 117

最適化 37

作成 35

セキュリティー 138

ソース 45

データ共有用の DB 規則関数 67

データなしで作成 35

ディメンションの順序設定 35

ディメンションの選択 8


プロパティー 35

翻訳する 48

ミラー 45

要求時にロード 39


予約 132

予約アクセス権限 129

例 7, 9

ロック 132

ロック解除 132

ロック・アクセス権限 127

DBR 書式を使用した値の取得 120

DBS 書式の値 121

キューブ間におけるデータの共有 67

キューブの最適化 37

キューブへのデータの移入DBS 書式 121

兄弟ディメンションへの追加 19

共有アプリケーション 108

アプリケーション内の参照 108

グループセキュリティー権限の割り当て 125

ディメンション 135

子集約要素への追加 19

構文規則書式 55

個人用アプリケーション 108

アプリケーション内の参照 108


コントロール・キューブ}PickList 42

［サ行］サーバーソース 45

ターゲット 45

サーバー・エクスプローラー選択したオブジェクトの表示の無効化 109

要素の順序の設定 23

削除アプリケーションから参照を 105

集約要素 20

ディメンションから要素を 20

サポートされていない Excel 関数ACCRINT 268

ACCRINTM 268

AMORDEGRC 268

AMORLINC 268

AREAS 270

ASC 272

BAHTTEXT 272

BETADIST 271

BETAINV 271

CHIDIST 271

CHIINV 271

CHITEST 271

COUNTBLANK 271

COUPDAYBS 268

COUPDAYS 268

COUPDAYSNC 268

COUPNCD 268

COUPNUM 268

COUPPCD 268

CRITBINOM 271

CUMIPMT 268

CUMPRINC 268

DAVERAGE 267

DCOUNT 267

DCOUNTA 267

DGET 267

DISC 268

DMAX 267

DMIN 267

DOLLARDE 268

DOLLARFR 268

DPRODUCT 267

DSTDEV 267

DSTDEVP 267

DSUM 267

DURATION 268

DVAR 267

DVARP 267

EDATE 267

EFFECT 268

サポートされていない Excel 関数 (続き)

EOMONTH 267

ERROR.TYPE 269

FACTDOUBLE 270

FDIST 271

FINV 271

FRENQUENCY 271

FTEST 271

FVSCHEDULE 268

GAMMADIST 271

GAMMAINV 271

GAMMALN 271

GCD 270

HYPGEOMDIST 271

INDIRECT 270

INFO 269

INTRATE 268

ISBLANK 269

ISEVEN 269

ISLOGICAL 269

ISNONTEXT 269

ISNUMBER 269

ISODD 269

ISREF 269

ISTEXT 270

JIS 272

LCM 270

LOGINV 271

LOGNORMDIST 271

MDETERM 270

MDURATION 268

MINVERSE 270

MMULT 270

MROUND 270

MULTINOMIAL 270

N 270

NEGBINOMDIST 271

NETWORKDAYS 267

NOMINAL 268

ODDFPRICE 268

ODDFYIELD 269

ODDLPRICE 269

ODDLYIELD 269

PERCENTILE 271

PERCENTRANK 271

PHONETIC 272

POISSON 271

PRICE 269

PRICEDISC 269

PRICEMAT 269

PROB 271

QUARTILE 271

QUOTIENT 270

RANDBETWEEN 270

RANK 271

RECEIVED 269

索引 279

サポートされていない Excel 関数 (続き)

RTD 270

SERIESSUM 270

SQRTPI 270

SUBTOTAL 270

SUMPRODUCT 270

SUMSQ 270

SUMX2MY2 270

SUMX2PY2 270

SUMXMY2 270

TBILLEQ 269

TBILLPRICE 269

TBILLYIELD 269

TDIST 271

TINV 271

TRANSPOSE 270

TRIMMEAN 271

TRUNC 271

TTEST 271

TYPE 270

VDB 269

WEEKNUM 267

WORKDAY 267

XIRR 269

XNPV 269

YEARFRAC 267

YIELD 269

YIELDDISC 269

YIELDMAT 269

ZTEST 271

サポートされている Excel 関数該当なし 259

行 260

列 260

ABS 260

ACOS 260

ACOSH 260

ADDRESS 260

AND 259

ASIN 260

ASINH 260

ATAN 260

ATAN2 261

ATANH 261

AVEDEV 263

AVERAGE 263

AVERAGEA 263

BINOMDIST 263

CEILING 261

CELL 259

CHAR 262

CHOOSE 260

CLEAN 262

CODE 262

COLUMN 260

COMBIN 261

サポートされている Excel 関数 (続き)

CONCATENATE 262

CONFIDENCE 263

CORREL 263

COS 261

COSH 261

COUNT 263

COUNTA 263

COUNTIF 264

COVAR 264

DATE 257

DATEVALUE 257

DAY 257

DAYS360 257

DB 258

DDB 258

DEGREE 261

DEVSQ 264

DOLLAR 262

EVEN 261

EXACT 262

EXP 261

EXPONDIST 264

FACT 261

FALSE 259

FIND 262

FISHER 264

FISHERINV 264

FIXED 262

FLOOR 261

FORECAST 264

FV 258

GEOMEAN 264

GROWTH 264

HARMEAN 264

HLOOKUP 260

HOUR 257

HYPERLINK 260

IF 259

INDEX 260

INT 261

INTERCEPT 264

IPMT 258

IRR 258

ISERR 259

ISERROR 259

ISNA 259

ISPMT 258

KURT 264

LARGE 264

LEFT 262

LEN 262

LINEST 264

LN 261

LOG 261

LOG10 261



LOGEST 264

LOOKUP 260

LOWER 262

MATCH 260, 264

MAX 264

MAXA 264

MEDIAN 264

MID 263

MIN 264

MINA 264

MINUTE 257

MIRR 258

MOD 261

MODE 264

MONTH 257

MORMINV 265

NEGBINOMDIST 264

NORMDIST 265

NORMSDIST 265

NORMSINV 265

NOT 259

NOW 257

NPER 258

NPV 258

ODD 261

OFFSET 260

OR 259

PEARSON 265

PERMUT 265

PI 261

PMT 258

POWER 261

PPMT 258

PRODUCT 261

PROPER 263

PV 258

RADIAN 261

RAND 261

RATE 258

REPLACE 263

REPT 263

RIGHT 263

ROMAN 261

ROUND 261

ROUNDDOWN 262

ROUNDUP 262

ROW 260

RSQ 265

SEARCH 263

SECOND 257

SIGN 262

SIN 262

SINH 262

SKEW 265

SLN 258


SLOPE 265

SMALL 265

SQRT 262

STANDARDIZE 265

STDEV 265

STDEVA 265

STDEVP 265

STDEVPA 265

STEYX 265

SUBSTITUTE 263

SUM 262

SUMIF 262

SYD 258

T 263

TAN 262

TANH 262

TEXT 263

TIME 257

TIMEVALUE 257

TODAY 257

TREND 265

TRIM 263

TRUE 259

UPPER 263

VALUE 263

VAR 265

VARA 265

VARP 265

VARPA 265

VLOOKUP 260

WEEKDAY 257

WEIBULL 265

YEAR 257

参照アクセス権限なし 130


共有 108, 109

共有から個人用に変換 109

個人用 108, 109

個人用から共有への変換 108


集計 10

規則に従う 12

集約重み付け係数を使用した作成 10

規則との対比 12

単一ディメンション内の複数のパス 11

集約要素 133

子の追加 19

定義済みの 13

ディメンション・ワークシートでの定義 30

要素の削除 20

循環参照 (規則) 64

条件ロジック規則書式 56

索引 281

数値規則書式内の定数 56

要素の定義 13

セキュリティーアクセス権限 125

アプリケーション 142

キューブ・レベル 131, 138

グループ 138

グループ権限 125

権限の相互作用 130

権限をアプリケーションに適用 107, 142

参照 142

セル・レベル 135

ディメンション・レベル 138

日課 141

プロセス 139

要素レベル 133, 138

セキュリティー権限の割り当て 125

セキュリティー・アクセス・オプション 140

セキュリティー・オーバーレイ 185

セキュリティー・コントロール・キューブ 135

セッション・トークン・ログオン 190

セル・レベルのセキュリティー集約 135

セキュリティー・コントロール・キューブ 135

リーフ要素 135

選択リスト規則を使用して定義 43

コントロール・キューブで作成 42

作成 39

サブセット 40

静的 40

タイプ 40

ディメンション 41

優先順 44

要素属性で作成 41

ソース・キューブ 45

ソース・サーバー 45

操作ボタンアピアランスのプロパティー 154

移動とサイズ変更 158

概要 143

ナビゲーションとマッピングの高度なオプションの使用154

プロセスを実行しワークシートにナビゲートする 151

別のワークシートにナビゲートする 149

変更 158

ワークシートへの追加 143

属性概要 13

形式 14

要素との対比 16

例 13

粗なディメンション 35

［タ行］ターゲット・サーバー 45

ダイアログ・ボックスキューブの作成 35

データ集計 10

データのインポートプロセス・ワークシート 115

データ予約概要 161

監査ログ・イベントの表示 171

関数を使用したモニター 172

キューブでの有効化 168

構成 168

使用するとき 161

使用方法 161

セルのステータスの表示 171

他の機能との動作 164

モニター 171

ユーザー・グループの有効化 170

有効化 167

API 関数の使用 178

TM1 Top ユーティリティーを使用したモニター 171

TurboIntegrator 関数の使用 173

データ予約 API の関数エラー・コード 183

TM1DataReservationAcquire 179

TM1DataReservationGetAll 181

TM1DataReservationGetConflicts 182

TM1DataReservationRelease 179

TM1DataReservationReleaseAll 180

TM1DataReservationValidate 183

データ予約の TurboIntegrator 関数CubeDataReservationAcquire 173

CubeDataReservationGet 176

CubeDataReservationGetConflicts 177

CubeDataReservationRelease 174

CubeDataReservationReleaseAll 175

データ予約モード 162

定数規則書式 56

ディメンションアクセス権限なし 130

アクセス権限の割り当て 138, 139, 141

階層 10, 30

解放 138



管理グループ 138

キューブでの選択 8

キューブ内での順序設定 35

兄弟の追加 19

作成 16

作成方法 16

集約 12, 63


ディメンション (続き)

粗な 35

ディメンション・エディターでの作成 17

名前付きレベル 31

編集 18

翻訳する 49

密な 35

要素の削除 20

要素の順序の設定 21, 23

要素の追加 19


予約 138


ロック 139

ロック解除 139


ワークシート 28, 31

ディメンション・エディター別名の使用 26

要素の選択 24

要素のソート 25, 26

ドリルスルー・プロセス 73, 76, 77, 78

ダウン 10

［ナ行］名前付き階層レベル 31

日課アクセス権限なし 130



［ハ行］ハイパーリンクアップロードされたアプリケーション・ファイルを開く

111

比較演算子規則書式 57

非対称キューブリンク 72


表示形式キューブの値 14

設定 15

比率規則を使用して計算 65

複数階層 33

複数の集約パス 11

複製キューブの関係 45

サーバーの関係 45

ソース・キューブ 45

ソース・サーバー 45

複製 (続き)

ターゲット・サーバー 45

必要なアクセス権限 45

ミラー・キューブ 45

利点 45

プロセスアクセス権限なし 130


セキュリティー・データの変更 140


平均の計算規則ステートメント 71

別名ディメンション・エディター 26

要素属性 13

例 14

翻訳 47

［マ行］マルチディメンション概要 1

図 2

例 1

密なディメンション 35

ミラー・キューブ 45

命名規則TM1 オブジェクト 3

メンバー翻訳する 50

文字列要素定義済みの 13

［ヤ行］要求時にキューブをロード 39

要素アクセス権限なし 130

アクセス権限の割り当て 133

重み付け係数 10

階層内の位置の変更 20

解放 134



兄弟の追加 19

サーバー・エクスプローラーからの順序の設定 23

集約 13, 133

集約要素の削除 20

数値 13


属性との対比 16

タイプ 13

ディメンションから削除 20

ディメンション内での順序 21

ディメンション内での順序の設定 21, 23

索引 283

要素 (続き)

ディメンションへの追加 17, 19

ディメンション・エディターで選択 24

ディメンション・エディターでのソート 24

表示されているすべての要素の選択 20

文字列 13


予約 134


ロック 134

ロック解除 134


要素属性Picklist 41

要素のソートディメンション・エディター 24

ディメンション・エディターでアルファベット順に 25

ディメンション・エディターでインデックスにより 25

ディメンション・エディターで階層別 26

読み取りアクセス権限 128, 130


予約文字オブジェクト名 3

［ラ行］レベル 0 (ディメンション階層) 10

ロック・アクセス権限 127, 129

論理演算子規則書式 57

AAPI 189


JavaScript ライブラリー 223

URL API 197

Area (規則のターゲット) 54

CCaption 属性 47, 48, 49, 50

CubeDataReservationAcquire 173

CubeDataReservationGet 176

CubeDataReservationGetConflicts 177

CubeDataReservationRelease 174

CubeDataReservationReleaseAll 175

CubeViewer オブジェクトJavaScript ライブラリーの使用 230

URL API の使用 210

CubeViewer クラスプロパティー 248

メソッド 253

DDataReservationMode プロパティー 168

DB 規則関数 58

DBS 書式概要 115

作成 121

EExcel

サポートされていないワークシート関数 267

ファイル参照 103, 105, 106

ワークシート関数 257

}Externals サブディレクトリー 99

IIF 関数規則書式 56

JJavaScript ライブラリー概要 223

コールバック関数 231


プロパティーとメソッドのサンプル 233

CubeViewer オブジェクトのロード 230

CubeViewer クラス 247

CubeViewer のプロパティー 248

CubeViewer のメソッド 253

HTML head タグ 225

Websheet オブジェクトのロード 229

Workbook クラス 236

Workbook のプロパティー 237

Workbook のメソッド 243

LLegacyUrlApiSessionDiscoveryEnabled パラメーター 192

OOLAP 38

OLE DB 38

RRDCLS 135


SSecurityOverlayCreateGlobalDefault 185

SecurityOverlayDestroyGlobalDefault 186

SecurityOverlayGlobalLockNode 187

STET 規則関数 60

TTM1

オブジェクトの命名規則 3

TM1 Web API 189

TM1 Web JavaScript ライブラリー参照： JavaScript ライブラリー

TM1 Web URL API

参照： URL API

TM1DataReservationAcquire 179

TM1DataReservationGetAll 181

TM1DataReservationGetConflicts 182

TM1DataReservationRelease 179

TM1DataReservationReleaseAll 180

TM1DataReservationValidate 183

UURL API 197

以前の URL API プロジェクトのアップグレード 214

概要 197

基本 URL 199

基本概念 201

構文 198


操作をオブジェクトに適用する 206

入門 198

パラメーター 200

パラメーター・リファレンス 216

フォーム・ベースのログオン 204

ユーザーのログオンとログアウト 203

ログアウト 205

Action パラメーター 205

AdminHost パラメーター 202

CubeViewer オブジェクトのオープン 210

CubeViewer オブジェクトの表示 210

CubeViewer グラフ 212

CubeViewer グラフ・タイプ 213

Cubeviewer タイトル要素 211

CubeViewer の表示プロパティー 210

URL API (続き)

CubeViewer の表示モード 212

HTML iframe 201

LegacyUrlApiSessionDiscoveryEnabled パラメーター 192

Open パラメーター 206

TM1Server パラメーター 202

URL エスケープ文字 201

Websheet オブジェクトのオープン 207

Websheet オブジェクトの表示 207

Websheet タイトル要素 208

Websheet の表示プロパティー 208

URL API のパラメーター操作 217

AccessType 216, 220

AdminHost 218

AutoRecalc 218

ChartType 219

Cube 220

HideDimensionBar 221

HideToolbar 221

TM1Server 221

TM1SessionId 222

Type 222

View 222

Workbook 223

WWeb クライアントへのアプリケーションの発行 111

Web シートプロパティーの設定 111

Web シート・オブジェクトアップロードされたアプリケーション・ファイルへのハイパーリンク 111

Websheet オブジェクトJavaScript ライブラリーの使用 229

URL API の使用 207

Workbook クラス 236, 247

プロパティー 237

メソッド 243

［特殊文字］}Externals サブディレクトリー

Excel ファイル 99

索引 285

TM1 for Developerspublic.dhe.ibm.com/.../docs/ja/2.0.0/tm1_dg_dvlpr.pdfTM1 for Developers 注記...

Documents

Transcript of TM1 for Developerspublic.dhe.ibm.com/.../docs/ja/2.0.0/tm1_dg_dvlpr.pdfTM1 for Developers 注記...