TM1 Turbo Integrator ガイド - IBMpublic.dhe.ibm.com/.../docs/ja/9.5.1/tm1_turb.pdfTM1...

IBM Cognos TM1

バージョン 9.5.1

TurboIntegrator ガイド

製品情報この文書は、IBM Cognos TM1 バージョン 9.5.1 に適用されます。また、以降のリリースにも適用される場合があります。この文書の最新版を確認するには、IBM Cognos Information Centers (http://publib.boulder.ibm.com/infocenter/cogic/v1r0m0/index.jsp) を参照してください。

CopyrightLicensed Materials - Property of IBM

© Copyright IBM Corp. 2007, 2010.

IBM、IBM ロゴ、ibm.com、TM1, 、および Cognos は、世界の多くの国で登録された International Business Machines Corp. の商標です。他の製品名およびサービス名等は、それぞれIBMまたは各社の商標である場合があります。現時点でのIBMの商標リストについては、www.ibm.com/legal/copytrade.shtmlをご覧ください。

Microsoft、Windows、Windows NT および Windows ロゴは、Microsoft Corporation の米国およびその他の国における商標です。

UNIX は The Open Group の米国およびその他の国における登録商標です。

http://publib.boulder.ibm.com/infocenter/cogic/v1r0m0/index.jsp

目次

はじめに 7

第 1 章：TurboIntegrator の基礎 9TurboIntegrator で使用可能なデータソース 9TurboIntegrator での文字列長の制限 9インポート処理のオプション 10TurboIntegrator 関数 10プロセスと日課 10TurboIntegrator プロセス内での操作の順序 11TurboIntegrator プロセスに関するの注意事項 11同じ TM1 サーバーに同時接続。 12TurboIntegrator 関数での別名 12個人用作業領域とサンドボックスを TurboIntegrator プロセスで使用する 12

TurboIntegrator プロセスを個人用領域かサンドボックスで手動で実行する 12TurboIntegrator 関数をサンドボックスで使用する 13

第 2 章：テキストファイルのインポート 15テキストファイルからのディメンションの作成 15

データソースの定義 15データソースの変数の識別 17変数のマッピング 20TurboIntegrator プロセスの保存と実行 21

テキストファイルからのキューブの作成 22キューブのデータソースの定義 22キューブ変数の定義 23キューブ変数のマッピング 23ディメンションへのキューブ要素変数のマッピング 24キューブのデータ変数のマッピング 24集約変数のマッピング 24キューブプロセスの保存と実行 24

第 3 章：ODBC ソースからのインポート 27Unicode と DNS 27ODBC データソースの定義 27MDX 文からの TurboIntegrator プロセスの生成 28

MDX TurboIntegrator プロセスの構築 28

第 4 章：TM1 のビューまたはサブセットからのインポート 31データソースとして TM1 キューブビューを使用 31

キューブプロセスの作成 31データソースとして TM1 サブセットを使用 31

データソースとしてディメンションサブセットを定義 32ディメンション変数の定義 32ディメンション変数のマッピング 33ディメンションの保存と実行 33

第 5 章：MSAS からのインポート 35OLE DB for OLAP データソース 35

ODBO プロバイダ名 35ODBO の場所 35ODBO データソース 35ODBC カタログ 35接続文字列：MSAS と TM1 35OLE DB for OLAP データソースへの接続（CAM 認証を使用する場合） 36

Licensed Materials – Property of IBM

3© Copyright IBM Corp. 2007, 2010.

MAS キューブのインポート 37TurboIntegrator による Analysis Services への接続 37［ODBC キューブのロード］タブによるキューブの指定 38［キューブディメンション］タブの使用 39MAS プロセスの保存と実行 40

MAS ディメンションのインポート 40MAS 接続パラメータの定義 41［ODBO ディメンションのロード］タブの使用 42ディメンション MAS プロセスの保存と実行 43TM1 メッセージログ 43

第 6 章：SAP BUsiness Warehouse 用 TM1 Connector を使用してデータをインポートする 45SAP オブジェクトと用語 45

SAP と TM1 の類似オブジェクト 45SAP のオブジェクト階層 45

SAP BW ソフトウェア用 TM1 Connector の必要条件 46Saprfc.ini ファイルと RFC ライブラリ 46

Microsoft Windows（x86） 46Microsoft Windows（x86、x64） 47UNIX（Sun Solaris、IBM AIX） 47

SAP BW への TM1 インターフェイスのインストール 48SAP の InfoCube のインポート 48

SAP BW への接続の確立 49TM1 キューブへの SAP InfoCube のマッピング 50TM1 ディメンションへの SAP 特性のマッピング 51特性の制限の設定 53特性設定の選択 55SAP TurboIntegrator プロセスの保存と実行 56結果の確認 57

SAP の特性のインポート 57TM1 ディメンションへの SAP 特性のマッピング 58

SAP のセキュリティのインポート 60インポートする SAP セキュリティ定義の選択 60

SAP の通貨データのインポートと換算 61TM1 のキューブおよびディメンションへの SAP 通貨のマッピング 61

SAP テーブルのインポート 64SAP テーブルクエリーの作成 64変数の識別とマッピング 64

SAP への TM1 データの書き込み 64TM1 ビューから ODS 表へのディメンションと値のマッピング 65

第 7 章：IBM Cognos TM1 Package Connector を使用してデータをインポートする 69Cognos BI サーバーへの接続を確立する 69

発行されたパッケージに接続する 701 つのディメンションのインポート 75

TurboIntegrator プロセスの保存と実行 75結果の確認 76SAP BW データを使用する際のガイドライン 76

Framework Manager でパッケージを使用して SAP BW データを使用する 76SAP BW クエリーに分割プロンプトを指定する 82

分割プロンプトを使用して並行クエリーを実行する 83

第 8 章：詳細プロシージャと日課の編集 85一括読み込みモードの使用 85

一括読み込みモード使用時の注意 85一括読み込みモードの TurboIntegrator プロセスコマンド 86一括読み込みモードの TM1 C API 関数 86

プロシージャの編集 86

4 IBM Cognos TM1

目次

オンデマンドでのプロセスの実行 88日課によるプロセスの自動実行スケジュールの作成 88

日課の開始時刻に関する重要な注意事項 90日課の編集 90日課の有効化 90日課の無効化 90日課の削除 91オンデマンドでの日課の実行 91

付録 A：TurboIntegrator Tutorial 93チュートリアルのデータディレクトリの設定 93TurboIntegrator の概要 93TurboIntegrator プロセスの作成 94

TurboIntegrator を使用したディメンションの作成 94キューブの作成とデータの処理 102

詳細スクリプトの処理 108プロローグ、メタデータ、データ、エピローグの各プロシージャの編集 108サブセットの作成 116属性の作成 117

付録 B：TurboIntegrator の予約語 119規則関数の名前 119プロセス関数の名前 122暗黙的な変数の名前 126TurboIntegrator のキーワード 127

索引 129

TurboIntegrator ガイド 5

目次

6 IBM Cognos TM1

目次

はじめに

このマニュアルは IBM® Cognos® TM1 の使用にあたって参照してください。

このマニュアルでは、IBM Cognos TM1 TurboIntegrator を使用して、データとメタデータをさまざまな

ソースから TM1 にインポートする方法について説明します。

ビジネスパフォーマンスマネージメントとは、企業全体の財務、運営、顧客、および組織のパフォーマ

ンスを継続してマネージメントし、モニタリングすることです。ビジネスパフォーマンスマネージメントソ

リューションには、次の機能があります。ビジネスにおける革新的な運営が容易になります。

● 広範囲な展開

● 協調的な意志決定

● 継続的かつリアルタイムの評価と改善

● 重要なパフォーマンスインジケータのモニタリング

IBM Cognos TM1 では、ビジネス計画、パフォーマンスの測定、および運営データを統合しています。

そのため、会社がビジネスの効果性や顧客との対話を地理的または構造的状況に関係なく最適化する

ことができます。TM1 では、データ、協調プロセス内の責任、および情報を一貫して詳細にモニタリング

することができるため、経営面における運営の変動を安定化し、新しいビジネスチャンスを活用すること

ができます。

対象読者

『IBM Cognos TM1 TurboIntegrator ガイド』は、TM1 にインポートされる必要のあるデータの構成方法

に関する基礎知識を持つ TM1 ユーザー向けに作成されています。

情報の検索

製品マニュアルの最新版を入手するには、IBM Cognos インフォメーションセンター（http://publib.

boulder.ibm.com/infocenter/cogic/v1r0m0/index.jsp）にアクセスしてください。各言語版のマニュアルも

すべて用意されています。

さらに、IBM Cognos の製品ディスクには、製品のリリースノートとインストールガイドが PDF 形式で収

録されています。

サンプルに関する免責事項

Great Outdoors 社、GO 販売、Great Outdoors 名のすべてのバリエーション、および Planning サンプ

ルでは、IBM および IBM のお客様向けのサンプルアプリケーションを開発するために使用されるサン

プルデータにより、架空の企業活動が描出されています。これらの架空データには、販売取引、商品流

通、財務、および人事のサンプルデータが含まれます。実際の名前、住所、電話番号、または取引額

との類似は偶発的なものです。また、サンプルファイルの中には、手動またはコンピュータで生成された

架空のデータ、学術的ソースまたは公共のソースを基に編集された実際のデータ、版権所有者の許可

を得て使われているデータなどが、サンプルアプリケーションを開発するためのサンプルデータとして

使用されている場合もあります。参照される製品名は、それぞれの所有者の商標である可能性がありま

す。無断の複写は禁止されています。





ユーザー補助機能

現在この製品では、ユーザー補助機能はサポートされていません。ユーザー補助機能とは、動作が制

限されている方、視力の限られた方など、身体の不自由な方に製品をご使用いただけるように支援する

機能のことです。

8 IBM Cognos TM1

はじめに

第 1 章：TurboIntegrator の基礎

このセクションでは、TurboIntegrator を使用して、データを IBM® Cognos® TM1® キューブにインポート

する方法の基本について説明します。TurboIntegrator では、ソースのデータ構造を認識し、TM1 が必

要とする適切な構造への変形するプロセスを設計することができます。一度 TI プロセスが設計された後

は、それを再実行したり、動的ソースからデータをインポートするときに使用されるようにスケジュールす

ることができます。後続のセクションでは、特定のソースタイプからデータをインポートする手順について

説明します。

TurboIntegrator を使い始める前に、全種類のソースに適用されるこの情報を必ず理解するようにしてく

ださい。

● 「TurboIntegrator で使用可能なデータソース」（9 ページ）.

● 「TurboIntegrator での文字列長の制限」（9 ページ）.

● 「インポート処理のオプション」（10 ページ）.

● 「TurboIntegrator 関数」（10 ページ）.

● 「プロセスと日課」（10 ページ）.

● 「TurboIntegrator プロセス内での操作の順序」（11 ページ）.

● 「TurboIntegrator プロセスに関するの注意事項」（11 ページ）.

TurboIntegrator で使用可能なデータソースTM1® TurboIntegrator では、次のデータソースのデータをインポートできます。

● ASCII ファイルを含む、カンマ区切りのテキストファイル。

● ODBC データソース経由でアクセス可能なリレーショナルデータベーステーブル。

● 他の TM1 キューブおよびビュー。

● Microsoft® Analysis Services。

● SAP 対 RFC。

これらのソースタイプの詳細については、本マニュアルの他のセクションを参照してください。

TurboIntegrator での文字列長の制限TurboIntegrator は、8000 シングルバイト文字までのサイズの文字列データを一度に扱うことがきます。

この制限は、TI プロセスで、変数への値の代入、データの個々のレコードのインポートなどの操作が実

行される場合に適用されます。8000 シングルバイト文字より長い値やレコードの末尾は切り捨てられま

す。

例えば、テキストファイルからデータ行をインポートする場合、テキストの各行の長さが 8000 文字を超え

ることはできません。カンマ区切りファイルのデータをインポートする場合は、ファイル内の各レコードの

長さが 8000 文字を超えることはできません。



インポート処理のオプションTurboIntegrator を使用してデータを TM1® にインポートする際には、次のオプションがあります。

● キューブを作成し、ソースからインポートしたデータをキューブに移入する。

● キューブを作成し直す。このオプションでは、現存するキューブが破棄され、再作成されます（その

ため、インポート時に、データとメタデータの両方を変更できます）。

● キューブ構造を維持したまま、既存のキューブを更新する。このオプションでは、データを既存の

キューブ構造にインポートできます。

● ソースからインポートしたデータで TM1 にディメンションを作成する。

● インポートしたデータで TM1 のディメンションを更新する。

TurboIntegrator では、これらの操作を任意に組み合わせて実行できます。

TurboIntegrator 関数TurboIntegrator には、TM1® オブジェクト（キューブ、ビュー、ディメンション、要素など）をデータのイン

ポート時に操作することができる一連の関数が用意されています。

これらの TurboIntegrator 関数に加えて、TurboIntegrator プロセスには、STET 関数を除く標準的なす

べての TM1 規則関数も組み込むことができます。

TurboIntegrator 関数については、『IBM Cognos TM1 参照ガイド』の「TM1 TurboIntegrator 関数」を参

照してください。

プロセスと日課TurboIntegrator でのデータインポートは、プロセスを定義して行います。プロセスは、次の要素で構成

される TM1® オブジェクトです。

● データソースの説明

● データソース内の各列に対応する一連の変数

● TM1 データベースの変数間の関係およびデータ構造を定義する一連のマップ

● プロローグプロシージャ（データソースの処理前に実行する一連の操作で構成されます。）

● メタデータプロシージャ（キューブ、ディメンションなどのメタデータ構造を更新または作成する一連

の操作で構成されます。）

● データプロシージャ（TM1 データベース内のデータを更新または変換する一連の操作で構成され

ます。）

● エピローグプロシージャ（データソースの処理後に実行されます。）

● プロセスを一般化し、異なる状況で使用できるようにするための一連のパラメータ。

日課は、一連の TM1 プロセスのコンテナオブジェクトです。日課を使用することで、複数のプロセスを

一定の順序で実行したり、プロセスを一定のタイミングで実行するスケジュールを作成できます。詳細に

ついては、「詳細プロシージャと日課の編集」を参照してください。

10 IBM Cognos TM1


TurboIntegrator プロセス内での操作の順序TurboIntegrator プロセスには、複数のプロシージャ（プロローグ、メタデータ、データ、およびエピロー

グ）が含まれます。これらのプロシージャは、TurboIntegrator エディタの［詳細］タブのサブタブとして表

示することができます。

データースを定義し、変数を設定して、プロセスのデータ操作を指定すると、TurboIntegrator プロセス

を実行したときに実行されるスクリプトが TM1® によって生成されます。このスクリプトは、TurboIntegrator

エディタのそれぞれのプロシージャサブタブに配置されます。また、TurboIntegrator 関数と規則関数を

使用して、独自のスクリプトを任意のプロシージャサブタブ内に作成することもできます。

TurboIntegrator プロセスを実行すると、次の順序でプロシージャが実行されます。

1. TurboIntegrator プロセスのデータソースが開かれる前に、プロローグプロシージャが実行されま

す。

2. プロセスのデータソースが［なし］の場合は、プロローグの処理が終了するとすぐにエピローグプロ

シージャが実行されます。

注：プロセスのデータソースが［なし］の場合、メタデータプロシージャとデータプロシージャは無視

されます。その場合は、プロセスのすべてのスクリプトを、プロローグまたはエピローグのいずれかの

プロシージャ内に作成する必要があります。

3. データソースが［なし］以外の場合は、データソースが開かれます。

4. データソースの最初のレコードに対して、メタデータプロシージャのすべての行が順に実行されま

す。次に、データソースの 2 番目のレコードに対してすべての行が順に実行され、それ以降もすべ

てのレコードが処理されるまで同じ処理が実行されます。

5. データソースの最初のレコードに対して、データプロシージャのすべての行が順に実行されます。

次に、データソースの 2 番目のレコードに対してすべての行が順に実行され、それ以降もすべて

のレコードが処理されるまで同じ処理が実行されます。

6. データプロシージャの処理が終了すると、データソースが閉じられます。

7. エピローグプロシージャが実行されます。

8. TM1 によって TurboIntegrator プロセスが閉じられます。

TurboIntegrator プロセスに関するの注意事項TurboIntegrator プロセスの作成と編集では、次の点に注意してください。

● TurboIntegrator で新規または変更されたディメンションがコンパイルされるのは、そのディメンション

が作成または変更されるプロシージャが終了した時点でのみです。

新しいディメンションの場合、これは、ディメンションを作成するプロシージャがデータソース内のす

べてのレコードを処理するまでは、新しいディメンションにアクセスできない（アクセス手段が

TurboIntegrator かどうかは問いません）ことを意味します。変更するディメンションの場合、これは、

ディメンションを変更するプロシージャが処理を完了するまでは、新しい要素にアクセスできないこと

を意味します。

● TurboIntegrator 関数および（STET を除く）規則関数は、プロセス内の任意のプロシージャで使用

できます。また、プロシージャで使用することができる関数に制限はありません（すべての関数が、あ

らゆる TurboIntegrator プロシージャで有効です）。

● TI プロセスと規則の論理演算子や算術演算子などのさまざまな演算子の使用方法については、

『IBM Cognos TM1 Rules Guide』の規則の概要の章の「式」を参照してください。



ただし、関数は論理的な順序で使用し、プロセスで目標を必ず達成できるようにすることが必要です。例

えば、ディメンションに新しい要素を追加し、そのデータ値を更新するプロセスを構築する場合は、新規

要素の追加とディメンションのコンパイルが終了してから、その要素のデータ値を更新するようにプロセ

スが実行されることを確認する必要があります。通常は、メタデータプロシージャで DimensionElementInsert

関数を使用して新規要素を追加してから、データプロシージャで CellPutN 関数を使用して値を更新す

ることになります。

この例で、新規要素を追加する操作と、そのデータ値を更新する操作の両方をデータプロシージャで

実行するプロセスを構築した場合、そのプロセスは正しく動作しません。処理が失敗するのは、前述した

ように、変更されたディメンションは、プロシージャの終了時のみにコンパイルされるためです。ディメン

ションがコンパイルされるまでは、新しい要素が存在しません。存在していない要素のデータ値を

TurboIntegrator で変更することはできません。このため、プロセスは失敗します。

同じ TM1 サーバーに同時接続。プロセスが既に実行している同じ TM1® サーバーに新しい接続（ログイン）を作成する TurboIntegrator

プロス内では、いかなる操作も行わないでください。2 つのログイン間のデッドロックや、スレッドによって

TM1 サーバーがハングまたはクラッシュする原因になります。

例えば次のような状況は回避してください。

● TI プロセスを使用しないで、同じ TM1 サーバーで ODBO MDX クエリーを起動（Applix TM1 OLE

DB MD Provider を使用）。この場合、プロセスとクエリーの両方が互いに終了するのを待つことにな

ります。

● TI 関数の ExecuteCommand を使用しないで、TI プロセスを呼び出して実行し、同じ TM1 サーバー

に再度ログインする外部プログラムを待機（”Wait”引数に”1”を設定）。この中には、同じ TM1 サー

バーに再度接続するカスタムアプリケーションや IBM Cognos アプリケーション（TM1 ETLDAP ユー

ティリティなど）が含まれます。

”Wait"引数に”1”を設定して ExecuteCommand 関数を使用すると、外部プログラムが再度同じサーバー

にログインしない場合でも、TM1 サーバーがハングする危険があります。外部プログラムに内部エラー

が発生してハングした場合は、基本的に TI プロセスは外部プログラムの待機をハングして、実行を終了

します。

TurboIntegrator 関数での別名別名は、規則上の関連する要素のプリンシパル名の代わりに、また TurboIntegrator において使用する

ことができます。

個人用作業領域とサンドボックスを TurboIntegrator プロセスで使用する

このセクションでは、個人用作業領域とサンドボックスを TurboIntegrator プロセスおよび関数で使用す

る方法について説明します。

TurboIntegrator プロセスを個人用領域かサンドボックスで手動で実行する

そのプロセスの[アクティブサンドボックスを使用] プロパティを選択することで、Server Explorer で現在

アクティブなサンドボックスと共にプロセスを手動で実行することができます。アクティブなサンドボックス

は、キューブビューアで現在選択されているサンドボックスにより決定されます。個人用作業領域では、

デフォルトのサンドボックスのみを使用することができます。

12 IBM Cognos TM1


注：日課、およびそれらに含まれるプロセスは、個人用作業領域またはサンドボックスで実行できません。

プロセスが日課の一部として実行される場合、基本データに対して実行されるだけです。

手順

1. Server Explorer において、キューブビューアのビューを開きます。

2. 利用可能なサンドボックスの一覧からサンドボックスをクリックし、そのプロセスに使用するサンドボッ

クスを選択します。

3. ツリーウィンドウで、プロセスを右クリックし、[アクティブサンドボックスを使用]をクリックしてオプショ

ンを有効にします。

4. プロセスを右クリックし、［実行］をクリックします。

プロセスは現在アクティブなサンドボックスを使用して実行されます。

TurboIntegrator 関数をサンドボックスで使用する

次の TurboIntegrator 関数により、TurboIntegrator プロセスが個人用作業領域またはサンドボックスと

相互に作用することができるようになります。

● GetUseActiveSandboxProperty

● SetUseActiveSandboxProperty

● ServerActiveSandboxGet

● ServerActiveSandboxSet

これらの関数は、Server Explorer インターフェースで利用できる [アクティブサンドボックスを使用] プロ

パティと同じです。

詳細については、『IBM Cognos TM1 リファレンスガイド』の TurboIntegrator 関数についての節を参照

してください。



14 IBM Cognos TM1


第 2 章：テキストファイルのインポート

このセクションでは、（ASCII などの）カンマ区切りのテキストデータを IBM® Cognos® TM1® TurboIntegrator

でインポートする方法について説明します。TM1 プロセスは個々に異なり、他のタイプのデータソース

からインポートする処理ではその内容がわずかに異なりますが、このセクションで説明する手順は、ほと

んどのプロセスに共通しています。この手順および例では、ファイル“NewEngland.cma”を使用します。こ

のファイルは、TM1 に付属するサンプルデータの 1 つとしてインストールされています。

テキストファイルからのディメンションの作成ディメンションは、TurboIntegrator を使用して、データソース内の要素名のリストから作成できます。この

方法は、何千何百もの要素を含むディメンションを最も速く作成できます。

TurboIntegrator でディメンションを作成する場合は、プロセスを定義して、TM1® サーバーにオブジェク

トとして保存します。このプロセスは、他のユーザーからもアクセスできます。また、オンデマンドで実行す

ることも、スケジュール設定した間隔で実行することもできます。

TurboIntegrator でディメンションを作成するには：

❑ データソースを TM1 に定義します。「データソースの定義」（15 ページ）を参照してください。

❑ TM1 が遭遇する変数を特定します。「データソースの変数の識別」（17 ページ）を参照してくださ

い。

❑ 変数をそのデータタイプにマッピングします。「変数のマッピング」（20 ページ）を参照してくださ

い。

❑ プロセスを保存して、実行します。「TurboIntegrator プロセスの保存と実行」（21 ページ）を参照し

てください。

データソースの定義

TurboIntegrator を使用する際はいつでも、データを読み出すデータソースを最初に定義する必要が

あります。この例では、この TurboIntegrator プロセスのデータソースとして、“NewEngland.cma”という名

前の ASCII ファイルを定義します。

手順

1. サーバーエクスプローラの左側のウィンドウにある［プロセス］を右クリックし、［プロセス］ → ［新規プ

ロセスの作成］を選択します。

2. ［データソース］タブで［テキスト］をクリックします。

［TurboIntegrator］ウィンドウが開きます。

3. ［参照］をクリックします。

［入力ファイルを選択］ダイアログボックスが開きます。

4. “NewEngland.cma”にナビゲートし、選択して［開く］.をクリックします。

“NewEngland.cma”は、PData または SData のいずれかのサンプルディレクトリにあります。 TM1®

のデフォルトインストールディレクトリを使用していた場合、このファイルの完全なパスは次のとおり

です。



C:\Program Files\Cognos\TM1\Custom\TM1Data\SData\NewEngland.cma

または

C:\Program Files\Cognos\TM1\Custom\TM1Data\PData\NewEngland.cma.

ファイルの場所を Universal Naming Convention（UNC）で指定するように求めるメッセージが表示さ

れる場合があります。プロセスを一貫して ASCII ファイルに対して実行する場合は UNC を使用して

ください。その際、次の条件を満足することも確認してください。

● Windows® TM1 サーバーを実行している場合、ASCII ファイルは、TM1 サーバーからアクセス

できるように、共有 Windows ディレクトリに存在する必要があります。

● UNIX TM1 サーバーを実行している場合は、TM1 Windows クライアントと TM1 UNIX サーバー

の両方から認識できるいずれかの共有ネットワークディレクトリにファイルが存在する必要があ

ります。

注：UNIX TM1 サーバーを実行している場合は、入力ソースファイル名に大文字やスペース文字

を含めることができません。

5. 警告ボックスで［OK］をクリックします。

6. ［TI］ダイアログボックスで次のように指定します。

“NewEngland.cma”は、区切り文字にカンマ、引用符に二重引用符、タイトルレコードなし、小数点

記号にピリオド、桁区切り記号にカンマを使用した区切りつきソースです。

このソースを定義するには、次の設定を入力します。

● ［区切り記号の種類］で［区切り付き］を選択します。

● ［区切り記号］として［カンマ］を選択します。

● ［引用符］に " を入力します。

● ［タイトルレコード］のフィールドは空白のままにします。

● ［小数点記号］に . を入力します。

● ［桁区切り記号］に , を入力します。

7. ［プレビュー］をクリックします。

ウィンドウの下部に、ソースデータのサンプルが表示されます。

16 IBM Cognos TM1


固定長レコードの使用

TurboIntegrator では、フィールド幅が固定されたテキストファイルからデータをインポートすることもでき

ます。データソースが固定フィールド幅を持っていることを指定するには、データソースの場所を指定

した後で、［区切り記号の種類］で［固定幅］を選択してから、［フィールド幅の設定］をクリックします。

［データのプレビュー］ダイアログボックスに、ソースデータの最初の 3 レコードが表示されます。データ

ソースのレコードの内容に基づいてフィールド幅を設定するには、次の操作を行います。

手順

1. 列見出し［1］をクリックします。

列見出しに区切り線が表示されます。この線は 3 つのレコードにまで延長されています。

2. 区切り線をクリックして、最初の列と 2 番目の列を仕切る位置までドラッグします。

新しい列見出し［2］が表示されます。

3. 列見出し［2］をクリックして、新しい区切り線を 2 番目と 3 番目の列を仕切る位置までドラッグしま

す。

4. テキストソース内の残りのすべての列について、区切り線を設定します。

5. ［OK］をクリックして、［TurboIntegrator］ウィンドウに戻ります。

データソースの変数の識別

データソースの定義が終了すると、TurboIntegrator によってソースの列ごとに変数が割り当てられます。

この変数の型と内容を識別する必要があります。

この処理の説明のため、次のテキストデータについて検討します。

New England, Massachusetts, Boston, Supermart, Feb, 2000000

New England, Massachusetts, Springfield, Supermart, Feb, 1400000



New England, Massachusetts, Worcester, Supermart, Feb, 2200000

New England, Connecticut, Hartford, Supermart, Feb, 1240000

New England, Connecticut, New Haven, Supermart, Feb, 2700000

New England, Connecticut, Greenwich, Supermart, Feb, 1700000

最初の 3 つの列は、ソーステキストファイルから構築する“Location”ディメンションの階層を構成しま

す。

● “New England”集約は、階層の最上位にあります。

● 州の“Massachusetts”および“Connecticut”は、“New England”の 1 つ下のレベルにあります。

● “Boston”、“Hartford”など都市名がある 3 番目の列は、階層の最下位にある単純要素になります。

● 残りの列は、“Location”ディメンションの作成には使用しません。

このデータ構造の［TurboIntegrator］ウィンドウには［変数］タブがあります。

TurboIntegrator によって、各列に変数名が割り当てられ、各列のサンプル値に基づいて変数の型が割

り当てられています。

デフォルトの変数名（“V1”、“Massachusetts”など）は変更できます。変数には、わかりやすい名前を付

けることをお勧めします。わかりやすい名前を付けることで、TurboIntegrator スクリプトが読みやすくな

り、トラブルシューティングも容易になります。

変数名を編集するには、［変数名］列の名前をクリックし、新しい名前を入力します。この演習では、最初

の 3 つの変数の名前が次のように編集されました。

変数名サンプル値

RegionNew England

StateMassachusetts

CityBoston

変数名は英文字で始まる必要があります。使用できるのは次の文字のみです。

説明文字

A ～ Z大文字

a ～ z小文字

18 IBM Cognos TM1


説明文字

0 ～ 9数字

.ピリオド

_アンダースコア

$ドル記号

［変数の型］フィールドでは、列の内容が識別されます。例えば、このデータの最初の列には、文字列

“New England”が含まれています。この変数型は、TurboIntegrator によって［文字列］と正しく識別され

ています。

注：一般に、ASCII データの場合は［変数の型］フィールドが正確に設定されますが、ODBC データソー

スから抽出したデータの場合は正確ではありません。

コンテンツフィールドは、次のいずれかの設定で指定できます。

説明オプション

データソースの処理時に、列の内容を無視します。無視

この列には、作成するディメンションの単純要素が含まれています。要素

この列には、作成するディメンションの集約要素が含まれています。集約

この列には、データ値が含まれています。データ

この例の場合、データ値を含む列は無視してください。データ値を含む列は、ディメンションの作成時にイ

ンポートされません。

この列には、作成するディメンションの要素属性が含まれています。属性

この列には、直前の 4 つのカテゴリのいずれにも該当しないデータが含まれています。一般にこの設定

が使用されるのは、カスタムの変数および数式で処理されるデータが列に含まれる場合です。

その他

この例のテキストデータには、“Location”ディメンションの要素と集約が含まれています。

● 属性は含まれていません。

● デタ値は含まれていますが、それらの値は、他のディメンションの要素と同様に、“Location”ディメン

ションの作成には関係しません。

“Location”ディメンションの変数を定義するには

手順

1. ［TurboIntegrator］ウィンドウの［変数］タブをクリックします。

2. 変数“Region”、“State”、および“City”の［コンテンツ］フィールドを、次のように設定します。



コンテンツ変数

集約Region

集約State

要素City

● これで、変数“Region”は集約として識別されます。

● また、変数“State”も集約として識別されます。

● 変数“City”は、リーフレベル（非集約）要素に識別されています。

変数のマッピング

データソースの変数の識別が終了したら、その変数を要素と集約にマッピングする必要があります。

変数のマッピングは、［TurboIntegrator］ウィンドウで［マップ］タブをクリックして始めます

［マップ］タブには、その他の複数のタブが含まれます。［キューブ］タブは常に使用可能です。他のすべ

てのタブは、［変数］タブで設定した列のコンテンツに基づいて使用できるようになります。例えば、列に

要素が含まれていると指定した場合は、［ディメンション］タブが使用可能になります。列に集約が含まれ

ていると指定した場合は、［集約］タブが使用可能になります（以下、同様）。

キューブのマッピングの無効化

ディメンションを作成する場合は、キューブ操作を実行しません。キューブのマッピングを防ぐには

手順

1. ［キューブ］タブをクリックします。

2. ［キューブの操作］ボックスで［未対処］を選択します。

ディメンションのマッピング

データソースの列の中に、要素を含んでいると指定した列がある場合は、作成するディメンションにその

要素をマッピングする必要があります。

手順

1. ［ディメンション］タブをクリックします。

2. ［ディメンション］フィールドに「Location」と入力します。

同じディメンションに複数の要素をマッピングする場合は、ディメンション名を要素ごとに入力します。

［ディメンション］列に新しいディメンション名を入力すると、［操作］列がデフォルトで［作成］になりま

す。

既存のディメンション名を入力する場合は、そのディメンションを再作成するか更新するかを選択で

きます。［再作成］操作を選択すると、既存のディメンション内の要素が削除され、データソースの

データで置き換えられます。［更新］操作を選択した場合は、データソースに新しい要素があれば

その要素でディメンションが更新されます。

3. 適切な［要素の型］メニューから各要素の型を選択します。要素の型は、要素変数で識別されたデー

タの型を示します。 TM1® では、この設定はほとんどの場合に［数値］です。

20 IBM Cognos TM1


4. ［要素の順序］オプションを選択します。要素の順序によって、処理中に要素をディメンションに追加

する方法が決まります。

この例のデータには 1 つの数値要素が含まれており、新しい“Location”ディメンションにマッピング

されます。操作の完了した［ディメンション］タブは、次のようになります。

データのマッピングの無効化

ディメンションを作成する場合、データのマッピングは実行しません。［キューブマッピング］タブ (「キュー

ブのマッピングの無効化」（20 ページ）) で［未対処］を指定したので、この［データ］タブは使用できなく

なります。

集約のマッピング

データソースの列の中に、「集約を含んでいる」と指定した列がある場合は、作成するディメンションの集

約パスをマッピングする必要があります。

手順

1. ［集約］タブをクリックします。

このタブには、集約と定義されている変数（“Region”および“State”）が表示されます。

ディメンションの集約階層は、集約変数ごとに子の変数を指定して定義できます。

2. “Region”集約変数の直属の子は“State”です。“Region”集約の［子の変数］フィールドの山括弧ボ

タンをクリックし、［State］を選択して、［OK］をクリックします。

3. “State”集約変数の直属の子は“City”です。“State”集約の［子の変数］フィールドの山括弧ボタン

をクリックし、［City］を選択して、［OK］をクリックします。

4. 集約ごとに、［コンポーネントの順序］ボタンをクリックします。［コンポーネント要素の順序設定］ダイ

アログボックスが開きます。

5. ［自動］、［名前］、および［昇順］をクリックします。

注：同じディメンション内に複数の集約を設定する場合は、すべての集約で［コンポーネント要素の

順序設定］の設定を同じにする必要があります。同じディメンション内に 2 つの集約がある場合、そ

れぞれの［コンポーネント要素の順序設定］設定が異なっていると、プロセスを保存して実行しようと

したときに、「並べ替え情報が一致しません」とのエラーが発生します。

TurboIntegrator プロセスの保存と実行

データソースの定義と変数の設定が終了したら、TurboIntegrator プロセスがコンパイルされ、保存され

ます。ディメンションを作成するには、完了したプロセスを実行します。

手順

1. TurboIntegrator のメニューバーから［ファイル］ → ［保存］をクリックします。

［プロセスに名前を付けて保存］ダイアログボックスが開きます。

2. プロセスの名前を入力し、［保存］をクリックします。

コンパイル時と保存時に TM1® でエラーが検出されると、エラーの内容を示すエラーメッセージが

表示されます。［TurboIntegrator］ウィンドウはアクティブなままなので、エラーがあればすぐに修正

できます。



プロセスは、サーバーエクスプローラの［プロセス］の下にサーバーオブジェクトとして保存されま

す。これで、プロセスを実行したり、修正したりすることができます。

プロセスを実行してディメンションを作成するには、TurboIntegrator のメニューバーから［ファイル］

→ ［実行］をクリックします。サーバーエクスプローラからプロセスを直接実行することもできます。そ

れには、プロセスを選択し、［プロセス］ → ［プロセスを実行］をクリックします。

プロセスが正常に実行されると、TM1 から確認メッセージが発行されます。

プロセスが実行できない場合は、実行時に発生したエラーの詳細を記述したダイアログボックスが

表示されます。

“NewEngland.cma”が処理されると、“Location”ディメンションが新規に作成されます。

テキストファイルからのキューブの作成また、TurboIntegrator はテキストファイルからキューブ全体を作成できます。この手順では、いくつかの

ディメンションと要素も構築され、データ操作も実行されます。

キューブを構築する手順は、ディメンションを構築するプロセスと似ています。

❑ データソースを TM1® に定義します。「キューブのデータソースの定義」（22 ページ）を参照して

ください。

❑ TM1 が遭遇する変数を特定します。「キューブ変数の定義」（23 ページ）を参照してください。

❑ 生成されるキューブにおける様々なデータタイプに対して、異なる変数をマッピングします。「キュー

ブ変数のマッピング」（23 ページ）、「ディメンションへのキューブ要素変数のマッピング」（24 ペー

ジ）を参照してください。「キューブのデータ変数のマッピング」（24 ページ）および「集約変数のマッ

ピング」（24 ページ）を参照してください。

❑ プロセスを保存して、実行します。「キューブプロセスの保存と実行」（24 ページ）を参照してくださ

い。

TM1 には、“TI_data”というサンプルデータディレクトリが含まれています。“TI_data”には、“import_cube.

csv”というファイルがあります。この例では、“import_cube.csv”から TM1 キューブを構築する方法につ

いて説明します。

キューブのデータソースの定義

テキストファイルからキューブを作成する最初の手順は、データソースの定義です。

手順

1. サーバーエクスプローラの左側のウィンドウで［プロセス］アイコンを右クリックし、［新規プロセスの作

成］を選択します。

2. ［TurboIntegrator］ウィンドウの［データソース］タブをクリックします。

3. ［データソースタイプ］で［テキスト］を選択します。

4. ［データソース名］フィールドの横にある［参照］ボタンをクリックし、“TI_data”ディレクトリ内の

[import_cube.csv]ファイルを選択します。デフォルトのインストールディレクトリを使用していた場合、

“TI_data”ディレクトリの完全なパスは次のとおりです。

C:\Program Files\Cognos\TM1\Custom\TM1Data\TI_Data.

5. ［区切り記号の種類］を［区切り付き］に設定し、［区切り記号］として［カンマ］を選択します。

この例では、［引用符］および［タイトルレコード数］フィールドは無視します。

22 IBM Cognos TM1


6. ［小数点記号］がピリオド（.）で、［桁区切り記号］がカンマ（,）になっていることを確認します。

7. ［プレビュー］をクリックして、データソースの最初の数レコードを表示します。

“import_cube.csv”の各レコードには 6 つのフィールドがあります。最初の 5 つのフィールドには、

要素名として TM1® にインポートされる情報が含まれています。6 番目の列にはキューブのデータ

が含まれています。

キューブ変数の定義

TurboIntegrator に対してソースデータを特定した後、ソースのフィールドごとに内容を識別する必要が

あります。

手順

1. ［変数］タブをクリックします。各変数には、TurboIntegrator によってデフォルト値が設定されます。

2. 各変数について、それぞれの［変数の型］メニューから型を選択します。

この例の場合、［変数の型］フィールドを変更する必要はありません。各変数の型は、TM1® によっ

て正しく識別されています。

3. 各変数について、それぞれの［コンテンツ］メニューからコンテンツタイプを選択します。

この例の場合、V6 を除くすべての変数を［要素］と識別する必要があります。V6 は［データ］と識別

する必要があります。

キューブ変数のマッピング

これでデータ、要素、および集約の変数は識別されました。ここからは、変数をマッピングして、新しい

キューブを作成する手順を指示する必要があります。

手順

1. ［マップ］タブをクリックします。

2. ［キューブ］タブをクリックします。

3. ［キューブの操作］で［作成］を選択します。

4. ［キューブ名］フィールドに「import_cube」と入力します。

5. ［データ操作］で［値の保存］を選択します。

6. ［キューブのログ記録を有効化］オプションはオンにしないでください。キューブのログ記録を有効

にすると、TM1® は処理中のキューブデータの変更を記録します。新しいキューブを作成するとき

に、変更内容をログに記録する必要はありません。



ディメンションへのキューブ要素変数のマッピング

［要素］型を持つと識別したすべての変数を、それぞれのディメンションにマッピングします。

手順

1. ［ディメンション］タブをクリックします。

2. 次の表に従って、［ディメンション］タブの値を設定します。

キューブ内の順序ディメンションサンプル値要素の変数

1actvsbud2ActualActual

2region2ArgentinaArgentina

3model2S Series 1.8 L SedanV3

4measuresUnitsUnits

5month2JanJan

3. すべての要素変数について、［操作］は［作成］に設定し、［要素の型］は［数値］に設定します。

キューブのデータ変数のマッピング

この例のデータ変数は V6 の 1 つのみです。このデータ変数はマッピングの必要がありません。

TurboIntegrator によって自動的にマッピングされます。この例では、データタブも有効になりません。

データがキューブに追加されるときは、作成されたディメンションの交差部分に追加されます。［変数］タ

ブで複数の変数がデータとして定義されている場合は、データをキューブに追加する際の位置に関す

る情報を指定することが必要になります。

データ値をキューブにマッピングする詳細な例については、「TurboIntegrator Tutorial」を参照してくだ

さい。

集約変数のマッピング

この例の場合は、［変数］タブで集約として定義された変数がありません。この例では、［集約］タブは有

効になりません。

集約をキューブにマッピングする詳細な例については、「TurboIntegrator Tutorial」を参照してください。

キューブプロセスの保存と実行

プロセスを保存して実行するには、以下を実行します。

手順

1. [実行]ボタンをクリックします。

TM1® は、プロセスに名前を付けて保存するように指示します。

2. プロセスを“create_newcube”として保存します。

数秒後に、プロセスが正しく実行されたことを示す確認画面が表示されます。

24 IBM Cognos TM1


3. サーバーエクスプローラを開きます。キューブ“import_cube”が作成され、データが移入されていま

す。また、必要なディメンションもすべて作成されています。



26 IBM Cognos TM1


第 3 章：ODBC ソースからのインポート

TurboIntegrator を使用して、リレーショナルデータベーステーブルのデータからキューブおよびディメ

ンションを作成できます。そのためには、マシン上に次のソフトウェアが必要です。

● TurboIntegrator を実行するマシンと同じマシンにインストールされているリレーショナルデータベー

ス用のクライアントソフトウェア。

● リレーショナルデータベースに対して確立された ODBC データソース。データソースは、Windows®

Data Sources コントロールパネルで構築します。

一旦 ODBC データソースの定義が完了すると、リレーショナルデータからキューブやディメンションを

作成する手順は、テキストファイルからキューブやディメンションを作成する場合とまったく同様です。

TurboIntegrator で ODBC ソースを使用し、順を追ってオブジェクトを作成する完全チュートリアルにつ

いては、「TurboIntegrator Tutorial」を参照してください。

Unicode と DNSバージョン 11g クライアント/ODBC ドライバを使用して Oracle データベースから Unicode データをイン

ポートするように DSNを設定する場合は、[Application(アプリケーション)]タブで[Enable Closing Cursors

(カーソルクローズを有効にする)]オプションを必ず指定してください。 TI プロセスは、このオプションが

指定されていなければ失敗します。

Oracle 11g ODBC ドライバは、SqlFreeStmt の SQL_CLOSE オプションを完全にサポートしていません。

ODBC データソースの定義ODBC データソースを定義するには：

手順

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

2. プロセスを作成するサーバーの下の［プロセス］アイコンを右クリックし、［新規プロセスの作成］を

選択します。


3. ［データソースタイプ］ボックスの最上部の［ODBC］を選択します。ODBC ソースの定義に必要な

フィールドが表示されます。

4. ［参照］をクリックし、ODBC データソース名を選択します。指定できるデータソースは、TM1 サー

バーが実行されているコンピュータ上にあるもののみです。

5. このソースを使用する必要がある場合は、ターゲットデータベースの有効なユーザー名とパスワー

ドを［ユーザー名］と［パスワード］フィールドに入力します。

6. ［クエリ］ボックスに、ソースからデータを抽出する SQL クエリーを入力します。SQL クエリーの構文

と書式は、使用するデータベースのタイプによって異なります。例えば、Microsoft® Access Database

を使用する場合は、Microsoft Access を実行し、データベースを開き、SQL ビューを使用して SQL

ステートメントをこの［クエリー］ウィンドウにコピーします。



注：クエリーで参照するテーブル名にスペースが含まれる場合は、名前を二重引用符で囲む必要

があります。


クエリーが有効であり、接続がしく定義されている場合は、ターゲットデータベーステーブルの最初

の 10 レコードが［TurboIntegrator］ウィンドウに表示されます。

ODBC 変数を定義する手順については、「データソースの変数の識別」を参照してください。

ODBC のマッピング指示を定義する方法については、「変数のマッピング」を参照してください。

TurboIntegrator プロセスを保存して実行する方法の詳細については、「TurboIntegrator プロセス

の保存と実行」を参照してください。

MDX 文からの TurboIntegrator プロセスの生成このセクションでは、MDX 文を使用して ODBO データソースのデータを抽出し、データを TM1 にイン

ポートする方法について説明します。

MDX 文は別のユーティリティを使用して生成し、その MDX 文を、TM1 へのインポートを最終的に行う

MDX 文のベースにすることをお勧めします。

データを TM1 にインポートするときは、列数の限られた MDX 文で始めることが重要です。MDX 文の

中には、多数の列を生成するものがあります。このようなクエリーは、インポートの起点として現実的では

ありません。

列数を制限するには、例えば、関心がある数値データのみを列に配置します。

MDX TurboIntegrator プロセスの構築

実用的なデータを戻す MDX 文を作成したら、TurboIntegrator プロセスを構築できます。

次の手順を実行して、処理を開始します。

手順

1. サーバーエクスプローラで［プロセス］を右クリックし、［新規プロセスの作成］を選択します。


2. ［データソースタイプ］ボックスで［ODBO］をクリックし、［MDX クエリー］を選択します。

3. 必要な接続パラメータを［TurboIntegrator］ウィンドウの［接続］タブに入力します。接続パラメータは、

ベンダー固有のパラメータです。

4. ［接続］をクリックします。正しく接続すると、接続ボタンがグレー表示になり、［MDX クエリー］タブに

進むことができます。

5. ［MDX クエリー］タブをクリックします。

6. MDX クエリーをこのタブに入力します。ベースとなる MDX クエリーを別のアプリケーションから切り

取って、このタブに貼り付けることもできます。

7. ［変数］タブをクリックします。MDX 文で生成される列ごとに、1 つの変数が TurboIntegrator によっ

て生成されます。

行見出しのある列は、一般にディメンション要素としてマッピングされます。データ要素のある列は、

データとしてマッピングされます。

28 IBM Cognos TM1


8. 「変数のマッピング」を参照して、変数を TM1 構造にマッピングします。ODBO データソースへの

接続と MDX 文の定義が終了すると、TurboIntegrator プロセスを完了する手順は、ODBC データ

インポートの場合と同じです。



30 IBM Cognos TM1


第4章：TM1のビューまたはサブセットからのインポート

IBM® Cognos® TM1® TurboIntegrator では、TM1 キューブビューからデータを抽出し、そのデータに基

づいて新しい TM1 オブジェクトを作成できます。TM1 ビューを使用するためのプロセスを構築する手順

は、インポート用に設計したデータのビューを初めに構築することを除き、他のデータソースを定義する

のに使用する手順に類似しています。

TM1キューブビューの中には、正しくインポートできないものもありますが、TurboIntegrator から特定の

パラメータを使用してビューを構築することで、インポート処理をいつでも正しく実行できるようになりま

す。

データソースとして TM1 キューブビューを使用データソースとして TM1® キューブビューを定義するには、データソースを定義してから（「キューブプ

ロセスの作成」（31 ページ）を参照）、テキストファイルのインポートで説明されている手順に従います。

キューブプロセスの作成

キューブビューをデータソースとして使用するプロセスを作成するには

手順


2. ［データソースタイプ］ボックスで［TM1］をクリックし、［キューブビュー］を選択します。［データソー

ス名］フィールドが表示されます。

3. 使用可能なビューの一覧から選択するために、［参照］をクリックします。［サーバーキューブビュー

の参照］ダイアログボックスが表示されます。

4. インポートするデータを持つキューブを選択します。

5. データソースとして使用するビューが既に存在する場合は、そのビューを選択します。

そのようなビューが存在しない場合は、［ビューを作成］をクリックし、［抽出の表示］ウィンドウを開い

てビューを作成します。ビューを作成したら、［サーバーキューブビューの参照］ダイアログボック

スでそのビューを選択します。

6. ［OK］をクリックします。

これにより、選択したビューが TurboIntegrator プロセスのデータソースとして表示されます。

テキストファイルのインポートで説明されている手順に従って、TM1® ビューのインポートを完了し

ます。

データソースとして TM1 サブセットを使用TurboIntegrator では、TM1 ディメンションサブセットからデータを抽出し、そのデータを別の TM1® オ

ブジェクトに移すことができます。次の例では、“Region”ディメンションの“Europe”集約が抽出され、

“Region_Europe”という新しいディメンションを構成するために使用されています。



ディメンションサブセットから情報を抽出するときのターゲットオブジェクトは、一般に別のディメンション

です。ディメンションサブセットから抽出した情報を基にキューブを構築することはできません。

TM1 サブセットを使用したデータ抽出の手順は、他の TurboIntegrator プロセスと類似しています。開

始するには、「データソースとしてディメンションサブセットを定義」（32 ページ）を参照してください。

データソースとしてディメンションサブセットを定義

ディメンションサブセットをデータソースとして使用するプロセスを作成するには、次の手順を実行しま

す。

手順


2. ［データソースタイプ］ボックスで［TM1］をクリックし、［ディメンションサブセット］を選択します。キュー

ブビューソースの定義に必要なフィールドが 1 つ表示されます。

3. 使用可能なサブセットの一覧から選択するために、［参照］をクリックします。

［サーバーサブセットの参照］ダイアログボックスが開きます。

4. インポートする要素が含まれるディメンションを選択します。

5. データソースとして使用するサブセットを選択し、［OK］をクリックします。


選択したディメンションサブセットの要素が、プレビューパネルに表示されます。

ディメンション変数の定義

TurboIntegrator で変数を識別し、定義する方法の詳細については、キューブ変数の定義を参照してく

ださい。

次の図に示す［変数］タブでは、“region”変数が要素として識別されています。

この例では、サブセットデータソースから抽出する要素が、“All Europe”という最上位集約の子として追

加されます。新しい集約を構築するには、次の手順を実行します。

手順

1. ［変数を新規作成］をクリックします。

［変数］タブに変数“V2”が表示されます。

2. ［数式］をクリックします。

［プロセス変数の数式］ダイアログボックスが開きます。

3. 数式を次のように修正します。

V2='All Europe';


5. “V2”の［変数の型］を［文字列］に変更します。

32 IBM Cognos TM1

第 4 章：TM1 のビューまたはサブセットからのインポート

6. “V2”の［コンテンツ］設定を［集約］に変更します。

次のセクションでは、サブセットデータソースからインポートされる要素を“All Europe”集約に追加

します。

ディメンション変数のマッピング

インポートされるデータを TM1® オブジェクトにマッピングする手順の詳細については、変数のマッピン

グを参照してください。

この例では、“Europe”という新しいディメンションを作成するために、［キューブ］、［ディメンション］、［集

約］の各タブを設定する必要があります。“Europe”には、“All Europe”という集約が 1 つのみあります。

キューブタブの設定

［キューブ］タブでは、次のオプションを設定します。

設定操作のタイプ

未対処キューブの操作

値の保存データ操作

ディメンションタブの設定

［ディメンション］タブでは、TM1® ディメンションに入れるデータをマッピングできます。この例では、

“Europe”というディメンションが 1 つのみ作成されます。［ディメンション］タブでは、次のオプションを設

定します。

設定オプション名

Europe要素の変数

Regionディメンション

作成操作

数値要素の型

集約タブの設定

前の手順で追加した“All Europe”変数が、［集約］タブに表示されます。［サンプル値］が、数式で指定

した値に設定されていることに着目してください。このプロセスに含まれる変数は 2 つのみなので、TM1®

は“region”変数を“V2”変数の子として正しく識別しています。［集約］タブの設定は、変更する必要があ

りません。

ディメンションの保存と実行

TurboIntegrator プロセスを保存して実行する方法の詳細については、TurboIntegrator プロセスの保存

と実行を参照してください。



プロセスを保存して実行すると、TM1® は、“Europe”という新しいディメンションを作成します。このディメ

ンションには、“All Europe”という集約が 1 つ含まれ、その集約にはヨーロッパのあらゆるの国に対する

リーフ要素が含まれています。

34 IBM Cognos TM1


第 5 章：MSAS からのインポート

IBM® Cognos® TM1® TurboIntegrator では、Microsoft® Analysis Services などの任意の OLE DB for

OLAP（ODBO）データソースからデータをインポートできます。このセクションでは、TurboIntegrator を

使用してMicrosoft Analysis Service からキューブとディメンションをインポートする方法を示します。

OLE DB for OLAP データソースOLE DB For OLAP データソースは、次のパラメータで識別されます。

● ODBO プロバイダ名

● ODBO の場所

● ODBO データソース

● ODBO カタログ

ODBO プロバイダ名

この名前は、多ディメンションデータベースサーバーを識別する ODBO プロバイダによって割り当てら

れます。例えば、TM1® は "TM1 OLE DB MD Provider" を使用し、Microsoft® Analysis Services は

"Microsoft OLE DB Provider for OLAP Services 8.0"を使用します。

TurboIntegrator には、サーバーにインストール済みの ODBO プロバイダのみが表示されます。

ODBO の場所

場所フィールドは、管理者によって ODBO プロバイダサービスの特定のインスタンスが割り当てられた

場所の名前です。

このフィールドの正確な解釈は、ベンダー固有です。

ODBO データソース

これは、管理者が特定の場所で一連のカタログに割り当てる名前です。Microsoft® Analysis Services の

場合は、これは登録されたサーバーの名前です。

ODBC カタログ

これは、管理者がデータベースの特定のコレクション（キューブ、ディメンションなどのオブジェクト）に割

り当てる名前です。Microsoft® Analysis Services の場合は、データベースの名前になります。

接続文字列：MSAS と TM1

TM1® OLE DB for OLAP プロバイダは修正され、プログラマが柔軟に接続文字列を作成できるように

なっています。このように修正されたのは、TM1 接続文字列に MSAS 接続文字列との互換性を持たせ

るためです。

以前のバージョンの TM1 の場合、TM1 OLE DB プロバイダ経由でログインするには、次のフィールドが

必要でした



設定例フィールド

MyServer場所

TM1 管理サーバーホストのマシン名。

SdataDatasource

TM1 サーバーの名前。

AdminuserID

TM1 ユーザー名。

Applepassword

TM1 ユーザーのパスワード。

上述のパラメータを使用することもできますが、次の表に示すパラメータを使用して、TM1 にログインす

ることもできます。このパラメータは、TurboIntegrator から Microsoft® Analysis Services に接続する場合

にも使用されます。

設定例フィールド

MyServerDatasource

TM1 管理サーバーホストのマシン名。

SdataCatalog

TM1 サーバーの名前。

AdminuserID

TM1 ユーザー名。

Applepassword

TM1 ユーザーのパスワード。

OLE DB for OLAP データソースへの接続（CAM 認証を使用する場合）

TM1® サーバーが Cognos Access Manager（CAM）認証を使用するように設定されている場合は、ODBO

データソースへの接続を確立する際に TM1 サーバーで使用される CAM ネームスペース ID を指定


32 ビットバージョンの TM1 サーバーを実行している場合は、TurboIntegrator の［接続］タブにある［そ

の他の接続パラメータ］セクションで CAM ネームスペースを指定できます。CAM ネームスペース ID

は、次の書式で指定する必要があります。

Provider String="CAMNamespace=<CAM Namespace ID"

＜CAM ネームスペース ID＞は、内部で使用する CAM ネームスペース ID です（ネームスペースの記

述名ではありません）。

36 IBM Cognos TM1


64 ビットバージョンの TM1 サーバーを使用している場合は、上述の書式と同じ書式に従って、接続文

字列で CAM ネームスペース ID を指定する必要があります。例えば、次の接続文字列では、NTLM_

NAMESPACE という CAM ネームスペース ID を指定しています。

Provider=TM1OLAP.1;Location=localhost;Data Source=empty;UserID=tm1user;Password="abc123";Provider String="CAMNamespace=NTLM_NAMESPACE";InitialCatalog=empty

64 ビットの TM1 サーバーを実行している場合は、TurboIntegrator のユーザーインターフェイスを使用

して CAM ネームスペースを指定することはできません。接続文字列を使用する必要があります。

MAS キューブのインポートこの手順では、単純なキューブを Microsoft® Analysis Services から TM1® にインポートする方法につい

て説明します。例えば次の表は、Analysis Services に表示されるキューブを表しています。

キューブ参照 - 販売

store2 全体store2

全時間(all time)時間(time)

測定レベル(MeasuresLevel)

店舗経費(store cost)店舗売り上げ(store sales)Country+

48,101.77120.160.84全顧客(all customer)

3,851.549.628.88Canada+

19,488.7348,622.07Mexico+

24,761.4961,909.89USA+

このキューブには、“time”、“store2”、“customer”、“measures”の 4 つのディメンションがあります。

Microsoft Analysis Services のキューブを TM1 にインポートするには

❑ MAS データソースへの接続を確立します。「TurboIntegrator による Analysis Services への接続」

（37 ページ）を参照してください。

❑ インポートするキューブを指定します。「［ODBC キューブのロード］タブによるキューブの指定」（38

ページ）を参照してください。

❑ ディメンションを定義します。「［キューブディメンション］タブの使用」（39 ページ）を参照してくださ

い。

❑ プロセスを保存して、実行します。「MAS プロセスの保存と実行」（40 ページ）を参照してください。

TurboIntegrator による Analysis Services への接続

TurboIntegrator を使用して、Microsoft® Analysis Services に接続するプロセスを作成します。

手順

1. TM1® Architect を実行し、有効なユーザー名とパスワードを使用してログインします。



2. ［プロセス］を右クリックし、［新規プロセスの作成］を選択します。

［TurboIntegrator］ダイアログボックスが開きます。

3. ［ODBO］オプションをクリックしてから、［キューブ］を選択します。

ダイアログボックスに、ODBO 接続文字列を作成するためのオプションが表示されます。

4. 接続パラメータを、ダイアログボックスに次のように入力します。

値フィールド

［Microsoft OLE DB Provider for OLAP Services］を選択します。ODBO プロバイダ

このパラメータは空白のままにします。ODBO の場所

Analysis Services をホストするサーバーのマシン名を入力します。ODBO データ

ソース

Analysis Services データベースの名前を入力します。例えば、Microsoft® サンプ

ルデータベースのデータをインポートする場合は、このフィールドにFoodMart 2000

と入力します。

ODBO カタログ

Analysis Services データベースに有効なユーザー名を入力します。ODBO ユーザー

ID

Analysis Services データベースのこのユーザー名に有効なパスワードを入力しま

す。

ODBO パスワード

ODBO サーバーの中には、他のパラメータも指定しなければ正しく接続できない

ものがあります。そのパラメータは、セミコロンで区切ってこのフィールドに入力しま

す。

その他の接続パラ

メータ

5. ［接続］をクリックします。正しく接続すると、［接続］ボタンがグレー表示になり、［ODBO キューブの

ロード］タブに進むことができます。

［ODBC キューブのロード］タブによるキューブの指定

［ODBO キューブのロード］タブでは、Analysis Services からインポートするキューブなどを指定できま

す。次の手順を実行して、このタブに必要事項を入力してください。

手順

1. ［ODBO キューブのロード］タブをクリックします。

2. キューブの操作を選択します。次の表で、この選択肢について説明します。


データとメタデータを ODBO データソースからコピーし、TM1® 内に新しいキューブを

作成します。このオプションは、インポートするキューブとディメンションが TM1サーバー

上に存在しない場合にのみ使用します。

キューブの

作成

38 IBM Cognos TM1



現存する TM1 キューブを破棄し、ODBO データソースのデータとメタデータを使用し

てキューブを再作成します。このオプションは、TM1 のキューブおよびディメンションが

存在し、その内容を新しい構造とデータで置き換える場合にのみ使用します。

キューブの

再作成

既存の ODBO キューブのデータをコピーし、既存の TM1 キューブに挿入ます。このオ

プションを実行しても、TM1 サーバー上のキューブとディメンションの構造は変更されま

せん。

キューブの

更新

この画面のデフォルト値。［未対処］を指定したプロセスは、キューブのデータやメタデー

タに影響しません。このオプションは、プロセスのテストとデバッグに使用します。また、

独自のカスタム操作を定義する場合にも使用してください。

未対処

この例では、［キューブの作成］を選択します。

3. ［ロード元の ODBO キューブを選択］をクリックし、TM1 にインポートする Analysis Services キュー

ブを選択します。

4. ［ロード先の TM1 キューブを選択］フィールドをクリックします。TM1 キューブの一意な名前を入力

します。

5. ［データ操作］パネルで、［値の保存］を選択します。このオプションを指定すると、ODBO キューブ

のセル値が TM1 キューブに書き込まれます。［値の累計］オプションを選択すると、インポートされ

る値と合算することができます。

［キューブディメンション］タブの使用

［キューブディメンション］タブでは、TM1® にインポートするディメンションをインポート時に操作できま

す。

デフォルトでは、ODBO キューブ内のすべてのディメンションがインポートされます。ディメンションは、＜

名前＞_ として TM1 内に作成されます。例えば、Analysis Services 内の“[customer]”ディメンションをイ

ンポートすると、TM1内で対応するディメンションは“Customer_”になります。

このダイアログボックスには、次のオプションがあります。

● ODBO ディメンションを、TM1 内の既存のディメンションにマッピングすることができます。それには、

［TM1 ディメンション］列でディメンションをクリックし、別の TM1 ディメンションを選択します。

● また、まったく新しい TM1 ディメンションに ODBO ディメンションの要素をインポートすることもでき

ます。［TM1 ディメンション］列で対応するセルをクリックしてから、新しいディメンションの名前を入力

してください。例えば、“customer_”ディメンションを“MyCustomerDim”というディメンションで置き換

えます。

● インポートするディメンションごとに、［TM1 ディメンションの操作］を選択する必要があります。次の

いずれかのオプションを選択してください。


ODBO キューブのディメンションデータをインポートして、そのディメンション内のす

べての要素を持つディメンションを TM1 内に新規に作成します。これはデフォルトの

操作です。

作成




ODBO キューブのディメンションデータをインポートし、その一部の要素を持つディ

メンションを TM1 内に新規に作成します。

フィルタのみ -

MDX

このディメンションは ODBO データソースからインポートしません。未対処

MAS プロセスの保存と実行

［キューブディメンション］タブの編集が終了したら、をクリックして、プロセスを保存し実行します。


新しいプロセスの名前を入力します。プロセスには、インポートするデータに関連する名前を付けてくだ

さい。この例では、「ODBO_Sales_Import」と入力します。

TM1® によってデータがインポートされ、新しいキューブが作成されます。ダイアログが表示され、イン

ポートの進捗状況が示されます。

MAS ディメンションのインポートこのセクションでは、Microsoft® Analysis Services のディメンションを TM1® にインポートする方法につい

て説明します。次の表は、Analysis Services に表示されるディメンションを表しています。

ディメンションメンバー

store2 全体O-

CanadaO+

MexicoO-

DFO+

GuerreroO+

JaliscoO+

VeracruzO+

YucatanO+

ZacatecasO+

USAO-

CAO+

またはO+

40 IBM Cognos TM1


ディメンションメンバー

WAO+

TM1 では、同じディメンション内の要素の名前はすべて一意であることが必要です。また、要素の別名

もすべて一意の名前であることが必要です。要素名を確実に一意にするために、インポートするディメン

ション内の集約と要素には、そのすべての親の名前を角かっこで囲み、ピリオドで区切った名前が付け

られます。

次の図に、TM1 にインポートされた後のストアディメンションを示します。

インポート後のサブセットの別名には、Analysis Services の要素名が設定されます。

MAS データをインポートする手順は、他のインポートプロセスと似ています。

MAS 接続パラメータの定義

Analysis Services のディメンションを TM1® にインポートするには、まず、Analysis Services に接続し、

［ODBO ディメンション］オプションを選択します。次の手順を実行してください。

手順

1. TM1 Architect を実行し、有効なユーザー名とパスワードを使用してログインします。

2. ［プロセス］を右クリックし、［新規プロセスの作成］を選択します。

［TurboIntegrator］ダイアログボックスが開きます。

3. ［ODBO］オプションをクリックしてから、［ディメンション］を選択します。

4. 接続パラメータを、ダイアログボックスに次のように入力します。

値フィールド

［Microsoft OLE DB Provider for OLAP Services］を選択します。ODBO プロバイダ

このパラメータは空白のままにします。ODBO の場所

Analysis Services をホストするサーバーのマシン名を入力します。ODBO データ

ソース



値フィールド

Analysis Services データベースの名前を入力します。例えば、Microsoft® サンプ

ルデータベースのデータをインポートする場合は、「FoodMart 2000」と入力しま

す。

ODBO カタログ

Analysis Services データベースに有効なユーザー名を入力します。ODBO ユーザー

ID

Analysis Services データベースのこのユーザーに有効なパスワードを入力します。ODBO パスワード

このフィールドは空白のままにします。その他の接続パラ

メータ

5. ［接続］をクリックします。接続ボタンがグレー表示になり、正しく接続されたことを示します。

［ODBO ディメンションのロード］タブの使用

Analysis Services に正しく接続したら、実行するディメンションロードプロセスでのコピー元とコピー先

のディメンションに関する情報を指定する必要があります。次の手順を実行してください。

手順

1. ［ODBO ディメンションのロード］タブをクリックします。

2. ［TM1 ディメンションの操作］を選択します。次のいずれかのオプションを選択してください。


ODBO データソースのディメンションをコピーして、新しいディメンションを TM1® に作成し

ます。

ディメン

ションの

作成

現存する TM1 ディメンションを破棄し、ODBO データソースのデータを使用してディメン

ションを再作成します。

ディメン

ションの

再作成

［ディメンションの更新］は、要素を挿入または削除するディメンションが TM1 に既に存在

していることを前提としています。

ディメン

ションの

更新 ● ODBO データソースには要素が存在し、TM1 には存在しない場合、その要素は、

TM1 ディメンションに追加されます。

● TM1 には要素が存在するが、ODBO データソースには存在しない場合、その要素は

インポートの影響を受けません。ローカルディメンション内の要素は、変更されません。

● 要素が ODBO データソースとローカルディメンションに存在する場合は、ODBO デー

タソースの要素がインポートされ、ローカルディメンション内に“＜要素名＞_1”として

作成されます。これにより、ローカルディメンションのサイズが大きくなることに注意して

ください。

42 IBM Cognos TM1



この画面のデフォルト値。このプロセスは、TM1 ディメンションに影響しません。未対処

3. ［ディメンションを含む ODBO キューブ］の一覧をクリックし、Analysis Services からインポートする

ディメンションが含まれるキューブを選択します。

4. ［キューブディメンション］の一覧をクリックし、インポートするディメンションを選択します。

5. ディメンションを更新または再作成する場合は、［ロードする TM1 ディメンション］の一覧をクリックし、

一覧からディメンションを選択します。

ディメンションを新しく作成する場合は、新しいディメンションの名前を［ロードする TM1 ディメンショ

ン］フィールドに入力します。

ディメンション MAS プロセスの保存と実行

［ODBO ディメンションのロード］タブの編集が終了したら、をクリックして、プロセスを保存し実行しま

す。


新しいプロセスの名前を入力してから、［保存］をクリックします。インポートが開始され、TM1®は、イン

ポート状況を示すダイアログボックスを表示します。

TM1 メッセージログ

プロセスが終了したときに、内部エラーが TM1® メッセージログに書き込まれる場合があります。その場

合は、メッセージボックスが開いて通知が表示されます。

TM1 サーバーのメッセージログをチェックするには、サーバーエクスプローラで［TM1 サーバー］を右

クリックし、［メッセージログの表示］を選択します。エラーの詳細を表示するには、TM1 メッセージログ

のエラーをダブルクリックします。



44 IBM Cognos TM1


第 6 章：SAP BUsiness Warehouse 用 TM1 Connectorを使用してデータをインポートする

IBM® Cognos® TM1® TurboIntegrator では、リモートファンクションコール（RFC）を使用して、SAP BW

からデータをインポートできます。このセクションでは、SAP 用 TM1 Connector を使用して TM1 にイン

ポートできる SAP オブジェクトと、そのインポート手順について説明します。また、TM1 データを ODS 表

を介して SAP に書き戻す方法についても説明します。

注：TurboIntegrator による SAP データへのアクセスは、SAP ライセンスに従って行う必要があります。

SAP オブジェクトと用語SAP BW のデータとメタデータを TM1® にインポートするには、その前に SAP システムと TM1 システム

の両方のデータ構造を十分に理解しておく必要があります。このセクションでは、SAP BW のデータをイ

ンポートする前に知っておく必要がある情報について説明します。

SAP と TM1 の類似オブジェクト

次の表に、対応するオブジェクトが TM1® にある SAP オブジェクト階層を示します。

TM1SAP

TM1 のディメンション。特性

TM1 キューブ内の数値データディメンション（キューブ内のデータによって測定される単位を定義）は、

SAP InfoCube の重要なデータ特性とまったく同じ性質を持っています。

ディメンション要素としてインポートされます。特性値

キューブとして TM1 にインポートされます。クエリー

キューブ

SAP 特性は、1 つまたは複数の階層を含むことができます。階層は、SAP ODBO プロバイダを通じて、

ディメンションとして TM1 にインポートされます。特性を TM1 にインポートする際は、特性内の階層を選

択できます。

階層

TM1 に、対応するオブジェクトはありません。ディメンション

例えば、SAP ではディメンションというオブジェクトが実装されます。SAP のディメンションは、特性のコレク

ションです。TM1 には、SAP のディメンションと性質が同じオブジェクトはありません。個々の特性は TM1

にインポートできますが、SAP のディメンションをインポートすることはできません。

SAP のオブジェクト階層

次の表に、SAP のオブジェクト階層と、それに類似する TM1® オブジェクトを示します。



TM1 のオブジェクトSAP のオブジェクト

キューブInfo Cube

キューブクエリーキューブ

キューブディメンション

ディメンション特性と重要なデータ

ディメンション階層

ディメンションの要素特性値

要素の別名表示属性：表示名

要素名表示属性：一意の名前

SAP BW ソフトウェア用 TM1 Connector の必要条件TurboIntegrator を実行して、SAP SAP BW からデータをインポートするには、ソフトウェアについて次の

前提条件を満たしている必要があります。

● SAP を実行するプラットフォームとオペレーティングシステムに固有な SAP ライブラリをインストール

している必要があります。最新の SAP ライブラリは、SAP Service Marketplace からダウンロードでき

ます。

● TM1® サーバーを実行するコンピュータ上に、“Saprfc.ini”ファイルがあることが必要です。

● 「SAP BW への TM1 インターフェイスのインストール」（48 ページ）の説明に従って、SAP BW 用

TM1® インターフェイスをインストールする必要があります。

Saprfc.ini ファイルと RFC ライブラリ“Saprfc.ini”ファイルと RFC ライブラリを使用できるようする方法は、次のセクションで説明するように、プ

ラットフォームごとに異なります。Saprfc.ini ファイルの詳細については、SAP ヘルプ Web サイトを参照し

てください。.

Microsoft Windows（x86）

Windows® プラットフォームの場合は、SAP から提供されるプラットフォーム固有の SAP RFC SDK にあ

るダイナミックリンクライブラリ（Librfc32.dll）および“Saprfc.ini”ファイルが必要です。

ダイナミックリンクライブラリをマシン上の任意のディレクトリに配置することもできますが、その場合はシ

ステムの PATH 変数にそのディレクトリが追加されていることが必要です。

“Saprfc.ini”ファイルは、TM1® サーバーを実行するマシン上であれば、任意の場所に配置できます。シ

ステム変数 RFC_INI を作成する必要があります（この変数には、“Saprfc.ini”ファイルの完全なパスを含

めます）。例：

RFC_INI = C:\Program Files\SAP_RFC_SDK\text\Saprfc.ini

46 IBM Cognos TM1

第 6 章：SAP BUsiness Warehouse 用 TM1 Connector を使用してデータをインポートする

x86 Microsoft® Windows® オペレーティングシステムで TM1 サーバーを実行する場合、同じシステムに

SAP GUI デスクトップクライアントをインストールすると、必要な SAP RFC ファイルはすべて自動的にイ

ンストールされます。さらに、SAP GUI を使用して接続を設定することもできます。

Microsoft Windows（x86、x64）

Microsoft Windows x86 および x64 プラットフォームでは、以下のファイルが必要になります。これらの

ファイルは、当該プラットフォームおよび SAP から入手できるバージョン対応の SAP RFC SDK（Software

Development Kit）に含まれています。

● SAP RFC SDK のサブフォルダにあるすべてのダイナミックリンクライブラリ（.dll）ファイル

● SAP RFC SDK に同梱されている"Saprfc.ini"ファイル

ダイナミックリンクライブラリファイル

SAP ダイナミックリンクライブラリファイルは、使用している SAP RFC SDK のバージョンによって異なり

ます。ダイナミックリンクライブラリをマシン上の任意のディレクトリに配置することもできますが、その場

合はシステムの PATH 変数にそのディレクトリを追加しておく必要があります。

"Saprfc.ini"ファイル

“Saprfc.ini”ファイルは、TM1® サーバーを実行するマシン上であれば、任意の場所に配置できます。シ

ステム変数 RFC_INI を作成する必要があります（この変数には、“Saprfc.ini”ファイルの完全なパスを含

めます）。次に例を挙げます。

RFC_INI = C:\Program Files\SAP_RFC_SDK\text\Saprfc.ini

UNIX（Sun Solaris、IBM AIX）

UNIX® プラットフォームの場合は、SAP から入手できるプラットフォーム固有のSAP RFC SDK にある、ブ

ランドおよびプラットフォーム固有のライブラリと“Saprfc.ini”ファイルが必要です。

ライブラリと“Saprfc.ini”は、TM1® サーバーを実行するマシン上であれば、任意の場所に配置できます。

特定のオペレーティングシステムに応じて SAP RFC ライブラリの場所を含めるために、次のシステム変

数のいずれかを変更する必要があります。

● LD_LIBRARY_PATH（Sun Solaris）

● LIBPATH（IBM AIX）

"Saprfc.ini"ファイルの完全なパスを示すように、RFC_INI 変数を更新する必要もあります。

Sun Solaris の例

次のように LD_LIBRARY_PATH と RFC_INI の変数を変更します。

LIBPATH=${LIBPATH}:$tm1_path:/usr/lib:/lib

LD_LIBRARY_PATH=${LD_LIBRARY_PATH}:$tm1_path:/usr/openwin/lib:/usr/lib://lib:/home/software/sap_rfc_sdk/lib

SHLIB_PATH={SHLIB_PATH}:$tm1_path:/usr/lib:/lib

RFC_INI=/home/software/sap_rfc_sdk/text/saprfc.ini

export SHLIB_PATH

export LD_LIBRARY_PATH

export LIBPATH

export TM1_PATH

export RFC_INI



IBM AIX の例

次のように LIBPATH と RFC_INI の変数を変更します。

LIBPATH=${LIBPATH}:$tm1_path:/usr/lib:/lib:/home/software/sap_rfc_sdk/lib

LD_LIBRARY_PATH=${LD_LIBRARY_PATH}:$tm1_path:/usr/openwin/lib:/usr/lib://lib

SHLIB_PATH={SHLIB_PATH}:$tm1_path:/usr/lib:/lib

RFC_INI=/home/software/sap_rfc_sdk/text/saprfc.ini

export SHLIB_PATH

export LD_LIBRARY_PATH

export LIBPATH

export TM1_PATH

export RFC_INI

SAP BW への TM1 インターフェイスのインストールインターフェイスをインストールする場合は、使用しているバージョンに対応する以下の出版物の説明に

従って行ってください。以下のファイルは、SAP BW ソフトウェアの TM1 Connector に含まれています。

● Installation_Guide_SyskoTM1_Release_70A_SP02.pdf (for BI 7.0)

● Installation_Guide_SyskoTM1_Release_10A_SP12.pdf (for BW 3.5)

SAP の InfoCube のインポートSAP InfoCube を TM1® にインポートすると、InfoCube の特性は TM1 のディメンションに変換されます。

その新しいディメンションを使用して、新しい TM1 キューブが作成されます。

SAP の InfoCube を TM1 にインポートするには

❑ SAP データソースへの接続を確立します。「SAP BW への接続の確立」（49 ページ）を参照してく

ださい。

❑ SAP データの特性を TM1 データ構造にマッピングします。以下を参照してください。

● 「TM1 キューブへの SAP InfoCube のマッピング」（50 ページ）.

● 「TM1 ディメンションへの SAP 特性のマッピング」（51 ページ）.

● 「特性の制限の設定」（53 ページ）.

● 「特性設定の選択」（55 ページ）.

❑ プロセスを保存して、実行します。「SAP TurboIntegrator プロセスの保存と実行」（56 ページ）を参

照してください。

❑ 出力を確認します。「結果の確認」（57 ページ）を参照してください。

48 IBM Cognos TM1


SAP BW への接続の確立

SAP からデータをインポートする場合や ODS 表にデータを書き込む場合は、まず、次の手順を実行し

て、SAP への接続を確立する必要があります。

手順

1. TM1 サーバーエクスプローラの左側のウィンドウで、［プロセス］グループを右クリックし、［新規プロ

セスの作成］を選択します。


2. ［データソースタイプ］ボックスで、［SAP］オプションをクリックします。

3. ［接続］タブに接続パラメータの値を入力します。

正しいパラメータ値は、社内の SAP 管理者に問い合わせてください。

注：SAP 接続パラメータの値にスペースが含まれる場合は、TurboIntegrator から SAP へ接続する

際に値を二重引用符で囲む必要があります。

例えば、Belfast BW System は有効な SAP システム名ですが、システム名を引用符で囲まずに

TurboIntegrator からそのシステムに接続しようとすると、その接続は失敗します。

説明パラメータ値

接続先の SAP システムの名前。システム名

システム名にスペースが含まれる場合は、名前を二重引用符で囲んでください。

SAP サーバーの UI バージョンに一致する数。たとえば、498 などです。クライアント数

SAP システムでの自分のユーザー名。ユーザー

SAP システムでの自分のパスワード。パスワード

SAP システムへのログオンに使用する言語。言語

テキストの説明は、すべてこの指定言語で返されます（その言語が可能な場合）。

言語パラメータは 2 文字の短縮形で、例えば EN=英語です。

SAP BW システムへの接続に使用するパラメータと値が他にあれば、入力します。その他の接続パラ

メータ



説明パラメータ値

SAP から TM1 に送信される各パケット内の行数を制限する値。パケットサイズを

小さくすると、小さなパケットによりネットワークトラフィックが増加します。パケットサ

イズを大きくすると、ネットワークトラフィックは減少しますが、1 転送あたりのパケッ

トが大きくなります。

パケットサイズ

デフォルトのパケットサイズは 50,000 です（これは、最小パケットサイズでもありま

す）。

4. ［接続］をクリックします。

TM1 キューブへの SAP InfoCube のマッピング

SAP の InfoCube を TM1® のキューブにマッピングするには、以下の手順を実行します。

手順

1. ［SAP］ソース一覧から［InfoCube］を選択します。

2. ［InfoCube］タブをクリックします。

3. SAP オブジェクトを TurboIntegrator で表示する際に、技術名と記述名のどちらで表示するかを指

定します。

SAP オブジェクトを技術名で表示するには、［SAP 技術名の表示］オプションを選択します。

SAP オブジェクトを記述名で表示するには、［SAP 技術名の表示］オプションをクリアします。

4. ［ロード元の InfoCube を選択］オプションをクリックし、TM1 にインポートする SAP InfoCube を選択

します。

［SAP 技術名の表示］を選択した場合は、 InfoCube が技術名順に並び替えられて最初の列に表示

されるとともに、InfoCube を容易に識別できるよう、対応する記述名も 2 番目の列に表示されます。

［SAP 技術名の表示］を選択していない場合は、InfoCubes は記述名によって並べ替えられ、技術

名は 2 番目の列に表示されます。

5. SAP InfoCube を既存の TM1 キューブにインポートする場合は、［ロード先の TM1 キューブを選択］

オプションをクリックし、SAP InfoCube のデータを受け取る TM1 キューブを選択します。

InfoCube のインポート時に新しい TM1 キューブを作成する場合は、その TM1 キューブの名前を

［ロード先の TM1 キューブを選択］フィールドに入力します。

6. ［TM1 キューブの操作］を選択します。

説明TM1 キューブの操作

SAP InfoCube のデータとメタデータをインポートして、新しいキューブを TM1 に作成

します。このオプションは、インポートするキューブとディメンションが TM1サーバー上

に存在しない場合にのみ使用します。

キューブの作

成

既存の TM1 キューブを破棄し、SAP InfoCube のデータとメタデータを使用してキュー

ブを再構築します。このオプションは、TM1 のキューブおよびディメンションが存在し、

その内容を SAP InfoCube の新しい構造とデータで置き換える場合にのみ使用します。

キューブの再

作成

50 IBM Cognos TM1


説明TM1 キューブの操作

既存の SAP InfoCube キューブのデータをインポートし、既存の TM1 キューブに挿入

します。このオプションを実行しても、TM1 サーバー上のキューブとディメンションの構

造は変更されません。

キューブの更

新

［未対処］を指定するプロセスは、TM1 キューブのデータやメタデータに影響しません。未対処

このオプションは、プロセスのテストとデバッグに使用します。また、独自のカスタム操作

を定義する場合にも使用してください。

7. ［データ操作］を選択します。

説明データ操作

このオプションを指定すると、SAP InfoCube のセル値が TM1 キューブに書き込まれ

ます。

値の保存

［キューブの更新］オプションが選択されている場合にこのオプションを選択すると、

InfoCube からインポートする値で既存の TM1 キューブ値が上書きされます。

［値の累計］オプションを指定すると、TM1 キューブの既存の値と SAP InfoCube から

インポートする値を合計することができます。

値の累計

このオプションは、［キューブの更新］操作を選択すると使用可能になります。ターゲット

キューブの一

部をゼロ設定このオプションを選択するのは、キューブビュー内のすべてのデータポイントをゼロ

に設定する場合です。

ゼロに設定するキューブビューは、次の手順で定義します。

● ［ビュー］の一覧をクリックし、ゼロにする既存のビューを選択します。

● ［ビュー］オプション一覧の横にある［詳細］ボタンをクリックし、ゼロに設定する新

しいビューを定義します。

8. SAP InfoCube のインポート時にキューブデータに対する変更点をログに記録するには、［キューブ

のログ記録を有効化］オプションを選択します。

インポート時のログ記録処理を無効にするには、［キューブのログ記録を有効化］オプションをクリア

します。

注：ログ記録を無効にすると、データのロードと更新に必要な時間は短くなりますが、システムエラー

が発生したときに更新内容を復元できなくなります。

TM1 ディメンションへの SAP 特性のマッピング

SAP 特性を TM1® ディメンションにマッピングするには、以下の手順を実行します。

手順

1. ［特性］タブをクリックします。



［特性］タブに表示された SAP 特性ごとに、「TM1 キューブへの SAP InfoCube のマッピング」（50

ページ）で説明している手順を実行します。続いて、［階層の選択］に進みます。

2. ［階層の選択］ボタンをクリックします。

［階層の選択］ダイアログボックスが開きます。

3. ［有効期限］の一覧をクリックし、評価日付を選択します。

選択した日付が、チェックマークが付いた状態で、［有効期限］領域に表示されます。

時間に依存する階層の中で、選択した日付の時点で存在していたものが TM1 にインポートされま

す。時間に依存しない階層は、プロセスの実行時点で存在していたものがインポートされます。

評価日付を選択しないか、［有効期限］オプションのチェックマークをクリアした場合は、TM1 プロ

セスの実行日に存在しているすべての階層がインポートされます。

4. TM1 にインポートする階層を選択し、［OK］をクリックします。

SAP 特性に階層が含まれていない場合は、［キャンセル］をクリックして、［階層の選択］ダイアログ

ボックスを閉じることができます。

重要：間隔がある階層は、TM1 にインポートすることができません。そのような階層をインポートしよ

うとすると、TurboIntegrator プロセスが失敗します。SAP 特性の内容を把握して、間隔を含む階層

はインポートしないようにすることが必要です。

5. 特性が既存の TM1 ディメンションに対応する場合は、［TM1 ディメンション］列をクリックし、特性に

対応するディメンションを選択します。

特性から新しい TM1 ディメンションを作成する場合は、ディメンションの名前を［TM1 ディメンション］

列に入力します。

特性を TM1 キューブにインポートしない場合は、［TM1 ディメンション］列を空のままにしておきま

す。

6. ［TM1 ディメンションの操作］を選択します。

説明ディメンションの操作

SAP 特性から新しい TM1 ディメンションを作成します。作成

SAP 特性からインポートした要素で、TM1 ディメンションを完全に作成し直します。再作成

SAP 特性からインポートした新しい要素を追加して、既存のディメンション構造を更新

します。

更新

TurboIntegrator で特性は処理しますが、その特性を使用して TM1 ディメンションを作

成または変更することはありません。

そのまま使用

このオプションは、プロセスのデバッグとテストに使用します。また、TurboIntegrator の

［詳細］タブで特性を操作する目的でも使用します。

SAP 特性は TM1 にインポートしません。TurboIntegrator で SAP InfoCube を処理す

るときに、特性は完全に除外されます。

ロードしない

7. ［属性の選択］ボタンをクリックします。

［特性の属性］ダイアログボックスが開きます。

52 IBM Cognos TM1


8. ［有効期限］の一覧をクリックし、属性の評価日付を選択します。

評価日付が選択されている場合は、その日付が［有効期限］オプションにチェックマーク付きで表

示され、時間に依存する SAP 属性の中でその指定日付に存在していたものがすべて TM1 にイン

ポートされます。時間に依存しない属性は、プロセスの実行時点で存在していたものがインポートさ

れます。


セスの実行日に存在しているすべての属性がインポートされます。

9. 次のいずれかを実行して、SAP 特性の各属性を TM1 属性にマッピングします。

● SAP 属性を新しい TM1 属性にマッピングするには、その SAP 属性の［TM1 属性］フィールド

に新しい TM1 属性の名前を入力してから、［属性の型］を選択します。TurboIntegrator プロセ

スを実行したときに、新しい TM1 属性が作成されます。

● SAP 属性を既存の TM1 属性にマッピングするには、その SAP 属性の［TM1 属性］フィールド

をクリックし、属性を選択してから、［属性の型］を選択します。

説明属性の型

属性を文字列値として識別します。テキスト

属性を数値として識別します。数値

属性が関連付けられるディメンションの別名として属性を識別します。この属性を使用する

と、TM1 ユーザーインターフェイスにディメンションを別名で表示できます。ディメンション

の別名は、他のディメンション別名や実際のディメンション名とは異なった名前であること

が必要です。

別名

次に、SAP の重要なデータを TM1 ディメンションにマッピングする必要があります。

重要なデータは、［特性］タブの最終行として表示されます。

10. ［重要なデータの選択］をクリックします。

［重要なデータの選択］ダイアログボックスが開きます。

11. TM1 にインポートする重要なデータを選択します。


13. 重要なデータを TM1 ディメンションにマッピングします。

重要なデータが既存の TM1 ディメンションにマップする場合は、［TM1 ディメンション］列をクリック

し、重要なデータに対応するディメンションを選択します。

重要なデータから新しい TM1 ディメンションを作成する場合は、ディメンションの名前を［TM1 ディ

メンション］列に入力します。

14. 上述の手順 5 の説明に従って、重要なデータに対する［TM1 ディメンションの操作］を選択します。

特性の制限の設定

TurboIntegrator プロセスにフィルタを作成すると、指定した制限範囲に特性が含まれるデータ値のみを

TM1® にインポートすることができます。



フィルタを作成するには：

手順

1. ［特性］タブの［制限］ボタンをクリックします。

2. ［制限］ダイアログボックスの［制限の追加］をクリックします。

新しい行がダイアログボックスに挿入されます。

3. ［SAP 特性］列のリストをクリックし、制限を定義する特性を選択します。

4. 一覧の［記号］列をクリックし、包含的な制限か、除外的な制限かを選択します。

制限の定義範囲内に含まれる値のみを TurboIntegrator プロセスでインポートする場合は、［包含］

を選択します。

制限の定義範囲外の値のみを TurboIntegrator プロセスでインポートする場合は、［除外］を選択し

ます。

5. ［オプション］列の中をクリックし、制限の演算子を選択します。

演算子は、次の表に示す 8 つの中から選択できます。

説明演算子

この制限は、指定された［下位値］に等しい値を持つ特性のみを探します。=

この制限は、指定された［下位値］より小さいかまたは大きい値を持つ特性のみを探しま

す。

< >

この制限は、指定された［下位値］より小さい値を持つ特性のみを探します。<

この制限は、指定された［下位値］より大きい値を持つ特性のみを探します。>

この制限は、指定された［下位値］以下の値を持つ特性のみを探します。< =

この制限は、指定された［下位値］以上の値を持つ特性のみを探します。> =

この制限は、指定された［下位値］と［上位置］の間に値が含まれる特性を探します（［下

位値］と［上位置］も対象）。

[ ]

この制限は、指定された［下位値］と［上位置］の外側に値がある特性を探します（［下位

値］と［上位置］も対象）。

] [

6. 制限の小さい方の値を［下位値］列に入力します。

7. 制限の大きい方の値を［上位値］列に入力します（入力が必要な場合）。

8. フィルタに追加するすべての制限について、手順 2 ～ 8 を繰り返します。


注：制限は、TurboIntegrator では検証されません。入力する制限が正確で SAP データに対して有

効であることはユーザーが確認する必要があります。

54 IBM Cognos TM1


単純なフィルタの例

次のフィルタの例には、制限が 2 つあります。 TurboIntegrator プロセスを実行すると、TM1® は、100 ～

500 の ZUNIQUE 特性値のみをインポートします。また、7 未満を除くすべての 0CALDAY 特性値もイ

ンポートされます。

上位値下位値オプションSgnSAP 特性

500100[ ]含めるZUNIQUE

7<除外OCALDAY

複合特性に関する重要な注意事項

複合属性の場合は、制限を別々に入力する必要があります。例えば、時間特性 0FISPER（会計期間）

は 0FISCVARNT（会計バリアント）に合成されるため、0FISCPER の複合要素キーは、K42007001 のよ

うに長さが 9 文字になります。会計期間を 2007 年の最初の 3 期間に制限し、会計バリアント K4 を使

用する場合は、次の 2 つの制限を定義する必要があります。

上位値下位値オプションSgnSAP 特性

1K4=含めるOFISCVARNT

20070032007001[ ]含めるOFISCPER

特性設定の選択

特性設定は、インポートする特性ごとにセキュリティ、集約、インポートされる別名などのオプションを管

理します。

インポートする SAP 特性ごとに、次の手順を実行します。

手順

1. 特性の SAP セキュリティ割り当てを TM1® にインポートする場合は、［セキュリティのインポート］オプ

ションを選択します。

SAP からキュリティをインポートするように選択すると、新しい TM1 ユーザーグループが作成され、

SAP で定義されたセキュリティ役割に基づいて、そのグループにディメンションセキュリティ権限が

割り当てられます。SAP のセキュリティモデルでサポートされている権限は「読み取り」と「なし」のみ

であるため、TM1 にもそれらの権限のみが作成されます。

例えば、Cost Center 特性の読み取りアクセス権を持つ Planner という役割が SAP システム内にあ

る場合、TurboIntegrator は、Planner という TM1 ユーザーグループを新規に作成し、そのユーザー

グループに、Cost Center 特性から作成または更新される TM1 ディメンションの読み取りアクセス

権を割り当てます。

2. 特性から作成される TM1 ディメンションに対して最上位の集約を作成する場合は、最上位集約の

名前を［上位集約］列に入力します。

作成される TM1 ディメンションには、入力した名前の集約が含まれることになります。例えば、［上

位集約］列に「Total」と入力すると、Total という名前の最上位集約がディメンションに含まれることに

なり、インポートされたすべての要素がその集約の子になります。



3. SAP 特性から作成するすべての要素について、生成される TM1 別名が確実に一意になるように指

するには、［テキストを一意にする］オプションを選択します。

SAP 特性を TM1 にインポートすると、特性値は TM1 ディメンションの要素になり、SAP 値の説明は

TM1 要素の別名になります。TM1 では、同じディメンション内の要素別名はすべて一意であること

が必要です。TurboIntegrator プロセスで、同じ別名を複数の要素に割り当てようとすると、エラーが

生成され、別名は作成されません。

［テキストを一意にする］オプションが選択されている場合、SAP の説明は検査されてから、インポー

トし TM1 の別名に変換されます。同じ説明を使用する値が複数あることが検出されると、値の名前

が説明の末尾に追加されて、一意な別名が生成されます。

例えば、次の表は、説明の同じ SAP 特性値が複数ある場合に、別名がどのように生成されるかを

示しています。

TM1 の別名SAP 値の説明SAP の特性値（TM1 の要素）

RegionRegionUS000

StateStateUS001

State US002StateUS002

State US003StateUS003

特性値 US000 の説明は Region です。この説明があるのはこの値のみであるため、TM1 は Region

を別名として割り当てます。値 US001、US002、および US003 は、SAP 説明がすべて同じ State で

す。State という説明を使用していることが TurboIntegrator プロセスで最初に検出される値（US001）

に別名 State が与えられます。説明が State の残りの値には、一意性を維持するために、説明名に

末尾に値の名前を追加して生成された別名が与えられます。

TurboIntegrator スクリプトを変更して、SAP 特性のインポート時に AttrPutS 関数で一意な別名を

挿入するようにすることも可能です。しかし、［テキストを一意にする］オプションを使用すると、一意

の別名を簡単に生成できます。その際、スクリプトの変更も必要ありません。

4. ［有効期限］列のボタンをクリックし、特性の評価日付を選択します。選択した日付とプロセスの実行

日との間に存在したすべての特性値が TM1 にインポートされます。

評価日付を選択しなかった場合のデフォルトは、TurboIntegrator プロセスが実行される日です。

SAP TurboIntegrator プロセスの保存と実行


手順

1. ［実行］ボタンをクリックします。

TM1® は、プロセスに名前を付けて保存するように指示します。



3. サーバーエクスプローラを開きます。キューブ“import_cube”が作成され、データが移入されていま

す。また、必要なディメンションもすべて作成されています。

56 IBM Cognos TM1


結果の確認

InfoCube を TM1® にインポートして、新しい TM1 キューブを作成するプロセスを定義すると、次の処理

が行われます。

● キューブに含めるよう選択した SAP 特性をインポートし、対応する TM1 ディメンションを作成するた

めのプロセスが、特性ごとに生成されます。

● 上述のディメンション作成プロセスを実行し、TM1 キューブを構築し、データ値をインポートするた

めのマスタープロセスが生成されます。

次の図に、“SAP import”というプロセスを作成して InfoCube を TM1 にインポートする場合に作成

されるプロセスを示します。

マスタープロセス

InfoCube に存在する

SAP 特性から

TM1 次元を

作成するプロセス

● SAP 特性から TM1 ディメンションを作成または更新するプロスを定義した場合、特性値はすべて

ディメンションの要素になります。

● SAP 値の技術名は、TM1 要素の名前になります。

● SAP 説明の名前は、TM1 要素の別名になります。

● SAP 特性の属性をインポートするように選択すると、新しいディメンション属性が作成され、SAP の

特性属性値に基づいて、属性値が割り当てられます。

● SAP 特性のセキュリティ情報をインポートするように選択すると、新しい TM1 ユーザーグループが

作成され、SAP で定義されたセキュリティ役割に基づいて、そのグループにディメンションセキュリ

ティ権限が割り当てられます。

SAP の特性のインポートSAP BW の特性は、TM1® のディメンションにインポートできます。特性をインポートする場合は、インポー

トする SAP 階層および属性を指定し、特性の SAP セキュリティ定義をインポートするかどうかを選択で

きます。

SAP から TM1 に特性をインポートするには、「SAP の InfoCube のインポート」（48 ページ）で説明てい

る手順に従い、マッピングを行う方法についての説明は「TM1 ディメンションへの SAP 特性のマッピン

グ」（58 ページ）を参照してください。



TM1 ディメンションへの SAP 特性のマッピング

SAP 特性を TM1® ディメンションにマッピングするには、以下を実行します。

手順

1. ［SAP］ソース一覧から［特性］を選択します。

2. ［特性］タブをクリックします。

3. システム上の SAP 特性を技術名で表示するには、［SAP 技術名の表示］オプションを選択します。

システム上の SAP 特性を記述名で表示するには、［SAP 技術名の表示］オプションをクリアします。

4. ［SAP InfoCube］オプションをクリックし、TM1 にインポートする特性が含まれる SAP InfoCube を選

択します。

5. ［ロード元の SAP 特性］オプションをクリックし、TM1 にインポートする SAP 特性を選択します。

6. 特性を既存の TM1 ディメンションにインポートする場合は、［ロード先の TM1 ディメンション］オプ

ションをクリックし、SAP 特性のデータを受け取る TM1 ディメンションを選択します。

特性のインポート時に新しい TM1 ディメンションを作成する場合は、その TM1 ディメンションの名

前を［ロード先の TM1 ディメンション］フィールドに入力します。

7. ［TM1 ディメンションの操作］を選択します。

説明ディメンションの操作

SAP 特性から新しい TM1 ディメンションを作成します。作成

SAP 特性からインポートした要素で、TM1 ディメンションを完全に作成し直します。再作成

SAP 特性からインポートした新しい要素を追加して、既存のディメンション構造を更新し

ます。

更新

SAP 特性は TM1 にインポートしません。ロードしない

この操作を選択するのは、プロセス定義は保存するものの、SAP 特性をインポートする

処理は実際には行わない場合のみです。特性のインポートが必要になった場合は、

［TM1 ディメンションの操作］を、後で（必要に応じて）［作成］、［再作成］、または［更新］

に変更できます。

8. 特性の SAP セキュリティ割り当てを TM1 にインポートする場合は、［セキュリティ設定の取得］オプ

ションを選択します。

SAP からキュリティをインポートするように選択すると、新しい TM1 ユーザーグループが作成され、

SAP で定義されたセキュリティ役割に基づいて、そのグループにディメンションセキュリティ権限が

割り当てられます。SAP のセキュリティモデルでサポートされている権限は「読み取り」と「なし」のみ

であるため、TM1 にもそれらの権限のみが作成されます。

例えば、Cost Center 特性の読み取りアクセス権を持つ Planner という役割が SAP システム内にあ

る場合、TurboIntegrator は、Planner という TM1 ユーザーグループを新規に作成し、そのユーザー

グループに、Cost Center 特性から作成または更新される TM1 ディメンションの読み取りアクセス

権を割り当てます。

58 IBM Cognos TM1


9. 特性から作成される TM1 ディメンションに対して最上位の集約を作成する場合は、最上位集約の

名前を［上位集約］ボックスに入力します。

10. ［階層の選択］ボタンをクリックします。

［階層の選択］ダイアログボックスが開きます。

11. ［有効期限］の一覧をクリックし、評価日付を選択します。

選択した日付が、チェックマークが付いた状態で、［有効期限］領域に表示されます。

選択した評価日付とプロセスの実行日との間に存在したすべての階層が TM1 にインポートされま

す。


セスの実行日に存在するすべての階層がインポートされます。

12. TM1 にインポートする階層を選択し、［OK］をクリックします。

SAP 特性に階層が含まれていない場合は、［キャンセル］をクリックして、［階層の選択］ダイアログ

ボックスを閉じることができます。

重要：間隔がある階層は、TM1 にインポートできません。そのような階層をインポートしようとすると、

TurboIntegrator プロセスが失敗します。SAP 特性の内容を把握して、間隔を含む階層はインポー

トしないようにすることが必要です。

13. ［属性の選択］ボタンをクリックします。

［特性の属性］ダイアログボックスが開きます。

14. ［有効期限］の一覧をクリックし、属性の評価日付を選択します。

選択した日付が［有効期限］オプションの下にチェックマーク付きで表示され、その評価日付とプロ

セスの実行日との間に存在したすべての SAP 属性が TM1 にインポートされます。


セスの実行日に存在するすべての SAP 属性がインポートされます。

15. 次のいずれかを実行して、SAP 特性の各属性を TM1 属性にマッピングします。

● SAP 属性ごとに、対応する TM1 属性名を入力してから、［属性の型］を選択します。

● クリックし、各 SAP 属性に対する既存の TM1 属性名を選択してから、［属性の型］を選択しま

す。

説明属性の型






が必要です。

別名

16. SAP 特性から作成するすべての要素において、生成される TM1 別名が確実に一意となるように指

定するには、［テキストを一意にする］オプションを選択します。詳細については、「「特性設定の選

択」（55 ページ）」を参照してください。



17. ［有効期限］の一覧をクリックし、特性の評価日付を選択します。選択した日付とプロセスの実行日と

の間に存在したすべての特性値が TM1 にインポートされます。

評価日付を選択しなかった場合のデフォルトは、TurboIntegrator プロセスが実行される日です。

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

SAP のセキュリティのインポートSAP の役割とユーザー名の両方を TM1® にインポートできます。SAP のセキュリティ定義をインポートす

ると、SAP の役割は TM1 のユーザーグループに変換され、SAP のユーザー名は TM1 ユーザーにな

ります。

注：SAP ユーザー名を TM1 にインポートしても、ユーザー名に対応するパスワードは TM1 にインポー

トされません。TM1 に得られた TM1 ユーザーのパスワードは空です。

SAP からセキュリティをインポートするには、「SAP の InfoCube のインポート」（48 ページ）で説明してい

る手順に従います。選択を識別するには「インポートする SAP セキュリティ定義の選択」（60 ページ）を

参照してください。

インポートする SAP セキュリティ定義の選択

インポートする SAP セキュリティ定義を指定するには：

手順

1. ［SAP］ソース一覧から［セキュリティ］を選択します。

2. ［セキュリティ］タブをクリックします。

役割とユーザー名を任意に組み合わせてインポートできます。

● ［役割フィルタ］文字列のみを指定すると、TM1® はそのフィルタ文字列に一致する SAP 役割

のみをインポートし、その役割に基づいて TM1 ユーザーグループを作成します。

● ［ユーザー名フィルタ］文字列のみを指定すると、そのフィルタ文字列に一致する SAP ユーザー

名のみがインポートされ、そのユーザー名に基づいて TM1 ユーザーが作成されます。

● ［役割フィルタ］文字列と［ユーザー名フィルタ］文字列の両方を指定すると、SAP の役割および

ユーザー名の中からそれぞれの文字列を満足するものがインポートされます。SAP の役割は

TM1 のユーザーグループに変換され、SAP のユーザー名は TM1 ユーザーに変換されます。

次に、TM1 ユーザーが、SAP での役割とユーザー名との関係に基づいて、該当する TM1 ユー

ザーグループに割り当てられます。

● ［役割フィルタ］ボックスと［ユーザー名フィルタ］ボックスを両方とも空のままにすると、SAP のす

べての役割とユーザーがインポートされます。

3. 役割フィルタを指定するには、検索文字列を［役割フィルタ］ボックスに入力します。

検索文字列には、任意の数の文字を表す % ワイルドカード文字を使用できます。

また、一覧をクリックし、特定の役割名を選択して TM1 にインポートすることもできます。

4. ユーザー名フィルタを指定するには、検索文字列を［ユーザー名フィルタ］ボックスに入力します。

検索文字列には、役割フィルタと同様に、% ワイルドカード文字を使用できます。


60 IBM Cognos TM1


セキュリティのインポート結果

SAP からセキュリティをインポートすると、SAP の役割はすべて TM1® ユーザーグループに変換され、

SAP のユーザー名はすべて TM1 ユーザーに変換されます。次に、TM1 ユーザーが、SAP での役割と

ユーザー名との関係に基づいて、該当する TM1 ユーザーグループに割り当てられます。

SAP の通貨データのインポートと換算SAP BW の通貨データは、TM1® のキューブにインポートできます。通貨のデータを受け取るキューブ

には、3 つのディメンションを含める必要があります。第 1 通貨（換算元通貨）、第 2 通貨（換算先通貨）、

そして通貨の換算方法です。

SAP から TM1 に通貨をインポートするには、「SAP の InfoCube のインポート」（48 ページ）で説明して

いる手順に従います。通貨をマッピングするには「TM1 のキューブおよびディメンションへの SAP 通貨

のマッピング」（61 ページ）を参照してください。

TM1 のキューブおよびディメンションへの SAP 通貨のマッピング

SAP の通貨データを TM1® のキューブおよびディメンションにマッピングするには、以下を実行します。

手順

1. ［SAP］ソース一覧から［通貨］を選択します。

2. ［SAP 通貨］タブをクリックします。

3. SAP の通貨および換算タイプの技術名を表示するには、［SAP 技術名の表示］オプションを選択し

ます。

記述名を表示するには、［SAP 技術名の表示］オプションをクリアします。

注：インポート処理時に作成される TM1 要素には、［SAP 技術名の表示］オプションの設定にかか

わらず、常に SAP 技術名が使用されます。

4. 通貨データを TM1 サーバー上の既存の 3 ディメンションキューブにインポートするには、［キュー

ブ名を入力］フィールドをクリックし、キューブを選択します。

SAP 通貨データを格納するキューブを新規に作成するには、キューブ名を［キューブ名を入力］

フィールドに入力します。

5. ［換算元通貨］フィールドをクリックし、SAP からインポートする第 1 通貨を選択します。

使用可能な通貨の一覧は、SAP システムで定義されている通貨を反映しています。

6. 隣の［ターゲットディメンション］フィールドで、SAP の通貨文字列を受け取る TM1ディメンションを

指定します。

7. ［換算先通貨］フィールドをクリックし、SAP からインポートする第 2 通貨を選択します。

使用可能な通貨の一覧は、SAP システムで定義されている通貨を反映しています。

8. 隣の［ターゲットディメンション］フィールドで、SAP の通貨文字列を受け取る TM1ディメンションを

指定します。

9. ［換算タイプ］フィールドをクリックし、第 1 通貨を第 2 通貨に換算する際の換算方法を選択します。

使用可能な換算タイプの一覧は、SAP システムで定義されている換算方法を反映しています。

10. 隣の［ターゲットディメンション］フィールドで、SAP の換算タイプを受け取る TM1ディメンションを指

定します。



SAP 通貨タブでのワイルドカードの使用

ワイルドカード文字列は、［SAP 技術名の表示］オプションが選択されている場合にのみ有効です。

［換算元通貨］、［換算先通貨］、［換算タイプ］の一覧から 1 項目を選択する代わりに、ワイルドカード文

字列を入力すると、一致するすべての項目を SAP から返すことができます。有効なワイルドカード文字

は % のみです。これは、0 文字以上の任意の文字列に一致します。

例えば、［換算元通貨］、［換算先通貨］、［換算タイプ］の各フィールドに 1 つのワイルドカード文字 % を

入力すると、SAP からすべての通貨と換算タイプが返されます。

% 文字は、他の文字と組み合わせて使用することもできます。例えば、［換算元通貨］フィールドに「EU

%」と入力すると、文字「EU」で始まるすべての通貨が返されます。また、［換算タイプ］フィールドに「001

%」と入力すると、文字「001」で始まるすべての換算タイプが返されます。

ワイルドカードを使用する場合は、指定したすべてのワイルドカード文字列に一致する SAP レコードの

みが TM1® にインポートされます。例えば、次の表に示すレコードが SAP ソースに含まれているとしま

す。

値換算タイプ換算先通貨換算元通貨

26.98000-EURX20010101EURRUB

3.54000-EURX20010101EURSAR

1.64110-200119970101USDDEM

［SAP 通貨］タブで、ワイルドカード文字列が下図のように使用されているとすると、返されるレコードはあ

りません。SAP ソースのレコードの中で、指定されたワイルドカード文字列のすべてに一致するものはあ

りません。

62 IBM Cognos TM1



通貨の結果

SAP の通貨データをインポートすると、次の処理が実行されます。

● 指定された 1 つの換算元通貨（ワイルドカード使用時は複数の通貨）が、指定されたターゲットディ

メンション内に要素として作成されます。

● 指定された 1 つの換算先通貨（ワイルドカード使用時は複数の通貨）が、指定されたターゲットディ


● 指定された 1 つの換算タイプ（ワイルドカード使用時は複数のタイプ）が、指定されたターゲットディ


● 通貨の値が、指定された TM1® キューブに書き込まれます。

次の図は、先に示した図のようにワイルドカードを使用して、すべての SAP 通貨データを TM1 にイン

ポートとして作成したキューブを示しています。“currency1”ディメンションおよび“currency2”ディメンショ

ンに作成された要素は、通貨コードとして容易に識別できます。タイトル要素“M”は、SAP の換算タイプ

です。




SAP テーブルのインポートTurboIntegrator を使用して SAP BW テーブルを TM1® キューブにインポートするには、「SAP の InfoCube

のインポート」（48 ページ）で説明している手順に従います。それ以外の場合は「SAP テーブルクエリー

の作成」（64 ページ）および「変数の識別とマッピング」（64 ページ）を参照してください。

SAP テーブルクエリーの作成

SAP システム上に存在するテーブルに対してクエリーを実行するには：

手順

1. ［SAP］ソース一覧から［SAP テーブル］を選択します。

2. ［SAP テーブル］タブをクリックします。

3. クエリーする SAP テーブルの名前を［表名］ボックスに入力します。

4. ［フィルタ文字列］ボックスに、SQL フィルタ文字列を入力します。この文字列は、TurboIntegrator

で生成された SQL SELECT 文を SAP テーブルに対して実行するときに WHERE 句で使用されま

す。例えば、値が R110 の顧客のみを返すには「CUSTOMER = 'R110'」と入力します。

注：入力するフィルタ文字列に等号（=）がある場合は、その両側にスペースが必要です。等号のど

ちらかの側にスペースがない場合は、構文エラーになります。入力したフィルタ文字列に構文エラー

が 1 つでも存在すると、TurboIntegrator プロセスは中止されます。

CUSTOMER = 'R110' は、正常に実行されます。

CUSTOMER='R110' は、構文エラーになります。

フィルタ文字列を入力しなかった場合、生成された SELECT 文はテーブル全体を返します。

変数の識別とマッピング

SAP テーブルに対するクエリーが完了すると、TurboIntegrator はクエリー結果に基づいて一連の変数

を生成します（SAP テーブル内の列ごとに 1 つの変数が生成されます）。SAP テーブルからデータを正

しくインポートするには、各変数を識別してマッピングする必要があります。

変数を識別してマッピングする方法の詳細については、「データソースの変数の識別」を参照してくださ

い。

SAP への TM1 データの書き込みTM1® データは、トランザクション ODS 表にデータをエクスポートする TurboIntegrator プロセスを作成

して、SAP に書き込むことができます。ODS 表は、SAP 管理者が作成する必要があります。また、

TurboIntegrator プロセスを作成する前に、SAP 上に存在している必要があります。

ODS 表に TM1 データをエクスポートする処理が終了したら、SAP 管理者は標準の SAP 機能を使用し

て、ODS 表のデータを SAP InfoCube に移すことができます。SAP データを TM1にインポートし、その

データを TM1 から SAP にエクスポートして戻すサイクルは、ほとんどの場合、次の図のように行われま

す。

64 IBM Cognos TM1


SAP InfoCube

をTM1 にイン

ポート

TM1 内のデー

タを使用

ODS 表から

元の InfoCube

にデータ

を転送

TM1 キューブ

ビューを

ODS 表にエク

スポート

TM1 キューブビューから ODS 表にデータをエクスポートするには、データのインポート手順に従いま

す。ディメンションや値をマッピングするには、「TM1 ビューから ODS 表へのディメンションと値のマッピ

ング」（65 ページ）を参照してください

TM1 ビューから ODS 表へのディメンションと値のマッピング

TM1® キューブビューのディメンションと値を既存の ODS 表にマッピングするには、以下を実行します。

手順

1. ［SAP］ソース一覧から［ODS 表］を選択します。

2. ［ODS 設定］タブをクリックします。

3. ［TM1 ビューを選択］フィールドの横にある［参照］ボタンをクリックし、エクスポートするビューを選択

します。

ビューの名前を［TM1 ビューを選択］フィールドに直接入力することもできます。名前は、次の書式

で指定する必要があります。

<ServerName>:<CubeName>-><ViewName>

例えば、sdata1 サーバー上の“SalesCube”キューブの“Region”ビューをエクスポートする場合は、

次の文字列を使用することになります。

sdata1:SalesCube->Region

注：キューブビューから ODS 表へのエクスポートを実行する場合、キューブ内の最後のディメンショ

ンは数値データディメンションであることが必要です。キューブ内の最後のディメンションが数値デー

タディメンションでない場合は、キューブの値を ODS 表の重要なデータ列に適切にマッピングでき

ません。

4. SAP システム上の ODS 表を技術名で表示するには、［技術名を表示］オプションを選択します。

記述名を表示するには、［技術名を表示］オプションをクリアします。

5. ［ODS 表を選択］フィールドをクリックし、TM1 データをエクスポートする先の ODS 表を選択します。

ODS 表を選択すると、その表内のすべての列が［ODS 表の列］に表示されます。



列は、SAP の特性の場合と、重要なデータの場合があります。どの列が特性で、どの列が重要な

データかを判断するには、ODS 表の構造を十分に理解している必要があります。TurboIntegrator

では、ODS 表の列タイプは区別されません。

6. TM1 のディメンションを ODS 表の特性列にマッピングします。

ディメンションをマッピングするには、一覧をクリックし、表の対応する列にマッピングするディメンショ

ンを選択します。例えば、次の表は、TM1 ディメンション“account1”が表の列“0QUANTITY”にマッ

ピングされていることを示しています。

数値データを選択TM1 のディメンションODS 表の列

account1OQUANTITY

ディメンションを特性にマッピングする場合は、次の点に注意してください。

● ODS 表のすべての特性列にディメンションをマッピングする必要はありません。マッピングが終

了しても、対応する TM1 ディメンションがない列もあります。その場合は、エクスポートが終了し

たときに、マッピングされいない特性列は空になります。

● 1 つの TM1 ディメンションを ODS 表の複数の特性列にマッピングしないでください。

TurboIntegrator ユーザーインターフェイスではその操作も可能ですが、そのようなマッピング

を実行すると、ODS 表内の列値が重複することになります。

● TM1 ビューのタイトルディメンションを特性にマッピングするときに、タイトルディメンションが既

定のサブセットを使用していない場合は、現在の無名のタイトルサブセット内の最後の要素の

みが ODS 表にエクスポートされます。タイトルディメンションが既定のサブセットを使用してい

る場合は、すべてのサブセット要素が ODS 表にエクスポートされます。

7. TM1 の数値データディメンションを ODS 表のすべての重要なデータ列にマッピングします。

ソースキューブビューの最後のディメンションは、数値データディメンションとみなされます。数値

データディメンションを ODS 表の列にマッピングする場合は、［数値データを選択］ボタンが使用可

能になります。

次の表は、ODS 表の重要なデータ列“0QUANTITY”にマッピングされた“account1”ディメンション

を示しています。“account1”は TM1 キューブの最後のディメンションなので、［数値データを選択］

ボタンが使用可能になっています。


OAMOUNT

数値データを選択account1OQUANTITY

8. ［数値データを選択］ボタンをクリックします。

サブセットエディタが開きます。

9. ODS 表の重要なデータ列に直接対応する 1 つの要素を選択してから、［OK］をクリックします。

選択した要素が、［数値データを選択］ボタンのラベルとして表示されます。

66 IBM Cognos TM1



OAMOUNT

単位account1OQUANTITY

ODS 表に含まれる重要なデータ列が 1 つのみの場合は、重要なデータを別の方法（次のセクショ

ンで説明）でマッピングすることもできます。

10. ODS 表内のすべての重要なデータについて、手順 7 ～ 9 を繰り返します。

ODS 表に重要なデータ列が複数ある場合は、そのすべての列に TM1 の数値データディメンショ

ンをマッピングしてください。ただし、次に示すように、重要なデータに対して選択する要素が重複し

ないようにする必要があります。


Salesaccount1OAMOUNT

単位account1OQUANTITY

Priceaccount1OPRICE

重要なデータの代替マッピング手順

ODS 表に含まれる重要なデータ列が 1 つのみの場合は、［_TM1CellValue_］オプションを使用して TM1®

キューブの値を ODS 表にマッピングできます。ODS 表に重要なデータ列が複数ある場合は、［_

TM1CellValue_］オプションは使用できません。

［_TM1CellValue_］オプションを使用するには：

手順

1. 「TM1 ビューから ODS 表へのディメンションと値のマッピング」（65 ページ）の手順 1 ～ 6 を実行

します。

2. TM1 の数値データディメンションは、重要なデータ列にマッピングしません。その代わりに、［TM1

ディメンション］列をクリックし、［_TM1CellValue_］を選択します。

例えば、次の表は、キューブの値が重要なデータ列“0SALES_UNIT”にマッピングされていることを

示しています。

TM1 のディメンションODS 表の列

_TM1CellValue_OSALES_UNIT

account1OQUANTITY

この代替方法で TM1 キューブの値をマッピングする場合は、TM1 の数値データディメンションが

ODS 列にマッピングされていないことが必要です。




ODS の結果

実行が正常に終了すると、指定したマッピングに基づいて、指定した ODS 表に TM1® データが書き込

まれています。

68 IBM Cognos TM1


第 7 章：IBM Cognos TM1 Package Connector を使用してデータをインポートする

IBM® Cognos® では、TM1® Package Connector を使用して IBM Cognos BI パッケージへ接続すること

ができます。パッケージは、SAP Business Warehouse InfoQueries と InfoCubes に準拠しています。

TM1 Package Connector を使用して SAP BWベースパッケージをインポートするには、以下の3つの段

階があります。

● SAP BW クエリーを作成する。 InfoCube に直接インポートするすることができます。

● Framework Manager にパッケージを作成する。

● TM1 Package Connector を使用する TurboIntegrator プロセスを作成する。

このドキュメントでは、TM1 Package Connector の使用方法について説明します。このドキュメントの後

半では、SAP BW データを使用する際のガイドラインとFramework Manager でパッケージを作成する

について説明.します。これらの関連項目の詳細は、SAP ドキュメントと IBM Cognos Framework Manager

ドキュメントを参照してください。

IBM Cognos TM1 Package Connector は、メイン TM1 インストールディスクとは別の CD に収納されて

いるオプションのコンポーネントです。 TM1 Package Connector のインストールと設定についての詳細

は、『IBM Cognos TM1 Installation Guide』の「IBM Cognos TM1 Package Connector のインストール」を

参照してください。

Cognos BI サーバーへの接続を確立するコンポーネントをインストールして設定したら、以下の説明に従って接続を確立します。

手順

1. TM1 を実行します。

2. TM1 サーバーエクスプローラの左側のウィンドウで、［Processes］グループを右クリックし、［Create

New Process］を選択します。


3. ［Data Source Type］ダイアログボックスで、［IBM Cognos Package］オプションを選択します。

4. デフォルトで［Package］が選択されています。発行されたパッケージに接続するを参照してくださ

い。

1 つのパッケージの 1 つのディメンションから階層をインポートするだけの場合は、代わりに

［Dimension］を選択することができます。

5. 接続情報を入力します。

IBM Cognos BI サーバーが匿名ログインを許可されている場合は、［Log on］をクリックします。そう

でない場合は、ここにログオン認証情報を入力します。

● 認証ネームスペース

プルダウンリストには使用可能なすべての認証ネームスペースが表示されます。

● ユーザー ID とパスワード



選択した認証ネームスペースにユーザーのユーザー ID とパスワードを入力します。

● サインオン

TI プロセスに関連するサインオン情報を管理することができます。ボタンは、BI サーバーに正

常にログインすると有効になります。

「BI サーバーログオン」というサインオンが、最初の BI サーバーへの認証時に自動的に作成

されます。最初のログインの後に［Connection］タブの認証情報を更新する場合、これらの変更

はこのサインオンを更新しません。［Manage Signons］ダイアログボックスを使用してサインオン

の変更を行う必要があります。サインオンは追加、変更、および削除することができます。

匿名ログオンが無効な場合にサインオンを削除すると、TI を実行できなくなります。

ディメンションと数値データを使用する場合に、データソースのサインオンが作成される場合が

あります。 [Signons] ウィンドウからこれらを管理することができます。

● ログオン/ログオフ

［Log on］をクリックして、BI サーバーにログインします。ログインすると［Log off］が有効になり、

BI サーバーのログアウトが可能になります。

発行されたパッケージに接続する

BI サーバーに接続したら、使用するパッケージを選択します。

パッケージを選択した後に数値データをインポートしない場合は、［Dimension］タブに移動します。

手順

1. パッケージを検索します。

［Browse］ボタンをクリックして、使用可能なパッケージから選択します。選択にはディメンションがあ

るパッケージのみが使用できます。

［Browse Metadata］ウィンドウからパッケージを選択すると、［Select Package］フィールドに自動的に

入力されます。パッケージを選択した後、［Edit］ボタンが有効になります。

2. ［TM1 cube to load to］を選択します。キューブを作成する場合は、キューブ名を入力します。既

存のキューブを再作成するか、更新する場合は、一覧からそれを選択します。

3. 実行するインポート操作を指定します。

他のタイプのデータソースのようにこのインポートの必要に応じてキューブの操作とデータ操作を完

了します。これらオプションの詳細については、変数のマッピングを参照してください。

SAP BW ベースパッケージの場合は、データ抽出を速くするためにセグメンタプロンプトを使用す

る際に［Accumulate Values］を選択する必要があります。結果を確認します。

4. パッケージのディメンションを定義するには、［Dimension］タブをクリックします。

5. ［Select Hierarchies］または［Select Attributes］をクリックし、表示されたダイアログボックスを使用し

て階層と属性の構造を定義します。

階層と属性の以下の点に注意してください。

● デフォルト階層

階層を事前に選択しないで TM1 ディメンションを指定する場合は、TM1 は自動的にデフォル

ト階層として最初の物を選択します。チェックボックスを選択または選択解除して選択を変更す

ることができます。

● マッピングの前の選択

70 IBM Cognos TM1


TM1 ディメンションにマッピングする前に階層とフィルタなどのすべてのサブ項目を選択するこ

ともできます。事前選択された階層ディメンション上の TM1 ディメンションに入力する場合、す

べての選択が自動的に適用されます。フィールドの TM1 ディメンション名をクリアしてマッピン

グされたディメンションを選択解除すると、対応するディメンションの下にある事前選択された階

層すべてが自動的にクリアされます。

● 名前と参照

指定した階層を明確に識別できるように、階層は階層名と階層参照を表示します。階層名は

繰り返されますが、階層参照は一意です。

● フィルタ

パッケージにフィルタが定義され、階層が選択されると、［Select Filters］ボタンが有効になり、

それを使用して適用するフィルタを選択します。

フィルタが選択した階層に適切であることを確認してください。適切でない場合はクエリーが実

行できない場合があります。

● 階層内の複数のレベル

IBM Cognos では、1 つの階層に複数のレベルを定義することができます。階層に複数のレベ

ルを定義する場合、属性名を各レベル全体で繰り返すことができます。

上記例では、”City”ディメンションには”City”、”Geography”、”Geography_link”などが含まれ

ています。各階層は複数のレベルを定義します。



上記例で、レベルラベル、ラベル番号、階層の一意名などは、各階層の下にある各レベル全体が

同じになります。 TM1 は、2つの要因である属性外部名と属性ロールに基づいて属性の集約を実

行します。

優先順位は、属性外部名、属性ロールの順になります。属性に同じ属性外部名値が含まれている

場合は、それらの属性は集約されます。

属性に外部名がない場合は、そのロールシグネチャ (すべてのロールがロールシグネチャに合成

する場所) が、集約の要因として評価されます。

TM1 属性マッピングを指定する場合は、インポート中に外部名やロールシグネチャがマッピングさ

れた TM1 属性に一致するすべての属性が選択されます。複数の属性をマッピングすることができ

ます。

6. 属性の選択

ディメンション属性を TM1 属性にマッピングする場合は、以下のいずれかを実行します。

● 属性を新しい TM1 属性にマッピングするには、その SAP 属性の［TM1 Attribute］フィールド

に新しい TM1 属性の名前を入力してから、［Attribute Type］を選択します。TurboIntegrator

プロセスを実行したときに、新しい TM1 属性が作成されます。

● 属性を既存の TM1 属性にマッピングするには、その SAP 属性の［TM1 Attribute］フィールド

をクリックし、属性を選択してから、［Attribute Type］を選択します。

説明属性の型






が必要です。

別名

72 IBM Cognos TM1


数値データを TM1 ディメンションにマッピングする必要があります。

数値データが、［Dimensions］タブの最終行に表示されます。

数値データを選択するには、［Select Measures］をクリックします。 TurboIntegrator は数値データの

デフォルトがないので事前に選択しません。

7. ［Select Measures］をクリックします。

［Select Measures]ダイアログボックスが開きます。

