TM1 Web ユーザー・ガイド - IBM

IBM Planning Analytics2.0

TM1 Web ユーザー・ガイド

IBM

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

製品情報本書は IBM Planning Analytics バージョン 2.0 に適用されます。また、それ以降のリリースにも適用される場合があります。お客様の環境によっては、資料中の円記号がバックスラッシュと表示されたり、バックスラッシュが円記号と表示されたりする場合があります。　原典：

IBM Planning Analytics 2.0TM1 Web User GuideLast updated: 2021-04-28

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

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

Licensed Materials - Property of IBM© Copyright International Business Machines Corporation 2007, 2021.

目次

はじめに.............................................................................................................. vii

第 1 章 TM1 Web の新機能.......................................................................................12.0.63 - 機能更新、2021 年 4 月 12 日.......................................................................................................1

1 つの Web シートに複数の TM1 データベースからのデータを取得する............................................12.0.62 - 機能更新と既知の問題、2021 年 3 月 8 日................................................................................... 1

1 つの Web シートに複数の TM1 データベースからのデータを取得する (Planning AnalyticsWorkspace Local のみ)...................................................................................................................... 2

Web シートの散布グラフでの予期しないラベル.................................................................................. 22.0.61 - 機能更新と既知の問題、2021 年 2 月 9 日................................................................................... 2

Web シートのグラフのラベルがずれる................................................................................................. 32.0.60 - 機能更新と既知の問題、2020 年 12 月 17 日...............................................................................3

Web シートの円グラフのラベルがずれる............................................................................................. 32.0.59 - 機能更新、2020 年 11 月 13 日.....................................................................................................42.0.58 - 機能更新、2020 年 10 月 20 日.....................................................................................................42.0.57 - 機能更新、2020 年 9 月 21 日.......................................................................................................42.0.56 - 機能更新、2020 年 8 月 12 日.......................................................................................................42.0.55 - 機能更新、2020 年 7 月 16 日.......................................................................................................5

TM1 Web の新規リリース・スケジュール.............................................................................................5TM1 Web の新規インストーラー........................................................................................................... 5

2.0.9 - 機能更新、2019 年 12 月 16 日.......................................................................................................5Web シートで動的な形状とイメージを使用する.................................................................................. 5複数タブの Web シートの保存時にアクティブだったタブで Web シートを開く................................ 5

2.0.8 - 機能更新、2019 年 6 月 21 日......................................................................................................... 6TM1 Web ログにユーザー名とメモリー使用量を含める.......................................................................6TM1 Application Web に自動的に保存される変更................................................................................ 7TM1 Web URL API を Cognos Analytics セキュリティーとともに使用してログオンを構成する........7TM1 Web Web シートのリレーショナル・データ・ソースが削除されました.....................................8

2.0.7 - 機能更新、2019 年 4 月 29 日......................................................................................................... 8TM1 Web での Web シートのロードの高速化....................................................................................... 8TM1 Web での IFERROR Excel 関数の使用............................................................................................8TM1 Web Web シートでの改善されたセル書式設定の利用.................................................................. 8更新された TM1 Web 構成のデフォルトについて ................................................................................9TM1 Web Web シートでのリレーショナル・データ・ソースの非推奨化 .........................................10

2.0.6 - 機能更新、2018 年 10 月 11 日.....................................................................................................102.0.5 - 機能更新、2018 年 6 月 25 日.......................................................................................................102.0.3 - 機能更新、2017 年 9 月 19 日.......................................................................................................112.0.0 - 機能更新、2016 年 12 月 16 日.....................................................................................................11

第 2 章 TM1 Web の概要........................................................................................15TM1 Web の開始........................................................................................................................................ 15TM1 Web の使用........................................................................................................................................ 16データの参照タスクと分析タスク.............................................................................................................16管理者タスク..............................................................................................................................................16Apple iPad から TM1 Web へのアクセス...................................................................................................16ユーザー補助機能...................................................................................................................................... 17

第 3 章Web シートの処理..................................................................................... 19Web シートの概要......................................................................................................................................19

Web シートと Excel ワークシートの違い............................................................................................19

iii

Web シートに継承される Excel 機能................................................................................................... 20複合 DBRW 式は TM1 Web でサポートされない................................................................................. 23

Web シートの表示......................................................................................................................................23Web シートのツールバーの使用............................................................................................................... 23TM1 Web でのアクティブ・フォーム....................................................................................................... 24Web シートのデータの編集.......................................................................................................................24

Web シートのセルのデータ編集.......................................................................................................... 25Web シートでのデータ・スプレッドの使用........................................................................................26データ・スプレッドからのセルの除外................................................................................................26データ・スプレッドからの集約の除外................................................................................................26

Web シートでのリレーショナル・データの操作......................................................................................27Excel でのリレーショナル・クエリーの定義...................................................................................... 27Excel でのパラメーター化クエリーの作成..........................................................................................29リレーショナル・クエリーの TM1 Web へのアップロード................................................................30TM1 Web でのリレーショナル・データの表示................................................................................... 30

Web シートのプロパティーの変更............................................................................................................31Web シートからのレポート生成............................................................................................................... 32

Web シートのエクスポートの制限...................................................................................................... 34

第 4 章 TM1 Web Cube Viewer の操作.................................................................... 35TM1 Web でキューブ・ビューを開く....................................................................................................... 35TM1 Web Cube Viewer ツールバーの使用................................................................................................ 36ページの移動..............................................................................................................................................37キューブ・ビューのデータの保存.............................................................................................................38キューブ・ビューの設定........................................................................................................................... 39集約の展開と折りたたみ......................................................................................................................39ディメンションのピボット.................................................................................................................. 39キューブ・ビューのフィルター...........................................................................................................40サブセットからの要素の選択...............................................................................................................40キューブ・ビューからのドリル...........................................................................................................41

キューブ・ビューのデータの編集.............................................................................................................41キューブ・ビューのセルのデータの編集............................................................................................ 41データ・スプレッドの使用.................................................................................................................. 42クイック・データ入力コマンド...........................................................................................................42Cube Viewer の集約セルにデータを入力する..................................................................................... 45データ・スプレッドからのセルの除外................................................................................................45データ・スプレッドからの集約の除外................................................................................................46セルのコメントの追加、表示、削除................................................................................................... 46

新しいキューブ・ビューの作成................................................................................................................ 47キューブ・ビューからのレポート生成..................................................................................................... 47

Cube Viewer のエクスポートの制限.................................................................................................... 48

第 5 章グラフの操作..............................................................................................49グラフ・タイプの変更............................................................................................................................... 49グラフからのドリル...................................................................................................................................49

第 6 章 TM1 Web でのサブセットの編集................................................................. 51サブセット編集の概要............................................................................................................................... 51動的サブセットと静的サブセット....................................................................................................... 51

サブセット・エディターを開く................................................................................................................ 51サブセット・エディターでの編集.............................................................................................................51サブセット・エディターのツールバーの使用.....................................................................................52Cube Viewer での翻訳された要素名の表示......................................................................................... 53要素の移動............................................................................................................................................ 53集約の移動............................................................................................................................................ 54要素の維持............................................................................................................................................ 54要素の削除............................................................................................................................................ 55

iv

要素のフィルター.................................................................................................................................55要素の検索............................................................................................................................................ 57要素のソート........................................................................................................................................ 57集約の展開と折りたたみ......................................................................................................................58親の挿入................................................................................................................................................59

カスタム集約の作成...................................................................................................................................60既存のサブセットからのカスタム集約の作成.....................................................................................60選択した要素からのカスタム集約の作成............................................................................................ 60

第 7 章ライトバック・モードとサンドボックス....................................................... 61ライトバック・モード............................................................................................................................... 61ライトバック・モードの設定...............................................................................................................61

さまざまなツールバー・オプションについて.......................................................................................... 62ダイレクト・ライトバックと名前付きサンドボックスの使用........................................................... 62個人用ワークスペースと名前付きサンドボックスの使用.................................................................. 63名前付きサンドボックスがない個人用ワークスペース ...................................................................... 63サンドボックスなしのダイレクト・ライトバック............................................................................. 64

個人用ワークスペースまたはサンドボックスの使用............................................................................... 64サンドボックスのリーフ・セルと集約セルのデータ値...................................................................... 65サンドボックスまたは個人用ワークスペースのデータ値のリセット................................................ 65変更したデータ値のセルの色分けの理解............................................................................................ 66変更データを個人用ワークスペースまたはサンドボックスからベースへコミット .......................... 66

第 8 章 TM1 Web とスコアカード........................................................................... 69TM1 Web のスコアカード・オブジェクト................................................................................................ 70

TM1 Web の評価指標キューブ.............................................................................................................70TM1 Web の影響図............................................................................................................................... 71TM1 Web の戦略マップ........................................................................................................................72TM1 Web のユーザー指定の図.............................................................................................................73

TM1 Web での評価指標キューブの表示....................................................................................................74TM1 Web での影響図の表示...................................................................................................................... 75TM1 Web での戦略マップの表示...............................................................................................................75TM1 Web でのユーザー指定の図の表示....................................................................................................76

第 9 章 IBM TM1 Web の管理................................................................................. 77IBM TM1 Web の概要.................................................................................................................................77TM1 Web でのパスワードの変更...............................................................................................................77リレーショナル・データ接続のためのプロキシー・アカウントの設定..................................................77TM1 Web 構成パラメーターの変更........................................................................................................... 78

TM1 Web 構成パラメーター.................................................................................................................79TM1 Web 設定ファイルの編集.............................................................................................................85AdminHostName および TM1ServerName のパラメーターを使用した TM1 Web ログオン・ページの設定.......................................................................................................................................... 86

TM1 Web のカスタム・ホーム・ページの設定................................................................................... 86TM1 Web のスタートアップと外観の設定の構成............................................................................... 91Cube Viewer のページ・サイズの変更................................................................................................ 93Web シートからエクスポートするシートの最大数の設定..................................................................94キューブ・ビューにおけるストリング値の折り返し..........................................................................94TM1 Web セッション・タイムアウトの設定.......................................................................................95

TM1 Web ログ記録の使用..........................................................................................................................96IBM TM1 Web ログ・ファイル............................................................................................................ 96TM1 Web ログ記録のメッセージ重大度レベル................................................................................... 96IBM TM1 Web ログ記録の設定と有効化..............................................................................................97TM1 Web ログ・ファイルの表示......................................................................................................... 98TM1 Web ログでのユーザー名とメモリー使用量の構成.................................................................... 98

Microsoft Excel 2007 以前の .xls ワークシートを使用する場合.............................................................. 99.xls ワークシートから .xlsx への変換...................................................................................................99

v

Microsoft Windows 以外の Web サーバーのデフォルト・フォント設定の確認....................................100

付録 A TM1 Web API.......................................................................................... 101TM1 Web API セッション・ログオン......................................................................................................101セッション・トークン・ログオン..................................................................................................... 102TM1 セッション ID ログオン............................................................................................................. 104Session モジュールと LoginDialog モジュール................................................................................. 105

TM1 Web の URL API............................................................................................................................... 108TM1 Web URL API の概要.................................................................................................................. 108TM1 Web URL API の導入.................................................................................................................. 108TM1 Web URL API の概念.................................................................................................................. 110URL API による Web シート・オブジェクトの表示..........................................................................115URL API による CubeViewer オブジェクトの表示............................................................................ 117以前の URL API プロジェクトを新しい TM1 Web URL API にアップグレードする........................ 121TM1 Web URL API パラメーター・リファレンス............................................................................. 122

TM1 Web JavaScript ライブラリー......................................................................................................... 130JavaScript ライブラリーを使用するために必須の HTML <head> タグと <body> タグ ................. 131AMD ローダーへの JavaScript ライブラリーの設定......................................................................... 131JavaScript ライブラリーによる Web シート・オブジェクトのロード............................................ 134JavaScript ライブラリーによる CubeViewer オブジェクトのロード...............................................135JavaScript ライブラリーのコールバック関数...................................................................................136JavaScript ライブラリーのプロパティーとメソッドを表すサンプル・コード............................... 138TM1 Web JavaScript ライブラリーの Workbook クラス.................................................................. 140TM1 Web JavaScript ライブラリーの CubeViewer クラス............................................................... 149

付録 B サポートされている Microsoft Excel 関数 - TM1 Web.................................. 157日付と時刻の関数.................................................................................................................................... 157財務関数...................................................................................................................................................157情報関数...................................................................................................................................................158論理関数...................................................................................................................................................159検索/行列関数.......................................................................................................................................... 159数学/三角関数.......................................................................................................................................... 160文字列操作関数........................................................................................................................................162統計関数...................................................................................................................................................163

付録 C サポートされていない Microsoft Excel 関数 - TM1 Web...............................167データベース/リスト管理関数................................................................................................................ 167日付と時刻の関数.................................................................................................................................... 167財務関数...................................................................................................................................................168情報関数...................................................................................................................................................170検索/行列関数.......................................................................................................................................... 170数学/三角関数.......................................................................................................................................... 170統計関数...................................................................................................................................................171文字列操作関数........................................................................................................................................173

特記事項............................................................................................................ 175

索引...................................................................................................................179

vi

はじめにTM1® Web は、IBM® Planning Analytics の分析能力を拡張した Web ベースのソフトウェア・クライアントです。TM1 Web を使用すると、Web ブラウザーで IBM TM1 データを表示、分析、編集、および図表化することができます。管理者は、 TM1 Web を使用して TM1 管理タスクを実行することもできます。注 : IBM Planning Analytics Workspace は、TM1 データを分析するための次世代の Web ベース・インターフェースであり、コンテンツの計画、作成、および分析を行えます。 Planning Analytics Workspace は、TM1 Web、TM1 Perspectives、および TM1 Architect の機能と分析を組み合わせたものです。詳しくは、IBM Knowledge Center で Planning Analytics Workspace の資料を参照してください。Planning Analytics は、ビジネス計画、業績測定、業務データを統合して、企業が地理的制限や構造的制限を受けることなく事業効率と顧客対話を最適化できるようにします。 Planning Analytics を使用すれば、データを即座に可視化し、協同プロセス内の責任を明確にして、一貫した情報を表示できるので、経営陣は変動する運用状況を迅速に安定化させ、新しいビジネス・チャンスを活用することができます。

情報の検索資料を Web で入手するには、IBM Knowledge Center (http://www.ibm.com/support/knowledgecenter) にアクセスしてください。各言語版の資料もすべて用意されています。

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

ユーザー補助機能ユーザー補助機能は、運動障害または視覚障害など身体に障害を持つユーザーが情報技術製品を快適に使用できるようにサポートします。TM1 Web には、キーボードだけを使用して作業を行えるようにユーザー補助機能が組み込まれています。例えば、Web シートに関連したメニューやダイアログ・ボックスへのキーボード・ナビゲーションやキーボード・アクセスなどの機能があります。詳しくは、17 ページの『ユーザー補助機能』を参照してください。

将来の見通しに関する記述本資料は、製品の現行機能について説明するものです。現在利用できない項目への言及が含まれる場合もありますが、将来的に使用可能になることを示唆するものではありません。このような言及は、なんらかの資料、コード、または機能を提供するという誓約、保証、または法的義務ではありません。特性や機能の開発、公開、およびその時期に関しては、引き続き IBM が単独裁量権を有します。

© Copyright IBM Corp. 2007, 2021 vii

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

viii IBM Planning Analytics: TM1 Web ユーザー・ガイド

第 1 章 TM1 Web の新機能IBM TM1 Web には、新しい機能があります。詳しくは、IBM Knowledge Center にある TM1 Web の資料を参照してください。

2.0.63 - 機能更新、2021 年 4 月 12 日IBM® Planning Analytics TM1 Web は 2021 年 4 月 12 日に更新され、以下の更新が組み込まれました。TM1 Web の各バージョンに対する更新は累積的なものです。以前のリリースの新機能については、1 ページの『第 1 章 TM1 Web の新機能』を参照してください。

1 つの Web シートに複数の TM1 データベースからのデータを取得する複数の TM1 データベースからのデータを 1 つの Web シートに取得できるようになりました。以前のリリースで存在していた、この機能の制限が撤廃されました。Planning Analytics SC 2.0.62 では、複数の TM1 データベースからのデータを 1 つの Web シートに取得する機能が導入されていましたが、以下の 2 つの制限がありました。• Web シートで参照されるすべてのデータベースは、同じ管理ホストに登録されている必要があった• Web シート内の複数の TM1 データベースは、Planning Analytics Local でのみ使用できたこれらの制限は撤廃されました。Web シートは、異なる管理ホストで登録されたデータベースを参照できるようになりました。また、Planning Analytics Workspace Local と Planning Analytics on Cloud の両方で、複数の TM1 データベースから 1 つの Web シートにデータを取得することもできます。複数のデータベースからデータを取得できるのは、カスタム・レポートと動的レポートのみです。これらは、VIEW 関数を使用してデータを取得します。複数のデータベースを 1 つの Web シートで正常に参照するには、以下の点に注意してください。• データベース名は静的である必要があります。算出されたデータベース名はサポートされていません。• すべてのデータベースは、同じ認証モードを使用するように設定されている必要があります。• ユーザーはデータベース間で共通の資格情報を持っている必要があります。参照データベースのいずれかが実行されていないか、接続が確立できない場合、Web シートにエラーが表示されます。

Web シートの詳細については、Web シートの概要を参照してください。

2.0.62 - 機能更新と既知の問題、2021 年 3 月 8 日IBM® Planning Analytics TM1 Web は 2021 年 3 月 8 日に更新されました。このリリースには、Web シートの散布グラフの予期しないラベルに関する既知の問題が含まれています。これについては、ここで説明しています。TM1 Web の各バージョンに対する更新は累積的なものです。以前のリリースの新機能については、1 ページの『第 1 章 TM1 Web の新機能』を参照してください。

© Copyright IBM Corp. 2007, 2021 1

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

https://www.ibm.com/support/knowledgecenter/en/SSD29G_2.0.0/com.ibm.swg.ba.cognos.tm1_ug.2.0.0.doc/c_websheetoverview_n10013f.html#WebsheetOverview_N10013F

1 つの Web シートに複数の TM1 データベースからのデータを取得する(Planning Analytics Workspace Local のみ)

複数の TM1 データベースからのデータを 1 つの Web シートに取得できるようになりました。Web シートで参照されるすべてのデータベースは、同じ管理ホストに登録されている必要があります。複数のデータベースからデータを取得できるのは、カスタム・レポートと動的レポートのみです。これらは、VIEW 関数を使用してデータを取得します。複数のデータベースを 1 つの Web シートで正常に参照するには、以下の点に注意してください。• データベース名は静的である必要があります。算出されたデータベース名はサポートされていません• すべてのデータベースは、同じ認証モードを使用するように設定されている必要があります• ユーザーはデータベース間で共通の資格情報を持っている必要があります

Web シートの散布グラフでの予期しないラベルこの問題は、散布グラフのラベル・テキストがカスタマイズ/ハードコーディングされたテキストを使用するように編集されている場合に発生します。カスタマイズされたラベル・テキストを表示する代わりに、ラベルには "[x-value], [y-value]" が表示されます。 x 値と y 値は、グラフの範囲内で設定されたデータ・ポイントの値です。以下のイメージで強調表示されているラベルは、この問題を示しています。

この問題は、今後のリリースで修正される予定です。

2.0.61 - 機能更新と既知の問題、2021 年 2 月 9 日IBM® Planning Analytics TM1 Web は 2021 年 2 月 9 日に更新され、修正のみ組み込まれました。新機能はありませんが、グラフでのラベルのずれに関する既知の問題はここで説明されています。TM1 Web の各バージョンに対する更新は累積的なものです。以前のリリースの新機能については、1 ページの『第 1 章 TM1 Web の新機能』を参照してください。

2 IBM Planning Analytics: TM1 Web ユーザー・ガイド

Web シートのグラフのラベルがずれるグラフ・データ・ラベルが Excel の値として設定される一般的ではないグラフ構成で、ラベルは対応するTM1 Web の Web シート内で間違った場所に置かれます。以下の図のように、ラベルはグラフの左上に表示され、すべてのラベルが重なり合っています。


2.0.60 - 機能更新と既知の問題、2020 年 12 月 17 日IBM® Planning Analytics TM1 Web は 2020 年 12 月 17 日に更新され、修正のみ組み込まれました。新機能はありませんが、円グラフでのラベルのずれに関する既知の問題はここで説明されています。TM1 Web の各バージョンに対する更新は累積的なものです。以前のリリースの新機能については、1 ページの『第 1 章 TM1 Web の新機能』を参照してください。

Web シートの円グラフのラベルがずれるTM1 Web シートの円グラフのラベルが、元の Excel スプレッドシートのグラフのラベルと比較してずれることがあります。一部のケースでは、セグメントのラベルが次の例のように適用先のセグメントの外側に表示される場合があります。


第 1 章 TM1 Web の新機能 3

2.0.59 - 機能更新、2020 年 11 月 13 日IBM® Planning Analytics TM1 Web は 2020 年 11 月 13 日に更新され、修正のみ組み込まれました。TM1 Web の各バージョンに対する更新は累積的なものです。以前のリリースの新機能については、1 ページの『第 1 章 TM1 Web の新機能』を参照してください。


2.0.57 - 機能更新、2020 年 9 月 21 日IBM Planning Analytics TM1 Web は 2020 年 9 月 21 日に更新され、以下の更新が組み込まれました。

新しいユーザー・エクスペリエンスTM1 Web ユーザー・インターフェースが更新され、エクスペリエンスにおける他の IBM 製品との一貫性が向上しました。ユーザーが気付く最も目立つ変更は、新しいログオン・ページと TM1 Web 全体でシンプルになったアイコンです。ジェスチャー、メニュー選択、機能は、変わっていません。既存のすべての Web シート、ビュー、レポートは、想定どおりに機能し続けます。

TM1 Web の各バージョンに対する更新は累積更新です。以前のリリースの新機能については、1 ページの『第 1 章 TM1 Web の新機能』を参照してください。



2.0.55 - 機能更新、2020 年 7 月 16 日IBM Planning Analytics TM1 Web は 2020 年 7 月 16 日に更新され、以下の機能と注記が組み込まれました。TM1 Web の各バージョンに対する更新は累積的なものです。以前のリリースの新機能については、1 ページの『第 1 章 TM1 Web の新機能』を参照してください。

TM1 Web の新規リリース・スケジュールIBM Planning Analytics の 2.0.55 SC リリース以降、新しいバージョンの TM1 Web は、より頻繁なスケジュールでリリースされます。新しいバージョンは、IBM Planning Analytics Workspace および IBMPlanning Analytics for Microsoft Excel のリリース・スケジュールと同様、およそ毎月 1 回リリースされます。TM1 Web は、Planning Analytics の 2.0.x LC リリースに含まれなくなりました。

TM1 Web の新規インストーラーIBM Planning Analytics の 2.0.9.2 LC/2.0.55 SC リリース以降、TM1 Web は、IBM Planning AnalyticsSpreadsheet Services インストーラーを使用してインストールされます。TM1 Web は、Planning AnalyticsLocal インストーラー内の Web 層の一部ではなくなりました。IBM Planning Analytics Spreadsheet Services インストーラーを使用した TM1 Web のインストールの詳細については、Planning Analytics TM1 Web のインストールと構成を参照してください。

2.0.9 - 機能更新、2019 年 12 月 16 日IBM Planning Analytics Local バージョン 2.0.9 およびクラウド専用リリースである IBM PlanningAnalytics バージョン 2.0.9 には、TM1 Web 用に以下の更新が含まれています。

Web シートで動的な形状とイメージを使用するWeb シートをカスタマイズします。TM1 Web では、セルの値が変わったときにイメージを変更する Webシート内の任意の場所に、形状やイメージを動的に挿入できます。ロゴ、従業員の写真、国旗、製品画像などを動的に挿入できます。動的イメージを作成するには、INDIRECT または INDEX ベースの数式を含む名前付き範囲をイメージ・オブジェクトに割り当てます。数式はセル参照に解決され、イメージがそのセルに固定されている場合、動的な形状はそのイメージ・オブジェクトのコンテンツを反映します。この機能をサポートするために、TM1 Web は割り当てられた数式を保持し、再計算時に、TM1 Web が名前付き範囲の数式をセル参照に評価します。TM1 Web は、このセル参照を使用して、イメージ・オブジェクトのファイル名を更新し、参照先のイメージと一致させることができます。

複数タブの Web シートの保存時にアクティブだったタブで Web シートを開くブック内に複数のタブを持つ Web シートがある場合、ブックを保存するときに、Planning AnalyticsWorkspace は Web シートのアクティブなタブを追跡します。その後、Planning Analytics Workspace でそのブックを開くと、作業を中断したときの状態が表示されます。


https://www.ibm.com/support/knowledgecenter/SSD29G_2.0.0/com.ibm.swg.ba.cognos.tm1_inst.2.0.0.doc/c_tm1web_sc_installation.html

Planning Analytics バージョン 2.0.9 および Planning Analytics Workspace バージョン 2.0.46 を使用して、Planning Analytics Workspace で Web シートを含むブックを開くと、Web シートを保存したときにアクティブだったタブがアクティブになります。注 : IBM Planning Analytics TM1 Web で Web シートのこの機能を利用するには、IBM Planning Analytics バージョン 2.0.9 で Planning Analytics Workspace を使用する必要があります。Planning Analytics バージョン 2.0.9 がインストールされていない場合、Planning Analytics Workspace でブックを開くと、Web シートの発行時 (TM1 Perspectives または Planning Analytics for Microsoft Excel を使用) のデフォルトのタブがアクティブになります。


TM1 Web ログにユーザー名とメモリー使用量を含める TM1 Web ログに、ユーザー名とメモリー使用量が含まれます。この更新により、レンダリングする行が多すぎるアクティブ・フォーム、ブック、またはキューブをユーザーが実行した場合に、簡単に確認できるようになりました。このオプションのロギングをオンにするには、¥tm1_64¥webapps¥tm1web¥WEB-INF¥configuration¥log4j.properties ファイルで log4j.logger.com.ibm.cognos.tm1 のロギング・レベルを DEBUG に設定する必要があります。監査ログを確認して、レンダリングの行数を減らすことができます。ログには以下の情報が含まれます。• タイム・スタンプ• アプリケーションとアクティブ・フォームの名前• 生成された行の数• ユーザー名• Web シートのレンダリング後の現在のヒープ・メモリーアクティブ・フォームを開いたときのログの例"<TIMESTAMP>:CLASSNAME:Constructed view for <ActiveFormViewid> contains <#> rows, by user '<username>'. <TIMESTAMP>:CLASSNAME:Current heap memory usage: <MB>".

ブックを開いたときのログの例"<TIMESTAMP>:CLASSNAME:Creating WorkbookMetaData for <sheet name>, by user '<username>'. <TIMESTAMP>:CLASSNAME:Current heap memory usage: <MB>".


キューブ・ビューを開いたときのログの例"<TIMESTAMP>:CLASSNAME:Exit from getUpdatedCubeViewData, updatedData: class name, username: <username>. <TIMESTAMP>:CLASSNAME:Current heap memory usage: <MB>".

TM1 Application Web に自動的に保存される変更 Planning Analytics バージョン 2.0.8 では、IBM TM1 Application Web の「保存」確認ダイアログ・ボッ

クスが削除されました。ビューを閉じるときに、変更を保存するように求められません。アプリケーションを閉じると、すべてのデータ変更が自動的に保存されます。アプリケーションを再度開くと、変更が反映されます。この変更はすべての Web ブラウザーに適用されます。

TM1 Web URL API を Cognos Analytics セキュリティーとともに使用してログオンを構成する

Planning Analytics バージョン 2.0.8 では、tm1web_config.xml ファイルで新しいパラメーターCSPHeaderFrameSource を使用できます。統合セキュリティー・モード 5 (Cognos® Analytics セキュリティー認証) を使用して構成された TM1 Web URL API を使用する場合は、ユーザーがログオンできるようにこのパラメーターを設定する必要があります。このパラメーターは、TM1 Web URL API が使用する<frame> 要素にロードされるコンテキストのセキュリティーを制御します。CSPHeaderFrameSourceパラメーターは、Content-Security-Policy (CSP) frame-src ポリシーで許可されるソースを定義します。

構文<add key="CSPHeaderFrameSource" value="" />

CSPHeaderFrameSource が指定されている場合、frame-src ポリシーの許可されたソースを設定します。値が空白のままであるか、パラメーターが設定されていない場合、デフォルト値は「*」であり、すべてのソースからコンテンツがロードされます。要確認 : IBM Planning Analytics Local バージョン 2.0.8 では、tm1web_config.xml.new という名前の新しいバージョンの tm1web_config.xml ファイルをインストールします。既存の tm1web_config.xmlファイルは保持されます。このリリースに適用された修正を利用するためには、tm1web_config.xml.new ファイルを tm1web_config.xml に名前変更し、これまで構成設定に行ったすべての変更を再適用する必要があります。例<add key="CSPHeaderFrameSource" value="'self'" />

frame-src ポリシーを「self」に設定します。サイトの起点からコンテンツをロードできるようになります。例<add key="CSPHeaderFrameSource" value="http://CAM_HOST:CAM_PORT http://TM1WEB_HOST:TM1WEB_PORT" />

frame-src ポリシーを http://CAM_HOST:CAM_PORT http://TM1WEB_HOST:TM1WEB_PORT に設定します。CAM_HOST:PORT および TM1WEB_HOST:PORT からコンテンツをロードできるようになります。

次の作業frame-src のソースを定義する方法について詳しくは、MDN web docs サイトの Sources を参照してください。


https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Security-Policy/frame-src#Sources

TM1 Web Web シートのリレーショナル・データ・ソースが削除されました v2.0.8 で削除 TM1 Web でリレーショナル・データ・ソースを使用する機能は、IBM Planning Analytics

Local バージョン 2.0.8 で削除されました。IBM Data Server Driver for JDBC and SQLJ 4.17 (10.5.0.2) もインストール・キット (db2cc4.jar、ojdbc6.jar、sqlj4.zip、sqljdbc4.jar) から削除されました。Planning Analytics バージョン 2.0.7 は、TM1 Web Web シートのリレーショナル・データ・ソースをサポートする最後のリリースです。


TM1 Web での Web シートのロードの高速化TM1 Web で Web シートのロードを最適化するために、新しい機能フラグOptimizeCssForHiddenContent を設定することができます。機能フラグは、tm1_64¥webapps¥tm1web¥WEB-INF¥configuration¥features.json で追加できます。OptimizeCssForHiddenContent が true に設定されている場合、非表示のコンテンツ (シート、行、列、セル、またはコントロール) からの CSS スタイル情報は、Web シートの読み込み時に除外されます。OptimizeCssForHiddenContent はデフォルトで、false に設定されます。例{ "NestedDbsEvaluation": false, "NewIrrAlgorithm": false , "OptimizeCssForHiddenContent": true}

TM1 Web での IFERROR Excel 関数の使用IBM Planning Analytics TM1 Web の Web シートで IFERROR 関数がサポートされるようになりました。IFERROR 関数は数式内のエラーをトラップし、エラーが検出されたときにテキストなどの代替結果を返します。

TM1 Web Web シートでの改善されたセル書式設定の利用TM1 Web Web シートの通貨、分数、電話番号、および社会保障番号のセルの書式設定が改善されました。Web シートのセルの書式設定に次の変更が加えられました。• 15 桁を超える数字の場合、Web シートのセルの数字が最初の 15 桁に切り上げられます。例えば、「123456789123456992.00」は「123456789123457000.00」と表示されます。 Excel では、最初の

15 桁のみが保存され、残りの桁はゼロに置き換えられます。例えば、「123456789123456992.00」は「123456789123456000.00」と表示されます。

• 通貨は、$ 記号の後にスペースなしで表示されます。負の通貨もドル記号の後にスペースなしで表示されます。例えば、「$99.00」、「-$999.00」と表示されます。


• 分数は、整数と分数の間にスペースを入れた分数形式「# ??/??」で表示されるよう書式設定されています。数値が整数の場合、セルは整数の後にスペースなしの形式になります。

• 電話番号は、Excel の場合と同様、「(nnn) nnn-nnnn」の書式に設定されます。• 社会保障番号は、最初の 9 桁で設定されます。最初の 9 桁に続く数字はすべて切り捨てられます。例えば、「1849348202」は「184-93-4820」と表示され、最後の数字の「2」が切り捨てられます。この書式設定は Excel では異なります。 9 桁を超える数字の場合、Excel では最後の 9 桁に書式が追加されますが、先頭にある超過分の数字は変わりません。例えば Excel では、「1849348202」が「1849-34-8202」と表示されます。

TM1 Web バージョン 2.0.6 以前 TM1 Web バージョン 2.0.7 以降 Excel でのセルの書式設定

このセルの書式設定はデフォルトで、機能フラグ NewDataFormatter によって TM1 Web Web シートで有効にされています。機能フラグは、tm1_64¥webapps¥tm1web¥WEB-INF¥configuration¥features.json で設定できます。例{ "NestedDbsEvaluation": false, "NewIrrAlgorithm": false , "NewDataFormatter": true}

更新された TM1 Web 構成のデフォルトについて以下の TM1 Web 構成パラメーターのデフォルト設定が新しくなりました。これらの設定は、以前は推奨の設定でした。現在は、TM1 Web を新規インストールする場合の tm1web_config.xml ファイルのデフォルトの設定になりました。注 : クラウド上の Planning Analytics のデフォルト構成パラメーター値のいくつかは、Planning AnalyticsLocal のものと異なります。ExportCellsThreshold

Web シートまたはキューブ・ビューのエクスポートに含めることができるセルの最大数を指定します。デフォルトはブランクから 1000000 に変更されました。

MaximumConcurrentExportsTM1 Web から同時実行できるエクスポートの最大数を指定します。クラウド上の Planning Analytics のデフォルト値は 3 に設定されています。このデフォルト値は変更されていません。Planning Analytics Local のデフォルト値は 5 から 4 に変更されています。

MaximumSheetsForExportエクスポートを許可するシートの最大数を指定します。デフォルトは 100 から 50 に変更されました。


WorkbookMaxCellCountブックの最大セル数を、桁区切り記号なしの数値で指定します。デフォルトは -1 から 500000 に変更されました。

詳しくは、 TM1 Web 構成パラメーターを参照してください。TM1 Web Web シートでのリレーショナル・データ・ソースの非推奨化

非推奨 Planning Analytics バージョン 2.0.7 は、TM1 Web Web シートでリレーショナル・データ・ソースがサポートされている最後のバージョンです。

2.0.6 - 機能更新、2018 年 10 月 11 日IBM Planning Analytics Local バージョン 2.0.6 およびクラウド専用リリースである IBM PlanningAnalytics バージョン 2.0.6 には、TM1 Web 用に以下の機能が含まれています。

TM1 Web のセッション・タイムアウトを構成する新規パラメーターIBM Planning Analytics Local バージョン 2.0.6 では、tm1web_config.xml ファイルにHttpSessionTimeout という新規パラメーターがあります。このパラメーターは、TM1 Web の HTTP セッションのセッション・タイムアウト (分数) を定義します。HttpSessionTimeout パラメーターが指定されていない (欠落しているかブランクである) 場合、または値が 1 より小さいか数値ではない場合は、web.xml ファイルに定義されているデフォルトの session-timeout が使用されます。重要 : IBM Planning Analytics Local バージョン 2.0.6 以降では、web.xml ファイルの session-timeout値は変更しないでください。要確認 : IBM Planning Analytics Local バージョン 2.0.6 では、tm1web_config.xml.new という新規バージョンの tm1web_config.xml ファイルをインストールすると、既存の tm1web_config.xml ファイルは保持されます。このリリースに適用された修正を利用するためには、tm1web_config.xml.new ファイルを tm1web_config.xml に名前変更し、これまで構成設定に行ったすべての変更を再適用する必要があります。


web.xml ファイルの変更この IBM Planning Analytics Local バージョン 2.0.5 のインストールによって IBM Planning Analytics TM1Web をアップグレードする場合は、web.xml.new という名前の新しいバージョンの web.xml ファイルをインストールします。既存の web.xml ファイルは保持されます。このリリースで適用された修正を活用するためには、web.xml.new ファイルを使用し、これまで構成設定に加えていた変更内容を再び適用する必要があります。特に、session-timeout の値を復元してください。1. <PA インストール場所>/webapps/tm1web/WEB-INF にある既存の web.xml ファイルをバックアップします。例えば、web.xml の名前を web.xml.old に変更します。この手順により、現在の設定がバックアップされます。

2. web.xml.new の名前を web.xml に変更します。この手順では、IBM Planning Analytics Local バージョン 2.0.5 に付属する新しいバージョンの web.xml を使用します。

3. web.xml の session-timeout の入力値を web.xml.old の入力値に置き換えます。この手順により、これまでこのプロパティーに加えていた変更内容が復元されます。


https://www.ibm.com/support/knowledgecenter/SSD29G_2.0.0/com.ibm.swg.ba.cognos.tm1_inst.2.0.0.doc/c_tm1web_cfg_params_v10r2.html#c_tm1web_cfg_params_v10r2/id_workbookmaxcellcount

以下に例を挙げます。<session-config> <session-timeout>20</session-timeout></session-config>

PDF へのエクスポートWeb シートを PDF にエクスポートするときには印刷域情報が使用されます。ワークシートに印刷域を定義した場合、その範囲内のデータのみが PDF にエクスポートされます。この動作は Excel から印刷する場合と同じです。


TM1 Web での現在の TM1 データベース・ラベルの表示TM1DatabaseLabel パラメーターは、バナーのユーザー名の横に TM1 データベース・ラベルを表示します。詳しくは、TM1DatabaseLabel パラメーターおよび TM1 Web 構成パラメーターを参照してください。

ブックの最大セル数の指定WorkbookMaxCellCount パラメーターは、ブックの最大セル数を、桁区切り記号なしの数値として指定します。 WorkbookMaxCellCount を使用して、多くのセルを含むブックを開くときの問題を回避できます。詳しくは、TM1 Web 構成パラメーターを参照してください。

Web シートからエクスポートできるセルの数を制限するExportCellsThreshold パラメーターは、Web シートまたはキューブ・ビューのエクスポートに含めることができるセルの最大数を指定します。選択したセルの数がしきい値を超える場合は、警告メッセージが表示され、エクスポートは開始されません。詳しくは、TM1 Web 構成パラメーターを参照してください。

Cube Viewer でのディメンションの非表示CubeViewerHiddenDimensionsEnabled パラメーターを使用して、TM1 Web Cube Viewer でディメンションを非表示にすることができます。詳しくは、TM1 Web 構成パラメーターを参照してください。

累加縦棒グラフのサポートTM1 Web は、Web シートで Excel ベースの累加縦棒グラフをサポートします。これらのグラフは、Microsoft Excel 2016 でリリースされています。

2.0.0 - 機能更新、2016 年 12 月 16 日IBM Planning Analytics Local バージョン 2.0.0 には、IBM Planning Analytics on Cloud 用に TM1 Web10.3.0 で導入されたすべての機能が含まれています。IBM Planning Analytics Local バージョン 2.0.0 では、次の機能が導入されました。これらの機能について詳しくは、IBM Knowledge Center にある TM1 Web の資料を参照してください。

TM1 Web の階層TM1 Web シートでは、1 つのディメンションに複数の階層を表示できます。


https://www.ibm.com/support/knowledgecenter/SSD29G_2.0.0/com.ibm.swg.ba.cognos.tm1_inst.2.0.0.doc/r_tm1databaselabelparameter.html

https://www.ibm.com/support/knowledgecenter/SSD29G_2.0.0/com.ibm.swg.ba.cognos.tm1_inst.2.0.0.doc/c_tm1web_cfg_params_v10r2.html





注 : TM1 Web では、階層を表示することはできますが、階層を作成することはできません。階層は、Planning Analytics Workspace で作成する必要があります。詳しくは、IBM Knowledge Center の PlanningAnalytics Workspace を参照してください。IBM Planning Analytics for Microsoft Excel のクイック・レポートを使用して階層を開くことができます。クイック・レポート (旧称はフレックス・ビュー) は、ライブ Web シートとして公開されます。ライブ Webシートは、TM1 サーバーへの接続を維持します。サーバーのデータが変更された場合、ライブ Web シートにその変更が反映されます。クイック・レポートについて詳しくは、IBM Knowledge Center の Planning Analytics for Microsoft Excel を参照してください。注 : 相対比例配分および相対割合調整は、TM1 Web で開いたクイック・レポートではサポートされません。

TM1 Web API の拡張機能TM1 Web API には、以下の新しい機能があります。• IBM Planning Analytics Local バージョン 2.0.0 以降、TM1 Web の JavaScript ライブラリー・モジュールをロードするために、TM1 Web に付属する Dojo バージョンを使用する必要はなくなりました。TM1Web の JavaScript ライブラリー・モジュールは、Dojo バージョン 1.7 以降の AMD ローダーを使用してロードできるようになりました。

• JavaScript ライブラリーを使用するために必要な HTML の <head> タグと <body> タグがシンプルになりました。

• JavaScript ライブラリーの tm1web/api/session/session モジュールを使用して、ユーザーは、ログオンしたり、セッション・トークンに基づいてセッション情報を取り出したり、セッション・トークンに基づいてセッションを破棄したりできます。

• JavaScript ライブラリーの tm1web/api/session/LoginDialog モジュールを使用して、ユーザーはログオン・ダイアログ・ボックスを表示/破棄することができます。

• JavaScript ライブラリーの tm1web/api/Workbook クラスは、アクション・ボタンが実行された後に実行情報を公開します。 onActionButtonExecution メソッド API を使用して、ユーザーは、アクション・ボタンがクリックされたときに、既存のワークブックを置換したり新規のものを作成したりできます。

• tm1web/api/Workbook クラスおよび tm1web/api/CubeViewer クラスには、 subset およびsubsets のセット・プロパティーおよびメソッドが含まれています。詳しくは、「TM1 for Developers」の資料の『TM1 Web API』を参照してください。

リレーショナル Web シートTM1 Web では、TM1 データと同じ Web シート上にリレーショナル・データを表示できるようになりました。 Excel ファイルにリレーショナル・クエリーを定義し、そのファイルを TM1 Web にアップロードして、それらの結果を同じ Web シートまたはタブ上に表示できます。これにより、OLAP データとリレーショナル・データを一緒にレポートの対象にすることができます。詳しくは、IBM Knowledge Center の Web シートでのリレーショナル・データの操作 (https://www.ibm.com/support/knowledgecenter/SSD29G_2.0.0/com.ibm.swg.ba.cognos.tm1_ug.2.0.0.doc/c_relational_data_websheets.html) を参照してください。

TM1 Web のアクセシビリティーTM1 Web には、キーボードだけを使用して作業を行えるようにユーザー補助機能が組み込まれています。例えば、Web シートに関連したメニューやダイアログ・ボックスへのキーボード・ナビゲーションやキーボード・アクセスなどの機能があります。• コンテキスト・メニューにアクセスするときには、Shift + F10 を使用します。コンテキスト・メニューでは、上矢印キーと下矢印キーによって項目を選択できます。

• Web シート内の行の展開表示/省略表示を切り替えるには、スペース・バーを使用します。




https://www.ibm.com/support/knowledgecenter/SSD29G_2.0.0/com.ibm.swg.ba.cognos.tm1_ug.2.0.0.doc/c_relational_data_websheets.html

• セット・セレクターにアクセスする場合は、スペース・バーを使用できます。検索と矢印キーとツリーの間を移動するときには、Tab キーを使用します。ツリー内で項目間を移動するときには、上矢印キーと下矢印キーを使用します。ツリー内でフォーカスがある項目を選択するときには、Enter キーを使用します。注 : セット・セレクターにアクセスして変更を加えた後に Esc を押して終了すると、元のセルのフォーカスは失われます。フォーカスはメインページに移ります。

ブックでの Excel 図形のサポートExcel の図形 (基本図形、矢印、バナー、等式図形、線など) を、TM1 Web のブックに追加することができます。サポート対象およびサポート対象外の Excel 図形のリストについては、List of Microsoft Excel-supported functionality by menu in IBM TM1 Web version 10.2.2 and later を参照してください。

TM1 Web のシングル・サインオン統合ログオン (Kerberos) およびアプリケーション・サーバーのセキュリティー層を使用して、 IBM TM1Web のシングル・サインオンを設定できます。シングル・サインオンにより、HTTP ユーザーの TM1 Webへのログオンを一度だけにすることができます。詳しくは、「Planning Analytics インストールおよび設定」の資料の『Kerberos と SPNEGO を使用した TM1Web の統合ログオンの設定』を参照してください。

TM1 ワークシート関数以下のワークシート関数が導入されました。TM1ELLIST単一の式を使用して、TM1 モデルから要素値のセットを返します。

TM1GLOBALSANDBOXツールバーから選択された現在のグローバル・アクティブ・サンドボックスを返します。

TM1INFO現在の TM1 のバージョンとクライアントに関する情報を戻します。

TM1PRIMARYDBユーザーの認証に使用された 1 次 TM1 サーバーの名前を返します (ユーザーが複数の TM1 サーバーに暗黙的にログオンしている場合も同様)。


http://www.ibm.com/support/docview.wss?uid=swg27042154



第 2 章 TM1 Web の概要IBM TM1 Web は、さまざまなタスクを Web ブラウザーで実行できるようにして IBM Planning Analytics の分析能力を拡張したものです。TM1 Web を使用すると、以下を行うことができます。• キューブ・データを分析する。• 書式を設定した Excel レポートにデータを表示および編集する。• データをドリル、ピボット、選択、フィルターする。• キューブ・データからグラフを作成する。• いくつかの IBM TM1 サーバー管理タスクを実行する。注 : IBM Planning Analytics Workspace は、TM1 データを分析するための次世代の Web ベース・インターフェースであり、コンテンツの計画、作成、および分析を行えます。 Planning Analytics Workspace は、TM1 Web、TM1 Perspectives、および TM1 Architect の機能と分析を組み合わせたものです。詳しくは、IBM Knowledge Center で Planning Analytics Workspace の資料を参照してください。

TM1 Web の開始以下の手順で、IBM TM1 Web にログオンできます。1.インターネット・ブラウザーを起動します。2. TM1 Web 管理者から入手した URL を以下の形式で入力します。http://machine_name:port_number/tm1web/

ここで：machine_name

TM1 Web ページを提供するために使用する Web サーバーの名前。port_number

Web サーバーのポート番号。例: http://localhost:9510/tm1web/

TM1 Web のログオン・ページが表示されます。3.ログオン情報を入力します。管理ホストネットワーク上のアクティブな TM1 サーバーを見つけるために使用する TM1 管理ホストの名前。

TM1 サーバーTM1 Web からアクセスする TM1 サーバーの名前。下矢印をクリックして、ネットワーク上に存在するいずれかの TM1 サーバーを選択してください。「更新」をクリックして、ネットワーク上で使用可能なサーバーのリストを更新します。注 : TM1s.config ファイルの AdminSvrSSLCertID パラメーターが正しく構成されていないと、サーバー・メニューが空になる場合があります。詳しくは、「Planning Analytics Local インストールおよび設定」資料の『SSL を使用する TM1 サーバーの設定』を参照してください。

ユーザー名選択した TM1 サーバーで使用するユーザー名。

パスワード選択した TM1 サーバーで使用するパスワード。

4.「ログオン」をクリックします。TM1 Web のメインページが表示されます。


TM1 Web の使用TM1 Web のメインページには、左側にナビゲーション・ウィンドウ、右側にコンテンツ・ウィンドウがあります。

ナビゲーション・ウィンドウナビゲーション・ウィンドウには、アプリケーションおよびビューが表示されます。• アプリケーション TM1 Web からアクセスできるアプリケーションのリストが表示されます。これらのアプリケーションには、TM1 の Web シート、キューブ、ビューへのショートカットが含まれていることがあります。

• ビュー TM1 サーバーにあるキューブとビューのリストが表示されます。TM1 Web では、ブラウザーの「戻る」ボタンと「進む」ボタンを使用できません。ナビゲーション・ウィンドウに用意されているコントロールを使用して、一貫性のあるデータ・ビューを維持してください。

「内容」ウィンドウ「内容」ウィンドウには、開いているキューブ・ビューと Web シートが表示されます。各オブジェクトを開くと、それぞれ別のタブに表示されます。

データの参照タスクと分析タスクTM1 Web には、TM1 の Web シート、キューブ・ビュー、グラフ、サブセットを操作するためのツールが用意されています。詳しくは、以下のトピックを参照してください。•『Web シートの処理』では、Web シートの表示、編集、エクスポートの方法が説明されています。• TM1 Web Cube Viewer の操作では、キューブ・ビューの表示、編集、構成、エクスポート、データ変更の確認と保存、新しいビューの作成の方法が説明されています。

•『グラフの操作』では、TM1 Web キューブ・ビューでのグラフの使用方法、グラフ・プロパティーの変更方法、グラフ内の集約値の展開/省略方法、グラフのドリル方法が詳しく説明されています。

• TM1 Web でのサブセットの編集では、TM1 Web サブセット・エディターによって、分析対象データを決定する要素リストを作成および管理する方法が説明されています。

管理者タスクTM1 Web 管理者は、アプリケーションの管理タスクと構成タスクを実行できます。以下に例を挙げます。• 現在のユーザーのパスワードを変更します。• TM1 Web のカスタム・ホーム・ページを構成します。• TM1 Web 構成パラメーターを変更します。• TM1 Web のログ・ファイルを使用して、TM1 Web のアクティビティーやエラーをモニターします。詳しくは、「TM1 Operations」の資料の『IBM TM1 Web の管理』を参照してください。

Apple iPad から TM1 Web へのアクセスApple iPad から TM1 Web にアクセスすることができます。他のモバイル・デバイスでは TM1 Web はサポートされていません。iPad から TM1 Web にログオンする場合は、以下の制限が適用されます。


•「管理ホスト」のラベルと著作権の内容を表示するには、TM1 Web ログオン画面を縦長モードで使用する必要があります。

• iPad では、ピンチして Web シートをズームインまたはズームアウトすることはできません。• タッチ・ジェスチャーを使用してサブセット・エディター内をスクロールした場合、サブセット・エディター内がスクロールされずに、TM1 Web ページがスクロールされます。

•「内容」ウィンドウにツールバーが一部しか表示されない場合がありますが、タッチ・ジェスチャーを使用してツールバーの右側にスクロールすることはできません。ツールバーをすべて表示するには、ナビゲーション・ウィンドウを省略表示してください。

• ダイアログ・ボックスの右下のサイズ変更ハンドルをタッチ・ジェスチャーで使用してダイアログ・ボックスのサイズを変更することはできません。ダイアログ・ボックスのサイズを変更するには、iPad を縦長モードまたは横長モードに回転してください。

• iPad にないフォントのテンプレートを使用して IBM Planning Analytics for Microsoft Excel で Web シートを作成した場合、TM1 Web で Web シートを開くと、フォントがデフォルトの Times New Roman に変更されることがあります。

ユーザー補助機能視覚に障害のあるユーザーは、スクリーン・リーダー・ソフトウェアとデジタル音声合成器を使用して、TM1 Web の画面の表示を読み上げることができます。 TM1 Web には、キーボードだけを使用して作業を行えるようにするユーザー補助機能も組み込まれています。例えば、Web シートに関連したメニューやダイアログ・ボックスへのキーボード・ナビゲーションやキーボード・アクセスなどの機能があります。• TM1 Web ログオン・ページのすべてのフィールドに Tab キーで移動できます。下矢印を使用して、「TM1サーバー」メニューを表示できます。下矢印キーと上矢印キーを使用して、メニュー内をナビゲートできます。スペース・バーを使用して、メニューを選択できます。スペース・バーまたは Enter キーを使用して、選択項目のリフレッシュ、チェック・ボックスの選択と選択解除を行えます。スペース・バーまたは Enter キーを使用してボタンをクリックすることができます。

• バナーでは、Tab キーを使用して「製品情報」要素に移動できます。 Enter キーを押して、「製品情報」ダイアログ・ボックスを開くことができます。 Tab キーで X に移動し、Enter キーを使用して「製品情報」ダイアログ・ボックスを閉じられます。バナーでは、Tab キーで「ヘルプ」や「ログアウト」に移動することもできます。 Enter キーを押して、新しいタブでヘルプ文書を開いたり、ログアウトしたりできます。

•「ナビゲーション」ウィンドウでは、スペース・バーでノードを選択、右矢印でノードを展開表示、左矢印でノードを省略表示、上矢印と下矢印でノード間の移動を行えます。

• ツールバーでは、右矢印と左矢印を使用して要素間を移動できます。スペース・バーを使用してボタンをクリックすることができます。トグル・ボタンがフォーカスされている状態では、スペース・バーを使用してボタンを有効または無効にできます。コピー機能と貼り付け機能はツールバーからは利用できませんが、セル内のコンテキスト・メニューからコピーと貼り付けを行うことができます。ツールバーの他のすべての操作は、スペース・バーを押すことで起動できます。

• コンテンツ・ペインでは、Shift + F10 を使用してコンテキスト・メニューにアクセスします。コンテキスト・メニューでは、上矢印キーと下矢印キーによって項目を選択できます。

• Web シート内の列や行を展開したり折りたたんだりする場合は、スペース・バーを使用できます。• サブセット・エディターにアクセスするには、矢印キーを使用して要素セレクターを持つセルに移動してから、スペース・バーを使用してその要素セレクターを開くことができます。検索と矢印キーとツリーの間を移動するときには、Tab キーを使用します。Tab キーを使用して要素セレクターの下部にある「サブセット・エディターを開く」アイコンに移動し、スペース・バーを押してサブセット・エディターを開きます。

• サブセット・エディター内では、上矢印キーと下矢印キーを使用してツリー内の項目間を移動します。ツリー内でフォーカスがある項目を選択するときには、Enter キーを使用します。ツリー内の複数の要素を選択することもできます。1.選択する最初の要素に移動します。2. Enter キーを押します。

第 2 章 TM1 Web の概要 17

3.下矢印を押して、選択する最後の項目まで移動します。4. Shift + Enter を押します。

• 警告、エラー、および情報の各ダイアログ・ボックスでは、Tab キーを使用してボタン間を移動できます。 Insert + B を使用してダイアログ・ボックスの内容を読み上げることができます。

• 他のダイアログ・ボックスでは、Tab キーを使用して前方に移動し、Shift + Tab キーを使用して後方に移動できます。上矢印と下矢印でラジオ・ボタンの間を移動し、スペース・バーでチェック・ボックスの選択と選択解除を行えます。スペース・バーまたは Enter キーを使用してボタンをクリックすることができます。注 : セット・セレクターにアクセスして変更を加えた後に Esc を押して終了すると、元のセルのフォーカスは失われます。フォーカスはメインページに移ります。アクセシビリティーに対する IBM のコミットメントについて詳しくは、IBM Human Ability andAccessibility Center (http://www.ibm.com/able) を参照してください。


http://www.ibm.com/able

http://www.ibm.com/able

第 3 章 Web シートの処理このセクションでは、Web シートの使用方法について説明します。

Web シートの概要Web シートは、IBM TM1 データを含む Microsoft Excel ワークシート (.xls ファイル) であり、Web ブラウザーで表示できます。 Excel ワークシートを IBM ソフトウェアからアプリケーション・フォルダーに発行すると、他のユーザーがワークシートを Web ブラウザーで表示できるようになります。Web シートでは、以下のタスクを実行できます。• 書き込みアクセス権限のあるセルにデータを入力できます。 IBM Web クライアントは書き込み可能なセルを検出できないので、Web シートにデータを入力するには、ご使用のデータについてのある程度の知識が必要です。詳しくは、24 ページの『Web シートのデータの編集』を参照してください。

• データ・スプレッド配分を使用して、Web シートに多数の値を一度に入力したり変更したりできます。配分はしばしば、シナリオのテスト、および予算業務やファイナンシャル・プランニングのプロセス中のWhat-if 分析に使用されます。

• 関連テーブルまたは他のキューブをドリル。Web に発行したスライスに、ドリルスルー・ルールが定義されたセルが含まれている場合は、そのドリル機能を Web シートから使用可能です。

• Excel チャートの表示。Web に発行したスライスにグラフが含まれている場合は、そのグラフが Web シートに表示されます。グラフの作成元のスライスにドリルスルー・ルールが定義されている場合は、Webシートのグラフから関連情報にドリルスルーできます。

• サブセット・エディター内のタイトル要素のサブセットを操作。• 代替階層を表示できます。TM1 Web シートで階層を表示することはできますが、Web シートで階層を作成したり、管理したりすることはできません。

Web シートでは、以下の Microsoft Excel ActiveX コントロールを使用できます。• チェック・ボックス• コンボ・ボックス• リスト・ボックス• ラジオ・ボタン• テキスト・ボックス• ラベル斜め罫線は、TM1 Web シートでは使用できません。複数の TM1 データベースからのデータを 1 つの Web シートに取得できます。複数のデータベースを 1 つの Web シートで正常に参照するには、以下の点に注意してください。• 複数のデータベースを参照できるのは、VIEW 関数を使用してデータを取得するレポートのみです。特に、カスタム・レポートと動的レポートは、VIEW 関数を使用してデータを取得します。

• データベース名は静的である必要があります。算出されたデータベース名はサポートされていません• すべてのデータベースは、同じ認証モードを使用するように設定されている必要があります• ユーザーはデータベース間で共通の資格情報を持っている必要があります

Web シートと Excel ワークシートの違いTM1 Web シートと Excel ワークシートの間には、いくつかの違いがあります。斜め罫線斜め罫線は、TM1 Web シートでは使用できません。


グリッド線Excel ワークシートでグリッド線を表示した場合、TM1 Web シートでもグリッド線が表示されますが、背景色 (セルの網掛け) が以下の場合は例外です。• Excel でグリッド線を有効にし、背景色をワークシート全体に適用した場合、Excel でも対応する Webシートでもグリッド線は表示されません。

• Excel でグリッド線を有効にし、背景色をワークシートのセルの一定範囲にのみ適用した場合、Excelではその範囲のセルのグリッド線が非表示になりますが、対応する Web シートでは表示されたままです。

Web シートに継承される Excel 機能Web シートは、Excel 機能のサブセットを継承します。以下の Excel 機能が Web シートに継承されます。• 列の非表示• 条件付き書式• ハイパーリンクのサポート• ウィンドウ枠の固定• セル保護 (パスワード保護でない)

列の非表示Excel ワークシートで列を非表示にすると、それらの列は Web シート上でも非表示になります。 TM1 Webは、Web シート上での表示/非表示にかかわりなくデータ・セルを計算します。計算を含む非表示セルが多い場合、Web シートのパフォーマンスが予想より遅くなる可能性があります。条件付き書式TM1 Web は、Excel の条件付き書式 (カラー・スケールやアイコン・セットの条件付き書式など) に対応しています。アイコン・セット条件付き書式アイコン・セット条件付き書式では、各アイコンが値の範囲を表します。カラー・アイコンを使用する場合は、アイコンの色によってグリッド内での値の比較結果が表されます。小さい値が赤、中間の値が黄色、大きい値が緑です。

カラー・スケール条件付き書式カラー・スケール条件付き書式では、グリッド全体の値に応じて、2 色または 3 色の階調で色に陰影がつけられます。

注 : アイコン・セットまたはカラー・スケールの条件付き書式をアクティブ・フォームで使用する場合は、1 行ずつ書式を設定してください。そうしないと、意味を成さない結果になることがあります。反復ネスト行の条件付き書式の使用IBM TM1 Web での反復ネスト行のラベルはブランクのままです。Microsoft Excel では、反復ラベルのテキスト・フォントは背景色と同じ色になるので見えません。TM1 Web の Web シートでは、反復セルはマージされます。ワークシート内の非表示テキストを表示するには、外部行の条件付き書式を使用してデフォルト設定をオーバーライドすることで、フォントの色を変更します。非表示テキストをオーバーライドするためのこの方法は、Excel でも TM1 Web の Web シートでも使用できます。

手順1.「条件付き表示形式」>「規則の新規作成」を選択します。2.「数式を使用して、書式設定するセルを決定」を選択します。3.「次の数式を満たす場合に値を書式設定」フィールドに、=1=1 と入力します。


4.「書式」をクリックし、非表示テキストをどのように表示するかを選択します。ハイパーリンクMicrosoft Excel のハイパーリンクの一部は、Web シートでも機能します。• 現在のブック内の他のセル• 現在のブックに定義されている名前付きの範囲• 現在のブック内のブックマーク• FTP または Web サイトの URL• 他の Excel ブック。リンク先のブックは、ネットワーク上のファイル、または TM1 サーバーにアップロードされたファイルにすることができます。リンク先のブックがネットワーク上のファイルである場合は、次の汎用命名規則 (UNC) の形式を使用したターゲット・ファイルの完全なネットワーク・パスがハイパーリンクに含まれていなければなりません。\\ComputerName\SharedFolder\FileName

以下に例を挙げます。\\sytem123\MyReports\hyperlink_target.xls

TM1 サーバーにアップロードされたファイルをハイパーリンクで参照する場合は、TM1 で割り当てられたファイル名を使用する必要があります。詳しくは、TM1 Developer の資料を参照してください。ウィンドウ枠の固定Excel ワークシートでウィンドウ枠を固定した場合は、Web シートもウィンドウ枠の固定を継承します。Web シートを縦方向または横方向にスクロールしても、固定した行または列が表示されます。このワークシートを縦にスクロールすると、固定されたウィンドウ枠の行は動きませんが、ワークシートの下の部分はスクロールされます。ClearType を使用して Web シートの表示とレンダリング機能を高めるWeb シートの表示を向上させるためには (特にセルの中でテキストが折り返されている固定ウィンドウと非固定ウィンドウが両方とも存在する場合は) Microsoft ClearType Tuner をインストールする方法を管理者に問い合わせてください。このツールを使用すると、TM1 Web で Web シートの固定ウィンドウと非固定ウィンドウの行を同じ高さに維持できます。詳しくは、「TM1 Operations」の資料で TM1 Web の管理方法についてのセクションを参照してください。TM1 Web の幅広の列の文字列測定StringMeasurement は、Web シート・セルの内容を列に合うように調整する方法を決定する web.config パラメーターです。セルのコンテンツを表示できる幅に比べてセルが小さいという列幅の場合、StringMeasurement 設定とセルのタイプに基づいて、コンテンツがそのセルに合わせられます。すべての設定のコンテンツが調整されると、数字が間違って別の数字として読み取られないように桁が「#」文字に置き換えられます。使用可能な領域に比べて、Web シートのセルに表示されるコンテンツが少なすぎる場合は、web.config ファイルに StringMeasurement=0 を設定して従来の計算を使用できます。使用可能な領域に比べて、Web シートに表示されるコンテンツが多すぎるためにアンバランスになったりした場合は、セルのタイプに応じて 1 から 3 の設定を使用してください。

第 3 章 Web シートの処理 21

文字列測定結果0 バージョン 9.5.1 より前の方法で、文字列タイプと数字タイプのセル・コンテンツ

をどこで切り捨てるかを決定します。1 文字列セルの測定に、新しい計算を使用します。2 数字セルの測定に、新しい計算を使用します。3 数字と文字列の両方のコンテンツに、新しい計算を使用します。

セルおよびパスワード保護TM1 Web シートは、Microsoft Excel のシート保護機能を使用してセル保護に対応していますが、パスワード保護には対応していません。 Excel のシート保護機能を使用すれば、パスワードを入力しなくてもデータ入力から Web シートを保護できます。Web シートは Excel ワークブックの Web ブラウザー・バージョンであるため、TM1 Web で Web ブラウザーを使用して Web シートにアクセスしているときにワークブックの完全性とレイアウトを変更することはできません。このタイプのアクセスは、Web シートでは一般にパスワード保護が不要であることを意味します。テキスト・ボックスTM1 Web シートは、Excel で作成されたテキスト・ボックスとボックス内のテキストの配置をサポートしています。テキスト・ボックスでテキストを水平位置合わせするには、Excel の横方向の配置ボタンである、「左揃え」、「中央揃え」、または「右揃え」を使用します。テキスト・ボックス内のテキストの行数に関係なく、垂直方向の上揃えを行うには、Excel の「上揃え」ボタンを使用します。1 行に収まるテキストで垂直方向の中央揃えを行うには、Excel の「上下中央揃え」ボタンを使用します。複数行のテキストの垂直方向の中央揃えを行う場合、またはテキストの行数に関係なく垂直方向での下揃えを行う場合は、Excel の「図形の書式設定」オプションを使用して、Web シートに正しくレンダリングされるようにテキストを配置する必要があります。「縦方向の配置」を「上揃え」に設定し、「上部余白」値を調整して、テキスト・ボックスの中央にテキストを配置します。


複合 DBRW 式は TM1 Web でサポートされないTM1 Web は複合 DBRW 式をサポートしていません。複合 DBRW 式は、DBRW 関数が他の関数や数値計算と組み合わせて使用されるものです。DBRW 関数の前に負符号を置くと、-1 x (DBRW 値) として解釈され、複合式となります。DBRW 関数によって取得される値を負の値として表示する場合は、DBRW 関数を含むセルへの参照の前に負記号のあるセル参照を作成します。例えば、-A7 となります。A7 には DBRW 関数が含まれます。

Web シートの表示TM1 アプリケーション内に存在する Excel ワークシートはすべて、自動的に TM1 Web で使用できるようになります。

手順1.ブラウザーから、左側のナビゲーション・ウィンドウ内のアプリケーションをクリックします。アプリケーションに含まれている Web シートが、リストにリンクとして表示されます。アプリケーションには、キューブ、ディメンション、サブセット、およびビューなどの様々なオブジェクトへの参照を含めることができます。TM1 Web のアプリケーションには、Web シート、キューブ、およびビューのショートカットだけが表示されます。

2.ワークシートのリンクをクリックします。Web シートがブラウザーに表示されます。管理者が TM1 サーバーで翻訳名の表示を有効にした場合は、キューブ、ディメンション、要素、属性が、ユーザーの Web ブラウザーの言語設定で指定されている現地語で表示されます。翻訳が有効でない場合、オブジェクト名は、TM1 Server で最初に作成されたとおりに表示されます。Web シートでは、SUBNM 関数または TM1RptRow 関数から返される要素だけが翻訳されます。Web シートの他のすべての要素およびオブジェクト名は、最初に作成されたとおりに表示されます。

次のタスクアプリケーションの作成と管理について詳しくは、TM1 Developer の資料を参照してください。

Web シートのツールバーの使用TM1 Web ページの最上部にある Web シートのツールバーには、Web シート作業用のボタンが含まれています。次のリストでは、Web シートのツールバーのボタンについて説明します。「操作」メニュー閉じる、エクスポートする、などの Web シートの一般的なタスクにアクセスできる。

データ変更の保存現在選択されている Web シートに変更を保存する。エクスポート現在の Web シートを Microsoft Excel スライス、Excel スナップショット、または Adobe PDF ファイルにエクスポートする。データのリセットその時点までにサンドボックスに入力したすべての変更データをクリアする。すべてのデータ値をリセットし、ベース・データの現在の値に戻す。

閉じる現在選択されている Web シートを閉じる。

その他を閉じる現在選択されている Web シート以外のすべての Web シートを閉じる。


すべてを閉じるすべての Web シートを閉じる。

コミットWeb シート・データの変更を TM1 サーバーに送信する。再計算Web シート内のデータ値を編集した場合、このオプションはそのデータ変更を TM1 サーバーに送信してから Web シート内のデータを更新する。Web シート内のデータ値を編集しなかった場合、このオプションは現在の値を TM1 サーバーから取得して Web シートのデータを更新する。現在のシートを再構築Web シートに存在するアクティブ・フォームを含め、現在の Web シートを再構築する。現在のブックを再構築存在するアクティブ・フォームを含め、現在のブック内のすべての Web シート/タブを再構築する。サンドボックスサンドボックスを作成または削除する。詳しくは、64 ページの『個人用ワークスペースまたはサンドボックスの使用』を参照してください。

TM1 Web でのアクティブ・フォームアクティブ・フォームを含む Microsoft Excel ワークシートを TM1 アプリケーションに追加した場合は、対応する Web シートからアクティブ・フォームに TM1 Web でアクセスすることができます。Web シートのツールバーには、アクティブ・フォームの操作を簡単にするための次の 2 つの新しいボタンがあります。ボタン名前目的

再構築 TM1RPTVIEW 関数のフォーム定義に従ってアクティブ・フォームを再構築する。

列のサイズ変更 Web シートの列の幅を広げてすべてのセル・データを表示する。該当列を選択してボタンをクリックします。

注 : 複数の TM1 サーバーからの複数のアクティブ・フォームが存在する Excel ワークシートの場合、対応する Web シートを正常に表示するためには、すべてのサーバーでユーザー名/パスワードの組み合わせが同じである必要があります。例えば、ワークシートにサーバー A からのアクティブ・フォームが 1 つとサーバー B からのアクティブ・フォームが 1 つある場合、単一の Web シートでそれらのアクティブ・フォームを正常に表示するには、サーバー A へのアクセスに使用するユーザー名/パスワードの組み合わせと、サーバー B へのアクセスに使用するユーザー名/パスワードの組み合わせが同じである必要があります。ユーザー名とパスワードの組み合わせが、Web シートに表されるすべての TM1 サーバーで同じでない場合、Web シートには不完全なデータが表示されます。

Web シートのデータの編集Web シートのデータを編集するには、Web シートのリーフ・セルに値を直接入力して編集します。データ・スプレッドを使用して Web シートに数値を配分することもできます。注 : Microsoft Edge ブラウザーで TM1 Web を使用する場合、以下の制限に注意してください。•「コピー」および「貼り付け」オプションは、ツールバーおよびセルのショートカット・メニュー (右クリック・メニュー) では無効になっています。値をコピーする場合は CRTL+C、値を貼り付ける場合はCRTL+V を使用する必要があります。


• セルの値は Delete (削除) キーではクリアできません。選択リストのセルの値をクリアするには、選択リスト・メニューで「ブランク」オプションを選択します。通常のセルの値をクリアするには、セルまたはセルの範囲を選択してから右クリックし、「データ・スプレッド」、「クリア」を選択します。

Web シートのセルのデータ編集Web シートのリーフ・セルに対する書き込みアクセス権限がある場合は、そのセルのデータを編集できます。TM1 Web クライアントは書き込み可能なセルを検出できないので、Web シートにデータを入力するには、ご使用のデータについてのある程度の知識が必要です。

手順1.次のいずれかの方法で、セルの値を編集します。値を編集するセルの値をダブルクリックします。 TM1 Web では、セルの現行値が点滅カーソルで表示されます。点滅カーソルになっているときには、キーボードの左矢印キーと右矢印キーを使用して値の中でカーソルの位置を合わせ、既存の値を選択的に編集できます。また、Backspace キーと Delete キーを使用して、値から数字を 1 つずつ削除することもできます。

値を置換するセルの値をシングルクリックします。 TM1 Web でセルの現行値が強調表示されていれば、そのセルは編集モードになっています。その場合は、セル内の既存の値を直接上書きして、完全に置換できます。値をセルに貼り付けることも可能です。注 :

• 負の値を貼り付ける場合、その値は先頭に負符号の付いた形式になっていなければなりません(-1234 など)。

• 小数位がある値を貼り付ける場合、ローカル・ブラウザーにおける書式設定の設定を知っておく必要があります。場合によっては、小数位のセル書式設定が設定された値を貼り付ける操作はサポートされていません。 Excel で数値の書式を使用する場合、「123456.7」などの数値は、末尾にスペースが付いた「123 456,7 」という形式でコピーされます。特定のロケール (「fr」など) では、数値パーサーが末尾スペースを桁区切り記号として解釈する場合があり、値の貼り付けができないことがあります。

• TM1 Web では、括弧で囲まれた値を貼り付けることはできません。新しい日付値を選択するセルが日付として書式設定されている場合に、セルをダブルクリックし、次にカレンダーを使用して新しい日付を選択します。一方、ダブルクリックするとセルが編集モードになるので、セルに新しい日付を直接入力することもできます。書式設定は、セルを決定する要素に適用された書式属性によって決まります。詳しくは、TM1Developer の資料で「要素属性」を参照してください。

「テキストを折り返す」が有効になっているセルに値を入力すると、新しい値が収まるように、必要に応じて行の高さが拡大されます。「テキストを折り返す」が有効になっているセルであっても、他の行/列にマージされている場合や、独自の行の高さが設定されている場合は、行の高さは拡大されません。

2.新しい値を入力したら、Enter キーを押すか、別のセルをクリックします。新しい数値は斜体の太字で表示されるので、そのセルの値が新しいことがわかります。データ変更を保存するには、TM1 サーバーにその変更を送信しなければなりません。重要 : 新しい値を送信せずに TM1 Web からログアウトすると、変更内容は失われます。

3.データ変更内容を確認します。サンドボックスを使用する場合は、変更がコミットされるまでデータ変更を異なる色で表示します。

4. Web シート・ツールバーの「コミット」をクリックして、サーバーに変更を保存します。変更を送信すると、更新された値が普通のフォントで Web シートに表示されるので、変更が保存されたことがわかります。


Web シートでのデータ・スプレッドの使用データ・スプレッドを使用すると、データ・スプレッド方式と呼ばれる事前定義された配分方式で Web シートの数値データを入力または編集できます。例えば、値をセル範囲に均等に分配することも、パーセンテージでセル範囲のすべての値を増分することもできます。注 : TM1 Web は、TM1 サーバーにアップロードされた Excel ファイルのコピーか、接続された Excel ファイルの元の場所のいずれかに配分値を保存します。そのどちらになるかは、ファイルが TM1 Web に追加された方法によって決まります。TM1 Web で配分が実行された後に、データを送信する必要はありません。

手順1. Web シートにデータを配分するには、セルを右クリックして「データ・スプレッド」を選択します。2.「配分」メニューで、データ配分方式を選択します。

データ・スプレッドからのセルの除外セルに保持を適用すると、データ・スプレッドによってそれらのセルが影響を受けることがなくなります。保持されたセルは、編集可能です。保持は、その機能を開始したユーザーだけに適用されます。他のユーザーはセルを編集できます。単一のセルまたは範囲に保持を適用する保持を単一のセル、またはセルの範囲に適用できます。

手順1.セル、または範囲を選択します。2.セル、または範囲を右クリックします。3.「保持」>「リーフの保持」をクリックします。保持された各セルには、左下隅に赤の三角形が表示され、そのセルまたは範囲に対して保持を適用したことを視覚的に示します。ログアウトすると、TM1 Web によってすべての保持が解放されます。

単一のセルまたは範囲で保持を解放する単一のセルまたはセルの範囲で保持を解放できます。

手順1.セル、またはセルの範囲を選択します。2.セル、または範囲を右クリックします。3.「保持」>「リーフ保持の解放」をクリックします。解放されたセルは、データ・スプレッド操作の値を受け入れます。注 : Web シートに適用したすべての保持を解放するには、Web シートのセルを右クリックし、「保持」>「全保持分の解放」をクリックします。

データ・スプレッドからの集約の除外集約定数の値を保持した状態で、その基礎のリーフ値を調整することができます。例えば、ある値を一定に保持した状態で、そのリーフ値を変更して what-if 分析を行いたい場合などがあります。集約の保持を適用してリーフ要素の値を変更する場合、 TM1 Web は、集約値が変わらないように他のリーフ値に比例配分を適用します。


単一のセルまたは範囲に集約の保持を適用する集約の保持を単一のセル、またはセルの範囲に適用できます。

手順1.セル、または範囲を選択します。2.セル、または範囲を右クリックします。3.「保持」>「集約の保持」をクリックします。保持された集約には赤い三角がセルの左下のコーナーに表示され、これはそのセルまたは範囲に保持が適用されたことを示しています。ログアウトすると、TM1 Web によってすべての保持が解放されます。

単一のセルまたは範囲で集約の保持を解放する単一のセルまたはセルの範囲で集約の保持を解放できます。

手順1.セル、またはセルの範囲を選択します。2.セル、または範囲を右クリックします。3.「保持」>「集約の解放」をクリックします。基礎のリーフ値に対して加えた変更を集約値に反映できるようになりました。注 : Web シートに適用したすべての保持を解放するには、Web シートのセルを右クリックし、「保持」>「全保持分の解放」をクリックします。

Web シートでのリレーショナル・データの操作v2.0.8 で削除 TM1 のデータと同じ Web シートに任意の書式でリレーショナル・データを表示することができます。TM1 でリレーショナル・データ・ソースにアクセスする 1 つの方法は、TurboIntegrator を使用してリレーショナル・データを抽出する方法です。その後、ドリルスルーして結果を表示することができます。詳しくは、TM1 TurboIntegrator の資料を参照してください。この TurboIntegrator を使用する方法には、次の 2 つの制限があります。• TM1 Web では、結果は別の Web シートに表示されます。Excel では、結果は別のタブに表示されます。このため、同じレポートに OLAP データとリレーショナル・データの両方を含めることはできません。

• 結果はモノクロの表として表示され、書式は設定できません。2 つ目の方法では、TI プロセスを実行せずにリレーショナル・データを表示できます。これは、Excel ファイルにリレーショナル・クエリーを定義し、そのファイルを TM1 Web にアップロードするという方法です。• この方法では、結果が同じ Web シートまたはタブに表示されるため、OLAP データとリレーショナル・データを一緒にレポートすることができます。

• レポートは Excel でも TM1 Web でも書式設定できます。Excel でのリレーショナル・クエリーの定義

v2.0.8 で削除 Excel から Microsoft SQL、IBM Db2®、および Oracle データベースに接続し、TM1 Web で実行するクエリーを定義します。TM1 Web でリレーショナル・クエリーを実行するには、Microsoft Excel でクエリーを作成する必要があります。Microsoft Excel を使用したリレーショナル・データベースのクエリー方法について詳しくは、Excel ソフトウェアの付属資料を参照してください。


MS SQL データのクエリーの作成注 : MS SQL Server OLE ドライバーのインストールは必要ありません。このドライバーは既に MicrosoftOffice と共にインストールされています。1. Microsoft Excel で、「データ」タブ >「外部データの取り込み」>「その他のソースから」>「SQL Serverから」に移動します。

2. MS SQL Server データベースの URL を入力し、ユーザー名およびパスワードを入力します。3.データベースを選択し、リストから表を選択します。4.クエリーを作成します。

a.「プロパティー」>「定義」タブをクリックします。b.コマンドの種類を SQL に変更します。c.「コマンドの文字列」ボックスに SQL コマンドを入力します。d.必要に応じて、パラメーターをクエリーに追加します。詳しくは、29 ページの『Excel でのパラメーター化クエリーの作成』を参照してください。注 : SQL クエリーの作成中にクエリーを検証することはできません。

5.必要に応じて、Excel でデータを変更したり書式を設定したりします。注 : ほとんどの書式設定はファイルを TM1 Web にアップロードしても保持されます。ただし、表の書式設定は保持されません。

6. Excel ワークシートを保存します。

Db2 データのクエリーの作成重要 : Excel から IBM Db2 データベースに接続するには、最新の Db2 OLE ドライバーをインストールする必要があります。詳細については、IBM サポート・ポータル (http://www.ibm.com/support/entry/portal/support) を参照してください。

1. Microsoft Excel で、「データ」タブ >「外部データの取り込み」>「その他のソース」>「データ接続ウィザード」に移動します。

2.「その他/詳細」をクリックし、「次へ」をクリックします。3.インストール済みの Db2 OLE ドライバーを選択して「次へ」をクリックします。4.「直接サーバー接続 (Direct server connection)」を選択します。5.サーバー名および ODBC ポート番号を次のように入力します。

server_name:ODBC_port_number6.リストからデータベースを選択し、ユーザー名およびパスワードを入力します。7.リストから表を選択し、必要な場合はユーザー名およびパスワードをもう一度入力します。8.クエリーを作成します。



10. Excel ワークシートを保存します。


http://www.ibm.com/support/entry/portal/support

Oracle データのクエリーの作成重要 : Excel から Oracle データベースに接続するには、最新の Oracle OLE ドライバーをインストールする必要があります。詳細については、Oracle の Web サイト (http://www.oracle.com) を参照してください。

1. Microsoft Excel で、「データ」タブ >「外部データの取り込み」>「その他のソース」>「データ接続ウィザード」に移動します。

2.「その他/詳細」をクリックし、「次へ」をクリックします。3.インストール済みの Oracle OLE ドライバーを選択して「次へ」をクリックします。4.「直接サーバー接続 (Direct server connection)」を選択します。5.サーバー名、ODBC ポート番号、およびネット・サービス ID を次のように入力します。

server_name:ODBC_port_number/net_service_id

注 : エラー・メッセージが表示され、その最後に次の行が示される場合があります。IO Error: Invalid connection string format, a valid format is: "host:port:sid" (入出力エラー: 接続文字列の形式が正しくありません。有効な形式は「host:port:sid」です)

このエラー・メッセージに反して、元の接続は正常に確立されています。また、有効な構文は host:port/sid のみです。

6.リストからデータベースを選択し、ユーザー名およびパスワードを入力します。7.リストから表を選択し、必要な場合はユーザー名およびパスワードをもう一度入力します。8.クエリーを作成します。



10. Excel ワークシートを保存します。以上で、リレーショナル・データを TM1 Web で使用できるようになります。詳しくは、30 ページの『リレーショナル・クエリーの TM1 Web へのアップロード』を参照してください。

Excel でのパラメーター化クエリーの作成v2.0.8 で削除 Excel でパラメーター化クエリーを作成し、後で TM1 Web から実行することができます。Excel のパラメーター化クエリーの詳細については、Microsoft Excel の資料を参照してください。

手順1.次の Web ページでの手順に従ってください。

http://msdn.microsoft.com/en-us/office2010developertrainingcourse_vbalab_topic3.aspx (http://msdn.microsoft.com/en-us/office2010developertrainingcourse_vbalab_topic3.aspx)。

2.上のリンクが使用できない場合は、Microsoft の Web サイト (http://www.microsoft.com) にアクセスし、「Creating a parameterized query in Excel」という検索文字列を入力してください。

Db2 注 1:

パラメーター化クエリーを Db2 で使用すると、次のエラーが表示される場合があります。関数シーケンス・エラー


http://www.oracle.com

http://msdn.microsoft.com/en-us/office2010developertrainingcourse_vbalab_topic3.aspx

http://www.microsoft.com

この問題を解決するには、次の技術情報を参照してください。http://www.ibm.com/support/docview.wss?uid=swg21628120 (http://www.ibm.com/support/docview.wss?uid=swg21628120)。Db2 注 2:

Microsoft Query を使用して Db2 データベースに接続しようとしても、OLE ドライバーの接続文字列にはホスト名が含まれません。そして、接続に失敗しましたというエラー・メッセージが表示されます。この問題を解決するには、次の引数を接続文字列に追加する必要があります。location=<hostname>;

また、Excel がデータベースに再接続しようとすると接続文字列がリセットされるため、Excel が再接続を試みないようにする必要があります。

リレーショナル・クエリーの TM1 Web へのアップロードv2.0.8 で削除リレーショナル・データをリアルタイムで照会し、結果を TM1 データと同じ Web シートに表示するには、リレーショナル・クエリーを TM1 Web にアップロードします。

始める前にリレーショナル・クエリーを TM1 Web にアップロードするには、Microsoft Excel でクエリーを作成し、そのデータをワークシートとして保存する必要があります。詳しくは、27 ページの『Excel でのリレーショナル・クエリーの定義』を参照してください。

手順1. TM1 Perspectives で、リレーショナル・クエリーが入っている Excel ワークシートを開きます。2.「TM1」タブで、「標準」>「接続」をクリックします。3.「サーバー ID」フィールドでアプリケーションを選択します。4. TM1 のユーザー ID およびパスワードを入力し、「OK」をクリックします。5.「標準」>「アップロード」をクリックします。6.ファイルをアップロードする TM1 アプリケーション・フォルダーを選択し、「OK」をクリックします。7.次の URL を入力して TM1 Web を開始します。

http://tm1_server_name:9510/tm1web8.アプリケーション・フォルダーを展開し、更新ボタンをクリックします。リレーショナル・ワークシートがフォルダー内に表示されます。

TM1 Web でのリレーショナル・データの表示v2.0.8 で削除 Microsoft Excel で作成されたクエリーを実行することにより、TM1 Web でリレーショナル・データを表示できます。注 : TM1 でデータの形式を設定できます。ただし、リレーショナル・データベースに書き戻すことはできません。

手順1.次の URL を入力して TM1 Web を開始します。

http://tm1_server_name:9510/tm1web2.アップロードした Excel ワークシートが含まれているアプリケーション・フォルダーを展開します。3.ワークシートを開きます。

a. TM1 Web サーバーは、ワークシートを表示する前に、管理者が定義したプロキシー・アカウント情報と照合して RDBMS のアカウント情報をチェックします。



この情報が一致している場合は、ワークシートが TM1 Web ウィンドウに表示されます。b. RDBMS アカウント情報と一致するプロキシー・アカウント情報が見つからない場合は、TM1 Web サーバーは、RDBMS アカウント情報を TM1 のユーザー名およびパスワードと照合してチェックします(統合セキュリティー・モードが 1 の場合のみ)。この情報が一致している場合は、ワークシートが TM1 Web ウィンドウに表示されます。

c. RDBMS アカウント情報と一致するプロキシー・アカウントも TM1 アカウントもない場合は、リレーショナル・データ・ソースのユーザー名およびパスワードと一致するユーザー名およびパスワードを入力するように求めるプロンプトが表示されます。リレーショナル・データ・ソースのユーザー名およびパスワードと一致するユーザー名およびパスワードを入力すると、ワークシートが TM1 Web ウィンドウに表示されます。注 : 試行が 3 回失敗すると、エラー・メッセージが表示されます。その場合は、管理者に連絡して有効なユーザー名およびパスワードを取得してください。

Web シートのプロパティーの変更Web シートのプロパティーは、TM1 Web の Web シートとして参照されるときの Excel ファイルの表示および動作を指定します。Web シートのプロパティーは、すべてのユーザーが参照できますが、Web シートのプロパティーを編集するにはアプリケーション内の Excel ファイルに対する書き込みアクセス権限が必要です。注 : Web シートのプロパティーの管理には、サーバー・エクスプローラーを使用します。サーバー・エクスプローラーは、Excel ファイルを TM1 アプリケーションに追加するためのユーザー・インターフェースです。 TM1 Web で直接 Web シートのプロパティーを管理することはできません。

手順1.サーバー・エクスプローラーのツリー・ウィンドウで、対応する Web シートの Excel ファイルが含まれている TM1 アプリケーションを見つけます。注 : サーバー・エクスプローラーには、IBM TM1 Perspectives または TM1 Architect からアクセスできます。

2. Excel ファイルを右クリックして「プロパティー」をクリックします。「TM1 Web のプロパティー」ダイアログ・ボックスが表示されます。以下の 2 つのタブがあります。

• 全般• 表示プロパティー

3.必要であれば、「全般」タブをクリックして、全般プロパティーを変更します。TM1 管理ホスト

Excel スライスの生成時にサーバーが登録されていた管理ホストが 1 つ以上表示されます。ユーザーは 1 つ以上の管理ホストに接続し、複数の管理ホストを指定することができます。リスト内の各項目をセミコロンで区切ってください。

Web からの書き戻しを許可Web シートに値を入力して TM1 のデータを変更することをユーザーに許可します。このオプションを無効にすると、Web シートは読み取り専用になります。

印刷プロパティーユーザーがこの Web シートから印刷できるページ数の上限を設定します。システムのデフォルト値は 100 です。この数は、この Web シートにとって適した任意の値に設定できます。例えば、ユーザーが印刷できる最大ページ数を 110 に設定するためには、「印刷プロパティー」セクションの、「シート数の上限」ボックスで「110」と入力します。

4.「表示プロパティー」タブをクリックして、表示プロパティーを変更します。タイトル要素セレクターの表示このオプションを有効にすると、Web シートのタイトル・ディメンションに「サブセット・エディター」ボタンが表示されます。このオプションが有効な場合、「セレクターの表示」オプションを使


用して、個々のタイトル・ディメンション用の「サブセット・エディター」ボタンの表示/非表示を切り替えることができます。このオプションをクリアすると、Web シートのすべてのタイトル・ディメンションの「サブセット・エディター」ボタンが非表示になります。

タイトル・ディメンション「タイトル・ディメンション」グリッドには、Web シートのすべてのタイトル・ディメンションが表示されます。このグリッドには以下の列があります。• ディメンション - タイトル・ディメンションの名前。• アドレス - Web シートのタイトル・ディメンションのセル・アドレス。• セレクターの表示 - 「タイトル要素セレクターの表示」オプションを有効にした場合は、Web シートのタイトル・ディメンションの「サブセット・エディター」ボタンの表示/非表示を個々に設定することができます。タイトル・ディメンション用の「サブセット・エディター」ボタンを表示するには、「セレクターの表示」列の対応するチェック・ボックスを選択します。タイトル・ディメンション用の「サブセット・エディター」ボタンを非表示にするには、「セレクターの表示」列の対応するチェック・ボックスをクリアします。

Web シートからのレポート生成TM1 Web で Web シートや Cube Viewer を使用してレポートを生成できます。Web シートレポートに組み込むタイトル・ディメンション・サブセットを選択します。オプションとして、エクスポートする Web シートの印刷域を定義することもできます。

Cube Viewerレポートに組み込むタイトル・ディメンション・サブセットと行数を選択します。詳しくは、47 ページの『キューブ・ビューからのレポート生成』を参照してください。

注 : Web サーバーに Microsoft Excel がない状態で TM1 Web のインストール環境を実行するように構成した場合は、Web シートをエクスポートするときにいくつかの制限が適用されることがあります。詳しくは、34 ページの『Web シートのエクスポートの制限』を参照してください。

手順1.「エクスポート」をクリックします。2.レポートのエクスポート形式を選択します。

Excel にスライス関数の使用により TM1 サーバーへのリンクを保持する Excel ドキュメント。スライスに関連付けられているサーバーに接続すると、現行のキューブ値がスライスに表示されます。 Excel にスナップショットエクスポートを実行した時点のキューブ値を表す数値が含まれている Excel ドキュメント。スナップショットでは TM1 サーバーへのリンクは保持されないので、これらの値は、エクスポート時点のキューブ値のスナップショットを表す静的な値です。 PDF にエクスポートエクスポートを実行した時点のキューブの値を表示する PDF 文書。

「Web シートをエクスポート」ダイアログ・ボックスが開きます。ダイアログ・ボックスは各タイトル・ディメンションのサブセット内の要素数を表示します。

3.レポートに入れるタイトル・ディメンションを選択します。


ディメンションを選択すると、生成されるシートの数がダイアログ・ボックスに表示されます。次の例では、plan_business_unit および plan_department のタイトル・ディメンションが選択され、レポートは 99 シート (9 要素 × 11 要素) を生成します。

注 : TM1 Web は、現在のタイトル・ディメンション・サブセット内の要素数に応じて各タイトル・ディメンションの要素数を決定します。タイトル・ディメンション・サブセットを編集すると、タイトル・ディメンションの要素数も変更されます。

4.「エクスポート」ダイアログ・ボックスで「OK」をクリックしてレポートを作成します。TM1 Web は、選択されたタイトル・ディメンションを「エクスポート」ダイアログ・ボックスでの表示順に繰り返して、レポート・シート (または PDF のページ) を生成します。この例の場合、TM1 Web は、以下のようにシートを生成します。•「エクスポート」ダイアログ・ボックスで選択しなかったタイトル・ディメンションについては、TM1

Web は、すべてのレポート・シートに Web シートの現在のタイトル要素を使用します。この例ではモデル・ディメンションが選択されていないので、TM1 Web は、すべてのレポート・シートで現在のタイトル要素を使用します。

• TM1 Web は、actvsbud タイトル・ディメンションの現在のサブセットの 1 つ目の要素を使用してシートの生成を開始します。

• その actvsbud タイトル要素を一定に保ちながら、次に TM1 Web は、region タイトル・ディメンションの現在のサブセットのすべての要素を循環することによって、シートを生成します。

• TM1 Web は、actvsbud タイトル・ディメンション・サブセットの 2 つ目の要素を使用してシートを生成します。

• その 2 つ目の actvsbud タイトル・ディメンション・サブセットの要素を一定に保ちながら、TM1 Webは、region タイトル・ディメンションの現在のサブセットのすべての要素を再度循環することによって、シートを生成します。

• 最後に、TM1 Web は、3 つ目の actvsbud タイトル・ディメンション・サブセットの要素を一定に保ちながら、region タイトル・ディメンションの現在のサブセットのすべての要素を循環することによって、シート再度生成します。

TM1 Web ですべてのシートが生成されたら、レポートを開いたり保存したりできます。5.以下のいずれかの手順を実行します。

•「開く」をクリックして新規ブラウザー・ウィンドウでレポートを開く。•「保存」をクリックしてレポートをユーザーのハードディスクに保存する。注 : デフォルトで、スライスまたはスナップショット・レポートの Excel へのエクスポートでは、Webブラウザーのウィンドウでレポートを表示します。スタンドアロン版の完全な Excel でレポートを開くようにコンピューターを設定する方法について詳しくは、Microsoft サポート Web サイトを参照してください。


Excel にエクスポートしたスライスで TM1 の機能を使用したい場合は、スタンドアロン版の Excel でスライスを開く必要があります。また、IBM TM1 Perspectives のローカル・バージョンをコンピューターにインストールしておく必要があります。TM1 Web を WAN (広域ネットワーク) サーバーで実行している状況で、TM1 Web から Excel ファイルやPDF ファイルをエクスポートするときに問題が発生した場合は、Internet Explorer のセキュリティー設定の再構成が必要になることがあります。詳しくは、TM1 Operation の資料を参照してください。

Web シートのエクスポートの制限TM1 Web サーバーに Microsoft Excel が存在しない場合は、Web シートのエクスポートにいくつかの制限があります。Excel へのスライスおよび Excel へのスナップショット• Web シート内の OLE コントロールは画像に変換されます。• Web シートと、生成された Excel ワークシート/ワークブックの間でレイアウトが異なることがあります。• ワークシートのヘッダーとフッターはエクスポートされません。• 生成されたワークシートでは、フォーム・コントロールの状態は更新されず、表示されることもありません。

PDF にエクスポート• Web シートを PDF にエクスポートするときには印刷域情報が使用されます。ワークシートに印刷域を定義した場合、その範囲内のデータのみが PDF にエクスポートされます。この動作は Excel から印刷する場合と同じです。

• Web シート内の画像はエクスポートされません。• Web シート内のグラフは PDF ファイルの別のページにエクスポートされます。• OLE コントロールとフォーム・コントロールはエクスポートされません。• ヘッダーとフッターはエクスポートされません。


第 4 章 TM1 Web Cube Viewer の操作このセクションでは、TM1 Web でキューブを操作する方法について説明します。

TM1 Web でキューブ・ビューを開く次の手順に従って、TM1 Web においてキューブ・ビューを開きます。

手順1. TM1 Web にログオンします。2.左の「ナビゲーション」ウィンドウで、ビュー・ノードを開きます。アクセスできるすべてのキューブがアルファベット順で表示されます。

3.任意のキューブの横にある「展開」アイコンをクリックして、TM1 Web で使用可能なビューを表示します。

4.リスト内のビューをクリックします。右の「内容」ウィンドウにビューが開きます。Cube Viewer ツールバーがビューのすぐ上に表示されます。

5.「ナビゲーション」ウィンドウで別のビューをクリックします。ビューが「内容」ウィンドウに開き、Cube Viewer ツールバーの上に 2 つのビュー・タブが表示されます。各ビュー・タブには、開いているビューの名前が含まれます。現在のビュー・タブには罫線が表示され、ビューが内容ウィンドウに表示可能であることを示します。次の例は、2 つのビュー・タブ、価格および地域を示します。この例で、「地域」タブには罫線が表示され、地域ビューが「内容」ウィンドウに表示されることを示します。

「ナビゲーション」ウィンドウからビューを開くたびに、該当するビューのタブが Cube Viewer ツールバーの上に表示されます。複数のビューを開くと、ビュー・タブが単一の行に沿って横方向に並べられ、開いているタブを左右にスクロールする矢印ボタンのセットが表示されます。以下の例では、複数のビュー・タブが表示され、現在のビュー・タブとして「Budget Input Detailed」が表示されています。


6.ビュー・タブを使用して、ビューを表示したり、閉じたりします。• ビュータブをクリックすると、「内容」ウィンドウに該当のビューが表示されます。• ビュー・タブの「閉じる」をクリックすると、該当のビューが閉じます。•「ビュー」タブのスクロール・バーの「左へスクロール」および「右へスクロール」矢印をクリックして、開いているビュー・タブの間を移動できます。

TM1 Web Cube Viewer ツールバーの使用TM1 Web Cube Viewer ツールバー・ボタンは、一般的に使用されるコマンドへのショートカットを提供します。次のリストでは、ツールバーの各ボタンについて説明します。「操作」メニュー保存、閉じる、およびエクスポートなど、一般的な Cube Viewer タスクへのアクセスを提供します。

データ変更の保存現在のデータに対する変更を保存します。ビューを保存現在のビューを TM1 サーバーに保存します。名前を付けて保存現在のキューブ・ビューを新しい名前で保存する。エクスポートCube Viewer データを次の形式でエクスポートする。

Excel にスライス - Cube Viewer のデータと TM1 の数式 (SUBNM 関数と DBRW 関数) を新しいExcel スプレッドシートにエクスポートします。そのスプレッドシートでは、TM1 サーバーとの接続が保持されます。

Excel にスナップショット - Cube Viewer のデータのみを新しい Excel スプレッドシートにエクスポートします。TM1 サーバーの数式 (SUBNM 関数と DBRW 関数) は除外されます。そのスプレッドシートでは、TM1 サーバーとの接続は保持されません。

PDF にエクスポート - Cube Viewer のデータを PDF ファイルにエクスポートします。「PDF にエクスポート」オプションを使用するには、TM1 Web のインストール時に PostScript プリンターをインストールする必要があります。詳しくは、「Planning Analytics インストールおよび設定」の資料を参照してください。TM1 Web Cube Viewer からレポートを生成する方法について詳しくは、47 ページの『キューブ・ビューからのレポート生成』を参照してください。


データのリセットその時点までにサンドボックスに入力したすべての変更データをクリアする。すべてのデータ値をリセットし、ベース・データの現在の値に戻す。ビューのリセットCube Viewer のビューの外観を再ロードし、最後に保存されたタイトル・ディメンションの配置にする。

閉じる現在選択されているキューブ・ビューを閉じます。

その他を閉じる現在選択されているキューブ・ビュー以外のすべてのビューを閉じます。

すべてを閉じるすべてのキューブ・ビューを閉じます。

コミットCube Viewer でデータに加えた変更を TM1 サーバーに送信します。再計算Cube Viewer 構成を更新して、ビューでデータを再計算する。セルを編集した場合は、すべての編集内容が TM1 サーバーに自動的に送信されます。自動計算「自動計算」オプションをオフにすると、TM1 Web は、ビュー構成の変更時に Cube Viewer の自動再計算を行わなくなります。例えば、行サブセットを編集するか、ディメンションをタイトルから列に移動する場合、これらの変更はすぐに Cube Viewer に表示されません。変更を表示するには、「再計算」ボタンをクリックする必要があります。「自動計算」オプションをオンにすると、TM1 Web は、ビュー構成の変更時に Cube Viewer を自動的に再計算します。ゼロを消去「ゼロを消去」には以下の 3 つのオプションがあります。

• 行と列のゼロを消去• 行のゼロを消去• 列のゼロを消去グラフの表示Cube Viewer データをグラフ形式で表示する。グラフとグリッドの表示Cube Viewer データをグリッドとグラフの両方の形式で表示する。グリッドの表示Cube Viewer データをグリッド形式で表示する。グラフのプロパティーグラフのタイプの選択、またはスコアカードの評価指標の図のオプションを表示します。

ページの移動ページを移動することによって、大きいキューブ・ビューの、ある部分から別の部分に移動できます。複数のナビゲーション・ボタンと 1 つのページ・インジケーターを持つページング・ツールバーが提供されています。キューブ・ビューで、表示されているグリッドの部分は 7 ページのうちの先頭です。

第 4 章 TM1 Web Cube Viewer の操作 37

次の表は、ページング・ツールバー・ボタンおよびインジケーターをそれらの説明とともに示します。ボタンまたはインジケーター

名前説明

ページを表示キューブ・ビューのページ・レイアウト・ダイアログ・ボックスですべてのページのレイアウトを表示する。ページをクリックして特定のページに移動できます。

前のページ (行) 行の前のページを示す。

次のページ (行) 行の次のページを示す。

次のページ (列) 列の次のページを示す。

前のページ (列) 列の前のページを示す。

ページ・インジケーター

現在のページとビューのセルの合計ページ数を表示する。

キューブ・ビューのデータの保存TM1 Web からサーバーにデータ変更を保存できます。

手順1.「ビューを保存」または「再計算」をクリックして、データへの変更を保存します。「ビューを保存」をクリックすると、Cube Viewer データの変更を保存するかどうかを確認するメッセージが TM1 Web から表示されます。

2.以下のいずれかのボタンをクリックします。•「はい」 - データ変更をサーバーに送信し、ビューを再計算し、Cube Viewer に戻ります。ビュー構成を変更した場合は、その構成も保存されます。

•「いいえ」 - データ変更を破棄し、Cube Viewer に戻る。•「キャンセル」 - Cube Viewer に戻る。Cube Viewer には、データ変更が表示されたままになります。

3.「データ変更の保存」をクリックして、変更を保存します。


キューブ・ビューの設定レポートまたは分析の要件を満たすビューに到達するために、さまざまな方法で Cube Viewer を再設定できます。• 集約を展開/たたむ• ディメンションのピボット• ビュー・データのフィルター• サブセットを編集• 関連データへのドリルスルー

集約の展開と折りたたみ要素名の横にあるコントロールをクリックして、Cube Viewer で集約を展開するかたたみます。「展開」 - 要素名の横にあるプラス記号は、要素を集約として特定します。ディメンション内の集約をドリルダウンして基礎となる詳細を表示するには、プラス記号をクリックします。プラス記号がマイナス記号に変わります。「たたむ」 - 要素名の横にあるマイナス記号は展開された要素を示します。ディメンション内でリーフ要素を集計するには、マイナス記号をクリックします。マイナス記号がプラス記号に変わります。

ディメンションのピボットCube Viewer でディメンションをピボットすると、キューブ・データの表示を変更できます。ディメンションをピボットするには、ドラッグ・アンド・ドロップ操作を行います。• ディメンションを列の位置までドラッグする。• ディメンションを行の位置までドラッグする。• ディメンションをタイトルの位置までドラッグする。ディメンションを新しい位置にドラッグすると、ディメンションをドロップするときに 3 つのオプションを使用できます。オプションは、カーソルの位置によって異なります。次の例では、Dimension1 およびDimension2 という名前のディメンションを使用します。• Dimension1 をドラッグしてカーソルを Dimension2 の中央に置くと、ディメンションのドロップによって 2 つのディメンションの位置が入れ替わります。

• Dimension1 をドラッグしてカーソルを Dimension2 の左側に置くと、Dimension1 が Dimension2 のすぐ左にドロップされます。

• Dimension1 をドラッグしてカーソルを Dimension2 の右側に置くと、Dimension1 が Dimension2 のすぐ右にドロップされます。

ディメンションをドラッグして既存の列または行ディメンションのすぐ左またはすぐ右にドロップすると、ビューの列または行に沿って詳細が表示されます。


キューブ・ビューのフィルター単一の行ディメンションと 1 つ以上の列ディメンションを含むキューブ・ビューで、データをフィルターできます。列に沿って 2 つ以上のディメンションがある場合は、最も内側 (ビュー・グリッドに最も近い) のディメンションからしかフィルターできません。

手順1.フィルターする値を含む列要素をクリックします。2.フィールドを選択します。

• 事前に定義されたフィルター - 「上位 10」、「下位 10」、「上位 10 パーセント」、「下位 10 パーセント」。フィルターはすぐにビューに適用されます。

• 詳細 - 次の手順の記載どおりに、「フィルター」ダイアログ・ボックスにフィルター・パラメーターを設定することによって、カスタム・フィルターを定義できる。

3.フィルター・タイプを選択します。フィルター・タイプ説明上位順大きい方から n 個の要素のみを表示するようにビューをフィルターす

る。n は「値」オプションで指定する数です。下位順小さい方から n 個の要素のみを表示するようにビューをフィルターす

る。n は「値」オプションで指定する数です。上位累計大きい方から順に、合計が n 以上になるようにビューをフィルターす

る。n は「値」オプションで指定する数です。下位累計小さい方から順に、合計が n 以上になるようにビューをフィルターす

る。n は「値」オプションで指定する数です。上位パーセント大きい方から順に、合計が n % 以上になるようにビューをフィルター

する。n は「値」オプションで指定する、ディメンション合計に対するパーセンテージです。

下位パーセント小さい方から順に、合計が n % 以上になるようにビューをフィルターする。n は「値」オプションで指定する、ディメンション合計に対するパーセンテージです。

4.「値」ボックスに数値を入力します。5. Cube Viewer でディメンション要素を表示するソート順序を昇順または降順から選択します。6.「OK」をクリックします。

タスクの結果フィルターを作成した列要素の横に、小さいじょうごのアイコンが表示されます。注 : フィルターを削除するには、フィルターを作成した列要素をクリックして、「フィルターを削除」をクリックします。

サブセットからの要素の選択サブセットから 1 つ以上の要素を選択して、Cube Viewer で要素を関連データと共に表示します。


手順1.サブセットの横にある「サブセット・エディターを開く」ボタンをクリックします。ブラウザーに「サブセット・エディター」ウィンドウが開きます。

2. Cube Viewer に表示する要素を選択します。3.「OK」をクリックします。

キューブ・ビューからのドリルPerspectives および Architect では、キューブ・ビュー内の関連情報にアクセスするようにドリル・プロセスおよびドリル割り当てをセットアップできます。適用したドリルのプロセスおよび規則は、TM1 Web で使用できます。これらのドリル・プロセスおよび規則は、別のキューブ・ビューへのドリルに使用できます。

手順1.別のキューブ・ビューにドリルするには、セルを右クリックして、「ドリルスルー」をクリックします。セルに関連する情報を含むターゲットのキューブ・ビューが開きます。

2.あるキューブ・ビューから別のキューブ・ビューにドリルスルーするには、セルを右クリックして、「ドリルスルー」をクリックします。ターゲットの Cube Viewer が新しいタブに開きます。

キューブ・ビューのデータの編集TM1 Web Cube Viewer でデータを編集できます。

キューブ・ビューのセルのデータの編集リーフ・セルのデータは、それらのセルに対して書き込みアクセスがあれば、編集できます。リーフ・セルは、Cube Viewer の白の背景に表示されます。サンドボックスを使用する場合は、サンドボックスを保存してセッション全体の値を格納することができます。詳しくは、61 ページの『第 7 章ライトバック・モードとサンドボックス』を参照してください。

手順1.次のいずれかの方法で、白のセルの値を編集します。値を編集する白のセルの値をダブルクリックします。 TM1 Web では、白い背景でセル内の現在の値が枠と共に表示され、カーソルが点滅します。これは、キーボードの左右矢印キーを使って値の中でカーソルを合わせることによって、既存の値を選択的に編集できることを示します。また、Backspace キーとDelete キーを使用して、値から数字を 1 つずつ削除することもできます。

値を置換する白のセルの値をシングルクリックします。 TM1 Web でセルの現行値が強調表示されていれば、そのセルは編集モードになっています。その場合は、セル内の既存の値を直接上書きして、完全に置換できます。値をセルに貼り付けることも可能です。注 :

• 負の値を貼り付ける場合、その値は先頭に負符号の付いた形式になっていなければなりません(-1234 など)。

• 小数位がある値を貼り付ける場合、ローカル・ブラウザーにおける書式設定の設定を知っておく必要があります。場合によっては、小数位のセル書式設定が設定された値を貼り付ける操作はサポートされていません。 Excel で数値の書式を使用する場合、「123456.7」などの数値は、末尾にスペースが付いた「123 456,7 」という形式でコピーされます。特定のロケール (「fr」など) で


は、数値パーサーが末尾スペースを桁区切り記号として解釈する場合があり、値の貼り付けができないことがあります。

• TM1 Web では、括弧で囲まれた値を貼り付けることはできません。新しい日付値を選択するセルが日付として書式設定されている場合に、セルをダブルクリックし、次にカレンダーを使用して新しい日付を選択します。一方、ダブルクリックするとセルが編集モードになるので、セルに新しい日付を直接入力することもできます。書式設定は、セルを決定する要素に適用された書式属性によって決まります。詳しくは、TM1Developer の資料で「要素属性」を参照してください。

2.新しい値を入力したら、Enter キーを押すか、別のセルをクリックします。注 : Web キューブ・ビューの集約セルに数を入力すると、値はその集約全体に均等に配分されます。例えば、Web キューブ・ビューの集約セルに 50 を入力すると、50p の配分コードを入力したように値はその集約全体に均等に配分されます。この動作は Web Cube Viewer でのみ発生します。Architect/Server Explorer の Cube Viewer では、Perspectives および Web シートのスライスに配分コードを入力して集約セルの間に比例配分する値を取得する必要があります。新しい数が太字および斜体で表示され、このセルに新しい値があることを示します。加えた変更を残すためには、ビューをサーバーに送信する必要があります。重要 : 新しい値を送信せずに TM1 Web からログアウトすると、変更内容は失われます。

3.データ変更内容を確認します。サンドボックスを使用する場合は、変更がコミットされるまでデータ変更を異なる色で表示します。

4. Cube Viewer ツールバーの「コミット」をクリックして、サーバーに変更を保存します。Cube Viewer には、更新された値が表示されます。すべての値は通常のフォントで表示され、変更を保存したことを示します。

データ・スプレッドの使用データ・スプレッドを使用して、データ・スプレッド方式と呼ばれる事前定義された配分方式で数値データを入力または編集できます。例えば、値をセル範囲に均等に分配することも、パーセンテージでセル範囲のすべての値を増分することもできます。

手順1.データを配分するには、セルを右クリックして、「データ・スプレッド」を選択します。2.「配分」メニューで、データ配分方式を選択します。注 : TM1 Web が配分値をサーバーに保存します。TM1 Web で配分が実行された後に、データを送信する必要はありません。

クイック・データ入力コマンドセルにデータ入力コマンドを入力すると、そのセルの値に対して操作が行われます。

データ入力コマンドは Enter を押すと処理されます。これらのコマンドは、現在のグリッドにのみ適用されます。これらのコマンドでは大文字と小文字は区別されません。コマンドは上下左右いずれの方向にも使用できますが、ページをまたいで使用することはできません。次の表はクイック・データ入力コマンドをリストしたものです。


コマンド説明操作K セルの値を千の単位で入力する。例：5K

5,000 を入力する。M セルの値を百万の単位で入力する。例：10M

10000000 を入力する。Add、+ セル値に数値を加算する。例：Add50

セル値に 50 を加算する。Subtract、Sub、~ セル値から数値を減算する。

重要：マイナス記号 (-) を減算を表すために使用することはできません。これは、マイナス記号が負の数を表す目的で使用されるためです。

例：sub8

セル値から 8 を減算する。

Percent、per パーセント値として追加された数値をセル値に乗算する。

例：per5

セルの値を元のセル値の 5% にする。

Increase、Inc パーセント値として追加された数値だけセル値を増分する。

Decrease, Dec パーセント値として追加された数値だけセル値を減分する。

例：decrease6

セル値を 6% 減分する。GR 指定したパーセント値ずつセルを増分して

いく。例：GR>150:10

値を 150 から 10% ずつ増分するHold、Hol、H、 HC セル値を保持して自動按分計算の対象外と

する。HC は集約レベルを保持します。Release、Rel、 RH、RC

セルの保持を解除する。

RA 保持されているすべてのセルを解除する。

クライアントによって異なるショートカットの使用IBM TM1 Application Web クライアントではいくつかのショートカット・キーを使用できます。次の表に、IBM TM1 Application Web クライアントで使用可能なショートカット・キーと、TM1 で使用可能なショートカット・キーを示します。 IBM Planning Contributor で使用可能なすべてのショートカットを、TM1 でも使用できるわけではありません。ショートカット・キーの使用に関する重要な情報が表の最後に記載されていますので、そちらも参照してください。Application Web TM1

Add10 P+10

Sub10 P~10


Application Web TM1

Increase10 P%+10

Decrease10 P%~10

Percent10 P%10

Add10> または >Add10 R+>10

Sub10> または >Sub10 R~>10

Increase10> または >Increase10 P%+>10

Decrease10> または <Decrease10 P%~>10

Percent10> または >Percent10 P%>10

>10 R>10

10> R>10

>10K R>10000

>10M R>10000000

10Grow100Compound> GR>10:100

10Grow100Linear> GR>10:100

10Gro100Com> GR>10:100

10Gro100Lin> GR>10:100

10G100C> GR>10:100

10G100L> GR>10:100

10Grow100> GR>10:100

1K 1000 (末尾に K が付く数字はクライアント側で 1000 を乗じたうえでサーバーに返されます)

1M 1000000 (末尾に M が付く数字はクライアント側で1000000 を乗じたうえでサーバーに返されます)

• 10K などのショートカットが入力されると、クライアント側で数値に 1000 や 1000000 が乗じられ、それからそのショートカットが対応する配分コードに変換されます。

• TM1 の配分コードと Planning Contributor のショートカットを組み合わせて使用することはできません。例えば、P%Add10 や RPAdd10 は使用できません。また、Planning Contributor のショートカットを TM1 のショートカットと組み合わせて使用することもできません。例えば、Add10Sub20 は無効な入力です。

• Planning Contributor の乗算、除算、累乗、およびリセットのショートカットは TM1 にはありません。


• すべての Grow コマンドは Compound か Linear かによらず TM1 GR 配分コード・コマンドに変換されます。GR コマンドでは線形増分しか実行できません。

• 配分の方向は、ショートカットの先頭と末尾のいずれで指定してもかまいません。ショートカット文字列の途中で方向を指定することはできません。例えば、Add10> と >Add10 は有効ですが、Add>10 とAdd1>0 は無効です。

• ショートカット・コードで大文字と小文字は区別されません。例えば、add10、Add10、aDD10 は、いずれも同じ結果になります。

Cube Viewer の集約セルにデータを入力するCube Viewer で集約セルに数値を入力すると、その値は集約対象の間で比例配分されます。例えば、Cube Viewer で集約セルに 50 を入力すると、配分コード 50p を入力した場合のように集約対象の間でその値が比例配分されます。この動作は Cube Viewer でのみ実行されます。 Architect/ServerExplorer の Cube Viewer では、Perspectives および Web シートのスライスに配分コードを入力して、集約セルの間で比例配分する値を取得する必要があります。

データ・スプレッドからのセルの除外セルに保持を適用すると、データ・スプレッドによってそれらのセルが影響を受けることがなくなります。保持されたセルは、編集可能です。保持は機能を開始したユーザーだけに適用され、他のユーザーはセルを編集できます。単一のセルまたは範囲に保持を適用する保持を単一のセルまたは範囲に適用できます。

手順1.セル、または範囲を選択します。2.セル、または範囲を右クリックします。3.「保持」>「リーフの保持」をクリックします。

タスクの結果保持された各セルには、左下隅に赤の三角形が表示され、そのセルまたは範囲に対して保持を適用したことを視覚的に示します。ログオフすると、すべての保持が解除されます。単一のセルまたは範囲で保持を解放する単一のセルまたは範囲で保持を解放できます。

手順1.セル、またはセルの範囲を選択します。2.セル、または範囲を右クリックします。3.「保持」>「リーフ保持の解放」をクリックします。

タスクの結果解放されたセルは、データ・スプレッド操作の値を受け入れます。注 : すべてのキューブに適用したすべての保持を解放するには、キューブ内の任意のセルを右クリックし、「保持」>「全保持分の解放」をクリックします。


データ・スプレッドからの集約の除外基礎となるリーフ値の調整中も、集約定数の値を保持できます。例えば、what-if 分析を実行するとき、リーフの値の変更中も、ある値を一定に保持することができます。集約の保持を適用してそのリーフ要素の値を変更する場合、集約値を変えないように残りのリーフ値に比例配分が適用されます。単一のセルまたは範囲に集約の保持を適用する集約の保持を単一のセルまたは範囲に適用できます。

手順1.セル、または範囲を選択します。2.セル、または範囲を右クリックします。3.「保持」>「集約の保持」をクリックします。

タスクの結果保持された各集約には赤い三角がセルの左下のコーナーに表示され、これはそのセルまたは範囲に保持が適用されたことを示しています。ログオフすると、すべての保持が解除されます。単一のセルまたは範囲で集約の保持を解放する単一のセルまたは範囲で集約の保持を解放できます。

手順1.セル、またはセルの範囲を選択します。2.セル、または範囲を右クリックします。3.「保持」>「集約の解放」をクリックします。

タスクの結果集約された値は、基礎となるリーフ値に加える変更を反映できるようになりました。注 : すべてのキューブに適用したすべての保持を解放するには、キューブ内の任意のセルを右クリックし、「保持」>「全保持分の解放」をクリックします。

セルのコメントの追加、表示、削除キューブ・ビューの任意のセルにコメント・テキストを追加したり表示したりできます。TM1 Web でセルに付加したコメントは、IBM Cognos Insight (スタンドアロン・モード) および IBM CognosPerformance Modeler で表示できます。コメントを削除するには、Cognos TM1 Applications ポータルから注釈を消去します。詳しくは、TM1 Performance Modeler の資料で『アプリケーションの注釈の構成』を参照してください。

手順1. TM1 Web で、コメント・テキストを追加または表示するセルを選択します。2.コメントを追加する場合は、次の手順に従います。

a)セルを右クリックし、「コメントの追加」をクリックします。b)コメントのテキストを入力します。ヒント : セルにコメントが付加されていることを示す赤色の小さな三角形がセルの隅に表示されます。

3.セルに既にコメントがある場合は、「コメントを参照」をクリックします。


各コメントを、ユーザー名およびコメントの追加日と共にリストする表が表示されます。

新しいキューブ・ビューの作成キューブのビューが分析要件を満たさない場合は、新しいビューを作成できます。

手順1.左の「ナビゲーション」ウィンドウで、ビュー・ノードを展開します。2.キューブ名をダブルクリックします

• キューブの個人用のデフォルトのビューが存在する場合、TM1 Web は内容ウィンドウにそのビューを表示します。

• キューブの個人用のデフォルトのビューが存在せず、共有のデフォルト・ビューが存在する場合、TM1Web は内容ウィンドウにその共有ビューを表示します。

• キューブの個人用のデフォルトのビューも共有のデフォルト・ビューも存在しない場合、TM1 Web は内容ウィンドウにシステム・デフォルト・ビューを表示します。システム・デフォルト・ビューでは、キューブ定義の最後のディメンションは列ディメンション、最後から 2 つ目のディメンションは行ディメンション、その他のディメンションはコンテキスト・ディメンションです。あるいは、キューブを展開し、既存のビューをクリックします。

3.要件に合わせてビューを変更します。39 ページの『キューブ・ビューの設定』を参照してください。4.「操作」 > 「名前を付けて保存」をクリックします。5.ビューの名前を入力します。6.共有ビューを作成するか、個人用ビューを作成するかを決定します。個人用ビューは、自分のみが表示できます。• 個人用ビューを作成するには、「個人用」チェック・ボックスを選択します。• 共有ビューを作成するには、「個人用」チェック・ボックスをクリアします。注 : 共有ビューを保存するためには、TM1 管理者であるか、キューブの管理権限を持っている必要があります。

7.キューブのデフォルトのビューとしてビューを保存する場合は、「デフォルト」をクリックします。• 例えば、「個人用」チェック・ボックスと「デフォルト」チェック・ボックスにチェックを入れた場合、そのビューは、キューブの個人用のデフォルトのビューとして保存されます。次にキューブをダブルクリックしたときには、そのビューが表示されます。

• 例えば、「個人用」チェック・ボックスのチェックを外し、「デフォルト」チェック・ボックスにチェックを入れた場合、そのビューは、キューブの、サーバーのすべてのユーザー用のデフォルトのビューとして保存されます。キューブの個人用のデフォルトのビューを作成したユーザーでない限り、次にキューブをダブルクリックしたときには、このビューが表示されます。注 : 共有ビューを保存するためには、TM1 管理者であるか、キューブの管理権限を持っている必要があります。

8.「OK」をクリックします。重要 : ビューを保存しないと、ビューを閉じるとき、または TM1 Web セッションを終了するときに、そのビューは TM1 Web によって破棄されます

キューブ・ビューからのレポート生成ブリーフィング・ブック・スタイルのレポートを、次に示す 2 とおりの方法で生成できます。• Cube Viewer - レポートに入れるタイトル・ディメンション・サブセットと行の数を選択する。• Web シート - レポートに入れるタイトル・ディメンション・サブセットを選択する。詳しくは、19 ページの『第 3 章 Web シートの処理』を参照してください。


注 : TM1 Web のインストール環境を、Web サーバーに Microsoft Excel がない状態で実行するように構成した場合は、Cube Viewer からエクスポートするときにいくつかの制限事項が適用されることがあります。詳しくは、48 ページの『Cube Viewer のエクスポートの制限』を参照してください。

手順1.「エクスポート」をクリックします。2.レポートのエクスポート形式を選択します。

• 「Excel にスライス」 - TM1 機能によってサーバーへのリンクを保持する Excel ドキュメント。スライスを開き、スライスが関連付けられているサーバーに接続すると、Perspectives アドインを有効にして Excel を実行している場合に、スライスは現在のキューブ値を表示します。

• 「Excel にスナップショット」 - エクスポートを実行したときのキューブ値を表す数値を含むExcel ドキュメント。スナップショットがサーバーへのリンクを保持しないため、値は静的であり、エクスポート時のキューブ値のスナップショットを表します。

• 「PDF にエクスポート」 - エクスポートを実行したときのキューブ値を表す PDF ドキュメント。「エクスポート」ダイアログ・ボックスが開きます。

3.エクスポートする行数を選択します。•「現在のページの行をエクスポートします」 - 現在のページの行のすべてをエクスポートする。•「先頭から現在のページまでの行をエクスポートします」 - 最初のページの最初の行から現在のページの最終行までエクスポートする。

•「ビューの行をすべてエクスポートします」 - すべてのページのすべての行をエクスポートする。4.レポートに入れるタイトル・ディメンションを選択します。5.「OK」をクリックして、レポートを作成します。レポート・シートが生成され、レポートを開くか保存するかを尋ねるプロンプトが表示されます。

6.次のいずれかを実行します。•「開く」をクリックして新規ブラウザー・ウィンドウでレポートを開く。•「保存」をクリックして、レポートをディスクに保存する。注 : デフォルトで、スライスまたはスナップショット・レポートの Excel へのエクスポートでは、Webブラウザーのウィンドウでレポートを表示します。スタンドアロン版の完全な Excel でレポートを開くようにコンピューターを設定する方法について詳しくは、Microsoft サポート Web サイトを参照してください。また、Excel にエクスポートしたスライスで TM1 の機能を使用したい場合は、スタンドアロン版の Excelでスライスを開く必要があります。また、ローカル・バージョンの Perspectives または Client をコンピューターにインストールしておく必要があります。注 : Excel または PDF ファイルにエクスポートする際に問題が発生し、さらに WAN (広域ネットワーク)サーバーを使用している場合は、Internet Explorer のセキュリティー設定の再構成が必要になることがあります。詳しくは、「Planning Analytics インストールおよび構成」資料の『TM1 Web の管理』セクションを参照してください。

Cube Viewer のエクスポートの制限Microsoft Excel が TM1 Web サーバー上に存在しない状態で、 Cube Viewer を「Excel にスライス」オプションまたは「Excel にスナップショット」オプションを使用してエクスポートした場合は、 Cube Viewer 内に存在するグラフが、生成されたワークシートにエクスポートされません。


第 5 章グラフの操作このセクションでは、TM1 Web でグラフを表示する方法を説明します。

手順1.ビューを開きます。2.次のいずれかを実行して、グラフを表示します。

• グラフ形式のみでキューブ・データを表示するには、「グラフの表示」をクリックします。縦棒グラフ (デフォルトのグラフ・タイプ) が表示されます。

• グラフ形式とグリッド形式の両方でキューブ・データを表示するには、「グラフとグリッドの表示」をクリックします。グリッドが上部に表示され、縦棒グラフ (デフォルトのグラフ・タイプ) が下部に表示されます。

• グリッド形式のみでキューブ・データを表示するには、「グリッドの表示」をクリックします。

グラフ・タイプの変更「グラフのプロパティー」メニューから、グラフ・タイプを変更できます。グラフ・タイプを変更するには、以下の手順に従います。

手順1.ツールバーで、「グラフのプロパティー」>「グラフのタイプ」をクリックします。2.選択可能なグラフ・タイプの 1 つ (「点グラフ」、「折れ線グラフ」、「縦棒グラフ」、または「円グラフ」など) を選択します。

グラフからのドリルグラフに表示されるキューブ・セルに対するドリルスルーのプロセスと規則を管理者が定義している場合、関連するデータをグラフからドリルスルーすることができます。ドリルスルーのプロセスおよび規則を作成する方法について詳しくは、TM1 Developer の資料を参照してください。グラフのコンポーネントが関連するデータの単一ソースに関連付けられている場合、データは新しい「表示」タブですぐに開きます。グラフのコンポーネントが関連するデータの複数のソースに関連付けられている場合、単一のソースを選択するように要求されます。例として、このセクションではドリルを実行する方法を紹介します。

手順1.グラフを表示するには、「グラフの表示」をクリックします。2.グラフの列を右クリックして、「ドリルスルー」をクリックします。セルが、関連するデータの 2 つ以上のソースとリンクされている場合、「ドリル」ダイアログ・ボックスが開き、グラフのコンポーネントが関連するデータ・ソースがリストされます。

3.表示するソースを選択して、「選択」をクリックします。

タスクの結果選択されたデータは、新しい「表示」タブで開きます。



第 6 章 TM1 Web でのサブセットの編集このセクションでは、IBM TM1 Web サブセット・エディターを使用して、分析対象データを決定する要素リストを作成および管理する方法について説明します。

サブセット編集の概要サブセット・エディター・ツールを使用すると、ビューで使用する要素の数を制限するディメンション用サブセットを定義することができます。ディメンションは、数千もの要素を持つことができます。しかし、あらゆるディメンションの要素をすべて必要とするビューはまずありません。多くの場合、ビューで使用する要素は、特定のデータ解析に必要なものに制限する必要があります。最高の結果を得るには、タイトル要素として表示される要素の数を制限してください。これにより、低速インターネット接続を用いてデータを参照する場合でも、データを効率的に表示できます。

動的サブセットと静的サブセットTM1 Web で動的サブセットを開くときには、動的サブセットが静的サブセットに変換されることを知らせる次の警告メッセージが表示されます。「このサブセットは式を使用して作成されました。このサブセットを変更すると式が削除され、サブセットは静的サブセットに変換されます。」サブセットを変更して保存すると、TM1 Web によって動的サブセットは静的サブセットに置換されます。静的サブセットに変換せずに動的サブセットを編集するためには、サーバー・エクスプローラー・サブセット・エディターを使用します。

サブセット・エディターを開くサブセット・エディターは、Web シートまたは Cube Viewer から開くことができます。

手順1. Web シートから、タイトル・ディメンションの右端にある「サブセット・エディターを開く」をクリックします。

2. Cube Viewer から、サブセットの右端にある「サブセット・エディターを開く」をクリックします。

サブセット・エディターでの編集サブセットに対して編集タスクを実行するには、サブセット・エディターを使用します。

手順1.ディメンションの横にある「サブセット・エディターを開く」をクリックします。サブセットが開きます。

2.サブセットの下部にある「サブセット・エディターを開く」をクリックします。

タスクの結果サブセット・エディターには、2 つのウィンドウがあります。使用可能な要素 (左ウィンドウ)ユーザーのサブセットに追加できる要素をすべて表示します。


サブセット (右ウィンドウ)サブセットの実際のメンバーだけを表示します。サブセットを保存する場合、「サブセット」ウィンドウ内の要素だけがサブセットに保存されます。

サブセット・エディターのツールバーの使用サブセット・エディターで使用可能な編集タスクには、そのツールバー・ボタンからアクセスします。次の表では、サブセット・エディターのツールバーのボタンについて説明します。ボタン名前説明

サブセットを保存「サブセット」リスト内に表示される要素のみをサブセットに保存します。

サブセットに名前を付けて保存

「サブセット」リスト内に表示される要素のみを異なる名前でサブセットに保存します。

サブセットの再ロード元のサブセットを再ロードします。

サブセットすべて親ディメンション内のすべての要素を表示します。

切り取り、コピー、および貼り付け

選択したサブセットの要素を切り取り、コピー、および貼り付けます。

選択した要素を維持サブセット用に選択した要素を維持します。

選択した要素を削除サブセットから選択した要素を削除します。

サブセットのフィルター

関連する特性を持つサブセット内の要素のグループを選択できます。次の方法で要素をフィルターできます。• レベルによるフィルター• 属性によるフィルター• 式によるフィルター

サブセットのソート次の方法でサブセットをソートできます。• 昇順にソート• 降順にソート• 階層順にソート• インデックスの昇順にソート• インデックスの降順にソート

ツリーの展開次の方法でツリーを展開します。• 選択した集約をドリルダウン - 選択した集約を 1 レベル展開します。

• 選択した集約を展開 - 選択した集約を展開し、すべての子孫を表示します。

• ツリーを完全に展開 - 階層全体を展開し、すべての親のすべての子を表示します。


ボタン名前説明ツリーの折りたたみ次の 2 つの方法でツリーを折りたたみます。

• 選択した集約を省略 - 展開した集約を折りたたみ、すべての子孫を非表示にします。

• ツリーを完全に省略 - 階層全体を折りたたみます。選択した要素の親を挿入

選択した要素の親を階層ツリー内のその要素のすぐ上に挿入します。

上へ展開「使用可能な要素」リストと「サブセット」リストの両方で、子のリストの最下部に集約を表示します。集約の子が集約の上部に展開されます。

カスタム集約を作成ビューでの作業中に、集約した要素をすぐに構築できます。詳しくは、60 ページの『カスタム集約の作成』を参照してください。

サブセット内で検索検索テキストを入力して、現在のサブセット内の要素を検索できます。

Cube Viewer での翻訳された要素名の表示TM1 Developer の資料の「モデルの翻訳」についての説明に従ってモデルを翻訳すると、翻訳した要素名を Cube Viewer で表示できます。

始める前に要素名の表示に使用する言語を、必ずブラウザーの表示言語として設定しておくようにしてください。

手順1. Cube Viewer で、翻訳された要素名を表示するディメンションをクリックします。ディメンションの現行のサブセットがサブセット・エディターで開かれます。

2.サブセット・エディターで、「別名」リストから「キャプション」を選択します。3.「OK」をクリックします。4.ビューを閉じてから開き直し、プロンプトが出たら変更を保存します。

Web ブラウザーの使用言語で要素が表示されます。要素の移動

ドラッグ・アンド・ドロップ操作を使用して、「使用可能な要素」ウィンドウから「サブセット」ウィンドウに要素を移動できます。この例では、「使用可能な要素」ウィンドウ中の「修復と保守」をクリックして「サブセット」ウィンドウ中の「その他の経費」の下にドラッグできます。

第 6 章 TM1 Web でのサブセットの編集 53

「その他の経費」要素の下線は、「修復と保守」要素が「その他の経費」の下に表示されることを示しています。

集約の移動ドラッグ・アンド・ドロップ操作により、「使用可能な要素」ウィンドウから「サブセット」ウィンドウに集約を移動できます。集約要素を移動させる場合、集約の子も移動します。この例では、Revenue という名前の集約の要素があると仮定します。Revenue を選択し、それを「サブセット」ウィンドウにドラッグする場合、折りたたまれた集約が「サブセット」ウィンドウに追加されます。

「使用可能な要素」ウィンドウ中の「Revenue」を展開して集約とその子を選択する場合、その集約を「サブセット」ウィンドウにドラッグできます。展開された集約が「サブセット」ウィンドウに追加されます。

どちらの例も、Revenue の集約およびその子が「サブセット」リストに追加されます。しかし、「サブセット」リスト中の集約の状態は、集約が表示される方法を反映します。最初の例では、Revenue には折りたたまれた集約が表示されます。2 番目の例では、Revenue は展開された集約として表示され、その子が表示されます。

要素の維持「サブセット」ウィンドウ中の要素のリストを、サブセット中に保持したい要素のみになるまで減らすことができます。この場合、他のすべての要素がサブセットから削除されます。注 : 「使用可能な要素」リストを小さくすることにより、サブセットに追加する要素の検索範囲を狭めることができます。範囲を狭めても、「サブセット」リスト内の要素には影響ありません。

手順1.「サブセット」リストで維持する要素を選択します。2.「選択した要素を維持」をクリックします。維持するように選択した要素のみが「サブセット」リストに表示されています。

3.「サブセットを保存」をクリックしてサブセットを保存します。


要素の削除選択した要素を「サブセット」ウィンドウから削除できます。

手順1. 1 つ以上の要素を「サブセット」ウィンドウから選択します。2.「選択した要素を削除」をクリックします。

タスクの結果選択した要素が「サブセット」ウィンドウから削除されます。削除した要素は、まだディメンション内に存在しています。注 : 削除したすべてのサブセット要素を表示するには、「サブセットすべて」をクリックします。

要素のフィルター「使用可能な要素」ウィンドウまたは「サブセット」ウィンドウのどちらかで要素をフィルターできます。以下のオプションを使用します。• 属性によるフィルター - 指定した属性と一致する要素のみを表示します。• レベルによるフィルター - 要素の階層中のレベルと一致する要素のみを表示します。• 式によるフィルター - パターンが一致する要素のみを表示します。属性によるフィルターサブセット・エディターでは、属性値によって要素をフィルターに掛けることができます。

手順1.「サブセットのフィルター」をクリックしてから、「属性によるフィルター」をクリックします。2.「属性を選択」リストから、属性を選択します。3.「照合する値を選択」リストから、値を選択します。4.「OK」をクリックします。

タスクの結果選択した属性の中で、この値と一致するすべてのサブセット要素が要素リストに残ります。選択した属性の中で、この値と一致しないすべてのサブセット要素は要素リストから削除されます。レベルによるフィルターサブセット・エディターを使用して要素をフィルターすると、1 つ以上の指定した階層レベルに属する要素だけを残せます。3 レベル階層の以下の例を考察します。この例では、図に表示されているサブセットで開始し、レベル 1 以外のすべてのサブセット要素を削除します。


手順1.「サブセットのフィルター」をクリックしてから、「レベルによるフィルター」をクリックします。2.リストの中のレベルをクリックして「OK」をクリックします。例えば、レベル 1 によってフィルターした場合、次のようにレベル 1 にあるサブセット要素が「サブセット」リストに残ります。• Revenue• COS

式によるフィルターサブセット・エディターを使用して要素をフィルターすると、指定した検索パターンに一致する要素のみを残すことができます。例えば、次のような要素のリストが「使用可能な要素」ウィンドウまたは「サブセット」ウィンドウにあるとします。• Sales• Other Revenue• Direct Cost• Other Costs• Bank Charges• Board of Directors• Employee Relations• Printing• Seminars and Continuing Ed.• Taxes and Licenses• Office Expense• Postage• Rent

ここで、このリストの中に“cost”という語を含む要素だけを表示したいと仮定します。

手順1.「サブセットのフィルター」をクリックしてから、「ワイルドカードによるフィルター」をクリックします。

2.英数字のパターンを「式を入力」ボックスに入力します。次の 2 つのワイルドカード文字を「式を入力」ボックスで使用できます。


• 疑問符 (?) - 1 文字を表すプレースホルダー• アスタリスク (*) - 1 文字以上の文字を表すプレースホルダー名前に文字列パターン cost が含まれるすべての要素を区別するには、開いたダイアログ・ボックスに式'cost' を入力します。

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

タスクの結果要素リストは、パターンと一致する要素のみを表示するよう整理されます。

要素の検索「サブセット内で検索」ツールバーを使用して、「使用可能な要素」ウィンドウまたは「サブセット」ウィンドウのいずれかで要素を検索できます。この機能では、入力したスペリング・パターンに一致する要素の単純なテキスト検索が実行されます。この機能は、多数の要素が含まれたリストの中から、特定の要素を検索する場合に特に便利です。注 : 「サブセット内で検索」機能は、検索テキストでの疑問符 (?) やアスタリスク (*) などのワイルドカード文字はサポートしていません。その代わりに、ユーザーが入力したスペリング・パターンの前後にアスタリスク (*) ワイルドカード文字が挿入され、要素のリスト内に存在するパターンの発生を検索することができます。例えば、スペリング・パターン ost を入力した場合は *ost* に変換され、検索結果は Cost や Boston などになります。

手順1.「サブセット内で検索」をクリックするか、Ctrl キーを押しながら F を押します。「サブセット内で検索」ツールバーがサブセット・エディター内で開きます。

2.検索ボックス内でスペリング・パターンを入力します。スペリング・パターンには、1 つ以上の英数字を含めることができますが、ワイルドカード文字は入力できません。入力したスペリング・パターンに従って要素のリストが検索されます。• 一致した要素が 1 つ以上見つかる場合、最初に一致した要素がリスト内で示されて強調表示されます。• 一致した要素が見つからない場合、検索ボックスの背景は一時的に赤くなります。また、リストのセクション内の要素をクリックすることで、要素のリスト内のどこからでも検索を開始することができます。ユーザーが検索を継続する場合、この新規開始点から検索を開始します。

3.一致する要素が複数見つかった場合は、「次を検索」または「前を検索」をクリックして要素のリストを移動できます。次のキーボード・コマンドを使用してナビゲートすることもできます。• 次に一致する要素を検索するには、F3 キーまたは Enter キーを押します。• 前の要素を検索するには、Shift キーを押しながら F3 キーを押すか、または Shift キーを押しながら

Enter キーを押します。前後に一致した要素が見つからない場合、検索ボックスの背景は一時的に赤くなり、リストを繰り返し検索します。

4.「検索バーを閉じる」をクリックして「サブセット内で検索」ツールバーを閉じます。要素のソート

「使用可能な要素」ウィンドウまたは「サブセット」ウィンドウにあるすべての要素をソートできます。


手順サブセットの要素をソートするには、「サブセットのソート」をクリックしてから、次のソート・オプションを選択します。ソート・オプションソート順昇順にソート A から Z、0 から 9 の昇順に並べ替えます。降順にソート Z から A、9 から 0 の降順に並べ替えます。階層順にソート親の下に子がすべて表示されます。インデックスの昇順にソート 1 から始まるディメンション・インデックスです。インデックスの降順にソートディメンション内の最も高いインデックスから始まるディメンシ

ョン・インデックスです。

集約の展開と折りたたみサブセット・エディター内で集約を展開して、集約の直接の子、または集約のすべての子孫を表示できます。以下の手順は、サブセット・エディターの「使用可能な要素」ウィンドウまたは「サブセット」ウィンドウのいずれかの要素に適用できます。集約の展開集約を展開できます。

手順1.展開する集約を選択します。2.「ツリーの展開」をクリックします。3.次のうちいずれかを選択します。

•「選択した集約をドリルダウン」をクリックして集約の直接の子を表示します。次の図は、“TotalBusiness Unit”集約上でドリルダウンした結果を示しています。「選択した集約をドリルダウン」をクリックすると、"Total Business Unit" の直接の子が表示されます。

•「ツリーを完全に展開」をクリックして、集約のすべての子孫を表示します。次の図は“Total BusinessUnit”集約を展開した結果を示しています。


•「ツリーを完全に展開」をクリックして、ディメンション階層内のすべての親のすべての子孫を表示します。

集約の折りたたみ選択した集約を使用して、展開された集約を折りたたむか、またはサブセット内の展開されたすべての集約を閉じることができます。

手順1.折りたたむ展開された集約を選択します。2.「ツリーの折りたたみ」をクリックします。3.「選択した集約を省略」をクリックします。注 : サブセット内の展開された集約のすべてを閉じるには、「ツリーの折りたたみ」をクリックしてから、「ツリーを完全に省略」をクリックします。

親の挿入選択した要素の直接の親を、サブセット・エディター内のその要素のすぐ上に直接挿入できます。例えば、複数のリーフ要素を表示する次の例を用いて説明します。

すべての要素を選択して、「選択した要素の親を挿入」をクリックすると、次の例に示すように、選択したすべての要素の直接の親が挿入されます。


カスタム集約の作成ビューで作業する場合、既存のサブセットまたは選択したサブセット要素からカスタム集約を作成できます。

既存のサブセットからのカスタム集約の作成既存のサブセットを現在のサブセットに挿入することにより、カスタム集約を作成することができます。これにより、既存のサブセットは、現在のサブセット内のカスタム集約となります。

手順1.ディメンションのサブセット・エディターを開きます。2.「サブセット」ウィンドウ内でサブセットを定義します。3.「カスタム集約を作成」をクリックしてから、「サブセットから集約を作成」をクリックします。4.現在のサブセットに、カスタム集約として挿入したい既存のサブセットを選択します。選択したサブセットがカスタム集約として現在のサブセットに挿入されます。

5.必要に応じて、「サブセットを保存」または「サブセットに名前を付けて保存」をクリックして、現在のサブセットを保存します。

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

タスクの結果新規カスタム集約のあるサブセットが開きます。

選択した要素からのカスタム集約の作成サブセット・エディター内の選択した要素からカスタム集約を作成できます。

手順1.ディメンションのサブセット・エディターを開きます。2.「サブセット」ウィンドウ内で、カスタム集約に含めたい要素を選択します。3.「カスタム集約を作成」をクリックしてから、「選択した要素から集約を作成」をクリックします。これで、手順 2 で選択した要素を含むカスタム集約が作成されました。}ROLLUP_ # という名前のカスタム集約が割り当てられます。# は、0 から始まり、サーバー・セッション中にユーザーが作成したカスタム集約ごとに 1 つずつ増加します。

4.「OK」をクリックして、新規カスタム集約を表示します。


第 7 章ライトバック・モードとサンドボックスIBM TM1 では、さまざまな方法でデータを変更できます。ライトバック・モードとサンドボックスの種類の組み合わせにより、サーバー・データに対する変更をどのように管理するかが決まります。さまざまなオプションがあるため、管理者は各種機能を組み合わせて、インストール環境やユーザー・グループごとに最適な作業方法を設定できます。詳しくは、個人用ワークスペースまたはサンドボックスの使用を参照してください。

ライトバック・モードIBM TM1 では、個人用領域で変更を保留にすることができます。これにより、データの変更をサーバーに書き戻して他の人に利用できるようにするタイミングを手動で決定することができます。この個人用領域は、機能範囲に応じて個人用ワークスペースまたはサンドボックスと呼ばれます。個人用領域にあったデータ変更をベース・データにコミットすると、変更した値はサーバーに書き込まれます。個人用ワークスペースなしで、ベース・データを直接使用する場合は、ダイレクト・ライトバック法を選択できます。管理者が提供できる別のオプションとしては、データ変更に名前を付けて、名前付きサンドボックスに保存する機能があります。サンドボックスまたは個人用ワークスペースで作業するときには、TM1 は、データがまだベースに統合されていないことを示すためにセルの色を変更します。サンドボックスまたは個人用ワークスペースをコミットすると、セルの色は黒に戻ります。詳細については、変更したデータ値のセルの色分けの理解を参照してください。管理者は各ユーザー・グループに機能を割り当てます。ユーザーは複数のグループのメンバーになれるため、作業領域のオプションはログオン、使用するクライアント、設定の組み合わせに応じて異なります。管理者だけに機能の割当へのアクセス権があります。システムの設計動作について詳しくは、管理者にお問い合わせください。ツールバーを使用してライトバック・モードとサンドボックス設定を調べる方法については、さまざまなツールバー・オプションについてを参照してください。機能の割り当ての詳細については、TM1 Operations の資料を参照してください。

ライトバック・モードの設定ライトバック・モード機能によって、データをサーバーに書き戻す方法が決まります。ライトバック・モードは、ユーザーの個人用ワークスペース機能のオンまたはオフによって決定されます。個人用ワークスペースおよび機能モードで変更の書き戻しが処理される方法をリストした表。説明個人用ワークスペース・

モード機能モード

変更はベースに対して直接行われます。オフ変更は一時領域に保持され、「コミット」ボタンまたはオプションを使用してベースに手動で書き込まれます。セルの色分けは、データが変更されたものの、まだコミットされていない場合に変わります。ジョブ・キューを使用して処理できます。

オン

サンドボックス機能は、サンドボックスに名前を付けることができるかどうか、またはデフォルトのサンドボックスを 1 つもっているかどうかを判定します。


サンドボックスおよび機能モードで変更が処理される方法をリストした表。説明サンドボックス

機能モードサンドボックスに名前を付けて、複数のサンドボックスを管理できます。オンデフォルトのサンドボックスを 1 つだけ使用できます。オフ設定の組み合わせによって、データ変更を保存し、処理する方法が決まります。例えば、ユーザー・グループが名前の付けられたサンドボックスにダイレクト・ライトバックを提供しているとします。これは、TM1 により使用されるデフォルトの作業設計です。つまり、個人用ワークスペースは利用できませんが (代わりに、サーバーへのダイレクト・ライトバックを利用)、変更の集合に名前を付けて手動で送信するという方法は利用できます。この設定により、最初にビューを開くとベースが表示され、ここで行った変更は直接ベースに書き込まれます。しかし、名前を付けたサンドボックスに変更を保存することにした場合は、ベースを更新するためにこれらの変更を手動で送信する準備ができたときに「コミット」ボタンを使用できます。データを直接サーバーに送信する場合を考えてみましょう。サーバーを更新する前に、グループ化したい変更の集合があるとします。その場合、「サンドボックスの作成」オプションを使用して、「最適事例」という名前の私用サンドボックスに現在のデータ変更を保存できます。最適事例サンドボックスで、変更をベースに送信して他の人も変更を使えるようにするには、「コミット」を使用する必要があります。最適事例がコミットされると、これらの変更はベースに統合されて他の人も変更を見ることができるようになり、ベースは更新されます。サンドボックスで作業をしている場合は、他の人が変更を見られるようにするため、手動でサンドボックスをコミットしなければなりません。それらの変更を共有にする準備ができていること、変更をベースに統合する必要があることを確認してください。ベースに戻る場合は、ダイレクト・ライトバックを使用して戻ります。この設定は高い柔軟性を提供します。この設定のあるユーザーは、ベースを更新するタイミングと、他の人が変更を使用できるように「コミット」ボタンを押すタイミングを覚えておく必要があります。そうしないと、個人用ワークスペースのライトバック・モードで柔軟に作業したいものの、名前付きサンドボックスを作成するのは面倒だから避けたがっていると、管理者から思われてしまう可能性があります。その場合、管理者はユーザーに個人用ワークスペースのライトバック・モードを付与しますが、サンドボックス機能は認めない可能性があります。

さまざまなツールバー・オプションについて自分のユーザー・グループが、ツールバーに示されたオプションに基づいてどのように機能するように設計されているかを調べることができます。例えば、サンドボックスを付与されている場合は、サンドボックスの作成と削除オプションへのアクセス権があります。サンドボックス・リストが表示されない場合は、個人用ワークスペース・ライトバック・モードがあります。

ダイレクト・ライトバックと名前付きサンドボックスの使用デフォルトでは、IBM TM1 はダイレクト・ライトバックと名前付きサンドボックスを使用するように設定されています。管理者は作業オプションを一部変更して設定している場合があります。個人用ワークスペースおよびサンドボックスの設定を示す 3 列の表。実行する操作個人用ワークスペー

ス・モードサンドボックス

データ変更でサーバーをただちに更新する。時々、変更の集合を保存して名前を付け、サーバーにコミットする。

オフオン

ダイレクト・ライトバックと名前付きのサンドボックスがある場合は、「コミット」ボタンと「データのリセット」ボタンがグレー化された状態でツールバーが開始し、「サンドボックス」ボタンが使用でき、サンドボックス・リスト領域に「ベース」が表示されます。


「サンドボックス」ボタンは、サンドボックスを作成および削除できることを示します。コミットするものがまだ存在しないために、「コミット」ボタンはグレー化されますが、表示はされます。データを変更して、名前付きのサンドボックスに保存することに決めた場合は、「コミット」と「データのリセット」を使用できるようになります。セルの色は、サンドボックスに名前を付けた場合にのみ変わります。サンドボックスに名前を付けるまで、ベースで操作することになります。ジョブ・キューイングがオンになると、サーバーへのサンドボックスの送信は、データ変更がコミットされる前のキューの処理に従います。

個人用ワークスペースと名前付きサンドボックスの使用個人用ワークスペースは、ユーザーがデータ変更を評価してからベースにコミットすることができる個人用の作業領域です。コミットすると、データがベースと統合されて他のユーザーも利用できるようになります。個人用ワークスペースを使用すると、一般にはダイレクト・ライトバックよりもパフォーマンスが向上します。コミットする前にデータ変更を評価できるのでサーバーの処理が減少することが多いからです。ジョブ・キューイングをオンにした場合は、個人用ワークスペースがキュー処理を受けた後に、コミットされた変更がベースに統合されます。個人用ワークスペースでは、ベース・データから作業を開始します。データのエントリーを変更すると、変更したコンテンツと集約値や規則生成値などの従属セルの色が青に変わります。この色は、まだベース・モデルには統合されていない変更であることを示します。個人用ワークスペースをコミットして処理が完了すると、色が黒に戻り、再びベースに対して作業を行うことになります。『変更したデータ値のセルの色分けの理解』を参照してください。個人用ワークスペースを付与され、サンドボックスの命名権限も付与されている場合は、サンドボックス・データの開始点がツールバーに [デフォルト] として示されます。個人用ワークスペースで作業しているときには、「コミット」ボタンと「データのリセット」ボタンにアクセスできます。実行する操作個人用ワークスペ

ース・モードサンドボックス

常に個人用領域で作業し、変更を手動でサーバーにコミットするタイミングを決定する。時々、変更の集合を保存して、それらに「最適事例」などの名前を付けてからサーバーにコミットする。

オンオン

個人用ワークスペースと名前付きのサンドボックスがある場合は、ツールバーに「コミット」、「データのリセット」、「サンドボックス」の各ボタンが含まれ、サンドボックスの開始点は [デフォルト] と表示されます。

個人用ワークスペースで作業しているため、「コミット」ボタンと「データのリセット」ボタンが表示されます。 [デフォルト] サンドボックスによって、サンドボックスに名前を付けるまでの開始点であるサンドボックスが示されます。

名前付きサンドボックスがない個人用ワークスペース個人用ワークスペースは利用可能で、サンドボックスの命名権限はない場合、「サンドボックスの作成」ボタンおよび「サンドボックスの削除」ボタンは表示されず、サンドボックスのリスト領域もありません。これは、常に同じ (単一の) 個人用ワークスペースで作業するからです。

第 7 章ライトバック・モードとサンドボックス 63

実行する操作個人用ワークスペース・モード

サンドボックス

常に個人用領域で作業し、変更を手動でサーバーにコミットするタイミングを決定する。複数のサンドボックスの名前付けを許可しない。

オンオフ

個人用ワークスペースは利用可能で、名前付きサンドボックスの作成権限はない場合、ツールバーに「コミット」および「データのリセット」は表示されますが、サンドボックス・リスト領域は表示されません。

常に同じ個人用ワークスペースで作業するので、リストするサンドボックス名はありませんが、「コミット」および「データのリセット」にアクセスできます。

サンドボックスなしのダイレクト・ライトバックこれが従来の IBM TM1 のダイレクト・ライトバック・モードです。このモードでは、名前付きのサンドボックスも個人用ワークスペースも利用できません。「コミット」ボタンや「データのリセット」ボタンにアクセスできず、ジョブ・キューを使用する機能もありません。このオプションでは、データ変更は色の変化で示されません。このモードでデータを変更すると、サーバーがただちに更新されます。ダイレクト・ライトバックをインストール全体で使用するには、サーバーの設定ファイルでDisableSandboxing=T 設定を使用します。この設定ファイルでサーバー全体のサンドボックスを無効にすると、機能の割当は無視されます。実行する操作個人用ワークスペー

ス・モードサンドボックス

変更をサーバーでただちに有効にする。他のユーザーはすべての変更をただちに利用できる。

オフオフ

この場合、ツールバーにはサンドボックスの各ボタン、「コミット」、「データのリセット」のいずれも表示されません。

どのサンドボックスにもアクセスできません。このモードでデータ変更を元に戻す唯一の方法は、「元に戻す」/「やり直し」を使うことです。

個人用ワークスペースまたはサンドボックスの使用サンドボックスを使用して自分用のワークスペースを作成し、データ値の変更を入力して、ベース・データとは別に保管することができます。サンドボックスはベース・データのコピーではなく、ベース・データの上に自分のデータ値を入力できる別のオーバーレイまたはレイヤーです。この特徴によってパフォーマンスが大幅に向上するので、データを変更する際に理解しておくことが重要です。• ベース・データは、すべてのユーザーがアクセスできるデータです。ベース・データに対して行われた編集は、データベースに直接書き戻されます。

• サンドボックス・データは、自分用の作業領域であり、何度でもデータ値を編集し、変更したデータをベース・データとは別に保存することができます。サンドボックスと個人用ワークスペースは各ユーザーに専用のものがあり、他のユーザーが見ることはできません。ベース・データにコミットされて初めて他のユーザーはデータ値を見ることができます。個人用ワークスペースはデフォルトの特別なサンドボックスであり、名前はありません。その機能がオンであればいつでも使用できます。サンドボックスはクライアントには保存されません。サンドボックスは、サーバーの独立した個人用領域で構成されます。サンドボックスで作業する場合は、ベース・モデル・データがサンドボックスに透過す


ると考えます。サンドボックスでデータを変更すると、サンドボックスに入力した値によって、ベース・モデルのデータ値が一時的にブロックされたようになります。ベース・モデルにサンドボックスの値を適用するには、サンドボックスをコミットする必要があります。サンドボックスのデータ値をコミットすると、そのデータ値がベースと統合され、変更した値が新たにベース値になります。サンドボックスと個人用ワークスペースには以下の機能があります。• 個人的なデータ変更。サンドボックスと個人用ワークスペースを使用すると、データ変更を他のユーザーに公開する前に、また、ベース・データにコミットする前に、さまざまなデータ変更を試すことができます。

• セルの色分け。サンドボックスまたは個人用ワークスペースでのセルの値の変更は、セルのコンテンツの色の違いで示されます。変更がまだベース・データに統合されていないことを示すためにセルの色が変わります。データがコミットされ、処理が完了すると、セルの色は黒に戻ります。セルの色分けは、集約セルや規則算出値のセルなど、編集の影響を受けたすべての従属セルにも適用されます。詳しくは、66 ページの『変更したデータ値のセルの色分けの理解』を参照してください。

• 手動コミット。サンドボックスまたは個人用ワークスペースで作業するときには、「コミット」ボタンが使用可能になるので、変更をベースにコミットするタイミングを決定できます。データをコミットすると、他のユーザーが変更を使用できるようになります。

• データのリセット。サンドボックスまたは個人用ワークスペースでは「データのリセット」ボタンが使用可能になるので、サンドボックスを最後にコミットしたときの状況まで戻すことができます。

• 名前付きサンドボックスでは、what-if シナリオを作成できます。構成設定によっては、複数のサンドボックスに「最良事例」や「最悪事例」などの名前を付けて、それらのサンドボックスを切り替えながら編集の影響を比較できます。

• 仮想サンドボックス・ディメンション。構成設定によっては、仮想サンドボックス・ディメンションに複数のサンドボックスを組み込み、1 つのビューでサンドボックスを比較することができます。例えば、サンドボックスの値とサンドボックス間の計算値を横並びのビューで比較する、といったことが可能です。要確認 : 管理者がユーザーの環境のサンドボックスを無効化したり、ユーザー・グループのライトバック・モードを変更したりする場合があります。サンドボックスで作業をするためには、最初にビューをオープンして新しいサンドボックスを作成するか、既存のサンドボックスを選択する必要があります。サンドボックスで作業する場合、選択したサンドボックスは現在のユーザー・セッションの他のすべてのビューに適用されます。

サンドボックスのリーフ・セルと集約セルのデータ値サンドボックスでのリーフ・セルおよび集約セルのデータ値が計算されます。• サンドボックスのリーフ・セルの値は、基本およびサンドボックスのセルの値を連結したものです。サンドボックスのリーフ・セルにユーザーが入力した値は、基本の値を上書きします。サンドボックスで変更されていないリーフ・セルは、ベース・データを示します。

• サンドボックスの集約セルは、サンドボックスで表示されるリーフ・セルの合計の値です。サンドボックスまたは個人用ワークスペースのデータ値のリセット

個人用ワークスペースまたはサンドボックスをリセットすると、その時点までに入力したすべての変更データ値がクリアされ、すべてのデータ値がベース・データの現在の値にリセットされます。

手順使用する TM1 コンポーネントに応じて、次のいずれかを実行します。


• TM1 Web および Server Explorer または Architect において、サンドボックスのリストをクリックして「サンドボックスのリセット」を選択します。

• TM1 Perspectives または Microsoft Excel で、サンドボックス・ツールバーの「サンドボックスのリセット」ボタンをクリックします。

タスクの結果サンドボックスの全てのデータ値は、ベース・データの現在の値に設定されます。セルの色分けはクリアされ、黒になります。

変更したデータ値のセルの色分けの理解個人用ワークスペースまたはサンドボックスに新しい値を入力すると、その新しい値がベース値とは異なる値であることを示すためにビジュアル・インジケーターがそのセルに適用されます。使用する TM1 コンポーネントの種類に応じて、データの色が黒から青や緑に変わるか、セルの外観が変わります。集約セルや規則算出値のセルなどの従属セルがある場合、編集によって再計算されるなら、それらも外観が変わります。サンドボックスまたは個人用ワークスペースに新しいデータ値を入力したときにさまざまな TM1 ユーザー・インターフェースに適用されるセルの色分けを以下の表にまとめます。セルの内容を更新したときにセルの内容の色がどのように変わるかを示す表。「ダイレクト」列および「個人用ワークスペースまたはサンドボックス」列は、考えられるライトバック・モードを表しています。セルの色 TM1 コンポーネントダイレクト個人用ワークスペースま

たはサンドボックス黒 TM1 Perspectives /

Microsoft Excel Architect

サーバー・エクスプローラー

新しい値を入力しても、色は変わりません。すべての値は黒で表示されます。

コミットした個人用ワークスペースまたはサンドボックスのデータ。

青 TM1 Perspectives /

Microsoft Excel Architect

サーバー・エクスプローラー

なし新しく入力したデータ。編集したセル、従属セルまたは集約セル、再計算されたセル

セルの左下隅に青で表示 TM1 Perspectives /

Microsoft Excel

なし新しく入力したデータ。編集したセル、従属セルまたは集約セル、再計算されたセル

緑 TM1 Web

Cube Viewer と Web シート

新しい値新しい値

変更データを個人用ワークスペースまたはサンドボックスからベースへコミット「コミット」コマンドまたはボタンは、個人用ワークスペースまたはサンドボックスで変更したすべてのデータ値をベース・データに統合します。コミット操作を元に戻すために「元に戻す」コマンドを使うことはできません。注 : 複数のサンドボックスがあり、そのうちの 1 つをベースにコミットする場合、他のサンドボックスの全ての変更されていないセルに新しいベース・データが自動的に適用されます。他のサンドボックスに新し


いデータ値を入力した場合は、そのデータ値は残りますが、ベース・データにコミットされた新しい値を表示しません。次の図は、複数のサンドボックスを使用しているときにサンドボックスの値をベース・データにコミットする場合の例です。この図では、サンドボックス 3 の新しい値がベース・データにコミットされ、新しいベース・データは他のサンドボックスの変更されていないセルに適用されています。この図では、変更されたデータを含んでいるサンドボックスのセルが、どのように更新されないかを示しています。

手順使用する TM1 コンポーネントに応じて、次のいずれかを実行します。• TM1 Web および Server Explorer / Architect において、サンドボックスのリストをクリックして「サンドボックスのコミット」を選択します。

• TM1 Perspectives/Microsoft Excel で、サンドボックス・ツールバーの「サンドボックスのコミット」ボタンをクリックします。

TM1 は、次の操作を実行します。• 現在のサンドボックスの変更したデータ値は、ベース・データに保存されます。• 現在のサンドボックスの変更したデータのセルの色分けはクリアされ、黒になります。• 新しいベース・データ値は、他のサンドボックスの全ての変更していないセルに適用されます。複数のサンドボックスがある場合は、メニュー・バーのプルダウン・オプションを使用して、サンドボックスの作成、削除、および使用可能な別のサンドボックスの選択を行うことができます。一部のインターフェースには、「サンドボックスの削除」ボタンがあります。



第 8 章 TM1 Web とスコアカードスコアカード機能が TM1 Web に組み込まれています。TM1 Web 内から直接スコアカード・キューブおよびスコアカード図を表示したり、それらと対話したりすることができます。TM1 スコアカードを使用して、以下を行うことができます。• 組織の戦略と目標を視覚的にモニターする。• 信号ステータスと傾向アイコンを使用して、重要業績評価指標 (KPI) をモニターする。• スコアカード図およびデータの可視化を表示し、それらと対話する。

スコアカードとはスコアカードは、事業単位または組織の戦略的目標を反映するように設計された一連の業績評価指標です。スコアカード情報は、計画と実績を比較することで、目標がどの程度達成されているかを示します。また、スコアカードには企業におけるさまざまな組織の情報も表示できます。スコアカードで信号や傾向アイコンなどの視覚的なステータス・インジケーターを使用すると、ビジネス・パフォーマンスを素早く評価することができます。スコアカードでは、評価指標ディメンションおよび評価指標インジケーター・ディメンションを使用します。評価指標重要な事業領域の業績を示す数値データまたは重要業績評価指標 (KPI)。例として、利益、売上および経費などがあります。

評価指標インジケーター重要な事業領域 (評価指標) の業績、ステータス、または傾向の数値データ。評価指標インジケーターは現在の結果とターゲット値を比較します。例えば、スコア、ステータス、および傾向などです。

TM1 Web でのスコアカード・オブジェクトの操作TM1 Web で、以下のスコアカード・オブジェクトを表示したり、それらと対話したりすることができます。評価指標キューブ評価指標キューブは、スコアカード図の基礎となる特殊なタイプの TM1 キューブです。このタイプのキューブは、評価指標ディメンションと評価指標インジケーター・ディメンションを、他の標準 TM1ディメンション (時刻、ジオグラフィー、または製品など) と組み合わせます。キューブのセルに直接表示される信号ステータスおよび傾向インジケーター・アイコンを使用して、評価指標キューブのスコアカード情報を表示して分析することができます。

影響図影響図では、評価指標キューブの評価指標間の正と負の関係が視覚化されます。このタイプの図では、ある評価指標が別の評価指標にどのように影響を与えるかを表示します。

戦略マップ図戦略マップは、視点、目標、および評価指標が、信号ステータスおよび傾向インジケーター・アイコンと共に 1 つの図の中で結合される、業界標準の可視化図です。

ユーザー指定の図ユーザー指定のスコアカードの図は、評価指標とカスタム画像を組み合わせた戦略マップです。評価指標は、ディメンション・コンテキストと共に画像の上部にデータ・ポイントとして表示されます。

スコアカードのモデル化スコアカード・オブジェクトは、IBM TM1 Performance Modeler で作成されます。詳細については、管理者に問い合わせるか、TM1 Performance Modeler 資料を参照してください。


スコアカード・サンプルTM1 インストール環境には、GO_scorecards という名前のスコアカード・データベース・サンプルが用意されています。このサンプルの使用について詳しくは、管理者に問い合わせるか、「Planning AnalyticsInstallation and Configuration」資料を参照してください。

TM1 Web のスコアカード・オブジェクトTM1 Web で評価指標キューブ、影響図、および戦略マップ図を表示し、それらと対話することができます。

TM1 Web の評価指標キューブIBM TM1 Web で評価指標キューブを表示して、スコアカード情報を確認および分析できます。評価指標キューブは、スコアカード図の基礎となる、特殊なタイプの TM1 キューブです。このタイプのキューブは、評価指標ディメンションと評価指標インジケーター・ディメンションを、他の標準 TM1 ディメンション (時間、ジオグラフィー、または製品など) と組み合わせます。評価指標キューブと標準キューブの主な違いは、評価指標キューブでは、キューブのセルに信号ステータスおよび傾向インジケーター・アイコンが直接表示される点です。これらの評価指標インジケーター・アイコンは、キューブ内の各評価指標のステータスと傾向を示します。評価指標キューブの標準的なスコアカード・レイアウトを以下に示します。• 行タイトル・ディメンション : 評価指標ディメンション• 列タイトル・ディメンション : 評価指標インジケーター・ディメンション• 必要なコンテキスト・ディメンション : 時間• オプションのコンテキスト・ディメンション : ジオグラフィー、製品、またはその他のデータ・コンテキスト・ディメンション。

1.幾何ディメンション2.評価指標インジケーター・ディメンション3.コンテキスト・ディメンション4.時間ディメンション5.信号ステータス・インジケーター・アイコン6.傾向インジケーター・アイコン


評価指標インジケーター評価指標キューブの評価指標インジケーターでは、現在の結果を目標値と比較することで、重要な事業領域における業績、ステータス、および傾向を評価します。例えば、評価指標の実績、目標、および許容範囲インジケーターは、通常、関連するスコア、ステータス、および傾向インジケーターを計算するために使用されます。評価指標インジケーターは、数値として表示することも、信号や傾向アイコンとして視覚的に示すこともできます。評価指標インジケーター・ディメンションは、通常、スコアカード・キューブ・ビューの列ディメンション・タイトルに表示されます。

信号ステータス・インジケーター信号またはステータス・インジケーターは、評価指標インジケーターのステータスを表示するアイコンです。ステータスは、次の表で説明されているように、アイコンの色と形状で示されます。表 1. 評価指標インジケーターの信号ステータス・アイコン信号アイコン説明

緑色の円アイコンは、関連付けられている評価指標インジケーターが満足できるステータスにあることを示します。黄色のひし形アイコンは、関連付けられている評価指標インジケーターのステータスに関する注意を示します。赤色の正方形アイコンは、関連付けられている評価指標インジケーターのステータスに関する警告を示します。この画像は、実績インディケーターまたは目標評価指標インジケーターのデータがない場合の、不完全なステータスを表します。これらの値のいずれか 1 つが欠落している場合、スコアまたはステータスを算出できません。

傾向インジケーター傾向インジケーターは、ある列の値と別の列の値との比較結果を示します。この傾向インジケーターは、値が他の値より大きいか小さいか、あるいは値に変化がないかを示します。表 2. 評価指標インジケーターの傾向アイコン傾向アイコン説明

緑色の上向き三角形アイコンは、傾向値が前の期間より大きいことを示します。例えば、値が前月または前四半期より大きい場合などです。灰色のダッシュ・アイコンは、傾向値に変化がないことを示します。赤色の下向き三角形は、傾向値が前の期間より小さいことを示します。例えば、値が前月または前四半期より小さい場合などです。

空白セルその期間中の傾向が未完了であることを示します。未完了ステータスがある場合、傾向は表示できません。例えば、Q1 (第 1 四半期) などの最初の時間枠では、前のデータが存在しないため、評価指標に実績、目標、スコア、およびステータスの値がある場合であっても、傾向を表示することはできません。

TM1 Web の影響図影響図では、評価指標キューブの評価指標間の正と負の関係が視覚化されます。このタイプの図では、ある評価指標が別の評価指標にどのように影響を与えるかを表示します。注 : デフォルトでは、1 つの評価指標キューブ内に存在できる影響図は 1 つだけです。

第 8 章 TM1 Web とスコアカード 71

影響図は、評価指標を以下の 3 つのカテゴリーに編成します。• 影響を与える評価指標• 注目対象の評価指標• 影響を受ける評価指標例えば、影響図では、売上と経費が利益にどのように影響し、その後、利益がボーナスと研究資金にどのように影響するかを示すことができます。

図に示される線は、図中の評価指標間の影響関係を表します。これらの線は、評価指標が注目対象の評価指標について良い影響を与えるか、悪い影響を与えるかを示します。• 実線 - ある評価指標から別の評価指標に対する良い影響を表します。• 破線 - ある評価指標から別の評価指標に対する悪い影響を表します。影響図には信号と傾向インジケーターのアイコンも表示され、図中の各評価指標のステータスと傾向が示されます。

TM1 Web の戦略マップ戦略マップは、視点、目標、および評価指標によってビジネス・パフォーマンスを追跡する、業界標準の可視化図です。戦略マップでは、視点、目標、および評価指標が以下の階層に編成されます。• 戦略マップには複数の視点を含められます。• 各視点には複数の目標を含められます。• 各目標には複数の評価指標を含められます。

視点戦略マップの標準的な視点には、以下のようなものがあります。• 財務• 顧客• 内部処理• 学習と革新


ステータスおよび傾向インジケーター戦略マップでは、視点、目標、評価指標が、信号ステータスおよび傾向インジケーター・アイコンと共に1 つの図に結合されます。目標の上にマウスを移動すると、関連する評価指標インジケーターのステータスおよび傾向の詳細なリストが表示されます。視点のインジケーター・アイコン上にマウスを移動すると、図と視点の名前が表示されます。

関連戦略マップでは、「関連」と呼ばれる方向矢印を表示して、図中の目標の視覚的な関係やフローを示すこともできます。

TM1 Web のユーザー指定の図TM1 Web で図表機能を使用して、ユーザー指定のスコアカードの図を表示できます。ユーザー指定のスコアカードの図には、カスタム画像の上部にデータ・ポイントとしてディメンション・コンテキストを持つ評価指標が表示されます。ユーザー指定の図の例のいくつかが、以下のリストに示されています。地域マップ北米またはヨーロッパにおける在庫またはコストの評価指標など、場所や地域における組織のさまざまなフォーカスの評価指標を表示します。

プロセス・ダイアグラムプロセス・フローのコンテキストにおける評価指標を表示します。

ユーザー指定の図には、評価指標とコンテキスト・ディメンションの名前が、画像上に、信号機および傾向インジケーター・アイコンと共にオーバーレイで表示されます。評価指標の上にマウス・カーソルを移動すると、そのポイントの詳細情報がポップアップ・ウィンドウで表示されます。


TM1 Web での評価指標キューブの表示IBM TM1 Web では、他の TM1 キューブやビューと同じように、スコアカード評価指標キューブを表示できます。評価指標キューブは、ログオンしたサーバーに存在するその他のすべての TM1 キューブおよびビューと共に、TM1 Web のナビゲーション・ウィンドウにリストされます。

手順1. TM1 Web ナビゲーション・ウィンドウで、開く評価指標キューブを見つけ、以下のいずれか 1 つを実行します。• キューブをダブルクリックして、デフォルト・ビューを開きます。• そのキューブのノードを展開し、特定のビューをクリックします。評価指標キューブが開き、セル値に信号と傾向インジケーターのアイコンが表示され、キューブ内の各評価指標のステータスと傾向が示されます。

2.ツールバーの「グラフの表示」および「グラフのプロパティー」>「評価指標の図」アイコンを使用して、その評価指標キューブに関連するスコアカードの図を表示します。詳細については、75 ページの『TM1 Web での影響図の表示』および 75 ページの『TM1 Web での戦略マップの表示』を参照してください。


TM1 Web での影響図の表示IBM TM1 Web で、スコアカードの影響図を表示することができます。

始める前にこのタイプの図を表示するためには、使用する TM1 サーバーに、スコアカード評価指標キューブが 1 つ以上含まれている必要があります。

手順1.評価指標キューブ・ビューを開きます。詳しくは、74 ページの『TM1 Web での評価指標キューブの表示』を参照してください。

2. TM1 Web レイアウトを変更して、グラフを表示します。ツールバーで、「グラフの表示」アイコンまたは「グラフとグリッドの表示」アイコンのどちらかをクリックします。

3.「グラフのプロパティー」>「評価指標の図」>「影響図」をクリックします。現行の評価指標キューブ・ビューの影響図が表示されます。注 : デフォルトでは、評価指標キューブに含めることができる影響図は 1 つだけなので、選択肢は 1 つだけです。

4.この図の評価指標の上にマウス・カーソルを移動して、その評価指標の評価指標インジケーターに関する情報を参照します。

5.評価指標の横にあるプラス (+) アイコンおよびマイナス (-) アイコンをクリックして、図のセクションを展開および縮小します。

6. TM1 Web サブセット・エディターを使用して、図中のフォーカスされる評価指標を別の評価指標に変更します。a)キューブ・ビューで、評価指標のタイトル・ディメンションの横にある「サブセット・エディターを開く」をクリックします。サブセット・エディターが開きます。

b)フォーカスされる評価指標として使用する評価指標を、「サブセット」ペインにドラッグします。c)「サブセット」ペインで、使用する評価指標をクリックします。d)「OK」をクリックします。影響図が更新されて、選択した評価指標がフォーカスされる評価指標として表示されます。

TM1 Web での戦略マップの表示IBM TM1 Web で、スコアカードの戦略マップ図を表示することができます。

始める前に使用する TM1 サーバーに、スコアカード評価指標キューブが 1 つ以上含まれていて、そのキューブにそのキューブ用の戦略マップ図が 1 つ以上含まれている必要があります。



3.「グラフのプロパティー」>「評価指標の図」をクリックして、戦略マップ図の 1 つを選択します。


注 : 評価指標キューブには、1 つ以上の戦略マップ図を含めることができます。4.ツールバーで「グラフの表示」アイコンをクリックして、図をフルサイズ・モードで表示します。5.図の視点および目標の上にマウスを移動して、詳細を確認します。

TM1 Web でのユーザー指定の図の表示IBM TM1 Web で図表機能を使用して、ユーザー指定のスコアカードの図を表示することができます。

始める前に使用する TM1 サーバーに、スコアカード評価指標キューブが 1 つ以上含まれていて、そのキューブにそのキューブ用のユーザー指定の図が 1 つ以上含まれている必要があります。



3.「グラフのプロパティー」>「評価指標の図」をクリックして、使用可能なユーザー指定の図の 1 つを選択します。注 : 評価指標キューブには、1 つ以上のユーザー指定の図を含めることができます。

4.ツールバーで「グラフの表示」アイコンをクリックして、図をフルサイズ・モードで表示します。5.図の中の評価指標データ・ポイントの上にマウス・カーソルを移動すると、その評価指標に関する詳細が表示されます。


第 9 章 IBM TM1 Web の管理IBM TM1 を Web 上で動作するように設定することができます。

IBM TM1 Web の概要IBM TM1 Web は、Web ブラウザーで以下のタスクを実行できるようにして TM1 の分析能力を拡張したものです。• キューブ・データの分析• 書式化された Excel レポートの操作• データのドリル、ピボット、選択、およびフィルター• グラフの作成• 一部のサーバー管理作業の実行

TM1 Web でのパスワードの変更ユーザーは自分の IBM TM1 Web パスワードをログオン画面で変更できます。

手順1. TM1 Web のログオン画面で、ユーザー名と既存のパスワードを入力します。2.「パスワードの変更」チェック・ボックスをクリックします。3.「ログオン」をクリックします。「ユーザー・パスワードの変更」ページが開きます。

4.「新規パスワード」ボックスに新しいパスワードを入力します。5.「新規パスワードの確認」ボックスに新しいパスワードをもう一度入力します。6.「OK」をクリックして新しいパスワードを保存し、ログオン手順を続行します。

リレーショナル・データ接続のためのプロキシー・アカウントの設定v2.0.8 で削除リレーショナル・データベースへの TM1 Web 接続を認証するようプロキシー・アカウントを設定します。管理者は、リレーショナル・データ・ソースに対して SQL クエリーを実行した TM1 Web ユーザーにプロンプトを表示せずに、プロキシー・アカウントを使用してユーザー認証を行うようにすることができます。プロキシー・アカウントには、Web シートに保管されている接続情報が保管されます。TM1 インストール環境に組み込まれている Java インスタンスを使用する必要があります。プロキシー・アカウント設定は JDBC を使用するため、すべてのオペレーティング・システムがサポートされます。注 : Web シートに接続情報が定義されていない場合、またはユーザーが正しいプロキシー・アカウント情報を入力していない場合は、別の認証を求めるプロンプトが表示されます。詳細については、TM1 Web でのリレーショナル・データの表示を参照してください。プロキシー・アカウント情報は relational_host.xml ファイルに保持することができます。

relational_hosts.xmlrelational_hosts.xml ファイルは、リレーショナル・データベースへの TM1 接続を認証するために使用されます。これには、以下のパラメーターが含まれます。keypath

relational.key ファイルの場所。


https://www.ibm.com/support/knowledgecenter/en/SSD29G_2.0.0/com.ibm.swg.ba.cognos.tm1_ug.2.0.0.doc/t_relational_data_sql_query.html

https://www.ibm.com/support/knowledgecenter/en/SSD29G_2.0.0/com.ibm.swg.ba.cognos.tm1_ug.2.0.0.doc/t_relational_data_sql_query.html

パスを指定しない場合、relational.key ファイルは次の場所に生成されます。tm1web¥WEB-INF¥cert¥key¥relational.key

datasource nameデータ・ソースに付けられた名前。

excelhostWeb シートに定義された接続のリレーショナル・データベース名または IP アドレス。

hostサーバーで使用する接続のリレーショナル・データベース名または IP アドレス。このパラメーターは、Web シートを開発環境から実動環境に移行するときに便利です。データベースDBDev に対するクエリーを Excel に定義する場合は、excelhost 値を DBDev として定義する必要があります。開発環境では、host も DBDev に設定して、TM1 Web のクエリーが開発用のリレーショナル・データベース・サーバーに対して実行されるようにします。実稼働環境に変更する際には、host を DBProd に設定して、TM1 Web のクエリーが実稼働用のリレーショナル・データベース・サーバーに対して実行されるようにします。このようにすると、Web シートのデータベース接続を変更する必要がありません。

usernamerelational.key ファイルに保管される暗号化されたユーザー名。

passwordrelational.key ファイルに保管される暗号化されたパスワード。

RelationalEncryptor.jarRelationalEncryptor.jar ファイルは、relational.key ファイルを生成するコマンド・ライン・ツールです。 relational_hosts.xml ファイルの項目の作成と更新も行います。このコマンドは以下の構文で使用します。java -jar RelationalEncryptor.jar name excelhost realhost username password

relational.keyrelational.key ファイルには、relational_hosts ファイルに現れる暗号化されたユーザー名とパスワードが含まれます。デフォルトの場所は tm1web¥WEB-INF¥cert¥key¥relational.key です。ただし、この場所はrelational_hosts.xml ファイルの keypath パラメーターを使用して変更できます。

TM1 Web 構成パラメーターの変更tm1web_config.xml ファイルは、TM1 Web の構成パラメーターが入っている XML ファイルです。このファイルのパラメーターによって、IBM TM1 Web の次の機能を制御できます。• ビュー・ノード• Cube Viewer のページ・サイズ• Cube Viewer からエクスポートするシートの数• IBM TM1 Web のスタートアップと外観の設定• セッション・タイムアウト


TM1 Web 構成パラメーターIBM Planning Analytics TM1 Web の構成パラメーターは、tm1web_config.xml ファイルに保管されます。tm1web_config.xml ファイルは、以下の場所にあります。<TM1 install location>¥webapps¥tm1web¥WEB-INF¥configuration¥

次のパラメーターが使用可能です。ActionButtonFullRecalculationEnabled

操作ボタンの実行の一部として行われる再計算のレベルを決定します。このパラメーターは、「計算」のタイプとして「シートを自動的に再計算」を使用する操作ボタンにのみ適用されます。true に設定すると、ターゲット・ブック全体の再計算が行われます。false に設定すると、ターゲット・ブックの部分的な再計算が行われます。ターゲット・ブックの表示されている部分のみが再計算されます。この再計算には、表示されている領域内のセルのアクティブ・フォーム、DBS/DBSW/DBR/DBRW/DBRA/DBSA 式、および依存関係が含まれます。ターゲット・ブックのスクロール範囲を超える部分は再計算されません。 false がデフォルト値です。この値に設定すると、特にブックが大きい場合にパフォーマンスが向上します。

AdminHostName設定した場合、ユーザーはログオン時に管理ホストの値の入力を求められません。86 ページの『AdminHostName および TM1ServerName のパラメーターを使用した TM1 Web ログオン・ページの設定』を参照してください。

AdminHostPort設定した場合、クライアントは管理ホストのデフォルト・ポートの代わりにこのポートの使用を試みます。

AdminHostSSLPort設定した場合、クライアントは管理 SSL ホストのデフォルト・ポートの代わりにこのポートの使用を試みます。

CamLoginApiRedirectEnabled

デフォルト値は false です。有効にした場合、TM1 Web API (URL API または JavaScript ライブラリー) からの CAM 認証では、Cognos Analytics の CAM ログオン・ページへのリダイレクトが行われます。この動作は、ダイアログ・ボックスに Cognos Analytics の CAM ログオン・ページが表示されるというデフォルトの動作とは異なります。値が SAMEORIGIN または DENY (クリックジャッキング攻撃からの保護を強化するために使用) の X-Frame-Options ヘッダーが Cognos Analytics に含まれる場合は、このパラメーターを有効にする必要があります。

CleanDimensionMetaDataCache

CleanDimensionMetaDataCache パラメーターは、Web シートの計算時にディメンション要素を TM1サーバーから取得するか、TM1 Web のキャッシュされた要素を使用して取得するかを指定します。デフォルト値: false

• CleanDimensionMetaDataCache を false に設定すると、tm1web キャッシュの要素が使用されます。• CleanDimensionMetaDataCache を true に設定すると、キャッシュから tm1web ディメンション要素が消去され、TM1 サーバーから直接要素が取得されます。

CrossDomainAccessList

TM1 Web へのアクセスを許可するクロスドメイン URL のリストを指定します。IBM Cognos Workspace を実行しているドメインが TM1 Web とは別のドメインである場合に、このパラメーターを使用してそのドメインを指定します。すべてのドメインに TM1 Web へのアクセスを許可するには、アスタリスク (*) を使用します。

第 9 章 IBM TM1 Web の管理 79

複数の URL を指定する場合は、コンマを使用してそれぞれを区切ります。このパラメーターが設定されていない場合、またはパラメーター値が空の場合は、TM1 Web へのクロスドメイン・アクセスは許可されません。

CubeViewerColumnPageSizeCubeviewer の 1 ページに取り込む列数を指定します。93 ページの『Cube Viewer のページ・サイズの変更』を参照してください。

CubeViewerHiddenDimensionsEnabledTM1 Web Cube Viewer でディメンションを非表示にします。非表示にしたディメンションは、ビューのコンテキストには含まれていますが、TM1 Web Cube Viewerにはコンテキスト・ディメンションとして表示されません。その代わりに、「非表示」というラベルのディメンション・バーの領域に存在します。TM1 Web Cube Viewer で非表示のディメンションを使用するには、tm1web_config.xml ファイルにCubeViewerHiddenDimensionsEnabled" ="true" を設定する必要があります。この機能を有効にすると、Cube Viewer に「非表示」領域が表示されます。「行」、「列」、および「コンテキスト」の各領域と同じように、「非表示」領域との間でもディメンションをドラッグできます。非表示のディメンションがビューに含まれている場合は、非表示のディメンションの数が「非表示」ラベルの下に表示されます。「非表示」領域をクリックすると、非表示になっているディメンションと要素を確認できます。非表示のディメンションの要素は変更できません。要素を変更する場合は、ディメンションを「行」、「列」または「コンテキスト」の領域にドラッグして表示した後に、要素を変更する必要があります。その後、ディメンションを「非表示」領域に戻すことができます。

CubeViewerRowPageSizeCubeviewer の 1 ページに取り込む行数を指定します。93 ページの『Cube Viewer のページ・サイズの変更』を参照してください。

CubeviewerStringWrapCubeviewer での文字列セルの折り返しの設定。94 ページの『キューブ・ビューにおけるストリング値の折り返し』を参照してください。

CustomCAMLogoutUrl

TM1 サーバーが CAM セキュリティー (モード 4 または 5) を使用するように構成されている場合に、CA SiteMinder の専用ログアウト・ページの URL を指定します。 SiteMinder セッション Cookie を無効にするために、ログアウト時にこの「ログアウト」ページにアクセスする必要があります。TM1 Web でユーザーが「ログオフ」をクリックする際、CAM のログアウトがまず行われます。次に、SiteMinder ログアウト・ページが呼び出されます。

EvaluationServiceURL評価サービスのロケーションを指定します。評価サービスは、IBM Planning Analytics スプレッドシート・サービスに含まれています。これは、TM1 Web および Planning Analytics の Web シート内のクイック・レポートのレンダリングに使用されます。有効な値は hostname:port_number です。値を割り当てなかった場合、デフォルトの値は http://localhost:9510 と見なされます。

ExportCellsThresholdWeb シートまたはキューブ・ビューのエクスポートに含めることができるセルの最大数を指定します。選択したセルの数がしきい値を超える場合は、警告メッセージが表示され、エクスポートは開始されません。IBM Planning Analytics バージョン 2.0.7 以降のデフォルト値は 1000000 です。


tm1web_config.xml ファイルの ExportCellsThreshold パラメーターは、次の形式に従って編集します。<add key="ExportCellsThreshold" value="CellsThreshold" />

CellsThreshold は、シートごとの行数に列数を掛け、その結果に反復数とエクスポート選択対象コンテキスト・メンバー数を掛けることによって決定されるセル・カウントしきい値です。例えば、Web シートにシートが 2 つあり、それぞれのシートが 1000 行と 25 列で構成されていて、4つのコンテキスト・メンバーに対してエクスポートが選択された場合、セル数は、25,000 * 2 シート *4 コンテキスト・メンバー = 200,000 セルとして計算されます。<CellsThreshold> が 150, 000 であれば、この Web シートのエクスポートは拒否されることになります。

ExternalUrl

TM1 Web の元の始動 URL を変更する外部ロード・バランサーで TM1 Web および Cognos セキュリティー (CAM) 認証を使用する場合に、この ExternalUrl パラメーターを設定します。Cognos セキュリティーが正常にリダイレクトされて TM1 Web に戻れるように、ExternalUrl パラメーターによって正しいURL を提供します。TM1 Web を開始するために使用する URL と同じ URL を値に設定します。次に例を示します。 <add key="ExternalUrl" value="http://mycomputer/TM1Web" />

GzipCompressionEnabledWeb サーバーの応答を圧縮するかどうかを決定します。有効な値は true/false です。

HideCubeviewerToolBartrue に設定した場合、Cubeviewer のツールバーはいずれも表示されません。93 ページの『HideCubeviewerToolBar パラメーター』を参照してください。

HideTabBartrue に設定すると、複数のタブが非表示になります。92 ページの『HideTabBar パラメーター』を参照してください。

HideWebsheetToolBartrue に設定すると、Web シートのすべてのツールバーが非表示になります。92 ページの『HideWebsheetToolBar パラメーター』を参照してください。

HomePageObject設定すると、ユーザーのログオン後に、Web シート、Cubeviewer、または URL タイプのオブジェクトが表示されます。88 ページの『すべてのユーザーのためのグローバルなホーム・ページの設定』を参照してください。

HttpSessionTimeoutこのパラメーターは、TM1 Web の HTTP セッションのセッション・タイムアウト (分数) を定義します。このパラメーターが欠落しているか、その値が 1 未満、ブランク、または数値以外の場合は、web.xmlファイルで TM1 Web 用に定義されているデフォルトのセッション・タイムアウト値が使用されます。95 ページの『TM1 Web セッション・タイムアウトの設定』を参照してください。注 : IBM Planning Analytics Local バージョン 2.0.6 以降では、web.xml ファイルの session-timeout 値は変更しないでください。

LegacyUrlApiSessionDiscoveryEnabledLegacyUrlApiSessionDiscoveryEnabled 構成パラメーターを使用して、TM1 Web URL API がログオン・セッションを処理する方法を制御します。このパラメーターを構成して、URL API が個別で固有なログオン・セッションを追跡するかどうかを指定します。このパラメーターを使用すると、指定された管理ホスト、TM1 サーバー、および (オプションで) ユーザー名に基づいて URL API セッションを再利用できます。


URL API でセッション・トークンによるログオン方式を使用する場合は、tm1web_config.xml ファイル内の LegacyUrlApiSessionDiscoveryEnabled 構成パラメーターを False に設定する必要があります。TM1 Web API セッション・ログオンを参照してください。以下のフォーマットを使用してください。<add key="LegacyUrlApiSessionDiscoveryEnabled" value=True または False/>以下に例を挙げます。<add key="LegacyUrlApiSessionDiscoveryEnabled" value="False"/>

デフォルト値は True です。• true

TM1 Web は、指定された情報 (TM1 管理ホスト、TM1 サーバー、ユーザー名) に基づいて、新しいログオン要求と既存のログオン・セッションのマッチングを試行します。このパラメーターは、TM1 管理ホスト、TM1 サーバー、およびユーザー名の固有の組み合わせでシングル・ログオンを行う場合にのみ、True に設定してください。

• false

TM1 Web URL API を使用して TM1 Web オブジェクトを開くたびにセッション・トークンを提供する必要があることを指定します。提供しない場合はユーザーにプロンプトが表示されます。TM1 Web の URL API で複数のログオン・セッションを使用する場合は、このパラメーターを Falseに設定してください。URL API、および TM1 Web や TM1 Application Web などの他の TM1 Web クライアントで複数のログオン・セッションを使用する場合も、この設定を使用してください。この構成では、ユーザー・セッションを個々に区別するためにセッション・トークンが使用されます。

MaximumConcurrentExportsTM1 Web から同時実行できるエクスポートの最大数を指定します。デフォルト値は 5 です。IBM Planning Analytics バージョン 2.0.7 より前のデフォルト値は 5 です。IBM Planning Analytics バージョン 2.0.7 以降のデフォルト値は 4 です。MaximumConcurrentExports を 0 に設定すると、同時エクスポート数を無制限にすることができます。この設定は、バージョン 10.3 より前の TM1 Web のエクスポート動作と類似しています。同時エクスポートの最大数に達した場合に、さらにエクスポートが開始されると、それら追加のエクスポートは、エクスポート・スロットが利用できるようになるまでキューに入れられます。キューに入れられたエクスポートを開始した人に、キューイングされたことは通知されません。最適なパラメーター設定は、RAM の容量とユーザーの要件によって異なります。一般的に、TM1 Webで利用できる RAM の容量が多いほど、設定できるパラメーターの値は高くなります。値を大きくするとメモリーの消費量は増えますが、エクスポートのキューイングは減少します (パラメーターを 0 に設定すると、エクスポートのキューイングはなくなります)。逆に、パラメーター値を小さくすると、エクスポートによるメモリー消費量は減りますが、エクスポートのキューイングの頻度が高くなる可能性があります。

MaximumSheetsForExportエクスポートを許可するシートの最大数を指定します。IBM Planning Analytics バージョン 2.0.7 より前のデフォルト値は 100 です。IBM Planning Analytics バージョン 2.0.7 以降のデフォルト値は 50 です。94 ページの『Web シートからエクスポートするシートの最大数の設定』を参照してください。

MixedCellPaste

MixedCellPaste パラメーターを true に設定すると、Web シートのリーフと集約値の混合範囲に値をコピーした場合に、貼り付けられた値が厳密にマッチングします。デフォルトの値は False です。


https://www.ibm.com/support/knowledgecenter/SSD29G_2.0.0/com.ibm.swg.ba.cognos.tm1_ug.2.0.0.doc/c_tm1webjv_api_sessiontoken_login.html

注 : このパラメーターは Web シートにのみ適用されます。CubeViewer には適用されません。NavTreeCollapsedOnStartユーザーのログオン後にナビゲーション・パネルを省略表示するか展開表示するかを決定します。91 ページの『NavTreeCollapsedOnStart パラメーター』を参照してください。

NavTreeDisplayServerViewナビゲーション・ツリー内にサーバー・ビュー・ノードを表示するかどうかを指定します。有効な値はY と N です。93 ページの『ナビゲーション・ウィンドウの「ビュー」ノードの表示と非表示』を参照してください。

NavTreeHiddenユーザーのログオン後にナビゲーション・パネルを表示するかどうかを決定します。91 ページの『NavTreeHidden パラメーター』を参照してください。

RecalcOnActivate

RecalcOnActivate を true に設定した場合、TM1 Web で Web シートまたはキューブ・ビューがアクティブになるたびに (タブを切り替えたときなど)、再計算が行われます。有効な値は true または false です。

RecalcOnDataValidationChange

データ検証リストの値を変更した場合に、デフォルトの再計算動作がオーバーライドされるかどうかを指定します。true に設定すると、データ検証リストの値を変更したときに再計算がトリガーされます。false に設定すると、データ検証リストの値を変更したときに再計算がトリガーされません。

RecalcOnPicklistChange

選択リストの値を変更した場合に、デフォルトの再計算動作がオーバーライドされるかどうかを指定します。true に設定すると、選択リストの値を変更したときに再計算がトリガーされます。false に設定すると、選択リストの値を変更したときに再計算がトリガーされません。

RelationalResultMaxRows-1 より大きい値を指定すると、リレーショナル・クエリーの ResultSet が戻す行数は、指定した値までに限定されます。

TM1DatabaseLabel「Y」を設定した場合、データベースの名前が TM1 Web バナー上のユーザーの隣に表示されます。例えば、「Welcome: Admin / Planning Sample」と表示されます。デフォルトは「N」です。このオプションを「N」に設定した場合、ユーザーの横には何も表示されません。『IBM TM1 Web のスタートアップと外観の設定』の 93 ページの『TM1DatabaseLabel パラメーター』を参照してください。

TM1ServerName設定した場合、ユーザーは接続する TM1 サーバーの選択をログオン時に求められることはありません。86 ページの『AdminHostName および TM1ServerName のパラメーターを使用した TM1 Web ログオン・ページの設定』を参照してください。

UseBookRecalcSetting

UseBookRecalcSetting パラメーターは tm1web_config.xml ファイルに含まれています。 true に設定すると、Web サーバーは Excel シートが発行されたときのモードを適用します。 Excel シートが手動再計算モードで発行されていた場合、再計算が実行されるまで Web シート・データはクライアントに再送されません。


UseBookRecalcSetting パラメーターは、tm1web_config.xml ファイルで次の形式を使用します。<add key="UseBookRecalcSetting" value="false" />

値は「false」または「true」のどちらかです。UseBookRecalcSetting を true に設定すると、TM1 Web は Excel ワークシートにおける再計算の設定を踏襲します。計算オプションが「自動」に設定されている場合は、次のようになります。• UseBookRecalcSetting = "true" を設定した場合、SUBNM 関数を変更すると Web シートは自動的に再計算されます。

• UseBookRecalcSetting = "false" を設定した場合、SUBNM 関数を変更すると Web シートは自動的に再計算されます。計算オプションが「手動」に設定されている場合は、次のようになります。• UseBookRecalcSetting = "true" を設定すると、Web シートは自動的には再計算されません。再計算するには、再計算ボタンを手動でクリックする必要があります。

• UseBookRecalcSetting = "false" を設定した場合、SUBNM 関数を変更すると Web シートは自動的に再計算されます。

WebsheetBackgroundRecalculationMode

Web シートで行うバックグラウンド再計算のレベルを指定します。データをすぐに取得できないために WebSheetService.scrollWebSheet の呼び出しに数秒かかることがあります。 WebsheetBackgroundRecalculationMode パラメーターを使用すると、要求されたときにすぐに必要なデータを使用できるように、バックグラウンドでブックを再計算できます。0 (デフォルト値) に設定すると、シートを最新表示したときに、バッファーに入っている (表示される)領域だけが計算されます。1 に設定すると、バッファーに入っている領域に加えて、バッファーに入っている領域に隣接する領域が計算されます。これにより、ユーザーが最初の表示領域から少しスクロールした場合の待ち時間が短縮されます。2 に設定すると、現在のワークシート全体が計算されます。これにより、ユーザーが現在のシートのどの領域にスクロールした場合でも、待ち時間が短縮されます。3 に設定すると、現在のブック全体が計算されます。これにより、ユーザーが現在のワークシートのどの領域に移動した場合でも、あるいは別のワークシートに移動した場合でも、待ち時間が短縮されます。注 : 設定する数値が大きいほど、計算されるセルの数が増えるので、Web サーバーの負荷が大きくなります。

WorkbookMaxCellCount

ブックの最大セル数を、桁区切り記号なしの数値で指定します。TM1 Web アプリケーション・サーバーは、TM1 サーバーに発行されたブックのサイズを検証します。コントロール行のみのアクティブ・フォームを含むブックがアップロードされることがあります。発行時にブックに複数の行を含めることができますが、開いて再ビルドすると、さらに多くの行が表示されることがあります。WorkbookMaxCellCount を使用して、多くのセルを含むブックを開くときの問題を回避できます。このパラメーターが tm1web_config.xml にあり、デフォルトでない場合は、ユーザーがブックを開くときにサーバーがセル数を WorkbookMaxCellCount と比較して検証します。ブックのセル数がWorkbookMaxCellCount を超える場合は、エラー・メッセージがログに記録され、ブックは開かれません。tm1web.log ファイルに「<book_name> exceeds maximum cell count」というエラー・メッセージが記録されます。IBM Planning Analytics TM1 Web ログ記録の使用を参照してください。


https://www.ibm.com/support/knowledgecenter/SSD29G_2.0.0/com.ibm.swg.ba.cognos.tm1_ug.2.0.0.doc/c_usingtm1weblogging_n518aa.html

• このパラメーターをブランクのままにするか 0 以下の値に設定した場合は、ブックのセル数を無制限に許容することを意味します。

• IBM Planning Analytics バージョン 2.0.7 より前のデフォルト値は -1 で、ブックのセル数を無制限に許容することを意味します。

• IBM Planning Analytics バージョン 2.0.7 以降のデフォルト値は 500000 です。注 : このパラメーターを変更する場合は、アプリケーション・サーバーを再始動する必要があります。

X-Frame-Options

X-Frame-Options パラメーターは、X-Frame-Options 応答ヘッダーの値を設定します。このパラメーター (および応答ヘッダーの値) は、ブラウザーに <frame>、<iframe>、または <object> の TM1 Webページのレンダリングを許可するかどうかを指定します。このパラメーターは、クリックジャッキング攻撃を防止し、TM1 Web のコンテンツが他のサイトに埋め込まれないようにするために使用します。指定可能なパラメーター値は 3 つあります。• 0 は応答ヘッダー値 DENY に該当し、すべてのドメインで TM1 Web コンテンツのフレーム内表示を禁止します。

• 1 は応答ヘッダー値 SAMEORIGIN に該当し、現在のドメインのみに TM1 Web コンテンツのフレーム内表示を許可します。

• 2 は応答ヘッダー値 ALLOW-FROM に該当します。この場合は、TM1 Web は tm1web_config.xmlの CrossDomainAccessList パラメーターで、TM1 Web コンテンツにアクセスしてフレーム内に表示することを許可されたクロスドメイン URL のリストを確認します。ALLOW-FROM 応答ヘッダーは、ユニバーサル・ブラウザーをサポートしていません。 TM1 Web はCrossDomainAccessList の値を使用して、ドメインが許可されているかどうかを判断します。許可されていない場合は、TM1 Web に応答ヘッダー値 DENY が含まれ、フレーム内に表示できなくなります。状況によっては、TM1 Web が要求元ドメインを判別できないことがあります。その場合は、応答ヘッダー値 SAMEORIGIN が組み込まれます。

X-Frame-Options パラメーターが欠落しているか空である場合は、2 がデフォルト値です。DENY 値と SAMEORIGIN 値の場合にのみ、TM1 Web の .jsp ファイルには応答ヘッダー X-Frame-Options が組み込まれます。ドメインが許可されていることが確認された場合、X-Frame-Optionsヘッダーは組み込まれません。

TM1 Web 設定ファイルの編集IBM TM1 Web 設定ファイルを編集して、さまざまなパラメーターを設定することができます。TM1 Web 設定ファイルは XML ファイルであるため、XML タイプのエディターで開く必要があります。Microsoft ワードパッドなどの通常のテキスト・エディターを使って開くと、ファイル破損の原因となり得る無効な文字が追加される可能性があります。TM1 Web バージョン 10.2 以降、これまでのバージョンの TM1 Web の web.configファイルは新しいtm1web_config.xml ファイルに置き換えられました。

手順1.次の場所で tm1web_config.xml ファイルを見つけて開きます。<TM1 のインストール場所>¥webapps¥tm1web¥WEB-INF¥configuration¥注 : tm1web_config.xml ファイルは xml ファイルであり、XML タイプのエディターでのみ開けます。Microsoft ワードパッドなどの通常のテキスト・エディターを使って開くと、ファイル破損の原因となり得る無効な文字が追加される可能性があります。

2.パラメーターを編集して、変更を保存します。3. IBM TM1 Web にログオンして、編集結果を確認します。


AdminHostName および TM1ServerName のパラメーターを使用した TM1Web ログオン・ページの設定

パラメーターの AdminHostName と TM1ServerName は、 TM1 管理ホストと TM1 サーバーの値を入力するようにユーザーに求めるプロンプトを、IBM TM1 Web のログオン・ページに表示するかどうかを制御します。このいずれかのパラメーターの値を tm1web_config.xml ファイルで設定すると、その指定値がログオン・プロセスで使用され、ユーザーにその情報の入力を求めることはありません。

AdminHostName パラメーターこのパラメーターは、TM1 管理サーバーが実行されている管理ホストの名前を指定します。tm1web_config.xml ファイルの AdminHostName パラメーターを次の形式を使用して編集します。<add key="AdminHostName" value="HostName"/>

ここで、HostName には、次のいずれかの値を指定できます。• HostName が空白 (デフォルト値) の場合は、ログオン・ページに「管理ホスト」プロンプトが表示されます。

• HostName に有効な TM1 管理ホストの名前を設定した場合は、その管理ホストが IBM TM1 Web のログオン・プロセスに使用されるので、ユーザーに入力プロンプトは表示されません。

TM1ServerName パラメーターこのパラメーターは、TM1 サーバーの名前を設定します。tm1web_config.xml ファイルのTM1ServerName パラメーターを次の形式を使用して編集します。<add key="TM1ServerName" value="ServerName"/>

ここで、ServerName には、次のいずれかの値を指定できます。• ServerName が空白 (デフォルト値) の場合は、「TM1 サーバー」プロンプトが IBM TM1 Web のログオン・ページに表示されます。

• ServerName が有効な TM1 サーバー名に設定されている場合は、ログオン・ページには管理ホストとTM1 サーバーのどちらのプロンプトも表示されません。

• AdminSvrSSLCertID パラメーターの設定が正しくない場合は、空白のサーバー名プルダウン・メニューが表示され、TM1 Web のログ・ファイルにエラーが記録されます。詳細については、「TM1Operation」の『SSL を使用してセキュア・モードで TM1 を実行』を参照してください。ユーザーが入力した「ユーザー名」と「パスワード」が有効な場合、IBM TM1 Web は、 tm1web_config.xmlファイルの TM1ServerName パラメーターで指定された TM1 サーバーにログオンします。例えば、次のコードのように TM1ServerName パラメーターに planning sample を設定できます。<add key="TM1ServerName" value="planning sample" />

TM1 Web のカスタム・ホーム・ページの設定ユーザーが IBM TM1 Web へのログオンに成功したときに Web シート、キューブ・ビュー、または URL を表示するように、IBM TM1 Web のカスタム・ホーム・ページを設定することができます。このホーム・ページは、ユーザーが TM1 データにアクセスして作業するための開始点となります。ホーム・ページは、IBM TM1 Web のすべてのユーザーに対してグローバルに設定することも、個々のユーザーやユーザー・グループごとに割り当てることもできます。例えば、HTML ファイルまたはその他のタイプの Web ページを表示するようにホーム・ページ・オプションを設定すると、Web ページに表示可能なあらゆる内容 (手順、タスク、リンクなど) をユーザーに提示することができます。


設定したホーム・ページは IBM TM1 Web の最初のタブに表示され、ユーザーが閉じることはできません。設定すると「ホーム」リンクが IBM TM1 Web のヘッダー領域に表示されるので、ユーザーはホーム・ページに簡単に戻ることができます。IBM TM1 Web ホーム・ページは、次の 2 つの方法で設定できます。IBM TM1 Web ユーザーごとに異なるホーム・ページ

TM1 Architect とサーバー・エクスプローラーの「クライアント設定」ダイアログを使用すると、 IBMTM1 Web のクライアント (ユーザー) ごとにスタートアップ・ホーム・ページを設定できます。

すべての IBM TM1 Web ユーザーのためのグローバルなホーム・ページtm1web_config.xml ファイルの HomePageObject パラメーターを使用すると、すべての IBM TM1Web ユーザーにグローバルに適用するホーム・ページを設定できます。

注 : tm1web_config.xml ファイルの HomePageObject パラメーターに AllowOverwrite=true を設定すると、「クライアント設定」ダイアログで指定したホーム・ページ割り当てが tm1web_config.xmlファイルのグローバルな設定をオーバーライドします。ユーザー別のホーム・ページの設定Architect とサーバー・エクスプローラーの「クライアント設定」ダイアログ・ボックスでは、IBM TM1Web クライアント (ユーザー) 別にスタートアップ・ホーム・ページを設定できます。例えば、営業部門の TM1 Web ユーザーに割り当てるホーム・ページと、経理部門のユーザーに割り当てるホーム・ページを別にすることができます。注 : 「クライアント設定」ダイアログ・ボックスを使用すると、特定のユーザーにホーム・ページを割り当てて、tm1web_config.xml ファイルの「HomePageObject」パラメーターのグローバルなホーム・ページ設定をオーバーライドすることができます。

手順1. Architect またはサーバー・エクスプローラーで、サーバーを右クリックし、「セキュリティー」、「クライアント/グループ」の順に選択します。「クライアント/グループ」ダイアログ・ボックスが開きます。

2.「設定」をクリックします。「クライアント設定」ダイアログ・ボックスが開きます。

3.ホームページ設定を適用するクライアントを「現在のクライアント」のリストから選択します。4.以下のようにして、ホーム・ページの Web シート、キューブ・ビュー、または URL を入力します。

• URL を表示するには、プロトコルの http:// を含む URL アドレスを「ホームページ」ボックスに入力します。Web サイトまたは個々のファイルのいずれかの URL を入力できます。

• ホーム・ページとして Web シートまたはキューブ・ビューを選択するには、「参照」をクリックします。「TM1 Web ホーム・ページを選択」ダイアログ・ボックスが開き、Web シートまたはキューブ・ビューへの参照を「アプリケーション」ツリーから選択できます。

Web シートまたはキューブ・ビューの参照を選択したら、「OK」をクリックして、「クライアント設定」ダイアログに戻ります。

5.ナビゲーション・ウィンドウの表示を制御する設定を選択します。注 : ここで設定したナビゲーション・ウィンドウの設定は、tm1web_config.xml ファイル内で対応するパラメーターが AllowOverwrite=true に設定されている場合にのみ適用されます。詳しくは、91 ページの『TM1 Web のスタートアップと外観の設定の構成』を参照してください。ナビゲーション・ウィンドウの表示は、次の設定値で制御できます。• ナビゲーション・ウィンドウを含める - 選択したクライアントが TM1 Web にログオンしたときにナビゲーション・ウィンドウを表示するか、非表示にするかを指定します。

• ログオン時にウィンドウを開く - 選択したクライアントが TM1 Web にログオンしたときにナビゲーション・ウィンドウを展開モードで表示するように設定します。


• ログオン時にウィンドウを閉じる - 選択したクライアントが TM1 Web にログオンしたときにナビゲーション・ウィンドウを最小モードで表示するように設定します。

• クライアントのナビゲーション・ウィンドウ設定を保存 - クライアントが TM1 Web からログアウトするときにナビゲーション・ウィンドウの個人用設定を保存するかどうかを指定します。

6.「適用対象」のリストからいずれかのオプションを選択して、このホームページをどのクライアント (複数の場合もあり) に対して表示できるようにするか設定します。次のオプションを使用できます。• 現在のクライアント - 「現在のクライアント」の一覧で選択したクライアントのみに対してホーム・ページの設定を適用します。

• 選択したクライアント - 「選択」ボタンが使用可能になるので、サブセット・エディターを開いて、同じホームページ設定を使用するクライアントの集合を選択できます。「選択したクライアント」を選択してから「選択」をクリックすると、サブセット・エディターが開きます。そこから、このホーム・ページを使用可能な TM1 クライアントのサブセットを選択できます。サブセット・エディターでクライアントのサブセットを選択してから「OK」をクリックすると、「クライアント設定」ダイアログに戻ります。「クライアント設定」ダイアログ・ボックスには、サブセット・エディターで選択したクライアントの合計数が表示されます。

• すべてのクライアント - 同じホーム・ページ設定をすべての TM1 クライアントに適用します。7.「設定を適用」をクリックして、「適用対象」のリストで選択したクライアントのホームページを設定します。

8.手順 4、5、6、7 を繰り返して、別の TM1 クライアントの集合向けにホーム・ページを設定します。9.「OK」をクリックして、「クライアント設定」ダイアログ・ボックスを閉じます。これで、TM1 Web のホーム・ページが設定されました。選択した TM1 Web クライアントが次に TM1Web へのログオンに成功したときには、ここで割り当てたホーム・ページが表示されます。

すべてのユーザーのためのグローバルなホーム・ページの設定tm1web_config.xml ファイルの HomePageObject パラメーターを使用すると、すべての IBM TM1Web ユーザーに表示するグローバルなホーム・ページを有効にすることができます。注 : 「クライアント設定」ダイアログを使用して個々の TM1 ユーザーに別のホーム・ページを割り当てることで、グローバルな HomePageObject パラメーターをオーバーライドできます。詳しくは、87 ページの『ユーザー別のホーム・ページの設定』を参照してください。HomePageObject パラメーターは、次の 3 種類のオブジェクトに有効です。• CubeViewer• Web シート• URL

ホーム・ページ・オブジェクトは、ユーザーが TM1 Web へのログオンに成功すると表示されます。HomePageObject パラメーターの使用HomePageObject パラメーターの使用方法HomePageObject パラメーターの書式は、次のとおりです。<add key="HomePageObject" value="ObjectPath ;Type= ObjectType ;Description= ObjectTitle ;AllowOverwrite =true" />

ここで：• ObjectPath は、開く Web シート、キューブ・ビュー、または URL オブジェクトのパスです。パスの具体的な書式は、オブジェクトのタイプに応じて異なります。

• ObjectType は、開くオブジェクトのキーワード (websheet、cubeviewer、または URL) です。• ObjectTitle はオブジェクトに割り当てる簡単なタイトルであり、Web ブラウザーのタイトル・バーと IBM

Cognos TM1 Web のホーム・ページ・タブに表示されます。


• AllowOverwrite には、次のように true または false の値を設定できます。AllowOverwrite=true に設定した場合は、Architect およびサーバー・エクスプローラーの「クライアント設定」ダイアログを使用して個々のクライアントに別のホームページを設定することで、HomePageObjectパラメーターをオーバーライドすることができます。AllowOverwrite=false に設定した場合は、HomePageObject パラメーターがすべての TM1 ユーザーにグローバルに適用され、Architect およびサーバー・エクスプローラーの「クライアント設定」ダイアログで個別に設定することはできません。以下のセクションでは、Web シート、キューブ・ビュー、および URL に対して HomePageObject パラメーターを使用する方法について説明します。キューブ・ビューをグローバルな TM1 Web ホーム・ページに設定キューブ・ビューを IBM TM1 Web のホーム・ページとして設定するには、次の形式を使用します。value=CubeName$$ViewName$$Status

ここで、以下の引数が $$ 文字で区切られています。• CubeName は、ビューが属するキューブの名前です。• ViewName は、表示するキューブ・ビューの名前です。• Status は、キューブ・ビューの共有または個人用ステータスです。注 : 開く特定のキューブ・ビューを正しく指定するには、PUBLIC または PRIVATE のいずれかの値を指定する必要があります。例えば、“SalesCube”の“Price”という共有ビューを開く場合は、次のように指定します。&ltadd key="HomePageObject" value="SalesCube$$Price$$Public;Type=cubeviewer;Description=MyStartCube;AllowOverwrite=true"/>

Web シートをグローバルな TM1 Web ホーム・ページに設定Excel ファイルを TM1 に追加した方法に応じて、Web シートを IBM TM1 Web ホーム・ページとして割り当てることができます。TM1 の外部にある Excel ファイルを参照する Web シートを開くExcel ファイルを参照する Web シートを開けます。

手順次の書式を使用します。value="WebsheetPath

ここで、WebsheetPath は Excel ファイルの場所と名前です。これには、ローカル・ファイルのパス、またはネットワーク上に置かれているファイルの UNC パスを指定できます。例えば、Web シートの UNC ネットワーク・パスは次のように設定します。value=//MySystem/Samples/classic_slice.xls

タスクの結果完全な HomePageObject パラメーターは、次のようになります。<add key="HomePageObject" value="//MySystem/Samples/classic_slice.xls;Type=websheet;

Description=MyWebsheet;AllowOverwrite=true"/>


TM1 サーバーにアップロードされている Web シート・オブジェクトを開くアップロードされた Web シート・オブジェクトを開けます。

手順1.サーバー・エクスプローラーの「プロパティー」ウィンドウを使用して、アップロードされた Excel ファイルの TM1 割り当て名を検索します。

図 1. サーバー・エクスプローラーにおけるアップロードされた Excel ファイルの割り当て名の例2.次の書式で、値パラメーターを設定します。

value="TM1://ServerName/blob/PUBLIC/.\}Externals\TM1_Filename

ここで：• ServerName は、Excel ファイルが配置されている TM1 サーバーの名前です。• TM1_Filename は、アップロード済みの Excel ファイルに TM1 が割り当てた名前です。以下に例を挙げます。value="TM1://sdata/blob/PUBLIC/.\}Externals\Report_2006.xls_20070123212746.xls

完全な HomePageObject パラメーター行は、次のようになります。<add key="HomePageObject" value="TM1://sdata/blob/PUBLIC/.\}Externals\Report_2006.xls_20070123212746.xls;Type=websheet;Description=MyUploaded Websheet;AllowOverwrite=true" />

URL をグローバルな TM1 Web ホーム・ページに設定HomePageObject パラメーターに URL を設定できます。以下のフォーマットを使用してください。value="URL_Path

ここで、URL_Path は、Web サイトまたは個々の Web ページ・ファイルを指すように指定できます。以下に例を挙げます。• ファイルを指す URL をホームページに設定するには：

<addkey="HomePageObject" value="homepage.html;Type=URL;

Description=MyStart Page;AllowOverwrite=true"/>

• Web サイトを指す URL をホームページに設定するには：


<addkey="HomePageObject" value="http://www.ibm.com;Type=URL;

Description=IBM;AllowOverwrite=true"/>

TM1 Web のスタートアップと外観の設定の構成IBM TM1 Web にユーザーがログオンしたときのナビゲーション・ペイン、タブ・バー、Web シート、および Cubeviewer ツールバーの外観を制御することができます。これらのパラメーターは tm1web_config.xml ファイルにあり、TM1 Web のすべてのユーザーにグローバルに適用されます。注 : HomePageObject パラメーターを使用してカスタム・ホーム・ページを設定する方法について詳しくは、86 ページの『TM1 Web のカスタム・ホーム・ページの設定』を参照してください。NavTreeHidden パラメーターNavTreeHidden パラメーターは、ユーザーが IBM TM1 Web にログオンしたときにナビゲーション・ウィンドウを表示するかどうかを指定します。これが役立つのは、カスタマイズしたホームページをユーザーに表示し、ナビゲーション・ウィンドウをまったく表示しないような場合です。NavTreeHidden パラメーターは、tm1web_config.xml ファイルで次の書式を使用します。<add key="NavTreeHidden" value="false;AllowOverwrite=true"/>

ここで：value は、true または false のいずれかを指定できます。• false に設定すると、ユーザーが TM1 Web にログオンしたときにナビゲーション・ウィンドウが表示されます。

• true に設定すると、ユーザーが TM1 Web にログオンしたときにナビゲーション・ウィンドウは表示されません。

AllowOverwrite は、true または false に設定できます。その意味は次のとおりです。• AllowOverwrite=true に設定すると、NavTreeHidden パラメーターはすべてのユーザーに対してグローバルに割り当てられますが、Architect およびサーバー・エクスプローラーの「クライアント設定」ダイアログを使用してクライアントごとにオーバーライドすることができます。

• AllowOverwrite=false に設定すると、NavTreeHidden パラメーターがすべての TM1 ユーザーに対してグローバルに適用され、Architect およびサーバー・エクスプローラーの「クライアント設定」ダイアログを使用して、個々のクライアントに対して、そのダイアログでの設定を優先させることはできません。

NavTreeCollapsedOnStart パラメーターNavTreeCollapsedOnStart パラメーターは、ユーザーがログオンした時点でナビゲーション・ウィンドウを最小化するか、展開表示するかを指定します。縮小表示の場合、ユーザーがウィンドウを復元する手段となる小さい縦線が表示されます。NavTreeCollapsedOnStart パラメーターは、tm1web_config.xml ファイルで次の書式を使用します。<add key="NavTreeCollapsedOnStart" value="false;AllowOverwrite=true"/>

ここで：value は、true または false のいずれかを指定できます。


• value を false に設定すると、ユーザーが TM1 Web にログオンしたときにナビゲーション・ウィンドウが展開され、デフォルト・モードで表示されます。

• value を true に設定すると、ユーザーが TM1 Web にログオンしたときにナビゲーション・ウィンドウは折りたたまれた状態で表示されます。

AllowOverwrite は、true または false に設定できます。その意味は次のとおりです。• AllowOverwrite=true に設定すると、NavTreeCollapsedOnStart パラメーターがすべてのユーザーに対してグローバルに適用されます。ただし、TM1 Architect およびサーバー・エクスプローラーの「クライアント設定」ダイアログを使用して、個々のクライアントに対してそのダイアログでの設定を優先させることができます。

• AllowOverwrite=false に設定すると、NavTreeCollapsedOnStart パラメーターがすべての TM1 ユーザーに対してグローバルに適用され、TM1 Architect およびサーバー・エクスプローラーの「クライアント設定」ダイアログを使用しても、個々のクライアントに対して、そのダイアログでの設定を優先させることはできません。

HideTabBar パラメーターHideTabBar パラメーターは、ユーザーが複数の TM1 Web オブジェクトを開いた場合に IBM TM1 Web が複数のタブを表示するか、それともビューを 1 つのみ表示するかを指定します。これが役立つのは、ユーザーに対して表示可能なビューを一度に 1 つに制限するような場合です。

HideTabBar パラメーターは、tm1web_config.xml ファイルで次の書式を使用します。<add key="HideTabBar" value="false;AllowOverwrite=true"/>

value は、true または false のいずれかを指定できます。• value を false に設定すると、複数のタブを表示できます。これが、TM1 Web のデフォルトの動作です。• value を true に設定すると、複数のタブは表示されません。一度に開くことができるのは 1 つのオブジェクトのみです。

AllowOverwrite オプションは、このパラメーターでは現在使用していません。HideWebsheetToolBar パラメーターHideWebsheetToolBar パラメーターは、ユーザーが Web シートを開いたときに Web シート・ツールバーを表示するかどうかを指定します。HideWebsheetToolBar パラメーターは、tm1web_config.xml ファイルで次の書式を使用します。<add key="HideWebsheetToolBar" value="false;AllowOverwrite=true"/>

value は、true または false のいずれかを指定できます。• value を false に設定すると、Web シート・ツールバーが TM1 Web に表示されます。• value を true に設定すると、Web シート・ツールバーは TM1 Web に表示されません。AllowOverwrite オプションは、このパラメーターでは現在使用していません。


HideCubeviewerToolBar パラメーターHideCubeviewerToolBar パラメーターは、ユーザーがキューブ・ビューを開いたときに Cube Viewer ツールバーを表示するかどうかを指定します。HideCubeviewerToolBar パラメーターは、tm1web_config.xml ファイルで次の書式を使用します。<add key="HideCubeviewerToolBar" value="false;AllowOverwrite=true"/>

value は、true または false のいずれかを指定できます。• value を false に設定すると、Web シート・ツールバーが TM1 Web に表示されます。• value を true に設定すると、Web シート・ツールバーは TM1 Web に表示されません。AllowOverwrite オプションは、このパラメーターでは現在使用していません。ナビゲーション・ウィンドウの「ビュー」ノードの表示と非表示ナビゲーション・ウィンドウの「ビュー」ノードを表示または非表示にするには：

手順1. TM1 Web 仮想ディレクトリーにある tm1web_config.xml を編集します。2. NavTreeDisplayServerView を探します (このパラメーターは、「サーバー・ビュー」ノードの表示を制御します)。デフォルト値の Y の場合、ナビゲーション・ウィンドウに「ビュー」ノードが表示されます。

<add key="NavTreeDisplayServerView" value="Y" />

3.「ビュー」ノードを非表示にするには、NavTreeDisplayServerView の値を N に変更します。4. tm1web_config.xml を保存します。5. TM1 Web にログオンします。これにより、ナビゲーション・ウィンドウで「ビュー」ノードが非表示になります。

TM1DatabaseLabel パラメーターこのパラメーターは、バナーのユーザー名の横に TM1 データベース・ラベルを表示します。tm1web_config.xml ファイルの TM1DatabaseLabel パラメーターを次の形式を使用して編集します。<add key="TM1DatabaseLabel" value="Y"/>

TM1DatabaseLabel には、N または Y を指定できます。• TM1DatabaseLabel を N に設定した場合、データベース・ラベルは表示されません。これが、TM1 Webのデフォルトの動作です。

• TM1DatabaseLabel を Y に設定した場合、データベース・ラベルは、バナーのログオン・ユーザー名の横に、「Welcome: <user name> / <TM1 database label>」と表示されます。

Cube Viewer のページ・サイズの変更IBM TM1 Web の Cube Viewer に表示される行数および列数は変更できます。デフォルトでは、Web Cube Viewer は、20 列 100 行のページに TM1 データを表示します (100 行の中にはディメンション・リストも含まれます)。


手順1. tm1web_config.xml を編集します。2.次のコードを探します。CubeViewerRowPageSize

CubeViewerColumnPageSize3.行/列のページ・サイズの値を変更します。4. tm1web_config.xml を保存します。5. TM1 Web にログオンします。例えば、行のページサイズを 10 に設定すると、データ行が 9 行とディメンションの行が Cube Viewerに表示されます。

Web シートからエクスポートするシートの最大数の設定Web シートからプリンターにエクスポート可能なシートの最大数は、デフォルトでは 100 です。これより多くのシートをエクスポートするように、IBM TM1 Web を設定できます。

手順1. tm1web_config.xml を編集します。2.次のコードを探します。

MaximumSheetsForExport

3.エクスポートするシート数の最大値を変更します。4. tm1web_config.xml を保存します。5. TM1 Web にログオンします。

キューブ・ビューにおけるストリング値の折り返しWeb キューブ・ビューでストリング・エレメント・セルを表示する際に使用するパラメーターを設定するには、CubeviewerStringWrap を使用します。ビューの表示と折り返しの方法を制御するには、CubeviewerStringWrap パラメーターを使用して値を設定し、Web 構成ファイルに保存します。表示されていないセルも、折り返し領域をクリックすると、スクロール可能域で編集が可能です。Enabledこのビューのストリング・セルの折り返しの有効/無効を切り替えます。「False」に設定すると、列幅は、現在のビューのすべての行における最大ストリング長と同じ幅になります。デフォルトの「True」に設定すると、これらのデフォルト・パラメーターを使用する折り返しが有効になります。

MinCharactersToWrap折り返すために必要な最小文字数を設定します。例えば、セルで、50 文字に満たないストリング値は折り返さないなどと設定します。デフォルトでは、50 に設定されます。

MaxDisplayCharactersストリング・セルで表示する最大文字数を設定します。セルにはこの文字数を超える文字を含めることができますが、セルをダブルクリックする場合以外は、それらの文字は表示されません。MinCharactersToWrap が 50 で MaxDisplayCharacters が 200 の場合には、200 文字以上が含まれるストリング・セルは、概ね 4 行を占めることになります。デフォルトでは、200 に設定されます。

WidthOfWrapCell表示画面の折り返し部分の文字数を設定します。デフォルトでは、240 に設定されます。


tm1web_config.xml ファイルで以下の形式を使用します (以下のリストでは、分かりやすくするために改行されていますが、実際には改行しないでください)。<add key="CubeviewerStringWrap" value="Enabled=true;MinCharactersToWrap=50;MaxDisplayCharacters=200;WidthOfWrapCell=240" />

要確認 : CubeviewerStringWrap は Web シートには適用されません。TM1 Web セッション・タイムアウトの設定

デフォルトの TM1 Web セッション・タイムアウトは 20 分です。 TM1 Web シートを IBM PlanningAnalytics Workspace にデプロイするときに、TM1 Web セッション・タイムアウトが発生することがあります。環境のこの設定を変更することができます。

このタスクについてTM1 Web シートを Planning Analytics Workspace にデプロイする場合に推奨されるセッション・タイムアウトは 60 分です。注 : IBM Planning Analytics Local バージョン 2.0.6 以降では、web.xml ファイルの session-timeout 値は変更しないでください。IBM Planning Analytics Local バージョン 2.0.6 では、tm1web_config.xml ファイルにHttpSessionTimeout というパラメーターがあります。このパラメーターを使用して、TM1 Web のHTTP セッションのセッション・タイムアウト (分数) をカスタマイズできます。HttpSessionTimeout パラメーターが指定されていない (欠落しているかブランクである) 場合、または値が 1 より小さいか数値ではない場合は、web.xml ファイルに定義されているデフォルトの session-timeout が使用されます。IBM Planning Analytics Local バージョン 2.0.6 以降を使用している場合、TM1 Web のセッション・タイムアウトをカスタマイズするには、tm1web_config.xml で HttpSessionTimeout パラメーターを設定します。 95 ページの『1』のステップを参照してください。IBM Planning Analytics Local バージョン 2.0.5 以前を使用している場合、デフォルトのセッション・タイムアウトを変更するには、web.xml で <session-timeout> パラメーターを設定します。 95 ページの『2』のステップを参照してください。

手順1.セッション・タイムアウトをカスタマイズするには、以下の手順に従います。

a)テキスト・エディターで tm1web_config.xml を開きます。tm1web_config.xml ファイルは、<pa インストール・ディレクトリー>¥webapps¥tm1web¥WEB-INF¥configuration ディレクトリーにあります。例えば、C:¥Program Files¥IBM¥cognos¥tm1_64¥webapps¥tm1web¥WEB-INF¥configuration にあります。

b) HttpSessionTimeout を 60 またはご使用の環境に必要な値に変更します。<add key="HttpSessionTimeout" value="60" />

c) tm1web_config.xml を保存して閉じます。2. IBM Planning Analytics Local バージョン 2.0.5 以前を使用している場合、デフォルトのセッション・タイムアウトを変更するには、以下の手順に従います。a)テキスト・エディターで web.xml を開きます。web.xml ファイルは <pa インストール・ディレクトリー>¥webapps¥tm1web¥WEB-INF ディレクトリーにあります。例えば、C:¥Program Files¥IBM¥cognos¥tm1_64¥webapps¥tm1web¥WEB-INF にあります。


b) <session-timeout> 値を 60 または環境に必要な値に変更します。<session-config> <session-timeout>20</session-timeout></session-config>

c) web.xml を保存して閉じます。3. IBM TM1 Application Server サービスを再始動します。

TM1 Web ログ記録の使用IBM TM1 Web の管理者は、tm1web.log ファイルを使用して、TM1 Web の状況を確認したりトラブルシューティングを行ったりすることができます。このログ・ファイルの重大度レベルは、メッセージの編成に役立ちます。

IBM TM1 Web ログ・ファイルIBM TM1 Web のログ記録プロセスによって、プログラムのアクティビティーやエラー・メッセージがtm1web.log ファイルに記録されます。管理者は、このログ・ファイルを使用して、IBM TM1 Web の状況を確認したりトラブルシューティングを行ったりすることができます。ログ・ファイルに記載される重大度レベルは、メッセージの編成に役立ちます。tm1web.log ファイルは、Microsoft Windows メモ帳などの任意のテキスト・エディターで開くことができる ASCII テキスト・ファイルです。

ログ・ファイルの名前と場所ログ・ファイルは、次の場所に保存されます。<TM1 installation location>¥webapps¥tm1web¥WEB-INF¥logs

現行 (最新) のファイルの名前は、tm1web.log になります。古いファイルは、次の名前および日付形式で保存され、タイム・スタンプが付けられます。tm1web.log.yyyy-mm-dd。以下に例を挙げます。tm1web.log.2013-03-21。

TM1 Web ログ記録のメッセージ重大度レベルIBM TM1 Web のログ記録処理では、ログ・メッセージが 3 つの重大度レベルに分類されます。これらのレベルは、ログ記録プロパティー・ファイルでログ記録を特定のレベルに設定するときにも使用されます。パラメーター説明DEBUG TM1 カスタマー・サポートや開発エンジニアリング部門でアプリケーションをデバ

ッグしなければならない場合に役立つ詳細で技術的なメッセージ。ログ記録がこのレベルに設定されている場合は、DEBUG、INFO、および ERROR のメッセージがログに記録されます。

INFO アプリケーションの進捗状況に明らかにして、アプリケーションの通常の遷移を報告する情報メッセージ。ログ記録がこのレベルに設定されている場合は、INFO、および ERROR のメッセージがログに記録されます。


パラメーター説明ERROR 管理者が認識すべきエラー状態。問題を解決するか TM1 カスタマー・サポートに報

告するという対処を取る必要があります。ログ記録がこのレベルに設定されている場合は、ERROR メッセージのみがログに記録されます。

IBM TM1 Web ログ記録の設定と有効化IBM TM1 Web ログ記録のログ記録メッセージ・レベルを変更できます。ログ記録プロパティーは、次の場所の log4j.properties ファイルに保存されます。<TM1 のインストール場所>¥webapps¥tm1web¥WEB-INF¥configurationTM1 Web のログ記録は、プログラムのインストール時にデフォルトで設定されて有効になります。

重要 : Web ログ記録のデフォルトの設定は日常的に使用することを目的としており、通常は調整の必要がありません。トラブルシューティングの目的でログ記録プロパティーを設定する必要がある場合は、IBM カスタマー・サポートにご相談ください。

以下は、ログ記録プロパティー・ファイルの例です。# System logging settingslog4j.rootLogger=ERROR, TextFilelog4j.logger.com.ibm.cognos=ERRORlog4j.logger.com.cognos=ERRORlog4j.logger.com.cognos.org=ERRORlog4j.logger.com.ibm.cognos.perf=ERRORlog4j.logger.com.ibm.cognos.tm1=ERROR

log4j.appender.Console=org.apache.log4j.ConsoleAppenderlog4j.appender.Console.layout=org.apache.log4j.PatternLayoutlog4j.appender.Console.layout.ConversionPattern=%d [%t] %-5p (%x) %c - %m%n

log4j.appender.TextFile=org.apache.log4j.DailyRollingFileAppenderlog4j.appender.TextFile.File=logs/tm1web.loglog4j.appender.TextFile.DatePattern=.yyyy-MM-ddlog4j.appender.TextFile.layout=org.apache.log4j.PatternLayoutlog4j.appender.TextFile.layout.ConversionPattern=%d [%t] %-5p (%x) %c - %m%n

log4j.appender.XMLFile=org.apache.log4j.DailyRollingFileAppenderlog4j.appender.XMLFile.File=logs/tm1web_log.xmllog4j.appender.XMLFile.DatePattern=.yyyy-MM-ddlog4j.appender.XMLFile.layout=org.apache.log4j.xml.XMLLayout

このファイルで各種のログ記録レベルおよび出力オプションを調整できます。メッセージ・レベル:

log4j.logger.logger_name=message_level

ログ・ファイル名:

log4j.appender.appender_name.File=location

重要 : デフォルトでは、ログ・ファイルは、使用する Web サーバーの root の直下に作成されます。そのため、無許可の個人がアクセス可能になってしまいます。 File パラメーターを設定してログ・ファイルを安全な場所に作成することを検討してください。パラメーターは、相対またはリテラル・パスを受け入れます。

手順1. Microsoft Windows メモ帳などのテキスト・エディターで log4j.properties ファイルを開きます。2.調整する行を見つけて編集します。


例えば、メッセージ・レベルをいずれかの有効な値 (DEBUG、INFO、または ERROR) に変更します。3.ファイルを保存して閉じます。

TM1 Web ログ・ファイルの表示IBM TM1 Web のインストールでは、 <TM1 Web_install>¥WEB-INF¥logs¥ ディレクトリー内のtm1web.log ファイルにメッセージを書き込むように、IBM TM1 Web のログ記録が構成されます。このファイルは、標準的なテキスト・エディターで開いて参照できます。

このタスクについてIBM TM1 Web をデフォルトのインストール場所にインストールした場合、tm1web.log ファイルは次のディレクトリーにあります。C:¥Program Files¥IBM¥cognos¥tm1_64¥webapps¥tm1web¥WEB-INF¥logs

バックアップとして使用するため、tm1web.log ファイルのコピーは、次の命名規則に従って名前が変更され、毎日保存されます。tm1web.log.<year>-<mm>-<dd>

例: tm1web.log.2013-10-17。

手順1. <TM1 Web_install>¥WEB-INF¥logs¥ ディレクトリーで tm1web.log ファイルを見つけます。2. Microsoft Windows メモ帳などのテキスト・エディターでファイルを開いて参照します。

タスクの結果エラー・メッセージは、次の形式で並べられます。Date Time Error_level Logger_name Error_message

ここで：• Date Time - yyyy-mm-dd hh:mm:ss 形式の日付と時刻。例: 2013-05-02 16:48:57,439

• Error_level - メッセージ・レベル (DEBUG, INFO, ERROR)• Logger_name - サブコンポーネント名。例: Cognos.TM1.Web.PageTM1WebpageUtils• Error_message - メッセージ・テキスト。

TM1 Web ログでのユーザー名とメモリー使用量の構成IBM Planning Analytics Local バージョン 2.0.8 では、TM1 Web ログにユーザー名とメモリー使用量を含めることができます。このオプションのロギングをオンにするには、¥tm1_64¥webapps¥tm1web¥WEB-INF¥configuration¥log4j.properties ファイルで log4j.logger.com.ibm.cognos.tm1 のロギング・レベルを DEBUG に設定する必要があります。このロギング・オプションを使用すると、レンダリングする行が多すぎるアクティブなフォーム、ブック、またはキューブをユーザーが実行した場合に、簡単に確認できます。監査ログを確認して、レンダリングの行数を減らすことができます。ログには以下の情報が含まれます。• タイム・スタンプ• アプリケーションとアクティブ・フォームの名前• 生成された行の数• ユーザー名• Web シートのレンダリング後の現在のヒープ・メモリー


詳しくは、97 ページの『IBM TM1 Web ログ記録の設定と有効化』を参照してください。アクティブ・フォームを開いたときのログの例"<TIMESTAMP>:CLASSNAME:Constructed view for <ActiveFormViewid> contains <#> rows, by user '<username>'. <TIMESTAMP>:CLASSNAME:Current heap memory usage: <MB>".

ブックを開いたときのログの例"<TIMESTAMP>:CLASSNAME:Creating WorkbookMetaData for <sheet name>, by user '<username>'. <TIMESTAMP>:CLASSNAME:Current heap memory usage: <MB>".

キューブ・ビューを開いたときのログの例"<TIMESTAMP>:CLASSNAME:Exit from getUpdatedCubeViewData, updatedData: class name, username: <username>. <TIMESTAMP>:CLASSNAME:Current heap memory usage: <MB>".

Microsoft Excel 2007 以前の .xls ワークシートを使用する場合IBM TM1 Web バージョン 10.2.0 以降では、Excel 2007 以降で作成された Microsoft Excel ワークシートには Open XML ファイル形式が使用されます。古い .xls 形式の既存の Microsoft Excel ファイルを使用する場合は、TM1 変換ツールを使用してファイルを変換してください。元のファイルにマクロが含まれている場合、TM1 変換ツールは元のファイルをマクロ対応の .xlsm ファイルに変換します。そうでない場合は、標準の .xslx ファイルに変換します。Cognos TM1 Architect Server Explorer の「Excel ファイルの OpenXML Excel 形式への変換」オプションを使用して、単一の .xls ワークシート、あるいはフォルダー内のすべてのワークシートを変換できます。このオプションを使用できるのは管理ユーザーだけです。変換を行うと、変換後に可能な限り多くのリンクを保持できるようにファイルが名前変更されます。バージョン 10.2.0 で行われたセル・ベースのセキュリティーへの移行の結果変更された可能性のある権限によっては、一部のリンクおよび操作ボタンを更新する必要があります。場合によっては、変換処理の間、変換されるファイル内で、元のファイルの既定の範囲が名前変更されることがあります。デフォルトでは、変換前のワークシートのバックアップが保存されます。また、デフォルトでは、ログ・ファイルも生成されます。

.xls ワークシートから .xlsx への変換.xls ワークシートに一回限りの変換を行うと、TM1 Web で使用可能な Open XML 形式の Excel ファイルになります。

手順1. IBM Cognos TM1 Architect Server Explorer で、変換するワークシートまたはフォルダーを右クリックします。フォルダー内に入っているその他のファイルに関係なく、Microsoft Excel .xls ファイルだけが変換されます。

2.「Excel ファイルの OpenXML 形式への変換」を選択します。3.デフォルトでは、変換前の .xls ファイルのバックアップとログが、表示されるディレクトリーの場所に作成されます。必要に応じて、これらのファイルを参照して新しい場所を指定することができます。

4.変換が完了すると、検出されて完了したファイルの数と、生成されたログ・テキスト・ファイルの場所がウィンドウにリストされます。


5.一部のファイルや操作ボタンに対するリンクを再設定しなければならない場合があります。セル・ベースのセキュリティーに変更を加えると、一部のファイルでは手動調整しないと作業用の正しい権限がなくなる可能性があります。

Microsoft Windows 以外の Web サーバーのデフォルト・フォント設定の確認

Microsoft Windows 以外の Web サーバーでは、Web サーバーで利用できるフォントを確認し、それらのフォントのいずれかを Microsoft Excel のデフォルト・フォントとして選択します。TM1 Web で使用するMicrosoft Excel ブックの作成には、このデフォルト・フォントを使用してください。通常、MicrosoftWindows Web サーバーは Microsoft Excel で使用されるフォントを備えていますが、MicrosoftWindows 以外の Web サーバーには当てはまらないことがあります。Microsoft Excel と TM1 Web で表示される列の幅の違いに気付いた場合は、Microsoft Excel で使用しているフォントが Web サーバーにないことが原因である可能性があります。AIX® では、TM1 は /usr/lpp/X11/lib/X11/fonts/TrueType でフォントを検索します。列の幅の寸法は、Microsoft Excel で設定されたデフォルトのフォントに基づきます。デフォルト・フォントは、「オプション」、「一般」、「これをデフォルト・フォントとして使用する (Use this as the defaultfont)」で設定されます。「本文のフォント」になっていれば、これは通常、Microsoft Excel のデフォルト・フォントである Calibri です。どのフォントがデフォルト・フォントとして使用されているかは、ブックで確認できます。ブックを解凍します。 xl フォルダーで、styles.xml ファイルを探します。テキスト・エディターでファイルを開き、以下のフォント・セクションを見つけます。<fonts count="2" x14ac:knownFonts="1"><font><sz val="11"/><color theme="1"/> <name val="Calibri"/><family val="2"/><scheme val="minor"/></font>

AIX 用の Calibri TrueType フォントがある場合を除き、Microsoft Excel のデフォルト・フォントを、AIXWeb サーバーにある Lucida Sans などのフォントに変更してください。


付録 A TM1 Web APIIBM TM1 Web は、スタンドアロン・アプリケーションとして使用できるだけでなく、カスタム Web アプリケーションの中で使用することもできます。Web プログラマーや TM1 アプリケーション開発者は、TM1Web のアプリケーション・プログラミング・インターフェース (API) を使用して、カスタムの Web ページ、アプリケーション、ダッシュボードに TM1 Web オブジェクトを組み込むことができます。TM1 Web API には、2 つの異なる API セットが含まれています。これらの API でも、セッション・トークンまたは TM1 セッション ID を使用する共通のログオン方式が使用されます。具体的な開発要件に応じて、以下の 2 つの異なる API のうちどちらを使用するかを選択できます。どちらを使用する場合でも同じログオン方式を使用できます。TM1 Web API セッション・ログオン

TM1 Web の各 API では、セッション・トークン (TM1 Web セッションを一意に識別して区別する) または TM1 セッション ID (TM1 サーバーを一意に識別する) を使用する共通のログオン方式が使用されます。どちらの API でも、このログオン方式を使用できます。詳しくは、101 ページの『TM1 Web API セッション・ログオン』を参照してください。

TM1 Web URL APIURL API は、URL とパラメーターの特別なセットを使用して Web シート・オブジェクトと CubeViewerオブジェクトにアクセスすることを可能にします。簡単な例では Web ブラウザーのアドレス・バーで直接使用できます。URL API を使用してソリューションを作成するには、HTML に関する知識と、望ましくは JavaScript に関する知識が必要です。108 ページの『TM1 Web の URL API』を参照してください。

TM1 Web JavaScript ライブラリーJavaScript ライブラリーは、HTML、JavaScript、Dojo を組み合わせた Web ページ開発環境で、TM1Web の Web シート・オブジェクトと CubeViewer オブジェクトをプログラムから利用することを可能にします。JavaScript ライブラリーを使用するには、HTML、JavaScript、Dojo、HTML Document ObjectModel (DOM) に関する知識が必要です。130 ページの『TM1 Web JavaScript ライブラリー』を参照してください。

TM1 Web API セッション・ログオンセッション・トークン・ログオン方式を使用すると、TM1 Web セッションを一意に識別できます。このログオン方式は、URL API に推奨される方式です。TM1 セッション ID ログオン方式を使用すると、 TM1 サーバー・セッションを一意に識別できます。サーバー・セッションには複数の TM1 Web セッションが含まれている場合があります。セッション・モジュールおよびログオン・モジュールを使用すると、JavaScriptライブラリーでのセッション管理が容易になります。

セッション・トークン・ログオンセッション・トークン・ログオンは、ユーザー、管理ホスト、TM1 サーバーの特定の組み合わせに対応するログオン・セッションを表す固有のセッション・トークンを返します。重要 : 各 TM1 Web セッションが HTTP セッションと関連付けられます。TM1 Web セッション・トークンは、そのトークンが作成された HTTP セッションでのみ使用できます。TM1 Web セッション・トークンを保存し、別のデバイスでブラウザーを開いて、そのセッション・トークンに対応する TM1 Web セッションにアクセスすることはできません。その理由は、HTTP セッションが異なるためです。JavaScript の XMLHttpRequest API を使用して、HTTP ログオン要求を TM1 Web サーバーに送信できます。送信後、要求から JavaScript Object Notation (JSON) 形式のセッション・トークンが返されます。セッション・トークンを受け取った後、TM1 Web オブジェクトを開く際にそのセッション・トークンを使用できます。HTTP セッションで非アクティブ・タイムアウトが発生すると、TM1 Web セッションと関連トークンは有効ではなくなります。


TM1 セッション ID ログオンユーザーは、TM1SessionId で TM1 サーバー・セッションを指定してログオンすることもできます。TM1Web セッションで使用される TM1 サーバー・セッションは変更されません。Web セッションの作成時に生成または指定する必要があります。複数の TM1 Web セッションで同じ TM1 サーバー・セッションを使用できます。

セッション・モジュールおよびログオン・モジュールJavaScript ライブラリーでは、session および LoginDialog の API を使用して、セッションおよびログオン・ダイアログ・ボックスを管理できます。詳しくは、105 ページの『Session モジュールと LoginDialog モジュール』を参照してください。

セッション・トークン・ログオンセッション・トークンを使用したログオンの全体的なプロセスには、以下の手順が含まれます。1. URL API を使用する場合は、tm1web_config.xml ファイルにLegacyUrlApiSessionDiscoveryEnabled 構成パラメーターを設定します。注 : JavaScript ライブラリーを使用する場合は、この構成パラメーターは不要です。

2. TM1 で使用している認証のタイプに基づき、ログオン要求のパラメーターのセットを組み立てます。3. JavaScript の XMLHttpRequest API などの方式を使用して、TM1 Web サーバーにログオン要求を送ります。

4. JSON 応答を処理して、返されたセッション・トークンを取得します。5. Web シート・オブジェクトおよび CubeViewer オブジェクトを開くときに、そのセッション・トークンを使用します。

セッション・トークン・ログオンのための構成パラメーターURL API でセッション・トークンによるログオン方式を使用する場合は、tm1web_config.xml ファイル内の LegacyUrlApiSessionDiscoveryEnabled 構成パラメーターを False に設定する必要があります。このパラメーターを使用すると、指定された管理ホスト、TM1 サーバー、およびユーザー名 (オプション)に基づいて URL API セッションを再利用することができます。<add key="LegacyUrlApiSessionDiscoveryEnabled" value="False"/>

ログオン要求パラメーターセッション・トークン方式を使用するには、TM1 で使用している認証タイプ用のパラメーターのセットを要求内に指定して送信します。TM1 標準の認証と統合ログオンの場合、以下のパラメーター形式を使用します。• param0=TM1_Admin_host• param1=TM1_server_name• param2=username• param3=password

以下に例を挙げます。param0=localhost&param1=SData&param2=admin&param3=apple

IBM Cognos Analytics セキュリティーを認証に使用している場合は、以下の形式を使用して、camPassportの値を指定します。• param0=TM1_Admin_host


• param1=TM1_Server_name• param2=camPassport

セッション・トークン・ログオンの JSON 応答ログオン要求の結果は、JSON 形式の文字列で返されます。ログオン要求が成功した場合、以下の形式の応答が返されます。{ "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 サーバー、およびユーザー名 (オプション)に基づいて URL API セッションを再利用することができます。

付録 A TM1 Web API 103

URL API でセッション・トークンによるログオン方式を使用する場合は、tm1web_config.xml ファイル内の LegacyUrlApiSessionDiscoveryEnabled 構成パラメーターを False に設定する必要があります。セッション・トークンを使用したログオン方法について詳しくは、101 ページの『TM1 Web API セッション・ログオン』を参照してください。

形式<add key="LegacyUrlApiSessionDiscoveryEnabled" value=True または False/>以下に例を挙げます。<add key="LegacyUrlApiSessionDiscoveryEnabled" value="False"/>

値デフォルト値は True です。true

TM1 Web は、指定された情報 (TM1 管理ホスト、TM1 サーバー、ユーザー名) に基づいて、新しいログオン要求と既存のログオン・セッションのマッチングを試行します。TM1 管理ホスト、TM1 サーバー、ユーザー名の固有な組み合わせごとにシングル・ログオンを行う場合は、このパラメーターを必ず True に設定してください。

falseTM1 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 を使用したログオンの全体的なプロセスは、セッション・トークンを使用したログオンのプロセスと似ています。相違点は、sessionTokenパラメーターの代わりに TM1SessionID パラメーターを使用する点のみです。TM1SessionId=valid TM1 session ID

このログオン方式では、新しい TM1 Web セッションを作成し、TM1SessionId に対応する TM1 サーバー・セッションを再利用できます。1 つの 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 ライブラリーでユーザー・セッションとログオン・ダイアログを容易に管理できます。セッションtm1web/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: "D3lJLw50uvh2jtbAcIYyVA"}

ログオン操作の完了時に解決された promise として dojo/promise/Promise を返します。ログオンに失敗すると、promise は拒否されます。成功すると解決されます。ログオンに成功すると、promiseに以下の形式のオブジェクトが渡されます。{ sessionToken: "7118fad5-bbeb-4b3e-8bea-4b4a45ca2735", tm1SessionId: "D3lJLw50uvh2jtbAcIYyVA", 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: "D3lJLw50uvh2jtbAcIYyVA", 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([ "tm1web/api/session/session"], function(session) { session.getInfo("sessionToken").then(function(sessionInfo) { // Continue using obtained sessionInfo });});

// logoutrequire([ "tm1web/api/session/session"], function(session) { 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();


https://dojotoolkit.org/reference-guide/1.10/dijit/_WidgetBase.html

構成LoginDialog モジュールは、複数の構成パラメーターを取ります。onLoginタイプ: Functionログオンが成功した場合のコールバック。実行時に、セッション情報を含むオブジェクトがパラメーターとしてこの関数に渡されます。

このようなオブジェクトの例を以下に示します。{ tm1SessionId : "JcFxniSEzsJZVlQQhYDLDQ", sessionToken : "baa4ff9a-ddfb-41d1-9c71-f0add92325fd", adminHost : "localhost", tm1Server : "Planning Sample", username : "Admin"}

このオブジェクトの形式は、tm1web/api/session/session の login メソッドの応答と同じです。adminHostタイプ: String (オプション)デフォルト値: localhostTM1 サーバー・リストの取得元の管理ホスト。管理ホストのパラメーターを指定しない場合は、tm1web_config.xml ファイルの AdminHost パラメーター値が使用されます (指定されている場合)。

tm1Serverタイプ: String (オプション)ログオン先の TM1 サーバー。

adminHostVisibleタイプ: Boolean (オプション)デフォルト値: truefalse の場合、ログオン・ダイアログに管理ホストのテキスト・ボックスが表示されません。

tm1ServersVisibleタイプ: Boolean (オプション)デフォルト値: truefalse の場合、ログオン・ダイアログに 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 APITM1 Web の URL API を使用して、TM1 Web の Web シート・オブジェクトおよび CubeViewer オブジェクトを、HTML ベースのドキュメントまたは Web ページのソリューションに組み込めます。

TM1 Web URL API の概要URL API は、TM1 Web の Web シート・オブジェクトおよび CubeViewer オブジェクトを独自のカスタムWeb ページに表示する URL を作成するためのフレームワークを提供します。URL API を使用すると、Web シート・オブジェクトおよび CubeViewer オブジェクトを、Web ページ、Webアプリケーション、ダッシュボードなどの HTML ベースの任意のソリューションに組み込むことができます。URL API は、URL とパラメーターの特別なセットを使用して Web シート・オブジェクトと CubeViewerオブジェクトにアクセスすることを可能にします。

開発ツールURL API を使用してソリューションを作成するには、HTML に関する知識と、望ましくは JavaScript に関する知識が必要です。テストの目的や簡単な例では、Web ブラウザーのアドレス・バーで直接 URL API を使用できます。URL APIによるソリューションの作成には、単純なテキスト・エディターや HTML および JavaScript を使用できる開発環境を利用できます。URL API は、CubeViewer オブジェクトおよび Web シート・オブジェクトをカスタム Web ページに表示するための主要な方法として HTML インライン・フレーム (<iframe> タグ) を使用します。

機能カスタム Web ページに以下の機能を与える URL を組み立てることができます。• Web シートおよび CubeViewer

– CubeViewer オブジェクトおよび Web シート・オブジェクトにアクセスして表示する– タイトル・ディメンション要素を設定する– ツールバーのオン/オフなどのプロパティーを制御する

• CubeViewer

– グリッド・モード、グラフ・モード、またはグリッドとグラフのモードで表示する– グラフの種類を変更する– 自動再計算を有効化/無効化する– キューブ・ビューのレイアウトを保存する– ビューを再計算する

• Web シート– アクティブ・フォームを再構築する

TM1 Web URL API の導入基本 URL と特定の TM1 パラメーターを使用して URL を作成し、完成した URL を TM1 Web サーバーに渡します。完成した URL によって Web シート・オブジェクトまたは 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 オブジェクトおよびWeb シート・オブジェクトをカスタム Web ページに表示します。<iframe> タグは、URL API を使用してCubeViewer オブジェクトおよび Web シート・オブジェクトを表示する主要な方法です。TM1 Web オブジェクトが iframe に表示されたら、その iframe の src (ソース) プロパティーを新しい URLで更新することで、そのオブジェクトに対して操作を適用できます。詳しくは、110 ページの『HTML iframe タグを使用した TM1 Web オブジェクトの表示』を参照してください。TM1 Web URL API の基本 URLすべての要求を TM1 Web URL API で作成するための基盤として、基本 URL を使用します。基本 URL の例を以下に示します。http://localhost:9510/tm1web/UrlApi.jsp

基本 URL に 1 つ以上のパラメーターを組み合わせて、完全な要求を作成できます。基本 URL の形式は、次のとおりです。http://WebServerName:PortNumber/tm1web/UrlApi.jsp

WebServerNameTM1 Web サーバーをホストしているコンピューターのドメイン名または IP アドレス。例えば、現在 TM1 Web サーバーを実行しているコンピューターで直接作業する場合は、WebServerName パラメーターに localhost を使用できます。http://localhost:9510/tm1web/UrlApi.jsp

TM1 Web サーバーがリモート・コンピューターで実行されている場合は、そのシステムの名前を次のように使用します。http://MyWebServer:9510/tm1web/UrlApi.jsp

http://www.example.com:9510/tm1web

PortNumberWeb アプリケーション・サーバーのポート番号。TM1 の標準インストール済み環境では、ポート番号 9510 が使用されます。

UrlApi.jspTM1 Web URL API の機能は UrlApi.jsp ファイルを介して提供されます。

TM1 Web URL API のパラメーターパラメーターを使用して、どの 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

Web シート・オブジェクトまたは CubeViewer オブジェクトを Web ページで開いたら、パラメーターを使用して追加の操作をそのオブジェクトに適用できます。例えば、次の URL は、AutoRecalc パラメーターと HideDimensionBar パラメーターを使用しています。

http://localhost:9510/tm1web/UrlApi.jsp#AutoRecalc=true

http://localhost:9510/tm1web/UrlApi.jsp#HideDimensionBar=true

パラメーターの処理について詳しくは、以下のトピックを参照してください。• 114 ページの『TM1 Web オブジェクトに Action パラメーターを使用する』.• 114 ページの『Open パラメーターを使用して TM1 Web オブジェクトを開く』.• 115 ページの『既存の TM1 Web オブジェクトへのパラメーターと操作の適用』.

URL API での URL エスケープ文字の使用スペースや、その他の特殊文字を含んだ URL を作成するときは、URL エスケープ文字を使用します。URL エスケープ文字の一般的な例としては、以下の項目があります。文字エスケープ文字スペース %20

$ %24

% %25

& %26

= %3D

TM1 Web URL API の概念URL API の使用に関する基本概念には、HTML iframes でのオブジェクトの表示、ログオン資格情報の指定、オブジェクトのオープン、および操作の適用が含まれます。HTML iframe タグを使用した TM1 Web オブジェクトの表示URL API で CubeViewer オブジェクトおよび Web シート・オブジェクトをカスタム Web ページに表示するには、HTML インライン・フレーム (<iframe> タグ) を使用します。<iframe> タグは、URL API を使用して CubeViewer オブジェクトと Web シート・オブジェクトをカスタム Web ページに表示する主要な方法です。


TM1 Web オブジェクトが iframe に表示されたら、その iframe の src (ソース) プロパティーを新しい URLで更新することで、そのオブジェクトに対して操作を適用できます。

例以下の例では、標準の HTML ボタンと JavaScript 関数を使用して Web シートを iframeにロードします。<button onClick="loadWebsheet();">Load Websheet</button>

<iframe id="websheetId" style="width:100%; height:100%;"></iframe>

<script type="text/javascript">

// The function to assemble the required URL and display the Websheet function loadWebsheet() {

// Get a reference to the iframe webSheet = document.getElementById("websheetId");

// Assemble the URL that specifies the Websheet you want to open baseUrl = "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 Websheet webSheet.src = websheetURL; };</script>

URL API での TM1 管理ホストと TM1 サーバーのパラメーターの指定AdminHost パラメーターと TM1Server パラメーターを使用して、TM1 管理ホストとサーバーの名前をURL 文字列内に設定できます。AdminHost パラメーターと TM1Server パラメーターは、#Action=Open コマンドと一緒に URL に指定することも、セッション・トークンを使用して暗黙的に指定することもできます。これらの値は URL のオプションですが、以下のいずれかの方法で TM1 に渡す必要があります。• tm1web_config.xml ファイルに指定する• セッション・トークンを使用する• URL 文字列に指定する• フォーム・ベースのログオンを使用して TM1 Web サーバーに送る• TM1 Web からプロンプトが出されたときにユーザーが指定するこれらの値が見つからない場合、TM1 はミニポップアップ・ウィンドウでその情報をユーザーに要求します。管理ホストとサーバー名は、以下の順序で決まります。1.セッション・トークンが指定されている場合、まずそこから管理ホストと TM1 サーバーが判別されます。セッション・トークンは特定のセッションを指しているからです。

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 サーバーの名前。

例えば、次のサンプル・コードは、ローカル・システムと TM1 Planning Sample データベースを使用します。&AdminHost=localhost&TM1Server=Planning Sample

URL API でのユーザーのログオンとログアウトの管理URL API を使用して TM1 Web オブジェクトを表示するには、IBM TM1 サーバーにログオンする必要があります。ユーザー・ログオン・プロセスは以下のさまざまな方法で管理できます。セッション・トークン・ログオンセッション・トークン・ログオンでは、複数の TM1 Web インスタンス、TM1 管理ホスト、および TM1サーバーの間で一意のユーザー・セッションを追跡できます。セッション・トークン・ログオンが推奨されるログオン方式です。ユーザーが同時に複数の TM1 Webインスタンスまたは別々の TM1 サーバーにログオンする場合は、このログオン方式を使用してください。詳しくは、101 ページの『TM1 Web API セッション・ログオン』を参照してください。

TM1 セッション ID ログオンユーザーは、管理ホスト、TM1 サーバー名、および TM1SessionId を使用して TM1 サーバー・セッションを指定してログオンすることもできます。TM1SessionId は、TM1 サーバー上のユーザー・セッションに対応します。すべての TM1 Web セッションには TM1 サーバー・セッションが必要です。TM1 Web セッションで使用される TM1 サーバー・セッションは変更されません。Web セッションの作成時に生成または指定する必要があります。複数の TM1 Web セッションで同じ TM1 サーバー・セッションを使用できます。このログオン方式では、新しい TM1 Web セッションを作成し、TM1SessionId に対応する TM1 サーバー・セッションを再利用できます。1 つの 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 内にパスワードを指定することは、安全ではありません。ポップアップ・ログオン・ウィンドウログオン情報のすべてまたは一部が他の方法で提供されない場合は、TM1 Web オブジェクトが表示される前に、ユーザーにログオンを要求するポップアップ・ウィンドウが表示されます。


フォーム・ベースのログオン入力フィールドを含む標準の HTML フォームを使用してユーザーのログオン資格情報を収集し、その情報を TM1 Web サーバーに送ることができます。詳しくは、113 ページの『TM1 Web URL API のフォーム・ベースのログオン』を参照してください。

IBM Cognos Analytics セキュリティー認証を使用する場合は、CamPassport パラメーターを指定できます。TM1 Web URL API のフォーム・ベースのログオン入力フィールドを含む標準の HTML フォームを使用してユーザーのログオン資格情報を収集し、その情報を TM1 Web サーバーに送ることができます。次の名前の <input> フィールドをフォームに含めてください。フォームを送信すると、フィールド名および関連する値が TM1 Web サーバーに送られます。• AdminHost• TM1Server• Username• 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>

<script type="text/javascript">

// This function submits the login form and opens a CubeViewer function loadCubeview() {

// Get a reference to the login form var 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 form loginForm.action = baseUrl + params;

// NOTE: Be sure to use the iframe name for the target of the login form loginForm.target = "cubeviewIFrame";

// Submit the form to login and display the TM1 Web object loginForm.submit(); };</script>

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 オブジェクトまたは Web シート・オブジェクトを開くことができる #Action=Open コマンドです。Action パラメーターは、URL 文字列の中で次のように使用します。#Action=TypeOfAction

TypeOfAction の値としては、Open、Recalc、Close など、サポートされる操作のいずれかを指定できます。使用可能な操作タイプの完全なリストについては、123 ページの『URL API の Action パラメーター』を参照してください。

例例えば、次の URL は TM1 Web CubeViewer オブジェクトを開きます。http://localhost:9510/tm1web/UrlApi.jsp#Action=Open&Type=CubeViewer&Cube=plan_BudgetPlan&View=Budget InputDetailed&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 オブジェクトを開く例を示しています。http://localhost:9510/tm1web/UrlApi.jsp#Action=Open&Type=CubeViewer&Cube=plan_BudgetPlan&View=Budget%20Input%20Detailed&AccessType=Public&AdminHost=localhost&TM1Server=Planning%20Sample

オブジェクトを開く方法について詳しくは、以下のトピックを参照してください。• 115 ページの『URL API による Web シート・オブジェクトの表示』.• 117 ページの『URL API による CubeViewer オブジェクトの表示』.


Web シート・オブジェクトまたは CubeViewer オブジェクトを Web ページで開いたら、パラメーターを使用して追加の操作をそのオブジェクトに適用できます。詳しくは、115 ページの『既存の TM1 Web オブジェクトへのパラメーターと操作の適用』を参照してください。既存の TM1 Web オブジェクトへのパラメーターと操作の適用TM1 Web オブジェクトが Web ページに表示されたら、パラメーターを使用してオブジェクトの URL を更新することで、その特定のオブジェクトに追加の操作を適用できます。既に表示されている Web シート・オブジェクトまたは CubeViewer オブジェクトに追加の操作を適用するには、必要なパラメーターを指定して新しい URL を作成します。そして、その新しい URL を、オブジェクトが表示されている iframe の src (ソース) プロパティーに適用します。オブジェクトが既に iframe に表示されている場合は、操作パラメーターを基本 URL に追加するだけで新しい URL を作成できます。例えば、次の URL は、AutoRecalc パラメーターと HideDimensionBar パラメーターを基本 URL に追加したものです。http://localhost:9510/tm1web/UrlApi.jsp#AutoRecalc=true

http://localhost:9510/tm1web/UrlApi.jsp#HideDimensionBar=true

注 :

AutoRecalc パラメーターは CubeViewer にのみ適用できます。Web シートではサポートされません。Web シートでは、自動再計算は UseBookRecalcSetting パラメーターと Excel ブックの設定によって処理されます。詳しくは、TM1 Web 構成パラメーターを参照してください。

例次の例は、既に CubeViewer オブジェクトが表示されている iframe の src プロパティーに、更新した URLを適用する JavaScript 関数を示しています。<iframe id="cubeviewId"></iframe>

<script type="text/javascript"> // This function updates an existing CubeViewer object function toggleDimensionBar() { // Get a reference to the existing iframe and CubeViewer cubeView = document.getElementById("cubeviewId");

// Create an updated URL and apply it to the iframe baseUrl = "http://localhost:9510/tm1web/UrlApi.jsp"; cubeView.src = baseUrl + "#HideDimensionBar=True"; };</script>

URL API による Web シート・オブジェクトの表示Web シートは、TM1 データを含む Microsoft Excel スプレッドシート・ファイルであり、Web ブラウザーで表示できます。 URL API を使用すると、Web シートを HTML iframe に表示し、その後に追加の操作とパラメーターを Web シートに適用することができます。Web シート・オブジェクトを開くURL API を使用して Web シート・オブジェクトを開くには、TM1 Application フォルダーに編成されている Web シートのロケーション・パスを使用します。

手順1. TM1 Web を開き、「アプリケーション」ノードを展開して、開く Web シートを見つけます。



2. Web シートへのパスを表すテキスト文字列を作成します。パスの先頭には Applications/ を付け、サブフォルダーはスラッシュ (/) 記号で区切ります。例: Applications/My Reports/Report_2014.xls

3. URL 内の Workbook パラメーターに、作成したパスを設定します。#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 関数は、Web シートを iframe にロードします。

function loadWebsheet() {

// Get a reference to an existing iframe that has this ID webSheet = document.getElementById("websheetId");

// Assemble the URL and assign it to the iframe webSheet.src = baseUrl + "#Action=Open&Type=WebSheet &Workbook=Applications/Planning Sample/Management Reporting/Actual v Budget &AdminHost=localhost&TM1Server=Planning Sample";

};

Web シート・オブジェクトの表示プロパティーの設定Web シート・オブジェクトの表示プロパティーを設定するには、関連するパラメーターを URL に指定します。以下のパラメーターを使用すると、Web シート・オブジェクトの表示を変更できます。HideToolbarツールバーをオンまたはオフにします。デフォルトはオンです。

例Web シート・オブジェクトの表示プロパティーを制御するには、URL 内で次の形式を使用します。property=value

例えば、ツールバーの表示をオフにするには、URL に次の行を追加します。HideToolbar=True

Web シート・オブジェクトのディメンション・タイトル要素の選択SUBNM 関数が入っているセルの場合は、Web シート・オブジェクトのタイトル・ディメンションに現行要素を設定できます。ディメンションを指定するには、シート番号、行番号、および列番号を使用するか、ディメンション名を使用します。新しい要素は、要素名または要素インデックスのいずれかで選択できます。


形式および値シート番号、行番号、および列番号でディメンションを指定するには、以下の形式を使用します。Title_S#-R#-C#=elementNameOrIndex

ディメンション名でディメンションを指定するには、以下の形式を使用します。Title_dimensionName=elementNameOrIndex

以下のパラメーターを使用します。Title_S#-R#-C#タイトル・ディメンションをシート番号、行番号、および列番号で指定します。# 記号を、Web シート内のディメンションの SUBNM セルの位置を示すシート、行、および列の値に置き換えてください。

Title_dimensionNameタイトル・ディメンションをディメンション名で指定します。

elementNameOrIndex選択する新しいタイトル要素の名前または数値 (インデックスの場合) を表すストリング値。新しいタイトル要素を要素名ではなく要素インデックスで選択する場合は、次のように UseIndex パラメーターを URL に指定します。Title_S#-R#-C#=ElementIndexNumber&UseIndex=true

例以下の例を使用して、まず Web シートを開き、次にタイトル要素を変更します。1.次の URL を Web ブラウザーのアドレス・バーに直接コピーして貼り付け、まず 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

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 オブジェクトを開くTM1 Web CubeViewer オブジェクトを指定して開くには、URL 内に Action=Open コマンドと Type、Cube、View、および AccessType パラメーターを組み合わせて指定します。CubeViewer オブジェクトを開くには、次の形式を使用します。#Action=Open&Type=CubeViewer&Cube=CubeName&View=ViewName&AccessType=Status

ここで：• CubeName は、ビューが属するキューブの名前です。• ViewName は、キューブ・ビューの名前です。• Status は、キューブ・ビューのステータス (共有または個人用) です。開く特定のキューブ・ビューを正しく指定するには、Public または Private のいずれかの値を指定する必要があります。次の URL を Web ブラウザーのアドレス・バーに直接コピー・アンド・ペーストして、この例を確認してください。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 ID cubeView = document.getElementById("cubeviewId");

// Assemble the URL and assign it to the iframe cubeView.src = baseUrl + "#Action=Open&Type=CubeViewer &Cube=plan_BudgetPlan&View=Budget Input Detailed&AccessType=Public";

};

CubeViewer オブジェクトの表示プロパティーの設定CubeViewer オブジェクトの表示プロパティーを設定するには、関連するパラメーターを URL に指定します。以下のパラメーターを使用して、CubeViewer オブジェクトの表示を変更できます。AutoRecalc自動再計算をオンまたはオフにします。デフォルトはオフです。注 :

AutoRecalc パラメーターは CubeViewer にのみ適用できます。Web シートではサポートされません。自動再計算モードは、ピボット、タイトル変更、ゼロ消去変更などのジェスチャーに適用されます。リーフ・セルに対するデータ変更には、自動再計算モードは適用されません。リーフ・セルは、変更されると必ず緑色になります。CubeViewer では、AutoRecalc パラメーターは「自動再計算モード (Automatic Recalculation Mode)」ツールバー・ボタン (Web シートには存在しません) と同じ目的で使用されます。自動再計算モードがオフの場合 (手動再計算モード)、ピボット、タイトル変更、ゼロ消去変更などのジェスチャーでは、データの再計算を更新する必要があります。Web シートでは、自動再計算は UseBookRecalcSetting パラメーターと Excel ブックの設定によって処理されます。詳しくは、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を開きます。http://localhost:9510/tm1web/UrlApi.jsp#Action=Open&Type=CubeViewer&Cube=plan_BudgetPlan&View=Budget%20Input%20Detailed&AccessType=Public&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

使用可能なオプションには、以下の値があります。• Grid• Chart• GridAndChart

例DisplayMode=Chart

DisplayMode=Grid

DisplayMode=GridAndChart

URL API によるグラフ・タイプの設定ChartType パラメーターを使用して、CubeViewer オブジェクトで表示するグラフのタイプを設定します。ChartType パラメーターの形式は、次のとおりです。ChartType=ChartName

ここで、ChartName は、使用可能なグラフ・タイプの 1 つを表す文字列値 (Column や Pie など) にすることができます。使用可能なグラフ・タイプの完全なリストについては、125 ページの『URL API のChartType パラメーター』を参照してください。

URL の例次の URL を Web ブラウザーのアドレス・バーに直接コピー・アンド・ペーストして、この例を確認してください。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

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>

<iframe id="cubeviewId" style="width:100%; height:100%;"></iframe>

<script type="text/javascript"> function setChartType(value) { if(!value) { return; }

cubeView = document.getElementById("cubeviewId"); baseUrl = "http://localhost:9510/tm1web/UrlApi.jsp"; cubeView.src = baseUrl + "#ChartType=" + value; };

</script></body>

以前の URL API プロジェクトを新しい TM1 Web URL API にアップグレードする

.NET ベースの TM1 Web URL API を使用したカスタム Web ページを、Java ベースの新しい TM1 Web URLAPI にアップグレードするには、この情報を利用してください。IBM TM1 バージョン 10.2.0 以降、TM1 Web は Java™ ベースの Web アプリケーション・サーバーで実行されるようになりました。TM1 Web バージョン 10.2.0 では、 Microsoft .NET Framework は不要であり、使用しません。このような変更のために、URL API の構文と機能が更新されています。

TM1 Web 10.2.0 環境の変更点TM1 Web の主な変更点のいくつかを、以下のリストに要約します。インストール、設定、アーキテクチャーについて詳しくは、「Planning Analytics Local インストールおよび設定」を参照してください。TM1 Web の新しいデフォルト・インストール・ディレクトリーバージョン 10.2.0 以降、TM1 Web のデフォルト・インストール・ディレクトリーは次の場所です。<TM1_install>¥webapps¥tm1web¥

TM1 Web を開始するための新しいデフォルト URLTM1 Web バージョン 10.2.0 を開くには、次の新しいデフォルト URL を使用します。http://localhost:9510/tm1web/

新しい TM1 Web 設定ファイルとパラメーターTM1 Web バージョン 10.2.0 では、 tm1web_config.xml という名前の新しい設定ファイルを使用します。このファイルは、これまでのバージョンの TM1 Web の web.config ファイルを置き換えるものです。新しい設定ファイルの場所は次のとおりです。<TM1_install>¥webapps¥tm1web¥web-inf¥configuration

TM1 Web 10.2.2 の URL API の変更点TM1 Web 10.2.2 の URL API には以下の変更と更新が含まれています。オブジェクト

• 10.2.2 の URL API では、TM1 Web ナビゲーション・ツリー・オブジェクトはサポートされません。• 10.2.2 の URL API では、Web ページ内の既存オブジェクトに対する操作を追跡および適用するために、ObjectId パラメーターを使用しません。代わりにオブジェクトの現在の状態を内部的に維持することで、新しい URL API ではクロスドメインにおける使用方法が改善されています。オブジェクト


が表示されている iframe を使用して、TM1 Web オブジェクトに追加の操作を適用できるようになっています。

パラメーター• パラメーターと基本 URL の区切りには、疑問符 (?) ではなくハッシュ・タグ記号 (#) が使用されるようになりました。例: http://localhost:9510/tm1web/UrlApi.jsp#Parameters

• OpenObject パラメーターの名前は Open に変更されました。• パラメーター値 Yes と No は、True と False に置き換えられました。値 0 と 1 は引き続き有効です。

• 10.2.2 では、Action=Save パラメーターの動作が異なり、CubeViewer オブジェクトにのみ適用されます。この操作では、ビューのレイアウトのみが保存され、データの変更は保存されません。CubeViewer オブジェクトのデータを保存するには、Recalc 操作を使用します。

• HideTitlebar パラメーターの名前は HideDimensionBar に変更されました。• HideTabs パラメーターは使用されなくなりました。• ChartType パラメーターは数値ではなく文字列値を使用するようになりました。

10.2.2 の URL API に更新するために必要なコード変更新しい URL API にプロジェクトをアップグレードするには、以下のコード変更を確認して適用します。基本 URL の変更

TM1 Web 10.2.2 の新しい形式を使用するように既存の基本 URL を変更します。• 既存の基本 URL: http://HostName/TM1Web/TM1WebMain.aspx• 変更後の URL: http://HostName:9510/tm1web/UrlApi.jsp

TM1WebMain.aspx ハンドラー・ファイルは UrlApi.jsp ファイルに置き換えられました。URL パラメーターの更新

TM1 Web 10.2.2 の URL API の変更点のリストを確認します。例えば、パラメーターと基本 URL の区切りにはハッシュ・タグ記号 (#) が使用されるようになり、一部のパラメーターは名前が変更されています。

ログオン・プロセスの更新10.2.2 の URL では新しいセッション・トークン・ログオン方式を使用してログオン・セッションを一意的に識別します。新しいフォーム・ベースのログオンも使用可能です。

ObjectId パラメーターの置換開いたオブジェクトを追跡するために ObjectId パラメーターを使用していたコードを更新します。代わりにオブジェクトの現在の状態を内部的に維持することで、新しい URL API ではクロスドメインにおける使用方法が改善されています。この機能を使用すると、オブジェクトを更新したいときにはいつでも、iframe の src プロパティーを更新することで TM1 Web オブジェクトに追加の操作を適用できます。

TM1 Web URL API パラメーター・リファレンスパラメーターを使用して、どの IBM 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 TM1 Web オブジェクトに対して実行する操作のタイプを指定します。

形式&Action=Type_Of_Action

値値説明Close 既存のオブジェクトを閉じます。Logout 同じセッションの下にある他のすべての URL API インスタンスのセッションを

終了します。Open TM1 Web オブジェクトを開きます。Rebuild Web シートに含まれている TM1 アクティブ・フォームのすべての値を再計算し

て、すべてのサブセットを再構築します。この操作は、TM1 Web ツールバーの「再構築」ボタンをクリックした場合と同じ操作を実行します。

Recalc 既存の Web シート・オブジェクトまたは CubeViewer オブジェクトを再計算します。

Reload CubeViewer オブジェクトのみを再ロードします。


値説明Save キューブ・ビューのレイアウトを保存します。CubeViewer オブジェクトにのみ

適用されます。注 : Save 操作では、ビュー内のデータの変更は保存されません。変更されたデータを保存するには、Recalc 操作を使用してください。

URL の例以下の URL の例は、Web ページに既に表示されている CubeViewer オブジェクトまたは Web シート・オブジェクトに対して実行する操作を示しています。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 オブジェクトまたは Web シート・オブジェクトに対してそれぞれ異なる操作を実行する一連の JavaScript 関数を示しています。<script type="text/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"; };

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"; };

function rebuildActiveForms() { webSheet.src = baseUrl + "#Action=Rebuild"; };

function recalculate() { getActiveIFrame().src = baseUrl + "#Action=Recalc"; };

function resetView() { cubeView.src = baseUrl + "#Action=Reset"; };

function saveView() { cubeView.src = baseUrl + "#Action=Save"; };

function close() { getActiveIFrame().src = baseUrl + "#Action=Close"; };

</script>


URL API の AdminHost パラメーターAdminHost パラメーターは、IBM TM1 管理ホストが実行されているシステムの名前を定義します。デフォルト値は localhost です。

形式&AdminHost=admin_host_name

値AdminHost パラメーターの値は、TM1 管理サーバーが実行されているシステムの名前です。

例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 の AutoRecalc パラメーターAutoRecalc パラメーターは、自動再計算をオンまたはオフにするために使用します。デフォルトはオフです。

形式&AutoRecalc=value

値値説明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 パラメーターDisplayMode パラメーターは、CubeViewer オブジェクトをグリッド・モード、グラフ・モード、またはグリッドとグラフのモードで表示するために使用します。

形式&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 オブジェクトおよび Web シート・オブジェクトのツールバーの表示を制御するために使用します。

形式&HideToolbar=value

値値説明1、true ツールバーを非表示にします。0、false ツールバーを表示します。

例#HideToolbar=1

URL API の TM1Server パラメーターTM1Server パラメーターは、ログオンする IBM TM1 サーバーを指定します。

形式&TM1Server=TM1_server_name

値TM1Server パラメーターの値は、ログオンする TM1 サーバーの名前です。

例&TM1Server=Planning Sample

URL API の TM1SessionId パラメーターTM1SessionId パラメーターは、ログオンする IBM TM1 サーバー・セッションを指定します。

形式&TM1SessionId=valid_TM1_session_ID

値ユーザーは、管理ホスト、TM1 サーバー名、および TM1SessionId で TM1 サーバー・セッションを指定してログオンできます。TM1SessionId パラメーターは、TM1 サーバー上のユーザー・セッションに対応します。詳しくは、101 ページの『TM1 Web API セッション・ログオン』を参照してください。

例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 オブジェクトを Web シートとして定義します。

例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 を示します。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 の Workbook パラメーターWorkbook パラメーターは、ロードするブックを表す IBM TM1 サーバーのツリー内のパスを指定します。

形式&Workbook=path_to_workbook

値Workbook パラメーターの値は、TM1 Application フォルダーに編成されている TM1 Web シートのパスです。


例&Workbook=Applications/Planning Sample/Management Reporting/Actual v Budget

以下の例に完全な URL を示します。http://localhost:9510/tm1web/UrlApi.jsp#Action=Open&Type=WebSheet&Workbook=Applications/Planning%20Sample/Management%20Reporting/Actual%20v%20Budget&AdminHost=localhost&TM1Server=Planning%20Sample

TM1 Web JavaScript ライブラリーTM1 Web JavaScript ライブラリーを使用すると、HTML、JavaScript、Dojo を組み合わせた Web ページ開発環境で、TM1 Web の Web シート・オブジェクトと CubeViewer オブジェクトをプログラムから利用することができます。JavaScript ライブラリーを使用するには、JavaScript、Dojo Toolkit、HTML DocumentObject Model (DOM) に関する実用的な知識が必要です。

概要TM1 Web JavaScript ライブラリーには、以下のメインクラスが含まれています。Workbook クラス

TM1 Web の Web シートを表します。CubeViewer クラス

TM1 Web CubeViewer を表します。これらのメインクラスは、dijit._WidgetBase という Dojo Toolkit ウィジェット・クラスを拡張したものです。この拡張により、ブック・オブジェクトと CubeViewer オブジェクトは、他の Dojo オブジェクト(Dojo タブ・コンテナーなどのコンテナー) の子として割り当てることができます。Dojo について詳しくは、http://dojotoolkit.org/documentation/ の Dojo の資料を参照してください。Web シート・オブジェクトと CubeViewer オブジェクトには、プログラムから利用できる関連プロパティーとメソッドも一式用意されています。これらのオブジェクトは非同期でロードされます。ロードが終わるまでコードでオブジェクトを操作することはできません。注 :

TM1 Web JavaScript ライブラリーの以下のオブジェクトは非推奨になりました。• tm1web/cubeview/CubeViewer• tm1web/websheet/Workbook

代わりに tm1web/api/CubeViewer と tm1web/api/Workbook を使用してください。tm1web/cubeview と tm1web/websheet のパッケージ内のモジュールは、tm1web/api package 内のモジュールの別名になりました。

設定TM1 Web JavaScript ライブラリーを使用するには、以下の設定が必要です。1. TM1 Web をインストールし、Web ブラウザーを使用して標準ユーザー・インターフェースにログオンできることを確認します。

2. JavaScript ライブラリーを使用するカスタム Web ページ・ファイルの head セクションに、必須の参照を追加します。詳しくは、131 ページの『JavaScript ライブラリーを使用するために必須の HTML <head> タグと<body> タグ』を参照してください。


http://dojotoolkit.org/documentation/

JavaScript ライブラリーの導入TM1 Web 環境の設定が済んだら、JavaScript ライブラリーを使用して、オブジェクトにアクセスするための Web ページのコーディングを開始できます。詳細と例については、以下のトピックを参照してください。• 134 ページの『JavaScript ライブラリーによる Web シート・オブジェクトのロード』.• 135 ページの『JavaScript ライブラリーによる CubeViewer オブジェクトのロード』.

AMD ローダーへの JavaScript ライブラリーの設定IBM Planning Analytics Local バージョン 2.0.0 以降、TM1 Web の JavaScript ライブラリー・モジュールをロードするために、TM1 Web に付属する Dojo バージョンを使用する必要はなくなりました。TM1 Web の JavaScript ライブラリー・モジュールは、Dojo バージョン 1.7 以降の AMD ローダーを使用してロードできるようになりました。詳しくは、131 ページの『AMD ローダーへの JavaScript ライブラリーの設定』を参照してください。

JavaScript ライブラリーを使用するために必須の HTML <head> タグと <body>タグ

TM1 JavaScript ライブラリーを使用する各カスタム Web ページの HTML <head> セクションと <body>セクションには、一連の必須のタグと参照を指定する必要があります。JavaScript ライブラリーを使用するすべての HTML 文書に、以下の参照を追加します。• HTML 5 DOCTYPE 宣言を指定します。• meta 参照を <head> セクションに追加します。• class 参照を <body> セクションに追加します。• JS Library モジュールが正しく検出されるように AMD ローダーの設定を操作する追加のコードを追加します。これらの参照は 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>

AMD ローダーへの JavaScript ライブラリーの設定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: { dojo: "tm1webDojo", dijit: "tm1webDijit", dojox: "tm1webDojox", com: "tm1webCom" }, tm1webDojo: { dojo: "tm1webDojo", dijit: "tm1webDijit", dojox: "tm1webDojox", com: "tm1webCom" }, tm1webDijit: { dojo: "tm1webDojo", dijit: "tm1webDijit", dojox: "tm1webDojox", com: "tm1webCom" }, tm1webDojox: { dojo: "tm1webDojo", dijit: "tm1webDijit", dojox: "tm1webDojox", com: "tm1webCom" } }});

以下の例は、Dojo 1.7 の AMD ローダーを設定する方法を示しています。require({ packages: [ { name: "tm1web", location: "location/to/tm1web/scripts/tm1web", packageMap: { dojo: "tm1webDojo", dijit: "tm1webDijit", dojox: "tm1webDojox", com: "tm1webCom" }


}, { name: "tm1webCom", location: "location/to/tm1web/scripts/com", packageMap: { dojo: "tm1webDojo", dijit: "tm1webDijit", dojox: "tm1webDojox", com: "tm1webCom" } }, { name: "tm1webRave", location: "location/to/tm1web/scripts/com", packageMap: { dojo: "tm1webDojo", dijit: "tm1webDijit", dojox: "tm1webDojox", com: "tm1webCom" } }, { name: "tm1webDojo", location: "location/to/tm1web/scripts/dojo", packageMap: { dojo: "tm1webDojo", dijit: "tm1webDijit", dojox: "tm1webDojox" } }, { name: "tm1webDijit", location: "location/to/tm1web/scripts/dijit", packageMap: { dojo: "tm1webDojo", dijit: "tm1webDijit", dojox: "tm1webDojox" } }, { name: "tm1webDojox", location: "location/to/tm1web/scripts/dojox", packageMap: { dojo: "tm1webDojo", dijit: "tm1webDijit", dojox: "tm1webDojox" } } ]});

以下の例は、完全な設定の例です。<!DOCTYPE html><html><head><meta charset="UTF-8"><meta http-equiv="X-UA-Compatible" content="IE=edge"><script src="path/to/the/1.10/version/of/dojo.js"></script><script> require({ packages: [ { name: "tm1web", location: "http://localhost:9510/tm1web/scripts/tm1web" }, { name: "tm1webCom", location: "http://localhost:9510/tm1web/scripts/com" }, { name: "tm1webDojo", location: "http://localhost:9510/tm1web/scripts/dojo" }, { name: "tm1webDijit", location: "http://localhost:9510/tm1web/scripts/dijit" }, {


name: "tm1webDojox", location: "http://localhost:9510/tm1web/scripts/dojox" } ], map: { tm1web: { dojo: "tm1webDojo", dijit: "tm1webDijit", dojox: "tm1webDojox", com: "tm1webCom" }, tm1webCom: { dojo: "tm1webDojo", dijit: "tm1webDijit", dojox: "tm1webDojox", com: "tm1webCom" }, tm1webRave: { dojo: "tm1webDojo", dijit: "tm1webDijit", dojox: "tm1webDojox", com: "tm1webCom" }, tm1webDojo: { dojo: "tm1webDojo", dijit: "tm1webDijit", dojox: "tm1webDojox", com: "tm1webCom" }, tm1webDijit: { dojo: "tm1webDojo", dijit: "tm1webDijit", dojox: "tm1webDojox", com: "tm1webCom" }, tm1webDojox: { dojo: "tm1webDojo", dijit: "tm1webDijit", dojox: "tm1webDojox", com: "tm1webCom" } } }); require([ "tm1web/api/Workbook" ], function(Workbook) { // Create and work with Workbook object });</script></head><body class="claro tm1web"></body></html>

JavaScript ライブラリーによる Web シート・オブジェクトのロードJavaScript を使用して Web シート・オブジェクトをインスタンス化します。オブジェクトがロードされたら、そのオブジェクトをドキュメントの本文の子孫として割り当てて Web ページ内に表示できます。Web シート・オブジェクトをロードするには、以下の形式を使用して、オブジェクトを定義する必須のプロパティーとオプションの関数を指定します。new Workbook({properties ..., functions ...});

properties には、ログオン資格情報と、開く Web シート・オブジェクトを示す値を指定します。functions には、オブジェクトの onLoad イベントと onTitleDimensionElementChange イベントについて通知するオプション・コードを指定できます。詳しくは、140 ページの『TM1 Web JavaScript ライブラリーの Workbook クラス』を参照してください。

例次の例は、Web シート・オブジェクトをロードする JavaScript 関数を示しています。


オブジェクトをインスタンス化するコードでは、特定の AMD (Asynchronous Module Definition) 構文とAMD require キーワードを使用する必要があります。オブジェクトが作成されると、関数はそのオブジェクトをドキュメントの本文の子として割り当てます。

// Load websheet with parameters for adminHost, tm1Server, username and passwordfunction loadWebsheet() { require([ "tm1web/api/Workbook" ], 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 body document.body.appendChild(loadedWebsheet.domNode);

loadedWebsheet.startup(); });};

次の例は、ログオンにセッション・トークンを使用して、Web シート・オブジェクトをロードします。

// Load websheet with a session tokenfunction loadWebsheet() { require([ "tm1web/api/Workbook" ], function(Workbook){ var loadedWebsheet = new Workbook({ sessionToken: "yourSessionToken", path: "Applications/Planning Sample/Management Reporting/Actual v Budget", onLoad: function() { console.debug("Workbook loaded successfully."); } }); // Add websheet to the document body document.body.appendChild(loadedWebsheet.domNode);

loadedWebsheet.startup(); });};

JavaScript ライブラリーによる CubeViewer オブジェクトのロードJavaScript を使用して CubeViewer オブジェクトをインスタンス化します。オブジェクトが作成されたら、そのオブジェクトをドキュメントの本文の子孫として割り当てて Web ページ内に表示できます。CubeViewer オブジェクトをロードするには、以下の形式を使用して、オブジェクトを定義する必須のプロパティーとオプションの関数を指定します。new CubeViewer({properties ..., functions ...});

properties には、ログオン資格情報と、開く CubeViewer オブジェクトを示す値を指定します。functions には、オブジェクトの onLoad イベントと onTitleDimensionElementChange イベントについて通知するオプション・コードを指定できます。詳しくは、149 ページの『TM1 Web JavaScript ライブラリーの CubeViewer クラス』を参照してください。

例次の例は、CubeViewer オブジェクトをロードする JavaScript 関数を示しています。


オブジェクトをインスタンス化するコードでは、特定の AMD 構文と Dojo require キーワードを使用する必要があります。オブジェクトが作成されると、関数はそのオブジェクトをドキュメントの本文の子として割り当てます。

function loadCubeview() { require([ "tm1web/api/CubeViewer", ], function(CubeViewer) { var loadedCubeview = new CubeViewer({ adminHost: "localhost", tm1Server: "Planning Sample", cube: "plan_BudgetPlan", view: "Budget Input Detailed", isPublic: true, onLoad: function() { console.debug("CubeViewer loaded successfully."); } });

// Add cubeview to the document body document.body.appendChild(loadedCubeview.domNode);

loadedCubeview.startup(); });};

次の例は、ログオンにセッション・トークンを使用して、CubeViewer オブジェクトをロードします。function loadCubeview() { require([ "tm1web/api/CubeViewer", ], function(CubeViewer) { var loadedCubeview = new CubeViewer({ sessionToken: "yourSessionToken", cube: "plan_BudgetPlan", view: "Budget Input Detailed", isPublic: true, onLoad: function() { console.debug("CubeViewer loaded successfully."); } }); // Add cubeview to the document body document.body.appendChild(loadedCubeview.domNode);


JavaScript ライブラリーのコールバック関数Web シート・オブジェクトおよび CubeViewer オブジェクトをインスタンス化するときには、コールバック関数を定義できます。コールバック関数は関連オブジェクトでタイトル・ディメンションが変更されたことをトラップするので、そのようなイベントの処理が可能になります。Web シート・オブジェクトの場合も CubeViewer オブジェクトの場合も、コールバック関数の定義には同じ形式を使用します。コールバック関数は、TM1 Web オブジェクトをインスタンス化する関数の中に直接追加します。イベントを処理するコードは、この関数の中に指定します。

形式コールバック関数は、以下の形式で定義します。onTitleDimensionElementChange: function(elementInfo) {

// Add your code here to handle the title change event}


タイトル・ディメンションに対する変更が検出されると、elementInfo オブジェクトがコールバック関数に渡されます。elementInfo の内容は、Web シート・オブジェクトと CubeViewer オブジェクトで違います。この情報から、変更されたディメンション・タイトルがわかります。Web シートの elementInfo オブジェクトは以下のとおりです。

sheetIndexタイプ: Integer変更された SUBNM セルが含まれているシートを指すゼロから始まるインデックス。

rowIndexタイプ: Integer変更された SUBNM セルが含まれている行を指すゼロから始まるインデックス。

columnIndexタイプ: Integer変更された SUBNM セルが含まれている列を指すゼロから始まるインデックス。

dimensionタイプ: Stringディメンションの名前。

elementタイプ: String要素の名前。

elementIndexタイプ: Integerディメンション要素を指す 1 から始まるインデックス。

CubeViewer の elementInfo オブジェクトは以下のとおりです。dimensionタイプ: Stringディメンションの名前。



Web シートのコールバック関数の例次の例は、Web シート・オブジェクトをロードする関数内で定義されているコールバック関数を示しています。function loadWebsheet() { require([ "tm1web/api/Workbook" ], function(Workbook){ var loadedWebsheet = new Workbook({ sessionToken: "yourSessionToken", path: "Applications/Planning Sample/Management Reporting/Actual v Budget",, onLoad: function() { console.debug("Workbook loaded successfully."); }, onTitleDimensionElementChange: function(elementInfo) { console.debug("Title dimension element changed:"); console.debug(elementInfo); } });


document.body.appendChild(loadedWebsheet.domNode);

loadedWebsheet.startup(); }); };

CubeViewer コールバック関数の例次の例は、CubeViewer オブジェクトをロードする関数の中に定義されたコールバック関数を示しています。function loadCubeview() { require([ "tm1web/api/CubeViewer" ], function(CubeViewer) { var loadedCubeview = new CubeViewer({ sessionToken: "yourSessionToken", cube: "plan_BudgetPlan", view: "Budget Input Detailed", isPublic: true, onLoad: function() { console.debug("CubeViewer loaded successfully."); }, onTitleDimensionElementChange: function(elementInfo) { console.debug("Title dimension element changed:"); console.debug(elementInfo); } }); document.body.appendChild(loadedCubeview.domNode);

loadedCubeview.startup(); }); };

JavaScript ライブラリーのプロパティーとメソッドを表すサンプル・コードTM1 Web JavaScript ライブラリーを使用して Web シート・オブジェクトおよび CubeViewer オブジェクトをロードしたら、オブジェクト指向アプローチでそれらのオブジェクトにプロパティーやメソッドを適用できます。以下のコード・サンプルは、さまざまなプロパティーとメソッドを適用する方法を示しています。Web シート・オブジェクト

• Web シートのアクティブ・フォームの再作成• Web シートの再計算

CubeViewer オブジェクト• 自動再計算モードのオン/オフ• ディメンション・タイトル・バーのオン/オフ• CubeViewer オブジェクトの元のビューへのリセット• ビューの保存• 表示モードとグラフのタイプの設定

Web シート・オブジェクトと CubeViewer オブジェクト• Web シート・オブジェクトまたは CubeViewer オブジェクトを閉じる• ログアウト

例<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."); }, function(message) { console.error(message); } ); };

// 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) { console.error(message); } ); };

// Turn on/off the dimension title bar for a CubeViewer object // ---------------------- function toggleDimensionBar(visible) { loadedCubeview.set("dimensionBarVisible", visible); };

// Reset a CubeViewer object to it's original view // ---------------------- function resetView() { loadedCubeview.reset().then( function() { console.debug("View reset completed successfully."); }, function(message) { console.error(message); } ); };

// Save a view for a CubeViewer object // ---------------------- function saveView() { loadedCubeview.save().then( function() { console.debug("Saving view completed successfully."); }, function(message) { console.error(message); } ); };

// Close a Websheet or CubeViewer object // ---------------------- function close() { loadedWebsheet.destroy(); };

// Set the display mode for a CubeViewer object // Valid values include Grid, Chart, GridAndChart // ---------------------- function setDisplayMode() {


require(["tm1web/cubeview/DisplayMode"], function(DisplayMode) { loadedCubeview.set("displayMode", DisplayMode.Grid).then( function() { console.debug("Display mode change completed successfully."); }, function(message) { console.error(message); } ); }); };

// Set the chart type for a CubeViewer object // ---------------------- function setChartType() { require(["tm1web/cubeview/ChartType"], function(ChartType) { loadedCubeview.set("chartType", ChartType.Pie).then( function() { console.debug("Chart type change completed successfully."); }, function(message) { console.error(message); } ); }); };

// 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>

TM1 Web JavaScript ライブラリーの Workbook クラスWorkbook クラスは、TM1 Web の Web シート・オブジェクトを表します。Workbook オブジェクトは Dojo ウィジェット・オブジェクト (dijit._WidgetBase) を拡張したものであり、Dojo タブ・コンテナー (dijit.layout.TabContainer) などのコンテナーの子オブジェクトとして割り当てることができます。詳しくは、Dojo Documentation (http://dojotoolkit.org/documentation/) を参照してください。Workbook オブジェクトには、Dojo ウィジェット・オブジェクトのプロパティーとメソッドに加えて、プログラムから利用できる TM1 関連のプロパティーとメソッドもあります。Workbook オブジェクトは非同期でロードされます。ロードが終わるまでコードでオブジェクトを操作することはできません。

形式Web シート・オブジェクトをロードするには、以下の形式を使用して、オブジェクトを定義する必須のプロパティーとオプションの関数を指定します。new Workbook({properties ..., functions ...});

プロパティーproperties には、Web シート・オブジェクトを定義する以下の値を指定します。• adminHost• tm1Server• username



• password• camPassport• sessionToken• objectId• path

注 : ログオン資格情報は、セッション・トークンとオブジェクト ID として指定することも、TM1 管理ホスト、TM1 サーバー、ユーザー名、パスワード、または camPassport の個々の値を含めて指定することもできます。

関数functions には以下のオプション・コードを指定できます。• onLoad 関数を使用すると、オブジェクトがロードされて操作可能になったときに通知を受け取ることができます。

• onTitleDimensionElementChange 宣言を使用すると、あるユーザーが関連するオブジェクトのディメンション・タイトルを変更するときに、そのイベントを処理することができます。

• OnActionButtonExecution 宣言を使用すると、操作ボタンが実行されたというイベントを処理することができます。

例次の例は、Web シート・オブジェクトをロードする JavaScript 関数を示しています。セッション・トークンを使用してログオン資格情報を提供できます。注 : Workbook クラスは、構成時にパラメーターとして objectId を受け入れます。TM1 Web セッションを識別するためには、objectId と sessionToken を指定する必要があります。

// Load Websheet with a session tokenfunction loadWebsheet() { require([ "tm1web/api/Workbook" ], function(Workbook){ var loadedWebsheet = new Workbook({ sessionToken: "yourSessionToken", objectId: "objectIdOfNewWorkbook" onLoad: function() { console.debug("Workbook loaded successfully."); } });

// Add websheet to the document body document.body.appendChild(loadedWebsheet.domNode);

loadedWebsheet.startup();

});};

Workbook のプロパティーこの Workbook クラスには、以下のプロパティーがあります。CubeViewer と Workbook のどちらをインスタンス化する場合も、以下のプロパティーはこの 2 つのオブジェクトの間で共通です。sessionTokenタイプ: Stringこのオブジェクトに使用する TM1 Web セッションを指定します。このプロパティーと adminHost、tm1Server、username、password、camPassport プロパティーは一緒に使用しないでください。


このプロパティーを指定せずに他の資格情報も指定しない場合は、始動時にユーザーにログオン・ダイアログが表示されます。

objectIdタイプ: Stringブックの ID。特定のブックを参照するために使用できる一意の識別子。TM1 Web セッションを識別するためには、objectId と sessionToken を指定する必要があります。以下に例を挙げます。new Workbook({ sessionToken: "previousSessionToken", objectId: "objectIdOfNewWorkbook"});

adminHostタイプ: Stringデフォルト: localhostオブジェクトのロード時に使用する管理ホスト。このプロパティーと sessionToken プロパティーは一緒に使用しないでください。

tm1Serverタイプ: Stringオブジェクトのロード時に使用する TM1 サーバー。このプロパティーと sessionToken プロパティーは一緒に使用しないでください。これを指定しない場合は sessionToken を指定しないと、始動時にユーザーにログオン・ダイアログが表示されます。

usernameタイプ: Stringオブジェクトのロード時に使用するユーザー名。このプロパティーと sessionToken およびcamPassport プロパティーは一緒に使用しないでください。これを指定しない場合はsessionToken または camPassport を指定しないと、始動時にユーザーにログオン・ダイアログが表示されます。

passwordタイプ: Stringオブジェクトのロード時に使用するパスワード。これを指定しない場合は sessionToken を指定しないと、始動時にユーザーにログオン・ダイアログが表示されます。

camPassportタイプ: Stringオブジェクトのロード時に使用する Cognos Analytics 認証パスポート (CAM パスポート)。このプロパティーと username および sessionToken は一緒に使用しないでください。

domNodeタイプ: HTMLElementウィジェットを表す基礎 HTML 要素。このプロパティーは、オブジェクトの構築中に自動的に定義されます。インスタンス化のときに指定してはいけません。詳しくは、dijit._WidgetBase に関する Dojo の資料 (https://dojotoolkit.org/reference-guide/1.10/dijit/_WidgetBase.html) を参照してください。

以下のプロパティーは、Workbook オブジェクトをインスタンス化する場合にのみ使用します。pathタイプ: Stringロードするブックを表す TM1 サーバーのアプリケーション・フォルダー・ツリー内のパス。例: "Applications/Planning Sample/Bottom Up Input/Budget Input"

replaceOnNavigateタイプ: Boolean (デフォルトは true)



true の場合、操作ボタンで新しいブックに移動するときに、このウィジェットは新しいブックに置き換えられ、既存のブックは閉じられます。false の場合、新しいブックを作成することも、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。設定するディメンション・サブセット・オブジェクトを表すオブジェクト。このオブジェクトの形式は、以下のとおりです。sheetIndexタイプ: Integerディメンション・サブセットを変更する SUBNM セルが含まれているシートを指すゼロから始まるインデックス。

rowIndexタイプ: Integer


ディメンション・サブセットを変更する SUBNM セルが含まれている行を指すゼロから始まるインデックス。

columnIndexタイプ: Integerディメンション・サブセットを変更する SUBNM セルが含まれている列を指すゼロから始まるインデックス。

dimensionタイプ: Stringディメンションの名前。sheetIndex、rowIndex、columnIndex と一緒に使用しないでください。

setExpressionタイプ: Stringサブセットを定義するために使用する MDX 式。subset と一緒に使用しないでください。つまり、setExpression かサブセット名のどちらかを入力します。

subsetタイプ: String設定するディメンション・サブセットのサブセット名。setExpression と一緒に使用しないでください。

aliasタイプ: String設定するディメンション・サブセットの別名。

elementタイプ: String要素の名前。elementIndex と一緒に使用しないでください。

elementIndexタイプ: Integer設定するディメンション要素を指す 1 から始まるインデックス。element と一緒に使用しないでください。

サブセット・オブジェクトの設定時に解決された promise として dojo.promise.Promise を返します。promise に登録されたコールバックには、このメソッドに渡したサブセットの形式と一致するオブジェクトが渡されます。サブセットが変更されなかった場合は、Null の値が渡されます。

subsets複数のサブセット・オブジェクトを設定します。パラメーター: (Object[]) subsets。設定するサブセット・オブジェクトの配列。各オブジェクトの形式は、以下のとおりです。sheetIndexタイプ: Integerディメンション・サブセットを変更する SUBNM セルが含まれているシートを指すゼロから始まるインデックス。

rowIndexタイプ: Integerディメンション・サブセットを変更する SUBNM セルが含まれている行を指すゼロから始まるインデックス。

columnIndexタイプ: Integerディメンション・サブセットを変更する SUBNM セルが含まれている列を指すゼロから始まるインデックス。

dimensionタイプ: Stringディメンションの名前。sheetIndex、rowIndex、columnIndex と一緒に使用しないでください。


setExpressionタイプ: Stringサブセットを定義するために使用する MDX 式。subset と一緒に使用しないでください。つまり、setExpression か subset のどちらかを入力します。





サブセット・オブジェクトの設定時に解決された promise として dojo.promise.Promise を返します。サブセットが正常に設定された場合、promise に登録されたコールバックには、このメソッドに渡したサブセット・オブジェクトの形式と一致するオブジェクトの配列が渡されます。

titleDimensionElementタイトル・ディメンション要素を設定します。パラメーター: (Object) element。設定するタイトル・ディメンション要素を表すオブジェクト。このオブジェクトの形式は、以下のとおりです。sheetIndexタイプ: Integerディメンション要素を変更する SUBNM セルが含まれているシートを指すゼロから始まるインデックス。

rowIndexタイプ: Integerディメンション要素を変更する SUBNM セルが含まれている行を指すゼロから始まるインデックス。

columnIndexタイプ: Integerディメンション要素を変更する SUBNM セルが含まれている列を指すゼロから始まるインデックス。



タイトル・ディメンション要素の設定時に解決された promise として dojo.promise.Promise を返します。promise に登録されたコールバックには、このメソッドに渡した要素の形式と一致するオブジェクトが渡されます。要素が変更されなかった場合は、Null の値が渡されます。

titleDimensionElements複数のタイトル・ディメンション要素を設定します。


パラメーター: (Object[]) elements。設定するタイトル・ディメンション要素の配列。各オブジェクトの形式は、以下のとおりです。sheetIndexタイプ: Integerディメンション要素を変更する SUBNM セルが含まれているシートを指すゼロから始まるインデックス。dimension を使用する場合はオプションですが、rowIndex と columnIndex の場合は必須です。

rowIndexタイプ: Integerディメンション要素を変更する SUBNM セルが含まれている行を指すゼロから始まるインデックス。このパラメーターと dimension パラメーターは一緒に使用しないでください。

columnIndexタイプ: Integerディメンション要素を変更する SUBNM セルが含まれている列を指すゼロから始まるインデックス。このパラメーターと dimension パラメーターは一緒に使用しないでください。

dimensionタイプ: Stringディメンションの名前。このパラメーターと 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 です。promise に登録されたコールバックには、サンドボックス・コミットが正常に完了した場合はブール値 true が渡され、コミットが失敗した場合はブール値 false が渡されます。



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このプロパティーは、ブックまたはシートのナビゲーションが操作ボタン実行の一部として行われた場合のみ存在します。calculationタイプ: String操作ボタン・ナビゲーションが発生した後にターゲット Workbook で行われた計算のタイプ。値は、「None」、「Recalculate」、「Rebuild」のいずれかです。

objectIdタイプ: Stringナビゲート先だったブックの objectId。同じブック内のワークシートに対して操作が行われた場合、objectId は現在のブックと同じです。

pathタイプ: Stringナビゲート先だったブックのパス。

nameタイプ: Stringターゲット・ブックの名前。

sheetIndexタイプ: Integerナビゲート先だったワークシートを指すゼロから始まるインデックス。

replaceタイプ: Boolean既存のブックを置き換えるように操作ボタンが構成されていたかどうか。

tiProcessタイプ: Objectこのプロパティーは、TI プロセスが操作ボタンの実行の一部として実行された場合のみ存在します。calculationタイプ: StringTI プロセスが実行された後に現在のブックで行われた計算のタイプ。


値は、「None」、「Recalculate」、「Rebuild」のいずれかです。nameタイプ: String実行された TI プロセスの名前。

executionSucceededタイプ: BooleanTI プロセス実行が正常に完了したかどうか。

onLoadオブジェクトのロードが終了したときに実行されます。

onTitleDimensionElementChangeタイトル・ディメンション要素が変更された場合に実行されます。オブジェクトの構成中にオーバーライドしたり、dojo/aspect モジュールを使用してアタッチしたりできます。構文: onTitleDimensionElementChange: function(elementInfo){}パラメーター: 以下の形式を使用する elementInfo オブジェクト。sheetIndexタイプ: Integer変更された SUBNM セルが含まれているシートを指すゼロから始まるインデックス。

rowIndexタイプ: Integer変更された SUBNM セルが含まれている行を指すゼロから始まるインデックス。

columnIndexタイプ: Integer変更された SUBNM セルが含まれている列を指すゼロから始まるインデックス。

dimensionタイプ: Stringディメンションの名前。



paste現在選択している領域にクリップボードの内容を貼り付けます (領域が選択されている場合)。

rebuildActiveFormsブック内のアクティブ・フォームを再作成します。アクティブ・フォームの再作成時に解決された promise として dojo.promise.Promise を返します。

redoやり直し操作を実行します。やり直し操作の完了時に解決された promise として dojo.promise.Promise を返します。

replaceobjectId を取り、既存のブックを、指定された objectId で表されるブックに置き換えます (ただし、そのブックが既存の Web シートと同じ場合は何の操作も実行されません)。置換では、既存のブックと置き換わるブックはこれまでのブックと同じ TM1 Web セッションを使用すると見なされます。

undo元に戻す操作を実行します。


元に戻す操作の完了時に解決された promise として dojo.promise.Promise を返します。

TM1 Web JavaScript ライブラリーの CubeViewer クラスCubeViewer クラスは、TM1 Web CubeViewer オブジェクトを表します。CubeViewer オブジェクトは Dojo ウィジェット・オブジェクト (dijit._WidgetBase) を拡張したものであり、Dojo タブ・コンテナー (dijit.layout.TabContainer) などのコンテナーの子オブジェクトとして割り当てることができます。詳しくは、Dojo Documentation (http://dojotoolkit.org/documentation/) を参照してください。CubeViewer オブジェクトには、Dojo ウィジェット・オブジェクトのプロパティーとメソッドに加えて、プログラムから利用できる TM1 関連のプロパティーとメソッドもあります。CubeViewer オブジェクトは非同期でロードされます。ロードが終わるまでコードでオブジェクトを操作することはできません。

形式CubeViewer オブジェクトをロードするには、以下の形式を使用して、オブジェクトを定義する必須のプロパティーとオプションの関数を指定します。new CubeViewer({properties ..., functions ...});

プロパティーproperties には、CubeViewer オブジェクトを定義する以下の値を指定します。• adminHost• tm1Server• username• password• camPassport• sessionToken• objectId• view• cube• isPublic

注 : ログオン資格情報は、セッション・トークンとオブジェクト ID として指定することも、TM1 管理ホスト、TM1 サーバー、ユーザー名、パスワード、または camPassport の個々の値を含めて指定することもできます。

関数functions には以下のオプション・コードを指定できます。• onLoad 関数を使用すると、オブジェクトがロードされて操作可能になったときに通知を受け取ることができます。

• onTitleDimensionElementChange 宣言を使用すると、関連するオブジェクトのディメンション・タイトルが変更されたというイベントを処理することができます。

例次の例は、CubeViewer オブジェクトをロードする JavaScript 関数を示しています。セッション・トークンを使用してログオン資格情報を提供します。function loadCubeview() { require([ "tm1web/api/CubeViewer"



], function(CubeViewer) { var loadedCubeview = new CubeViewer({ sessionToken: "yourSessionToken", cube: "plan_BudgetPlan", view: "Budget Input Detailed", isPublic: true, onLoad: function() { console.debug("CubeViewer loaded successfully."); }, }); // Add cubeview to the document body document.body.appendChild(loadedCubeview.domNode);


CubeViewer のプロパティーCubeViewer クラスには、以下のプロパティーがあります。CubeViewer オブジェクトと Workbook オブジェクトのどちらをインスタンス化する場合も、以下のプロパティーはこの 2 種類のオブジェクトの間で共通です。sessionTokenタイプ: Stringこのオブジェクトに使用する TM1 Web セッションを指定します。このプロパティーと adminHost、tm1Server、username、password、camPassport プロパティーは一緒に使用しないでください。このプロパティーを指定せずに他の資格情報も指定しない場合は、始動時にユーザーにログオン・ダイアログが表示されます。

objectIdタイプ: StringCubeViewer の ID。特定の CubeViewer を参照するために使用できる一意の番号。

adminHostタイプ: Stringデフォルト: localhostオブジェクトのロード時に使用する管理ホスト。このプロパティーと sessionToken プロパティーは一緒に使用しないでください。

tm1Serverタイプ: Stringオブジェクトのロード時に使用する TM1 サーバー。このプロパティーと sessionToken プロパティーは一緒に使用しないでください。これを指定しない場合は sessionToken を指定しないと、始動時にユーザーにログオン・ダイアログが表示されます。

usernameタイプ: Stringオブジェクトのロード時に使用するユーザー名。このプロパティーと sessionToken およびcamPassport プロパティーは一緒に使用しないでください。これを指定しない場合はsessionToken または camPassport を指定しないと、始動時にユーザーにログオン・ダイアログが表示されます。

passwordタイプ: Stringオブジェクトのロード時に使用するパスワード。これを指定しない場合は sessionToken を指定しないと、始動時にユーザーにログオン・ダイアログが表示されます。

camPassportタイプ: String


オブジェクトのロード時に使用する Cognos Analytics 認証パスポート (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 に登録されたコールバックに渡されます。各オブジェクトの形式は、次のとおりです。• 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 を返します。

automaticRecalculation自動再計算をオンまたはオフに設定します。パラメーター: Boolean。• True は、自動再計算をオンにします。• False は、自動再計算をオフにします。dojo.promise.Promise を返します。これは、自動再計算を有効/無効にしたときに解決されたpromise です。

chartTypeCubeViewer オブジェクトのグラフのタイプを設定します。パラメーター: tm1web.cubeview.ChartType。設定するグラフのタイプ。dojo.promise.Promise を返します。これは、グラフのタイプの設定時に解決された promise です。

dimensionBarVisibleディメンション・バーの可視性を設定します。パラメーター: Boolean。• True は、ディメンション・バーの表示をオンにします。• False は、ディメンション・バーの表示をオフにします。

displayModeCubeViewer オブジェクトの表示モードを設定します。パラメーター: tm1web.cubeview.DisplayMode。設定する表示モード。dojo.promise.Promise を返します。これは、表示モードの設定時に解決された promise です。

subsetサブセット・オブジェクトを設定します。パラメーター: (Object) subset。設定するディメンション・サブセット・オブジェクトを表すオブジェクト。このオブジェクトの形式は、以下のとおりです。dimensionタイプ: Stringディメンションの名前。

setExpressionタイプ: Stringサブセットを定義するために使用する MDX 式。subset と一緒に使用しないでください。つまり、setExpression かサブセット名のどちらかを入力します。






サブセット・オブジェクトの設定時に解決された promise として dojo.promise.Promise を返します。promise に登録されたコールバックには、このメソッドに渡したサブセットの形式と一致するオブジェクトが渡されます。サブセットが変更されなかった場合は、Null の値が渡されます。

subsets複数のサブセット・オブジェクトを設定します。パラメーター: (Object[]) subsets。設定するサブセット・オブジェクトの配列。各オブジェクトの形式は、以下のとおりです。dimensionタイプ: Stringディメンションの名前。

setExpressionタイプ: Stringサブセットを定義するために使用する MDX 式。subset と一緒に使用しないでください。つまり、setExpression か subset のどちらかを入力します。





サブセット・オブジェクトの設定時に解決された promise として dojo.promise.Promise を返します。サブセットが正常に設定された場合、promise に登録されたコールバックには、このメソッドに渡したサブセット・オブジェクトの形式と一致するオブジェクトの配列が渡されます。

titleDimensionElementタイトル・ディメンション要素を設定します。パラメーター: 要素オブジェクト。設定するタイトル・ディメンション要素。このオブジェクトの形式は、次のとおりです。dimension文字列ディメンションの名前。

element文字列要素の名前。このパラメーターと elementIndex は一緒に使用しないでください。

elementIndex整数


設定するディメンション要素を指す 1 から始まるインデックス。このパラメーターと element パラメーターは一緒に使用しないでください。

dojo.promise.Promise を返します。これは、タイトル・ディメンション要素の設定時に解決された promise です。promise に登録されたコールバックには、このメソッドに渡した要素の形式と一致するオブジェクトが渡されます。要素が変更されなかった場合は、Null の値が渡されます。

titleDimensionElements複数のタイトル・ディメンション要素を設定します。パラメーター: object[] 要素。設定するタイトル・ディメンション要素の配列。各オブジェクトの形式は、次のとおりです。dimension文字列ディメンションの名前。

element文字列要素の名前。このパラメーターと elementIndex は一緒に使用しないでください。

elementIndex整数設定するディメンション要素を指す 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 です。サンドボックス・コミットが正常に完了した場合は、promise に登録されたコールバックにブール値 true が渡されます。コミットが失敗した場合は、false の値が渡されます。

copy選択したセルをクリップボードにコピーします (セルが選択されている場合)。

destroyこのオブジェクトを破棄し、ガーベッジ・コレクションのために準備をします。dijit._WidgetBase#destroy については、Dojo の資料を参照してください。



logoutこのオブジェクトの sessionToken に関連付けられている TM1 Web セッションを破棄します。ログアウトの完了時に解決された promise として dojo.promise.Promise を返します。

onLoadオブジェクトのロードが終了したときに実行されます。

onTitleDimensionElementChangeタイトル・ディメンション要素が変更された場合に実行されます。オブジェクトの構成中にオーバーライドしたり、dojo/aspect モジュールを使用してアタッチしたりできます。構文: onTitleDimensionElementChange: function(elementInfo){}パラメーター: elementInfo オブジェクト。このオブジェクトの形式は、次のとおりです。dimension文字列変更されたディメンションの名前。

element文字列変更された要素の名前。

elementIndex整数変更されたディメンション要素を指す 1 から始まるインデックス。

paste現在選択している領域にクリップボードの内容を貼り付けます (領域が選択されている場合)。

redoやり直し操作を実行します。やり直し操作の完了時に解決された promise として dojo.promise.Promise を返します。

reset

キューブ・ビューをその元の保存状態にリセットします。dojo.promise.Promise を返します。これは、キューブ・ビューのリセット時に解決された promiseです。

save

キューブ・ビューのレイアウトを保存し、既存のレイアウトに上書きします。dojo.promise.Promise を返します。これは、キューブ・ビューの保存時に解決された promise です。

undo元に戻す操作を実行します。元に戻す操作の完了時に解決された promise として dojo.promise.Promise を返します。



付録 B サポートされている Microsoft Excel 関数 - TM1Web

IBM 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 関数のサポートは、info_types が address、col、row、protect、contents、type である場合に限定されています。

IFERROR 式の評価がエラーである場合に、指定された値を返します。IBM Planning Analytics バージョン 2.0.7 以降でサポートされています。

ISERR セルの内容が #N/A 以外のエラー値の場合に“TRUE”を返します。ISERROR セルの内容がエラー値の場合に“TRUE”を返します。ISNA セルの内容がエラー値 #N/A の場合に“TRUE”を返します。NA エラー値“#N/A”を返します。


論理関数次の表に、論理関数を示します。関数説明AND すべての引数が TRUE のとき、“TRUE”を返します。FALSE 論理値“FALSE”を返します。IF 実行する論理テストを指定します。NOT 引数の論理値を反転します。OR いずれかの引数が TRUE であれば、“TRUE”を返します。TRUE 論理値“TRUE”を返します。

検索/行列関数次の表に、検索/行列関数を示します。注 : LOOKUP や ROWS などのいくつかの関数は、引数に 2 次元配列を指定できます。 TM1 Web は 2 次元配列をサポートしていません。データの編成や要件によっては、これらの関数で正しい値を取得できる場合があります。例えば、取り出すデータが配列の最初の部分にあたる場合です。 TM1 Web でこれらの関数を処理して正しい値を取得するには、場合によっては、1 次元配列を引数とする関数を反復して使用するように、入力データを再編成する必要があります。または、直接セル参照を使用する必要があります。関数説明ADDRESS ワークシートの 1 つのセルの参照を文字列で返します。CHOOSE 値のリストから値を選択します。COLUMN 参照の列番号を返します。COLUMNS 参照に含まれる列の数を返します。HLOOKUP 配列の先頭行を検索し、指定したセルの値を返します。HYPERLINK ネットワーク・サーバー、イントラネット、またはインターネットに保存さ

れているドキュメントを開くショートカットまたはジャンプを作成します。INDEX インデックスを使用して、参照または配列から抽出した値を選択します。LOOKUP ベクトルまたは配列から値を検索します。MATCH 参照または配列から値を検索します。OFFSET 任意の参照から参照オフセットを返します。ROW 参照の行番号を返します。ROWS 参照に含まれる行の数を返します。

付録 B サポートされている Microsoft Excel 関数 - TM1 Web 159

関数説明VLOOKUP 配列の左端の列を検索し、その行内の対応するセルの値を返します。

数学/三角関数次の表に、数学/三角関数を示します。関数説明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 数値の双曲線正接を返します。注 : 合計する条件には固定サイズ範囲を使用する必要があります。全列参照の使用はサポートされていません。オプションのパラメーターとして sum_range を指定する場合は、range パラメーターと同じサイズにする必要があります。例えば、SUMIF を使用する以下の式を表すとします。=SUMIF(Calculation!$B:$B,$B21,Calculation!$M:$M)

次の式を使用する必要があります。=SUMIF(Calculation!$B$1:$B$500,$B21,Calculation!$M$1:$M$500)

例えば、SUM を使用する以下の式を表すとします。


=SUM('EIS vs EISNA'!G:G)

次の式を使用する必要があります。=SUM('EIS vs EISNA'!G1:G1000)

文字列操作関数次の表に、文字列操作関数を示します。関数説明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 負の 2 項分布 (成功率 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 ワイブル分布を返します。



付録 C サポートされていない Microsoft Excel 関数 -TM1 Web

IBM 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 整数部と分子で表されたドル価格を 10 進数表示に変換します。DOLLARFR 10 進数で表されたドル価格を整数部と分子の表記に変換します。DURATION 定期的に利子が支払われる証券の年間のデュレーションを返します。


関数説明EFFECT 実効年利率を返します。FVSCHEDULE 投資期間内の一連の金利を複利計算することにより、初期投資の元金の将来

価値を返します。INTRATE 全額投資された証券の利率を返します。IRR 一連のキャッシュ・フローに対する内部収益率を返します。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 満期日に利息が支払われる証券の年利回りを返します。

付録 C サポートされていない Microsoft Excel 関数 - TM1 Web 169

情報関数この表には、TM1 Web でサポートされない情報関数を示します。関数説明ERROR.TYPE エラー・タイプに対応する数値を返します。IFERROR 式の評価がエラーである場合に、指定された値を返します。

IBM Planning Analytics バージョン 2.0.6 以前ではサポートされていません。INFO 現在の操作環境に関する情報を返します。ISBLANK セルの内容が空白の場合に“TRUE”を返します。ISEVEN 数値が偶数の場合に“TRUE”を返します。ISLOGICAL セルの内容が論理値の場合に“TRUE”を返します。ISNONTEXT セルの内容が文字列以外の値である場合に“TRUE”を返します。ISNUMBER セルの内容が数値の場合に“TRUE”を返します。ISODD 数値が奇数の場合に“TRUE”を返します。ISREF セルの内容が参照である場合に“TRUE”を返します。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 リストまたはデータベースの集計値を返します。SUMIFS 複数の条件を満たすすべての引数を加算します。SUMPRODUCT 指定された配列の対応する要素の積の合計を返します。SUMSQ 引数の平方の合計を返します。SUMX2MY2 2 つの配列で対応する要素の平方差の合計を返します。SUMX2PY2 2 つの配列で対応する要素の平方和の合計を返します。SUMXMY2 2 つの配列で対応する要素の差を 2 乗し、その合計を返します。TRUNC 数値の整数部を返します。

統計関数この表には、TM1 Web でサポートされない統計関数を示します。関数説明BETADIST 累積 β確率密度関数を返します。BETAINV 累積 β確率密度関数の逆関数を返します。CHIDIST カイ 2 乗分布の片側確率を返します。


関数説明CHIINV カイ 2 乗分布の片側確率の逆関数を返します。CHITEST カイ 2 乗検定による独立性のテストを返します。COUNTBLANK 範囲に含まれる空白セルの個数を返します。COUNTIFS 指定した複数の範囲に含まれる空白以外のセルのうち、検索条件に一致する

セルの個数を返します。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-検定の片側確率の値を返します。

文字列操作関数この表には、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 の将来の方向または意向に関する記述については、予告なしに変更または撤回される場合があり、単に目標を示しているものです。本書はプランニング目的としてのみ記述されています。記述内容は製品が使用可能になる前に変更になる場合があります。本書には、日常の業務処理で用いられるデータや報告書の例が含まれています。より具体性を与えるために、それらの例には、個人、企業、ブランド、あるいは製品などの名前が含まれている場合があります。これらの名称はすべて架空のものであり、名称や住所が類似する企業が実在しているとしても、それは偶然にすぎません。著作権使用許諾:

本書には、様々なオペレーティング・プラットフォームでのプログラミング手法を例示するサンプル・アプリケーション・プログラムがソース言語で掲載されています。お客様は、サンプル・プログラムが書かれているオペレーティング・プラットフォームのアプリケーション・プログラミング・インターフェースに準拠したアプリケーション・プログラムの開発、使用、販売、配布を目的として、いかなる形式においても、IBM に対価を支払うことなくこれを複製し、改変し、配布することができます。このサンプル・プログラムは、あらゆる条件下における完全なテストを経ていません。従って IBM は、これらのサンプル・プログラムについて信頼性、利便性もしくは機能性があることをほのめかしたり、保証することはできません。これらのサンプル・プログラムは特定物として現存するままの状態で提供されるものであり、いかなる保証も提供されません。 IBM は、お客様の当該サンプル・プログラムの使用から生ずるいかなる損害に対しても一切の責任を負いません。それぞれの複製物、サンプル・プログラムのいかなる部分、またはすべての派生的創作物にも、次のように、著作権表示を入れていただく必要があります。© (お客様の会社名) (西暦年). このコードの一部は、IBM Corp. のサンプル・プログラムから取られています。 © Copyright IBM Corp. _年を入れる_.

この情報をソフトコピーでご覧になっている場合は、写真やカラーの図表は表示されない場合があります。この「ソフトウェア・オファリング」は、Cookie もしくはその他のテクノロジーを使用して個人情報を収集することはありません。

©

本書は IBM Planning Analytics バージョン 2.0.0 に適用されます。また、それ以降のリリースにも適用される場合があります。

著作権Licensed Materials - Property of IBM© Copyright IBM Corp. 2007, 2020.

US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP ScheduleContract with IBM Corp.

IBM、IBM ロゴ、および ibm.com は、世界の多くの国で登録された International Business MachinesCorporation の商標です。他の製品名およびサービス名等は、それぞれ IBM または各社の商標である場合

176 特記事項

があります。現時点での IBM の商標リストについては、著作権および商標情報の Web サイト(www.ibm.com/legal/copytrade.shtml) をご覧ください。以下の会社名、製品名およびサービス名等は、それぞれ各社の商標または登録商標です。• Microsoft、Windows、Windows NT および Windows ロゴは、Microsoft Corporation の米国およびその他の国における商標です。

• Adobe、Adobe ロゴ、PostScript、PostScript ロゴは、Adobe Systems Incorporated の米国およびその他の国における登録商標または商標です。

• Linux® は、Linus Torvalds の米国およびその他の国における登録商標です。• UNIX は The Open Group の米国およびその他の国における登録商標です。• Java およびすべての Java 関連の商標およびロゴは Oracle やその関連会社の米国およびその他の国における商標または登録商標です。

Microsoft 製品のスクリーン・ショットは Microsoft の許可を得て使用しています。

特記事項 177

http://www.ibm.com/legal/copytrade.shtml


索引日本語, 数字, 英字, 特殊文字の順に配列されています。なお, 濁音と半濁音は清音と同等に扱われています。［ア行］印刷プロパティー 31影響図

概要 71表示 75

エクスポートシートの最大数 94レポート 47

［カ行］書き戻し 31, 41カスタム集約既存のサブセットからの 60選択した要素から 60

関数検索および参照 159財務 157サポートされていない 167, 168, 170, 171, 173サポートされている Excel ワークシート 157情報 158数学/三角 160テキストおよびデータ 162統計 163日付と時刻 157論理 159

管理tm1web_config.xml 78

管理ホスト 31クイック・コマンド

データ入力コマンド 42, 43グラフドリルスルー 49

構成パラメーターTM1 Web 79

固定ウィンドウ枠 21

［サ行］削除要素 55

サブセット親の挿入 59サブセットの削除 55集約の移動 54集約の折りたたみ 59集約の展開 58動的 51編集 51要素の維持 54要素の移動 53要素の選択 40

サブセット (続き)要素のソート 57要素のフィルター 55

サブセット・エディターアクセス 51集約の折りたたみ 59集約の展開 58集約のドリルダウン 58ツールバー 52ツリーを完全に省略 59ツリーを完全に展開 58表示 51

サポートされていない Excel 関数ACCRINT 168ACCRINTM 168AMORDEGRC 168AMORLINC 168AREAS 170ASC 173BAHTTEXT 173BETADIST 171BETAINV 171CHIDIST 171CHIINV 172CHITEST 172COUNTBLANK 172COUNTIFS 172COUPDAYBS 168COUPDAYS 168COUPDAYSNC 168COUPNCD 168COUPNUM 168COUPPCD 168CRITBINOM 172CUMIPMT 168CUMPRINC 168DAVERAGE 167DCOUNT 167DCOUNTA 167DGET 167DISC 168DMAX 167DMIN 167DOLLARDE 168DOLLARFR 168DPRODUCT 167DSTDEV 167DSTDEVP 167DSUM 167DURATION 168DVAR 167DVARP 167EDATE 167EFFECT 169EOMONTH 167ERROR.TYPE 170FACTDOUBLE 171

索引 179

サポートされていない Excel 関数 (続き)FDIST 172FINV 172FRENQUENCY 172FTEST 172FVSCHEDULE 169GAMMADIST 172GAMMAINV 172GAMMALN 172GCD 171HYPGEOMDIST 172IFERROR 170INDIRECT 170INFO 170INTRATE 169IRR 169ISBLANK 170ISEVEN 170ISLOGICAL 170ISNONTEXT 170ISNUMBER 170ISODD 170ISREF 170ISTEXT 170JIS 173LCM 171LOGINV 172LOGNORMDIST 172MDETERM 171MDURATION 169MINVERSE 171MMULT 171MROUND 171MULTINOMIAL 171N 170NEGBINOMDIST 172NETWORKDAYS 167NOMINAL 169ODDFPRICE 169ODDFYIELD 169ODDLPRICE 169ODDLYIELD 169PERCENTILE 172PERCENTRANK 172PHONETIC 173POISSON 172PRICE 169PRICEDISC 169PRICEMAT 169PROB 172QUARTILE 172QUOTIENT 171RANDBETWEEN 171RANK 172RECEIVED 169RTD 170SERIESSUM 171SQRTPI 171SUBTOTAL 171SUMISF 171SUMPRODUCT 171SUMSQ 171SUMX2MY2 171SUMX2PY2 171

サポートされていない Excel 関数 (続き)SUMXMY2 171TBILLEQ 169TBILLPRICE 169TBILLYIELD 169TDIST 172TINV 172TRANSPOSE 170TRIMMEAN 172TRUNC 171TTEST 172TYPE 170VDB 169WEEKNUM 167WORKDAY 167XIRR 169XNPV 169YEARFRAC 167YIELD 169YIELDDISC 169YIELDMAT 169ZTEST 173

サポートされている Excel 関数行 159列 159ABS 160ACOS 160ACOSH 160ADDRESS 159AND 159ASIN 160ASINH 160ATAN 160ATAN2 160ATANH 160AVEDEV 163AVERAGE 163AVERAGEA 163BINOMDIST 163CEILING 160CELL 158CHAR 162CHOOSE 159CLEAN 162CODE 162COLUMN 159COMBIN 160CONCATENATE 162CONFIDENCE 163CORREL 163COS 160COSH 160COUNT 163COUNTA 163COUNTIF 163COVAR 163DATE 157DATEVALUE 157DAY 157DAYS360 157DB 157DDB 157DEGREE 160DEVSQ 163


サポートされている Excel 関数 (続き)DOLLAR 162EVEN 160EXACT 162EXP 160EXPONDIST 163FACT 160FALSE 159FIND 162FISHER 163FISHERINV 163FIXED 162FLOOR 160FORECAST 163FV 158GEOMEAN 163GROWTH 163HARMEAN 163HLOOKUP 159HOUR 157HYPERLINK 159IF 159IFERROR 158INDEX 159INT 160INTERCEPT 163IPMT 158IRR 158ISERR 158ISERROR 158ISNA 158ISPMT 158KURT 163LARGE 163LEFT 162LEN 162LINEST 164LN 160LOG 160LOG10 160LOGEST 164LOOKUP 159LOWER 162MATCH 159, 164MAX 164MAXA 164MEDIAN 164MID 162MIN 164MINA 164MINUTE 157MIRR 158MOD 161MODE 164MONTH 157MORMINV 164NA 158NEGBINOMDIST 164NORMDIST 164NORMSDIST 164NORMSINV 164NOT 159NOW 157NPER 158

サポートされている Excel 関数 (続き)NPV 158ODD 161OFFSET 159OR 159PEARSON 164PERMUT 164PI 161PMT 158POWER 161PPMT 158PRODUCT 161PROPER 162PV 158RADIAN 161RAND 161RATE 158REPLACE 162REPT 162RIGHT 162ROMAN 161ROUND 161ROUNDDOWN 161ROUNDUP 161ROW 159RSQ 164SEARCH 162SECOND 157SIGN 161SIN 161SINH 161SKEW 164SLN 158SLOPE 164SMALL 164SQRT 161STANDARDIZE 164STDEV 164STDEVA 164STDEVP 164STDEVPA 165STEYX 165SUBSTITUTE 162SUM 161SUMIF 161SYD 158T 162TAN 161TANH 161TEXT 162TIME 157TIMEVALUE 157TODAY 157TREND 165TRIM 162TRUE 159UPPER 163VALUE 163VAR 165VARA 165VARP 165VARPA 165VLOOKUP 160WEEKDAY 157

索引 181

サポートされている Excel 関数 (続き)WEIBULL 165YEAR 157

サンドボックス概要 61コミット 66削除 61セルの色分け 66データ値のリセット 65

集計 39集約サブセット内での折りたたみ 59サブセット内の移動 54展開 58

集約の折りたたみ 39, 59条件付き書式 20ショートカット 43スコアカード影響図 71, 75概要 69戦略マップ 75評価指標キューブ 74ユーザー指定の図 76

スナップショットレポート 47

スプレッドデータ 42

スプレッド・データキューブ・ビューでの集約の除外 46キューブ・ビューでのセルの除外 45Cube View での 42Web シートでの 26Web シートでの集約の除外 26Web シートのセルを除外する 26

スライスレポート 47レポートのエクスポート 32

静的サブセット 51

セッション・トークン・ログオン 101セルの折り返し 94戦略マップ概要 72表示 75

挿入親 59

［タ行］ツールバーサブセット・エディター 52ページング 37Cube Viewer 36Web シート 23

ディメンション積み上げ 39ピボット 39リスト 31

ディメンションの移動 39ディメンションの積み上げ 39ディメンションのピボット 39データスプレッド 42

データ・スプレッド

データ・スプレッド (続き)除外 26, 45, 46Cube View での 42Web シートでの 26

データ入力コマンド 42, 43データの入力データ入力コマンド 42, 43

展開集約 39, 58

動的サブセット 51ドリルプロセス 41割り当て 41

［ナ行］ナビゲーション

Cube Viewer 37ナビゲーション・ツリービュー・ノード 93

［ハ行］ハイパーリンク 21パスワード変更 77

パスワードの変更 77パラメーター、tm1web_config.xml 78ビュー

作成 47ビューの作成 47評価指標キューブ概要 70表示 74

フィルター式による 56属性による 55タイプ 40要素 55レベルによる 55Cube Viewer でのデータ 40

フォントMicrosoft Excel のデフォルト 100

ページ編集 37ページング・ツールバー 37編集サブセット 51Web シートのデータ 24Web シートのデータの有効化/無効化 31

［マ行］文字列測定 21

［ヤ行］ユーザー指定のスコアカードの図概要 73表示 76

ユーザー定義集約「カスタム集約」を参照 60

要素維持 54


要素 (続き)親の挿入 59削除 55サブセット内での削減 54ソート 57フィルター 55

要素の維持 54要素の選択 40要素のソート 57

［ラ行］列非表示 20

列の非表示 20レポートエクスポート 47概要 32, 47スナップショット 32, 47スライス 32, 47Cube Viewer 32, 47PDF 32, 47Web シート 32, 47

レポート生成 32, 47ログオン・ページの設定 86ログオン・ページを設定する 86

［ワ行］ワークシートの発行定義されている 19

ワークシートの変換 99

AAdd コマンド 42AIX 100APIセッション・トークン・ログオン 101JavaScript ライブラリー 130URL API 108

CClearType Tuner ユーティリティーエンド・ユーザー・コンピューター上の 21

Cube Viewer書き戻し 41グラフのドリルスルー 49サブセット・エディター 40集計 39集約の折りたたみ 39集約の展開 39スプレッド・データ 42セルのデータの編集 41ツールバー 36ディメンションの移動 39ディメンションの積み上げ 39ディメンションのピボット 39データの再計算 38データの保存 38ドリル 39ドリル・プロセス 41

Cube Viewer (続き)ドリル割り当て 41ナビゲーション 37開く 35フィルター 40ページ・サイズ 93ページング・ツールバー 37レポート生成 32, 47

Cube Viewer でのデータの再計算 38Cube Viewer でのデータの保存 38Cube Viewer の集約セル 45CubeViewer オブジェクト

JavaScript ライブラリーの使用 135URL API の使用 117

CubeViewer クラスプロパティー 150メソッド 154

CubeviewerStringWrap 94

DDEBUG

TM1 Web メッセージの重要度 96Decrease コマンド 42Divide コマンド 42

EERROR

TM1 Web メッセージの重要度 96Excelサポートされていないワークシート関数 167ワークシート関数 157

GGrow コマンド 42

HHold コマンド 42

IIncrease コマンド 42INFO

TM1 Web メッセージの重要度 96

JJavaScript ライブラリー概要 130コールバック関数 136セッション・トークン・ログオン 101プロパティーとメソッドのサンプル 138CubeViewer オブジェクトのロード 135CubeViewer クラス 149CubeViewer のプロパティー 150CubeViewer のメソッド 154HTML head タグ 131Web シート・オブジェクトのロード 134Workbook クラス 140

索引 183

JavaScript ライブラリー (続き)Workbook のプロパティー 141Workbook のメソッド 146

KK コマンド 42

LLegacyUrlApiSessionDiscoveryEnabled パラメーター 103

MM コマンド 42Microsoft Excelデフォルト・フォント 100

Multiply コマンド 42

PPDFレポート 47

Percent コマンド 42Power コマンド 42

SSubtract コマンド 42

TTM1 Web概要 15管理 77管理者タスク 16起動 15構成パラメーター 79使用 16スコアカード 69スタートアップ・パラメーター 91データの参照と分析 16ホームページ 87ログオン 15ログ記録 96, 97tm1web.log ファイル 96

TM1 Web API 101TM1 Web JavaScript ライブラリー、参照 : JavaScript ライブラリーTM1 Web の URL API、参照 : URL APItm1web_config.xmlスタートアップ・パラメーター 91定義されている 78編集 85

tm1web_config.xml の編集 78

UURL API以前の URL API プロジェクトのアップグレード 121概要 108基本 URL 109

URL API (続き)基本概念 110構文 108セッション・トークン・ログオン 101操作をオブジェクトに適用する 115導入 108パラメーター 109パラメーター・リファレンス 122フォーム・ベースのログオン 113ユーザーのログオンとログアウト 112ログアウト 113Action パラメーター 114AdminHost パラメーター 111CubeViewer オブジェクトの表示 117CubeViewer オブジェクトを開く 118CubeViewer グラフ 120CubeViewer グラフ・タイプ 120Cubeviewer タイトル要素 119CubeViewer の表示プロパティー 118CubeViewer の表示モード 120HTML iframe 110LegacyUrlApiSessionDiscoveryEnabled パラメーター103Open パラメーター 114TM1Server パラメーター 111URL エスケープ文字 110Web シート・オブジェクトの表示 115Web シート・オブジェクトを開く 115Web シート・タイトル要素 116Web シートの表示プロパティー 116

URL API のパラメーター操作 123タイプ 129AccessType 123, 127AdminHost 125AutoRecalc 125ChartType 125Cube 126HideDimensionBar 127HideToolbar 128TM1Server 128TM1SessionId 128View 129Workbook 129

WWeb グラフグラフのタイプ 49ドリルスルー 49

Web シートウィンドウ枠の固定 21関連のドリル 19グリッドラインの表示 19条件付き書式 20スプレッド・データ 26セルのデータの編集 25セル保護 22ツールバー 23定義されている 19データ編集の概要 24斜め罫線 19ハイパーリンク 21読み取り専用化 31


Web シート (続き)列の非表示 20Excel ワークシートとの外観の違い 19

Web シート、シートのエクスポート 94Web シート・オブジェクト

JavaScript ライブラリーの使用 134URL API の使用 115

Web シート内の列の幅 21Web シートのオブジェクトの翻訳 23Web シートのプロパティー印刷 31書き戻し 31管理ホスト 31全般 31ディメンションのリスト 31変更 31

web.config 85Workbook クラスプロパティー 141メソッド 146

［特殊文字］.xls の変換 99.xlsx ワークシート 99

索引 185


IBM®

Date post:	08-Nov-2021
Category:	Documents
Upload:	others
View:	3 times
Download:	0 times

TM1 Web ユーザー・ガイド - IBM

Documents