注：パッケージには複数の数値データディメンションがある場合があります。数値データの名前は、

パッケージの数値データディメンション名を含んでいます。

8. TM1 にインポートする各数値データを選択します。

9. ［Filters］をクリックして数値データクエリーに適用するフィルタを選択します。フィルタが選択した階

層に適切であることを確認してください。適切でない場合はクエリーが実行できない場合があります。


11. 数値データを TM1 ディメンションにマッピングします。

数値データが既存の TM1 ディメンションにマッピングする場合は、［TM1 Dimension］列をクリックし、

数値データに対応するディメンションを選択します。

数値データから新しい TM1 ディメンションを作成する場合は、ディメンションの名前を［TM1

Dimension］列に入力します。

12. 数値データで［TM1 Dimension Action］を選択します。

13. ディメンション設定

［Dimension settings］タブを使用して、指定したディメンションに上位集約を定義します。

14. プロンプトの編集

［Prompts］ボタンをクリックして、Cognos プロンプト編集ウィンドウを開いてプロンプトの値を設定して

変更します。 SAP BW 変数が IBM Cognos パッケージのプロンプトとして表示されます。必須のプ

ロンプトがパッケージにある場合は、TI がクエリーを実行する前にプロンプト値を入力する必要があ

ります。そうしないと処理が失敗します。

［Prompts］ボタンを使用して、UI を使用して値や範囲を設定できるようにします。値列の下のセル

をクリックしてプロンプト値を設定します。



または、以下の TI API を使用することができます。

プロンプト名を知っている場合は、プロンプト名と値を渡して CGAddPromptValues を直接呼び出す

ことができます。これらの関数は親 TI のプロローグに入力する必要があります。

これらの関数は TI で定義されているプロンプトを取得します。下にある TI プロセスにそれらを定

義するには、TI にプロンプトウィンドウが起動されている必要があります。［Prompts］をクリックし、

定義されたクエリーすべてからプロンプトをプルして［OK］をクリックし、これを使用できるようにしま

す。

説明TI API

設定する必要があるプロンプトの合計数を返しますCGPromptSize()

インデックス (0-(CGPromptSize()-1)) のプロンプトを返しますCGPromptGetNextMember(int index)

プロンプト名を指定してプロンプト値を設定しますCGAddPromptValues(promptName, value 1, value 2...)

count=CGPromptSize(); while(i<count); prmptname=CGPromptGetNextMember(i); CGAddPromptValues(prmptname, ’1999-01-01’,’2009-01-01’); i=i+1; end;

例

15. マッピングされたディメンション、階層、および数値データがある場合、［クエリーをテスト］をクリックし

てクエリーをテストすることができます。

［クエリーをテスト］は、TI が実行する前にクエリー実行をトリガーします。クエリーが正常に実行す

るかどうか事前テストしたり、見つからないプロンプト値やサインオン情報を入力する際に使用するこ

とができます。

16. ［Show Namespace］チェックボックスをクリックして、ディメンション一覧にネームスペースを追加しま

す。

17. 必要に応じて［Advanced］タブと［Schedule］タブに記入します。詳細については、詳細プロシージャ

と日課の編集を参照してください。 Package Connector は、各ディメンションで TI プロセスも生成し

ます。これにより、必要に応じて独自の TI スクリプトステートメントを自由に追加できます。

18. TI プロセスを保存して実行します。 TurboIntegrator プロセスの保存と実行を参照してください。

74 IBM Cognos TM1


1 つのディメンションのインポート

［データソース］タブのディメンションプルダウンオプションを使用すると、簡単に 1 つのディメンション

を定義することができます。 IBM Cognos Package オプションプルダウンから［Dimension］を選択し、

［Dimension］タブを直接開いて、実行する操作と階層を定義する操作を指定します。

手順

1. パッケージを検索します。

［Browse］ボタンをクリックして、使用可能なパッケージから選択します。

2. ［Dimension to load from:］を指定します。

プルダウンリストには選択したパッケージで使用可能なディメンションが一覧表示されます。

3. ［TM1 Dimension to load into:］を指定します。

既存のディメンションを更新する場合は、プルダウンに使用可能なディメンションが一覧表示されま

す。

4. 他のデータソースのように［TM1 Dimension Action］を選択します。詳細については、ディメンション

のマッピングを参照してください。

5. ［Top Consolidation］を指定します。

TM1 ディメンションの上位レベル集約を作成する場合は、最上位集約の名前をここに入力します。

作成される TM1 ディメンションには、入力した名前の集約が含まれることになります。例えば、［Top

Consolidation］に「Total」と入力すると、集約の子としてインポートされたすべての要素と共に「Total」

という名前の上位レベルの集約がディメンションに含まれることになります。

6. プロンプトの指定についての詳細は、SAP BW クエリーに分割プロンプトを指定するを参照してくだ

さい。

7. マッピングされたディメンション、階層、および数値データがある場合、［Test Queries］をクリックして

クエリーをテストすることができます。

［Test Queries］は、TI が実行する前にクエリー実行をトリガーします。クエリーが正常に実行するか

どうか事前テストしたり、見つからないプロンプト値やサインオン情報を入力する際に使用することが

できます。

TurboIntegrator プロセスの保存と実行プロセスを保存して実行するには、以下を実行します。

手順

1. [Execute]ボタンをクリックします。

プロセスに名前を付けて保存するプロンプトが表示されます。

2. プロセスを保存します。

プロセスが正しく実行されたことを示す確認画面が表示されます。

3. サーバーエクスプローラを開きます。指定したキューブが作成および格納され、必要なすべての

ディメンションが作成されていることを確認します。



結果の確認パッケージを TM1 にインポートして、新しい TM1 キューブを作成するプロセスを定義すると、次の処理

が行われます。

● キューブに含めるよう選択した各ディメンションで、ディメンションをインポートするプロセスを生成し、

対応する TM1 ディメンションを作成します。

● 上述のディメンション作成プロセスを実行し、TM1 キューブを構築し、データ値をインポートするた

めのマスタープロセスが生成されます。

次の図に、“SAP import”というプロセスを作成して InfoCube を TM1 にインポートする場合に作成

されるプロセスを示します。

マスタープロセス

InfoCube に存在する

特性からTM1 ディメ

ンションを作成するプ

ロセス

● 階層のレベルのキーとして定義されたクエリー項目は、TM1 要素名として使用されます。

SAP BW データを使用する際のガイドラインFramework Manager で作成された SAPベースパッケージを使用する場合の特殊集約があります。 SAP

クエリーの作成、Framework Manager での SAPベースパッケージの作成、および TM1 での使用方法

についての詳細は、Framework Manager でパッケージを使用して SAP BW データを使用するを参照

してください。 Framework Manager でのパッケージの作成の詳細については、『Framework Manager

ユーザーガイド』の「パッケージの作成または変更」を参照してください。

Framework Manager でパッケージを使用して SAP BW データを使用する

Framework Manager で作成して Content Manager に発行した SAPベースパッケージを使用して、IBM

Cognos TM1 Package Connector の SAP BW データを利用することができます。この方法を使用して

SAP BW データを使用することをお勧めします。 Framework Manager で作成された SAPベースパッ

ケージを使用する場合の特殊集約があります。

TM1 Package Connector を使用して SAP BW クエリーソースからディメンションとファクトデータの両方

をインポートすることができます。 SAP BW キューブを IBM® Cognos® TM1® キューブとして再構築する

方法について、以下で説明します。その場合は、SAP BW クエリーパッケージを特殊な形式にする必

要があります。

IBM Cognos を使用してディメンションとファクトの両方へアクセスする SAP BW クエリーをインポートする

には、以下の 3 つの段階があります。

● SAP Business Explorer Query Designer で BW クエリーを作成する

● Framework Manager でパッケージを作成する。

76 IBM Cognos TM1


● TM1 Package Connector を使用する TI プロセスを作成する。

制限

● この展開プロセスは SAP BW データのみに制限されています。

● データソースは SAP BW データソースで定義されている明確に構築されたクエリーでなければな

りません。

パッケージの作成の詳細については、『Framework Manager ユーザーガイド』の「パッケージの作成ま

たは変更」を参照してください。

SAP Business Explorer Query Designer で BW クエリーを作成する

インポートするキューブを含むクエリーを作成する必要があります。データベースの1つの InfoCube の

クエリーに準拠することをお勧めします。複数のソースに基づくクエリーは、データ取得中に SAP BW

エラーを発生させる場合があります。

使用する Query Designer バージョンによって、使用する手順は異なります。

手順

1. ［Query Designer］で、［New Query］をクリックします。

2. ［New Query］ダイアログボックスで、インポートするキューブを含んでいる情報プロバイダを選択し

ます。

3. ［Tools］アイコンをクリックして、［InfoObject］の技術名を表示します。

4. インポートする特性を、左側の列の［InfoObject］カタログからページ右側のいずれかのフィールドに

ドラッグします。例えば、［Columns］または［Rows］です。

選択する特性は、キューブのメタデータを定義します。特性は以下の制限に従う必要があります。

● データ抽出要求を分割するためには、1つ以上の任意の変数が必要になります。実質的には、

通常の要求より高いスループットになる可能性があります。

● データソースを代表する特性を検索します。特性は、TM1 キューブの数値データか、TM1

キューブディメンションのディメンションのいずれかの重要なデータになります。

● 指定するか変数によって、表示階層にいずれの特性も割り当てないでください。



● SAP BW クエリーのすべての重要なデータは数値でなければなりません。

● ［Currency/Unit］の特性を選択しないでください。

● 選択したすべての重要なデータは同じ通貨を使用していることを確認します。

● TM1 Package Connector を使用して抽出する SAP BW クエリーに特性のみを含めます。不必

要な特性を含むとデータ量が増加し、パフォーマンスに影響を与えます。

● 特性は、クエリー定義の［Columns］または［Rows］フィールドにコピーする必要があります。

［Free Characteristics］または［Filter］フィールドにコピーすると、特性はパッケージからのイン

ポート時にディメンションとして表示されますが、分割されたデータ抽出が発生した場合に使用

されるストリーム抽出プロセスは値をフェッチできません。

● フィルタが定義されている場合は、クエリー定義のいずれかに含まれているディメンションのみ

を参照する必要があります。

● フリー特性を含む場合は、重要なデータの抽出の特性に表示される値はありません。フリー特

性のフィルタは、返された SAP BW データのフィルタのように動作します。 InfoCube のサブセッ

トを定義するフィルタとしてこれを使用することができます。

● クエリーでは、入力プロンプトでなく、選択リストプロンプトを使用します。選択リストプロンプト

は、データを分割するための値を入力します。

5. キューブを格納するメタデータを定義するには、含めるよう選択した各特性のプロパティを変更する

必要があります。特性を右クリックして、［Properties］を選択します。

6. ［Properties of Characteristic］ダイアログボックスで、［Display As］値を［Key］に変更し、［Suppress

Results Rows］値を［Always］に変更します。個々で適用した制限やフィルタは次回まで有効になり

ません。

7. 手順 4 で選択した各特性に対して、手順 5 ～ 6 を繰り返します。

注：必要な特性のみ選択してください。過剰なメモリ使用、システムパフォーマンスの低下や障害

を避けるためには、クエリーに含む特性を慎重に考慮してください。データ量が過剰かどうか確認

する場合は、SAP BW 管理者に問い合わせることをお勧めします。

8. ［Queries Properties］アイコンをクリックして、［Extended］タブから［Allow External Access to

this Query］チェックボックスを選択します。これは、クエリーを Framework Manager に公開します。

78 IBM Cognos TM1


9. ［Save］をクリックして、［Description］と［Technical Name］に新しいクエリーを入力します。［Technical

Name］フィルードには SAP BW の命名規則を使用することをお勧めします。直観的な名前や標準

の命名規則の先頭に文字「Z」を付けます。この技術名を書き留めておいてください。Framework

Manager でのクエリーの検索に必要になります。

詳細は、変数を作成を参照してください。 SAP Query Designerの使用についての詳細は、SAP BW ド

キュメントを参照してください。

変数を作成

クエリーの任意のプロンプトパラメータを作成できるようになったので、TM1 Package Connector はより

小さなクエリーを SAP に発行して、小さなチャンクの全体のデータセットを取得できます。このテクニッ

クは、データ量が SAP BW サーバーでエラーを発生する場合に使用する必要があります。

TM1 Package Connector で SAP BW ファクトデータを抽出するためのガイドライン

TM1 Package Connector で使用するための SAP BW データを抽出する場合の変数使用に対する規則

はありません。ただし、多すぎるデータ要求は避けてください。パフォーマンスが低下したり、SAP 環境

内にメモリ不足のメッセージが表示されてエラーの原因になります。

変数をデータ抽出の分割に使用すると、TM1 Package Connector はまず、変数が定義されるディメン

ションに存在するすべてのメンバをフェッチします。その後、TM1 Package Connector は個々のデータ

フェッチを実行し、変数を満たすためにディメンション内の個々のメンバのファクトデータを抽出します。

これにより、TM1 Package Connector はSAP BW サーバーが処理できる管理可能なチャンクにデータ抽

出を分割できるようになります。これを適用するディメンションについて設定されている標準はありませ

ん。最適なパフォーマンスを実現するには、SAP BW データを理解し、ファクトデータを均等に分割す

るディメンションを決定する必要があります。

変数を定義するディメンションを慎重に選択してください。最適なパフォーマンスを実現するには、いく

つか実験する必要がある場合があります。例えば、メンバーとして 3 つの国、”United States

(US)”、”Canada (CA)”、”Mexico (MX)”が含まれている [COUNTRY] ディメンションがあるとします。ほ

とんどの取引は US (90%) で、残りの取引 (10%) は”Canada”と”Mexico”で均等に分配されている場合、

このディメンションはデータを均等に分割にしません。クエリーの結果は、非常に大きな要求 1 つ (US)

と、2 つの小さな要求 (CA と MX) になります。従って、このディメンションは良い候補にはなりません。

多数の非常に小さな要求を発生する 1 つのディメンションに 1 つの変数を適用することは望ましくありま

せん。例えば、SAP BW 環境で良く使用されるディメンション [0MATERIAL] は、多数の小さな要求の

実行を発生させるので、良い候補にはなりません。

データの均等な分割に役立つ 10 件の異なるコストセンターのデータを均等に分割するディメンション

を [COSTCENTER] に定義したとします。適切に実行するセクションにデータを分割できるので暦年や

歴月は良い候補になります。

データ抽出のクエリーに変数を適用する必要はありません。抽出によっては、変数が適用されていない

場合に最適に動作します。

2 つの環境は違うので、式を適用することはできません。ただし、SAP BW 環境を妨害しないよう慎重に

扱ってください。

手順

1. ［Query Designer］で、前の手順で選択した特性を右クリックし、［Restrict］を選択します。

データを確実に均等に配布するには、キューブの代表で、大きな数の値にならない特性を選択しま

す。変数の各値の行数が類似した結果変数にしたい場合は、細かすぎる結果変数 (例えば、1 つ

の値当たりの行が少ないためにクエリーの数が極端に多くなる) や、粗すぎる変数 (例えば、1 つの

値当たりの行が 100 万以上)を避けるべきです。



2. [Selection for …]ダイアログボックスで、[Variables]タブをクリックして、[Description]ウィンドウ内の

任意の場所を右クリックして、[New Variable]を選択します。

注：既に選択されている特性の 1 つに変数がある場合は、新しい変数の作成を省略して手順 7 に

進みます。

3. [New Variable Wizard General Information]ページで、[Variable Name] と [Description]に入力し、

特性としてディメンションを選択します。［Next］をクリックします。

4. [Details]ページで、[Single Value]、[Multiple Single Values]、または[Interval] を[Variable Represents]

フィールドで選択し、[Optional]を[Variable entry is]フィールドで選択して[Ready for Input]チェック

ボックスを選びます。［Next］をクリックします。

5. [Default Values]ページで[Default Value]フィールドが空であることを確認します。

6. [Selection for …]ダイアログボックスに戻るまで[Next]をクリックします。新しい変数が[Description]

ウィンドウに表示されます。

7. 変数を選択して右矢印をクリックし、選択した変数を[Selection]ウィンドウに移動してクエリー

を保存します。これで Framework Manager でクエリーをインポートする準備完了です。

Framework Manager でパッケージを作成する

Framework Manager で必要なパッケージを作成するには

● ここで説明されたようにメタデータウィザードを使用して SAP BW メタデータをインポートします。

Framework Manager は SAP BW クエリーをモデルにインポートし、Content Manager へエクスポー

トするパッケージを定義します。

インポートしたら、以下の点に注意してください。

● SAP BW クエリーで選択したディメンションは、[Import]ダイアログボックスの[Dimension Folders]

で使用できます。

● 各ディメンションには1 つ以上の階層が含まれます。

● 階層に一致する名前の第 1 階層を常に選択してください。

● 他の階層が使用できる場合は、階層内の必要なレベル一式を提供するものを選択します。

80 IBM Cognos TM1


● Framework Manager は、設定パラメータが有効な場合にのみ SAP BW データからモデルに時

間ディメンションをインポートします。詳細については、SAP BW からメタデータをインポートす

るを参照してください。時間ディメンションとしての構成の設定は、グローバルエントリです。イ

ンポートされた各ディメンションは時間文字列として扱われます。

● パッケージを作成します。

Content Manager へ発行するためのパッケージを作成する場合は、2 つの階層をインポートしたこ

れらのディメンションの第 1 階層を非表示にします。第 1 階層は必須で、クエリーを正しく動作させ

るには、パッケージ中に存在する必要があります。表示したくない場合は、階層を非表示にするこ


SAP BW からメタデータをインポートする

SAP BW キューブのメタデータを FrameWork Manager のモデル定義にインポートする場合に、ディメン

ションが時間ディメンションかどうかが決まります。

正しく行うには、構成設定を設定する必要があります。デフォルトでは、値が設定されていません。

Framework Manager がインストールされた場所の下にある"configuration"ディレクトリには、SAP BW ア

クセスを制御する設定ファイルがあります。ファイル名は“sapbw_config.xml”になります。イントールで

は、このファイルを直接インストールしません。その代わりに、“sapbw_config.xml-sample”をインストール

します。 “sapbw_config.xml”が見つからない場合は、“sapbw_config.xml-sample”をコピーするか、“sapbw_

config.xml-sample”の名前を変更して作成します。

“sapbw_config.xml”には、次の行が含まれています。

<provider name="SAPBWODP"> <parameter name="UseStgDTypes" value="true"/>  <parameter name="UseFastGetMembers" value="true"/></provider>

“UseStgDTypes”に value = “true” があることを確認します。デフォルトでは、値は“false”になっていま

す。

これを実行してから、FrameWork Manager を起動し、SAP BW からメタデータをインポートしてモデルを

作成してください。

この変更によって、メタデータをインポートして「Dimension in the SAP BW」キューブのディメンションが

“Time”ディメンションであることを確認できるようになります。これは、ディメンションの最低レベルのメン

バに日付であるキー値があるディメンションです。

メタデータウィザードを使用してインポートする手順

1. Framework Manager で、[Create a new project]をクリックします。

2. [New Project]ダイアログボックスのフィールドを完了します。［OK］をクリックします。

3. [Metadata Wizard]に従って操作を完了します。データソースの選択を要求するプロンプトが表示

されたら、新しいデータソースを作成する必要がある場合は[New…]をクリックします。

4. [Select Objects]ページで、前の操作で SAP BW クエリーデザイナーで定義したクエリーを検索し

ます。変数を作成した時に入力した技術名にリストをスクロールします。フォルダの構造は、

Hierarchies > Level definitions > Query Item definitions のようになります。

5. レベルに直接関連するメインのクエリー項目を選択します。それは、(Key)、(Name)などラベル化さ

れたものです。

6. デフォルト値を使用して[Metadata Wizard]の残りの操作を完了し、[Next]をクリックします。ディメン

ションを生成して、メタデータをインポートします。

7. 最後のウィザード画面で結果を確認し、［Finish］をクリックします。

パッケージ作成手順

1. [Packages]フォルダをクリックして、[Actions]メニューから、[Create]、[Package]の順にクリックします。

2. [Provide Name]ページで、パッケージの名前を入力し、必要に応じて説明と画面のヒントを入力しま

す。［Next］をクリックします。

3. 前の画面でインポートしたクエリーを選択します。

4. [Define objects]ページで、パッケージから子オブジェクトを非表示または除外する場合は、それらを

個々に選択する必要があります。親オブジェクトを除外すると、そのすべての子も除外されます。

大きなキューブから多数のオブジェクトを除外 (または選択解除) するには、時間がかかります。

注：Framework Manager では ctrl+shift と alt+shift の機能が使用できます。これらキーのを使用し

て、キューに含めるか非表示する複数のオブジェクトを選択します。例えば、大きなブランチに 2

つの項目だけを含む場合は、ブランチ全体を選択し、ctrl+shift を使用して含む項目を選択解除し、

残りの選択されている項目を非表示にします。

オブジェクトの包含、除外、非表示についての詳細は、『Framework Manager ユーザーガイド』の

「パッケージの作成または変更」を参照してください。

5. パッケージにデフォルトのアクセス権限を使用するかどうかを、以下のように選択します。

● デフォルトのアクセス権限を使用する場合は、[Finish]をクリックします。

● アクセス権限を設定する場合は、[Next]をクリックします。

6. [Publish Package Wizard]を開くように要求されたら、[Yes]をクリックします。

7. デフォルト値を選択して、［Publish］をクリックします。これによりパッケージがコンテンツストアに発

行され、TM1 でパッケージへアクセスできるようになります。

8. 最後の画面で結果を確認して、［Finish］をクリックします。

TM1 でモデルを作成する準備が完了しました。パッケージ作成の詳細については、『Framework Manager

ユーザーガイド』の「パッケージの作成または変更」を参照してください。

SAP BW クエリーに分割プロンプトを指定する

ファクトデータの SAP BW データソースのクエリー時に分割プロンプトが使用されます。また BEx 変数

ともいわれる分割プロンプトは、クエリーがファクトデータの代表サンプリングを確実に取得できるように

します。

分割プロンプトには単一値、複数値、または範囲があります。範囲を選択する場合は、包含形式で、範

囲の最初と終了の値を含める必要があります。分割プロンプトは任意にする必要があり、デフォルト値

は指定されていません。

複数プロンプト、またはBEx 変数が許可されています。複数のプロンプトがある場合は、分割プロンプト

として 1 つを選択することができます。分割プロンプトはいずれのクエリーにも値を指定することはでき

ません。分割プロンプトとして指定されていない必須プロンプトでは値を指定する必要があります。分

割プロンプトとして指定されていない任意のプロンプトは、必要に応じて値を持ったり、持たなかったりし

ます。

手順

1. 階層と数値データを選択したら、[Prompts]をクリックします。

82 IBM Cognos TM1


2. データをセグメント化するプロンプトリストで、ファクトデータをセグメント化するプロンプトを選択しま

す。有効なプロンプトのみが一覧表示されます。

3. 分割プロンプトはデフォルト値が指定されていないことを確認します。ヒント：プロンプトの値をクリア

するには、現在のプロンプト値リストのプロンプトをクリックして、[Clear Value]をクリックします。

4. 現在のプロンプト値リストに表示されているすべての必須プロンプトに値が指定されているか確認

します。


分割プロンプトを使用して並行クエリーを実行するSAP BW ファクト抽出を分割するプロンプトを定義した場合は、TM1 Package Connector に参照を設定

してパフォーマンスを向上させることができます。

手順

1. TM1 Package Connector のインストールフォルダを検索して Configuration フォルダに移動し、テ

キストエディタで cogtr.xml ファイルを開きます (XML-アウェアエディタを推奨)。

2. ファイルの "Transformer" セクションに次のエントリを追加します。

<Preference Name="SegmenterParallelQueryCount" Value="16"/>

3. TM1 Package Connector が発行する並行クエリーの数値を設定します。デフォルトでは、一度に 1

つ発行します。

4. ファイルを保存します。

TM1 Package Connector は、指定する値に基づいて並行に数値データのクエリーを実行すること

ができます。例えば、月に関する InfoQuery 任意の変数を定義し、特性に 48 ヶ月が含まれている

とします。この変数を分割プロンプトとして数値データディメンションに指定します。 TM1 Package

Connector は並行して最大 16 クエリーを実行することができるので (各月ごとに 1 つ)、ファクトデー

タの抽出速度を大幅に改善できます。

SAP 管理者に相談して、データ抽出のクエリーが他のユーザーの SAP BW 環境に悪影響を与え

ないようにしてください。



84 IBM Cognos TM1


第 8 章：詳細プロシージャと日課の編集

このセクションでは、プロセスの自動実行をスケジュールする「日課」などの IBM® Cognos® TM1®

TurboIntegrator プロセスを管理する方法について説明します。

一括読み込みモードの使用一括読み込みモードでは、最適化された特別な単一ユーザー、または単一の日課/プロセスモードで

TM1® を実行できます。このモードは、他のアクティビティがほとんど、あるいはまったく予定されていない

場合に、専用タスクのパフォーマンスを最大限に引き上げることができます。

一括読み込みモードの使用例を以下に挙げます。

● メンテナンス操作を手動で実行する必要のある TM1 管理者。

● 大容量のデータを読み込む夜間帯。

TM1 は通常、複数のユーザー、日課、およびプロセスすべてが同時に TM1 データにアクセスして実行

できるマルチユーザーモードで実行されます。一括読み込みモードでは、TM1 サーバーは他のユー

ザー、日課、およびプロセスを一時的に停止して同時アクティビティを阻止するため、マルチユーザー環

境で必要な諸経費をなくすことができます。

一括読み込みモードは、実際にユーザーをログアウトするのではなく、TM1 とのやりとりを一時的に停止

するだけです。一括読み込みモードが終了すると、以前にログインしていたユーザー全員が再びアクティ

ブになり、TM1 とユーザーのやりとりが再開されます。

一括読み込みモードは TI プロセス内で直接、または TM1 API を使って有効にすることができます。ど

ちらの場合でも、コマンドを使用して一括読み込みモードを有効、無効にします。

一括読み込みモード使用時の注意

一括読み込みモードを使用する場合は、次の事項に注意してください。

● 一括読み込みモードでは、エンドユーザーへの警告メッセージは表示されません。一括読み込み

モードの使用を計画し、それに合わせて調整を行う必要があります。

● 一括読み込みモードでは、単一のユーザーまたはプロセスだけを有効にすることができます。一括

読み込みモード中は、サーバーへ新しい接続を確立することはできません。

● TI プロセスでは、再度同じ TM1® サーバーにログインするコマンドラインプログラムを起動するた

めに ExecuteCommand を使用することはできません。ログイン試行に失敗します。

● 一括読み込みモードが有効な期間中に実行するよう予定されているスケジュール済みの日課は無

効になり、実行されません。

一括読み込みモードの開始

サーバーが一括読み込みモードになると、他のスレッドによる処理はすべて一時停止されます。既存の

ユーザースレッドと実行中の日課は一時停止されます。一括読み込みモードを開始したスレッドのみが

有効なままになります。一括読み込モードを開始する日課以外のスケジュール済みの日課はすべて無

効になります。システム固有のスレッドと TM1Top 接続も一時停止されます。



一括読み込みモードの終了

一括読み込みモードが無効になると、すべてのシステムとユーザースレッドが再開され、ユーザーログ

インが可能になります。

TM1® API を使用して一括読み込みモードを有効にするカスタムアプリケーションは、必要な TM1® API

関数を呼び出して、一括読み込みモードを終了する必要があります。ただし、クライアント接続が切断さ

れている場合（ネットワークのエラー、クライアントのログアウト、またはクラッシュや接続切断による）、サー

バーは自動的に一括読み込みモードを終了します。

同様に、TI プロセス/日課を一括読み込みモードで実行している最中にプロセスが正常に終了するか、

エラーで終了すると、サーバーは自動的に一括読み込みモードを終了します。

サーバーが通常のマルチユーザーモードに戻ると、無効だった日課がすべて再度アクティブになり、通

常のスケジュールに戻ります。実行するようにスケジュールされた日課が一括読み込みモードで止めら

れていた場合は、即座には実行されませんが、スケジュールに従って実行されます。一括読み込みモー

ドが有効な期間中のロックアウトを防ぐには、スケジュールされた日課の実行時間の調整が必要な場合

があります。

一括読み込みモードの TurboIntegrator プロセスコマンド

TI プロセスの［プロローグ］または［エピローグ］セクションのいずれかから［一括読み込みモード］を有効

にすることができます。プロセスの［プロローグ］セクションの最初のステートメントまたは最初に非常に近

いステートメントで［一括読み込みモード］を有効にすると効率的です。

プロセスで［一括読み込みモード］を有効にすると、［エピローグ］セクションの最後の行でしか無効にで

きません。プロセスの他の場所で［一括読み込みモード］を無効にしようとすると、プロセスはコンパイル

しません。

モードが 1 つの TI プロセスで有効になると、明示的に無効になるまで、または日課が完了するまで有

効のままです。つまり、日課内のプロセスでモードを有効にして、無効にする前に連続した TI プロセス

を実行することができます。また、日課の特定の重要な部分に対してのみモードを使用して、［一括読み

込みモード］の入出を繰り返すこともできます。

TI プロセスで［一括読み込みモード］の有効/無効を切り替えるには、次の TI コマンドを使用します。

EnableBulkLoadMode()

DisableBulkLoadMode() - この関数は、［一括読み込みモード］を使用する際に、TI プロセスの［エピロー

グ］セクションの最後の行でのみ使用することができます。

一括読み込みモードの TM1 C API 関数

次の TM1® C API 関数は、［一括読み込みモード］の有効と無効をき切り替えるのに使用できます。

● TM1ServerEnableBulkLoadMode

● TM1ServerDisableBulkLoadMode

詳細については、『IBM Cognos TM1 API ガイド』を参照してください。

プロシージャの編集データソースを指定し、変数をすべて識別し、マッピング指示をすべて定義したら、［TurboIntegrator］

タブで選択したオプションに基づいて、4 つのプロシージャが生成されます。これらのプロシージャは、

［詳細］タブのサブタブになります。

86 IBM Cognos TM1


次のプロシージャがあります。

説明タブ

データソースを処理する前に実行する一連の文。プロローグ

処理中にキューブ、ディメンション、などのメタデータ構造体を更新または作成する一連の文。メタデータ

データソースの各レコードの値を操作する一連の文。データ

データソースを処理した後で実行する一連の文。エピローグ

これらのプロシージャを編集して TurboIntegrator 関数と TM1® 規則関数を記述すると、TurboIntegrator

の機能を拡張することができます。例えば、データプロシージャを編集すると、値がゼロのレコードをス

キップしたり、インポートしたレコードを外部ファイルに書き込んだりするようにプロセスに対して指示する

文を記述できます。

使用可能なすべての TurboIntegrator 関数と TM1 規則関数が記載された一覧は、『IBM Cognos TM1

参照ガイド』を参照してください。

プロシージャを編集するときは、各プロシージャはプロセス中の特定の時点で特定の操作を実行するよ

うに設計されているということを忘れないでください。したがって、作成する操作や文は、そのプロシージャ

に適したものにしてください。

注：プロセスのデータソースが［なし］の場合は、プロセスの実行時に、データプロシージャとメタデータ

プロシージャは無視されます。［データ］および［メタデータ］サブタブ上の関数や文は実行されません

が、プロセスの一部が実行されなかったことを示すエラーや警告は発行されません。

プロシージャを編集するには：

手順

1. ［詳細］タブをクリックします。

2. 編集するプロシージャのサブタブをクリックします。

3. 文をテキストボックスに入力します。次の行の前か、

#****GENERATED STATEMENTS START****

次の行の後ろに入力してください。

#****GENERATED STATEMENTS FINISH****



重要：ユーザーが作成する文は、生成された文の前または後ろに挿入できます。TurboIntegrator

によって生成された文の中に挿入することはできません。

オンデマンドでのプロセスの実行プロセスをオンデマンドで実行するには、サーバーエクスプローラでプロセスを選択し、［プロセス］ →

［プロセスを実行］を選択します。

TurboIntegrator から［ファイル］ → ［実行］を選択してプロセスを実行することもできます。

日課によるプロセスの自動実行スケジュールの作成プロセスは、オンデマンドで実行できます。また、日課を作成して、決まった間隔で実行することもできま

す。この 2 つの実行方法は、両方が同時に指定されてもかまいません。プロセスは、日課として自動実

行するようにスケジュール設定されている場合でも、オンデマンドでいつでも実行できます。

日課は、1 つ以上のプロセスをユーザーが定義した頻度で実行する TM1® のオブジェクトです。日課を

構成する要素は、次のとおりです。

● 実行するプロセスのリスト

● 日課を最初に実行する開始日時

● それ以降に日課を実行する頻度

定義した日課は、必要に応じて有効または無効にすることができます。

日課機能へのアクセス権は、ユーザーグループのセキュリティ権限によって制御されます。TM1 サー

バーに日課を作成するには、ADMIN または DataAdmin グループのメンバーであることが必要です。日

課をサーバーエクスプローラに表示したり、日課を手動で実行するには、日課の読み取り権限が必要

です。

プロセスを日課として自動実行するスケジュールは、TurboIntegrator から設定できます。

手順

1. ［TurboIntegrator］ウィンドウの［スケジュール］タブをクリックします。

88 IBM Cognos TM1


2. ［このプロセスのスケジュールに使用する日課名］オプションを選択します。

3. プロセスの名前を隣のフィールドに入力します。デフォルトでは、プロセスの名前が日課に割り当て

られます。

4. カレンダーの日付をクリックして、日課を初めて実行する開始日を指定します。

5. 時刻を入力して、日課を初めて実行するときの開始時刻を指定します。

6. ［日課の実行頻度］ボックスのフィールドにデータを設定して、日課の実行間隔を定義します。

7. ［ファイル］ → ［保存］を選択し、プロセスをスケジュール情報付きで保存します。

TurboIntegrator からプロセスのスケジュールを設定すると、その日課が自動的に有効になり、指定

した開始日時に実行されます。

プロセス（またはプロセスの集合）の日課は、サーバーエクスプローラから直接作成することもできま

す。

8. サーバーエクスプローラで、日課を作成するサーバーの下にある［日課］アイコンを選択します。

9. ［日課］ → ［新規日課の作成］を選択します。

［日課設定ウィザード］が開きます。

10. ［使用可能］の一覧で、日課を作成するプロセスを選択します。

11. クリックする項目



12. ［次へ］をクリックします。

13. カレンダーの日付をクリックして、日課を初めて実行する開始日を指定します。

14. 時刻を入力して、日課を初めて実行するときの開始時刻を指定します。

15. ［日課の実行頻度］ボックスのフィールドにデータを設定して、日課の実行間隔を定義します。

16. ［日課実行はアクティブです。］ボックスに必要事項を入力します。

17. ［終了］をクリックします。

［日課に名前を付けて保存］ダイアログボックスが開きます。

18. 日課の名前を入力し、［保存］をクリックします。

日課の開始時刻に関する重要な注意事項

日課の開始日時はグリニッジ標準時（GMT）形式で保存され、GMT に基づいて日課が実行されます。

TM1® では、夏時間への自動対応は行っていません。TM1 サーバー上のシステムクロックが、地域の

夏時間を使用するように設定されている場合は、夏時間が始まるときに日課の開始日時を編集しなけれ

ば、日課の実行スケジュールを同じ地域時間に保つことはできません。

夏時間が始まる日に、そのときの日付と希望する開始時刻を使用するように日課を編集してください。

夏時間が終わる日にも、同じように、そのときの日付と希望する開始時刻を使用するように日課を編集し

てください。

日課の編集

日課を開いて、日課設定ウィザードで編集するには：

手順

1. サーーエクスプローラの左側のウィンドウで日課を選択します。

2. ［日課］ → ［日課の編集］を選択します。

日課の有効化

現在無効になっている日課を有効にするには：

手順


2. ［日課］ → ［有効化］オプションをオンに切り替えます。

日課の無効化

定期実行するように設定されている日課スケジュールを一時的に停止するには：

手順


2. ［日課］ → ［有効化］オプションをオフに切り替えます。

90 IBM Cognos TM1


日課の削除

日課を削除するには：

手順


2. ［日課］ → ［削除］を選択します。

注：アクティブな日課は削除できません。日課を削除するには、その前に無効にする必要がありま

す。

オンデマンドでの日課の実行

日課をオンデマンドで実行するには：

手順


2. ［日課］ → ［実行］を選択します。



92 IBM Cognos TM1


付録 A：TurboIntegrator Tutorial

このチュートリアルでは、IBM® Cognos® TM1® TurboIntegrator の高度な機能を紹介します。

このチュートリアルは、組織内で TM1 の実装と利用計画の開発を担当するユーザーを対象としていま

す。通常は、TM1 の上級ユーザーや開発者が TM1 のキューブやディメンション、およびデータイン

ポートプロセスの作成、保守、および開発を担当します。このチュートリアルを進めるには、TM1 の概念

を十分に理解し、TM1 の機能について実践的な知識を持っている必要があります。

このチュートリアルでは、TurboIntegrator でディメンションとキューブを作成し、フラットファイルと ODBC

データソースをインポートする方法を示しています。また、詳細スクリプトの処理機能を使用して、

TurboIntegrator の機能を拡張する方法も説明されています。さらに、このチュートリアルには TM1

TurboIntegrator の問題に対処するためのヒントも記述されています。

チュートリアルのデータディレクトリの設定このチュートリアルでは、TM1 に付属するサンプルデータを使用しています。チュートリアルを開始する

前に、サンプルデータを参照するようにローカルサーバーのデータディレクトリを設定する必要があり

ます。

データディレクトリを設定するには：

手順

1. サーバーエクスプローラの左側のウィンドウで［TM1］をクリックし、［ファイル］ → [オプション]の順

に選択します。

［オプション］ダイアログボックスが開きます。

2. ［ローカルサーバーのデータディレクトリ］の［参照］ボタンをクリックし、TurboIntegrator のサンプル

データディレクトリに移動します。

サンプルデータディレクトリの名前は TI_data です。このディレクトリは“＜インストールディレクトリ

＞\Custom\TM1Data\”ディレクトリにあります。TM1 をデフォルトのインストールディレクトリにイン

ストールしている場合、このサンプルデータディレクトリの完全なパスは、“C:\Program Files\Cognos\

TM1\Custom\TM1Data\TI_Data”です。

3. ［オプション］ダイアログボックスの［OK］をクリックしてデータディレクトリを設定し、ローカルサー

バーを再起動します。

TurboIntegrator の概要TM1 TurboIntegrator を使用すると、データのインポート、メタデータの管理などのタスクを自動化するプ

ロセスを作成できます。

プロセスは、次の要素で構成される TM1 オブジェクトです。

● データソースの説明

● データソース内の各列に対応する一連の変数

● TM1 データベースの変数間の関係およびデータ構造を定義する一連のマップ

● プロローグプロシージャ（データソースの処理前に実行する一連の操作で構成されます。）



● メタデータプロシージャ（キューブ、ディメンションなどのメタデータ構造を更新または作成する一連

の操作で構成されます。）

● データプロシージャ（データソース内のレコードごとに実行する一連の操作で構成されます。）

● エピローグプロシージャ（データソースの処理後に実行されます。）

● プロセスを一般化し、異なる状況で使用できるようにするための一連のパラメータ。

TurboIntegrator を使用すると、ODBC ソース、ASCII ファイル、SAPベースデータ、OLAP 多ディメン

ションデータ、TM1 キューブビュー、および TM1 ディメンションサブセットからデータをインポートでき

ます。

TurboIntegrator には、プロセス機能を拡張する一連の関数が含まれています。この関数を使用して、

データを ASCII ファイルや ODBC ソースにエクスポートするスクリプトや、条件式を使用してプロセスを

制御するスクリプトを作成できます。このような TurboIntegrator 関数に加えて、プロセス定義には、STET

関数と UNDEFVALS 関数を除くすべての標準 TM1 規則関数も組み込むことができます。

TurboIntegrator へのアクセスは、ユーザーグループで管理されます。TurboIntegrator のすべての機

能を利用し、プロセスをネットワーク上の TM1 サーバーに定義するには、ADMIN グループのメンバー

であることが必要です。

TurboIntegrator 関数の作成を支援するインターフェイスはありません。関数は、［詳細］タブ内の適切な

サブタブに、直接手入力する必要があります。TurboIntegrator 関数に対する文字列引数は、一重引用

符で囲む必要があります。TurboIntegrator ウィンドウで各関数の末尾を示すには、セミコロン（;）を含め

る必要があります。

TurboIntegrator プロセスの作成プロセスは、5 つの手順で作成します。各手順は、［TurboIntegrator］ウィンドウのそれぞれのタブで、オ

プションを設定するか値を編集することで完了します。

プロセスの作成に必要な手順は、次のとおりです。

手順

1. データソースの定義

2. 変数の設定

3. データのマッピング

4. 詳細スクリプトの編集

5. 作成したプロセスのスケジュール設定

プロセスを作成するには、［TurboIntegrator］ウィンドウの各タブを順番に処理する必要があります。

作業中のタブに必要なすべての情報を指定しない限り、次のタブへは進めません。

TurboIntegrator を使用したディメンションの作成

TM1 TurboIntegrator を使用すると、ODBC、ASCII ファイルなどのいずれかのデータソースからディメ

ンションの要素一覧を作成できます。一覧の要素が膨大にある場合（カスタマディメンションに何千もの

名前があるような場合）は、この方法を使用すると最も速く一覧を作成できます。

サンプルの ASCII ファイル

次に、後でディメンションの構築とデータのインポートに使用する区切り付き ASCII ファイル（“example.

cma”）を示します。

94 IBM Cognos TM1


"New England", "Massachusetts", "Boston", "SuperMart", "Feb" , 2000000"New England","Massachusetts", "Springfield", "SuperMart", "Feb" , 1400000"New England", "Massachusetts","Worcester", "SuperMart", "Feb" , 2200000

このソースファイルの各レコードには 6 つのフィールドがあり、その中の 3 つを使用して“Example”ディ

メンションを作成します。最初の 2 つのフィールドは、集約要素になります。3 番目のフィールドは、数値

要素になります。残りのフィールドは無視されます。

“Example”ディメンションは、ディメンションエディタで次のように表示されます。

“Boston”、“Springfield”、および“Worcester”の数値は“Massachusetts”の合計に集約され、その合計

は“New England”の合計に集約されます。

ASCII ファイルからのディメンションの作成

サンプルファイル“example.cma”を使用してディメンションを作成するには：

手順

1. サーバーエクスプローラの左側のウィンドウで、ローカルサーバーの下にある［プロセス］を選択し

ます。

2. ［プロセス］ → ［新規プロセスの作成］を選択します。


3. ［データソースタイプ］で［テキスト］を選択します。

4. ［データソース名］の［参照］ボタンをクリックし、“TI_data”ディレクトリ内の“example.cma”を選択しま

す。

5. ［サーバー上のデータソース名］フィールドは空のままにします。

6. ［区切り記号の種類］を［区切り付き］に設定し、［区切り記号］を［カンマ］に設定します。

7. ［引用符］および［タイトルレコード数］フィールドは無視します（入力ファイルに、引用符はなく、タイ

トルレコードもありません）。

［小数点記号］はピリオド（.）に、［桁区切り記号］はカンマ（,）に設定されている必要があります。

8. ［プレビュー］ボタンをクリックして、“example.cma”ソースファイルのレコードを表示します。そのレ

コードを見て、データソース内のレコード構造を確認できます。

変数の識別

ソースデータを TurboIntegrator にロードしたら、ソースのフィールドごとに内容を識別する必要がありま

す。ソース内の各フィールドには、TM1 によって変数が割り当てられます。

手順

1. ［変数］タブをクリックし、次に示すグリッドを表示します。このグリッドに表示される行は、データソー

ス内の各変数に対応しています。



グリッドの最初の列は、データソースフィールドごとに割り当てられる［変数名］です。独自の変数を

割り当てるには、そのセルをクリックして新しい変数名を入力します。

2 番目の列は、各変数に割り当てられる［変数の型］です。これにより、ソースフィールドのデータの

型が識別されます。この型は、ドロップダウンリストから選択して変更できます。

3 番目の列は［サンプル値］で、データソースの最初のレコードの内容が表示されます。上図の場

合、“example.cma”の最初のレコードの最初のフィールドの内容は“New England”です。

［コンテンツ］列は、各変数が表す TM1 のデータ型（要素、集約、データ、属性、その他、無視）を

規定します。この例の最初の 3 つの変数は、地域階層の集約と要素を表しています。

2. 変数“V1”の［コンテンツ］列で、ドロップダウンリストから［集約］を選択します。

3. 同じ操作を“Massachusetts”変数に対して実行します。

4. 変数“Boston”では、［要素］を選択します。

5. その他の変数は、ディメンションの作成に使用されないため、すべて［無視］を選択します。


データソース内の変数を識別したら、その変数を TM1 オブジェクトにマッピングする必要があります。

手順

1. ［マップ］タブをクリックしてから、［キューブ］サブタブをクリックします。

2. キューブは作成しないため、［キューブの操作］ボックスで［未対処］を選択します。

3. ［データ操作］は関係ありません（キューブの作成や更新は行いません）。このボックスは無視するこ


4. ［キューブのログ記録を有効化］オプションは関係ありません（データ値は処理しません）。このオプ

ションは、非選択のままにしておきます。

96 IBM Cognos TM1


5. ［ディメンション］サブタブをクリックします。

このグリッドには、内容タイプを［要素］と指定した変数が 1 行ずつ表示されます。要素の型を指定

し、その要素をメンバーとするディメンションを指定する必要があります。

6. ディメンションは新規に作成するので、“Boston”変数の［ディメンション］列に「Example」と入力しま

す。

7. ［操作］ドロップダウンリストから［作成］を選択します。

8. ［要素の型］ドロップダウンリストから［数値］を選択します。［ディメンション］サブタブの表示は、次の

ようになります。

これで、“Boston”変数が、“Example”という新しいディメンションの数値要素としてマッピングされま

した。

次は、集約として識別した変数をマッピングできます。

9. ［集約］サブタブをクリックします。

2 つの集約変数が新しい“Example”ディメンションのメンバーであることは、TM1 で正しく認識され

ています。必要な処理で残っているのは、それぞれの集約について子の変数を特定することです。

10. “V1”集約変数について、［Massachusetts］を［子の変数］として選択します。

11. “Massachusetts”集約変数について、［Boston］を［子の変数］として選択します。

12. ［重み付け］は、どちらの集約変数でも編集しないでください。

操作が終了すると、［集約］サブタブの表示は次のようになります。

マッピングはすべて完了です。特に必要ではありませんが、［詳細］タブをクリックしてから各種サブ

タブをクリックすると、TurboIntegrator によって作成されたスクリプト（“Example”を新規に作成し、集

約と要素を挿入するスクリプト）を表示できます。 TurboIntegrator のスクリプトについては、このチュー

トリアルの後半で詳しく説明します。

プロセスの保存と実行


手順


プロセスを保存するようプロンプトが表示されます。

2. “create_Example_dimension”という名前でプロセスを保存します。



プロセスは、わかりやすい名前で保存することをお勧めします。

数秒後に、プロセスが正しく実行されたことを示すメッセージボックスが表示されます。

3. ［TurboIntegrator］ウィンドウを閉じます。


5. 作成された［Example］ディメンションを右クリックし、［ディメンション構造の編集］を選択します。

ディメンションエディタで“Example”ディメンションが開きます。

6. をクリックし、ディメンションメンバーを階層レベルで並べ替えます。

“Example”ディメンションが正しく作成されています。“New England”は集約要素で、“Massachusetts”

（集約要素）を含みます。その“Massachusetts”は、数値要素の“Boston”、“Springfield”および

“Worcester”を含んでいます。

ODBC ソースからのディメンションの作成

チュートリアルのこのセクションでは、手順を追って、ODBC データソースからディメンションを作成しま

す。その手順は、ASCII ファイルからディメンションを作成する方法によく似ています。


チュートリアルを進める前に、Access データベースを ODBC データとして追加し、TurboIntegrator から

使用できるようにする必要があります。

手順

1. Windows の［ODBC データソースアドミニストレータ］ダイアログボックスを開きます。

このダイアログボックスにアクセスする手順は、実行している Windows のバージョンによって異なり

ます。詳細については、Windows オンラインヘルプを参照してください。

2. ［ユーザー DSN］タブで［追加］ボタンをクリックします。

［データソースの新規作成］ダイアログボックスが開きます。

3. ［Microsoft Access ドライバ］を選択し、［完了］をクリックします。

［ODBC Access セットアップ］ダイアログボックスが開きます。

4. ［データソース名］フィールドに「NewDB」と入力します。

5. ［選択］ボタンをクリックします。

［データベースの選択］ダイアログボックスが開きます。

98 IBM Cognos TM1


6. “TI_Data”ディレクトリに移動して、“NewDB.mdb”を選択します。

7. ［OK］をクリックして、［データベースの選択］ダイアログボックスを閉じます。

8. ［OK］をクリックして、［ODBC アドミニストレータ］ダイアログボックスを閉じます。

これで、Access データベースの NewDB が ODBC ソースとして使用可能になります。

データソースのクエリー

データソースをクエリーするには：

手順

1. サーバーエクスプローラで［プロセス］アイコンを右クリックし、［新規プロセスの作成］を選択します。


2. ［データソースタイプ］として［ODBC］を選択します。

3. ［データソース名］フィールドの横にある［参照］ボタンをクリックします。

4. ［ODBC データソース］ダイアログボックスが開きます。

5. ［NewDB］を選択し、［OK］をクリックします。

“NewDB.mdb”には“ACCOUNT”というテーブルが 1 つあり、このテーブルには 27 個のフィールド

が含まれます。その中の 6 つのフィールドの情報を選択す SQL クエリーを作成します。ODBC クエ

リーでは、その基となる DBMS の SQL 方言を使用する必要があります。MS Access クエリーの構文

と、Informix クエリー、SQL Server クエリーなどの構文は異なります。

クエリーを間違いなく正しい構文で作成するには、まず、基となる DBMS のクエリー機能を使用して

クエリーを作成し、そのクエリーをコピーして TurboIntegrator の［クエリ］フィールドに貼り付けます。

6. ［クエリ］フィールドに、次の文を正確に入力します。

SELECT [ACCOUNT_ID], [PARENT_ID], [NAME], [TYPE], [SALESREP], [SALESTEAM] FROM ACCOUNT;

7. ［プレビュー］をクリックし、クエリーが返す最初の 10 レコードを表示します。

SQL 内パラメータを使用する

[データソース]フィールドに使用するパラメータを作成し、クエリーの一部としてそのパラメータを呼び出

します。

次の SQL ステートメントはその例です。

SELECT * FROM customer WHERE last_name = ’Smith’

パラメータの”Smith”の値を”pLastName”に置き換える場合は、SQL ステートメントは次のようになります。

SELECT * FROM customer WHERE last_name = ’?pLastName?’

パラメータの作成時は、以下の点に注意してください。

● 最初に ODBC ソースを使用して TI プロセスを作成する必要があります。これは［変数］を作成しま

す。これによって、変数 DATASOURCEQUERY を使用して、［データソース］タブのクエリーテキス

トボックスを上書きすることができます。

● 返された設定の列の数は、TI プロセスが開発された時の数と一致している必要があります。

● 列のデータタイプも一致している必要があります。



● 文字列パラメータの場合は、一重引用符でパラメータを囲むことを忘れないでください。数値パラ

メータの場合は、一重引用符を使用しないでください。例えば、数値を使用しているクエリーは次の

ようになります。

SELECT * FROM customer WHERE last_name = ?pQuantity?

パラメータを作成するには、TurboIntegrator プロセスダイアログボックスの［詳細設定］タブを使用して

デフォルトの PO パラメータを使用したいパラメータに交換します (例えば、 pLastName)。

変数の識別

ソースデータのクエリーが終了したら、クエリー結果のフィールドごとに内容を識別する必要があります。

手順

1. ［変数］タブをクリックします。

変数タブのグリッドは、次のように表示されます。

［変数名］列に、データベースの列名が正しく設定されていることに着目してください。

2. ［コンテンツ］列の選択内容を、次のように変更します。

コンテンツ変数名

無視ACCOUNT_ID

無視PARENT_ID

要素名前

集約TYPE

集約SALESREP

集約SALESTEAM

これで、変数をマッピングする準備ができました。


まず、要素をディメンションにマッピングする必要があります。

手順

1. ［マップ］タブをクリックしてから、［ディメンション］サブタブをクリックします。

要素と識別した 1 つの変数が、グリッドに表示されます。

2. ［ディメンション］列に「DB」と入力します。

3. ［操作］ドロップダウンメニューから［作成］を選択します。

100 IBM Cognos TM1


4. ［要素の型］ドロップダウンメニューから［数値］を選択します。

［ディメンション］サブタブの表示は、次のようになります。

これで、集約変数をマッピングする準備ができました。

手順


各集約変数が DB ディメンションに関係していることは、TM1 で正しく認識されています。

2. 各集約変数の［子の変数］を設定します。

子の変数定数の変数

SALESREPTYPE

名前SALESREP

TYPESALESTEAM

［子の変数］をすべて設定すると、［集約］サブタブの表示は次のようになります。



手順



2. “create_DB_dimension”という名前でプロセスを保存します。


3. ［TurboIntegrator］ウィンドウを閉じます。


5. 作成された“DB”ディメンションをダブルクリックします。



サブセットエディタで“DB”ディメンションが開きます。

6. サブセットエディタのメニューバーから［編集］ → ［並べ替え］ → ［階層］を選択して、ディメンショ

ンの要素と集約を表示します。

“DB”ディメンションには、40 を超える要素が含まれています。階層レベルは 4 つあります。

キューブの作成とデータの処理

次の例では、TM1 TurboIntegrator を使用して、キューブ、ディメンション、および要素を作成し、同時に

データを処理する方法を示します。


次の手順を実行して、データソースを定義します。

手順




2. ［TurboIntegrator］ウィンドウの［データソース］タブをクリックします。

3. ［データソースタイプ］を［テキスト］に、［区切り記号の種類］を［区切り付き］に、さらに［区切り記号］

を［コロン］に設定します。

［引用符］および［タイトルレコード数］フィールドは無視します。

4. ［小数点記号］がピリオド（.）で、［桁区切り記号］がカンマ（,）になっていることを確認します。

5. ［データソース名］フィールドの横にある［参照］ボタンをクリックし、“TI_data”ディレクトリ内のファイ

ル“newcube.csv”を選択します。

6. ［プレビュー］をクリックして、データソースの最初の 10 レコードを表示します。

“newcube.csv”の各レコードには 20 個のフィールドがあります。表示グリッドをスクロールすると、す

べてのフィールドを表示できます。

変数の識別


す。

手順


一部の変数には Vn という形式で名前が付けられ、他の変数にはソースファイルの最初のレコード

に対応する名前が付けられます。

2. 編集処理を簡単にするために、すべての変数の名前を Vn という形式に変更します。最初の変数

の名前を「V1」、2 番目の変数の名前を「V2」に変更してください（以下同様）。操作が終了すると、

［変数］タブの表示は次のようになります。

102 IBM Cognos TM1


3. 各変数について、それぞれの［変数の型］ドロップダウンリストから型を選択します。

変数“V1”、“V2”、および“V3”のタイプは［数値］です。他の変数のタイプはすべて［文字列］です。

4. 各変数について、それぞれの［コンテンツ］ドロップダウンリストから内容タイプを選択します。次の

表を参照して、各変数の内容タイプを指定してください。

コンテンツ変数名コンテンツ変数名

集約V11データV1



要素V14要素V4

集約V15集約V5

集約V16集約V6

要素V17集約V7

要素V18集約V8



コンテンツ変数名コンテンツ変数名

要素V19集約V9

要素V20要素V10

操作が終了すると、［変数］グリッドの表示は次のようになります。


これでデータ、要素、および集約の変数は識別されました。ここからは、変数をマッピングして、新しい

キューブを作成する手順を指示する必要があります。

キューブのマッピング

キューブのマッピング指示を指定するには：

手順


2. ［キューブ］サブタブをクリックします。

3. ［キューブの操作］で［作成］を選択します。

4. ［キューブ名］フィールドに「NewCube」と入力します。

104 IBM Cognos TM1


5. ［データ操作］で［値の保存］を選択します。

6. ［キューブのログ記録を有効化］オプションはオンにしないでください。

キューブのログ記録を有効にすると、この処理で行われるキューブデータの変更が記録されます。

新しいキューブを作成するときに、変更内容をログに記録する必要はありません。

ディメンションへの要素変数のマッピング

これで、［要素］型を持つと識別したすべての変数を、それぞれのディメンションにマッピングできます。

手順


2. 次の表に従って、要素変数ごとに［ディメンション］、［操作］、および［要素の型］を指定します。

要素の型操作ディメンション要素の変数

数値作成dateV4

数値作成itemV10

数値作成customerV14

数値作成jobV17

数値作成countryV18

数値作成エージェントV19

数値作成bookV20

数値作成measureData Variables

各変数の［キューブ内の順序］値は、デフォルト値をそのまま使用できます。

操作が終了すると、［ディメンション］サブタブの表示は次のようになります。



データ変数のマッピング

ここでは、型がデータであると識別した変数をそれぞれの要素にマッピングする必要があります。

手順

1. ［データ］サブタブをクリックします。

2. データ変数“V1”について、「weight」を変数のマッピング先の要素として入力します。

3. “V2”では、「conversion」と入力します。

4. “V3”では、「pieces」と入力します。

5. ［要素の型］列は、3 つのすべての要素に対して［数値］を選択します。

［データ］サブタブの表示は、次のようになります。

集約変数のマッピング

ここでは、コンテンツが集約であると識別したすべての変数について、集約パスをマッピングする必要が

あります。

手順


2. 次の表に従って、集約変数ごとに［ディメンション］および［子の変数］を指定します。

子の変数ディメンション集約変数

V6itemV5

V7itemV6

V8itemV7

V9itemV8

V10itemV9

V12customerV11

V13customerV12

V14customerV13

106 IBM Cognos TM1


子の変数ディメンション集約変数

V16jobV15

V17jobV16

3. ［重み付け］と［コンポーネントの順序］は、すべての集約変数についてデフォルト値をそのまま使用

できます。

操作が終了すると、［集約］サブタブの表示は次のようになります。

これで、新しいディメンションを作成し、そのディメンションに要素と集約を挿入し、新しいキューブを

作成して、そのキューブにデータを移入するためのマッピングが完了しました。



手順





3. サーバーエクスプローラを開いて、キューブ“NewCube”が作成されてデータが移入されていること、

および必要なディメンションがすべて作成されていることを確認します。



新しいキューブ（データはまばらに移入されています）を参照して、新しく作成されたディメンションを

チェックしてください。

詳細スクリプトの処理TurboIntegrator の［詳細］タブを使用して、実行時にプロセスに渡すことが可能なパラメータを作成した

り、プロセスのプロシージャを編集したりすることで、TurboIntegrator の機能を強化できます。プロシー

ジャは、TurboIntegrator 関数と TM1 規則関数の両方を組み込むスクリプトを作成して編集します。

プロローグ、メタデータ、データ、エピローグの各プロシージャの編集

TurboIntegrator の機能は、プロセスの動作を定義するプロシージャを編集して拡張できます。プロシー

ジャは、TM1 のデータまたはメタデータを操作する文をグループにまとめたものです。

プロセス内には、順番に実行される 4 つのプロシージャがあります。各プロシージャには、

［TurboIntegrator］ウィンドウのいずれかの画面でユーザーが指定したオプションを基に TM1 が作成し

た生成文が含まれます。このプロシージャは編集できます（ユーザー独自の文を追加して、TurboIntegrator

関数および規則関数を組み込むことができます）。

プロセスには、次のプロシージャが含まれています。

説明タブ

データソースを処理する前に実行される一連の操作プロローグ

処理中にキューブ、ディメンション、などのメタデータ構造体を更新または作成する一連の操作メタデータ

データソース内の各レコードに対して実行される一連のデータ操作データ

データソースを処理した後で実行される一連の操作エピローグ

プロシージャを編集するときは、各プロシージャはプロセス中の特定の時点で特定の操作を実行するよ

うに設計されているということを忘れないでください。したがって、作成する操作や文は、そのプロシージャ

に適したものにしてください。

例えば、処理するデータを ASCII ファイルにエクスポートするには、データプロシージャに ASCIIOutput

関数を追加することになります。ASCIIOutput はデータを操作する関数なので、処理時に実行する必要

があります。したがって、データプロシージャが、この関数を配置するのに適したプロシージャになりま

す。

108 IBM Cognos TM1


プロシージャの編集

プロシージャを編集するには：

手順

1. ［TurboIntegrator］ウィンドウの［詳細］タブをクリックします。

2. 編集するプロシージャのサブタブをクリックします。

3. 文をテキストボックスに入力します。次の行の前か、


次の行の後ろに入力してください。


この 2 つの行の間に生成されている文は編集しないでください。

階層のバランスが取れていないディメンションの作成

この演習では、次の入力ファイルを使用して、階層のバランスが取れていないディメンションを作成しま

す。

TOTAL,NORTH,TK1,G1

TOTAL,NORTH,TK1,G2

TOTAL,NORTH,TK1,G3

TOTAL,NORTH,TK1,G4

TOTAL,NORTH,TK2,G5

TOTAL,NORTH,TK2,G6

TOTAL,SOUTH,TK3,G7

TOTAL,SOUTH,TK3,G8

TOTAL,SOUTH,TK3,G9

TOTAL,SOUTH,TK4,G10

TOTAL,SOUTH,TK4,G11

TOTAL,SOUTH,TK4,G12

TOTAL,TK5,G13

TOTAL,TK5,G14

TOTAL,TK6,G15

TOTAL,TK6,G16

TOTAL,TK6,G17

TOTAL,G18

TOTAL,G19

最終的結果は、次のようになります。



ディメンションの作成を開始するには：

手順




2. ［データソースタイプ］として［テキスト］を選択します。

3. ［データソース名］フィールドの横の［参照］をクリックし、“TI_data”ディレクトリ内の“unbalanced.csv”

を選択します。

4. ［データソース］タブにある他のオプションは、すべてデフォルト設定値のままにしておきます。

5. ［更新］をクリックして、データソースの最初の 10 レードを表示します。

変数の識別


す。

手順


110 IBM Cognos TM1


2. “Total”、“North”、“TK1”の各変数について、［コンテンツ］列で［集約］を選択します。

3. 変数“G1”では、［要素］を選択します。


これで要素と集約の変数が識別されました。次に、変数をディメンションにマッピングし、集約パスを定義


手順



3. 要素変数“G1”について、［ディメンション］として「unbalanced」、［操作］として［作成］、［要素の型］と

して［数値］を入力します。


5. 3 つの変数について、［ディメンション］列のドロップダウンリストから［unbalanced］を選択します。

6. 集約変数“Total”について、［子の変数］として［North］を選択します。

7. 集約変数“North”について、［子の変数］として［TK1］を選択します。

8. 集約変数“TK1”について、［子の変数］として［G1］を選択します。

生成された文のコピー

［TurboIntegrator］ウィンドウのオプションを変更すると、TM1 によって動的に文が作成されます。

［詳細］タブの［プロローグ］サブタブと［メタデータ］サブタブに生成された文を編集して、バランスの取れ

ていないディメンション階層に対応します。作業を多少とも楽に進めるため、生成された文をコピーして



貼り付けることにします（そうすることにより、［TurboIntegrator］ウィンドウでオプションを変更した後の文

を使用できます）。

手順

1. ［詳細］タブをクリックしてから、［プロローグ］サブタブをクリックします。

2. コメント行の間に挟まれている DimensionDestroy および DimensionCreate 関数をコピーして、



コメント行の下に貼り付けます。

3. ［メタデータ］サブタブをクリックします。

次の 2 つの関数があります。

DimensionElementInsert 関数は、単純な要素（リーフ要素）をディメンションに追加します。この関数

を使用すると、数値と文字列の両方の要素を追加できます。

DimensionElementComponentAdd 関数は、コンポーネント（子）を集約要素に追加します。

4. 生成されている文をすべてコピーし、最後のコメント行の下に貼り付けます。

112 IBM Cognos TM1


生成された文の完全な削除

生成された文を完全に削除するには：

手順

1. ［変数］タブをクリックし、［コンテンツ］列の選択内容を［その他］に変更します。

［その他］として識別した変数は、詳細スクリプトで使用することができます。変数が［無視］として識

別されている場合、その変数を TurboIntegrator では処理されないため、詳細スクリプトからも参照

できません。

2. 文が削除されていることを確認するには、［詳細］タブをクリックしてから、［プロローグ］および［メタ

データ］サブタブをクリックします。

文は次のようになります。

Prolog>



DIMENSIONDESTROY('unbalanced');

DIMENSIONCREATE('unbalanced');

Metadata>



DIMENSIONELEMENTINSERT('unbalanced','',G1,'n');

DIMENSIONELEMENTINSERT('unbalanced','',TOTAL,'c');

DIMENSIONELEMENTINSERT('unbalanced','',NORTH,'c');

DIMENSIONELEMENTINSERT('unbalanced','',TK1,'c');

DIMENSIONELEMENTCOMPONENTADD('unbalanced',TOTAL,NORTH,1.000000);

DIMENSIONELEMENTCOMPONENTADD('unbalanced',NORTH,TK1,1.000000);

DIMENSIONELEMENTCOMPONENTADD('unbalanced',TK1,G1,1.000000);

TurboIntegrator 文の編集

［メタデータ］サブタブに今あるスクリプトの内容を確認します。この文は、次のようになっています。








このスクリプトは、“unbalanced.csv”の最初のレコードに基づいて生成されており、フィールドが 4 つある

レコードに対し有効です。このスクリプトは、ソースの各フィールドからディメンション要素を作成し、階層

を作成します。ただし、含まれるフィールドが 4 つより少ないレコードには有効でありません。



ソースファイルの“unbalanced.csv”には長さが異なるレコードが含まれるため、ソース内の各レコードを

評価するようにスクリプトを変更する必要があります。このスクリプトでは、集約のレベルを正しく判断し、

集約の各レベルに対して適切な集約パスを指定する必要があります。これは、IF 関数を含むようにスク

リプトを編集して実現できます。IF 関数を使用するとで、定義した条件に基づいて別の TurboIntegrator

文を実行できます。

手順

1. ［詳細］タブをクリックしてから、［メタデータ］サブタブをクリックします。

2. 次の行を挿入します。

IF (G1@<>'');

挿入する位置は、最初の DIMENSIONELEMENTINSERT 文の手前です。この IF 文は、文字列変

数“G1”が空でなければ、この IF 文の後に続く文が実行されることを示します。“V4”が空の場合は、

この次の条件文に処理がジャンプします。

これで、［メタデータ］サブタブの表示は、次のようになります。



IF (G1@<>'');








IF (G1@<>'') が真の場合は、3 つの集約要素（“Total”、“North”、“TK1”）と 1 つの数値要素（“G1”）

が“unbalanced”ディメンションに挿入されます。また、“Total”が“North”の親で、“North”が“TK1”

の親で、“TK1”が“G1”の親である 4 レベルの階層も作成されます。


ELSEIF (TK1@<>'');

挿入する位置は、最後の DIMENSIONELEMENTCOMPONENTADD 文の後ろです。

この条件付き ELSEIF 文は、文字列変数“V3”が空でなければ、この ELSEIF 文の後に続く文が実

行されることを示します。“V3”が空の場合は、この次の条件文に処理がジャンプします。

4. ここで、ELSEIF (TK1@<>'') が真の場合に実行する文を挿入する必要があります。

ELSEIF (TK1@<>'') が真の場合は、ソースレコードに 3 つのフィールドが含まれています。したがっ

て、各フィールドからディメンション要素を作成し、3 レベルの階層を作成する文が必要です。

5. 次の文を、ELSEIF (TK1@<>''); のすぐ後ろに挿入します。



DIMENSIONELEMENTINSERT('unbalanced','',TK1,'n');



IF (TK1@<>'') が真の場合は、2 つの集約要素（“Total”、“North”）と 1 つの数値要素（“TK1”）が

“unbalanced”ディメンションに挿入されます。また、“TOTAL”が“NORTH”の親で、“NORTH”が

“TK1”の親である 3 レベルの階層も作成されます。

114 IBM Cognos TM1



ELSE;

挿入する位置は、最後の DIMENSIONELEMENTCOMPONENTADD 文の後ろです。

7. ここで、処理が ELSE 文に到達したときに実行する文を挿入する必要があります。（そうなるのは、IF

(G1@<>'') と ELSEIF (TK1@<>'') の両方が偽の場合です。）

処理が ELSE 文に到達した場合は、ソースレコードに 2 つのフィールドが含まれています。挿入す

る文によって、各フィールドからディメンション要素を作成し、2 レベルの階層を作成する必要があり

ます。

8. 次の文を、ELSE; のすぐ後ろに挿入します。


DIMENSIONELEMENTINSERT('unbalanced','',NORTH,'n');


この文は、集約要素“TOTAL”と数値要素“NORTH”を“unbalanced”ディメンションに挿入し、

“TOTAL”が“NORTH”の親である階層を作成するように TurboIntegrator に指示します。


ENDIF;

挿入する位置は、最後の DIMENSIONELEMENTCOMPONENTADD 文の後ろです。ENDIF は、

IF 文の終端を示します。

編集が終了して完成した［メタデータ］サブタブは、次のようになります。



IF (G1@<>'');








ELSEIF (TK1@<>'');



DIMENSIONELEMENTINSERT('unbalanced','',TK1,'n');



ELSE;


DIMENSIONELEMENTINSERT('unbalanced','',NORTH,'n');


ENDIF;

10. ［ファイル］ → ［保存］を選択し、プロセスに“create_unbalanced_dim”という名前を付けます。

11. ［ファイル］ → ［実行］を選択して、プロセスを実行します。



12. ディメンションが正しく構築されたことを確認するには、ディメンションエディタで“unbalanced”ディメ

ンションを開きます。ディメンションは、次の図のように表示されます。

サブセットの作成

この演習では、ディメンションプロセスによって作成されるディメンション“newdim”のサブセットを作成し

ます。

手順

1. ［TurboIntegrator］ウィンドウでプロセス［subsets］を開きます。

“TI_data”ディレクトリの“region.csv”を指すようにデータソーの変更が必要な場合があります。デー

タソースを変更すると、プロセス変数を扱う方法を指定するプロンプトが表示されます。［すべての

変数を維持する］を選択します。

この例では、TM1 TurboIntegrator 関数の SubsetCreate() と SubsetElementInsert() を使用して、

ディメンションサブセットを作成し、要素を設定します。

ソースファイルのプレビューは、次のようになっています。

116 IBM Cognos TM1


次に、サブセットを処理するスクリプトを示します。

Prolog>



SubsetCreate('NewDim','Europe');

SubsetCreate('NewDim','US');

SubsetCreate('NewDim','ROW');

Metadata>



SubsetElementInsert('NewDim',V4,V0,0);

2. プロセスを実行します。

3. サーバーエクスプローラで、“newdim”ディメンションを展開して、新しく作成されたアブセットを確認

します。

属性の作成

文字列要素属性の値は、AttrPutS 関数で割り当てます。文字列“Europe”を、“NewDim”ディメンション

の国“Sweden”の“Continent”属性に割り当てる場合は、AttrPutS 関数を次のように記述します。

AttrPutS(‘Europe’,'NewDim',’Sweden’,'Continent');

手順

1. TurboIntegrator で［Attributes］プロセスを開きます。

“TI_data”ディレクトリの“region.csv”を指すようにデータソーの変更が必要な場合があります。デー

タソースを変更すると、プロセス変数を扱う方法を指定するプロンプトが表示されます。［すべての

変数を維持する］を選択します。


“V4”と“V5”が属性として識別されていることを確認してください。



3. “V5”の［数式］セルをクリックします。

V5=V0|V4; と表示されます。

この式は、“V4”変数と“V5”変数の値を連結します。

4. ［マップ］タブをクリックし、［属性］サブタブをクリックします。

変数“V4”の属性の型は［テキスト］と定義され、“V5”の型は［別名］と定義されています。

5. ［詳細］タブをクリックし、［データ］サブタブをクリックして、生成された文と 2 つの追加文を表示しま

す。


V5=v0|v4;

AttrPutS(V4,'newdim',V0,'continent');

AttrPutS(V5,'newdim',V0,'cont');




［変数］タブで“V1”と“V2”がコンテンツと宣言されていないため、上記の 2 つの文は手動で追加さ

れています。ただし、これらの変数には、テキスト属性“Continent”を割り当てる必要があります。

6. “Attributes”プロセスを保存して実行します。

属性の表示

属性値を割り当てたら、次の手順でその割り当て内容を表示できます。

手順

1. サーバーエクスプローラで［newdim］ディメンションをダブルクリックして、サブセットエディタを開き

ます。

2. ［サブセット All］ボタンをクリックします。

3. メニューから［編集］ → ［フィルタ基準］ → ［属性］を選択して、［属性によるフィルタ］ダイアログボッ

クスを表示します。

4. ［属性によるフィルタ］ダイアログボックスで、ドロップダウンリストから属性値を選択して、特定の大

陸のすべての国をサブセットエディタに表示します。

118 IBM Cognos TM1


付録 B：TurboIntegrator の予約語

この付録では、IBM® Cognos® TM1® TurboIntegrator の予約語の一覧を示します。作成する

TurboIntegrator スクリプトでエラーが発生しないように、TM1 変数を作成する場合は、次の表に示す語

と一致する名前を使用しないでください。

TurboIntegrator の予約語は、次の 4 つに分類されます。

● 規則関数の名前

● プロセス関数の名前

● 暗黙的な変数の名前

● TurboIntegrator のキーワード

規則関数の名前次に、TM1® 規則関数の予約語を示します。

● ABS

● ACOS

● ASIN

● ATAN

● ATTRN

● ATTRS

● AVG

● BANNR

● BDATE

● BDAYN

● CAPIT

● CENTR

● CHAR

● CNT

● CODE

● COL

● Consolidate Children

● COS

● DATE



● DATES

● DATFM

● DAY

● DAYNO

● DBG16

● DBGEN

● DELET

● DFRST

● DIMIX

● DIMNM

● DIMSIZ

● DISPLY

● DNEXT

● DNLEV

● DTYPE

● DYS

● ELCOMP

● ELCOMPN

● ELISANC

● ELISCOMP

● ELISPAR

● ELLEV

● ELPAR

● ELPARN

● ELWEIGHT

● EXP

● FILL

● FV

● HEX

● IF

● INSRT

● INT

120 IBM Cognos TM1


● IRR

● ISLEAF

● ISUND

● LIN

● LN

● LOG

● LONG

● LOOK

● LOWER

● MAX

● MEM

● MIN

● MOD

● MONTH

● MOS

● NCELL

● NOW

● NPV

● PAYMT

● PV

● RAND

● RIGHT

● ROUND

● ROUNDP

● SCAN

● SCELL

● SIGN

● SIN

● SLEEP

● SQRT

● STDDV

● STR



● SUBSIZ

● SUBST

● SUM

● TABDIM

● TAN

● TIME

● TIMST

● TIMVL

● TODAY

● TRIM

● UNDEF

● UPPER

● VAR

● WHOAMI

● WIDTH

● YEAR

● YRS

プロセス関数の名前次に、TurboIntegrator プロセス関数名を示します。

● AddClient

● AddGroup

● AllowExternalRequests

● ASCIIDelete

● ASCIIOutput

● AssignClientPassword

● AssignClientToGroup

● AttrDelete

● AttrInsert

● AttrPutN

● AttrPutS

● AttrToAlias

● BatchUpdateFinish

122 IBM Cognos TM1


● BatchUpdateStart

● CellGetN

● CellGetS

● CellIsUpdateable

● CellPutN

● CellPutProportionalSpread

● CellPutS

● ChoreQuit

● CubeCreate

● CubeDestroy

● CubeExists

● CubeGetLogChanges

● CubeLockOverride

● CubeProcessFeeders

● CubeSetConnParams

● CubeSetIsVirtual

● CubeSetLogChanges

● CubeSetSAPVariablesClause

● CubeSetSlicerMembers

● CubeUnload

● DeleteClient

● DeleteGroup

● DimensionCreate

● DimensionDeleteAllElements

● DimensionDestroy

● DimensionEditingAliasSet

● DimensionElementComponentAdd

● DimensionElementComponentDelete

● DimensionElementDelete

● DimensionElementInsert

● DimensionElementInsertByAlias

● DimensionElementPrincipalName



● DimensionExists

● DimensionSortOrder

● ElementSecurityGet

● ElementSecurityPut

● EncodePassword

● ExecuteCommand

● ExecuteProcess

● Expand

● FileExists

● GetProcessErrorFileDirectory

● GetProcessErrorFilename

● IsNull

● ItemReject

● ItemSkip

● LockOff

● LockOn

● NumberToString

● NumberToStringEx

● NumericGlobalVariable

● NumericSessionVariable

● ODBCClose

● ODBCOpen

● ODBCOutput

● ProcessBreak

● ProcessError

● ProcessExitByBreak

● ProcessExitByChoreQuit

● ProcessExitByQuit

● ProcessExitMinorError

● ProcessExitNormal

● ProcessExitOnInit

● ProcessExitSeriousError

124 IBM Cognos TM1


● ProcessExitWithMessage

● ProcessQuit

● PublishView

● RemoveClientFromGroup

● ReturnSQLTableHandle

● ReturnViewHandle

● RuleLoadFromFile

● SaveDataAll

● SecurityRefresh

● ServerShutDown

● SetChoreVerboseMessages

● StringGlobalVariable

● StringSessionVariable

● StringToNumber

● StringToNumberEx

● SubsetAliasSet

● SubsetCreate

● SubsetCreateByMDX

● SubsetDeleteAllElements

● SubsetDestroy

● SubsetElementDelete

● SubsetElementInsert

● SubsetExists

● SubsetFormatStyleSet

● SubsetGetElementName

● SubsetGetSize

● SubsetIsAllSet

● SwapAliasWithPrincipalName

● ViewColumnDimensionSet

● ViewColumnSuppressZeroesSet

● ViewConstruct

● ViewCreate



● ViewDestroy

● ViewExists

● ViewExtractSkipRuleValuesSet

● ViewExtractSkipRuleValuesSet

● ViewExtractSkipZeroesSet

● ViewRowDimensionSet

● ViewRowSuppressZeroesSet

● ViewSetSkipCalcs

● ViewSetSkipRuleValues

● ViewSetSkipZeroes

● ViewSubsetAssign

● ViewSuppressZeroesSet

● ViewTitleDimensionSet

● ViewTitleElementSet

● ViewZeroOut

● WildcardFileSearch

暗黙的な変数の名前次に、TurboIntegrator の暗黙の変数名を示します。

● DatasourceASCIIDecimalSeparator

● DatasourceASCIIDelimiter

● DatasourceASCIIHeaderRecords

● DatasourceASCIIQuoteCharacter

● DatasourceASCIIThousandSeparator

● DatasourceCubeview

● DatasourceDimensionSubset

● DatasourceNameForClient

● DatasourceNameForServer

● DatasourceODBOCatalog

● DatasourceODBOConnectionString

● DatasourceODBOCubeName

● DatasourceODBOHierarchyName

● DatasourceODBOLocation

126 IBM Cognos TM1


● DatasourceODBOProvider

● DatasourceODBOSAPClientId

● DatasourceODBOSAPClientLanguage

● DatasourcePassword

● DatasourceQuery

● DatasourceType

● DatasourceUseCallerProcessConnection

● DatasourceUsername

● MinorErrorLogMax

● NValue

● OnMinorErrorDoItemSkip

● SValue

● Value_Is_String

TurboIntegrator のキーワード次に、予約済みの TurboIntegrator キーワードを示します。

● break

● else

● elseif

● end

● endif

● if

● while



128 IBM Cognos TM1


索引

A

ASCII

サンプルファイル, 94

ファイル, 9

フラットファイル, 22

I

IBM Cognos 8 Planning と SAP BW データ, 76

InfoCube, 50, 61

M

MDX, 28

Microsoft Analysis Services, 35, 40, 43

キューブをインポートする, 37

接続する, 37

接続文字列, 35

ディメンションをインポートする, 40

MSAS

接続文字列, 35

O

ODBC, 9

カタログ, 35

データソース, 27

データソースていぎ, 27

ODBO

カタログ, 35

キューブ, 38

キューブのディメンション, 38, 39

キューブを保存する, 40

ディメンション, 42

ディメンションを保存する, 42


場所, 35

プロバイダ名, 35

ODS 表, 65

ODS 表にエクスポートする, 64

OLAP, 35

OLE_LINK1, 109

OLE DB, 35

S

SAP

BW, 49, 69

BW への接続の確立, 49, 69

RFC, 46

インポートする, 58

オブジェクト階層, 45

階層, 45, 51, 58, 70

技術名, 46

クエリーキューブ, 45, 46

重要なデータ, 51, 65, 70

セキュリティインポートする, 60

接続パラメータ, 49, 69

通貨, 61


特性, 45, 51, 57, 70

マッピングする, 50, 51, 58, 61, 64, 65, 70

役割, 60

用語, 45

ワイルドカードを使用する, 62

SAP BW

ファクトデータ使用のガイドライン, 79

SAP BW クエリー

分割プロンプトを指定, 82

SAP BW データ

Cognos Planning, 76

SQL クエリー, 27

STET, 11

T

TI 関数での別名, 12

TI プロセス

推奨, 12

TM1, 9

キューブ, 9

メッセージログ, 43

TurboIntegrator

MDX からインポートする, 28

ODBC, 27

関数, 10

チュートリアル, 93

データをインポートする, 10

プロセス, 11

予約語, 119

U

UNC, 15

Universal Naming Convention




W

WHERE 句, 64

い

一括読み込みモード, 85

え

エピローグプロシージャ, 11

か

関数

TurboIntegrator プロセスでの使用, 10

き

キューブ

ASCII フラットファイル, 22

作成する, 22


表示, 31

変数, 23

マッピングする, 20, 23

く

クエリー

SQL, 27

クライアント, 49

け

言語, 49

こ

固定長のレコード, 17

さ

サンドボックス

TurboIntegrator 関数, 13

TurboIntegrator プロセスと共に実行, 12

TurboIntegrator プロセスとの併用, 12

サンプルの ASCII ファイル, 94

し

システム, 49

集約

ディメンションサブセット, 33

複数の集約, 21

マッピングする, 21

重要なデータ, 51, 65, 70, 76

詳細ファクトクエリーサブジェクト, 76

す

数値データ

IBM Cognos 8 Planning 用, 76

せ

セキュリティ

SAPからインポートする, 58, 60

接続

MSAS 文字列, 35

SAP のパラメータ, 49, 69

TM1 文字列, 35

そ

その他の接続パラメータ, 49

ち

チュートリアル

概要, 93

作成する, 94, 102, 116, 117

ディメンションを作成する, 94

データディレクトリ, 93

プロセス内のプロシージャを編集する, 108

つ

通貨

SAPからインポートする, 61

て

ディメンション

ASCII フラットファイル, 15

ODBO, 42

サブセット集約, 33

サブセットデータソース, 31

集約変数をマッピングする, 24

データ変数をマッピングする, 24


要素変数をマッピングする, 24

データ

ODBC ソース, 27

ソース, 11, 15, 17, 22, 31

プロシージャ, 11

変数, 24


データソースのクエリー, 99

データソースのパラメータ, 99

データソースパラメータ, 99

データの抽出

変数使用法の SAP BW ガイドライン, 79

データをインポートする

概要, 9

130 IBM Cognos TM1

索引

と

登録済みサーバー, 35

特性, 57

マッピングする, 51, 70

に

日課

自動実行, 88

設定ウィザード, 88

定義, 10, 88

は

パケットサイズ, 50

パスワード, 49

ひ

表名フィールド, 64

ふ

フィルタ文字列フィールド, 64

プロセス

ODBO プロセスを実行する, 43

実行する, 21, 88

定義, 10

ヒント, 11

プロシージャ, 11

編集する, 86

保存する, 21, 43

プロローグプロシージャ, 11

プロンプト

SAP BW クエリーで分割を指定, 82

へ

並行クエリー, 83

変数

SAP BW ファクトデータのガイドライン, 79

キューブ, 23

キューブのマッピング, 23

集約をディメンションにマッピングする, 24

ディメンションにマッピングする, 24


デフォルトの名前, 17


ま

マッピング

キューブ, 20, 23

キューブ変数, 23

集約, 21

集約変数をディメンションにマッピングする, 24


ディメンションサブセット, 33

ディメンションの要素変数, 24

データ, 21

変数, 20

め

メタデータプロシージャ, 11

メッセージログ, 43

や

役割フィルタ, 60

ゆ

ユーザー, 49

ユーザー名フィルタ, 60

よ

要素

データソースからインポートする, 15

予約語

TurboIntegrator のキーワード, 127

暗黙的な変数の名前, 126

概要, 119

規則関数, 119

プロセス関数, 122

れ

レコード、固定長, 17

わ

ワイルドカード, 62


索引

TM1 Turbo Integrator ガイド - IBMpublic.dhe.ibm.com/.../docs/ja/9.5.1/tm1_turb.pdfTM1...

Documents

Transcript of TM1 Turbo Integrator ガイド - IBMpublic.dhe.ibm.com/.../docs/ja/9.5.1/tm1_turb.pdfTM1...