Siebel レポートガイド バージョン6.0

Reports.book
1 ページ
２００１年４月２７日　金曜日　午前１１時２７分
SIEBEL eBUSINESS APPLICATIONS
®
SIEBEL レポートガイド
SIEBEL 2000
バージョン 6.0
1JPA1-GA00-06000
2000 年 3 月
Reports.book
2 ページ
２００１年４月２７日　金曜日　午前１１時２７分
Siebel Systems, Inc., 1855 South Grant St., San Mateo, CA 94402
Copyright © 2000 Siebel Systems, Inc.
All rights reserved. Published 2000
Printed in the United States of America
本著作物の一部または全部を、Siebel Systems, Inc. の事前の同意および書面による許可なく、転載、複製、情
報検索に保管することは、その形態 ( 複写、写真、磁気などの記憶媒体を含みますがそれだけに限りません )
を問わず、禁じられています。
Target Account Selling Methodologies, Copyright © 1996 Target Marketing International, Inc. All rights reserved.
Siebel eBusiness Applications のフルテキスト検索機能には、Fulcrum Technologies とのライセンス契約のもと、同
社の技術を採用しており、著作権は Fulcrum Technologies, Inc. およびその使用許諾許可者に帰属しています。
Siebel、Siebel のロゴ、ActiveBriefing、TrickleSync、TSQ、Universal Agent、およびここで参照したその他の
Siebel 製品名は Siebel Systems, Inc. の商標であり、一部の国、地域においては登録商標である可能性があり
ます。
Windows ® は Microsoft Corporation の登録商標です。
これ以外のすべての製品名、マーク、ロゴ、記号に関しても、各々の所有者の商標または登録商標である可
能性があります。
合衆国政府制限つき権利。国防総省連邦調達規制補足を条件として配布されたプログラム、補助プログラム、
文書は DFARS 227.7202 "Commercial Computer Software and Commercial Computer Software Documentation" で制定さ
れた「商用コンピュータソフトウェア」であり、プログラム、補助プログラム、文書のいかなる使用、複製
および公開は Siebel の当該使用許諾契約に含まれている制限に従うものとします。その他すべての合衆国政府
によるプログラム、補助プログラム、文書の使用、複製および公開は Siebel の当該使用許諾契約および FAR
52.227-19 の (c) 項「Commercial Computer Software - Restricted Rights」(1987 年 6 月 ) または FAR 52.227-14「Rights
in General Data Alternate III」(1987 年 6 月 ) に記述されている制限に従うものとします。契約者 / 使用許諾付与
者は Siebel Systems, Inc. (1855 South Grant Street, San Mateo, CA 94402) です。
所有権情報
Siebel Systems, Inc. は、本書ならびに Siebel eBusiness Applications のオンライ
ンヘルプ中に記載されている情報を社外秘とみなします。本社外秘文書は、
以下の条項と条件のもとでのみ入手ならびに利用できます。(1) 有効で、お客
様が同契約書の条項に拘束されることを承諾されたものとする Siebel Systems
ソフトウェアライセンスサービス契約書。(2) 本書に含まれる著作ならびに制
限された権利通知。
Reports.book
iii ページ
２００１年４月２７日　金曜日　午前１１時２７分
目次
はじめに
このマニュアルの対象読者 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . はじめに- 2
このマニュアルの構成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . はじめに- 2
新機能 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . はじめに- 4
マニュアルの変更 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . はじめに- 4
レポート機能の変更 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . はじめに- 5
関連資料 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . はじめに- 6
Siebel テクニカルサポートへの連絡 . . . . . . . . . . . . . . . . . . . . . . . . . はじめに- 7
Siebel へのご意見 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . はじめに- 8
第1章
Siebel レポート
概要 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2
開発環境 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4
Actuate ファイルタイプ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4
ディレクトリ構造 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-5
Actuate ライブラリ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-7
Actuate デザインファイル . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-9
Siebel-Actuate 相互作用 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-12
ランタイム行動 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-15
レポートのデータ定義 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-17
データ供給 .ROL ファイル . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-18
Siebel レポートオブジェクトタイプ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-20
追加の Siebel-Actuate レポート項目 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-23
インストール . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-23
バージョン 6.0
Siebel レポートガイド
i ii
Reports.book
iv ページ
２００１年４月２７日　金曜日　午前１１時２７分
目次
動的レポートと静的レポート . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-24
ssSiebel.bas と移行条件 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-24
レポートデザインとライブラリファイルのバックアップ . . . . . . . . . . . . . . . 1-25
レポートの電子メールによる送付 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-25
第2章
グローバルなレポート修正
この章について . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2
全レポートのフォントの変更 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3
全レポートの企業ロゴの変更 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-10
第3章
簡単なリストレポートの作成
この章について . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2
新規レポートの作成とデザインのサブクラス化 . . . . . . . . . . . . . . . . . . . . . . 3-2
簡単なレポートリストの働き . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-3
既存リストレポートの検討 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-4
例－簡単なリストレポートの作成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-9
Siebel Tools による新規レポートオブジェクト定義の作成 . . . . . . . . . . . . . . 3-10
Actuate Developer Workbench でのレポートデザインの作成 . . . . . . . . . . . . . 3-13
ラベルおよびデータ要素のデザインへの追加 . . . . . . . . . . . . . . . . . . . . . . . . . 3-18
レポートのコンパイルとテスト . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-21
他の方法によるレポート作成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-23
レポートオブジェクト定義のコピー . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-23
レポートデザインのコピー . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-24
カスタムコンポーネントライブラリの使用 . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-25
第4章
既存のレポートのサブクラス化
この章について . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2
サブクラス化レポートの利点 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2
新規フィールドを持つサブクラス化レポートの作成 . . . . . . . . . . . . . . . . . . . 4-3
新規 .ROL ファイルの作成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-3
iv
Siebel レポートガイド
バージョン 6.0
Reports.book
v ページ
２００１年４月２７日　金曜日　午前１１時２７分
目次
サブクラス化レポートのデザインファイル作成 . . . . . . . . . . . . . . . . . . . . . . . 4-4
Content コンポーネントのサブクラス化 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-6
レポートデザインへのフィールドの追加 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-8
レポートのコンパイル、展開、およびテスト . . . . . . . . . . . . . . . . . . . . . . . . 4-10
第5章
グループセクションのあるレポート
この章について . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-2
グループセクションの動作 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-3
グループセクションのあるレポートの検討 . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-5
例－グループ区切りのあるレポートの作成 . . . . . . . . . . . . . . . . . . . . . . . . . . 5-8
Siebel Tools による新規レポートオブジェクト定義の作成 . . . . . . . . . . . . . . . 5-9
Actuate Developer Workbench によるレポートデザインの作成 . . . . . . . . . . . 5-11
ラベルおよびデータ要素のデザインへの追加 . . . . . . . . . . . . . . . . . . . . . . . . 5-13
レポートのコンパイルとテスト . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-16
グループ合計 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-17
例－売上合計のセールスステージテストレポートへの追加 . . . . . . . . . . . . 5-17
第6章
マスター詳細レポート
この章について . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-2
マスター詳細レポートの概要 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-4
既存のマスター詳細レポートの検証 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-6
例‐マスター詳細レポートの作成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-10
Siebel Tools での新しいレポートオブジェクト定義の作成 . . . . . . . . . . . . . . 6-11
カスタムコンポーネントライブラリの作成 . . . . . . . . . . . . . . . . . . . . . . . . . . 6-14
Actuate Developer Workbench でのレポートデザインの作成 . . . . . . . . . . . . . 6-15
レポートデザインへのデータストリームの追加 . . . . . . . . . . . . . . . . . . . . . . 6-17
デザインへのフレーム、データコントロール、ラベル要素の追加 . . . . . . 6-18
レポートのコンパイルとテスト . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-21
バージョン 6.0
Siebel レポートガイド
v
Reports.book
vi ページ
２００１年４月２７日　金曜日　午前１１時２７分
目次
第7章
複合データストリーム
この章について . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-2
データストリームの概念 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-2
レポートでの複合データストリームの使用 . . . . . . . . . . . . . . . . . . . . . . . . . . 7-4
レポートデザインへのグローバル変数の追加 . . . . . . . . . . . . . . . . . . . . . . . . . . 7-6
マスターデータストリームコンポーネントの修正 . . . . . . . . . . . . . . . . . . . . . . 7-7
コントロールでのグローバル変数の参照 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-8
複合データストリームのデバッグ時のヒント . . . . . . . . . . . . . . . . . . . . . . . . . . 7-9
第8章
メモリ内のレコードのソート
この章について . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-2
マルチバリューフィールドでソートされるレポート . . . . . . . . . . . . . . . . . . . . 8-3
多対多関係からのレコードをソートするレポート . . . . . . . . . . . . . . . . . . . . . . 8-5
メモリソートレポートの働き . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-7
データフィルタ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-7
メモリ構造 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-8
レポートデザインの構造 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-9
マルチバリューフィールドでソートされたレポートの検証 . . . . . . . . . . . . 8-12
グローバルリスト変数 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-16
マスターデータストリームの Fetch メソッド . . . . . . . . . . . . . . . . . . . . . . . . . 8-17
詳細データストリームの Fetch メソッド . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-17
統合データストリームの Fetch メソッド . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-19
ソートデータフィルタの Compare メソッド . . . . . . . . . . . . . . . . . . . . . . . . . . 8-20
多対多関係にもとづくレポートの検証 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-22
第9章
レポートでのグラフの使用
この章について . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-2
概要 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-2
Actuate により提供されるチャートタイプ . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-4
グラフコントロールプロパティ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-6
vi
Siebel レポートガイド
バージョン 6.0
Reports.book
vii ページ
２００１年４月２７日　金曜日　午前１１時２７分
目次
サンプルレポート‐商談パイプライン . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-16
レポート構造 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-18
プロパティ設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-19
例‐グラフを使用したレポートの作成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-21
第 10 章
スマートレポート
この章について . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-2
概要 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-2
スマートレポートの目的 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-2
標準のスマートレポート . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-4
ビジュアル特性 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-6
レポート構造と主要コンポーネント . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-10
価値の高さの指標 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-14
サーモメータ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-16
最小値、最大値、トリガー値の取得 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-18
データ値の取得 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-20
ダッシュボードのサブページ上でのサーモメータの配置 . . . . . . . . . . . . . 10-23
Siebel 生成グラフのスマートレポートへの転送 . . . . . . . . . . . . . . . . . . . . 10-25
第 11 章
売上予想レポート
この章について . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-2
売上予想データ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-2
部下の反復 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-8
Period ビジネスコンポーネント . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-9
売上予想レポートプロセスの概要 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-11
期間情報のロード . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-12
売上予想ライブラリ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-13
動的データ行と foDataRow 変数 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-13
既存の売上予想レポートの検討 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-16
期間をロードするレポートセクション . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-20
バージョン 6.0
Siebel レポートガイド
v ii
Reports.book
viii ページ
２００１年４月２７日　金曜日　午前１１時２７分
目次
個人をロードするレポートセクション . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-20
出力レポートセクション . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-30
反復データの取得 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-39
データストリームの同期化 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-41
データ反復のその他の用途 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-46
第 12 章
サーバーベースおよび
シンクライアントのレポート機能
この章について . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-2
サーバーベースのレポート機能 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-3
システムの概要 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-4
ユーザーインターフェースとプロセスフロー . . . . . . . . . . . . . . . . . . . . . . . . . 12-5
Siebel のレポート管理ビュー . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-9
ユーザー管理ビュー . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-9
プロフィールビュー . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-13
スケジュールリクエストビュー . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-15
完了リクエストビュー . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-17
アクティブリクエストビュー . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-20
エクスプローラビュー . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-21
レポート ( 個人 ) ビュー . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-23
Actuate Server の機能 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-25
Actuate Administrator Desktop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-25
ReportCast . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-26
シンクライアントのレポート機能 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-29
第 13 章
既存のカスタムレポートの
バージョン 6.0 への移行
この章について . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-2
ssSiebel.bas ライブラリ関数 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-3
オブジェクトに対する整数型参照 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-4
vi ii
Siebel レポートガイド
バージョン 6.0
Reports.book
ix ページ
２００１年４月２７日　金曜日　午前１１時２７分
目次
メソッド名の接頭辞 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-5
ssBusComp 接頭辞 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-5
ssModel 接頭辞 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-6
ssBusObj 接頭辞 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-7
InvokeMethod . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-7
メッセージボックス . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-8
CreateObject . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-9
第 14 章
Actuate 以外のソフトウェア製品を使用した
Siebel レポート
この章について . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-2
Microsoft Access レポートの設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-3
Siebel Tools でのレポートの定義 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-4
Siebel.mdb ファイルの作成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-6
Microsoft Access 用 ODBC データソースの設定 . . . . . . . . . . . . . . . . . . . . . . . 14-6
設定ファイルの内容の追加または変更 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-8
カスタムデータベースファイルの作成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-9
Siebel アプリケーションからのレポートの呼び出し . . . . . . . . . . . . . . . . . . 14-13
Microsoft Excel レポートの設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-14
Siebel Tools でのレポートの定義 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-15
区切りテキスト用 ODBC データソースの設定 . . . . . . . . . . . . . . . . . . . . . . . 14-17
Seagate Crystal Reports の設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-18
Siebel OLE DB Provider を介した
レポート用データへのアクセス . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-19
バージョン 6.0
Siebel レポートガイド
ix
Reports.book
x ページ
２００１年４月２７日　金曜日　午前１１時２７分
目次
付録 A
ライブラリリファレンス
この付録について . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-3
ssCustom ライブラリ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-3
テキストコントロール . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-3
売上情報の表示 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-6
日付情報の表示 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-7
CanGrow プロパティ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-9
チェックボックステキストコントロール . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-9
パーセントテキストコントロール . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-9
ラベルコントロール . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-10
フレームコントロール . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-11
ページリストおよび子コンポーネント . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-11
その他のコントロール . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-13
ラインコントロール . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-13
セクションコンポーネント . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-14
ssSiebel ライブラリ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-15
baseCur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-16
baseDate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-16
baseDateDisplay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-16
baseFlow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-17
baseFlow1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-17
baseFrm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-18
baseGrp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-18
baseInt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-19
baseLbl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-19
baseLblSiebel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-19
baseLineControlr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-20
basePage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-20
basePageList . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-21
basePageNoDisplay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-21
basePrintBy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-22
x
Siebel レポートガイド
バージョン 6.0
Reports.book
xi ページ
２００１年４月２７日　金曜日　午前１１時２７分
目次
baseReport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-22
baseReportHeader . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-23
baseReportTitle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-23
baseRpt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-24
baseRptCreateBy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-24
baseSeq . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-24
baseSubPage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-25
baseTxt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-25
付録 B
メソッドリファレンス
DataStream 機能 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .B-2
DataStream の必須メソッド . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .B-2
Start メソッド . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-3
Fetch メソッド . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-6
Delete メソッド . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-9
バージョン 6.0
Siebel レポートガイド
xi
Reports.book
xii ページ
２００１年４月２７日　金曜日　午前１１時２７分
目次
xi i
Siebel レポートガイド
バージョン 6.0
Reports.book
1 ページ
２００１年４月２７日　金曜日　午前１１時２７分
はじめに
このマニュアルの対象読者 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . はじめに- 2
このマニュアルの構成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . はじめに- 2
新機能 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . はじめに- 4
マニュアルの変更 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . はじめに- 4
レポート機能の変更 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . はじめに- 5
関連資料 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . はじめに- 6
Siebel テクニカルサポートへの連絡 . . . . . . . . . . . . . . . . . . . . . . . . . はじめに- 7
Siebel へのご意見 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . はじめに- 8
バージョン 6.0
Siebel レポートガイド
は じ めに - 1
Reports.book
2 ページ
２００１年４月２７日　金曜日　午前１１時２７分
はじめに
このマニュアルの対象読者
このマニュアルの対象読者
0
このマニュアルは、以下の方を対象としています。
アプリケーション このマニュアルは、Actuate を使って Siebel レポートの設定や
開発者
新規作成を行うアプリケーション開発者を対象としています。
オブジェクト指向という概念とともに、ビジネスオブジェクト、ビジネスコンポー
ネント、レポートオブジェクトといった Siebel オブジェクトモデルについて解説し
ます。また、Actuate Developer Workbench によるレポート作成についても十分な理解
が必要です。Siebel オブジェクトモデルについては『Siebel Tools ガイド』を参照し
てください。Actuate の概念については、Actuate Developer Workbench マニュアルシ
リーズの『Developing Advanced e.Reports』を参照してください。
このマニュアルの構成
0
このマニュアルの内容を理解すると、Actuate Developer Workbench を使った
Siebel レポートのカスタマイズ、強化、新規作成ができるようになります。
最初の章はレポート実装の概要で、ランタイムとプログラミングモデルについて
説明しています。
続く 3 つの章では、簡単なものから包括的なものまで順に、3 つの異なるレポー
ト実装シナリオを説明しています。
■
全てのレポートに影響を与えるライブラリコンポーネントへのマイナー
チェンジ
■
新しいレポートの作成
■
サブクラスによる既存の標準レポート修正バージョンの作成
その次の一連の章では、高度なレポートデザイン機能のさまざまな実装方法につ
いて説明します。
はじ め に - 2
■
グループレポート
■
マスター - 詳細レポート
■
グローバル DataRow の使用について
Siebel レポートガイド
バージョン 6.0
Reports.book
3 ページ
２００１年４月２７日　金曜日　午前１１時２７分
はじめに
このマニュアルの構成
■
マルチバリューフィールドと多対多データの並べ替えに使用するメモリ内レ
コードの並べ替え
■
レポートへの図の組込み
次の 2 つの章では、特別な設定事項 (Smart Report と見込みレポート ) が含まれる
複合レポートの 2 つのクラスについて説明します。
その後の 2 つの章では、全てのレポート ( サーバーベースレポート、シンクライア
ントレポート、バージョン 6.0 への全バージョンの 6.0 カスタムレポートの移送 )
に影響を与える機能と実行について説明します。
最後の章では、Siebel アプリケーションから非 Actuate レポートまでを説明して
います。
その後に 2 つの付録がありますが、ここでは特定のライブラリおよび方法に関す
る参照情報を説明します。
備考 : このガイドは Acutuate Software Corporation が提供するマニュアルに記載
されている情報の複製ではありません。このマニュアルをご使用になるには、
『Using e.Reports』および『Developing Advanced e.Report』に含まれる内容につい
て十分な理解が必要です。また、このマニュアルに含まれる例を実行してみる
には、Actuate Developer Workbench、Siebel Tools、および Siebel アプリケーショ
ン ( 最低要件 ) をインストールしていることが必要です。
バージョン 6.0
Siebel レポートガイド
は じ めに - 3
Reports.book
4 ページ
２００１年４月２７日　金曜日　午前１１時２７分
はじめに
新機能
新機能
0
Siebel eBusiness Applications の Siebel レポートガイドとレポート機能は両方とも、
バージョン 5.6 リリースから変更されています。
マニュアルの変更
0
Siebel レポートガイドは改訂されています。特に変更になった部分は次のとおり
です。
機能
説明
既存の内容は書きなおし
または更新されています
Siebel レポートガイドの内容は大幅に書きなおされ、次の
ような内容になっています。
新しく追加された章
追加済インデックス
はじ め に - 4
Siebel レポートガイド
■
Siebel レポート、Siebel eBusiness Applications、Actuate の
関係性についてのより詳細な説明
■
例の実行手順に関しての詳細な説明
■
設計概念を説明する既存の標準レポート分析
次のトピックに関して、新しい章が追加されました。
■
レポートに図を組み込む
■
Smart Reports
■
見込みレポート
■
サーバーベースレポートとシンクライアントレポート
■
既存のカスタムレポートのバージョン 6.0 への移送
Siebel レポートガイドのインデックスは、これで全体を網
羅するようになりました。
バージョン 6.0
Reports.book
5 ページ
２００１年４月２７日　金曜日　午前１１時２７分
はじめに
新機能
レポート機能の変更
0
Siebel eBusiness Applications と Siebel Tools には、バージョン 6.0 のレポートに関
連して次の機能が新しく加わりました。
機能
説明
サーバーベースレポート
サーバーベースレポートにより、レポートのスケジュー
ルを後で、または定期的に実行できます。また、実行可
能レポートを保存したり、レポートサーバーにレポート
を出力して適切なアクセス権限を持つ複数のユーザーが
使用することもできます。12-3 ページの「サーバーベー
スのレポート機能」を参照してください。
シンクライアントレポート
このレポートは、Siebel のシンクライアントが使用でき
ます。Siebel シンクライアントと専用クライアントに関
するほとんどの部分で、レポートリクエスト生成とレ
ポート出力へのアクセスは同じです。
レポートへの Web ブラウザ
アクセス
レポートサーバーにログオンアクセスするユーザーは、
Web ブラウザを使用して Siebel eBusiness Applications の
外部にあるレポートを参照することができます。
データアクセスメカニズム
OLE からより一般的なメカニズムに変更されました。
備考 : すべての Siebel 製品にこのマニュアルで説明されている機能全てが実装さ
れているわけではありません。 実装されている機能はお買い上げになったソフト
ウェアモジュールによって異なります。
バージョン 6.0
Siebel レポートガイド
は じ めに - 5
Reports.book
6 ページ
２００１年４月２７日　金曜日　午前１１時２７分
はじめに
関連資料
関連資料
0
次の Siebel マニュアルでも、このマニュアルで扱っているトピックの説明を参照
することができます。
『Siebel Tools ガイド』
『Siebel オブジェクトタイプリファレンス』
『Guide to Siebel Services』では、Siebel Technical Servicesおよび Professional Services
についての情報を参照できます。
これらのマニュアルを入手する場合は、Siebel Books Online をご利用ください。
Siebel Books Online には、Siebel Systems 社の Web サイト (http://www.siebel.com/)
の Worldwide Services からアクセスできます。ここでは、その他の Siebel マニュ
アルや Siebel Bookshelf (CD-ROM 版 ) をご注文頂けます。
関連情報は、Siebel オンラインヘルプにもあります。
次の Actuate Software Corporation マニュアルでも、Siebel アプリケーションへの
レポート実装に関する情報を入手できます。
『Using e.Reports』
『Developing Advanced e.Reports』
これらのマニュアルのコピーは、Actuate Software Corporation から入手できます。
これらのマニュアルは PDF 形式で Siebel Bookshelf CD-ROM の Third Party フォル
ダにも含まれています。Siebel レポートガイドを使用するには、これら 2 つのマ
ニュアルで説明している内容についての十分な理解が必要です。特に、
『Developing Advanced e.Reports』はこのマニュアルの内容を理解するために必要
な概念的バックグラウンドについて説明しています。Actuate マニュアルに含ま
れるその他のマニュアルも役に立ちます。
はじ め に - 6
Siebel レポートガイド
バージョン 6.0
Reports.book
7 ページ
２００１年４月２７日　金曜日　午前１１時２７分
はじめに
Siebel テクニカルサポートへの連絡
Siebel テクニカルサポートへの連絡
0
Siebel テクニカルサポートのご利用方法をご存知ですか。まず、サポートを受け
るための条件を理解することが重要です。これにより、最も素晴らしい成果を得
ることができます。ご不明な点がある場合は、いつでもお問い合せください。
Siebel 製品についての理解を最大限に深めて、投資収益を上げるには、次のよう
な方法があります。
■
Siebel のトレーニングを受講して、「指定担当者」となる必要があります。
■
このトレーニングを受講した指定担当者が、ユーザーにテクニカルサポート
を提供します。Siebel テクニカルサポートは、
「指定担当者」だけを対象にし
ています。
次のような方法でサポートを効果的にかつ迅速に提供し、問題に対処できるよう
にしています。
■
Siebel テクニカルサポートは主に Web ベースで提供され、Siebel SupportWeb
(http://supportweb.siebel.com) からアクセスできます。新しいサー
ビスリクエストがある場合は、SupportWeb にご登録ください。SupportWeb で
は、解決策のナレッジベースを検索することもできます。
■
指定担当者には、SupportWeb への読み込み / 書き込みアクセス権が与えられま
す。プロジェクトチームのその他のメンバー全員には、読み込み専用アカウ
ントが与えられ、ナレッジベースのサポートを受けることができます。
Siebel トレーニングに登録するには、http://www.siebel.com/japanese/
siebeluni_JPN.html にアクセスして、Siebel University トレーニングコースを
選択してください。これまでの説明に関してのご質問は、次の Siebel テクニカルサ
ポートまでお問い合せください。
eBusiness のお客様 : [email protected]
米国 :
ロンドン :
800.214.0400 または 650.295.5724
+44.1784.494.949
東京 :
ミュンヘン : +49.89.95718.400
バージョン 6.0
03.5469.3811 ( 代表 )
シンガポール : +65.320.8533 ( 代表 )
Siebel レポートガイド
は じ めに - 7
Reports.book
8 ページ
２００１年４月２７日　金曜日　午前１１時２７分
はじめに
Siebel へのご意見
技術的な問題やアップデートに関する質問は Siebel SupportWeb にご連絡ください
(http://supportweb.siebel.com)。SupportWeb アカウントがない場合は、
ここで示した各アドレスに電子メールでご連絡ください。Siebel テクニカルサ
ポートがお役に立てることを願っています。
Siebel へのご意見
0
Siebel では、今後リリース予定のバージョンに反映させるため、修正すべき点ま
たは不明な箇所など、お客様からのご意見をお待ちしております。ご意見をお寄
せいただく際には、次の情報をお知らせください。
■
このマニュアルのタイトルとバージョン
■
お名前、会社名、部署または役職、電話番号、電子メールアドレス
郵便または電子メールをご利用ください。連絡先は次のとおりです。
Siebel Systems, Inc.
Technical Publications Department
1855 South Grant Street
San Mateo, CA 94402-2667
[email protected]
ご意見、ご感想をお待ちしております。
はじ め に - 8
Siebel レポートガイド
バージョン 6.0
Reports.book
1 ページ
２００１年４月２７日　金曜日　午前１１時２７分
Siebel レポート
1
概要 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2
開発環境 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4
Actuate ファイルタイプ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4
ディレクトリ構造 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-5
Actuate ライブラリ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-7
Actuate デザインファイル . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-9
Siebel-Actuate 相互作用 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-12
ランタイム行動 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-15
レポートのデータ定義 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-17
データ供給 .ROL ファイル . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-18
Siebel レポートオブジェクトタイプ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-20
追加の Siebel-Actuate レポート項目 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-23
インストール . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-23
動的レポートと静的レポート . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-24
ssSiebel.bas と移行条件 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-24
レポートデザインとライブラリファイルのバックアップ . . . . . . . . . . . . . . 1-25
レポートの電子メールによる送付 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-25
バージョン 6.0
Siebel レポートガイド
1-1
Reports.book
2 ページ
２００１年４月２７日　金曜日　午前１１時２７分
Siebel レポート
概要
概要
A
Siebel アプリケーションには、出荷時に 100 以上の標準レポートが添付されてい
ます。これらのレポートを修正したり新規レポートを追加したりするには、この
ガイドで説明するように、Siebel Tools と Actuate Developer Workbench を使う必要
があります。
レポートは 2 つの場所で作成、修正することができます。
„
Siebel Tools では、Report ( およびその他の ) オブジェクト定義を作成、修正し、
その中にプロパティを設定します。これらのオブジェクト定義はランタイム
で実行されます。
„
Actuate Developer Workbench では、.ROD ( レポートオブジェクトデザイン ) ファ
イルを作成、修正します。これらのファイルはコンパイルして実行されます。
Siebel Tools または Actuate Developer Workbench の一方にのみ変更を加えても、両
方のレポートデザイン作業に変更と追加が必要になる場合がよくあります。
Siebel Tools 修正では、レポート、レポートフィールド、サブレポート、サブレ
ポートフィールド、ビューレポートのオブジェクトタイプを使用します。これら
の修正は次の領域に影響を与えます。
„
Siebel アプリケーションから Actuate レポートにエクスポートされたデータの
構造定義。Actuate レポートはデータストリームにこれらのデータを受取り
ます。
„
特定のビューの [ レポート ] メニューへのレポート添付。
Actuate Developer Workbench で .ROD ファイル修正を行うと、レポートの動作、
外観、データ取得、その他レポートを定義するさまざまなクラスとサブクラスが
変更されます。
1- 2
Siebel レポートガイド
バージョン 6.0
Reports.book
3 ページ
２００１年４月２７日　金曜日　午前１１時２７分
Siebel レポート
概要
Actuate Developer Workbench はレポートデザイン (.ROD ファイル ) からオブジェ
クト指向 Acutate BASIC コードが生成、コンパイルされるビジュアルデザインエ
ディタであり、ライブラリクラス (.ROL または Report Object Library ファイル )、
を実行可能レポートプログラムに照会します。結果的な実行可能プログラムは
.ROX ( レポート作成プログラム ) ファイルです。実行可能プログラムを実行する
と、レポート仕様とデータの両方を含むインスタンスファイルが作成されます。
インスタンスファイルは .ROI ( レポート作成インスタンス ) フォーマットで作成
され、Microsoft Windows クライアントを使用して Actuate レポートで表示する最
適な形式になっています。Web ブラウザが ( レポートサーバーから直接、または
シンクライアント環境で ) インスタンスファイルを要求した場合は、ROI からブ
ラウザ対応の DHTML フォーマットに変換されます。これについては図 1-1 で説
明しています。
デザイン
コードの生成
.ROD
ファイル
コンパイル
.BAS
ファイル
.ROL
ファイル
Actuate
ビューア
実行
.ROX
ファイル
.ROI
ファイル
レポート
サーバー
.DHTML
ファイル
図 1-1
バージョン 6.0
Web
ブラウザ
Actuate レポート生成と表示ステップ
Siebel レポートガイド
1-3
Reports.book
4 ページ
２００１年４月２７日　金曜日　午前１１時２７分
Siebel レポート
開発環境
図 1-1 で示すように、実行作業で生成された .ROI ファイルは、Actuate ビューアに
直接送信してただちに表示することも、レポートサーバーに送信して長期保存や
使用可能情報にしたり、システムプリンタで印刷したり、Web ブラウザやシンク
ライアントクライアントでアクセスすることもできます。ユーザーはレポートを
要求するときに、即時表示 ( クライアントモードレポート ) にするかレポートサー
バー処理 ( サーバーモードレポート ) にするかを指定します。レポートサーバー、
Web ブラウザ、シンクライアントのレポートへのアクセスについては第 12 章
「サーバーベースおよび シンクライアントのレポート機能」で説明しています。
開発環境
A
この項では Actuate 開発環境を Siebel レポートに適用するための特定の機能に関
する概要について説明しています。Actuate Developer Workbench を使用するため
の要件については、Actuate マニュアルの『Developing Advanced eReports』で詳
細に説明しています。
Actuate ファイルタイプ
A
Actuate は次の 6 つのファイルタイプを使用または生成します。
1- 4
„
ROD ( レポートオブジェクトデザイン )
.ROD ファイルはレポートレイアウトファイルです。.ROD ファイルは標準レ
ポートごとにあり、レポートを新しく作成するたびに新規 .ROD ファイルを作
成します。標準レポートの .ROD ファイルは Siebel Tools に添付されています。
„
ROL ( レポートオブジェクトライブラリ )
.ROL ファイルはライブラリファイルです。ライブラリファイルには再利用可
能なコンポーネントが含まれており、デザインファイルに追加することがで
きます。ライブラリからオブジェクトをサブクラスへ分類、コピー、参照で
きるため、既存のものを再利用すれば構築方法を理解する必要がありません。
„
BAS (BASIC ソースコード )
.BAS ファイルは構築およびコンパイルプロセスで生成されます。BAS はコ
ンパイル対象の .ROD および .ROL ファイルからのすべてを含むライブラリ
モジュールから作成されます。これは後に続くコンパイルステップで使用さ
れる中間ファイルフォーマットであり、開発者が直接修正するものではあり
ません。.BAS ファイルはレポートデザインに包合する再利用可能 Actuate
BASIC ルーチンを実装するためにも使用されます。
Siebel レポートガイド
バージョン 6.0
Reports.book
5 ページ
２００１年４月２７日　金曜日　午前１１時２７分
Siebel レポート
開発環境
„
ROX ( レポート作成プログラム )
.ROX ファイルはコンパイルされた .ROD ファイルである実行可能レポートで
す。レポートを実行すると Siebel アプリケーションが .ROX ファイルを実行
します。Siebel アプリケーションには標準レポートの .ROX ファイルが含ま
れることに注意してください。標準レポートをカスタマイズしたり新しいレ
ポートを作成したりするときには、関連する .ROX ファイルを削除するか、
または適切なディレクトリに追加して Siebel アプリケーションが利用できる
ようにします。
„
ROI ( レポート作成インスタンス )
インスタンスファイルは ( シンクライアントモードではなく接続クライアン
トで ) Siebel アプリケーションの Actuate ウィンドウでレポートが実行されて
いるときにユーザーに見えるファイルです。インスタンスファイルに何らか
の作業を行うのは、レポートを保存したり、外部ビューアを使用して表示し
たりするときだけです。
„
DHTML (Web ページ )
DHTML ファイルはシンクライアントモードで、Actuate ウィンドウでレポー
トが実行されているとき、または Web ブラウザを使用してレポートサーバー
から取得されているときにのみ表示することができます。
ディレクトリ構造
A
Siebel 環境の Actuate ファイルは次の Siebel 開発のサブディレクトリおよびクラ
イアントディレクトリに保存されます。
„
バージョン 6.0
実行可能ディレクトリ
C:¥Siebel_client¥reports¥language_code。英語圏ユーザーの標準インストールで
は、C:¥Siebel¥reports¥enu になります。レポート作成プログラム (.ROX ファイ
ル ) はこのディレクトリに表示され、実行されます。Siebel アプリケーション
を C:¥Siebel 以外のディレクトリにインストールする場合は、Siebel eBusiness
Applications ソフトウェアが保存されているディレクトリの ¥reports サブディレ
クトリにします。複数の言語をサポートしている場合は、それぞれに対して
¥reports のサブディレクトリが個別に与えられており、言語コードで識別され
ています。たとえば、C:¥Siebel¥reports¥deu や C:¥Siebel¥reports¥jpn などになり
ます。
S
i ebel レポートガイド
1 -5
Reports.book
6 ページ
２００１年４月２７日　金曜日　午前１１時２７分
Siebel レポート
開発環境
„
開発ディレクトリ
C:¥Siebel_development¥rptsrc¥language_code Rptsrc は開発ディレクトリであり、
.ROD と .ROL ファイルが含まれています。通常のインストールでは、
C:¥Siebdev¥rptsrc です。言語別にサブディレクトリに分けられます。ユーザー
が作成する新規レポートは ¥language_code サブディレクトリに保存します。各
言語のサブディレクトリはさらに ¥standard と ¥lib に分けられて、
C:¥Siebdev¥rptsrc¥enu¥standard と C:¥Siebdev¥rptsrc¥enu¥lib になります。
„
標準レポートディレクトリ
C:¥Siebel_development¥rptsrc¥language_code¥standard たとえば
C:¥Siebdev¥rptsrc¥enu¥standard です。このサブディレクトリには標準レポート
のデザインファイルが保存されています。このディレクトリにカスタムレ
ポートを保存しないでください。カスタムレポートは ¥language_code に保存
するか、または ¥language_code のサブディレクトリを作成し、¥custom などの
名称を付けます。
„
ライブラリディレクトリ C:¥ Siebel_development¥rptsrc¥language_code¥lib たと
えば C:¥Siebdev¥rptsrc¥enu¥lib です。データストリーム ( ソースデータ定義 )
ファイルがここに保存されています。Siebel Tools で作成されます。このフォ
ルダにはすべての Siebel レポートが使用するライブラリファイル
(ssSiebel.rol、ssCustom.rol など ) も保存されます。
.ROD ファイルの開発を標準レポートディレクトリで行うか開発ディレクトリで
行うかは標準レポートを作成するか新規レポートを作成するかによって異なりま
す。完成したデザインを Actuate Developer Workbench でコンパイルし、生成され
た .ROX ファイルを実行可能ディレクトリに移動します。最初に、.ROX ファイ
ルをユーザーのコンピュータでテスト用に開きます。開く準備ができたら .ROX
ファイルは各クライアントコンピュータのこの位置に移動します。
1- 6
Siebel レポートガイド
バージョン 6.0
Reports.book
7 ページ
２００１年４月２７日　金曜日　午前１１時２７分
Siebel レポート
開発環境
Actuate ライブラリ
A
標準、カスタムを問わずすべての Siebel レポートには次のライブラリが含まれて
います。
バージョン 6.0
„
AFC.rol
これは Actuate Foundation Class ライブラリです。Actuate の基本オブジェクト
がすべて含まれています。ssSiebel.rol のコンポーネントはすべて、このライ
ブラリから引き出されます。このライブラリの内容は修正しないでください。
„
ssSiebel.rol
Siebel ライブラリです。AFC.rol から導出され、ssCustom ライブラリの基本ク
ラスをすべて含んでいます。ssCustom.rol の一部として自動的に含まれます。
ssSiebel.rol の内容は修正しないでください。
„
ssCustom.rol
カスタムライブラリです。ssSiebel.rol ライブラリから導出されます。
ssCustom.rol は修正してフォント、ヘッダーなど全レポートに影響を与える全
体的な変更を加えることができます。作成または修正しているレポートデザ
インファイルに ssCustom.rol から細分化またはコピーされたオブジェクトを
たびたび組み込むことになります。
„
<reportname>.rol
データ供給ライブラリファイルです。Siebel アプリケーションでは、Actuate
レポートごとに 1 つあります。たとえば、ACLIST ( 取引先リスト ) レポート
には Aclist.rol と呼ばれるデータストリームファイルがあります。データ供給
ライブラリファイルは、[Tools] メニューから [Generate Actuate Report] オプ
ションを選択するときに、現在選択しているレポートオブジェクト定義に対
して Siebel Tools から自動的に生成されます。
„
ssSiebel.rol
Siebel BASIC ファイルです。すべての Siebel レポート、特に Siebel と Actuate
間のオブジェクトとデータインターフェースが使用するメソッドを含む
BASIC ソースコードファイルです。デフォルトで全標準レポートに含まれて
いますが、カスタムレポートにも含めてサーバーレポートで正しく作動する
ようにします。
Siebel レポートガイド
1-7
Reports.book
8 ページ
２００１年４月２７日　金曜日　午前１１時２７分
Siebel レポート
開発環境
図 1-2 は、レポートデザインファイルにおいてコンポーネントの継承構造を示し
たものです。
Afc.rol
ssSiebel.rol
<reportname>.rol
データストリーム
およびDataRow
コンポーネント
図 1-2
ssCustom.rol
表示レイアウト
およびその他諸々
のコンポーネント
<reportname>.rod
Siebel レポートにおけるコンポーネントの継承構造
ssSiebel.rol ライブラリのクラスは Actuate Foundation Class ライブラリから導出
されます。一方 ssCustom.rol のクラスは ssSiebel.rol クラスから導出されます。
ssSiebel.rol ライブラリは Siebel の製品改良のために確保されており、開発者が
修正することはできません。ssCustom.rol ライブラリのライブラリの多くはレ
ポートデザインで修正されることなく使用されますが、開発者が修正できるよ
うに提供されています。ssCustom.rol ライブラリは修正してもかまいませんが、
ssSiebel.rol ライブラリは絶対に修正しないでください。
1- 8
Siebel レポートガイド
バージョン 6.0
Reports.book
9 ページ
２００１年４月２７日　金曜日　午前１１時２７分
Siebel レポート
開発環境
Actuate デザインファイル
A
.ROD ファイルはレポートデザインファイルです。レイアウト、構造、レポートの
行動を定義します。標準 Siebel レポートの .ROD ファイルは Siebel Tools に添付され
ています。デザインファイルは [ デザインエディタ ] ウィンドウと呼ばれる Actuate
Developer Workbench ソフトウェアのメインウィンドウで修正されます。[ デザイン
エディタ ] に表示される商談概要レポートのデザインファイル (Opsum.rod) を図 1-3
に示します。
図 1-3
デザインエディタにおける Siebel レポートのレポートデザイン
バージョン 6.0
Siebel レポートガイド
1-9
Reports.book
10 ページ
２００１年４月２７日　金曜日　午前１１時２７分
Siebel レポート
開発環境
[ デザインエディタ ] ウィンドウでは、左側にツリー構造、右側にレイアウトグ
リッドが表示されます。ツリー構造にはコンポーネントが表示されます。これら
のコンポーネントを持つノード ( スロット ) のタイプは用途とレポートにおける
行動によりさまざまです。特定のアイコンにより、該当するコンポーネントタイ
プが識別されます。構造のノードタイプには特に次のようなものがあります。
„
Report ノード
現レポートを識別します。トップレベルコンポーネントです ( インストール
の OPSUM)。
„
Content ノード
レポートの一部で、コンテントがどこからくるか、どのようにレイアウトさ
れているかを識別します。コンテントノードには通常、ビジュアルレポート
要素のレイアウト方法であるフレーム ( 方形レポートエリア ) に該当する
PageHeader、Before、Content、After、PageFooter ノードが含まれます。
„
DataStream ノード
データソースを識別します。Siebel アプリケーションのレポートでは、現
ビューに対応する列セットがあり、カラムは 1 つまたは複数のビジネスコン
ポーネントからのものです。構造の DataStream ノードは実際に、Siebel Tools
のレポート ( および子 ) オブジェクト定義の内容にもとづく Siebel Tools から
生成される外部ライブラリファイルを示しています。
„
PageList ノード
レポートの一般的なページレイアウト情報が保存されており、通常は全レ
ポートに共通する外部ライブラリファイルから取得されます。
Actuate がオブジェクト指向ソフトウェア製品になるようにリコールします。構
造ツリーのアイコンはそれぞれオブジェクトを表し、それぞれに子オブジェクト
( ツリー参照 ) とユーザーが編集できるプロパティリストがあります。この外観
は、Siebel Object Explorer に似ています。
1- 1 0
Siebel レポートガイド
バージョン 6.0
Reports.book
11 ページ
２００１年４月２７日　金曜日　午前１１時２７分
Siebel レポート
開発環境
Actuate のオブジェクトに割り当てられたクラスによりその行動が決定されます。
新規オブジェクトを作成したり、またはある場所から別の場所へ移動したりする
場合は、オブジェクトと現クラス間の関係を変更しないように注意してください。
ただし、明確に指定した場合は除きます。次の 3 つのコンセプトはオブジェクト
とクラスの関係変更に関するものです。
„
サブクラス化
独自にクラスを作成するオブジェクトをサブクラス化します。このクラスは
オリジナルオブジェクトのクラスにもとづき、リンクされています。オリジ
ナルオブジェクトに加えられる更新はすべて、新規オブジェクトに継承され
ます。ただし、サブクラスで変更した部分への更新は継承されません。この
技法は Siebel レポートではよく使用されます。これは、Siebel システムが
Siebel 製品の更新に伴って新規行動をレポートに継承させるためです。
„
参照
参照とは、新規コンポーネントの作成ではなく既存のコンポーネントを参照
することです。既存のコンポーネントがユーザーの要求を満たしており、将
来どのような変更が加えられようともそのものを使用したいという場合に参
照を使用します。
„
コピー
コンポーネントをレポートデザインのある場所から別の場所にコピーできま
す。コンポーネントをコピーすると、コピー元のコンポーネントとの関連性
は失われます。
これらのコンセプトに関する情報については、Actuate Developer Workbench マ
ニュアルの『Developing Advanced e.Reports』を参照して Actuate コンセプトにつ
いてすべて確認してください。
バージョン 6.0
Siebel レポートガイド
1- 1 1
Reports.book
12 ページ
２００１年４月２７日　金曜日　午前１１時２７分
Siebel レポート
Siebel-Actuate 相互作用
Siebel-Actuate 相互作用
A
Siebel 専用クライアントアプリケーションで [ レポート ] メニューからレポートが
選択されると Actuate ビューアが ActiveX コンポーネントとして呼び出されます。
[ レポート ] メニューは現ビュー特有のものであり、ビューおよび関連ビューに表
示されるデータにもとづくレポートをリストします。
呼び出された Actuate ビュー
アのウィンドウには選択したレポートが表示され、参照および印刷できます。
Siebel アプリケーションでは、Actuate ビューアは Siebel レポートビューアと呼ば
れています。図 1-4 は、Siebel Sales から呼び出された Siebel レポートビューアを
示しています。
埋め込まれた Actuate ビューアのウィンドウ
図 1-4
Siebel Sales の Actuate ビューア
1- 1 2
Siebel レポートガイド
バージョン 6.0
Reports.book
13 ページ
２００１年４月２７日　金曜日　午前１１時２７分
Siebel レポート
Siebel-Actuate 相互作用
Siebel シンクライアントでは、レポートインスタンスは .ROI フォーマットでは
なく .DHTML フォーマットでクライアントから入手されます。Siebel レポート
ビューアは Web ブラウザの子ウィンドウです。
現ビジネスオブジェクト ( ビューから入手 ) とクエリーにより、レポートに送信
されるデータを決定するコンテキストが作成されます。Windows のクライアント
レポート作成モードでは、データは Siebel アプリケーションと埋め込まれた
Actuate ビューア間の COM インターフェースで変数により受け渡されます。アク
セスはレポートデザインのメソッドを使用して実行されます。サーバーレポート
モードで、またはユーザーがシンクライアントからレポートを起動している場合、
オブジェクトインターフェースはオブジェクトマネージャとレポートサーバー間
にあります。
[ レポート ] メニューからレポートを選択して Windows でクライアントレポート作
成モードを指定すると、該当するレポート作成プログラム (.ROX ファイル ) がロー
カルで起動されて、その結果生成されるインスタンス (.ROI ファイル ) が表示され
ます。ユーザーがシンクライアントを実行している、またはサーバーレポートを作
動環境で指定している場合、レポート作成プログラムは適当な時間にレポートサー
バーで起動され、インスタンスがレポートサーバーに保存されます。環境とユー
ザーの依頼によっては、システムプリンタに送信されたりレポートサーバーから自
動的に取得されてローカルに表示されたりすることもあります。
バージョン 6.0
Siebel レポートガイド
1- 1 3
Reports.book
14 ページ
２００１年４月２７日　金曜日　午前１１時２７分
Siebel レポート
Siebel-Actuate 相互作用
View Report オブジェクト定義が View オブジェクト定義の子として存在するため、
ビューごとに利用できるメニューオプションがあります。各 View Report オブジェ
クト定義は Report オブジェクト定義とレポート名を参照します。これについては
図 1-5 で説明しています。
View
Report
プロパティ
View Report
Report
Access Base
DB Name
プロパティ
.ROX
ファイル
ローカル
モード
.ROI
ファイル
Actuate
ビューア
実行可能
ディレクトリ
説明
オブジェクト定義
含まれる
(子)オブジェクト定義
他のオブジェクト定義を
指定するプロパティ
図 1-5
先送りモード
または
シンクライアント
レポート
サーバー
メニューオプションのビューへの実装
Siebel アプリケーションの実行で利用できる .ROX フォーマットのレポートは次
のディレクトリでロケールごとに保存されています。
C:¥Siebel_client¥reports¥language_code
言語コードはアプリケーションの起動に使用される .CFG ファイルで指定された
現ロケールにあります。たとえば、英語のレポート作成プログラムは
C:¥Siebel¥reports¥enu にあり、言語が英語の場合 ( アプリケーションの .CFG ファ
イルの言語パラメータが定義されていない場合、あるいは ENU に設定されてい
る場合 ) は、識別されたレポート作成プログラムをこのディレクトリから取得し
ます。ロケールごとに 1 つのディレクトリがあり、個別のディレクトリには別の
ロケール固有レポート作成プログラムが格納されています。たとえば、¥deu の
フォルダには、ドイツ語レポート作成プログラムがあります。
1- 1 4
Siebel レポートガイド
バージョン 6.0
Reports.book
15 ページ
２００１年４月２７日　金曜日　午前１１時２７分
Siebel レポート
Siebel-Actuate 相互作用
ランタイム行動
A
Siebel アプリケーション、Actuate ソフトウェアコンポーネント、Siebel 環境用に
デザインされた Actuate レポートの関連性を ( クライアントレポート作成モード
で ) 実際に実行してみることができます。
Siebel レポートと Actuate、Siebel ソフトウェア間の関連性を確認するには
1 Siebel アプリケーションがデスクトップで実行されている場合は、終了します。
2 Actuate Developer Workbench ソフトウェアを起動します。
3 [ ファイル ] → [ 開く ] を選択します。
4 C:¥Siebdev¥rptsrc¥enu の Aclist.rod を開きます。
5 [ 構築と実行 ] ボタンをクリックしてレポートをコンパイルし、実行します。
次のようなエラーメッセージが表示されます。
6 エラーダイアログボックスを閉じてレポート実施を停止してください。
7 デスクトップのアイコンまたは [ スタート ] メニューから Siebel Sales を起動
し、[ 商談 ( 個人 )] ビューを開きます ( タブバーの [ 商談 ] をクリックします )。
結果を表示するために、無効なビューをあえて開きます。
8 開いたままになっている Siebel アプリケーションで Actuate Developer
Workbench に戻ります。
バージョン 6.0
Siebel レポートガイド
1- 1 5
Reports.book
16 ページ
２００１年４月２７日　金曜日　午前１１時２７分
Siebel レポート
Siebel-Actuate 相互作用
9 [ 構築と実行 ] ボタンをクリックしてレポートを再度実行します。
今回は次のような別のエラーメッセージが表示されます。
エラーダイアログボックスを閉じてください。
10 Siebel Sales に戻り、[ 取引先 ( 個人 )] ビューに移動します ( タブバーの [ 取引
先 ] をクリックします )。
11 Actuate Developer Workbench に戻り、[ 構築と実行 ] ボタンをクリックします。
今回は取引先リストレポートが正常に表示されます。
この練習では、2 つの条件が揃わなければ Actuate で Siebel レポートをローカル
で実行できないことを説明しています。
„
Siebel アプリケーションが実行されており、Siebel ソフトウェアが OLE コンテ
ナとして利用可能であること。
„
アプリケーションの現ビューが正しいビジネスオブジェクトにもとづいてお
り、実行されるレポートにデータを供給できること。この例では、取引先
データをリストするレポートには Accounts ビジネスオブジェクトにもとづく
ビューがアクティブになっていることが必要です。
Siebel レポートは実行されるようにデザインされたビューからのみ実行されるた
め、Siebel アプリケーションが適切に設定されていればこのようなエラーは発生
しません。
ユーザーがクエリーのデータを制限する場合、クエリーの制限に一致するデータ
しかレポートに表示されないことに注意してください。Siebel アプリケーション
は現クエリーからのデータのみを Actuate ビューアに渡します。
1- 1 6
Siebel レポートガイド
バージョン 6.0
Reports.book
17 ページ
２００１年４月２７日　金曜日　午前１１時２７分
Siebel レポート
レポートのデータ定義
レポートのデータ定義
A
Siebel レポートの .ROD ファイルは Actuate で Siebel 以外のレポートで使用した
データソースやクエリー定義ではなく、
.ROL ファイルからのデータストリームコ
ンポーネントを参照しなければなりません。これは、Actuate ビューアがデータ
ベース自体に直接アクセスするのではなく、Siebel オブジェクトインターフェー
スからデータを取得するためです。データアクセスがデータオブジェクトレベル
ではなく、常にビジネスオブジェクトでデータアクセスが実行される Siebel 標準
と一致します。
Siebel アプリケーションと実行可能 Actuate では、エクスポートされたデータの構
造が一致していなければ、データをレポートで使用することができません。この
ため、各レポートのデータ構造はレポートオブジェクト定義とその子を使用して
Siebel Tools で定義されています。次に、Siebel Tools の [Tools] メニューにある
[Generate Actuate Report] オプションを使用して、.ROL フォーマットでデータスト
リームファイルにエクスポートされます。生成される .ROL ファイル名は Siebel
Tools のレポートオブジェクト定義において、Template Name プロパティで指定さ
れます。
データ供給 .ROL 名、レポートデザイン、実行可能ファイルの関連性について
は、表 1-1 で説明します。
表 1-1
バージョン 6.0
.ROL、.ROD、.ROX ファイル名の関連性
ファイル
使用方法
名前の指定場所
データ供給 .ROL
ファイル
Siebel Tools で生成され、
組み込みモジュールとして
.ROD にロードされます。
Report オブジェクト定義の Template
Name プロパティ
レポートデザイン
(.ROD) ファイル
レポートのレイアウトと行
動を指定し、.ROX にコン
パイルされます。
Report オブジェクト定義の Access
Base DB Name プロパティを使用して
Siebel アプリケーションに識別され
ます。元来は Actuate Developer
Workbench で作成されます。
実行可能 (.ROX)
ファイル
実行時にレポートを実行し
ます。
ファイル名拡張子を除外して、.ROD
と同じ名前を自動的に受取ります。
Siebel レポートガイド
1- 1 7
Reports.book
18 ページ
２００１年４月２７日　金曜日　午前１１時２７分
Siebel レポート
レポートのデータ定義
規則により、生成された .ROD ファイルの名前は組み込み先の .ROD ファイルの
名前と同じになります。たとえば、Opportunities – Summary Report オブジェクト
定義は Template Name と Access Base DB Name プロパティの両方に「OPSUM」と
いう名前を指定し、対応するレポートデザインファイルは Opsum.rod になります。
データ供給ライブラリファイルがSiebel Toolsからこのレポートにエクスポートさ
れると、Template Name 設定により Opsum.rol という名前が与えられます。.ROD
ファイルをコンパイルすると、その結果生成される実行可能ファイルには、
Actuate Developer Workbench により Opsum.rox という名前が与えられます。Siebel
アプリケーションがビューから実行可能ファイルを起動する場合、Access Base
DB Name 設定により Opsum.rox が起動されます。
備考 : データ供給 .ROL ファイル名とそのファイルを組み込む .ROD ファイル名
が必ずしも一致する必要はありません。ただし、各 .ROD ごとにデータ供給
.ROL ファイルを区別し、可能であれば名前を一致させるほうが望ましいと言え
ます。
データ供給 .ROL ファイル
A
すべての .ROL ファイルには Actuate Developer Workbench でデザインファイルに
細分化できる再利用可能コンポーネントが含まれています。たとえば、第 2 章
「グローバルなレポート修正」で説明しているように、ssCustom.rol のラベル、テ
キスト、フレームコントロールなどのデザイン要素はレポートデザインローカル
により細分化されます。対応するデザインファイル内へのデータ供給ライブラリ
ファイルの組み込みは、このサブクラス化方法の特殊な用途になります。レポー
トデザインローカルは対応するデータ供給 .ROL ファイルからデータストリーム
コンポーネントを細分化します。
データストリームコンポーネントには Siebel オブジェクトインターフェースを通
じて正しいビジネスオブジェクトから必要なレポートデータにアクセスする方法
が含まれています。複数のデータ行コンポーネントがデータストリームで使用す
るように定義され、それぞれはレコードが検索対象になるビジネスコンポーネン
トのフィールドリストを指定しています。現クエリー ( およびあればサブクエ
リー ) のレコードがすべて取得され、レポートに処理されるまでデータストリー
ムコンポーネントの論理がデータ行のインスタンスをフェッチし、削除します。
データストリームとデータ行コンポーネントの内容は Method Editor と Component
Editor を使用してレポートデザインでビューできます。
1- 1 8
Siebel レポートガイド
バージョン 6.0
Reports.book
19 ページ
２００１年４月２７日　金曜日　午前１１時２７分
Siebel レポート
レポートのデータ定義
データストリームコンポーネントの内容をビューするには
1 標準 Siebel レポート (C:¥Siebdev¥rptsrc¥enu¥standard の Actlist.rod など ) を
Actuate Developer Workbench で開きます。
2 メインレポートセクションコンポーネントを展開してコンポーネントツリー
のデータストリームコンポーネントを強調表示します。メニューバーから
[ 表示 ] → [ メソッドエディタ ] を選択します。
[ メソッドエディタ ] ウィンドウが開きます。
3 ウィンドウの左上にあるメソッドピックリストから Start を選択します。
データストリームの Start メソッドに関するテキストが [ メソッドエディタ ]
ウィンドウに表示されます。
4 このメソッドのコードを検証します。このコードがビジネスコンポーネント
のエクスポートされたフィールドをそれぞれ活動化します。
5 メソッドピックリストで Fetch を選択して Fetch メソッドのコードを検証しま
す。エクスポートされたフィールドごとにコードが値を取得する方法に注意
してください。
レポートのデータ供給ライブラリは [ ファイル ] → [ モジュールのインクルード
] メニューオプションを Actuate Developer Workbench で選択して起動し、レポー
トデザインにロードします。データストリームとデータ行コンポーネントローカ
ルが Actuate Foundation Class ライブラリの AcDataSource と AcDataRow コンポー
ネントをそれぞれサブクラス化します。データ供給ライブラリファイルのメソッ
ドが Foundation Class ライブラリの該当するメソッドを置き換えます。これらの
メソッドの内容は生成されたコードであり、Siebel Tools のレポートフィールド
のリストおよび他のレポートオブジェクト定義プロパティと子から作成されたも
のです。
データ行コンポーネントの内容をビューするには
1 まだ標準 Siebel レポートを開いていない場合は前の手順 1 を実行してください。
2 コンポーネントツリーのデータストリームコンポーネントを展開してデータ
行コンポーネントを強調表示します。
3 データ行コンポーネントを右クリックしてポップアップウィンドウから [ プ
ロパティ ] を選択します。
[ コンポーネントエディタ ] ウィンドウが開きます。
バージョン 6.0
Siebel レポートガイド
1- 1 9
Reports.book
20 ページ
２００１年４月２７日　金曜日　午前１１時２７分
Siebel レポート
レポートのデータ定義
4 [ 変数 ] タブをクリックします。
データ行で定義された変数のリストが表示されます。
5 変数名は RowNumber を除き、灰色ではなく黒文字になっていることに注意
してください。これらの変数が親 AcDataRow クラスではなく、クラスコード
でローカルに定義されたことを示しています。
6 変数名はビジネスコンポーネントからの修正されたフィールド名であること
に注意してください。接頭辞 ss がそれぞれに追加され、スペースと特殊文字
が下線 (_) 文字で置き換えられています。
エクスポートされたレポートフィールドのリストに対応する変数セットの自動定
義は、データ供給ライブラリで生成されたコードの一部の役割です。
Siebel レポートオブジェクトタイプ
A
次の (Siebel Tools の ) オブジェクトタイプが各レポートのデータ構造定義とその
レポートのデータ供給 .ROL ファイル生成に使用されます。
„
1- 2 0
Report オブジェクトタイプ
Report オブジェクト定義は 1 つのレポートに対して高レベルプロパティを提
供します。レポートのプロパティはレポート作成プログラムと生成された
データ供給ライブラリのファイル名、ビジネスコンポーネント名、レポート
タイプ (Actuate または Access) などを識別します。
„
Business Component プロパティ データがメインレポートで使用されるビ
ジネスコンポーネントを指定します。サブレポートのビジネスコンポーネ
ントはサブレポートオブジェクト定義で指定されます。
„
Template Name プロパティ Siebel Tools で生成されたデータ供給ライブラ
リで、このレポートに関して Actuate に情報を供給するものの名前 ( 拡張
子 .ROL なし ) です。Access レポートの場合、このプロパティは空白にな
ります。また一部の予測レポートのような、Siebel Tools から生成するに
はデータ供給ライブラリファイルが複雑すぎてプログラムコードとして作
成しなければならない「手動で作成する」Actuate レポートの場合も空白
になります。
Siebel レポートガイド
バージョン 6.0
Reports.book
21 ページ
２００１年４月２７日　金曜日　午前１１時２７分
Siebel レポート
レポートのデータ定義
„
Access Base DB Name プロパティ Actuate レポートでは、実行可能なファ
イルの名前 ( 拡張子 .ROX を除く ) になります。レポートを選択したとき
に Siebel アプリケーションによって実行されるファイル名です。Access レ
ポートの場合は、レポート仕様を含む MDB ( データベース ) ファイル名
となります。
„
Class プロパティ CSSActuateReportViewer クラスは Actuate レポートを指定
します。CSSAccessReport クラスは Access レポートを指定します。
CSSReport クラスは Microsoft Excel または Crystal Reports 用の区切られた
テキストとして生成されるレポートを指定します。
備考 : このマニュアルは主に Actuate レポートを対象としたものです。
Siebel レポート用の、Actuate 以外のソフトウェア設定については、第 14
章「Actuate 以外のソフトウェア製品を使用した Siebel レポート」で説明
しています。
バージョン 6.0
„
Sort Specification プロパティ Report オブジェクト定義でソート条件を設定
すると、データストリームを介して、ソートした順序で Actuate に行を送
ることができます。ソート条件を設定しないと、行は現在のビューに表示
されている順序で送られます。Siebel アプリケーションから入ってくる
データを整理すると、少なくともレポートランタイムのパフォーマンスは
改善されます。レポートを正常に機能させるために、データ整理が必要と
なる場合があります。
„
Menu Textプロパティ このレポートをView Reportオブジェクト定義として
活動中のビューに取り込むための、[ レポート ] メニューに表示されるメ
ニューテキストです。
„
Client Only プロパティ Siebel シンクライアントまたはサーバーモードレ
ポートでレポートが利用可能かを決定します。TRUE であれば、レポート
は専用クライアントのクライアントモードレポートのみ利用可能です。
FALSE であれば、レポートは専用もしくはシンクライアントのどちらで
も、クライアントモードとサーバーモードレポートのいずれにも利用可能
です。見込みレポートはクライアント専用レポートの例です。
Siebel レポートガイド
1- 2 1
Reports.book
22 ページ
２００１年４月２７日　金曜日　午前１１時２７分
Siebel レポート
レポートのデータ定義
„
Report Field オブジェクトタイプ
Report Field オブジェクト定義はレポートのビジネスコンポーネントからレ
ポートに組み込まれる 1 つのフィールドを指定します。Actuate レポートで
は、Report Field オブジェクト定義のリストは生成時にデータ供給ライブラリ
ファイルに組み込まれます。あるフィールドをデータストリームおよび実行
時のレポートに表示させるには、Siebel Tools を使って Report Field オブジェ
クト定義として含めなければなりません。実際にレポートで使用しない
フィールドでも作成できます。ただし、作成されたすべてのフィールドが取
り出されるため、使用しないフィールドを表示すると、レポートのパフォー
マンスが必要以上に低下するので注意してください。.ROL の各フィールドは
データストリームの子データ行コンポーネントで利用可能です。
„
Sub Report オブジェクトタイプ
Sub Report オブジェクト定義は詳細ビジネスコンポーネントからのデータを
使用しています。また、マスター詳細レポートの詳細部分を管理する情報が
含まれています。データ供給 .ROL ファイルには、メインレポートおよびレ
ポートの各サブレポート子に対する 1 つのデータストリームコンポーネント
が含まれています。各詳細データストリームコンポーネントは Sub Report オ
ブジェクト定義とサブレポートフィールド子から生成されます。
„
Sub Report Field オブジェクトタイプ
Sub Report Field オブジェクト定義はサブレポートのビジネスコンポーネント
からサブレポートに組み込まれる 1 つのフィールドを指定します。Sub Report
Field オブジェクト定義のリストはサブレポートデータストリームコンポーネ
ントに送られ、変数としてデータ行に保存されます。
次のオブジェクトタイプは特定のレポートを Report オブジェクト定義に従って
特定のビューに添付するために使用されます。
„
View Report オブジェクトタイプ
View Report オブジェクト定義は Report オブジェクト定義とビュー間に関連性
を作成し、ビューが活動中になるとレポートが [ レポート ] メニューで利用
可能になるようにします。
備考 : これらのオブジェクトタイプに関するプロパティ全般の情報については、
『Siebel オブジェクトタイプリファレンス』を参照してください。
1- 2 2
Siebel レポートガイド
バージョン 6.0
Reports.book
23 ページ
２００１年４月２７日　金曜日　午前１１時２７分
Siebel レポート
追加の Siebel-Actuate レポート項目
追加の Siebel-Actuate レポート項目
A
この項では、Siebel アプリケーションの報告に関するさまざまな追加項目につい
て説明します。
インストール
A
ソフトウェアインストールでは以下の点に注意してください。
„
Actuate Developer WorkbenchはActuateインストールCD-ROMからWindowsクラ
イアント PC にインストールされます。Actuate マニュアルの『Installing
Actuate Developer Workbench Release 4』の説明に従ってください。
„
レポートサーバーコンポーネントのインストールについては、『Siebel インス
トールガイド』で説明しています。
„
Actuate レポートビューアは Siebel アプリケーションにより自動的にインス
トールされます。
Tools.cfg (Siebel Tools の設定ファイル ) の次の設定ファイルについても注意して
ください。
„
ActuateDevWBDir
Developer Workbench ソフトウェアの位置を指定します。
„
TemplateDestDir
Siebel Tools からエクスポートされるときにデータ供給ライブラリファイルが
作成されるディレクトリの場所を指定します。デフォルトでは
C:¥Siebdev¥rptsrc¥enu¥lib になっています。
各 Siebel アプリケーション用の設定ファイルにある次のパラメータを指示に従っ
て設定してください。
„
バージョン 6.0
EnableOLEAutomation
これを TRUE に設定しなければ Siebel レポートのローカル生成が作動しませ
ん。これは Siebel オブジェクトインターフェース機能を使用しない場合、あ
るいはその機能を持っていない場合にも該当するので注意してください。
Siebel レポートガイド
1- 2 3
Reports.book
24 ページ
２００１年４月２７日　金曜日　午前１１時２７分
Siebel レポート
追加の Siebel-Actuate レポート項目
動的レポートと静的レポート
A
動的および静的レポートは Siebel Tools の動的ビュー設定にもとづくレポートの
2 つの分類です。これら 2 つの分類は次のように説明されます。
„
動的レポート
Dynamic View プロパティが TRUE に設定されているレポートです。動的レ
ポートのビューにはレコードが表示され、ここから、現クエリーにより表示
されるレコードのみ実行または包含できます。デフォルトでは、すべての標
準 Siebel レポートが動的になっています。
„
静的レポート
Dynamic View プロパティが FALSE に設定されているレポートです。静的レ
ポートは現クエリーを無視し、ユーザーの可視性について全ビジネスコン
ポーネントを確認します。特定の管理レポートにのみ適用されるレポートな
ど、ビューのデータがかなり制限されている場合には有用です。静的レポー
トのビジネスオブジェクト、ソート条件、検索条件をレポートオブジェクト
定義で直接指定します。
静的行動を希望する場合を除き、作成したカスタムレポートについて Dynamic
View プロパティを TRUE に設定してください。
ssSiebel.bas と移行条件
A
バージョン 6.0 から、Siebel レポートの全レポートデザインファイルに
ssSiebel.bas BASIC ファイルが含まれなければならなくなりました。これは、以
前とは異なるオブジェクトインターフェースメソッドが使用され、一部のメソッ
ドがこのファイルで参照されるためです。レポートデザイン移行に関する完全な
情報については、第 13 章「既存のカスタムレポートの バージョン 6.0 への移行」
を参照してください。オブジェクトインターフェースはサーバーレポートをサ
ポートするように変更されています。
その他の重要な移行条件には次のものがあります。データ供給 .ROL ファイルは
Siebel Tools バージョン 6.0 で生成されなければ、サーバーレポートで正しく作動
しません。6.0 以前の Siebel Tools バージョンで生成されるデータ供給 .ROL ファ
イルはクライアントレポートでは正しく作動しますが、サーバーレポートでは正
しく作動しません。ユーザーのカスタムレポートデザインファイル用に、データ
供給 .Rol ファイルを再度生成しなければなりません。
1- 2 4
Siebel レポートガイド
バージョン 6.0
Reports.book
25 ページ
２００１年４月２７日　金曜日　午前１１時２７分
Siebel レポート
追加の Siebel-Actuate レポート項目
レポートデザインとライブラリファイルのバックアップ
A
レポートソースファイル、特にレポートデザインファイルとライブラリファイル
の一連の開発ディレクトリを設定し、旧バージョンが上書きされないように注意
する必要があります。目的に適ったソースコードコントロールソフトウェアを採
用することが最も望ましい方法です。1 つの場所の単一の一連のソースファイル
に繰り返し複数の開発者が修正を加えるような場合、レポートデザインと開発努
力が失われてしまう危険性があります。ソースファイルをバックアップし、旧
バージョンを保持するシステムを備えることで、このようなリスクを大幅に減ら
すことができます。
レポートの電子メールによる送付
A
レポートインスタンス (.ROI) ファイルを他の Siebel ユーザーが見ることができ
るように送信できます。受信者は Srviewer.exe アプリケーション (C:¥Siebel¥bin
に格納されています ) を開き、ファイルを開くアイコンをクリックして指定する
.ROI ファイルに移動します。これにより、Actuate レポートビューアでレポート
インスタンスが開きます。
Siebel アプリケーションが実行されている場合や受信者側では、レポート生成に
必要なビューやデータを持っている必要はありません。これは、.ROI ファイル
が独立型であるためです。
ただし、Siebel 以外のユーザーに Srviewer.exe プログラムを送信することはでき
ません。レポート作成プログラムおよび特定の .DLL ファイルのインストールが
必要です。
Siebel 以外のユーザーでレポート出力の電子コピーが必要であれば、次の代替方
法のいずれかを採用することができます。
バージョン 6.0
„
レポートの場所を示す Web サーバーの URL を提供し、Web サーバーのレポー
トにログオンする適切な権限を持たせる。これについては 12-26 ページの
「ReportCast」で説明しています。これにはユーザーが Web サーバーにアクセ
スできることが必要です。
„
受入れ可能なレポートを HTML で作成して HTML ファイルで送信する。印刷
可能性、全レポートが 1 つの HTML ページになってしまうなど、制限がある
点に注意してください。
„
レポートサーバーにレポート出力が存在する場合は PDF フォーマットでダウ
ンロードしてファイルを送信します。
Siebel レポートガイド
1- 2 5
Reports.book
26 ページ
２００１年４月２７日　金曜日　午前１１時２７分
Siebel レポート
追加の Siebel-Actuate レポート項目
„
1- 2 6
適切な Adobe PDF プリンタドライバがインストールされている場合、ローカ
ルレポートはこのドライバで印刷して PDF ファイルを生成し、生成された
ファイルを電子メールで送信します。
Siebel レポートガイド
バージョン 6.0
Reports.book
1 ページ
２００１年４月２７日　金曜日　午前１１時２７分
グローバルなレポート修正
2
この章について . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2
全レポートのフォントの変更 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3
全レポートの企業ロゴの変更 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-10
バージョン 6.0
Siebel レポートガイド
2-1
Reports.book
2 ページ
２００１年４月２７日　金曜日　午前１１時２７分
グローバルなレポート修正
この章について
この章について
B
グローバルカスタマイズは、1 つのレポートに対してではなく、すべてのレポー
トに対して行います。カスタマイズは、ssCustom ライブラリのコンポーネント
で変更を行い、該当するコンポーネントを使用するすべてのレポートにその変更
を反映することで完了します。
グローバルなレイアウトのカスタマイズは、比較的短時間かつ簡単な作業で、修正
するプロパティの設定値も少なくてすむため、Siebel レポートのカスタマイズを理
解するのに適した内容です。グローバルな修正の典型的な例としては、ヘッダーに
異なる企業名あるいは企業ロゴを配置するなど、ヘッダーあるいはフッターへの修
正があります。また、別のグローバルな修正として、すべてのレポートのフォント
サイズおよびスタイルに異なる初期値を設定することもできます。
ライブラリコンポーネントを変更すると、そのコンポーネントを使ったすべての
レポートに反映されるため、グローバルなレポート修正になります。グローバル
な修正は常に ssCustom ライブラリで行います。たとえば、ssCustom ライブラリ
にある ssLbl ( ラベル ) コンポーネントのフォントのプロパティを編集すると、
ssLbl を使用するすべてのレポートで新たに指定したフォントが使用されます。
この変更を該当するレポートに反映させるには、そのレポートを再コンパイルす
る必要があります。
この章では、ssCustom ライブラリでページレイアウトオブジェクトを修正し、
レポートを再コンパイルしてグローバルなレイアウト変更をそのレポートに適用
できるようにする手順を説明します。次の 2 つの手順を例に説明します。
2- 2
„
すべてのテキストコントロールとラベルコントロールで使用されるフォント
のレポート全体での変更
„
すべてのレポートで使用される企業ロゴの変更
Siebel レポートガイド
バージョン 6.0
Reports.book
3 ページ
２００１年４月２７日　金曜日　午前１１時２７分
グローバルなレポート修正
全レポートのフォントの変更
全レポートのフォントの変更
B
すべてのテキストコントロールとラベルコントロールで使用されるフォントをレ
ポート全体で変更できます。次の手順に示すように、ssTxt ( テキスト ) ライブラ
リコントロールと ssLbl ( ラベル ) ライブラリコントロールの Font.FaceName プロ
パティを変更するだけです。レポートのテキストコントロールとラベルコント
ロールはすべて、ssTxt と ssLbl から取得されます。
適切な変更を実行してテストするには、次の手順を実行してください。
„
レポートデザインファイルを開く
„
ssCustom のラベルコントロールとテキストコントロールを編集する
„
レポートをコンパイルして実行する
„
変更内容を ssCustom に保存する
レポートデザインファイルと対応する Siebel ビューを開くには
1 Siebel Sales を起動します。
2 タブバーの [ 取引先 ] をクリックします。
[ 取引先 ( 個人 )] ビューが表示されます。この手順は必須で、これにより、
レポートをテストするときに Siebel データを Actuate レポートに送信できる
ようになります。
3 デスクトップまたは [ スタート ] メニューから、Actuate Developer Workbench
ソフトウェアを起動します。
4 [ ファイル ] → [ 開く ] を選択します。
C:¥Siebel¥rptsrc¥enu¥standard フォルダの位置を検索して [Aclist.rod] を選択し
ます。
[ デザインエディタ ] ウィンドウに [ 取引先リスト ] のレポートデザインが表
示されます。
バージョン 6.0
Siebel レポートガイド
2-3
Reports.book
4 ページ
２００１年４月２７日　金曜日　午前１１時２７分
グローバルなレポート修正
全レポートのフォントの変更
ssCustom のラベルコントロールとテキストコントロールを編集するには
1 ツールバーの [ ライブラリブラウザ ] アイコンをクリックします。
[ インクルードモジュール選択 ] ダイアログボックスが表示されます。
[ ライブラリブラウザ ] アイコンおよび [ インクルードモジュール選択 ] ダイ
アログボックスは、レポートデザインに含まれているライブラリの 1 つを開
くために使用されます。AFC、ssCustom、および ssSiebel のライブラリはす
べてのレポートに含まれています。
2- 4
Siebel レポートガイド
バージョン 6.0
Reports.book
5 ページ
２００１年４月２７日　金曜日　午前１１時２７分
グローバルなレポート修正
全レポートのフォントの変更
2 ssCustom.rol を選択して [OK] をクリックします。
ssCustom の [ ライブラリ ] ウィンドウが表示されます。[ ライブラリ ] ウィン
ドウには、開いたライブラリ、つまり、この例では ssCustom.rol で使用可能
なライブラリコンポーネントのすべてが表示されます。
バージョン 6.0
Siebel レポートガイド
2-5
Reports.book
6 ページ
２００１年４月２７日　金曜日　午前１１時２７分
グローバルなレポート修正
全レポートのフォントの変更
3 ssLbl コンポーネントを右クリックして、[ プロパティ ] を選択します。
[ コンポーネントエディタ ] ウィンドウが表示され、ssLbl のプロパティ設定
が表示されます。
[ コンポーネントエディタ ] には、次の 4 つのタブ、[ プロパティ ]、[ メソッド ]、
[ 変数 ]、[ クラス ] があります。
„
プロパティタブ 現在のコンポーネントに定義されているプロパティごと
の設定を識別します。プロパティ設定はこのタブページで変更できます。
„
メソッドタブ コンポーネントに定義されている Actuate BASIC メソッドを
リストします。
„
変数タブ コンポーネントに定義されている変数をリストします。
„
クラスタブ コンポーネントのクラス名とスーパークラス、そして、クラ
スが存在するモジュール ( 通常は、レポートデザインファイルあるいは組
み込まれているライブラリのいずれか ) を識別します。
4 [ コンポーネントエディタ ] で Font プロパティを検索して開きます。
Font.FaceName プロパティが表示されます。
5 Font.FaceName の値を [Arial] から [Arial Narrow] に変更して [ 適用 ] をクリッ
クします。
2- 6
Siebel レポートガイド
バージョン 6.0
Reports.book
7 ページ
２００１年４月２７日　金曜日　午前１１時２７分
グローバルなレポート修正
全レポートのフォントの変更
6 [ ライブラリ ] ウィンドウをクリックしてウィンドウをアクティブにします。
アクティブにしたら、他のライブラリコンポーネントを選択してそのプロパ
ティを変更します。
7 [ ライブラリ ] ウィンドウの ssTxt コンポーネントをクリックします。
[ コンポーネントエディタ ] ウィンドウには、ssTxt のプロパティ設定が表示
されます。
8 ssTxt に手順の 4 と 5 を繰り返し、[ コンポーネントエディタ ] および [ ライ
ブラリ ] のウィンドウを閉じます。
レポートをコンパイルして実行するには
1 Actuate Developer Workbench で、ツールバーの [ 構築と実行 ] アイコンをク
リックします。
[ 構築と実行 ] アイコンは、レポートの作成、コンパイル、および実行の各プ
ロセスを呼び出します。これらのプロセスは、Actuate Developer Workbench の
[ レポート ] メニューから、一括してあるいは個別に呼び出すこともできま
す。
2 次のダイアログボックスが表示されます。[Yes] をクリックします。
バージョン 6.0
Siebel レポートガイド
2-7
Reports.book
8 ページ
２００１年４月２７日　金曜日　午前１１時２７分
グローバルなレポート修正
全レポートのフォントの変更
3 [ リクエスタ ] ダイアログボックスが表示されます。[OK] をクリックして初
期値を読み込みます。
このダイアログボックスは、パラメータ値をレポートに送信する手段を提供
します。
[Actuate Developer Workshop] ウィンドウにレポートが生成され、表示されます。
2- 8
Siebel レポートガイド
バージョン 6.0
Reports.book
9 ページ
２００１年４月２７日　金曜日　午前１１時２７分
グローバルなレポート修正
全レポートのフォントの変更
変更内容を ssCustom に保存するには
1 レポートを閉じます。
2 次のダイアログボックスが表示され、ssCustom が変更されたこととその変更
内容を保存するかどうかを確認するメッセージが表示されます。[ はい ] ボタ
ンをクリックします。
3 Actuate Developer Workbench を閉じます。
4 開発ディレクトリ (C:¥Siebel_development¥reports¥language_code¥standard) から
実行可能ディレクトリ (C:¥Siebel_client¥reports¥language_code) に Aclist.rox
ファイルをコピーします。
5 Siebel Sales で、[ レポート ] メニューから [ 取引先リスト ] を選択します。校
正された取引先リストレポートが [ レポートビューア ] ウィンドウに表示さ
れます。
ssCustom への変更内容を他のレポートに反映させるには、該当するレポートの
再コンパイルが必要です。
バージョン 6.0
Siebel レポートガイド
2-9
Reports.book
10 ページ
２００１年４月２７日　金曜日　午前１１時２７分
グローバルなレポート修正
全レポートの企業ロゴの変更
全レポートの企業ロゴの変更
B
すべてのレポートで使用する企業ロゴを変更できます。ssLblSiebel コントロール
の fileName プロパティを、このセクションに記載されている手順どおりに変更
します。
適切な変更を実行してテストするには、次の手順を実行してください。
„
レポートデザインファイルを開く
„
ssCustom の ssLblsbl を編集する
„
レポートをコンパイルして実行する
„
変更内容を ssCustom に保存する
レポートデザインファイルと対応する Siebel ビューを開くには
1 Siebel Sales を起動します。
2 タブバーの [ 取引先 ] をクリックします。[ 取引先 ( 個人 )] ビューが表示され
ます。
3 デスクトップまたは [ スタート ] メニューから、Actuate Developer Workbench
ソフトウェアを起動します。
4 [ ファイル ] → [ 開く ] を選択します。
C:¥Siebel¥rptsrc¥enu¥standard フォルダの位置を検索して [Aclist.rod] を選択し
ます。
[ デザインエディタ ] ウィンドウに [ 取引先リスト ] のレポートデザインが表
示されます。
ssCustom のラベルコントロールとテキストコントロールを編集するには
1 ツールバーの [ ライブラリブラウザ ] アイコンをクリックします。
[ インクルードモジュール選択 ] ダイアログボックスが表示されます。
2 sscustom.rol を選択して [OK] をクリックします。
ssCustom の [ ライブラリ ] ウィンドウが表示されます。
2- 1 0
Siebel レポートガイド
バージョン 6.0
Reports.book
11 ページ
２００１年４月２７日　金曜日　午前１１時２７分
グローバルなレポート修正
全レポートの企業ロゴの変更
3 次の図のように、ssReport、PageList、および PageStyle を検索して開きます。
4 ssLblSiebel コンポーネントを右クリックして、[ プロパティ ] を選択します。
[ コンポーネントエディタ ] が表示されます。
5 fileName プロパティで指定したファイル名に置き換えます。
企業のロゴを含むグラフィックファイルを使用して、Siebel のロゴグラ
フィックを置換できます。再コンパイルしたレポートには、置換した企業の
ロゴが表示されます。
備考 : 企業で使用するロゴのビットマップがない場合は、
C:¥Siebdev¥rptsrc¥enu¥standard ディレクトリにある既存のビットマップファイ
ルをデモンストレーション用に選択します。プロパティ設定を sslogo5.bmp
に戻したら、再コンパイルする必要があります。
6 [ 適用 ] をクリックしてから [ 閉じる ] をクリックし、[ コンポーネントエ
ディタ ] を閉じます。[ ライブラリ ] ウィンドウを閉じます。
バージョン 6.0
Siebel レポートガイド
2- 1 1
Reports.book
12 ページ
２００１年４月２７日　金曜日　午前１１時２７分
グローバルなレポート修正
全レポートの企業ロゴの変更
レポートをコンパイルして実行するには
1 ツールバーの [ 構築と実行 ] アイコンをクリックすると、レポートがコンパ
イルされて実行されます。
2 [ リクエスト ] ダイアログボックスの [OK] をクリックして、初期値を読み込
みます。
[Actuate Developer Workshop] ウィンドウにレポートが生成され表示されます。
変更内容を ssCustom に保存するには
1 レポートを閉じます。レポートデザインを閉じます。
2 Aclist.rox ファイルを開発ディレクトリから実行可能ディレクトリへコピーし
ます。
3 Siebel Sales で、[ レポート ] メニューから [ 取引先リスト ] を選択します。校
正された取引先リストが [ レポートビューア ] ウィンドウに表示されます。
2- 1 2
Siebel レポートガイド
バージョン 6.0
Reports.book
1 ページ
２００１年４月２７日　金曜日　午前１１時２７分
簡単なリストレポートの作成
3
この章について . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2
新規レポートの作成とデザインのサブクラス化 . . . . . . . . . . . . . . . . . . . . . . 3-2
簡単なレポートリストの働き . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-3
既存リストレポートの検討 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-4
例－簡単なリストレポートの作成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-9
Siebel Tools による新規レポートオブジェクト定義の作成 . . . . . . . . . . . . . . 3-10
Actuate Developer Workbench でのレポートデザインの作成 . . . . . . . . . . . . . 3-13
ラベルおよびデータ要素のデザインへの追加 . . . . . . . . . . . . . . . . . . . . . . . . 3-18
レポートのコンパイルとテスト . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-21
他の方法によるレポート作成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-23
レポートオブジェクト定義のコピー . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-23
レポートデザインのコピー . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-24
カスタムコンポーネントライブラリの使用 . . . . . . . . . . . . . . . . . . . . . . . . . . 3-25
バージョン 6.0
Siebel レポートガイド
3-1
Reports.book
2 ページ
２００１年４月２７日　金曜日　午前１１時２７分
簡単なリストレポートの作成
この章について
この章について
C
新規レポートを作成するには、Acuate Developer Workbench でレポート要素をゼ
ロから組み立てる必要があります。この方法が、組織のカスタムレポートの要件
を満たすために使われる最も一般的な技法です。この章の最後で説明しますが、
新規カスタムレポートを作成する簡便な方法もあります。
新規レポートの作成とデザインのサブクラス化
C
新規レポートの作成と、第 4 章「既存のレポートのサブクラス化」に説明されて
いるレポートのサブクラス化は対照関係にあります。ユーザーの要件を既存のレ
ポートで満たすことができず、ユーザーの望むレポートと既存のレポートとの間
に著しい相違がある場合、新規レポートを作成します。新規レポートと既存のレ
ポートとの相違が小さく、旧レポートへのアップグレードを新規レポートに含め
る場合は、サブクラス化を行って新規レポートを入手します。
次のような状況で新規レポートを作成します。
„
レポートのオブジェクト定義に含まれるフィールドのリストと、既存レポー
トのリストがフィールドの数でかなり異なっている場合
„
レポートのコンポーネントの構造が、たとえば、グループセクションあるい
はサブレポートの追加または削除により、関連するレポートと異なっている
場合
備考 : グループセクションについては、第 5 章「グループセクションのある
レポート」、サブレポートについては、第 6 章「マスター詳細レポート」で説
明しています。
„
カスタムレポートが新規ビジネスコンポーネントを使用する場合
次のような状況で既存のレポートデザインをサブクラス化します。
3- 2
„
同じレポートの複数の同じようなバージョンを展開して、カテゴリーの異な
るユーザーに少しずつ異なるデータを表示する場合
„
2 つのレポートが同じデータを異なる方法で表示する場合
Siebel レポートガイド
バージョン 6.0
Reports.book
3 ページ
２００１年４月２７日　金曜日　午前１１時２７分
簡単なリストレポートの作成
簡単なレポートリストの働き
簡単なレポートリストの働き
C
図 3-1 は、簡単なリストレポートの構造を示しています。
Report Design
Report Section
DataStream
Page
Header
Content
PageList
図 3-1
簡単なリストレポートの構造
この構造には、次のような重要なコンポーネントが含まれています。
バージョン 6.0
„
Report Design
このコンポーネントはレポートの最上位のコンポーネントです。つまり、こ
のコンポーネントは、自分が常駐する .ROD ファイルに一致します。簡単な
レポートでは、最上位のコンポーネントを修正する必要はありません。その
コンポーネントに子のコンポーネントを追加するだけです。より複雑なデザ
インでは、レポートデザインのコンポーネントにグローバル変数を追加する
ことができます。
„
Report Section
Report Section は、データソース、物理的なレイアウト、およびマスターレ
ポートあるいはサブレポートの動作を定義するコンポーネントをグループに
まとめたものです。
„
DataStream
データストリームコンポーネントは、レポートセクションに必要なデータ
ソースを定義します。簡単な Siebel レポートでは、データストリームは常に
データ供給ライブラリ (.ROL) ファイルの内容で構成されており、Siebel
ビューから Actuate レポートへのデータ転送を定義しています。より複雑な
レポートでは、追加データストリームがライブラリデータストリームから得
られるデータを操作することができます。
Siebel レポートガイド
3-3
Reports.book
4 ページ
２００１年４月２７日　金曜日　午前１１時２７分
簡単なリストレポートの作成
簡単なレポートリストの働き
„
Page Header フレーム
フレームとは、データコントロール、ラベル、およびその他のビジュアルコ
ンポーネントに必要な方形のレイアウトエリアです。Page Header フレームの
内容は、新規ページごとの冒頭の部分に表示されます。簡単なリストレポー
トでは、ページヘッダーにはレポートカラムに必要なカラムの見出しだけが
含まれます。グループ区切りを使用する、より複雑なレポートでは、取引先
別の商談グループごとに必要な取引先名と場所などのグループ区切り情報が
ページヘッダーに含まれます。
„
Content フレーム
Content フレームは 1 つのレポート列のレイアウトを定義します。データスト
リームにより取得される各データレコードは、Content フレームに含まれる
データコントロールのレイアウトに従って書式化されます。
„
PageList セクション
PageList セクションは、レポート名、ページ番号、および企業ロゴなど、
ページの最上部と最下部に示す情報を含め、レポートのページレイアウトを
定義します。また、レポートセクションで生成されるデータの表示に使用で
きるページのエリアも定義します。標準 Siebel レポートの PageList コンポー
ネントを組み込んで、レポートタイトルなどのプロパティを修正します。
既存リストレポートの検討
C
簡単なリストレポートの設定を詳しく知るには、このタイプの標準 Siebel レポー
トを Actuate Developer Workbench で開き、そのレポートを学習することが役立ち
ます。この学習には Activity List レポートが最適で、[ 活動 ] 画面のビュー ( 一般
的には、[ 活動 ( 個人 )] ビュー ) から呼び出されます。Siebel Sales のレポート出
力と Actuate Developer Workbench のレポートデザインをそれぞれ開いたままで比
較し、検討してください。
Siebel Sales で Activity List レポートを生成するには
1 Siebel Sales を起動します。
2 タブバーの [ 活動 ] を選択します。
[ 活動 ( 個人 )] ビューが表示されます。
3 メニューバーで [ レポート ] → [ 活動リスト ] を選択します。
3- 4
Siebel レポートガイド
バージョン 6.0
Reports.book
5 ページ
２００１年４月２７日　金曜日　午前１１時２７分
簡単なリストレポートの作成
簡単なレポートリストの働き
図 3-2 に示されているように、レポートビューアに活動リストレポートが表示さ
れます。
図 3-2
Siebel レポートビューアの活動リストレポート
活動リストレポートに必要なレポートデザインを開くには
1 Actuate Developer Workbench を開きます。
2 メニューバーから [ ファイル ] → [ 開く ] を選択します。
3 [ 開く ] ダイアログボックスで、C:¥Siebdev¥rptsrc¥enu¥standard フォルダ ( あ
るいはユーザーのコンピュータにある同じフォルダ ) に移動して、Actlist.rod
を選択します。
備考 : この Actlist.rod と Account List レポートを意味する Aclist.rod を混同しな
いでください。ここで開くのは、活動リストレポート (Actlist.rod) です。
バージョン 6.0
Siebel レポートガイド
3-5
Reports.book
6 ページ
２００１年４月２７日　金曜日　午前１１時２７分
簡単なリストレポートの作成
簡単なレポートリストの働き
Actuate Developer Workbench の Actlist.rod レポートファイルが図 3-3 に示されて
います。
図 3-3
活動リストレポートデザイン
レポートデザインを検索するには、左側にあるエクスプローラツリーのフォルダ
を開いたり閉じたりして、デザイン要素と対応する機能をレポート出力で比較
し、コンポーネントを右クリックしてそのプロパティリストを表示させます。
3- 6
Siebel レポートガイド
バージョン 6.0
Reports.book
7 ページ
２００１年４月２７日　金曜日　午前１１時２７分
簡単なリストレポートの作成
簡単なレポートリストの働き
このレポートデザインの次の機能に関する注意事項
„
灰色で表示されているコンポーネント名はライブラリで参照されます。黒色
で表示されているコンポーネント名は、ローカルでサブクラス化され、オリ
ジナルに影響を及ぼすことなくローカルでの修正に利用できるようになって
います。同じ色のスキーマがメソッドに使用されます。ローカルで修正され
たメソッド ( コンポーネントの [ コンポーネントエディタ ] ウィンドウの [ メ
ソッド ] タブにある ) の名前は黒色で表示されますコンポーネントのスー
パークラスから得られる修正されていないメソッドは、明るい灰色で表示さ
れます。
„
データストリームコンポーネントである ssActionQuery の名前は灰色で表示さ
れ、ローカルではなく参照されることを示しています。このコンポーネント
の [ コンポーネントエディタ ] ウィンドウを開き [ クラス ] タブをクリックす
ると、オリジナルが Aclist.rol ライブラリファイルにあることが確認できま
す。Aclist.rol は、Siebel Tools から生成されたデータ供給ライブラリです。
„
データストリームコンポーネントを展開すると、このコンポーネントに子デー
タ行コンポーネント、ssActionDataRow が含まれていることを確認できます。こ
のコンポーネントもローカルではなく、参照されるもので、ssActionQuery と共
にデータ供給ライブラリファイルから取得されます。ssActionDataRow の [ コン
ポーネントエディタ ] ウィンドウを開き [ 変数 ] タブをクリックすると、データ
行コンポーネントが ssAccount_Location、ssAccount_Name、および
ssContact_First_Name などの変数で構成されていることが確認できます。これら
の変数は、データを供給するビジネスコンポーネントレコードのフィールドリ
ストから得られます。
備考 : 特に、これらのフィールドは、レポートオブジェクト定義のレポート
フィールドの子のリストから生成され、生成されたフィールドからデータ供
給 .ROL ファイルが生成されます。
レポートデザインに必要なすべてのデータ定義作業は、ユーザーが独自のレ
ポートおよびレポートフィールドオブジェクト定義を作成し、Siebel Tools か
ら .ROL を生成した後に処理されます。簡単なレポートでは、生成したデー
タストリームが修正されないままユーザーのレポートデザインに含まれてい
るので、Siebel と Actuate 間のデータ転送を設定する以外に必要な作業はあり
ません。
バージョン 6.0
Siebel レポートガイド
3-7
Reports.book
8 ページ
２００１年４月２７日　金曜日　午前１１時２７分
簡単なリストレポートの作成
簡単なレポートリストの働き
„
ページヘッダーコンポーネント (ssFrmACLISTHdr) およびその子のコンテンツ
フレーム (ssFrmBlueBackl) を展開すると、カラム見出しラベルとその上に引
かれている青い線の定義方法を確認できます。レイアウト枠あるいは構造枠
のいずれかにあるビジュアル要素をクリックすると、その要素が両方の場所
で強調表示されます。ラベルの 1 つでプロパティリストを表示して、そのテ
キスト、フォント、およびその他の物理的属性が設定されている方法を確認
します。灰色のプロパティテキストは、親のオブジェクト (ssCustom.rol ライ
ブラリの ssLblHead) からの初期値で、黒色のテキストは初期値から変更され
ていることを表します。
„
ツールバーの [ ライブラリブラウザ ] アイコンをクリックします。[ インクルー
ドモジュール選択 ] ウィンドウで、ssCustom.rol をダブルクリックします。リ
ストされているコンポーネントはライブラリコンポーネントで、ユーザーレ
ポートの構成単位として用いられます。ssCustom ライブラリのライブラリコ
ンポーネントのリスト全体を検索して、それらのコンポーネントと同じよう
に得られたレポートデザインのコンポーネントを比較します。
通常、簡単なレポートに組み込む必要がある項目は、データ供給ライブラリ
から得られるデータストリームを除き、ssCustom.rol ライブラリの一般的なコ
ンポーネントから派生します。これらのライブラリコンポーネントの修正は
通常、レポートデザインに導入された後は、ほとんど必要ありません。
Actlist.rod で、ラベル、テキストコントロール、コンテンツフレーム、水平
線、および PageList が ssCustom.rol のライブラリコンポーネントから得られ
ます。
備考 : ここで、[ssCustom.rol - ライブラリビュー ] ウィンドウを閉じる、ある
いは小さくすることができます。
„
メインコンテンツフレーム (ssFrmACTLISTContent) を展開します。このフレー
ムの子オブジェクトは、すべてデータコントロールです。データコントロー
ルは、データストリームにより取得した 1 つあるいは複数のフィールドの値
を表示します。1 つのデータコントロールの [ コンポーネントエディタ ] ウィ
ンドウを開き、ValueExp プロパティの設定に注目します。ValueExp property
は、テキストコントロールに表示する内容を決める表現を保有します。
次の項では、同じようなレポートデザインをユーザー自身で作成します。
3- 8
Siebel レポートガイド
バージョン 6.0
Reports.book
9 ページ
２００１年４月２７日　金曜日　午前１１時２７分
簡単なリストレポートの作成
例－簡単なリストレポートの作成
例－簡単なリストレポートの作成
C
この例では、商談リストレポートを作成します。このレポートには、取引先名、
商談名、予想売上額、および表示商談レコードごとのクローズ予定日がリストさ
れます。結果レポートは、図 3-4 で示されたレポートのようになります。
図 3-4
レポートサンプル
レポートを作成するには、次の手順を実行します。
バージョン 6.0
„
新規レポートオブジェクト定義(および子)をSiebel Toolsで作成してエクスポー
トする
„
レポートデザインを Actuate で作成する
„
データコントロールとラベル要素をデザインに追加する
„
レポートをコンパイルしてテストする
Siebel レポートガイド
3-9
Reports.book
10 ページ
２００１年４月２７日　金曜日　午前１１時２７分
簡単なリストレポートの作成
例－簡単なリストレポートの作成
Siebel Tools による新規レポートオブジェクト定義の作成
C
カスタムあるいは標準の区別なく、それぞれのレポートデザインには、通常、
Siebel Tools および対応するデータ供給ライブラリファイルに独自のレポートオ
ブジェクト定義があります。レポート ( および子 ) オブジェクト定義およびエク
スポートされたデータストリームライブラリについては、1-17 ページの「レ
ポートのデータ定義」に説明があります。
この例で、レポートオブジェクト定義および子をスクラッチから作成します。こ
れ以外の方法については、3-23 ページの「レポートオブジェクト定義のコピー」
で説明しています。
新規レポートオブジェクト定義 ( および子 ) を Siebel Tools で作成する
1 Siebel Tools を起動します。Object Explorer の Report オブジェクトタイプに移
動します。
2 Object List Editor の任意のレコードをクリックします。レポートレコードを追
加します (Ctrl キーを押しながら N キーを押すか、[Edit] → [New Record] を選
択します )。
3 Object List Editor の新規レポートレコードで、次のようなプロパティを入力し
ます。
„
Name Test Report
この名前は、たとえば、レポートをビュー用として [ レポート ] メニュー
に追加するときなど、Siebel Tools でレポート構造を参照するのに使用さ
れます。
„
Project Report
Report プロジェクトが Siebel Sales の標準です。Report (SSV) は、一般的に
Siebel Service に使用されます。Report プロジェクトは、一般的にアプリ
ケーションで使用されます。
3- 1 0
Siebel レポートガイド
バージョン 6.0
Reports.book
11 ページ
２００１年４月２７日　金曜日　午前１１時２７分
簡単なリストレポートの作成
例－簡単なリストレポートの作成
„
Access Base DB Name TESTRPT
このプロパティは、このレポートオブジェクト定義がビューの [ レポート ]
メニューから呼び出されたとき、Testrpt.rox が呼び出されたレポート作成
プログラムの名前になることを指定します。
備考 : 標準レポートに必要なこの値はすべて大文字ですが、名前をすべて
大文字にする必要はありません。
„
Business Component Opportunity
ここで指定するビジネスコンポーネントは、メインレポートにレコードを
提供するコンポーネントです。サブレポート ( より高度なレポート ) に
は、独自のビジネスコンポーネントがあります。
„
Class CSSActuateReportViewer
このプロパティは Actuate レポートのレポートを指定します。ピックリス
トのその他のオプション (CSSAccessReport、CSSCrystalReport、および
CSSReport) は、他のレポートソフトウェアを指定します。CSSAccessReport
および CSSReport クラスについては、第 14 章「Actuate 以外のソフトウェ
ア製品を使用した Siebel レポート」を参照してください。
„
Menu Text Test Report
このプロパティは、ビューレポートオブジェクト定義を使用することによ
りこのレポートがビューに含まれたとき、ビューに必要な [ レポート ] メ
ニューに表示されるテキストです。
„
Template Name TESTREPT
このプロパティは、[Generate Actuate Report] オプションがこのレポートオ
ブジェクト定義のために呼び出されたとき、生成されたデータ供給ライブ
ラリファイルに使用される名前を指定します。
備考 : 標準レポートに必要なこのプロパティの値はすべて大文字ですが、
名前をすべて大文字にする必要はありません。
バージョン 6.0
Siebel レポートガイド
3- 1 1
Reports.book
12 ページ
２００１年４月２７日　金曜日　午前１１時２７分
簡単なリストレポートの作成
例－簡単なリストレポートの作成
4 Object Explorer ツリーの [Report] オブジェクトタイプを展開し、[Report Field]
の子オブジェクトタイプを選択してクリックします。
5 レポートフィールドオブジェクト定義を追加します (Ctrl キーを押しながら N
キーを押すか、[Edit] → [New Record] を選択します )。Field プロパティの中
をクリックします。[Field] ピックアプレットで [Name] を選択します。
親のレポートオブジェクト定義の Business Component プロパティ設定は、レ
ポートフィールドとして含めることができるフィールド、つまり、該当する
ビジネスコンポーネントのフィールドを決定します。レポートの子として追
加するそれぞれのレポートフィールドオブジェクト定義は、データ供給ライ
ブラリにエクスポートされるフィールドを定義します。
6 取引先、売上、およびクローズ予定日のフィールドに手順 5 を繰り返します。
ピックアプレットで検索しなくてもその名前を入力できます。スペルミスを
しないようにしてください。
7 上位の [Object List Editor] ウィンドウにある親オブジェクト定義 (Test Report)
をクリックします。メニューバーで [Tools] → [Generate Actuate Report] を選択
します。
このように選択すると、Template Name プロパティの値により命名されたデー
タ供給 .ROL ファイルが、C:¥Siebdev¥rptsrc¥enu¥lib フォルダ ( あるいはユー
ザーのシステムにある同じフォルダ ) に生成されます。
8 Object Explorer の View オブジェクトタイプに移動します。
9 Object List Editor で、Opporunity List View 定義にカーソルを移動します。
Object Explorer で、[View] を展開し [View Report] をクリックします。
これは、[ 商談 ] 画面の [ 商談 ( 個人 )] です。新規レポートをこのビューの
[ レポート ] メニューに追加します。
10 Object List Editor にビューレポートオブジェクト定義を追加します。名前
「Test Report」( スペルミスとスペースに注意します ) およびリストの他の順序
番号より 1 つ上の順序番号を入力します。
指定した名前は、表示するメニューテキストおよび呼び出されるレポート作
成プログラムを含め、レポートを定義するレポートオブジェクト定義を識別
します。順序番号は、他のレポートと相対的にメニューのレポート位置を指
定します。
3- 1 2
Siebel レポートガイド
バージョン 6.0
Reports.book
13 ページ
２００１年４月２７日　金曜日　午前１１時２７分
簡単なリストレポートの作成
例－簡単なリストレポートの作成
11 [Repository] → [Compile] を選択してレポジトリを再コンパイルします。結果
.SRF ファイルを C:¥Siebel¥objects またはユーザーシステムの同等の位置に移
動します。
この移動は、[ 商談リスト ] ビューの [ レポート ] メニューへの追加を認識さ
せるために必要な手順です。データ供給 .ROL ファイルを生成するためにレ
ポジトリをコンパイルする必要はありません。
Actuate Developer Workbench でのレポートデザインの作成
C
レポートデザインファイルは 1 つのレポートのレイアウトおよび動作を定義しま
す。この練習では、新規レポートデザインをライブラリコンポーネントを使用し
て最初から作成します。
レポートデザインを Actuate Developer Workbench で作成するには
1 Actuate Developer Workbench を起動します。
2 [ ファイル ] → [ 新規作成 ] を選択します。[ 新規ファイル ] ダイアログボッ
クスで、ラジオボタンの [ 空のレポートデザイン ] を選択します。
3 [ 新規レポートデザイン ] ダイアログボックスで、次の情報を入力します。
„
タイトル Test Opportunity Report
この値は、レポートビューアの内容のレポートテーブルに関するウィンド
ウタイトルで使用されます。
„
ファイル名 C:¥Siebdev¥rptsrc¥enu¥Testrept.rod
ファイル名と作成するレポートデザインファイルを保存するフォルダの場
所です。このレポートはカスタムレポートなので、標準レポートと同じ
フォルダ (...¥enu¥standard) に保存しないでください。また、.ROD ファイ
ルもライブラリファイルと同じフォルダ (...¥enu¥lib) に保存しないでくだ
さい。ファイルを直接 ...¥enu に保存したり、¥enu のサブフォルダを
¥enu¥custom という名前 ( あるいは同じ方法 ) で作成することができます。
„
レポートオブジェクト名 Testrept
これにより、デザインファイルの最上位にあるレポートデザインオブジェ
クトの名前が指定されます。一般に、.ROD ファイルの名前と同じ名前
(.ROD 拡張子なし ) を指定します。
バージョン 6.0
Siebel レポートガイド
3- 1 3
Reports.book
14 ページ
２００１年４月２７日　金曜日　午前１１時２７分
簡単なリストレポートの作成
例－簡単なリストレポートの作成
4 [ ファイル ] → [ モジュールのインクルード ] を選択します。[ モジュールの
インクルード ] ダイアログボックスで、C:¥Siebdev¥rptsrc¥enu¥lib ( あるいは同
様のフォルダ ) に移動し、ssSiebel.rol を選択して [ 開く ] をクリックします。
[ ライブラリ ] ウィンドウを閉じます。
5 次のライブラリファイル ssCustom.rol および Testrept.rol に手順 4 を繰り返し
ます。
ssSiebel.rol および ssCustom.rol は、Siebel 標準およびカスタムレポートに必須
のライブラリです。Testrept.rol は、Siebel Tools から生成したデータ供給 .ROL
ファイルです。つまり、このファイルは、新規レポートへのデータの転送方
法を定義します。
6 [ ファイル ] → [ 名前を付けて保存 ] を選択します。...¥enu ( あるいは
...¥enu¥custom) フォルダの Testrept.rod を指定します。
デザインファイルは、作業中定期的に保存するようにしてください。
7 構造ツリーの [Testrept] ( 最上位 ) アイコンをダブルクリックします ( あるいは、
そのアイコンを右クリックして [ プロパティ ] を選択します )。[ コンポーネン
トエディタ ] ウィンドウで、[ クラス ] タブをクリックします。[ スーパークラ
ス ] の値を acReport から ssReport に変更します。
これは重要な手順です。Siebel レポートは、acReport (Actuate レポート ) から
直接継承しているのではなく、ssReport (Siebel 標準レポート ) から継承され
ています。ssReport は ssSiebel が提供するもので、acReport から継承されてい
ます。この手順は、ssSiebel.rol ライブラリを含めるまで実行できないことに
注意してください。
レポートのクラスを変更すると、次の 2 つのコンポーネントが自動的にレ
ポートに追加されます。Report Section (ssRpt) および PageList セクション
(ssPageList)。
8 [ 表示 ] → [ オプション ] を選択して [ 空のスロットを表示 ] オプションを
チェックしてください。
空スロットの表示を構造ツリーで検索してレイアウトペインを分散する場合、
このオプションの選択を後から解除できます。ここでは、コンポーネントを
ssCustom ライブラリからこのスロットにドラッグするため、空スロットを表
示しておく必要があります。
3- 1 4
Siebel レポートガイド
バージョン 6.0
Reports.book
15 ページ
２００１年４月２７日　金曜日　午前１１時２７分
簡単なリストレポートの作成
例－簡単なリストレポートの作成
9 最上位のレポートコンポーネントを展開します。構造ツリーにあるレポート
セクションの子コンポーネント (ssRpr) を右クリックします。ポップアップメ
ニューの [ ローカルサブクラス ] オプションを選択します。
コンポーネントの修正を計画している場合、レポートに導入するそれぞれの
コンポーネントをローカルのサブクラスにする必要があります。サブクラス
にしておかないと、変更はシステムにより許可されません。
10 レポートセクションコンポーネント (ssRpt1) を右クリックして [ 名前の変更 ]
を選択します。名前を「ssRptOpportunity」に変更します。
作成するレポートのコンポーネントに命名規則を用いて、意味のある名前を
コンポーネントに付けると、すばらしいデザインを実践することができます。
接頭辞 ssRpt は、ssRpt ライブラリコンポーネントが基になっているレポート
セクションであることを示しています。接頭辞 Opportunity は、商談レコード
が表示されるマスターレポートセクションとして、このコンポーネントが識
別されることを示しています。
バージョン 6.0
Siebel レポートガイド
3- 1 5
Reports.book
16 ページ
２００１年４月２７日　金曜日　午前１１時２７分
簡単なリストレポートの作成
例－簡単なリストレポートの作成
[ デザインエディタ ] ウィンドウのユーザーが作成したレポートデザインは、
次のように表示されます。
11 [ ライブラリブラウザ ] アイコンをクリックして ssCustom.rol ライブラリを開
きます。[ ライブラリ ] ウィンドウから、ssFrm コンポーネントをコンテント
スロットにドラッグアンドドロップします。
これにより、各レポート列に表示される内容を定義するフレームが作成され
ます。このフレームはレポートセクションコンポーネントの子になります。
12 新規フレーム (ssFrm) を右クリックして、[ ローカルサブクラス ] を選択しま
す。
13 フレームを右クリックして、[ 名前の変更 ] を選択します。名前を
「ssFrmOpportunityContent」に変更します。[ ライブラリ ] ウィンドウを閉じ
ます。
3- 1 6
Siebel レポートガイド
バージョン 6.0
Reports.book
17 ページ
２００１年４月２７日　金曜日　午前１１時２７分
簡単なリストレポートの作成
例－簡単なリストレポートの作成
14 ツールバーの [ ライブラリブラウザ ] アイコンをクリックし、ダイアログ
ボックスで [Testrept.rol] を選択します。
[ ライブラリ ] ウィンドウが開き、Testrept.rol の内容、つまり、Siebel Tools か
ら生成したデータ供給ライブラリが表示されます。
15 [ ライブラリ ] ウィンドウのデータストリームコンポーネント
(ssOpportunityQuery) を [ デザインエディタ ] のデータストリームスロットに
ドラッグアンドドロップします。[ ライブラリ ] ウィンドウを閉じます。
データストリームコンポーネントは、これでレポートセクションコンポーネ
ントの子になります。データストリームは、レポート列を生成するための
データの供給方法を定義します。それぞれのデータレコードは、親のレポー
トセクションにレポート列を 1 列生成します。データストリームコンポーネ
ントは、未修正の形でレポートで使用されるため、このコンポーネントを
ローカルのサブクラスにしないように注意してください。
バージョン 6.0
Siebel レポートガイド
3- 1 7
Reports.book
18 ページ
２００１年４月２７日　金曜日　午前１１時２７分
簡単なリストレポートの作成
例－簡単なリストレポートの作成
ラベルおよびデータ要素のデザインへの追加
C
これまでに、レポートデザインファイルおよびその重要な構造コンポーネントを 3
つ作成しました。そのコンポーネントとは、Report Design ( ルート )、Report Section、
および PageList です。また、あらかじめ生成したデータソースライブラリファイル
から、データソースを参照により取得し、データが供給されるレポートセクション
にそのデータソースを置きました。ここで、ページヘッダーに必要なフレームを作
成して各ページの最上部に表示される要素を定義すると共に、重要なコンテンツフ
レームを作成して各レポート列に表示される要素を定義します。
テキストとラベル要素をデザインに追加するには
1 [ ライブラリ ] ウィンドウからコンテンツフレームの空の Content 子スロット
(ssFrmOpportunityContent) に、ssTxt コンポーネントをドラッグアンドドロッ
プします。
[ コンポーネントプロパティ ] ダイアログボックスが表示されます。
2 [ コンポーネントプロパティ ] ダイアログボックスで、ドロップリストをク
リックして、データストリームから [ssName] フィールドを選択します。
[OK] をクリックして [ コンポーネントプロパティ ] ダイアログボックスを閉
じます。
データコントロールに必要なデータの情報源を [ValueExp] プロパティで指定
します。
3- 1 8
Siebel レポートガイド
バージョン 6.0
Reports.book
19 ページ
２００１年４月２７日　金曜日　午前１１時２７分
簡単なリストレポートの作成
例－簡単なリストレポートの作成
3 レイアウトグリッドで新規データコントロールのサイズを変更して、名前の
データに合わせてサイズを調整します ( サイズが小さすぎると、名前が切り
捨てられます )。
4 データコントロールを右クリックして、ポップアップメニューから [ 名前の
変更 ] を選択します。テキストコントロールに内容を表す一意の名前、この
場合は txtOpportunity を付けます。
一般的に、レポートデザインコンポーネントの接頭辞は、その親のライブラリ
コンポーネントの一部を使用します。接頭辞 txt (ssTxt から ) は、ssTxt から得
た動的データコントロールに妥当な標準で、標準レポートの命名規則に一致し
ます。
5 データコントロールを右クリックして、ポップアップメニューから [ プロパ
ティ ] を選択します。[CanGrow] プロパティが TRUE に設定されていること
を確認します。
このプロパティが TRUE に設定されていると、ビジネスコンポーネント
フィールドにおける複数行の値が、レポートで複数行の値として印刷されま
す。FALSE の場合は、それぞれの値の 1 行目だけが印刷されます。
備考 : 可能であれば、[ コンポーネントエディタ ] ウィンドウの [ デフォルト ]
ボタンを使用して、プロパティをリセットしてください。値を手動で入力せ
ずに、たとえば、CanGrow をその初期値 ( この場合は TRUE) にリセットして
ください。これにより、不要なサブクラス化を行わずに継承をそのまま維持
することになります。
6 次のコントロールに手順 4 から 8 までを繰り返します。
„
ssAccount データストリーム変数にもとづく txtAccount という名前のコント
ロール
„
ssRevenue_Formatted にもとづく txtRevenue という名前のコントロール
„
ssClose_Date にもとづく txtCloseDate という名前のコントロール
使用できる空の子スロットがないため、ssTxt コンポーネントは親のコンテン
ツフレーム (ssFrmOpportunityContent) にドロップしてください。データコン
トロールを作成した後、右側にあるレイアウトペインに各データコントロー
ルを再度位置付ける必要があることにも注意してください。
バージョン 6.0
Siebel レポートガイド
3- 1 9
Reports.book
20 ページ
２００１年４月２７日　金曜日　午前１１時２７分
簡単なリストレポートの作成
例－簡単なリストレポートの作成
7 ssFrmBlueBack ライブラリコンポーネントを空のページヘッダースロットに
ドラッグアンドドロップします。新規フレームコンポーネントをローカルの
サブクラスにして、その名前を ssFrmOpprotunityHeader に変更します。
ページヘッダーにカラム見出しが含まれます。青緑の背景色に白い太字の見出
しラベルが Siebel レポートの標準で、カスタムレポートも同じ外観にします。
8 これから説明するラベルを作成するたびに、ssLb1Head コンポーネントを
Page Header フレーム (ssFrmOpportunityHeader) にドラッグアンドドロップし
ます。[Text] プロパティをラベルごとに指示どおり設定します。ラベルが作
成されている場合は、ラベルごとにサイズ変更、再位置付け、および名前の
変更が必要です。それぞれのラベルは、対応するデータコントロールと垂直
方向で一直線に並びます。
„
Opportunity の Text プロパティ値を持つ、1b1Opportunity という名前のラベル
„
Account の Text プロパティ値を持つ、1b1Account という名前のラベル
„
Revenue の Text プロパティ値を持つ、1b1Revenue という名前のラベル
„
Close Date の Text プロパティ値を持つ、1b1CloseDate という名前のラベル
9 LineControl コンポーネントを [ssFrmOpportunityContent] フレームにドラッグ
アンドドロップします。名前を LineSeparator に変更します。レイアウト枠の
ラインがデータコントロールの真下に来るように再位置付けします。
区切りラインはレポート列の間に境界を作成します。
10 最上位のレポートコンポーネントを右クリックして、[ プロパティ ] を選択し
ます。Test Report の値を [ssReportTitle] プロパティに入力します。
これにより、左上にある青緑の範囲で印刷されるタイトルを定義します。
3- 2 0
Siebel レポートガイド
バージョン 6.0
Reports.book
21 ページ
２００１年４月２７日　金曜日　午前１１時２７分
簡単なリストレポートの作成
例－簡単なリストレポートの作成
レポートのコンパイルとテスト
C
レポートは、Actuate Developer Workbench で構築およびコンパイルして、ユーザー
がそれを実行する必要があります。それから、Actuate Developer Workbench により
ローカルでデバッグすることができます。それを展開できるようになったら、レ
ポートの実行可能バージョンを、Siebel アプリケーションがそれぞれのレポート
作成プログラムを取得するフォルダに移動します。
レポートをコンパイルしてインストールするには
1 Siebel Sales を起動して、[ 商談 ( 個人 )] ビューに移動します。必要なクエリー
が活動中か確認してください。
適切なアプリケーションおよびビューを起動して、レポートがレコードを入
手できるようにする必要があります。また、ビューで表示されるレコードの
セットが、レポートで使用されるレコードのセットとなります。
2 Actuate Developer Workbench で、ツールバーの [ 構築と実行 ] アイコンを選択
するか、[ レポート ] → [ 構築と実行 ] を選択します。
レポートが Actuate ビューアに表示されます。レポートを Actuate で作成しな
がらテストできます。レポートは、データレコードを Siebel アプリケーショ
ンでの表示順序と同じ順序で表示することに注意してください。レポートに
使用できるデータがないことを示すエラーが発生したら、Siebel アプリケー
ションが適切なレコードをクエリーしているか、カーソルを最初のレコード
に合わせてあるかを確認してください。
備考 : カーソルを最初のレコード以外のレコードに置くと、すべてのレコー
ドが表示されなくなります。これは、クエリーの Forward Only モードが原因
です。
3 必要な修正をレポートデザインに行い、必要であれば何度でも再コンパイル
してください。
4 Microsoft Windows のエクスプロ－ラを使用して、Testrept.rox ファイルを
C:¥Siebdev¥rptsrc¥enu ( あるいは、相当するフォルダ ) から
C:¥Siebel¥reports¥enu ( あるいは、相当するフォルダ ) へコピーします。
バージョン 6.0
Siebel レポートガイド
3- 2 1
Reports.book
22 ページ
２００１年４月２７日　金曜日　午前１１時２７分
簡単なリストレポートの作成
例－簡単なリストレポートの作成
5 Siebel Sales で [ レポート ] → [ テストレポート ] を選択します。
レポートが Siebel Sales で表示されます。問題が発生した場合、次のことを確
認してください。
3- 2 2
„
[テストレポート]オプションが[レポート]メニューにない場合、
[商談(個人)]
ビューが活動中であることを確認してください。適正なビューが活動中で
あれば、問題は、このメニューオプションを定義するビューレポートのオ
ブジェクト定義の設定にあります。適正なビュー (Opportunity List View) の
子であることを確認してください。
„
Siebel アプリケーションがレポートを見つけられないというメッセージが
表示されたら、実行可能なレポートを適正なフォルダに移動したかどうか
を確認してください。
Siebel レポートガイド
バージョン 6.0
Reports.book
23 ページ
２００１年４月２７日　金曜日　午前１１時２７分
簡単なリストレポートの作成
他の方法によるレポート作成
他の方法によるレポート作成
C
前の項で概略した手順は、新規のカスタムレポートを作成する方法の 1 つです。
プロセスの一部あるいはすべてに対して他の方法を実行できます。これらの一部
について、ここで簡単に説明します。
レポートオブジェクト定義のコピー
C
3-10 ページの「Siebel Tools による新規レポートオブジェクト定義の作成」で説
明している、新規レポートオブジェクト定義 ( および子 ) を Siebel Tools で作成
する手順は、既存のオブジェクト定義とほぼ同じで複雑なオブジェクト定義セッ
トを新しく作成する必要がある場合、非常にわずらわしい手順になります。他の
方法では、必要なレポートオブジェクト定義をコピーします。この方法で、同じ
プロパティ設定および子のレポートフィールドとサブレポートオブジェクト定義
を持つ新規レポートオブジェクト定義を作成します。
既存のレポートオブジェクト定義と子をコピーするには
1 Siebel Tools で、Report オブジェクトタイプおよび必要なレポートオブジェク
ト定義に移動してコピーします。
2 Report プロジェクトをロックします ([Repository] → [Lock Project] を選択 )。
3 [Edit] → [Copy Record] を選択します。
これにより、同じ子のセットおよび複写したプロパティ設定を持つ新規レ
ポートオブジェクト定義が作成されます。Menu Text プロパティおよび Name
プロパティは例外で、ユーザーが指定する必要があります。また、Template
Name および Access Base DB 名の設定も変更して、データ供給ライブラリお
よび実行可能レポートにオリジナルの名前と異なる名前を付ける必要があり
ます。
4 必要であれば、新規レポートオブジェクト定義および子に修正を行ってくだ
さい。
5 [Tools] → [Generate Actuate Report] を選択して、データ供給ライブラリファイ
ルにエクスポートします。
6 Report プロジェクトのロックを解除します。
バージョン 6.0
Siebel レポートガイド
3- 2 3
Reports.book
24 ページ
２００１年４月２７日　金曜日　午前１１時２７分
簡単なリストレポートの作成
他の方法によるレポート作成
レポートデザインのコピー
C
Actuate レポートデザイン (.ROD) ファイルは、Windows のエクスプローラ、ある
いは Actuate Developer Workbench の [ ファイル ] → [ 名前を付けて保存 ] オプショ
ンを使用して、異なる名前を持つ新規ファイルにコピーすることができます。
Actuate は新規デザインをオリジナルとは別のデザインとして扱いますが、含まれ
ているライブラリへの関係はすべて維持します。
この方法は、既存レポートデザインの多くのデザイン要素を再利用する場合に望
ましい方法ですが、各種の修正を行う必要があります。これが普通の状況であり、
この技法は利用する価値があることがわかります。
既存のレポートデザインをコピーしたら、次の修正を新規レポートデザインに実
行します。
3- 2 4
„
新規名前を持つ元のデータストリームのコピーを、3-23 ページの「レポートオ
ブジェクト定義のコピー」で説明されているように作成します。既存のデータ
ストリームをレポートデザインから削除して、新規データストリームを新規
データ供給ライブラリファイルからレポートデザインにドラッグアンドド
ロップします。2 つのレポートデザインが単一のデータストリームと単一のレ
ポートオブジェクト定義を共有することは実行不可能なため、この手順は重要
です。
„
レポートオブジェクト定義を、新規レポートデザインに従って、Template
Design プロパティおよび Access Base DB Name プロパティで適正に設定する
ようにしてください。
„
最上位のレポートコンポーネント名を変更します。これは重要な手順ではあ
りませんが、Actuate Developer Workbench のそれぞれのレポートで作業する場
合、ユーザー自身を適応させるのに役立ちます。
Siebel レポートガイド
バージョン 6.0
Reports.book
25 ページ
２００１年４月２７日　金曜日　午前１１時２７分
簡単なリストレポートの作成
他の方法によるレポート作成
カスタムコンポーネントライブラリの使用
C
類似のレポートで役立つようなデザインコンポーネントおよび子コンポーネント
を作成する場合、これらのコンポーネントを再利用できるカスタムコンポーネン
トライブラリを作成できます。カスタムコンポーネントライブラリの例として、
Quotestd.rod、Quotepro.rod および Quosum.rod を含む、各種見積りレポートで使
用される ssQuote.rol ライブラリがあります。
一般的に、この技法は、ページヘッダー、ページフッター、あるいは多数のラベ
ルおよびデータコントロールを含むコンテンツフレームを再利用するために使用
されますが、任意のコンポーネントおよびその子を再利用するためにこの方法で
公開できます。
カスタムコンポーネントライブラリを作成するには
1 カスタムライブラリで公開するコンポーネントを含むレポートデザインを開
きます。
2 メニューバーから [ ファイル ] → [ 新規ライブラリ ] を選択します。宛先フォ
ルダ ( これは C:¥Siebdev¥rptsrc¥enu¥lib となるか、あるいは相当のフォルダ )
およびファイル名 ( ファイル名は、Siebel カスタムライブラリからのファイ
ルであることを示す ss で始まり、データストリームライブラリのファイル名
と区別できなければなりません ) を指定します。
最上位のライブラリコンポーネントのみを含む新規ライブラリに対して、
[ ライブラリ ] ウィンドウが開きます。
3 レポートデザインの必要な親コンポーネント ( たとえば、コンテンツフレー
ム ) を最上位のライブラリコンポーネントにドラッグアンドドロップします。
[ コンポーネントドロップ ] ダイアログボックスが表示されます。
バージョン 6.0
Siebel レポートガイド
3- 2 5
Reports.book
26 ページ
２００１年４月２７日　金曜日　午前１１時２７分
簡単なリストレポートの作成
他の方法によるレポート作成
4 [ コンポーネントの公開 ] ラジオボタンを選択して、[OK] をクリックします。
公開したコンポーネントおよびその子がライブラリに追加されます。レポート
デザインファイルのそれぞれの名前は明るい灰色に変わり、ライブラリのバー
ジョンからサブクラス化されたコンポーネントになったことが示されます。
5 他のコンポーネントをこのレポートデザインファイルおよび他のレポートデ
ザインファイルからライブラリに移動します。
3- 2 6
Siebel レポートガイド
バージョン 6.0
Reports.book
1 ページ
２００１年４月２７日　金曜日　午前１１時２７分
既存のレポートのサブクラス化
4
この章について . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2
サブクラス化レポートの利点 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2
新規フィールドを持つサブクラス化レポートの作成 . . . . . . . . . . . . . . . . . . . 4-3
新規 .ROL ファイルの作成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-3
サブクラス化レポートのデザインファイル作成 . . . . . . . . . . . . . . . . . . . . . . . 4-4
Content コンポーネントのサブクラス化 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-6
レポートデザインへのフィールドの追加 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-8
レポートのコンパイル、展開、およびテスト . . . . . . . . . . . . . . . . . . . . . . . . 4-10
バージョン 6.0
Siebel レポートガイド
4-1
Reports.book
2 ページ
２００１年４月２７日　金曜日　午前１１時２７分
既存のレポートのサブクラス化
この章について
この章について
D
この章では、既存のレポートをサブクラス化することにより既存の標準レポート
から新規レポートを作成する方法について説明します。
サブクラス化レポートの利点
D
サブクラス化とは、オリジナルのコンポーネントから特性を継承する新規コン
ポーネントを作成することです。既存レポートをサブクラス化して新規レポート
を作成すると、そのレポートには、親レポートに対して行われた変更内容もすべ
て継承されます。サブクラスレポートでの変更内容は継承されません。
この手法は標準的な Siebel レポートで幅広く採用されています。Siebel 製品を
アップグレードすると、新規動作がレポートに継承されます。既存レポートの限
定バージョンを作成したいときはサブクラス化を行います。これにより、同じよ
うなレポートのセットでバージョンごとに更新するという不要な保守作業から解
放されます。ただし、新規レポートと既存レポートの間に著しい相違がある場
合、レポートデザインをサブクラス化するよりは、第 3 章「簡単なリストレポー
トの作成」で説明したように最初からレポートを作成します。3-2 ページの「新
規レポートの作成とデザインのサブクラス化」で、レポートの作成とサブクラス
化の利点が比較されています。
カラムの追加、削除、再ソートはもちろん、別の方法でデータをグループ分けし
たりソートしたりするために、サブクラス化を使用することもあります。サブク
ラス化したレポートのカラムを削除する場合、Siebel Tools のレポートオブジェ
クト定義からフィールドを削除しないように注意してください。削除すると、サ
ブクラス化したデザインの基礎になっているレポートデザインを壊すことになり
ます。
4- 2
Siebel レポートガイド
バージョン 6.0
Reports.book
3 ページ
２００１年４月２７日　金曜日　午前１１時２７分
既存のレポートのサブクラス化
新規フィールドを持つサブクラス化レポートの作成
新規フィールドを持つサブクラス化レポートの作成
D
この項の例では、取引先リストレポートをサブクラス化します。新しいレポート
には、継承したデザインへの追加フィールドとして、[Home Page] ( 取引先の URL)
を追加します。
次の手順で実行します。
„
Siebel Tools を使用して、新しい .ROL ファイルを作成する
„
Actuate を使用して、サブクラス化した .ROD ファイルを作成する
„
Content アイコンをサブクラス化する
„
フィールドをレポートに追加する
„
レポートをコンパイルしてテストする
新規 .ROL ファイルの作成
D
現在までに、レポートにエクスポートされていない新規フィールドを追加するに
は、Siebel Tools のレポートにフィールドオブジェクト定義を追加して、データ
供給 .ROL ファイルを生成します。
Siebel Tools で新しい .ROL ファイルを作成するには
1 Siebel Tools を起動します。Object Explorer の Report オブジェクトタイプに移
動し、Object List Editor にある [Accounts-Current Query] というレポートを検索
( して強調表示 ) します。
2 [Repository] → [Lock Project] を選択します。
3 Object Explorer の [Report] オブジェクトタイプを展開します。[Report Field] オ
ブジェクトタイプをクリックして強調表示します。
4 Object List Editor の [Report Field] リストにある任意のレコードを強調表示しま
す。レポートフィールドレコードを追加 (Ctrl キーを押しながら N キーを押
すか、[Edit] → [New Record] を選択します ) して、[Field] ダイアログボックス
から [Home Page] を選択します。
バージョン 6.0
Siebel レポートガイド
4-3
Reports.book
4 ページ
２００１年４月２７日　金曜日　午前１１時２７分
既存のレポートのサブクラス化
新規フィールドを持つサブクラス化レポートの作成
追加できるレポートフィールドは、レポートオブジェクト定義の Business
Component プロパティで指定されているビジネスコンポーネントのフィール
ドリストに限定されます。[Accounts - Current Query] レポートの場合、指定さ
れたビジネスコンポーネントは Account で、利用できるフィールドは Account
ビジネスコンポーネントのフィールドです。
5 [Accounts - Current Query] というレポートレコードを選択し、[Tools] →
[Generate Actuate Report] を選択します。
Actuate により、Aclist.rol ファイルが生成されます。
6 生成された Aclist.rol ファイルが、C:¥Siebdev¥rptsrc¥enu¥lib にあることを確認
します。
サブクラス化レポートのデザインファイル作成
D
標準 Aclist.rod にもとづいて、新しいレポートをサブクラス化により作成します。
オリジナルの Aclist レポートは常に使用できるため、今後行われる基本オブジェ
クト Aclist.rod への変更は、サブクラス化したデザインファイルに継承されます。
サブクラス化したデザインファイルは、C:¥Siebdev¥rptsrc¥enu に置いてください。
Actuate でサブクラス化した .ROD ファイルを作成するには
1 Actuate Developer Workbench を開きます。[ ファイル ] → [ 新規作成 ] を選択
します。
[ 新規ファイル ] ダイアログボックスが表示されます。
2 ラジオボタングループの [ デザインのサブクラス化 ] を選択して、[OK] をク
リックします。
4- 4
Siebel レポートガイド
バージョン 6.0
Reports.book
5 ページ
２００１年４月２７日　金曜日　午前１１時２７分
既存のレポートのサブクラス化
新規フィールドを持つサブクラス化レポートの作成
3 [ 基本デザインファイル選択 ] ダイアログボックスで、
C:¥Siebdev¥rptsrc¥enu¥standard フォルダにあるファイル Aclist.rod を選択します。
[ 新規レポートデザイン ] ダイアログボックスが表示されます。
4 タイトルおよびレポートルート名を Aclist2 に、ファイル名を Aclist2.rod に、
それぞれ変更します。
[ デザインエディタ ] ウィンドウが開き、新しい Aclist2.rod のツリー構造とレ
イアウトが表示されます。
5 [ ライブラリブラウザ ] アイコンをクリックします。[ インクルードモジュー
ル選択 ] ダイアログボックスで、Aclist.rod デザインファイルが組み込みモ
ジュールとしてリストされていることに注意してください。このことは、
Aclist2 レポートが構築およびコンパイルされるとき、Aclist のクラスが使用さ
れることを意味します。生成した BASIC コードには、次のクラス宣言が
Aclist2 に表示されます。
Class Aclist2 Subclass Of ::ACCLIST
6 [ キャンセル ] をクリックして [ インクルードモジュール選択 ] ダイアログ
ボックスを閉じます。
バージョン 6.0
Siebel レポートガイド
4-5
Reports.book
6 ページ
２００１年４月２７日　金曜日　午前１１時２７分
既存のレポートのサブクラス化
新規フィールドを持つサブクラス化レポートの作成
Content コンポーネントのサブクラス化
D
新規 Aclist2 レポートデザインには、複数のコンテンツフレームが含まれていま
す。最上位階層にあるレポートオブジェクトだけでなく、修正するそれぞれのコ
ンテンツフレームをサブクラス化します。これにより、基本オブジェクトが変更
されても、継承パターンに与える影響を最小限に抑えることができます。
それぞれの Content コンポーネントをサブクラス化するには
1 ツリー構造の Content アイコンを右クリックします。表示されるポップアップ
メニューの [ ローカルサブクラス ] オプションを選択します。
Content コンポーネント名のフォントの色が灰色から黒色に変わり、名前も
ssRptACLIST から ssRptACLIST1 に変わっていることに注意してください。
生成した BASIC コードのクラス宣言である
Class ssRptACLIST Subclass Of ssRpt
は変わりませんが、次の新しいクラス宣言が表示されます。
Class ssRptACLIST1 Subclass Of ::ACCLIST::ssRptACLIST
新規にサブクラス化した Content コンポーネントを変更すると、その変更内
容は新しいクラスに関するコードに表示されます。
2 ツリー構造で Content アイコンを展開します。ssGrpACLISTAccount という別
のコンテンツフレームが表示されます。このコンポーネントを右クリックし
て、前と同じように、[ ローカルサブクラス ] を選択します。名前が変更され
て、名前の最後に「1」が付加されます。このコンポーネントを展開します。
3 ssGrpACLISTLocation という別のコンテンツフレームが表示されます。この
コンポーネントを右クリックして、前と同じように、[ ローカルサブクラス ]
を選択します。さらに、この Content アイコンを展開します。
4- 6
Siebel レポートガイド
バージョン 6.0
Reports.book
7 ページ
２００１年４月２７日　金曜日　午前１１時２７分
既存のレポートのサブクラス化
新規フィールドを持つサブクラス化レポートの作成
4 ssFrmACLISTContent という別のコンテンツフレームが表示されます。このコ
ンポーネントを右クリックして、[ ローカルサブクラス ] を選択します。
[ デザインエディタ ] ウィンドウが表示されます。
バージョン 6.0
Siebel レポートガイド
4-7
Reports.book
8 ページ
２００１年４月２７日　金曜日　午前１１時２７分
既存のレポートのサブクラス化
新規フィールドを持つサブクラス化レポートの作成
レポートデザインへのフィールドの追加
D
以前にレポートオブジェクト定義階層へ追加し、データ供給 .ROL ファイルへエ
クスポートしたフィールドを、ここでサブクラス化したレポートデザインへ追加
します。
フィールドをレポートに追加するには
1 ツールバーの [ ライブラリブラウザ ] アイコンをクリックします。[ インクルー
ドモジュール選択 ] ダイアログボックスで、[ssCustom.ROL] を選択します。
ssCustom.ROL には、標準テキストとラベルコンポーネントが含まれています。
2 [ ライブラリ ] ウィンドウで ssLblB というライブラリコンポーネントを検索
し、それを、ssGrpACLISTLocation1:Content というラベルが付いたフレーム
のレポートレイアウトエリアに、他のラベルの横に並ぶようにドラッグしま
す。これにより、レポートレイアウトに太字フォントのラベルが作成されま
す。レイアウトグリッドでラベルを編集し、「URL」を読み込みます。
3 新規ラベルのフォントや色が他のラベルと異なる場合は、ラベルを右クリッ
クし、[ プロパティ ] を選択して、必要に応じて Font プロパティを調整して
ください。
4- 8
Siebel レポートガイド
バージョン 6.0
Reports.book
9 ページ
２００１年４月２７日　金曜日　午前１１時２７分
既存のレポートのサブクラス化
新規フィールドを持つサブクラス化レポートの作成
4 [ ライブラリ ] ウィンドウで ssTxt というオブジェクトを検索し、そのオブ
ジェクトを同じフレームのレポートレイアウトエリアにドラッグします。
データストリームからロードされるテキストフィールドが、レポートレイア
ウトに作成されます。[ コンポーネントプロパティ ] ダイアログボックスが表
示されます。
5 必要なフィールドをピックリストから選択します。名前の先頭に「ss」、そし
て空白のスペースに下線の付いた名前を持つ、Siebel フィールド名と同じ
フィールドを選択します。たとえば、ここでは ssHome_Page を選択します。
[OK] をクリックします。
6 レイアウトグリッドでテキストフィールドのサイズを変更して、URL データ
の文字列に合わせてサイズを調整します ( サイズが小さすぎると、URL の文
字列が切り捨てられます )。
7 作成したテキストオブジェクト (「Sample Value」) を右クリックし、ポップ
アップメニューで [ プロパティ ] を選択します。新規フィールドのフォント
あるいは色が他のフィールドと異なる場合、必要に応じて Font プロパティを
調整します。
バージョン 6.0
Siebel レポートガイド
4-9
Reports.book
10 ページ
２００１年４月２７日　金曜日　午前１１時２７分
既存のレポートのサブクラス化
新規フィールドを持つサブクラス化レポートの作成
8 [ クラス ] タブをクリックすると、クラスのプロパティが表示されます。
9 [ クラス名 ] フィールドで、テキストコントロールに一意の名前を指定します。
この例では txtHomePage です。
命名規則に応じて、Siebel フィールド名の後に txt という文字列を指定します。
レポートのコンパイル、展開、およびテスト
D
変更内容はレポートをコンパイルし、実行して確認できるようになりました。最
初は Actuate でデバッグを行い、次に Siebel アプリケーションを実行します。
Siebel アプリケーションから入手できる新規レポートは、該当する Siebel レポー
トオブジェクト定義にある旧 .ROX ファイルではなく、新しい .ROX ファイルを
参照する必要があります。
レポートを Actuate Developer Workbench でコンパイルしテストするには
1 Siebel Sales を起動し、[ 取引先 ( 個人 )] ビューを開きます。
2 Actuate Developer Workbench で [ ライブラリ ] ウィンドウを閉じます。[ 構築
と実行 ] アイコンをクリックします。
修正したレポートが生成され実行されます。
3 デザインに満足するまで、レポートデザインに必要な修正を行ってレポート
を再実行します。
4- 1 0
Siebel レポートガイド
バージョン 6.0
Reports.book
11 ページ
２００１年４月２７日　金曜日　午前１１時２７分
既存のレポートのサブクラス化
新規フィールドを持つサブクラス化レポートの作成
レポートを Siebel アプリケーションに展開してテストするには
1 Siebel Sales を閉じます。
2 Microsoft Windows のエクスプローラを使用して、実行可能ファイル Aclist2.rox
を C:¥Siebdev¥rptsrc¥enu から C:¥Siebdev¥reports¥enu にコピーします。
3 Siebel Tools を起動します。Object Explorer の Report オブジェクトタイプに移
動し、Object List Editor にある [Accounts-Current Query] というレポートを検索
( して強調表示 ) します。Access Base DB Name プロパティの値を ACLIST か
ら ACLIST2 に変更します。これにより、旧レポートでなく新しいレポートを
使用するように、Siebel アプリケーションに通知されます。
4 [Repository] → [Compile] を選択して、Report プロジェクトを再コンパイルし
ます。Siebel Tools を閉じます。
5 新しい .SRF ファイルを C:¥Siebel¥objects にコピーします。
6 Siebel Sales を起動して、ツールバーで [ 取引先 ] をクリックします。
7 [ レポート ] メニューから [ 取引先リスト ] を選択します。
バージョン 6.0
Siebel レポートガイド
4- 1 1
Reports.book
12 ページ
２００１年４月２７日　金曜日　午前１１時２７分
既存のレポートのサブクラス化
新規フィールドを持つサブクラス化レポートの作成
改訂された取引先リストレポートが [ レポートビューア ] ウィンドウに表示
されます。これには、修正が反映されています。
4- 1 2
Siebel レポートガイド
バージョン 6.0
Reports.book
1 ページ
２００１年４月２７日　金曜日　午前１１時２７分
グループセクションのあるレポート
5
この章について . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-2
グループセクションの動作 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-3
グループセクションのあるレポートの検討 . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-5
例－グループ区切りのあるレポートの作成 . . . . . . . . . . . . . . . . . . . . . . . . . . 5-8
Siebel Tools による新規レポートオブジェクト定義の作成 . . . . . . . . . . . . . . . 5-9
Actuate Developer Workbench によるレポートデザインの作成 . . . . . . . . . . . 5-11
ラベルおよびデータ要素のデザインへの追加 . . . . . . . . . . . . . . . . . . . . . . . . 5-13
レポートのコンパイルとテスト . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-16
グループ合計 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-17
例－売上合計のセールスステージテストレポートへの追加 . . . . . . . . . . . . 5-17
バージョン 6.0
Siebel レポートガイド
5-1
Reports.book
2 ページ
２００１年４月２７日　金曜日　午前１１時２７分
グループセクションのあるレポート
この章について
この章について
E
この章では、グループセクションを使用してグループ区切りのあるレポートを作
成する方法について説明します。グループ区切りは、値がキーフィールドで変わ
るレコードリストの点を指し、特殊な処理が行われます。その処理には通常、新
規見出しの印刷やときとしてページ区切り処理が含まれます。たとえば、取引先
のリストで、取引先ごとのレコードグループの前に取引先名を表示する見出しを
作成できます。レコード間の取引先名フィールドの変更は、新しい見出しをトリ
ガーします。
Siebel レポートでは、グループ区切りの動作は、レポートデザインの Group
Section コンポーネントを使用することにより実現します。
ビジネスコンポーネントレコードは、プライマリソートキーとしてグループ
フィールドでソートされなければならないことに注意してください ( ビジネスコ
ンポーネントのデフォルトのソート順序と異なる場合、通常はレポートオブジェ
クト定義の Sort Specification プロパティのソート順序になります )。これ以外の
場合、レコードは正確にグループ化されません。
グループセクションはまた、フィールドあるいはビジネスコンポーネントのある
フィールドにもとづいて単一のビジネスコンポーネントのレコードをクラスタ化
するものです。これは、マスタービジネスコンポーネントレコードごとに、別の
ビジネスコンポーネントの詳細なレコードをリストにするシナリオとは異なりま
す。リスト化するシナリオでは、第 6 章「マスター詳細レポート」に説明されて
いるマスター詳細レポートの設定が必要になります。このシナリオでは、マス
ターレベルあるいは 1 つまたはそれ以上のサブレポートのいずれでも、マスター
詳細レポートでのグループセクションの使用を除外することはありません。
5- 2
Siebel レポートガイド
バージョン 6.0
Reports.book
3 ページ
２００１年４月２７日　金曜日　午前１１時２７分
グループセクションのあるレポート
グループセクションの動作
グループセクションの動作
E
図 5-1 は、グループセクションを使用する簡単なレポートの構造を示しています。
Report Design
Report Section
DataStream
Group Section
Page Header
Content
After Section
図 5-1
グループレポートの構造
構造には、次のような重要なコンポーネントが含まれています。
バージョン 6.0
„
Report Design
このコンポーネントは、レポートの最上位のコンポーネントであり、自分が
常駐する .ROD ファイルに対応します。Report Design コンポーネントには、
グループレポートに関する特別な機能はありません。
„
Report Section
Report Section は、データの情報源、物理的なレイアウトおよびマスターある
いはサブレポートの動作を定義するコンポーネントをグループにまとめたも
のです。Group Section は、Group Section がクラスタ化するレコードを含む
Report Section の子となります。
Siebel レポートガイド
5-3
Reports.book
4 ページ
２００１年４月２７日　金曜日　午前１１時２７分
グループセクションのあるレポート
グループセクションの動作
5- 4
„
DataStream
DataStream コンポーネントは、Report Section に必要なデータの情報源を定義
します。DataStream には、グループ化した Report Section に対する特別な機能
はありませんが、プライマリソートキーとしてグループフィールドでデータ
がソートされるようにする必要があります。
„
Group Section
Group Section コンポーネントは、その親の Report Section に含まれるレコード
をグループ化あるいはグループを区切る動作を実行します。Group Section に
は、レコードのグループ化方法を決めるフィールドを定義する Key プロパ
ティと、グループの動作 ( グループ区切りをページ区切りとするかどうかな
どの動作 ) を定義するその他のプロパティがあります。
„
Page Header フレーム
Group Section を含む Report Section では、Page Header フレームは Report
Section の子ではなく Group Section の子となります。Page Header フレームの
内容は、各ページの冒頭に加え、それぞれの新規グループの冒頭で表示され
ます。ページヘッダーには、セールスステージ別商談グループごとのセール
スステージ名など、グループ区切り情報が含まれます。
„
Content フレーム
Content フレームは、1 つのレポート列のレイアウトを、グループ化されない
Report Section で動作するように定義します。ただしレポート列は、Report
Section の子ではなく、Group Section の子となります。
„
After Section
After Section は、レポートでグループの次に表示する内容を定義します。この
セクションは省略したり、グループ合計の表示に使用したりできます。詳細
については、5-17 ページの「グループ合計」を参照してください。
Siebel レポートガイド
バージョン 6.0
Reports.book
5 ページ
２００１年４月２７日　金曜日　午前１１時２７分
グループセクションのあるレポート
グループセクションの動作
グループセクションのあるレポートの検討
E
グループ化した簡単なレポートの設定を詳しく知るには、このタイプの標準
Siebel レポートを Actuate Develeoper Workbench で開き、そのレポートを学習する
ことが役立ちます。この学習に役立つ最適なレポートは Contacts By State レポー
トで、[ 担当者 ] 画面のビュー ( 一般的には、[ 担当者 ( 個人 )] ビュー ) から呼び
出されます。Siebel Sales のレポート出力と Actuate Developer Workbench のレポー
トデザインをそれぞれ開いたままで比較し、検討する必要があります。
都道府県別担当者レポートを Siebel Sales で生成するには
1 Siebel Sales を起動します。
2 タブバーの [ 担当者 ] を選択します。
[ 担当者 ( 個人 )] ビューが表示されます。
3 メニューバーで [ レポート ] → [ 都道府県別 ] を選択します。
都道府県別担当者レポートがレポートビューアに表示されます。
バージョン 6.0
Siebel レポートガイド
5-5
Reports.book
6 ページ
２００１年４月２７日　金曜日　午前１１時２７分
グループセクションのあるレポート
グループセクションの動作
都道府県別担当者レポートに必要なレポートデザインを開くには
1 Actuate Developer Workbench を開きます。
2 メニューバーから [ ファイル ] → [ 開く ] を選択します。
3 [ 開く ] ダイアログボックスで、C:¥Siebdev¥rptsrc¥enu¥standard フォルダ ( あ
るいはユーザーのコンピュータにある同じフォルダ ) に移動して、
Cntstate.rod を選択します。
図 5-2 には、Actuate Developer Workbench の Cntstate.rod レポートデザインを表示
しています。
図 5-2
都道府県別担当者レポートデザイン
レポートデザインを展開して、レポート出力の対応する機能とデザイン要素を
比較し、コンポーネントを右クリックしてそれぞれのプロパティリストを表示
します。
5- 6
Siebel レポートガイド
バージョン 6.0
Reports.book
7 ページ
２００１年４月２７日　金曜日　午前１１時２７分
グループセクションのあるレポート
グループセクションの動作
このレポートデザインの次の機能に関する注意事項
„
Group Section コンポーネント ssGrpState には、この Page Header と Content フレー
ムがあります。ssFrmCONTACTHeader1 および ssFrmCONTACTContent が該当
します。同じ Page Header および Content フレームが大部分の担当者レポート
で使用されているため、これらのフレームは ssCntct.rol カスタムコンポーネ
ントライブラリからサブクラス化されています。カスタムコンポーネントラ
イブラリに関する詳細については、3-25 ページの「カスタムコンポーネント
ライブラリの使用」を参照してください。
„
Page Header コンポーネント (ssFrmCONTACTHeader1) を展開すると、この
Content フレーム (ssFrmBlueBack1) が表示されます。子の Content フレームを
展開すると、ページヘッダーに現れるカラムの見出しラベルが表示されます。
„
Page Header のもう 1 つの子コンポーネントが、TxtCONTACTHeader1 という名
前のデータコントロールです。このコントロールをコンポーネントツリーで
強調表示すると、レイアウトペインでも強調表示されます ( コントロールの
サンプルテキストでは Subclass Me と表示されます )。
„
Page Header のデータコントロール (ssTxtCONTACTHeader1) は、新しい県ごと
に県名を省略して表示します。この県名は、Siebel Sales で生成したレポート
で表示できます。この動作を設定するデータコントロールのプロパティは、
ValueExp です。このプロパティの値は [ssState] で、Contact ビジネスコンポー
ネントにある [ 都道府県 ] フィールドに対応するデータストリーム変数です。
„
Group Section コンポーネントのプロパティ (ssGrpState) を確認する場合、この
プロパティには Key プロパティがあり、このプロパティには [ssState] が設定
されていることに注目してください。Group Section コンポーネントの Key プ
ロパティ値は、ソート区切りの発生時、つまりビジネスコンポーネントレ
コード間の対応するフィールドの値が変わったときを決定します。グループ
のキー値が変わると、新しい値を持ったページヘッダーの再表示がトリガー
されます。
次の項では、同じようなレポートデザインをユーザー自身で作成します。
バージョン 6.0
Siebel レポートガイド
5-7
Reports.book
8 ページ
２００１年４月２７日　金曜日　午前１１時２７分
グループセクションのあるレポート
例－グループ区切りのあるレポートの作成
例－グループ区切りのあるレポートの作成
E
この例では、商談レコードがセールスステージ別にグループ化されている商談リ
ストレポートを作成します。レポートでは、商談名、取引先名、予想売上額、お
よび商談レコードごとのクローズ日をリストにし、セールスステージをページ
ヘッダーで表示して、そのうしろにそのセールスステージを含む各商談レコード
のグループを表示します。結果レポートは、図 5-3 で示されたレポートのように
なります。
図 5-3
グループ区切りのあるレポートの例
レポートを作成するには、次の手順を実行します。
5- 8
„
新しいレポートオブジェクト定義 ( および子 ) を Siebel Tools で作成してエクス
ポートする
„
レポートデザインを Actuate で作成する
Siebel レポートガイド
バージョン 6.0
Reports.book
9 ページ
２００１年４月２７日　金曜日　午前１１時２７分
グループセクションのあるレポート
例－グループ区切りのあるレポートの作成
„
データコントロールとラベル要素をデザインに追加する
„
レポートをコンパイルしてテストする
Siebel Tools による新規レポートオブジェクト定義の作成
E
それぞれのレポートデザインには、通常、Siebel Tools および対応するデータ供
給ライブラリファイルに独自のレポートオブジェクト定義があります。第 3 章
「簡単なリストレポートの作成」では、レポートオブジェクト定義が最初から作
成されています。この例では、既存のレポートオブジェクト定義 ( および子 ) を
コピーしてプロパティ値のいくつかを変更します。
Siebel Tools でコピーにより新しいレポートオブジェクト定義を作成するには
1 Siebel Tools で、Object Explorer の Report オブジェクトタイプに移動し、
Object List Editor の [Opportunity List - Current Query] レポートオブジェクト定
義を強調表示します。
2 Report プロジェクトをロックします ([Repository] → [Lock Project] を選択し
ます )。
3 [Edit] → [Copy Record] を選択します。
これにより、オリジナルが同じ子のセットおよび複写したプロパティ設定を
持つ新規レポートオブジェクト定義が作成されます。
4 新規レポートオブジェクト定義で次のプロパティ設定を変更します ( 他のプ
ロパティ設定を変更する必要はありません )。
„
Name Test Group Report
この名前は、たとえば、レポートをビュー用として [ レポート ] メニュー
に追加するときなど、Siebel Tools でレポート構造を参照するのに使用さ
れます。
„
Access Base DB Name GROUPRPT
このプロパティは、このレポートオブジェクト定義がビューの [ レポート ]
メニューから呼び出されたとき、Testrpt.rox が呼び出されたレポート作成プ
ログラムの名前になることを指定します。
バージョン 6.0
Siebel レポートガイド
5-9
Reports.book
10 ページ
２００１年４月２７日　金曜日　午前１１時２７分
グループセクションのあるレポート
例－グループ区切りのあるレポートの作成
„
Menu Text Sales Stage - Test
このプロパティは、ビューレポートオブジェクト定義を使用することによ
りこのレポートがビューに含まれる場合に、ビューに必要な [ レポート ]
メニューに表示されるテキストです。
„
Template Name GROUPRPT
このプロパティは、[Generate Actuate Report] オプションがこのレポートオ
ブジェクト定義のために呼び出されたとき、生成されたデータ供給ライブ
ラリファイルに使用される名前を指定します。
„
Sort Specification Sales Stage
グループ区切りが正確に作動するのに必要な商談レコードを、セールスス
テージ順にソートします。この条件は、データストリーム方法で対応する
コードに翻訳されます。
5 [Tools] → [Generate Actuate Report] を選択して、データ供給ライブラリファイ
ルにエクスポートします。
選択すると、Template Name プロパティの値により命名されたデータ供給
.ROL ファイルが C:¥Siebdev¥rptsrc¥enu¥lib フォルダ ( あるいはユーザーのシ
ステムにある同じフォルダ ) に生成されます。
6 Report プロジェクトのロックを解除します。
7 Object Explorer の View オブジェクトタイプに移動します。
8 Object List Editor で、Opportunity List View オブジェクト定義にカーソルを移動
します。Object Explorer で、[View] を展開し [View Report] をクリックします。
これは、[ 商談 ] 画面の [ 商談 ( 個人 )] です。
9 Object List Editor のビューレポートオブジェクト定義を追加します。名前
「Test Group Report」( スペルミスとスペースに注意します ) およびリストの他
の順序番号より 1 つ多い順序番号を入力します。
10 [Repository] → [Compile] を選択してレポジトリを再コンパイルします。結果
.SRF ファイルを C:¥Siebel¥objects、あるいはユーザーシステムの同じ位置に
移動します。
5- 1 0
Siebel レポートガイド
バージョン 6.0
Reports.book
11 ページ
２００１年４月２７日　金曜日　午前１１時２７分
グループセクションのあるレポート
例－グループ区切りのあるレポートの作成
Actuate Developer Workbench によるレポートデザインの作成
E
この練習では、ライブラリコンポーネントを使用して新規レポートデザインを最
初から作成します。
レポートデザインを Actuate Developer Workbench で作成するには
1 Actuate Developer Workbench を開きます。
2 [ ファイル ] → [ 新規作成 ] を選択します。[ 新規ファイル ] ダイアログボッ
クスで、ラジオボタンの [ 空のレポートデザイン ] を選択します。
3 [ 新規レポートデザイン ] ダイアログボックスで、次の情報を入力します。
„
タイトル Grouped Opportunity Report
„
ファイル名 C:¥Siebdev¥rptsrc¥enu¥Grouprpt.rod
ファイル名と、作成するレポートデザインファイルを保存するフォルダの
場所です。..¥enu にサブフォルダ ¥custom がある場合は、そのフォルダに
保存します。
„
レポートオブジェクト名 Grouprpt
これにより、デザインファイルの最上位にあるレポートデザインオブジェ
クトの名前が指定されます。
4 [ ファイル ] → [ モジュールのインクルード ] を選択します。[ モジュールのイ
ンクルード ] ダイアログボックスで、C:¥Siebdev¥rptsrc¥enu¥lib ( あるいは同じ
内容のフォルダ ) に移動し、ssSiebel.rol を選択して [ 開く ] をクリックします。
[ ライブラリ ] ウィンドウを閉じます。
5 ライブラリファイル ssCustom.rol および Grouprpt.rol に手順 4 を繰り返します。
6 構造ツリーの Grouprpt ( 最上位 ) アイコンをダブルクリックします ( あるいは、
そのアイコンを右クリックして [ プロパティ ] を選択します )。[ コンポーネン
トエディタ ] ウィンドウで、[ クラス ] タブをクリックします。[ スーパークラ
ス ] の値を acReport から ssReport に変更します。
レポートのクラスを変更すると、次の 2 つのコンポーネントが自動的にレ
ポートに追加されます。Report Section (ssRpt) および PageList セクション
(ssPageList)
バージョン 6.0
Siebel レポートガイド
5- 1 1
Reports.book
12 ページ
２００１年４月２７日　金曜日　午前１１時２７分
グループセクションのあるレポート
例－グループ区切りのあるレポートの作成
7 [ ファイル ] → [ 上書き保存 ] を選択します。...¥enu ( あるいは ...¥enu¥custom)
フォルダの Grouprpt.rod を指定します。
デザインファイルは、作業中定期的に保存するようにしてください。
8 [ 表示 ] → [ オプション ] を選択して [ 空スロットを表示 ] オプションをチェッ
クします。
9 最上位のレポートコンポーネントを展開します。構造ツリーにある Report
Section の子コンポーネント (ssRpt) を右クリックします。ポップアップメ
ニューの [ ローカルサブクラス ] オプションを選択します。
10 Report Section コンポーネント (ssRpt1) を右クリックして [ 名前の変更 ] を選
択します。名前を ssRptOpportunity に変更します。
11 Report Section コンポーネント (ssRptOpportunity) を展開します。ツールバーの
[ ライブラリブラウザ ] アイコンをクリックして [ssCustom.rol] を選択します。
ssGrp ライブラリコンポーネントを Report Section の Content 子スロットにド
ラッグアンドドロップします。
12 Group Section コンポーネント (ssGrp) を右クリックして、[ ローカルサブクラ
ス ] を選択します。
13 Group Section コンポーネント (ssGrp1) を右クリックして [ 名前の変更 ] を選
択します。名前を ssGrpStage に変更します。
14 ssFrm コントロールを [ ライブラリ ] ウィンドウから Group Section の Content
スロットにドラッグします。フレームをローカルのサブクラスにして、その
名前を ssFrmOpportunityContent に変更します。
15 Group Section コンポーネント (ssGrpStage) を右クリックして、[ プロパティ ]
を選択します。Key プロパティで [ssSales_Stage] を入力します。[ コンポーネ
ントエディタ ] ウィンドウを閉じます。
16 ssFrm コンポーネントを [ ライブラリ ] ウィンドウから Group Section の
PageHeader スロットにドラッグアンドドロップします。フレームをローカル
のサブクラスにして、その名前を「ssFrmStageHeader」に変更します。[ ライ
ブラリ ] ウィンドウを閉じます。
5- 1 2
Siebel レポートガイド
バージョン 6.0
Reports.book
13 ページ
２００１年４月２７日　金曜日　午前１１時２７分
グループセクションのあるレポート
例－グループ区切りのあるレポートの作成
17 ツールバーの [ ライブラリブラウザ ] アイコンをクリックし、ダイアログ
ボックスで [Grouprpt.rol] を選択します。
[ ライブラリ ] ウィンドウが開き、Grouprpt.rol のコンテンツ、つまり、Siebel
Tools から生成したデータ供給ライブラリが表示されます。
18 [ ライブラリ ] ウィンドウの DataStream コンポーネント (ssOpportunityQuery)
を Design Editor の DataStream スロットにドラッグアンドドロップします。
[ ライブラリ ] ウィンドウを閉じます。
これで DataStream コンポーネントが Report Section コンポーネントの子にな
ります。
ラベルおよびデータ要素のデザインへの追加
E
ここでは、レポート列ごとのコンテンツフレームおよびページ区切りあるいは
ソート区切りごとのカラム見出しラベルに、データコントロールを追加します。
また、Page Header でセールスステージを定義して、各グループあるいはページ
区切りに含まれるセールスステージを表示します。
テキストおよびラベル要素を追加するには
1 [ ライブラリブラウザ ] アイコンをクリックし、[ インクルードモジュール選
択 ] ダイアログボックスで [ssCustom.rol] を選択します。
2 [ ライブラリ ] ウィンドウから Content フレームの空 Content の子スロット
(ssFrmOpportunityContent) に、ssTxt コンポーネントをドラッグアンドドロッ
プします。
[ コンポーネントプロパティ ] ダイアログボックスが表示されます。
3 [ コンポーネントプロパティ ] ダイアログボックスで、ドロップリストでク
リックして、DataStream から [ssName] フィールドを選択します。[OK] をク
リックして [ コンポーネントプロパティ ] ウィンドウを閉じます。
4 レイアウトグリッドで新しいデータコントロールのサイズを、商談名データ
に適したサイズに変更します ( サイズが小さすぎると、名前が切り捨てられ
ます )。
バージョン 6.0
Siebel レポートガイド
5- 1 3
Reports.book
14 ページ
２００１年４月２７日　金曜日　午前１１時２７分
グループセクションのあるレポート
例－グループ区切りのあるレポートの作成
5 データコントロールを右クリックして、ポップアップメニューから [ 名前の
変更 ] を選択します。テキストコントロールに内容を表す一意の名前、この
場合は txtOpportunity を付けます。
6 データコントロールを右クリックして、ポップアップメニューから [ プロパ
ティ ] を選択します。[CanGrow] プロパティが TRUE に設定されていること
を確認します。
このプロパティが TRUE に設定されていると、ビジネスコンポーネント
フィールドにおける複数行の値がレポートで複数行の値として印刷されます。
FALSE の場合は、それぞれの値の 1 行目だけが印刷されます。
7 手順 2 ～手順 6 を繰り返して、次のコントロールを追加します。
„
ssAccount にもとづく txtAccount という名前のコントロール
„
ssClose_Date にもとづく txtCloseDate という名前のコントロール
データコントロールを作成した後、右側にあるレイアウトペインに各データ
コントロールを再度位置付ける必要があることに注意してください。
8 ssCur コンポーネントを [ ライブラリ ] ウィンドウから Content フレーム
(ssFrmOpportunityContent) にドラッグアンドドロップします。
[ コンポーネントプロパティ ] ダイアログボックスが表示されます。
9 [ コンポーネントプロパティ ] ダイアログボックスで、DataStream から
[ssRevenue] フィールドを選択します。[ コンポーネントプロパティ ] ダイア
ログボックスを閉じ、レイアウトグリッドで通貨コントロールのサイズ変更
と再位置付けを行い、その名前を curRevenue に変更します。
金額の表示にはテキストデータコントロールではなく通貨データコントロー
ルが使用されます。これにより、表示と位置合わせが正確に行われます。
10 ハンドルの 1 つをドラッグして、オリジナルの高さの 2 倍になるように Page
Header フレーム (ssFrmStageHeader) を縦に拡大します。
追加されたスペースは、仕切りラインおよびセールスステージデータコント
ロールに必要となります。
11 LineControl ライブラリコンポーネントを Page Header フレーム (ssFrmHeader)
にドラッグアンドドロップします。名前を LineSeparator に変更します。
5- 1 4
Siebel レポートガイド
バージョン 6.0
Reports.book
15 ページ
２００１年４月２７日　金曜日　午前１１時２７分
グループセクションのあるレポート
例－グループ区切りのあるレポートの作成
12 ssTxtSectionHeadeM ライブラリコンポーネントを Page Header スロットにド
ラッグアンドドロップします。[ コンポーネントエディタ ] ウィンドウで、
ValueExp プロパティの [ssSales_Stage] を指定します。
このテキストコントロールは、セールスステージをページヘッダーで表示す
るコントロールです。このコントロールのフォントは、他より大きい太字で
色は栗色です。
13 新規データコントロールコンポーネントをローカルのサブクラスにして、そ
の名前を ssTxtStageName に変更します。レイアウトペインのコントロールの
幅を広げて、セールスステージ名に十分な広さを確保します。
14 ssFrmBlueBack ライブラリコンポーネントを Page Header スロットにドラッグ
アンドドロップします。自動的にローカルのサブクラスとなります。このフ
レームコンポーネントの名前を ssFrmOpportunityHeader に変更します。それ
を展開して子のスロットを呼び出します。
このフレームには列の見出しが含まれます。
15 次にリストされたラベルを作成するには、ラベルごとに ssLb1Head コンポー
ネントを Page Header フレーム (ssFrmOpportunityHeader) にドラッグアンドド
ロップします。Text プロパティをラベルごとに指示どおり設定します。ラベ
ルが作成されている場合は、ラベルごとにサイズ変更、再位置付けおよび名
前の変更が必要です。それぞれのラベルは、対応するデータコントロールと
垂直方向で一直線に並ぶはずです。
„
Opportunity の Text プロパティ値を持つ、1b1Opportunity という名前のラベル
„
Account の Tex] プロパティ値を持つ、1b1Account という名前のラベル
„
Close Date の Text プロパティ値を持つ、1b1CloseDate という名前のラベル
„
Revenue の Text プロパティ値を持つ、1b1Revenue という名前のラベル
16 LineControl コンポーネントを ssFrmStageHeader フレームにドラッグアンド
ドロップします。名前を LineSeparator に変更します。レイアウトペインの
ラインがセールスステージデータコントロールの上にくるように再位置付け
します。
区切りラインはレポート列の間に境界を作成します。
17 最上位のレポートコンポーネントを右クリックして、[ プロパティ ] を選択し
ます。Group Test Report の値を [ssReportTitle] プロパティに入力します。
バージョン 6.0
Siebel レポートガイド
5- 1 5
Reports.book
16 ページ
２００１年４月２７日　金曜日　午前１１時２７分
グループセクションのあるレポート
例－グループ区切りのあるレポートの作成
レポートのコンパイルとテスト
E
レポートを構築、コンパイルして、Actuate Developer Workbench で実行します。
それから、Actuate Developer Workbench によりローカルでデバッグすることがで
きます。それを展開できるようになったら、レポートの実行可能バージョンを、
Siebel アプリケーションがそれぞれのレポート作成プログラムを取得するフォル
ダに移動します。
レポートをコンパイルしてインストールするには
1 Siebel Sales を起動して、[ 商談 ( 個人 )] ビューに移動します。必要なクエ
リーがアクティブか確認します。
2 Actuate Developer Workbench で、ツールバーの [ 構築と実行 ] アイコンを選択
するか、[ レポート ] → [ 構築と実行 ] を選択します。
レポートが Actuate ビューアに表示されます。
3 必要な修正をレポートデザインに行い、必要であれば何度でも再コンパイル
してください。
4 Windows のエクスプローラを使用して、Grouprpt.rox ファイルを
C:¥Siebdev¥rptsrc¥enu ( または相当のフォルダ ) から C:¥Siebel¥reports¥enu ( ま
たは相当フォルダ ) へコピーします。
5 Siebel Sales で [ レポート ] → [ セールスステージ - テスト ] を選択します。
レポートが Siebel Sales で表示されるはずです。問題が発生する場合はレ
ポートの設定をチェックし、Siebel Tools でレポートオブジェクト定義を表示
します。
5- 1 6
Siebel レポートガイド
バージョン 6.0
Reports.book
17 ページ
２００１年４月２７日　金曜日　午前１１時２７分
グループセクションのあるレポート
グループ合計
グループ合計
E
グループ合計は、各グループセクションの最後にある 1 つあるいはそれ以上の数
値レポートカラムの真下に表示することができます。これにより、金銭および数
量フィールドの各グループ内に小計が表示されます。これらのフィールドの総計
は、レポートの最後に表示されます。
グループ合計データコントロールは、Group Section の子 After フレームで設定し
ます。グループ合計コントロールは、グループのすべてのレポート列に含まれる
データストリーム変数の値を合計します。これを実現するために、Sum 関数が
使用されます。Group Section の After フレーム内における Sum 関数の範囲は、そ
のグループのレコードに限定されます。Sum 関数に関する詳細については、
『Developing Advanced e.Reports』のフレームおよびコントロールに関する情報を
参照してください。
例－売上合計のセールスステージテストレポートへの追加
E
この例では、5-8 ページの「例－グループ区切りのあるレポートの作成」で作成
したレポートを使用します。グループ合計コントロールは、ssGroupStage Group
Section の After セクションに追加されます。これにより、グループごとの売上金
額を合計できます。
売上合計をグループセクションに追加するには
1 ツールバーの [ ライブラリブラウザ ] アイコンをクリックします。[ インク
ルードモジュール選択 ] ダイアログボックスで、[ssCustom.rol] を選択します。
2 ssFrm コンポーネントを [ ライブラリ」ウィンドウから Group Section の子の
After セクションにドラッグアンドドロップします。フレームをローカルのサ
ブクラスにして、その名前を「ssFrmGroupTotals」に変更します。
3 レイアウトペインでフレームの高さをオリジナルの 2 倍の高さに広げます。
4 ssCur コンポーネントを [ ライブラリ ] ウィンドウから ssFrmGroupTotals フ
レームにドラッグアンドドロップします。ValueExp には、次のように指定し
ます。
Sum (Val([ssRevenue]))
バージョン 6.0
Siebel レポートガイド
5- 1 7
Reports.book
18 ページ
２００１年４月２７日　金曜日　午前１１時２７分
グループセクションのあるレポート
グループ合計
5 新しい ssCur コンポーネントの名前を curGroupRevenueTot に変更します。そ
のコンポーネントをレイアウトフレームに再位置付けして、レポートの売上
カラムと並ぶようにします。
6 LineControl コンポーネントを [ ライブラリ ] ウィンドウから ssFrmGroupTotals
フレームにドラッグアンドドロップします。名前を LineTotal に変更します。
コンポーネントをレイアウトペインで売上合計コントロールの上に来るように
垂直方向に再位置付けして、左ハンドルを使用してラインを狭め、そのコン
ポーネントが合計コントロールの上のスペースのみを占有するようにします。
7 レポートデザインを保存し、再コンパイルしてテストします。
下の図がその結果レポートです。
5- 1 8
Siebel レポートガイド
バージョン 6.0
Reports.book
19 ページ
２００１年４月２７日　金曜日　午前１１時２７分
グループセクションのあるレポート
グループ合計
最終合計をレポートに追加するには
1 [ ライブラリ ] ウィンドウから Report Section の子 After スロット
(ssReportOpportunity) に、ssFrm コンポーネントをドラッグアンドドロップし
ます。そのコンポーネントをローカルでサブクラス化して名前を
ssFrmReportTotals に変更します。
2 レイアウトペインでフレームの高さをオリジナルの 2 倍の高さに広げます。
3 ssCur コンポーネントを [ ライブラリ ] ウィンドウから ssFrmReportTotals フ
レームにドラッグアンドドロップします。ValueExp には、次のように指定し
ます。
Sum (Val([ssRevenue]))
4 新しい ssCur コンポーネントの名前を「curReportRevenueTot」に変更します。
そのコンポーネントをレイアウトフレームに再位置付けして、レポートの売
上カラムと並ぶようにします。
5 LineControl コンポーネントを [ ライブラリ ] ウィンドウから
ssFrmReportTotals フレームにドラッグアンドドロップします。名前を
LineRptTotal に変更します。コンポーネントをレイアウトペインで売上合計
コントロールの上に来るように垂直方向に再位置付けして、左ハンドルを使
用してラインを狭め、そのコンポーネントが合計コントロールの上のスペー
スのみを占有するようにします。
6 ssLblb コンポーネントを [ ライブラリ ] ウィンドウから ssFrmReportTotals フ
レームにドラッグアンドドロップします。名前を 1b1RptTotal に変更します。
そのコンポーネントを売上合計コントロールのすぐ左に再位置付けします。
その Text プロパティを Grand Total に設定します。
バージョン 6.0
Siebel レポートガイド
5- 1 9
Reports.book
20 ページ
２００１年４月２７日　金曜日　午前１１時２７分
グループセクションのあるレポート
グループ合計
7 レポートデザインを保存し、再コンパイルしてテストします。
次の図がその結果レポートです。
備考 : ssCur コンポーネントでは、すべての金額は、Windows コントロールパ
ネルの [ 地域 ] で指定した通貨建てになっていると仮定されます。詳しくは、
A-6 ページの「売上情報の表示」を参照してください。
5- 2 0
Siebel レポートガイド
バージョン 6.0
Reports.book
1 ページ
２００１年４月２７日　金曜日　午前１１時２７分
マスター詳細レポート
6
この章について . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-2
マスター詳細レポートの概要 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-4
既存のマスター詳細レポートの検証 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-6
例‐マスター詳細レポートの作成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-10
Siebel Tools での新しいレポートオブジェクト定義の作成 . . . . . . . . . . . . . . 6-11
カスタムコンポーネントライブラリの作成 . . . . . . . . . . . . . . . . . . . . . . . . . . 6-14
Actuate Developer Workbench でのレポートデザインの作成 . . . . . . . . . . . . . 6-15
レポートデザインへのデータストリームの追加 . . . . . . . . . . . . . . . . . . . . . . 6-17
デザインへのフレーム、データコントロール、ラベル要素の追加 . . . . . . 6-18
レポートのコンパイルとテスト . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-21
バージョン 6.0
Siebel レポートガイド
6-1
Reports.book
2 ページ
２００１年４月２７日　金曜日　午前１１時２７分
マスター詳細レポート
この章について
この章について
F
この章では、マスター詳細レポートを作成する方法について説明します。マスター
詳細レポートには、それぞれのマスタービジネスコンポーネントの各レコードに
ついて詳細ビジネスコンポーネントレコードのリストが表示されます。この場合、
マスタービジネスコンポーネントと詳細ビジネスコンポーネントは、一対多関係
にあります。マスター詳細レポートは、各マスターレコードの詳細レコードが表
示されるという点で、Siebel アプリケーションでのマスター詳細ビューに似てい
ます。マスター詳細ビューと違うのは、マスター詳細レポートには、1 つのマス
ターレコードの詳細レコードが表示されるのではなく、すべてのマスターレコー
ドの詳細レコードが一度に表示されることです。
レポートに詳細ビジネスコンポーネントのレコードリストがあるときには、その
レポートはサブレポートを含んでいる、といいます。しかし、サブレポートとい
う言葉は、詳細レコードのリストが 1 つだけ存在するというニュアンスがあるた
め、場合によっては誤解を招くおそれがあります。確かに、各マスターレコード
のあとに詳細レコードの 1 つのリスト (1 つのサブレポート ) があります。
しかし、
Siebel Tools とレポートデザインのいずれにおいても、1 つのサブレポートが指定
された場合、マスターごとに詳細レコードのリストが 1 つ表示されます。
6- 2
Siebel レポートガイド
バージョン 6.0
Reports.book
3 ページ
２００１年４月２７日　金曜日　午前１１時２７分
マスター詳細レポート
この章について
マスター詳細レポートの 1 つの例として、図 6-1 に示した、Siebel Service 内の
サービスリクエスト活動レポートがあげられます。
図 6-1
サービスリクエスト活動レポート
このレポートには、各サービスリクエストのマスター情報と、そのサービスリク
エストの活動のリストが示されます。各サービスリクエストは、それぞれ独自の
ページから始まります。このレポートについては、6-6 ページの「既存のマス
ター詳細レポートの検証」に説明してあります。
マスター詳細レポートには、複数のサブレポートを含めることもできます。その
場合、各マスターレコードの複数のビジネスコンポーネントそれぞれについて、
詳細レコードのリストが表示されます。たとえば、取引先サービス詳細レポート
には、顧客調査返答、商談、サービスリクエストという 3 つのリストがあります
( それぞれが各取引先マスターレコードのリスト )。6-10 ページの「例‐マス
ター詳細レポートの作成」に、2 つのサブレポートをもつレポートについて説明
しています。Siebel 標準レポートでは、複数のサブレポートをもつマスター詳細
レポートも頻繁に使用されます。
バージョン 6.0
Siebel レポートガイド
6-3
Reports.book
4 ページ
２００１年４月２７日　金曜日　午前１１時２７分
マスター詳細レポート
マスター詳細レポートの概要
マスター詳細レポートの概要
F
図 6-2 は、Actuate におけるマスター詳細レポートの構造を示しています。
Report Design
Report Section (master)
DataStream (master)
Group Section
Sequential Section
Before Section
Report Section (subreport 1)
DataStream (subreport 1)
Page Header
Content
Report Section (subreport 2)
DataStream (subreport 2)
Page Header
Content
(etc.)
図 6-2
6- 4
マスター詳細レポートの構造
Siebel レポートガイド
バージョン 6.0
Reports.book
5 ページ
２００１年４月２７日　金曜日　午前１１時２７分
マスター詳細レポート
マスター詳細レポートの概要
マスター詳細レポートの中の主要なコンポーネントは次のとおりです。
バージョン 6.0
„
Report Design
レポートの最上位のコンポーネントであり、このコンポーネントが属す
.ROD ファイルに対応しています。マスター詳細レポートの Report Design コ
ンポーネントに固有な機能はありません。
„
Master Report Section
Master Report Section は、各マスターレコードのデータの取得と表示の方法を
定義し、その子コンポーネントを通じてサブレポートを定義します。
„
Master Datastream
Master データストリームコンポーネントは、マスターレコードのデータ源を
定義します。各サブレポートごとに、詳細データを取得するための個別の
データストリームが定義されます。グループレポートの場合と同様に、デー
タはプライマリソートキーとしてのグループフィールドによってソートされ
る必要があります。
„
Group Section
Group Section コンポーネントは、親のレポートセクション内でのマスターレ
コードのグループ化とグループ区切りの行動を実装します。この行動は、
Group Section の Key プロパティと、PageBreakBefore などそのほかのプロパ
ティに定義されます。サブレポートは、Group Section コンポーネントの子に
あたります。
„
Sequential Section
Sequential Section は、その子セクションコンポーネントを 1 つずつ順に実行
させるためのセクションです。マスター詳細レポートでは、Before フレーム
のあとに最初のサブレポートセクションが実行され、そのあと他の各サブレ
ポートセクション ( 存在するとき ) が実行されます。
„
Before Section
このセクションには、各マスターレコードに対して一度だけ現れ、サブレ
ポートの前にマスター情報を表示するフレームが保持されます。
„
Subreport Report Section
各 Subreport Report Section は、マスター詳細レポート内の 1 つのサブレポート
を定義します。各 Subreport Report Section には、子コンポーネントによって定
義される専用のデータストリームとコンテントフレームがあります。
Siebel レポートガイド
6-5
Reports.book
6 ページ
２００１年４月２７日　金曜日　午前１１時２７分
マスター詳細レポート
マスター詳細レポートの概要
„
Subreport Datastream
各詳細データストリームは、1 つのサブレポート ( 親のレポートセクション )
内の詳細レコードにデータを提供します。データは、現在のマスターレコー
ドの詳細レコードすべてをリクエストするマスタービジネスコンポーネント
クエリーのサブクエリーを通じて取得されます。
„
Subreport Page Header フレーム
サブレポートレポートセクション内のページヘッダーフレームは、サブレ
ポートレコードのヘッダー情報を定義します。通常、ヘッダー情報には、サ
ブレポートレコードの上に表示させる情報として、サブレポートを識別する
タイトルと列ヘッダーラベルが含まれます。
„
Subreport Content Frame
コンテントフレームは、サブレポートの 1 行のレイアウトを定義します。
既存のマスター詳細レポートの検証
F
簡単なマスター詳細レポートの設定方法を身につける方法として、このタイプの
標準 Siebel レポートを参考にするとよいでしょう。この目的に適したレポート
は、全サービスリクエスト活動レポートです。このレポートは、Siebel Service の
[ サービス ] 画面内のビューから呼び出します ( 一般には [ サービスリクエスト
( 個人 )] ビュー )。Siebel Service でレポート出力を表示させ、Actuate Developer
Workbench でレポートデザインを表示させ、2 つを比較できるように両方を開い
たままにします。
Siebel Service でサービスリクエスト活動レポートを生成するには
1 Siebel Service を起動します。
2 タブバーで [ サービス ] を選択します。
[ サービスリクエスト ( 個人 )] ビューが表示されます。
3 メニューバーで [ レポート ] → [ 全サービスリクエスト活動 ] を選択します。
6-3 ページの図 6-1 のように、サービスリクエスト活動レポートがレポート
ビューアに表示されます。
6- 6
Siebel レポートガイド
バージョン 6.0
Reports.book
7 ページ
２００１年４月２７日　金曜日　午前１１時２７分
マスター詳細レポート
マスター詳細レポートの概要
サービスリクエスト活動レポートのレポートデザインを開くには
1 Actuate Developer Workbench を起動します。
2 メニューバーから [ ファイル ] → [ 開く ] を選択します。
3 [ 開く ] ダイアログボックスで、C:¥Siebdev¥rptsrc¥enu¥standard フォルダ ( ま
たはコンピュータ上の同等の場所 ) に移動し、[Srvreqaa.rod] を選択します。
図 6-3 は、Actuate Developer Workbench で開いた Srvreqaa.rod レポートデザイン
ファイルです。
図 6-3
サービスリクエスト活動レポートのレポートデザイン
レポートデザインを詳細に確認してください。そのデザイン要素と、レポート出
力での対応する要素とを比較してみます。コンポーネントを右クリックすると、
そのプロパティリストが表示されます。
バージョン 6.0
Siebel レポートガイド
6-7
Reports.book
8 ページ
２００１年４月２７日　金曜日　午前１１時２７分
マスター詳細レポート
マスター詳細レポートの概要
このレポートデザインには、以下に示す特徴があります。
„
各サービスリクエスト ( マスター ) レコードの前にページ区切りがあります。
これは、Group Section コンポーネント (ssGrpRowID) の PageBreakBefore プロ
パティの値 TRUE によって設定されています。
„
グループセクション内の Before フレームと、レポートセクション内のページ
ヘッダーとコンテントフレームは、ssSrvReq.rol カスタムコンポーネントライ
ブラリから取得される公開されたコンポーネントです。これらのフレームの
内容は、サービスリクエストごとに活動をリストする 2 つのレポートで同じ
ように使用されています。
„
2 つのデータストリーム ( マスターレポート内の ssService_RequestQuery と活動
サブレポート内の ssActionQuery_1) は、データ供給ライブラリファイル
Srvreqaa.rol から取得されます。マスター詳細レポートのデータ供給ライブラ
リファイルには、マスターレポート用に 1 つのデータストリームと、各サブ
レポート用に 1 つずつのデータストリームが用意されています。
Siebel Tools で、このレポートのレポートオブジェクト定義 ( と子 ) を表示させる
ことで、さらに情報が得られます。
Siebel Tools でレポートオブジェクトと子オブジェクトの定義を表示させる
には
1 Siebel Tools を起動します。
2 Object Explorer の Report オブジェクトタイプに移動して、それを展開します。
2 つの子オブジェクトタイプ Report Field と Sub Report があります。
3 Object List Editor 内の [Reports] ウィンドウで、[Service Request Activity - All] オ
ブジェクト定義に移動します。
6- 8
Siebel レポートガイド
バージョン 6.0
Reports.book
9 ページ
２００１年４月２７日　金曜日　午前１１時２７分
マスター詳細レポート
マスター詳細レポートの概要
4 Object Explorer 内で Sub Report オブジェクトタイプをクリックします。2 番目
の [Object List Editor] ウィンドウが開き、現在の親レポートの子オブジェクト
にあたるサブレポートの定義が表示されます。次の図のようになります。
Service Request Activity - All レポートには、1 つの子オブジェクトであるサブ
レポートの定義 (Action) があります。Action サブレポートオブジェクト定義
は、活動サブレポートを定義します。
Action サブレポートのビジネスコンポーネントプロパティ設定は Action であ
ることに注意してください。別のレポート名はありません。なぜなら Actuate
内のサブレポートは、レポートデザインの内部的なオブジェクト ( サブレ
ポートオブジェクト定義の親を使用する ) であるからです。
バージョン 6.0
Siebel レポートガイド
6-9
Reports.book
10 ページ
２００１年４月２７日　金曜日　午前１１時２７分
マスター詳細レポート
例‐マスター詳細レポートの作成
5 Sub Report オブジェクトタイプを展開し、[Sub Report Field] を選択します。
Action サブレポートオブジェクト定義の子として定義されたフィールドのリ
ストがあります。
サブレポートに対するサブレポートフィールドオブジェクト定義の役割は、
レポートに対するレポートフィールドオブジェクト定義の役割と同じです。
つまり、指定されたビジネスコンポーネントからレポートまたはサブレポー
トにエクスポートするフィールドを定義します。
例‐マスター詳細レポートの作成
F
この例では、各取引先の商談リストと担当者リストを提供する取引先レポートを
作成します。作成されるレポートは、図 6-4 の例のようになります。
図 6-4
6- 1 0
2 つのサブレポートをもつマスター詳細レポートの例
Siebel レポートガイド
バージョン 6.0
Reports.book
11 ページ
２００１年４月２７日　金曜日　午前１１時２７分
マスター詳細レポート
例‐マスター詳細レポートの作成
このレポートを作成するには、次の手順が必要です。
„
Siebel Tools で、新しいレポートオブジェクトと子オブジェクトの定義を作成
してエクスポートする
„
カスタムコンポーネントライブラリを作成する
„
Actuate Developer Workbench でレポートデザインを作成する
„
レポートデザインにデータストリームを追加する
„
デザインに、フレーム、データコントロール、ラベル要素を追加する
„
レポートをコンパイルしてテストする
Siebel Tools での新しいレポートオブジェクト定義の作成
F
普通、各レポートデザインには、Siebel Tools 内の対応するレポートオブジェク
ト定義と、対応するデータ供給ライブラリファイルとが含まれます。第 5 章「グ
ループセクションのあるレポート」では、レポートオブジェクト定義を既存の定
義からコピーし、小さな変更を行いました。この例でも、効率的な同じ方法をと
りますが、より広範な変更を行います。
Siebel Tools でコピーによって新しいレポートオブジェクト定義を作成する
には
1 Siebel Tools を起動します。Account ビジネスオブジェクトに、Account ( マス
ター ) ビジネスコンポーネントに関連する詳細ビジネスコンポーネントとし
て Opportunity と Contact があることを確認します。
このステップは、この例では不要ですが、あまり一般的ではないビジネスコ
ンポーネント関係を使用するときには確認するようにしてください。ビジネ
スオブジェクト内のビジネスオブジェクトコンポーネントとリンクによって
指定されるマスター - 詳細関係は、マスター - 詳細データストリーム関係が
機能するうえで必要です。
2 Object Explorer で Report オブジェクトタイプに移動します。このオブジェクト
タイプを展開して、子である Sub Report オブジェクトタイプを表示させます。
バージョン 6.0
Siebel レポートガイド
6- 1 1
Reports.book
12 ページ
２００１年４月２７日　金曜日　午前１１時２７分
マスター詳細レポート
例‐マスター詳細レポートの作成
3 レポートの [Object List Editor] ウィンドウで、Account Summary オブジェクト
定義を選択します。
このレポートには、Opportunity や Contact など、7 つの子サブレポートがあり
ます。商談と担当者の 2 つのサブレポートをもつ取引先レポートオブジェク
ト定義であれば、他の定義でもかまいません。このレポートオブジェクト定
義をコピーしてから、不要な子サブレポートを削除します。
4 Report プロジェクトをロックします ([Repository] → [Lock Project] を選択し
ます )。
5 Account Summary オブジェクト定義が選択されている状態で、[Edit] → [Copy
Record] を選択します。
新しいレポートオブジェクト定義が作成されます。この定義では、[Name] プ
ロパティと [Menu Text] プロパティが空であり、その他の子供とプロパティは
元の定義に一致しています。
6 新しいレポートオブジェクト定義のうち、次のプロパティ設定を変更します
( これ以外のプロパティ設定は変更する必要がありません )。
„
Name Account - Opty/Contact Detail
この名前は、たとえば、レポートをビュー用として [ レポート ] メニュー
に追加するときなど、Siebel Tools でレポート構造を参照するのに使用さ
れます。
„
Access Base DB Name ACOPCOM
これは、ビューの [ レポート ] メニューからこのレポートオブジェクト定
義が呼び出されるときに呼び出されるレポート作成プログラムの名前が
Acopcom.rox であることを指定します。
„
Menu Text Account - Opportunity/Contact Detail
そのレポートがビューレポートオブジェクト定義の使用を通じてビューに
含められているときに、ビューの [ レポート ] メニューに表示されるテキ
ストです。
6- 1 2
Siebel レポートガイド
バージョン 6.0
Reports.book
13 ページ
２００１年４月２７日　金曜日　午前１１時２７分
マスター詳細レポート
例‐マスター詳細レポートの作成
„
Template Name ACOPCOM
そのレポートオブジェクト定義用に [Generate Actuate Report] オプションが
呼び出されるときに生成されるデータ供給ライブラリファイルに使う名前
を指定します。
„
Sort Specification ( 空白 )
初期設定では、取引先レコードを取引先名の順にソートします。このこと
はグループ区切りを正しく機能させるうえで必要です。空白にしないで、
取引先の値を指定することもできます。
7 Object List Editor で、新しいレポートオブジェクト定義の Sub Reports リスト
に移動します。商談と担当者を除くサブレポートオブジェクト定義すべてを
削除します ([Edit] → [Delete Record] を使用します )。
8 商談サブレポートの Sub Report Fields オブジェクト定義を展開します。次の
サブレポートフィールドがまだ存在していなければ追加します。City、Close
Date、Description、Name、Postal Code、Rep %、Revenue、Sales Rep、Sales
Stage。
9 [Tools] → [Generate Actuate Report] を選択することで、データ供給ライブラリ
ファイルにエクスポートします。
これにより、データ供給 .ROL ファイルが C:¥Siebdev¥rptsrc¥enu¥lib フォルダ
( またはシステム内の同等の場所 ) 内に生成されます ( ファイル名は [Template
Name] プロパティの値にもとづいて付けられます )。
10 Report プロジェクトのロックを解除します。
11 Object Explorer の View オブジェクトタイプに移動します。
12 Object List Editor で、Account List View オブジェクト定義を見つけます。
Object Explorer で View を展開し、[View Report] をクリックします。
これは、[ 取引先 ] 画面の [ 取引先 ( 個人 )] ビューです。
13 Object List Editor 内で、ビューレポートオブジェクト定義を追加します。名前
「Account - Opty/Contact Detail」( スペルとスペースを正確に入力すること ) と、
リスト内で最も大きい順序番号より 1 だけ大きい順序番号を入力します。
14 [Repository] → [Compile] を選択し、レポジトリを再コンパイルします。生成
された .SRF ファイルを C:¥Siebel¥objects ( またはシステム内の同等の場所 )
に移動します。
バージョン 6.0
Siebel レポートガイド
6- 1 3
Reports.book
14 ページ
２００１年４月２７日　金曜日　午前１１時２７分
マスター詳細レポート
例‐マスター詳細レポートの作成
カスタムコンポーネントライブラリの作成
F
以下の例では、ライブラリコンポーネントを使用して新しいレポートデザインを
作成します。他のレポートデザインやカスタムライブラリ内のコンポーネントを
使うことで、デザイン時間を短縮できます。カスタムコンポーネントライブラリ
については、3-25 ページの「カスタムコンポーネントライブラリの使用」を参照
してください。カスタムライブラリはすでに存在し、商談詳細フレーム情報
(ssOppt.rol) が入っています。しかし、取引先マスター詳細フレームと担当者詳細
フレームの各レイアウトを既存のレポートデザイン ( この場合は Acreview.rod) か
ら新しいカスタムコンポーネントライブラリに公開する必要があります。
取引先マスター詳細フレームと担当者詳細フレームをもつカスタムコン
ポーネントライブラリを作成するには
1 Actuate Developer Workbench で、Acreview.rod (Account Review) レポートデザ
インを開きます。
2 [ ファイル ] → [ 新規ライブラリ ] を選択します。名前 ssAcct.rol とパス
C:¥Siebdev¥rptsrc¥enu¥lib を指定します。
3 Acreview レポートから ssAcct.rol カスタムライブラリに、次のフレームをド
ラッグアンドドロップします ([ コンポーネントをドロップ ] ダイアログボック
スでそれぞれについて [ コンポーネントを公開 ] オプションを選択します )。
„
ssFrmHeadSection。グループセクションの Before フレームであり、取引先
ヘッダー情報を表示します。
„
ssFrmContactsBefore
„
ssFrmContactsContent
4 レポートデザインとライブラリを保存するように指示されたら、Acreview.rod
レポートデザインを閉じ、[ すべて保存 ] ボタンをクリックします。
Acreview.rod レポートと新しい Account - Opportunity/Contact Detail レポートは、
このライブラリのフレームコンポーネントを共有します。どちらかのレポートで
カスタマイズが必要になったときは、変更が一方のレポートだけに限定されるよ
うに、コンポーネントがまずローカルサブクラス化されます。
6- 1 4
Siebel レポートガイド
バージョン 6.0
Reports.book
15 ページ
２００１年４月２７日　金曜日　午前１１時２７分
マスター詳細レポート
例‐マスター詳細レポートの作成
Actuate Developer Workbench でのレポートデザインの作成
F
ここまでの手順で、新しいレポートデザインが作成され、主要なコンポーネント
が追加されました。
Actuate Developer Workbench でマスター詳細レポートデザインを作成する
には
1 [ ファイル ] → [ 新規作成 ] を選択します。[ 新規ファイル ] ダイアログボック
スで、[ ブランクレポートデザイン ] ラジオボタンを選択します。
2 [ 新規レポートデザイン ] ダイアログボックスで、次の情報を入力します。
„
タイトル Account - Opty/Contact Detail
„
ファイル名 C:¥Siebdev¥rptsrc¥enu¥Acopcon.rod
作成しているレポートデザインファイルが保存されるときのファイル名と
フォルダの場所です。ただし ..¥enu の ¥custom サブフォルダがあるときは、
そこに保存します。
„
レポートオブジェクト名 Acopcon
これは、デザインファイル内のトップレベルのレポートデザインオブジェ
クトの名前です。
3 [ ファイル ] → [ モジュールのインクルード ] を選択します。[ モジュールの
インクルード ] ダイアログボックスで C:¥Siebdev¥rptsrc¥enu¥lib ( または同等
の場所 ) に移動し、ssSiebel.rol を選択して [ 開く ] をクリックします。[ ライ
ブラリブラウザ ] ウィンドウを終了します。
4 次のライブラリファイルそれぞれについて、ステップ 3 を繰り返します。
ssCustom.rol、ssAcct.rol、Acopcon.rol。
5 [ ファイル ] → [ 上書き保存 ] を選択します。...¥enu ( または ...¥enu¥custom)
フォルダ内の Acopcon.rod を指定します。
作業中、デザインファイルは定期的に保存してください。
バージョン 6.0
Siebel レポートガイド
6- 1 5
Reports.book
16 ページ
２００１年４月２７日　金曜日　午前１１時２７分
マスター詳細レポート
例‐マスター詳細レポートの作成
6 構造ツリー内の Acopcon ( トップレベル ) アイコンをダブルクリックします
( または右クリックしてから [ プロパティ ] を選択します )。[ コンポーネン
トエディタ ] ウィンドウで、[ クラス ] タブをクリックします。[ スーパー
クラス ] の値を acReport から ssReport に変更します。
レポートのクラスを変更すると、2 つのコンポーネント、つまりレポートセ
クション (ssRpt) と pagelist セクション (ssPageList) が自動的にレポートに追加
されます。
7 [ 表示 ] → [ オプション ] で、[ 空スロットを表示 ] オプションがチェックさ
れているようにします。
8 トップレベルのレポートコンポーネントを展開します。構造ツリー内のレ
ポートセクション子コンポーネント (ssRpt) を右クリックします。ポップアッ
プメニューで [ ローカルサブクラス ] オプションを選択します。
9 レポートセクションコンポーネント (ssRpt1) を右クリックし、[ 名前の変更 ]
を選択します。名前を ssRptAccount に変更します。
10 Report Section コンポーネント (ssRptAccount) を展開します。ツールバーの [ ラ
イブラリブラウザ ] アイコンをクリックし、ssCustom.rol を選択します。ssGrp
ライブラリコンポーネントを Report Section の Content 子スロットにドラッグ
アンドドロップします。
11 Group Section コンポーネント (ssGrp) を右クリックし、[ ローカルサブクラス ]
を選択します。
12 Group Section コンポーネント (ssGrp1) を右クリックし、[ 名前の変更 ] を選択
します。名前を ssGrpAccount に変更します。
13 Group Section コンポーネント (ssGrpAccount) を右クリックし、[ プロパティ ]
を選択します。Key プロパティで「ssName」と入力します。[ コンポーネン
トエディタ ] ウィンドウを閉じます。
14 [ ライブラリ ] ウィンドウから ssSeq ライブラリコンポーネントをコンテント
セクション (ssGrpAccount) にドラッグアンドドロップします。指示されたら、
[Use As Content] を指定します。
これにより、サブレポートを順に実行させる順次セクションが定義されます。
15 順次セクションをローカルサブクラス化し、その名前を ssSeqAccount に変更
します。
6- 1 6
Siebel レポートガイド
バージョン 6.0
Reports.book
17 ページ
２００１年４月２７日　金曜日　午前１１時２７分
マスター詳細レポート
例‐マスター詳細レポートの作成
16 ssRpt ライブラリコンポーネントを順次セクションにドラッグアンドドロップ
します。これをローカルサブクラス化し、その名前を ssRptOpportunity に変
更します。このレポートコンポーネントを展開します。
17 ssRpt ライブラリコンポーネントを順次セクションにもう一度ドラッグアンド
ドロップします。このレポートコンポーネントをローカルサブクラス化し、
その名前を ssRptContact に変更します。このレポートコンポーネントを展開
します。
18 [ ライブラリ ] ウィンドウを閉じます。
レポートデザインへのデータストリームの追加
F
ここでは、レポートデザインのレポートセクションに、データ供給ライブラリか
ら 3 つのデータストリームを追加します。マスターレポート用の 1 つと、2 つの
各サブレポート用です。
1 [ ライブラリブラウザ ] ボタンをクリックし、[Acopcon.rol] を選択します。
2 ssAccountQuery ライブラリコンポーネントをマスターレポートセクション下
のデータストリームスロットにドラッグアンドドロップします。
3 ssOpportunityQuery_1 ライブラリコンポーネントを、商談詳細レポートセク
ション ssRptOpportunity の下のデータストリームスロットにドラッグアンド
ドロップします。
4 ssContactQuery_2 ライブラリコンポーネントを、担当者詳細レポートセク
ション ssRptContact の下のデータストリームスロットにドラッグアンドド
ロップします。
5 [ ライブラリ ] ウィンドウを閉じます。
バージョン 6.0
Siebel レポートガイド
6- 1 7
Reports.book
18 ページ
２００１年４月２７日　金曜日　午前１１時２７分
マスター詳細レポート
例‐マスター詳細レポートの作成
デザインへのフレーム、データコントロール、ラベル要素の追加
F
これらの要素の多くは、2 つのカスタムコンポーネントライブラリから取得され
ます。そのうちの 1 つは前に作成しました。
フレーム、データコントロール、ラベル要素を追加するには
1 [ ライブラリブラウザ ] アイコンをクリックします。[ インクルードモジュー
ル選択 ] ダイアログボックスで、[ssAcct.rol] を選択します。
2 ssFrmHeadSection ライブラリコンポーネントを、グループセクション
ssGrpAccount の Before 子スロットにドラッグアンドドロップします。
ssFrmHeadSection のコンポーネントサブツリーのマイナス記号をクリック
することで、サブツリーを非表示にします。
ヘッダーと詳細行のコンポーネントサブツリーを表示させているとツリーが
見づらいので、このように非表示にすることでツリーを簡潔に、かつ移動操
作しやすくしておきます。
3 ssFrmContactBefore ライブラリコンポーネントを、担当者サブレポートセク
ション ssRptContact のページヘッダー子スロットにドラッグアンドドロップ
します。ssFrmContactBefore のコンポーネントサブツリーを非表示にします。
4 [ ライブラリ ] ウィンドウを閉じます。メニューバーから [ ファイル ] → [ モ
ジュールのインクルード ] を選択します。...¥enu¥library フォルダで
[ssOppt.rol] を選択します。
このカスタムコンポーネントライブラリは、商談レポートで使われます。作
成している商談サブレポートに必要なページヘッダーと詳細行が含まれてい
ます。
5 ssOppHeader ライブラリコンポーネントを、商談サブレポートセクション
ssRptOpportunity のページヘッダー子スロットにドラッグアンドドロップし
ます。ssOppHeader のコンポーネントサブツリーを非表示にします。
6 ssOppRowNoAddress ライブラリコンポーネントを、商談サブレポートセク
ション ssRptOpportunity の Content 子スロットにドラッグアンドドロップし
ます。ssOppRowNoAddress のコンポーネントサブツリーを非表示にします。
[ ライブラリ ] ウィンドウを閉じます。
6- 1 8
Siebel レポートガイド
バージョン 6.0
Reports.book
19 ページ
２００１年４月２７日　金曜日　午前１１時２７分
マスター詳細レポート
例‐マスター詳細レポートの作成
7 ssRptOpportunity レポートセクションのページヘッダー子フレームを展開しま
す。このページヘッダーフレーム (ssOppHeader) をローカルサブクラス化し、
その名前を「ssFrmOpportunityPage」に変更します。
このページヘッダーにはいくつか修正が必要です。
8 ssFrmOpportunityPage の ssTxtOPPTHeadM 子データコントロールを選択して
削除します。
9 ssCustom.rol ライブラリを開き、[ ライブラリ ] ウィンドウから ssLblSectionHead
コンポーネントを ssFrmOpportunityPage ページヘッダーにドラッグアンドド
ロップします。
10 新しいセクションヘッダーラベル ssLblOpportunityHead に名前を変更します。
このヘッダーラベルを担当者のヘッダーラベルと比較できるように、サイズ
と位置を変更します。[ ライブラリ ] ウィンドウを閉じます。
11 ssFrmOpportunityPage 内の ssFrmOPSTATEHeader コンテンツフレームを選択し
ます。これをローカルサブクラス化し、その名前を「ssFrmOpportunityHeader」
に変更します。ssFrmOpportunityHeader を展開して、その子ラベルコンポーネ
ントを表示させます。
このヘッダーから取引先ラベルと、その下に表示される詳細データ行を削除
します。なぜなら、この取引先はマスターレポートにすでに表示されている
からです。
12 ssFrmOpportunityHeader の子ラベル ssLblAccount を強調表示させて削除します。
13 ssFrmOpportunityHeader の残りの子ラベルそれぞれをローカルサブクラス化
し、それらを左にドラッグし、ssLblAccount を削除することで空になってい
るスペースを埋めます。
このとき、Shift キーを押しながら商談ヘッダー内の各ラベルをクリックして
いくことで、処理上のグループを形成できます。このラベルグループは各ラ
ベル間の距離を保ったまま、まとめて左にドラッグできるので、作業が楽に
なります。
バージョン 6.0
Siebel レポートガイド
6- 1 9
Reports.book
20 ページ
２００１年４月２７日　金曜日　午前１１時２７分
マスター詳細レポート
例‐マスター詳細レポートの作成
14 ssFrmOpportunityPage コンポーネントツリーを非表示にします。ssRptOpportunity
の ssOpRowNoAddress コンテンツ子フレームを展開します。ssOpRowNoAddress
をローカルサブクラス化し、その名前を ssOpportunityContent に変更します。
次に、取引先データコントロールを削除し、空になったスペースに別のデー
タコントロールを入れます。
15 ssTxtOPSTATEAccount データコントロールを強調表示させます。これを削除
します。
16 ssFrmOpportunityRow の残りの子データコントロールそれぞれをローカルサブ
クラス化します。レイアウトペイン内で各子データコントロール ( 名前コン
トロールを除く ) を、Shift キーを押しながらクリックしていき、左側にまと
めてドラッグします。これにより、ssTxtOPSTATEAccount を削除することで
空になっていたスペースを埋めます。データコントロールが、その上のヘッ
ダーラベルに対して整列していることを確認します。
17 グループセクション (ssGrpAccount) の [PageBreakBefore] プロパティが
TRUE であり、[PageBreakAfter] プロパティが FALSE であることを確認し
ます。また、ssRptContact と ssRptOpportunity サブレポートセクションの
[PageBreakBefore] と [PageBreakAfter] プロパティの両方が FALSE に設定さ
れていることを確認します。
各サブレポートセクションをページの先頭から開始させたいときは、各サブ
レポートセクションで PageBreakBefore を TRUE に設定します。サブレポー
トの 4 つのページ区切りプロパティすべてを FALSE に設定すると、取引先の
間を除いてページ区切りは入りません。
18 レポートデザインのトップレベルのコンポーネントである Acopcon のプロパ
ティウィンドウを開きます。[ssReportTitle] プロパティを Account - Opportunities/
Contacts Detail に設定します。
6- 2 0
Siebel レポートガイド
バージョン 6.0
Reports.book
21 ページ
２００１年４月２７日　金曜日　午前１１時２７分
マスター詳細レポート
例‐マスター詳細レポートの作成
レポートのコンパイルとテスト
F
レポートの構築、コンパイル、実行は、Actuate Developer Workbench で行います。
レポートのデバッグは、Actuate Developer Workbench 内でローカルに行うことが
でき、配備する準備ができたら、Siebel アプリケーションがレポート作成プログ
ラムを取得するフォルダに、レポートの実行可能バージョンを移動させます。
レポートをコンパイルしてインストールするには
1 Siebel Sales を起動し、[ 取引先 ( 個人 )] ビューに移動します。目的のクエリー
がアクティブであることを確認します。
2 Actuate Developer Workbench で、ツールバーの [ 構築と実行 ] アイコンをク
リックするか、または [ レポート ] → [ 構築と実行 ] を選択します。
レポートが Actuate ビューアに表示されます。
3 必要であればレポートデザインを修正して再コンパイルするという手順を繰
り返します。
4 Microsoft Windows Explorer を使用して、Acopcon.rox ファイルを
C:¥Siebdev¥rptsrc¥enu ( または同等の場所 ) から C:¥Siebel¥reports¥enu ( または
同等の場所 ) に移動させます。
5 Siebel Sales で、[ レポート ] → [ 取引先 - 商談 / 担当者詳細 ] を選択します。
レポートが Siebel Sales に表示されるはずです。何らかの問題があるときは、
Siebel Tools でレポートの設定をチェックし、レポートオブジェクト定義を表
示させます。
バージョン 6.0
Siebel レポートガイド
6- 2 1
Reports.book
22 ページ
２００１年４月２７日　金曜日　午前１１時２７分
マスター詳細レポート
例‐マスター詳細レポートの作成
6- 2 2
Siebel レポートガイド
バージョン 6.0
Reports.book
1 ページ
２００１年４月２７日　金曜日　午前１１時２７分
複合データストリーム
7
この章について . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-2
データストリームの概念 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-2
レポートでの複合データストリームの使用 . . . . . . . . . . . . . . . . . . . . . . . . . . 7-4
レポートデザインへのグローバル変数の追加 . . . . . . . . . . . . . . . . . . . . . . . . . 7-6
マスターデータストリームコンポーネントの修正 . . . . . . . . . . . . . . . . . . . . . 7-7
コントロールでのグローバル変数の参照 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-8
複合データストリームのデバッグ時のヒント . . . . . . . . . . . . . . . . . . . . . . . . . 7-9
バージョン 6.0
Siebel レポートガイド
7-1
Reports.book
2 ページ
２００１年４月２７日　金曜日　午前１１時２７分
複合データストリーム
この章について
この章について
G
この章は、次の 2 つのセクションに分かれています。
„
7-2 ページの「データストリームの概念」では、高度なレポート機能すべての
基礎になっているデータストリームの概念について説明します。
„
7-4 ページの「レポートでの複合データストリームの使用」では、1 つのフ
レームに複数のビジネスコンポーネントからのデータを表示させるときに使
用する複合データストリームについて説明します。
データストリームの概念
G
データストリームコンポーネントとは、1 つのビジネスコンポーネントからの
データのことです。データストリームとレポートセクションは 1 対 1 の関係にあ
り、多くの場合にレポートデザインには複数のデータストリームがあります。複
雑なレポートで使われる手法の多くは、これらの関係にもとづいて機能します。
各データストリームはデータ行コンポーネントを使用して変数の値を格納し、
フォーマットしたデータをレポートインスタンスに戻します。Siebel/Actuate で
は、データ行コンポーネントは、レポートオブジェクト定義の中のフィールドリ
ストを表します。レポートオブジェクト定義の各フィールドは、データ行に定義
されている 1 つの変数にマッピングされます。レポートオブジェクト定義の中の
データ行ごとに、1 つのデータ行オブジェクトが作成されます。
データ行コンポーネントとは、実行時にデータ行オブジェクトを作成するために
インスタンス化されたクラスです。データストリームにはデータを抽出するコー
ドがあり、データ行にその値が保持されます。データ行はそのほとんどが変数属
性によって定義されるため、データ行コンポーネントにコードを書き込むのでは
なく、レポートオブジェクトと子オブジェクトの定義を修正するようにしてくだ
さい。
しかしデータ行オブジェクトは、レポートセクションに表示され、作成されてか
らコントロールにデータを割り当てるまでの間に遮断できます。データストリー
ムコンポーネントとデータ行コンポーネントのローカルサブクラスを作成して、
データストリーム内で Fetch メソッドをオーバーライドしたり ( レコード全体を
処理する )、データ行内の OnRead メソッドをオーバーライドしたりする (1 つの
フィールドを処理する ) ことができます。
7- 2
Siebel レポートガイド
バージョン 6.0
Reports.book
3 ページ
２００１年４月２７日　金曜日　午前１１時２７分
複合データストリーム
データストリームの概念
データストリームコンポーネントがそのローカルスペース ( レポートセクション )
で使用するデータ行コンポーネントは 1 つだけですが、グローバルデータ行が作
成されることによって、複数のデータ行にあるフィールドをレポートデザイン全
体で利用できるようになります。この方法の詳細は、7-4 ページの「レポートでの
複合データストリームの使用」を参照してください。
Actuate では、データストリームはレポートにデータを送るコンポーネントの集
合を指します。Siebel のデータアクセスは、OLE と OMU ( レポートサーバーイ
ンターフェース ) を通じて行われるので、クエリーはつねに Actuate 環境の外で
実行されます。
データストリームの役割は、OLE または OMU を通じてインターフェースを作
成し、フォーマットされたデータ行をレポートデザインに渡すことです。Siebel
Tools では、クエリーを実行するのに必要な変数が定義されます。この値はレ
ポートデザインの要件によって決定されます。表 7-1 は、データストリーム変数
とその種類、機能についてまとめたものです。
表 7-1
Siebel データストリームクラスの変数
変数
タイプ
機能
ssAppServer
Integer
データストリームの Start メソッドで作成されるオブジェク
トへのポインタです。アクティブな Siebel アプリケーショ
ンやモデルを識別します。
ssBO
Integer
Start メソッドで作成されるオブジェクトへのポインタです。
アクティブなビジネスコンポーネントを識別します。
ssBusCompName
Integer
Siebel アプリケーションにおけるアクティブなビューのマ
スタービジネスコンポーネントへのポインタです。
オーバーライドされるデータストリームメソッドについては、付録 B「メソッド
リファレンス」を参照してください。
バージョン 6.0
Siebel レポートガイド
7-3
Reports.book
4 ページ
２００１年４月２７日　金曜日　午前１１時２７分
複合データストリーム
レポートでの複合データストリームの使用
レポートでの複合データストリームの使用
G
レポートでは、1 つのフレームに複数のビジネスコンポーネントのデータを表示
させる必要が生じることがよくあります。各フレームはレポートセクションから
データを取得します。各レポートセクションには 1 つのデータストリームがあり
ます。データストリームはそれぞれ、レポートオブジェクト定義を通じて、1 つ
のビジネスコンポーネントに関連付けられます。通常では、データコントロール
が別のレポートセクションの内容を見ることはできません。
その解決策として、グローバルデータ行を作成します。グローバルデータ行はレ
ポート全体に表示されるもので、レポートセクションにとらわれることはありま
せん。そのためには、レポートデザインコンポーネントに変数を設定します。そ
れにより、コントロールで適正なデータを使用できます。
グローバルデータ行を作成して使用するには、以下の手順が必要です。
7- 4
„
レポートデザインにグローバル変数を追加する。
„
マスターデータストリームコンポーネントを修正する。
„
コントロールでグローバル変数を参照する。
Siebel レポートガイド
バージョン 6.0
Reports.book
5 ページ
２００１年４月２７日　金曜日　午前１１時２７分
複合データストリーム
レポートでの複合データストリームの使用
これらの各手順について、Quotestd.rod 標準レポートを通じて以下に説明します。
このレポートは、[ 見積り ] 画面における [ レポート ] メニュー内の現見積りレ
ポートです。図 7-1 は、このレポートの例です。
図 7-1
現見積りレポートのページの例
このレポートには、上段に見積りマスター情報が表示され、中央には、各見積り
ライン項目のリストを含むサブレポートが表示されています。
バージョン 6.0
Siebel レポートガイド
7-5
Reports.book
6 ページ
２００１年４月２７日　金曜日　午前１１時２７分
複合データストリーム
レポートでの複合データストリームの使用
レポートデザインへのグローバル変数の追加
G
マスターデータ行内のフィールド値をサブレポートで使用できるようにするには、
マスターデータ行の内容を保持するグローバル変数を定義する必要があります。
グローバル変数は、レポートデザインコンポーネント上でパブリック静的変数と
して定義され、その型はマスターデータ行と同じクラスとして定義されます。
レポートデザイン内にグローバルデータ行変数を作成するには
1 マスターデータストリームを展開して子データ行を表示させ、そのデータ行
の名前をメモしておきます。
現見積りレポート (QUOTESTD) の場合、この名前は ssQuoteDataRow であり、
クラスは名前と同じです ( サブクラス化されていないため )。
2 トップレベルのコンポーネントであるレポートデザインに移動して右クリック
します。ポップアップメニューで、[ プロパティ ] を選択します。
3 Report Design コンポーネントの [ コンポーネントエディタ ] ウィンドウで、[ 変
数 ] タブをクリックします。
4 [ 新規 ] ボタンをクリックします。[ クラス変数 ] ダイアログボックスが表示
されます。
7- 6
Siebel レポートガイド
バージョン 6.0
Reports.book
7 ページ
２００１年４月２７日　金曜日　午前１１時２７分
複合データストリーム
レポートでの複合データストリームの使用
5 次のように値を入力します。
„
[ 名前 ] フィールドに、「MasterRow」と入力します。
„
[ 種類 ] フィールドに、前にメモしたデータ行のクラス名を入力します。
„
[ 外部で定義されたデータ型 ] はチェックしないままにします。
„
[ 記憶場所 ] ラジオボタングループのうち、[ スタティック ] を選択します。
„
[ 可視性 ] ピックリストで、[ パブリック ] を選択します。
6 [OK] をクリックして新しい変数を保存します。
マスターデータストリームコンポーネントの修正
G
このステップでは、グローバルデータ行変数からデータ行コンポーネントのデー
タを取得できるように、マスターデータストリームコンポーネントを修正します。
これは、マスターデータストリームの Fetch メソッドをオーバーライドすることに
よって行います。
マスターデータストリームの Fetch メソッドをオーバーライドするには
1 マスターデータストリームコンポーネント ( サブレポートではなくマスター
レポートのデータストリーム ) に移動し、それをクリックして強調表示させ
ます。
Quotestd.rod レポートでは、このコンポーネントは ssQuoteQueryAddGlobalRow
です。
2 [ 表示 ] → [ メソッドエディタ ] を選択します。
[ メソッドエディタ ] ウィンドウが表示されます。
3 [ メソッドエディタ ] の左上にあるピックリストで、Fetch メソッドを選択し
ます。
4 [ 上書き ] ボタンをクリックします。
バージョン 6.0
Siebel レポートガイド
7-7
Reports.book
8 ページ
２００１年４月２７日　金曜日　午前１１時２７分
複合データストリーム
レポートでの複合データストリームの使用
5 [ メソッドエディタ ] 内で、既存のコードを次のコードに置き換えます
(ssQuoteDataRow 以外の場合には該当するマスターデータ行名を使用します )。
Function Fetch ( ) As AcDataRow
Dim aMasterRow As ssQuoteDataRow
Set aMasterRow = Super::Fetch ( )
If aMasterRow Is Nothing Then
Exit Function
End If
Set MasterRow = aMasterRow
Set Fetch = MasterRow
End Function
6 [ 閉じる ] ボタンをクリックします。
Fetch メソッド内のコードは、フェッチされたレコードが空でないことを確認し
たあとに、MasterRow グローバル変数を、Super::Fetch 操作によって返された行
の内容に置き換えます。マスターデータストリームレコードが取得されるたび
に、MasterRow 内のメモリ内のレコードが置換されます。
コントロールでのグローバル変数の参照
G
たとえば、各ライン項目行で取引先の名前を参照する必要があるとします。
ライン項目行に取引先名を追加するには
1 サブレポート内の内容フレームに移動します (QuoteItemContent1)。
2 2 つのフィールドの間に取引先名のためのスペースを空けます。
3 ssCustom.rol ライブラリを開きます ( まだ開いていない場合 )。ライブラリブ
ラウザウィンドウから、ssTxtS コンポーネントを内容フレーム内の目的の位
置までドラッグします。
すると新しいテキストコントロールの [ コンポーネントプロパティ ] ダイア
ログボックスが開きます。
7- 8
Siebel レポートガイド
バージョン 6.0
Reports.book
9 ページ
２００１年４月２７日　金曜日　午前１１時２７分
複合データストリーム
レポートでの複合データストリームの使用
4 [ コンポーネントプロパティ ] ダイアログボックス内の [ValueExp] プロパティ
に次の値を入力します。
QUOTERPT::MasterRow.ssAccount
この値は、現在の見積りを格納する MasterRow グローバル変数内の
ssAccount フィールドの現在の値が表示されるように、テキストコントロール
を設定します。
テキストコントロールでグローバル変数の値を使用するには、この例のように
コントロールの ValueExp プロパティを使用します。形式は次のとおりです。
GlobalVar.FieldName
たとえば次のようにします。
QUOTERPT::MasterRow.ssAccount
複合データストリームのデバッグ時のヒント
G
レポートデザインの MasterRow 変数は、パブリックな可視性のある静的なもので
なければなりません。
オーバーライドした Fetch メソッドでは、まず「Super.Fetch ()」を呼び出してか
ら、これを使ってグローバルデータ行を作成する必要があります。予期しない結
果が発生した場合は、Fetch メソッドにブレークポイントを割り当てて ( 区切り点
とする行を選択して [F9] を押します )、
レポート変数をすべて検査します ([ デバッ
グ ] → [ 変数 ])。aMasterRow という名前のデータ行変数が、目的どおりに利用で
きるようになることを確認してください。
MasterRow が制御対象となっていることを確認する方法として、ブレークポイン
トを使って MasterRow 変数 ( とそのフィールド ) の値をチェックできるように、
コントロールの BuildFromRow メソッドをオーバーライドすることもできます。
バージョン 6.0
Siebel レポートガイド
7-9
Reports.book
10 ページ
２００１年４月２７日　金曜日　午前１１時２７分
複合データストリーム
レポートでの複合データストリームの使用
7- 1 0
Siebel レポートガイド
バージョン 6.0
Reports.book
1 ページ
２００１年４月２７日　金曜日　午前１１時２７分
メモリ内のレコードのソート
8
この章について . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-2
マルチバリューフィールドでソートされるレポート . . . . . . . . . . . . . . . . . . . 8-3
多対多関係からのレコードをソートするレポート . . . . . . . . . . . . . . . . . . . . . 8-5
メモリソートレポートの働き . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-7
データフィルタ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-7
メモリ構造 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-8
レポートデザインの構造 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-9
マルチバリューフィールドでソートされたレポートの検証 . . . . . . . . . . . . 8-12
グローバルリスト変数 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-16
マスターデータストリームの Fetch メソッド . . . . . . . . . . . . . . . . . . . . . . . . . 8-17
詳細データストリームの Fetch メソッド . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-17
統合データストリームの Fetch メソッド . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-19
ソートデータフィルタの Compare メソッド . . . . . . . . . . . . . . . . . . . . . . . . . . 8-20
多対多関係にもとづくレポートの検証 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-22
バージョン 6.0
Siebel レポートガイド
8-1
Reports.book
2 ページ
２００１年４月２７日　金曜日　午前１１時２７分
メモリ内のレコードのソート
この章について
この章について
H
一般には、ソート条件やグループ区切りを使用することで、レポートに必要な
ソートやグループ化を行うことができます。詳細については、第 5 章「グループ
セクションのあるレポート」を参照してください。ただし、マスターデータがマ
ルチバリューフィールドの内容によってソートされているときや、マスターと詳
細とが多対多関係にあるときは、ソート条件でソートを定義できません。このよ
うな場合、データストリームのマスター - 詳細セットとしてデータを Actuate に
渡し、ソートデータフィルタのメカニズムを通じて Actuate 内でさらに処理する
必要があります。
この章では、単純なソートではなく、レコードのマージが必要となるレポートを
設計する方法について説明します。
8- 2
Siebel レポートガイド
バージョン 6.0
Reports.book
3 ページ
２００１年４月２７日　金曜日　午前１１時２７分
メモリ内のレコードのソート
この章について
マルチバリューフィールドでソートされるレポート
H
メモリソートは、マスターレコードをマルチバリューフィールドの内容によって
ソートする必要があるときに使用します。このような場合の例として、[ 商談 ]
画面のビューで [ レポート ] → [ 営業担当別 ] を選択することで得られる営業員
別商談レポートがあります。このレポートは、図 8-1 で説明しています。
図 8-1
営業担当別商談レポート
このレポートには商談レコードがリストされており、商談を担当している営業員
ごとにソートされています。商談を担当する営業員が 1 人だけであれば、レポー
トのこの要件はソート条件とグループ区切りだけで満たすことができます。しか
し、商談レコードは、1 人の営業員ではなく、営業チームに割り当てられます。
各営業員ごとの全商談を表示させるためには、特定の商談に関与する複数の営業
員の名前の下にその同じ商談がリストされている必要があります。
バージョン 6.0
Siebel レポートガイド
8-3
Reports.book
4 ページ
２００１年４月２７日　金曜日　午前１１時２７分
メモリ内のレコードのソート
この章について
商談とそれに割り当てられる営業員の関係は、一対多関係です。Siebel ビジネス
モデルでは、この関係は Opportunity ビジネスオブジェクトのコンテキストにお
ける Opportunity ビジネスコンポーネントと Position ビジネスコンポーネントの
間のマスター‐詳細関係 ( リンク ) として定義されます。Siebel Sales で、商談レ
コード用に [ 営業員 ] フィールドに表示されるマルチバリューグループは、役割
マルチバリューリンクを通じて定義されます。
この種類のレポートの場合、データストリームはマスターレコードと詳細レコー
ドの両方を提供する必要があります。Actuate に商談レコードだけしか送られな
いと、各商談にどの営業員が割り当てられているか判断できません。各商談につ
いて判断できるのはプライマリ営業員だけです。商談とそれにかかわる営業員の
詳細情報のセットを送るには、Siebel Tools の中で、Opportunity ビジネスコン
ポーネントのレポートオブジェクト定義と、Position ビジネスコンポーネントの
子サブレポートオブジェクト定義とによって、データストリームが定義されてい
る必要があります。営業員別商談レポートについてこれが行われているかどうか
を Siebel Tools で確認できます。
2 つのデータストリーム内のマスターレコードと詳細レコードにもとづいて、2
つのビジネスコンポーネントから、クロス製品を表すマージ済みレコードのセッ
トが作成されます。このマージ済みレコードセットには、商談とその商談の [ 営
業員 ] マルチバリューフィールド内の役割の組み合わせごとに、1 つのマージ済
み商談レコードが含まれます。営業員ごとに並べられ、営業員のソート区切り付
きで最終的に印刷されるのは、このようにメモリ内に作成されたマージ済みレ
コードです。
このレポートについては、8-12 ページの「マルチバリューフィールドでソート
されたレポートの検証」で詳しく説明します。
8- 4
Siebel レポートガイド
バージョン 6.0
Reports.book
5 ページ
２００１年４月２７日　金曜日　午前１１時２７分
メモリ内のレコードのソート
この章について
多対多関係からのレコードをソートするレポート
H
メモリソートは、マスタービジネスコンポーネントと詳細ビジネスコンポーネン
トが、商談と担当者、あるいは取引先と商談など、多対多関係にあるときにも使
用されます。このような場合の例として、[ 担当者 ] 画面のビューで [ レポート ]
→ [ 商談別 ] を選択することで得られる商談別担当者レポートがあげられます。
図 8-2 はこのレポートを示しています。
図 8-2
商談別担当者レポート
このレポートの構成は、営業員別商談レポートと非常によく似ています。つまり
各マスターに対して複数の詳細レコードがあり、マスターレコードが詳細レコー
ド内のフィールドによってソートされています。ここでは、商談ごとにソートさ
れた担当者のプリントアウトが必要であるとします。そのためには、1 つの商談
に対して複数の担当者がいるという多対多関係で考えることが必要です。
バージョン 6.0
Siebel レポートガイド
8-5
Reports.book
6 ページ
２００１年４月２７日　金曜日　午前１１時２７分
メモリ内のレコードのソート
この章について
Siebel Tools 内のオブジェクト定義のセットでは Opprotunity ビジネスコンポーネ
ントをマスターとして使用し、担当者サブレポートを含んでいます。レポートデ
ザイン内には、マージされた商談レコードがメモり構造の中に作成され、担当者
名が追加のフィールドに含まれます。次にレコードは、担当者の順にソートされ、
担当者グループ区切りを用いて印刷されます。
この設定は、商談ごとにソートされた担当者を印刷するレポートを作成するよう
に簡単に切り替えることもできます。その場合、エクスポートされるデータ供給
ライブラリでは、マスターレポートオブジェクト定義内のビジネスコンポーネン
トとして Contact が使用され、
サブレポートに Opportunity が使用されます。レポー
トデザインには、メモリ内の構造に、各担当者レコードの内容と商談名フィール
ドが保持されます。担当者レコードは、商談の順にソートされ、商談グループ区
切りが付加されます。
このレポートの詳細については、8-22 ページの「多対多関係にもとづくレポート
の検証」を参照してください。
8- 6
Siebel レポートガイド
バージョン 6.0
Reports.book
7 ページ
２００１年４月２７日　金曜日　午前１１時２７分
メモリ内のレコードのソート
メモリソートレポートの働き
メモリソートレポートの働き
H
この項では、メモリソートレポートを理解するうえで必要な背景知識を説明して
から、この方法を使う既存の 2 つの標準レポートについて説明します。
データフィルタ
H
データストリームは、データソースとデータフィルタという 2 種類のデータアダ
プタで構成されます。データソースは、入力ソース (Siebel レポートの場合は
COM インターフェース ) からデータを取得し、取得したレコードからデータ行
を作成します。データフィルタは、データ行に対してソート、フィルタ処理、そ
の他の計算を実行します。データストリームには、少なくとも 1 つのデータソー
スが必要ですが、データフィルタはなくてもかまいません。実際に標準レポート
の多くは、データフィルタを使用していません。
データフィルタは、1 つ以上のデータソースまたはそのほかのデータフィルタか
らデータ行を受け取ります。データフィルタは、受け取ったデータを処理し、そ
れを次のデータフィルタ ( 存在時 ) またはレポートに渡します。
Actuate には、2 つのクラスのデータフィルタが用意されています。1 つは、1 つ
のデータソースまたはデータフィルタからのデータを受け取るためのフィルタ、
もう 1 つは複数のデータソースとフィルタからのデータをマージするためのフィ
ルタです。ssCustom ライブラリでは、これら 2 つの目的のためのクラスは、そ
れぞれ ssSingleInputFilter と ssMemoryDataSorter です。
標準のソート方式とグルーピング方式で処理できないソート / マージの要件は、
ssMemoryDataSorter からサブクラス化されたデータフィルタによって処理されま
す。このクラスは、ssSiebel ライブラリ内の baseMemoryDataSorter クラスから継
承されたもので、最終的な派生元は Actuate Foundation Classes の
AcMemoryDataSorter です。ssMemoryDataSort にもとづくデータフィルタはソー
トフィルタとも呼ばれます。
バージョン 6.0
Siebel レポートガイド
8-7
Reports.book
8 ページ
２００１年４月２７日　金曜日　午前１１時２７分
メモリ内のレコードのソート
メモリソートレポートの働き
メモリ構造
H
子ビジネスコンポーネント別にデータをソートするには、まず、マスターとなる
ビジネスコンポーネントからデータを抽出して格納します。次に、詳細ビジネス
コンポーネント内の値を基準にして再度ソートします。マスタービジネスコン
ポーネントレコードと詳細ビジネスコンポーネントレコードは、それぞれマス
ターデータストリームと詳細データストリームを通じて取得されます。
標準レポートである営業員別商談レポート (OPSLREP) では、商談クエリーの各行
が処理されてからデータがフォーマットされます。データ行は一時的なオブジェ
クトなので、処理されるときにメモり内のテンポラリ構造に書き込まれます。
この目的に、グローバルリストコンポーネントやメモリデータバッファコンポー
ネントを使用できます。営業員別商談レポートでは、商談をクエリーした結果の
データ行が、グローバルリストコンポーネントに格納されます。グローバルリス
トコンポーネントの派生元である AcList クラスは、スマート配列構造です。メモ
リバッファ (AcMemoryBuffer クラスにもとづく ) はグローバルリストと似ています
が、ほとんどの Siebel レポートには必要のない、より複雑な動作を示します。
RowList 変数は AcList から派生しています。AcList は、順に並べられたオブジェ
クトの集合を保持するように設計された AFC クラスです。また AcList は、グ
ローバルに機能するように設定されていて、リストを容易に管理するためのメ
ソッドを保持しています。表 8-1 は、AcList 変数に使用できるメソッドのリスト
です。
表 8-1
8- 8
AcList 変数に使用できるメソッド (1/2)
メソッド
派生元クラス
説明
AddToHead
AcList
リストの先頭に項目を追加します。
AddToTail
AcOrderedCollection
コレクションの最後に項目を追加します。
Contains
AcList
リストに項目が含まれていれば、TRUE を返します。
Copy
AcList
リストの最後に別のリストからの内容をコピーし
ます。
GetAt
AcOrderedCollection
コレクション内の指定の位置の項目を返します。
GetCount
AcCollection
コレクションの中のオブジェクトの数を返します。
Siebel レポートガイド
バージョン 6.0
Reports.book
9 ページ
２００１年４月２７日　金曜日　午前１１時２７分
メモリ内のレコードのソート
メモリソートレポートの働き
表 8-1
AcList 変数に使用できるメソッド (2/2)
メソッド
派生元クラス
説明
GetHead
AcOrderedCollection
コレクションの中の最初の項目を返します。
GetIndex
AcList
リスト内の指定されたノードの位置を返します。
GetTail
AcOrderedCollection
コレクションの中の最後の項目を返します。
InsertAfter
AcList
リスト内の指定ノードの後ろにノードを挿入します。
InsertBefore
AcList
リスト内の指定ノードの前にノードを挿入します。
IsEmpty
AcCollection
コレクションが空かどうかを報告します。
NewIterator
AcCollection
コレクションのイテレータを作成します。
Remove
AcCollection
コレクションから指定された項目を削除します。
RemoveAll
AcCollection
コレクションからすべての内容を削除します。
RemoveHead
AcList
リストから最初のノードを削除します。
RemoveTail
AcOrderedCollection
コレクションの最後の項目を削除します。
これらのメソッドの詳細については、
『Actuate Foundation Class Reference』を参照
してください。
レポートデザインの構造
H
メモリソートレポートは、構造的には第 5 章「グループセクションのあるレポー
ト」に説明されているグループ区切りをもつレポートに似ています。しかしグ
ループ区切り以外のコンポーネントも使用します。たとえば次のとおりです。
バージョン 6.0
„
2 番目のレポートセクション
„
2 つのレポートセクションをグループ化するための順次セクション
„
前のレポートセクションにあるマスターデータストリームと詳細データスト
リームからのデータを再処理するための、新規レポートセクション内のデー
タフィルタ
Siebel レポートガイド
8-9
Reports.book
10 ページ
２００１年４月２７日　金曜日　午前１１時２７分
メモリ内のレコードのソート
メモリソートレポートの働き
図 8-3 は、このタイプのレポートの構造を示しています。
Report Design
Sequential Section
Report Section (outer)
DataStream (master)
Report Section (inner)
DataStream (detail)
Report Section (combined)
Data Sort Filter
DataStream (combined)
Group Section
Page Header
Content
図 8-3
8- 1 0
メモリソートレポートの構造
Siebel レポートガイド
バージョン 6.0
Reports.book
11 ページ
２００１年４月２７日　金曜日　午前１１時２７分
メモリ内のレコードのソート
メモリソートレポートの働き
この構造の中の主要なコンポーネントは次のとおりです。
バージョン 6.0
„
Sequential Section
このセクションは、レポート行を生成しないでマスターレコードと詳細レ
コードを取得するための外側レポートセクションと、レコードをソートして
から印刷済みレコードにする統合レポートセクションとをまとめてグループ
化します。Sequential Section では、この 2 つのプロセスが順に行われます。
つまり最初のプロセスで格納済みレコードセットが生成され、2 番目のプロ
セスで処理を行うことが必要です。
„
Outer Report Section
このセクションには、マスターレポートのデータストリームが保持されます。
„
Master Datastream
このデータストリームは、マスタービジネスコンポーネントからデータレ
コードを取得します。これはレポートのデータ供給ライブラリファイルから
取得されます。
„
Inner Report Section
このセクションには、サブレポートのデータストリームが保持されます。
„
Detail Datastream
このデータストリームは、各マスターレコードの詳細ビジネスコンポーネン
トからデータレコードを取得します。これもデータ供給ライブラリファイル
から取得されます。
„
Combined Report Section
前のレポートセクション内のデータストリームからマージ済みレコードを取
得して、レポートに適したソート順に処理するデータフィルタを保持します。
またこのレポートセクションは、レポート出力を定義する内容ノードも保持
します。
„
Data Sort Filter
このデータフィルタは、その前のレポートセクション内のデータストリーム
からのマージ済みレコードを処理して、レポート出力用の正しいソート順に
します。
„
Combined Datastream
このデータストリームは、データソートフィルタの子コンポーネントです。
グローバルリストからマージ済みレコードを取得します。マージ済みレコー
ドのレコード構造は、統合データストリームの子データ行コンポーネントに
定義されます。
Siebel レポートガイド
8- 1 1
Reports.book
12 ページ
２００１年４月２７日　金曜日　午前１１時２７分
メモリ内のレコードのソート
マルチバリューフィールドでソートされたレポートの検証
„
Group Section
このセクションは、同じタイプのレコードのグループ間のソート区切りを実
装します。
マルチバリューフィールドでソートされたレポート
の検証
H
営業員別商談レポートは、検討に適した、MVF ソートされたレポートです。こ
のレポートは、[ 商談 ] 画面のビュー ( 通常は [ 商談 ( 個人 )] ビュー ) から呼び出
します。Siebel Sales でレポート出力を検討し、Actuate Developer Workbench でレ
ポートデザインを検討してください。このとき両方を開いたままにして 2 つを比
較してください。
営業員別商談レポートを生成するには
1 Siebel Sales を起動します。
2 タブバーで [ 商談 ] を選択します。
[ 商談 ( 個人 )] ビューが表示されます。
3 メニューバーから [ レポート ] → [ 営業担当別 ] を選択します。
営業担当別商談レポートがレポートビューアに表示されます。このレポートは
8-3 ページの図 8-1 に示してあります。
営業担当別商談レポートのレポートデザインを開くには
1 Actuate Developer Workbench を起動します。
2 メニューバーから [ ファイル ] → [ 開く ] を選択します。
3 [ 開く ] ダイアログボックスで、C:¥Siebdev¥rptsrc¥enu¥standard フォルダ ( ま
たはコンピュータ上の同等の場所 ) に移動し、[Opslsrep.rod] を選択します。
8- 1 2
Siebel レポートガイド
バージョン 6.0
Reports.book
13 ページ
２００１年４月２７日　金曜日　午前１１時２７分
メモリ内のレコードのソート
マルチバリューフィールドでソートされたレポートの検証
図 8-4 は、Actuate Developer Workbench での Opslsrep.rod レポートデザインファイ
ルです。
図 8-4
営業担当別商談レポートのレポートデザイン
レポートデザインを検討し、デザイン要素とレポート出力内の対応する部分を比
較し、コンポーネントを右クリックしてそのプロパティリストを表示させます。
このレポートデザインには次の特徴があります。
„
バージョン 6.0
マスターレポート、サブレポート、統合レポートにそれぞれ対応する 3 種類の
データストリームがあります。このうちマスターレポート (GenerateDataStream)
とサブレポート (InnerReport) は、データの収集だけに使用され、Content フレー
ムがありません。
Siebel レポートガイド
8- 1 3
Reports.book
14 ページ
２００１年４月２７日　金曜日　午前１１時２７分
メモリ内のレコードのソート
マルチバリューフィールドでソートされたレポートの検証
8- 1 4
„
Siebel Tools を起動して、Opslsrep レポート ( 営業員別商談 ) とその子のレポー
トオブジェクト定義に移動すると、商談レコードが親であり、役割レコード
( 一部のフィールドだけ表示されている ) が子であることがわかります。こ
のことは、Actuate 内のレポートデザインにも反映されています。つまりマ
スターデータストリームが商談を取得し、詳細データストリームが各商談の
役割を取得するという構造です。
„
トップレベルのレポートデザインコンポーネントを右クリックし、[ プロパ
ティ ] を選択して [ 変数 ] タブをクリックすると、カスタム変数が定義されて
いることがわかります。これは名前の付いた RowList であり、AcList クラス
です。このリスト構造変数は、入力データストリームからデータ行が取得さ
れたときに格納しておき、あとからソート ( 統合 ) データストリームからア
クセスできるようにします。詳細については、8-16 ページの「グローバルリ
スト変数」を参照してください。
„
3 つのデータストリームそれぞれの Fetch メソッドは、レコード取得コードを
変更するためにローカルに上書きされています。これについては、データス
トリームの [ コンポーネントプロパティ ] ウィンドウを開いて [ メソッド ] タ
ブをクリックすると、Fetch メソッドの名前に暗いフォントが使われているこ
とで判別できます。コードを表示させるメソッド名をダブルクリックします。
„
マスターデータストリームの Fetch メソッド (QueryOuter) は、現在のマス
ターレコード内のデータを、OutSideDataRow というパブリックデータ行
変数に移動します。この変数は、マスターデータストリーム上に定義さ
れ、詳細データストリームである ssPositionQuery で現在のマスターレコー
ドを使用できるようにします。詳細については、8-17 ページの「マスター
データストリームの Fetch メソッド」を参照してください。
„
詳細データストリームの Fetch メソッド (ssPositionQuery) は、マスターデー
タ行と詳細データ行を結合して統合データ行を作成します。作成された統
合データ行は、そのあと RowList グローバルリストに追加されます。詳細
については、8-17 ページの「詳細データストリームの Fetch メソッド」を
参照してください。
„
統合データストリームの Fetch メソッド (GetFromList) は、
グローバルリスト
から各データ行を取得し、そのデータ行をソートフィルタに渡します。詳
細については、8-19 ページの「統合データストリームの Fetch メソッド」
を参照してください。
Siebel レポートガイド
バージョン 6.0
Reports.book
15 ページ
２００１年４月２７日　金曜日　午前１１時２７分
メモリ内のレコードのソート
マルチバリューフィールドでソートされたレポートの検証
„
統合レポートセクション GenerateFormat は、Siebel Tools によって生成された
データ供給ライブラリファイルからインポートされるデータではなく、ロー
カルに作成、定義されたデータストリーム (GetFromList) を使用します。この
データストリームの親コンポーネントは、レポートセクション自体ではなく
データフィルタコンポーネントです。このデータストリームは ssCustom.rol
内の ssDataSource ライブラリコンポーネントから作成され、データフィルタ
は同じライブラリ内の ssMemoryDataSorter から作成されます。
ソートデータフィルタの Compare メソッドは、フィルタに送られてきたデー
タ行を再ソートします。ソートデータフィルタコンポーネントについては、
8-20 ページの「ソートデータフィルタの Compare メソッド」を参照してくだ
さい。
バージョン 6.0
Siebel レポートガイド
8- 1 5
Reports.book
16 ページ
２００１年４月２７日　金曜日　午前１１時２７分
メモリ内のレコードのソート
マルチバリューフィールドでソートされたレポートの検証
グローバルリスト変数
H
グローバルリスト変数は、AFC ライブラリ内の AcList クラスにもとづいており、
入力データストリームから取得されるデータ行を、あとからソートデータスト
リームによってアクセスできるように保持しておきます。営業担当別商談レポー
トでは、この変数は RowList と呼ばれます。グローバルリスト変数は、レポート
デザインのトップレベルのコンポーネント、つまりレポートデザイン自体に追加
します。
レポートデザインにグローバルリスト変数を作成するには
1 トップレベルのコンポーネントであるレポートデザインに移動して右クリッ
クします。ポップアップメニューで、[ プロパティ ] を選択します。
2 Report Design コンポーネントの [ コンポーネントプロパティ ] ウィンドウで、
[ 変数 ] タブをクリックします。
3 [ 新規 ] ボタンをクリックします。[ クラス変数 ] ダイアログボックスが表示
されます。
4 次の値を入力します。
„
[ 名前 ] フィールドに、「RowList」と入力します。
„
[ クラス ] フィールドで、[AcList] を選択します。
„
[ 外部で定義されたデータ型 ] のチェックをはずした状態にします。
„
[ 保存場所 ] ラジオボタンのうち、[ スタティック ] を選択します。
„
[ 可視性 ] ピックリストで、[ パブリック ] を選択します。
5 [OK] をクリックして新しい変数を保存します。
営業担当別商談の例では、RowList 変数は、GenerateDataStream レポートセクション
で作成されたマージ済みデータ行を保持します。統合データ行がそれぞれ構築され
るたびに、RowList 変数に対する AddToTail メソッドの呼び出しによってリストに
追加されます。
8- 1 6
Siebel レポートガイド
バージョン 6.0
Reports.book
17 ページ
２００１年４月２７日　金曜日　午前１１時２７分
メモリ内のレコードのソート
マルチバリューフィールドでソートされたレポートの検証
マスターデータストリームの Fetch メソッド
H
マスターデータストリームの Fetch メソッド ( このレポートの例では QueryOuter)
は、現在のマスターレコード内のデータを、OutSideDataRow と呼ばれるパブ
リックデータ行変数に移動します。この変数は、マスターデータストリーム上に
定義され、詳細データストリームである ssPositionQuery で現在のマスターレ
コードを使用できるようにします。マスターデータストリームの Fetch メソッド
には、次のコードが含まれます。
Function Fetch ( ) As AcDataRow
Set Fetch = Super::Fetch ()
' If a row is returned, then assign it to OutSideDataRow Var
If NOT Fetch Is Nothing Then
Set OutSideDataRow = Fetch
End If
End Function
詳細データストリームの Fetch メソッド
H
詳細データストリームの Fetch メソッドは、マスターデータ行と詳細データ行を
結合して統合データ行を作成します。作成された統合データ行は、あとから
RowList グローバルリストに追加されます。統合データ行のフィールド構造は、
統合データストリームコンポーネントのデータ行子コンポーネントに定義されま
す ( 営業員別商談レポートの例では、統合データ行は CombinedDataRow であり、
これは GetFromList データストリームの子です )。
詳細データストリームの Fetch メソッドには、次のコードが含まれます。
Function Fetch ( ) As AcDataRow
Dim aInsideDataRow As ssPositionDataRow
Dim aOutsideDataRow As ssOpportunityDataRow
Dim aCombinedDataRow As CombinedDataRow
' Initialize the List Object if it has been initialized
' This should only happen for the first time through
If RowList Is Nothing Then
Set RowList = New AcSingleList
End If
バージョン 6.0
Siebel レポートガイド
8- 1 7
Reports.book
18 ページ
２００１年４月２７日　金曜日　午前１１時２７分
メモリ内のレコードのソート
マルチバリューフィールドでソートされたレポートの検証
' Get the current inside row
Set aInSideDataRow = Super::Fetch ( )
If aInSideDataRow is Nothing Then
Set Fetch = Nothing
Exit Function
End If
' Get a pointer to the Outside Data Row Variable, declared on the
DataSource
Set aOutsideDataRow = OPSLSREP::QueryOuter::OutSideDataRow
If aOutsideDataRow Is Nothing Then
Exit Function
End If
' Create a new CombinedDataRow
Set aCombinedDataRow = New CombinedDataRow
' Fill Combined Data row with entries from inner row
aCombinedDataRow.ssSales_Rep = aInSideDataRow.ssLogin_Name
aCombinedDataRow.ssPosName = aInSideDataRow.ssName
aCombinedDataRow.ssClose_Date =
aInSideDataRow.ssOpportunity_Close_Date
aCombinedDataRow.ssClose_Date_Formatted=
aInSideDataRow.ssOpportunity_Close_Date_Formatted
aCombinedDataRow.ssRevenue_Formatted =
aInSideDataRow.ssOpportunity_Revenue_Formatted
aCombinedDataRow.ssRevenue= aInSideDataRow.ssOpportunity_Revenue
' Get values that are required from the outside data row
aCombinedDataRow.ssName = aOutSideDataRow.ssName
aCombinedDataRow.ssAccount = aOutSideDataRow.ssAccount
aCombinedDataRow.ssCity = aOutSideDataRow.ssCity
aCombinedDataRow.ssDescription = aOutSideDataRow.ssDescription
aCombinedDataRow.ssPostal_Code = aOutSideDataRow.ssPostal_Code
aCombinedDataRow.ssRep__ = aInSideDataRow.ssOpportunity_Rep__
aCombinedDataRow.ssSales_Stage = aOutSideDataRow.ssSales_Stage
aCombinedDataRow.ssState = aOutSideDataRow.ssState
aCombinedDataRow.ssStreet_Address =
aOutSideDataRow.ssStreet_Address
' Handle inside row so that Fetch continues to function
Set Fetch = aInsideDataRow
' Add the newly created combined datarow to the Global list of rows
RowList.AddToTail (aCombinedDataRow)
End Function
8- 1 8
Siebel レポートガイド
バージョン 6.0
Reports.book
19 ページ
２００１年４月２７日　金曜日　午前１１時２７分
メモリ内のレコードのソート
マルチバリューフィールドでソートされたレポートの検証
統合データストリームの Fetch メソッド
H
統合データストリームで Fetch メソッドを実行すると、グローバルリストから
データが取得されます。グローバルリストの各行について、グローバルリスト
変数に対する GetAt メソッドが呼び出されてデータが取得され、親データソー
トフィルタコンポーネントに対する AddRow メソッドが呼び出されてフィルタ
にデータ行が渡されます。
統合データストリームの Fetch メソッドのコードは次のとおりです。
Function Fetch ( ) As AcDataRow
Dim curList As AcList
Dim curDataRow As CombinedDataRow
' Acquire a reference variable to the global RowList from first
report
Set curList = RowList
If curList is Nothing then
'MsgBox "failure to acquire Row List"
Exit Function
End If
' Set the data row to the Item in the list at the current position
Set curDataRow = curList.GetAt (Position)
If curDataRow Is Nothing Then
Exit Function
End If
Set Fetch = curDataRow
AddRow (Fetch)
End Function
バージョン 6.0
Siebel レポートガイド
8- 1 9
Reports.book
20 ページ
２００１年４月２７日　金曜日　午前１１時２７分
メモリ内のレコードのソート
マルチバリューフィールドでソートされたレポートの検証
ソートデータフィルタの Compare メソッド
H
ソートデータフィルタの Compare メソッドは、フィルタに送られてきたデータ
行を再ソートします。ソートフィルタは、元来、行のソート方法を指定するため
にフィルタの Compare メソッドをオーバーライドすることによって設定されて
います。Compare メソッドは、引数として 2 行をとり、次の値のいずれかを返し
ます。
„
最初の行が次の行のあとに来るときは正の数。
„
両方の行が同じであるときは 0。
„
最初の行が次の行の前に来るときは負の数。
Compare メソッドに定義するコードは、レコードを並べるときの基準を定義し
ます。
Compare メソッドは、同じ列から取得された 2 つのキー値を比較するため、
CompareKeys メソッド (AFC の AcDataSorter クラス内 ) を呼び出します。
CompareKeys メソッドは、次の値のいずれかを返します。
„
key1 が key2 より小さいときは –1
„
key1 と key2 が等しいときは 0
„
key1 が key2 より大きいときは 1
営業担当別商談レポートでは、商談はまず営業員によって並べられ、次に売り上
げによって並べられています。つまり、同じ営業員で構成される各グループごと
に、売り上げにもとづいて商談が並べられているということです。これにより、
営業員が変わるごとにグループセクション内にグループ区切りが挿入され、商談
の各グループ内で売り上げの高い順に商談をリストさせることができます。
8- 2 0
Siebel レポートガイド
バージョン 6.0
Reports.book
21 ページ
２００１年４月２７日　金曜日　午前１１時２７分
メモリ内のレコードのソート
マルチバリューフィールドでソートされたレポートの検証
ソートデータフィルタの Compare メソッドのコードは次のとおりです。
Function Compare ( row1 As AcDataRow, row2 As AcDataRow ) As Integer
Dim aRow as CombinedDataRow
Dim bRow as CombinedDataRow
Set aRow = row1
Set bRow = row2
' Order By Sales Reps
Compare = CompareKeys (aRow.ssSales_Rep, bRow.ssSales_Rep)
' Order by Revenue, descending
' May want to use the functional data here
If Compare = 0 Then
Compare = CompareKeys (Val(bRow.ssRevenue), Val
(aRow.ssRevenue))
End If
End Function
バージョン 6.0
Siebel レポートガイド
8- 2 1
Reports.book
22 ページ
２００１年４月２７日　金曜日　午前１１時２７分
メモリ内のレコードのソート
多対多関係にもとづくレポートの検証
多対多関係にもとづくレポートの検証
H
多対多レポートとして検討するのに適しているのは、商談別担当者レポートで
す。このレポートは、[ 担当者 ] 画面内のビューから呼び出します ( 通常は [ 担
当者 ( 個人 )] ビュー )。Siebel Sales でレポート出力を検討し、Actuate Developer
Workbench でレポートデザインを検討してください。このとき両方を開いたま
まにして 2 つを比較してください。
商談別担当者レポートを生成するには
1 Siebel Sales を起動します。
2 タブバーで [ 担当者 ] を選択します。
[ 担当者 ( 個人 )] ビューが表示されます。
3 メニューバーから [ レポート ] → [ 商談別 ] を選択します。
8-5 ページの図 8-2 のように、商談別担当者レポートがレポートビューアに表示
されます。
営業員別商談レポートのレポートデザインを開くには
1 Actuate Developer Workbench を起動します。
2 メニューバーから [ ファイル ] → [ 開く ] を選択します。
3 [ 開く ] ダイアログボックスで、C:¥Siebdev¥rptsrc¥enu¥standard フォルダ ( ま
たはコンピュータ上の同等の場所 ) に移動し、[Cntopp.rod] を選択します。
8- 2 2
Siebel レポートガイド
バージョン 6.0
Reports.book
23 ページ
２００１年４月２７日　金曜日　午前１１時２７分
メモリ内のレコードのソート
多対多関係にもとづくレポートの検証
図 8-5 は、Actuate Developer Workbench での Cntopp.rod レポートデザインファイル
です。
図 8-5
商談別担当者レポートのレポートデザイン
このレポートデザインには次の特徴があります ( 特に 8-12 ページの「マルチバ
リューフィールドでソートされたレポートの検証」に説明されている営業員別商
談レポートとの比較において )。
バージョン 6.0
„
レポートの構造と、データストリームおよびデータフィルタに定義される
コードが、2 つのレポート間で非常によく似ています。
„
グローバルリスト変数と、マスター行グローバル変数の両方が、レポートデ
ザインコンポーネント Cntopp.rod に定義されています。
前の例の Oppslsrep.rod では、グローバルデータ行変数はデータストリームの
Fetch コードに定義されていましたが、これらの結果は同じです。レポートデ
ザインコンポーネントにデータ行変数を定義することは、デザインが明瞭に
なるという点で望ましいことです。
Siebel レポートガイド
8- 2 3
Reports.book
24 ページ
２００１年４月２７日　金曜日　午前１１時２７分
メモリ内のレコードのソート
多対多関係にもとづくレポートの検証
„
Cntopp.rod における Compare メソッドは、マージされたレコードを、最初に商
談名で、次に担当者の名前でソートします。これは、最終的なレポートの
ソートとグルーピングの要件に合致しています。
„
Siebel Tools を起動して、Cntopp.rod レポート ( 商談別担当者 ) とその子のレポー
トオブジェクト定義に移動すると、担当者レコードが親であり、商談レコー
ド ([Name] フィールドだけが表示されている ) が子であることがわかります。
このことは、Actuate 内のレポートデザインにも反映されています。つまりマ
スターデータストリームが担当者を取得し、詳細データストリームが各担当
者の商談を取得するという構造です。
この構造は、Opslsrep.rod オブジェクト定義とレポートデザインの構造に似て
います。つまり、ソートして印刷するビジネスコンポーネントがマスターで
あるということです。ソートキーを提供するのは、詳細ビジネスコンポーネ
ントです。このことは、多対多レポートの場合に少し変に思われるかもしれ
ませんが ( 詳細ビジネスコンポーネントがグループヘッダーを提供し、マス
タービジネスコンポーネントが詳細レポート行を提供する )、Contact ビジネ
スオブジェクトのデータモデルに合致しています。レポートは [ 担当者 ] 画
面内のビュー (Contact ビジネスオブジェクトがアクティブになっている ) か
ら呼び出されるので、Opportunity がマスターであるマスター - 詳細関係を通
じてレコードを取得することはできません。2 つのビジネスコンポーネント
のレコードはソート前にマージされているので、このようにレコードを取得
することは何のメリットもありません。
8- 2 4
Siebel レポートガイド
バージョン 6.0
Reports.book
1 ページ
２００１年４月２７日　金曜日　午前１１時２７分
レポートでのグラフの使用
9
この章について . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-2
概要 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-2
Actuate により提供されるチャートタイプ . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-4
グラフコントロールプロパティ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-6
サンプルレポート‐商談パイプライン . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-16
レポート構造 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-18
プロパティ設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-19
例‐グラフを使用したレポートの作成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-21
バージョン 6.0
Siebel レポートガイド
9-1
Reports.book
2 ページ
２００１年４月２７日　金曜日　午前１１時２７分
レポートでのグラフの使用
この章について
この章について
I
この章では、棒グラフやパイグラフなどのグラフをレポートに組み込む技術につ
いて説明します。まず全体的な方法論について説明し、Siebel のチャートタイプ
と Actuate のグラフタイプの対応について説明した後、グラフのプロパティ設定
について説明します。
グラフを組み込んだ既存の標準レポート、商談パイプラインレポートについて分
析します。グループ区分を含む標準レポートのカスタマイズバージョンを作成す
る例も示します。カスタマイズレポートには、詳細レコードの各グループの最後
に、サマリ棒グラフも含まれます。
概要
I
グラフは、コンテンツフレームに配置されたコントロールです。Actuate
Developer Workbench のコンテンツフレームに配置されたグラフコントロールが、
図 9-1 に示されています。
図 9-1
9- 2
フレーム内のグラフコントロールを表示するデザインエディタ
Siebel レポートガイド
バージョン 6.0
Reports.book
3 ページ
２００１年４月２７日　金曜日　午前１１時２７分
レポートでのグラフの使用
概要
グラフは、詳細レポートの行と同じ方法で、データストリームにより現在のレ
ポートセクションに提供されたデータを使用します。グラフコントロールは、他
のコントロールと同じフレームに配置できます。
グラフのみを示し、テキストデータを示さないレポートでは、レポートセクショ
ンのメインのコンテンツフレーム全体にグラフコントロールが配置されます。こ
のデザインの例が、9-16 ページの「サンプルレポート‐商談パイプライン」に
示されています。もう 1 つのオプションでは、グループ区分を持つレポートの
After フレームにグラフコントロールを配置します。この場合、グラフはテキス
トローの各グループの後に表示されます。このデザインの例が、9-21 ページの
「例‐グラフを使用したレポートの作成」に示されています。
レポートで使用されるグラフは、バーまたは曲線のポイントと、基になるデータ
の関係によって、次の 2 種類に分類されます。
„
詳細グラフ
各データのポイントは、曲線ポイントまたはバーとして個々に表示されます。
X 軸および Y 軸は数字で表示する必要があります。詳細グラフの用途は限ら
れていて、通常、散布図にのみ使用します。詳細グラフは、Actuate Foundation
Class (AFC) ライブラリ内の acDetailGraph クラスに基づいています。
備考 : ssCustom ライブラリではなく、AFC ライブラリのコンポーネントを使
用するのは例外的な場合で、詳細グラフにのみ適用されます。AFC コンポー
ネントは、この特殊な場合を除いて、Siebel レポートで直接使用しません。
„
バージョン 6.0
概要グラフ
特定の分類におけるすべてのデータポイントが結合され、集計値が各曲線ポ
イントまたはバーに表示されます。概要グラフではデータシリーズの表示が
可能で、各凡例ラベルに対して 1 組の棒グラフまたは線グラフのポイントが
提供されます。X 軸上のテキストラベルと日付値もサポートされます。概要
グラフは、ssCustom ライブラリの ssSummaryGraph クラスに基づいています。
Siebel レポートガイド
9-3
Reports.book
4 ページ
２００１年４月２７日　金曜日　午前１１時２７分
レポートでのグラフの使用
Actuate により提供されるチャートタイプ
いずれの場合も、コンポーネントを空のフレームにドラッグして、データの使用
を設定するためにプロパティを設定します。詳細グラフコントロールは、[ グラ
フ ] ツールバーアイコンにより追加できます。概要グラフは、ssCustom ライブラ
リの [ ライブラリ ] ウィンドウを使用して追加する必要があります。
備考 : 3 つ目のグラフタイプ、HLC (high-low-close) も使用できますが、この章で
は扱いません。HLC グラフは [ グラフ ] ツールバーアイコンを使用して、プロン
プトで AcHLCGraph クラスを選択して追加します。
Actuate により提供されるチャートタイプ
I
Actuate には、Siebel eBusiness Applications と同じ多数のチャート ( またはグラフ )
タイプが用意されています。そのため、Siebel のビューとそれらのビューのレポー
ト間でこれらのグラフの種類を複製できます。次のリストに示されたすべての
チャートタイプは、詳細グラフと概要グラフのどちらでも使用できますが、その
多くは概要グラフでのみ適切に使用できます。Siebel と Actuate でサポートされる
チャートタイプと、それらの対応については、表 9-1 に示されています。
表 9-1
Siebel チャートタイプと対応する Actuate グラフタイプ (1/2)
Siebel チャートタイプ
Actuate グラフタイプ
縦棒
Graph2dBar ( 垂直 )
横棒
Graph2dBar ( 水平 )
折れ線
GraphLine
パイ
Graph2dPie
点
GraphScatter
曲線
9- 4
分割縦棒
Graph2dBar ( 垂直、分割 )
３ D 縦棒
Graph3dBar ( 垂直 )
3D クラスタ縦棒
Graph3dBar ( 垂直、クラスタ )
Siebel レポートガイド
バージョン 6.0
Reports.book
5 ページ
２００１年４月２７日　金曜日　午前１１時２７分
レポートでのグラフの使用
Actuate により提供されるチャートタイプ
表 9-1
Siebel チャートタイプと対応する Actuate グラフタイプ (2/2)
Siebel チャートタイプ
Actuate グラフタイプ
3D 横棒
Graph3dBar ( 水平 )
3D 折れ線
3D パイ
Graph3dPie
3D 曲線
GraphTape
3D 分割縦棒
Graph3dBar ( 垂直、分割 )
コンボ
Graph2dArea
Graph3dArea
GraphHLC (High-Low-Close)
GraphOHLC (Open-High-Low-Close)
GraphCandleStick
バージョン 6.0
Siebel レポートガイド
9-5
Reports.book
6 ページ
２００１年４月２７日　金曜日　午前１１時２７分
レポートでのグラフの使用
グラフコントロールプロパティ
グラフコントロールプロパティ
I
グラフコントロールのプロパティ設定は、Component Editor で行います。
Component Editor にアクセスするには、グラフを右クリックしてポップアップメ
ニューの [ プロパティ ] を選択して、[ プロパティ ] タブをクリックします。概
要グラフと詳細グラフで使用できるプロパティは同じですが、Expressions カテ
ゴリーのプロパティだけは異なります。
プロパティカテゴリー ( プロパティを参照するときに展開するフォルダ ) 別に配
列されたグラフコントロールのプロパティは、表 9-2 に説明されています。
表 9-2
プロパティカテゴリー別のグラフプロパティ (1/11)
カテゴリー
プロパティ
説明
TargetWindow Name
ハイパーリンクの内容が表示されたターゲットウィンド
ウの名前。
Advanced
LinkExp
このグラフオブジェクトのハイパーリンクを定義する式。
Advanced
ObjectVariable
このグラフオブジェクトを指定する、フレーム内のオプ
ションメソッドの名前。
Data
DataSetCount
データシリーズの数。この値は、グラフが表示された
ときに計算されます。グラフをデザインする場合、こ
のプロパティには表示するサンプルポイントの数が示
されます。
Data
PointCount
それぞれのデータシリーズのポイント数。この値は、グ
ラフが表示されたときに計算されます。グラフをデザイ
ンする場合、このプロパティには表示するサンプルポイ
ントの数が示されます。
Data
PointLabelColor
各ポイントに対して表示されるラベルの色。
Data
PointLabelStyle
各ポイントに対して表示されるラベルのスタイル。オプ
ションには、GraphNoPointLabels、GraphCustomLabels、
GraphNumericLabels、GraphColoredNumericLabels、
GraphColoredCustomLabels があります。
Data
SampleMax
最大サンプル値。
Data
SampleMin
最小サンプル値。
9- 6
Siebel レポートガイド
バージョン 6.0
Reports.book
7 ページ
２００１年４月２７日　金曜日　午前１１時２７分
レポートでのグラフの使用
グラフコントロールプロパティ
表 9-2
プロパティカテゴリー別のグラフプロパティ (2/11)
カテゴリー
プロパティ
説明
Data
ValuesColorList
カンマ区切りを持つ色の名前のリスト、または異なる
データシリーズを識別する RGB 値。
Expressions
(AcDetailGraph の
場合のみ )
LabelValueExp
角かっこで囲まれたデータ行変数が含まれます。この変
数によって、各ポイントに対する X 軸のテキストラベ
ルが取得されます。この値は、それぞれのラベルに対し
て集計されません。
Expressions
(AcDetailGraph の
場合のみ )
XValueExp
角かっこで囲まれたデータ行変数が含まれます。この変
数によって各データポイントの X 値が供給されます。
たとえば、Y 軸に売上額、X 軸に営業フェーズを示す散
布グラフでは、このプロパティ設定は [ssSales_Stage] に
なります。
Expressions
(AcDetailGraph の
場合のみ )
YValueExp
角かっこで囲まれたデータ行変数が含まれます。この変
数によって各データポイントの Y 値が供給されます。
たとえば、Y 軸に売上額、X 軸に営業フェーズを示す散
布グラフでは、このプロパティ設定は [ssRevenue] にな
ります。
Expressions
(AcDetailGraph の
場合のみ )
ZValueExp
角かっこで囲まれたデータ行変数が含まれます。この変
数によって各データポイントの Z 値 ( シリーズ ) が供給
されます。
Expressions
(ssSummaryGraph
の場合のみ )
CategoryKey
カテゴリー、つまりデータをグループ化する X 軸の値
を指定するデータ行変数または式が含まれます。これは
通常、整数値となります。たとえば、商談を月別にグ
ループ化する概要グラフでは、カテゴリーキーは次のよ
うになります。
Year ([ssClose_Date]) * 12 + Month([ssClose_Date]) –1
Expressions
(ssSummaryGraph
の場合のみ )
CategoryLabel
各カテゴリーにテキストラベルを提供するデータ行変数
または式が含まれます。たとえば、商談を月別にグルー
プ化する概要グラフでは、カテゴリーラベル式は次のよ
うになります。
[ssClose_Date_ Formatted]
Expressions
(ssSummaryGraph
の場合のみ )
バージョン 6.0
SeriesKey
データポイントのシリーズ (Z 軸 )、つまり、ポイントが
表示されるバーの色、または線グラフの曲線を決定する
値を指定するデータ行変数または式が含まれます。これ
は通常、整数値になります。
Siebel レポートガイド
9-7
Reports.book
8 ページ
２００１年４月２７日　金曜日　午前１１時２７分
レポートでのグラフの使用
グラフコントロールプロパティ
表 9-2
プロパティカテゴリー別のグラフプロパティ (3/11)
カテゴリー
プロパティ
説明
Expressions
(ssSummaryGraph
の場合のみ )
SeriesLabel
各シリーズの凡例に表示されるテキストラベルを提供す
るデータ行変数または式が含まれます。
Expressions
(ssSummaryGraph
の場合のみ )
ValueExp
各データポイントの Y 値を供給するデータ行変数また
は式が含まれます。たとえば、商談売上を月別にグルー
プ化する概要グラフでは、値式は次のようになります。
Sum (Val([ssRevenue]))
General
AxisColor
軸線の色。
General
BackgroundColor
グラフの背景の色。BackgroundIsClear が TRUE に設定さ
れている場合は、無視されます。
General
BackgroundIsClear
グラフの背景が明確な場合は、TRUE です。
General
GraphBackground.Color
グラフ周囲の長方形部分の色。
General
GraphBackgroundIsClear
グラフ周囲の長方形部分 ( タイトルや凡例を含まない )
が明確な場合は、TRUE です。
General
GraphBorderStyle
グラフ周囲の境界線のスタイル。オプションには、
GraphNoBorder、GraphSolidBorder、GraphDropShadow、
GraphShadowAndBorder、GraphRaisedBorder、
GraphLoweredBorder があります。
General
GraphType
グラフタイプを指定します。オプションには、
Graph2DPie、Graph3DPie、Graph2DBar、Graph3DBar、
GraphLine、Graph2DArea、Graph2DScatter、GraphHLC、
GraphTape、GRaphOHLC、Graph2DArea、Graph3DArea
があります。
General
GridColor
グラフに重ね合わされるグリッド線の色。
Graph-Specific
BarGrouping
棒グラフがクラスタまたはスタックか、あるいはクラス
タやスタックがないかを指定します。棒グラフ以外の場
合は、無視されます。オプションには、
GraphBarNoGrouping、GraphBarCluster、
GraphBarClusterZ (3D のみ )、GraphBarStack、
GraphBarStackPercentage があります。
9- 8
Siebel レポートガイド
バージョン 6.0
Reports.book
9 ページ
２００１年４月２７日　金曜日　午前１１時２７分
レポートでのグラフの使用
グラフコントロールプロパティ
表 9-2
プロパティカテゴリー別のグラフプロパティ (4/11)
カテゴリー
プロパティ
説明
Graph-Specific
BarOrientation
棒グラフが水平バーか垂直バーかを指定します。棒グラ
フ以外の場合は、無視されます。オプションには、
GraphBarVertical、GraphBarHorizontal、
GraphBarHorizontalReversed があります。
Graph-Specific
HLCBarStyle
HLC グラフと OHLC グラフのみです。グラフに高、低、
および目盛りマークを表示する方法を設定します。オプ
ションには、GraphHLCAllBars、GraphHLCThickBars、
GraphHLCNoClose、GraphHLCNoBars があります。
Graph-Specific
LineStyle
線グラフに、デフォルトの太さの実線、特定パターンの
破線、または太線を使用するかを指定します。線グラフ
にのみ適用されます。オプションには、
GraphDefaultLines、GraphPatternLines、GraphThickLines
があります。
Graph-Specific
LineStylesList
線グラフのみ。カンマ区切りを持つ線スタイルのリス
ト。各スタイルはそれぞれのデータセットに適用されま
す。オプションには、SingleLine、DashLine、DotLine、
DashDotLine、DashDotDotLine、NullLine があります。
Graph-Specific
LineThickness
線グラフ、点グラフのみ。グラフ別ユニットの線の太さ
を指定します。
Graph-Specific
PointsArePercent
エリアグラフのみ。TRUE の場合、データポイントの数
字はパーセント値であることを示します。FALSE の場
合、ポイントは絶対値です。
Graph-Specific
ShowAsPercent
エリアグラフ、円グラフのみ。データセットにおけるす
べてのポイントの合計として、各データポイントのパー
セント値を示すグラフを描きます。エリアは常に、グラ
フの全高さを占めます。
Graph-Specific
ShowLines
Line、log/lin、lin/log、log/log のグラフのみ。TRUE の場
合、線はポイントと連動します。
Graph-Specific
ShowSticks
Line、log/lin、lin/log、log/log、および散布グラフのみ。
TRUE の場合、Y 軸から各ポイントに線が描かれます。
Graph-Specific
ShowSymbols
Line、log/lin、lin/log、log/log、および散布グラフのみ。
TRUE の場合、各ポイントの記号を示します。
バージョン 6.0
Siebel レポートガイド
9-9
Reports.book
10 ページ
２００１年４月２７日　金曜日　午前１１時２７分
レポートでのグラフの使用
グラフコントロールプロパティ
表 9-2
プロパティカテゴリー別のグラフプロパティ (5/11)
カテゴリー
プロパティ
説明
HTML
Alignment
レポートのテキストフロー内でのグラフウィンドウの整
列を指定します。
HTML
AlternateText
Java アプレットがサポートされないブラウザで、グラフ
の個所に表示されるテキストを指定します。
HTML
BorderWidth
グラフ周囲の境界線の太さのピクセル数。
HTML
Margin
アプレットウィンドウと周囲のテキストの間の水平およ
び垂直スペースのピクセル数。
HTML
UseDefaultSize
ブラウザによって計算されたデフォルトの画像サイズを
使用するかどうかを決定します。TRUE に設定した場
合、高さと幅の HTML 属性は生成されません。FALSE
に設定した場合、Size プロパティによってこれらの属性
が生成されます。
Legend
LegendBackgroundColor
凡例の背景の色。
Legend
LegendBackground IsClear
凡例が無色の場合は、TRUE です。
Legend
LegendBorderStyle
凡例周囲に描かれるボックスのスタイル。オプションに
は、GraphNoBorder、GraphSolidBorder、
GraphDropShadow、GraphShadowAndBorder、
GraphRaisedBorder、GraphLoweredBorder があります。
Legend
LegendColorText
凡例のエントリが、識別される線、ポイント、または
バーと同色の場合は、TRUE です。
Legend.LegendFont.Color により指定される色の場合は、
FALSE です。
Legend
LegendFont
Bold、Color、FaceName、Italic などを含む、凡例ラベル
のフォントを定義するプロパティグループです。
Legend
LegendPosition
凡例の位置。オプションには、GraphLegendNone、
GraphLegendTop、GraphLegendTopRight、
GraphLegendTopLeft、GraphLegendLeft、GraphLegendRight、
GraphLegendBottomLeft、GraphLegendBottom、
GraphLegendBottomRight があります。
Legend
LegendSize
0 ( 最小 ) ～ 100 ( 最大 ) の凡例の相対サイズ。この値は、
凡例エントリの間隔をコントロールします。
9- 1 0
Siebel レポートガイド
バージョン 6.0
Reports.book
11 ページ
２００１年４月２７日　金曜日　午前１１時２７分
レポートでのグラフの使用
グラフコントロールプロパティ
表 9-2
プロパティカテゴリー別のグラフプロパティ (6/11)
カテゴリー
プロパティ
説明
Titles
AxisTitleFont
X 軸と Y 軸のタイトルフォントを定義するプロパティ
セットです。
Titles
LabelFont
X 軸と Y 軸の値ラベルのフォントと、各ポイントに隣
接するデータラベルのフォントを定義するプロパティ
セットです。
Titles
TitleBackground Color
タイトルを囲む長方形の背景の色です。
Titles
TitleBackgroundIs Clear
TRUE の場合、タイトルの下のエリアは無色です。
Titles
TitleBorderStyle
タイトル周囲の境界線のスタイル。オプションには、
GraphNoBorder、GraphSolidBorder、GraphDropShadow、
GraphShadowAndBorder、GraphRaisedBorder、
GraphLoweredBorder があります。
Titles
TitleFont
グラフタイトルのフォントを定義するプロパティセット
です。
Titles
TitleText
グラフの上に表示されるタイトル。
TOC
TocAddComponent
コンポーネント名がレポートの目次に追加されるかどう
かを決定します。値は次のようになります。
TOC
バージョン 6.0
TocAddContents
„
TOCAlwaysAdd 常に、目次にコンポーネントを追加
します。
„
TOCIfAllVisible ユーザーが、ページセキュリティに
基づいてコンポーネントから生成されたページを参
照できる場合に限り、コンポーネント名が目次に追
加されます。これはデフォルトです。
„
TOCIfAnyVisible ユーザーが、ページセキュリティ
に基づいてコンポーネントから生成されたどのペー
ジも参照できない場合でも、コンポーネントが目次
に追加されます。
„
TOCSkip コンポーネントはいっさい、目次に追加さ
れません。これは、パラレルセクション、順次セク
ション、または詳細フレームなどのコンポーネントを
ユーザーに対して非表示にするときに使用されます。
コンポーネントの内容がレポートの目次に追加されるか
どうかを決定します。
Siebel レポートガイド
9- 1 1
Reports.book
12 ページ
２００１年４月２７日　金曜日　午前１１時２７分
レポートでのグラフの使用
グラフコントロールプロパティ
表 9-2
プロパティカテゴリー別のグラフプロパティ (7/11)
カテゴリー
プロパティ
説明
TOC
TocValueExp
このオブジェクトの目次エントリとして表示されるスト
リングを戻します。
Viewing
CursorShape
マウスカーソルがグラフオブジェクトを通り過ぎたとき
に表示されるカーソルの種類
Viewing
HelpText
ユーザーがヘルプを参照するときに表示される、グラフ
オブジェクトに関するテキスト。
Viewing
Searchable
グラフオブジェクトがビューア内で検索可能かどうかを
指定します。
Viewing
SearchAlias
このグラフオブジェクトの検索をビルドするときに、
ユーザーを表示する名前。
Viewing
Selectable
ユーザーがビューア内でこのグラフオブジェクトを選択
できる場合は、TRUE です。
Visual
Position
フレーム内のグラフオブジェクトの位置。
Visual
Size
グラフオブジェクトのサイズ。
X-Axis
XAxisPosition
X 軸の位置。オプションには、GraphXAxisAuto、
GraphXAxisTop、GraphXAxisBottom があります。
X-Axis
XAxisStyle
グラフの原点の位置。オプションには、
GraphZeroOrigin、GraphAutoOrigin、GraphCustomOrigin
があります。
X-Axis
XLabelFormat
カスタムの X 軸ラベルを作成するときに使用する
フォーマットストリング。
X-Axis
XLabelsList
カンマ区切りを持つ、見積り X 軸値のリスト。
9- 1 2
Siebel レポートガイド
バージョン 6.0
Reports.book
13 ページ
２００１年４月２７日　金曜日　午前１１時２７分
レポートでのグラフの使用
グラフコントロールプロパティ
表 9-2
プロパティカテゴリー別のグラフプロパティ (8/11)
カテゴリー
プロパティ
説明
X-Axis
XLabelStyle
X 軸に沿って表示されるラベルの種類。オプションに
は、次のものがあります。
„
GraphNoLabels ラベルを表示しません。
„
GraphAutoLabels 自動的に計算されたラベルを表示
します。
„
GraphCustomLabels XLabelsList プロパティに入力し
た情報に基づいたカスタムラベルを表示します。
„
GraphExpressionLabels LabelExp プロパティで指定し
た式により計算されたラベルを表示します。
X-Axis
XMajorGridStyle
主要なグリッド線に使用される線のスタイル。オプショ
ンには、SingleLine、DashLine、DotLine、DashDotLine、
DashDotDotLine、NullLine があります。
X-Axis
XMajorTickCount
表示する目盛りの数。X 値を持つグラフの場合は、表示
される目盛りの数です。X 値を持たないグラフの場合
は、目盛りの頻度です (1 目盛りのポイント数 )。
X-Axis
XMajorTickStyle
目盛りマークの種類。オプションには、GraphNoTicks、
GraphAutoTicks、GraphCustomTicks があります。
X-Axis
XMax
X 軸の上限を設定します。この値は、グラフが表示され
たときに計算されます。グラフのデザイン時には、サン
プルデータを表示するときにこの値を使用します。
X-Axis
XMin
X 軸の下限を設定します。この値は、グラフが表示され
たときに計算されます。グラフのデザイン時には、サン
プルデータを表示するときにこの値を使用します。
X-Axis
XMinorGridStyle
マイナーなグリッド線に使用される線のスタイル。
X-Axis
XShowMinorTicks
TRUE の場合、グラフにマイナーな目盛りマークが表示
されます。その場合、メジャーな目盛りマークの間に示
されるマイナーな目盛りの数は常に 5 となります。
X-Axis
XTitle
X 軸に対して表示されるラベルテキスト。
X-Axis
XTitleBackGround Color
X 軸タイトルの背景の色。
X-Axis
XTitleBackgroundIsClear
TRUE の場合、X 軸タイトルの背景は無色になります。
バージョン 6.0
Siebel レポートガイド
9- 1 3
Reports.book
14 ページ
２００１年４月２７日　金曜日　午前１１時２７分
レポートでのグラフの使用
グラフコントロールプロパティ
表 9-2
プロパティカテゴリー別のグラフプロパティ (9/11)
カテゴリー
プロパティ
説明
X-Axis
XTitleBorderStyle
X 軸タイトルを囲む長方形のスタイル。オプションに
は、GraphNoBorder、GraphSolidBorder、
GraphDropShadow、GraphShadowAndBorder、
GraphRaisedBorder、GraphLoweredBorder があります。
X-Axis
XValueSet
使用できる X 軸の値の数を設定する方法を示します。
„
GraphDefaultXValues X 軸の値は使用できません。グ
ラフには X 軸に沿ってデフォルトの間隔が表示され
ます。
„
GraphXValuePerDataSet 最初の(または唯一の)データ
セットのポイントに 1 組の X 軸値が提供されます。
これが全ポイントに適用されます。
„
GraphXValuePerPoint 各ポイントは X 軸値を持ってい
ます。
X-Axis
XVerticalLabels
TRUE の場合は、X 軸ラベルが水平ではなく垂直に表示
されます。
Y-Axis
YAxisPosition
Y 軸の位置。オプションには、GraphYAxisAuto、
GraphYAxisLeft、GraphYAxisRight があります。
Y-Axis
YAxisStyle
グラフの原点の位置。オプションには、
GraphZeroOrigin、GraphAutoOrigin、GraphCustomOrigin
があります。
Y-Axis
YLabelFormat
カスタムの Y 軸ラベルを作成するときに使用する
フォーマットストリング。
Y-Axis
YLabelsList
カンマ区切りを持つ、見積り Y 軸値のリスト。
9- 1 4
Siebel レポートガイド
バージョン 6.0
Reports.book
15 ページ
２００１年４月２７日　金曜日　午前１１時２７分
レポートでのグラフの使用
グラフコントロールプロパティ
表 9-2
プロパティカテゴリー別のグラフプロパティ (10/11)
カテゴリー
プロパティ
説明
Y-Axis
YLabelStyle
Y 軸に沿って表示されるラベルの種類。オプションに
は、次のものがあります。
„
GraphNoLabels ラベルを表示しません。
„
GraphAutoLabels 自動的に計算されたラベルを表示
します。
„
GraphCustomLabels XLabelsList プロパティに入力し
た情報に基づいたカスタムラベルを表示します。
„
GraphExpressionLabels。LabelExp プロパティで指定し
た式により計算されたラベルを表示します。
Y-Axis
YMajorGridStyle
主要なグリッド線に使用される線のスタイル。オプショ
ンには、SingleLine、DashLine、DotLine、DashDotLine、
DashDotDotLine、NullLine があります。
Y-Axis
YMajorTickCount
表示する目盛りの数。Y 軸値を持つグラフの場合は、表
示される目盛りの数です。Y 軸値を持たないグラフの場
合は、目盛りの頻度です。
Y-Axis
YMajorTickStyle
目盛りマークの種類。オプションには、GraphNoTicks、
GraphAutoTicks、GraphCustomTicks があります。
Y-Axis
YMax
Y 軸の上限を設定します。この値は、グラフが表示され
たときに計算されます。グラフのデザイン時には、サン
プルデータを表示するときにこの値を使用します。
Y-Axis
YMin
Y 軸の下限を設定します。この値は、グラフが表示され
たときに計算されます。グラフのデザイン時には、サン
プルデータを表示するときにこの値を使用します。
Y-Axis
YMinorGridStyle
マイナーなグリッド線に使用される線のスタイル。オプ
ションには、GraphDefaultLines、GraphPatternLines、
GraphThickLines があります。
Y-Axis
YShowMinorTicks
TRUE の場合、グラフにマイナーな目盛りマークが表示
されます。その場合、メジャーな目盛りマークの間に示
されるマイナーな目盛りの数は常に 5 となります。
Y-Axis
YTitle
Y 軸に対して表示されるラベルテキスト。
Y-Axis
YTitleBackGround Color
Y 軸タイトルの背景の色。
バージョン 6.0
Siebel レポートガイド
9- 1 5
Reports.book
16 ページ
２００１年４月２７日　金曜日　午前１１時２７分
レポートでのグラフの使用
サンプルレポート‐商談パイプライン
表 9-2
プロパティカテゴリー別のグラフプロパティ (11/11)
カテゴリー
プロパティ
説明
Y-Axis
YTitleBackgroundIsClear
TRUE の場合、Y 軸タイトルの背景は無色になります。
Y-Axis
YTitleBorderStyle
Y 軸タイトルを囲む長方形のスタイル。オプションに
は、GraphNoBorder、GraphSolidBorder、
GraphDropShadow、GraphShadowAndBorder、
GraphRaisedBorder、GraphLoweredBorder があります。
Y-Axis
YTitleOrientation
Y 軸タイトルに対するテキストの表示方法を決定しま
す。デフォルトの GraphYLabelUp では、テキストが時
計と反対回りに 90 度回転されます。オプションには、
GraphYLabelHoriz、GraphYLabelUp、GraphYLabelDown
があります。
Y-Axis
YVerticalLabels
TRUE の場合、X 軸ラベルを 90 度回転して表示します。
サンプルレポート‐商談パイプライン
I
商談パイプラインの標準レポートは、¥Siebdev¥rptsrc¥enu¥standard のディレクト
リに用意されていますが、現在、Siebel Sales では使用しません。ただし、Siebel
Sales を起動して [ 商談 ] 画面をアクティブにした場合は、Actuate Developer
Workbench からこのレポートを呼び出せます。
商談パイプラインレポートを表示するには
1 Siebel Sales を起動して、[ 商談 ] 画面を開きます。
2 Actuate Developer Workbench を起動します。
3 Actuate で、C:¥Siebdev¥rptsrc¥enu¥standard に格納されている Oppipe.rod デザ
インファイルを開きます。
4 [ 表示 ] → [ ツールバー ] オプションの順に選択して、[ ビューア ] ツール
バー以外のすべてのツールバーを非表示にします。
5 レポートを構築し、実行します。
9- 1 6
Siebel レポートガイド
バージョン 6.0
Reports.book
17 ページ
２００１年４月２７日　金曜日　午前１１時２７分
レポートでのグラフの使用
サンプルレポート‐商談パイプライン
Actuate Developer Workbench に表示される商談パイプラインレポートを図 9-2 に
示します。
図 9-2
商談パイプラインレポート
これは棒グラフを含む単一ページのレポートです。このグラフでは、クローズ日
のある月別に売上 ( 予想または実際 ) を集計します。
バージョン 6.0
Siebel レポートガイド
9- 1 7
Reports.book
18 ページ
２００１年４月２７日　金曜日　午前１１時２７分
レポートでのグラフの使用
サンプルレポート‐商談パイプライン
レポート構造
I
商談パイプラインレポートの構造は非常に単純です。このレポートのデータは、
サブレポートを持たない 1 つのデータソースから取得されます ( 商談のみがグラ
フ化されるため )。唯一の特性は、コンテンツフレーム内にグラフのコンポーネ
ントが配置されることです。この構造は図 9-3 に示されています。
Report Design
Report Section
DataStream
Content
Graph
図 9-3
商談パイプラインレポートの構造
グラフコンポーネントは、ssCustom ライブラリの Library Viewer からコンテンツ
フレームにドラッグされています。ssSummaryGraph がフレームにドラッグされ
たコンポーネントです。これによって、構造ツリーに、コンテンツフレームのグ
ラフの子コンポーネントが表示されます。
9- 1 8
Siebel レポートガイド
バージョン 6.0
Reports.book
19 ページ
２００１年４月２７日　金曜日　午前１１時２７分
レポートでのグラフの使用
サンプルレポート‐商談パイプライン
プロパティ設定
I
表 9-3 に、商談パイプラインレポートにおけるグラフコンポーネントの重要なプ
ロパティ設定がリストに表示されています。
表 9-3
グラフの重要なプロパティ設定 (1/2)
プロパティ
設定
説明
Data.DataSetCount
1
バーシリーズが 1 つのみであることを指
定します。
Data.PointLabelStyle
GraphNoPointLabels
この設定は、各バーの上に値が表示され
ないことを指定します。
Expressions.CategoryKey
Year ([ssClose_Date]) * 12 +
Month ([ssClose_Date]) –1
この式は、各商談が発生する月に整数値
を割り当てます。同じ月の商談は、その
売上合計が 1 つのバーに示されます。
Expressions.Category Label
[ssClose_Date_ Formatted]
各 X 軸ラベルが生成される元の値。
Expressions.ValueExp
Sum (Val([ssRevenue]))
各バーを示す Y 軸値を取得する式。
General.GraphType
Graph2dBar
グラフが 2 番目の棒グラフであることを
指定します。
Graph-Specific.BarGrouping
GraphBarNoGrouping
バーシリーズが 1 つしか存在しないこと
を指定します。
Graph-Specific.BarOrientation
GraphBarVertical
棒グラフのバーが水平ではなく垂直に表
示されることを指定します。
X-Axis.XAxisStyle
GraphZeroOrigin
X 軸がゼロ値から開始することを指定し
ます。
X-Axis.XLabelFormat
mm 'yy
X 軸のラベルの生成に使用する、X 軸の日
付値のフォーマットマスクを指定します。
X-Axis.XLabelStyle
GraphExpressionLabels
X 軸のラベルが存在し、CategoryLabel 式
から導出されることを指定します。
X-Axis.XTitle
時間 ( 月別 )
X 軸の下に表示されるテキスト。
X-Axis.XValueSet
GraphXValuePerDataSet
すべてのデータシリーズに適用される 1
組の X 軸値が存在します。
バージョン 6.0
Siebel レポートガイド
9- 1 9
Reports.book
20 ページ
２００１年４月２７日　金曜日　午前１１時２７分
レポートでのグラフの使用
サンプルレポート‐商談パイプライン
表 9-3
グラフの重要なプロパティ設定 (2/2)
プロパティ
設定
説明
Y-Axis.YAxisPosition
GraphYAxisLeft
Y 軸が左側に表示されることを指定し
ます。
Y-Axis.YAxisStyle
GraphAutoOrigin
Y 軸の原点がデータから自動的に決定さ
れることを指定します。
Y-Axis.YLabelFormat
#,###
Y 軸の目盛りマークの横に表示される値
のフォーマットマスク。
Y-Axis.YLabelStyle
GraphCustomLabels
YLabelsList プロパティに入力した情報に
基づいたカスタムラベルを表示します。
Y-Axis.YTitle
Revenue
Y 軸に沿って表示されるタイトル。
Y-Axis.YMajorGridStyle
SingleLine
グリッドではなく、水平の線が表示され
ることを指定します。
Y-Axis.YMajorTickCount
5
Y 軸に表示される目盛りマークの数を指
定します。
Y-Axis.YVerticalLabels
False
Y 軸ラベルが垂直ではなく水平に表示さ
れることを示します。
9- 2 0
Siebel レポートガイド
バージョン 6.0
Reports.book
21 ページ
２００１年４月２７日　金曜日　午前１１時２７分
レポートでのグラフの使用
例‐グラフを使用したレポートの作成
例‐グラフを使用したレポートの作成
I
グループ区切りを持つレポートの After セクションに概要グラフを追加できます。
詳細レコードに続いて、各ページの最後にグラフが表示されます。このグラフは
各ページに示される情報を要約します。
この例では、情報源別商談分析レポート ( 個々のページに、各情報源の商談をリ
ストする ) が、各ページの最後に棒グラフを取り込むように変更されます。棒グ
ラフは、月別に商談を集計します。この棒グラフは基本的に、9-16 ページの
「サンプルレポート‐商談パイプライン」で説明された商談パイプラインレポー
トに表示されるグラフと同じです。これから作成するカスタムレポートでは、レ
ポート全体にグラフを提供するのではなく、同じ情報源を持つそれぞれの商談グ
ループに対して 1 つのグラフを提供します。
例を単純化するために、既存の OPSRC レポートをサブクラスに分類します。通
常は、新たにレポートデザインを作成します。
グラフを使用した情報源別商談分析レポートを作成するには
1 Actuate Developer Workbench で [ ファイル ] → [ 新規作成 ] の順に選択します。
表示されたダイアログボックスで、[ デザインのサブクラス化 ] を選択しま
す。
2 [ 基本デザインファイル選択 ] ダイアログボックスで [Opsrc.rod] を選択しま
す。
3 [ 新規レポートデザイン ] ダイアログボックスで、次の値を入力します。
„
タイトル グラフを持つ情報源別商談分析
„
ファイル名 < パス名 >。Opsrcgrph.rod
„
レポートオブジェクト名 OPSRCGRPH
4 構造ツリーで、グループセクション (ssGrp1) を検索します。そのグループセ
クションを右クリックし、表示されるポップアップメニューで [ ローカルサ
ブクラス ] を選択します。
5 未設定の場合は、[ 表示 ] → [ オプション ] → [ 空スロットを表示 ] を TRUE
に設定します。
バージョン 6.0
Siebel レポートガイド
9- 2 1
Reports.book
22 ページ
２００１年４月２７日　金曜日　午前１１時２７分
レポートでのグラフの使用
例‐グラフを使用したレポートの作成
6 ssCustom ライブラリの [ ライブラリ ] ウィンドウを開いて、その [ ライブラ
リ ] ウィンドウから ssFrm コンポーネントをグループセクションの子 After ス
ロットにドラッグします。After フレームを右クリックして、[ ローカルサブ
クラス ] を選択します。
7 [ ライブラリ ] ウィンドウから ssSummaryGraph コンポーネントを、After フ
レームのコンテンツ子スロットにドラッグします。[ ライブラリ ] ウィンドウ
を閉じて、空のスロットの表示をオフにします。
8 After フレームの下部のハンドルをドラッグして縦に拡大します。画面上で数
インチの高さにします。
9 グラフコントロールの右下のハンドルをドラッグして、After フレームのほぼ
全体を占めるようにグラフコントロールを拡大します。
10 構造ツリーでグループコンポーネントを選択して右クリックし、[ プロパティ ]
を選択します。Page.PageBreakBefore プロパティの設定を TRUE に変更します。
[ コンポーネントエディタ ] ウィンドウを閉じます。
11 構造ツリーで概要グラフコンポーネントを選んでクリックし、[ プロパティ ]
を選択します。プロパティを 9-19 ページの表 9-3 に示される値と一致するよ
うに設定します。[Titles.TitleText] の値をブランクに設定します。[ コンポー
ネントエディタ ] ウィンドウを閉じます。
12 Siebel Sales を起動して [ 商談 ] 画面をアクティブにします。
13 レポートをビルドし、実行します。
9- 2 2
Siebel レポートガイド
バージョン 6.0
Reports.book
23 ページ
２００１年４月２７日　金曜日　午前１１時２７分
レポートでのグラフの使用
例‐グラフを使用したレポートの作成
作成されたレポートは、図 9-4 のようになります。
図 9-4
バージョン 6.0
変更された情報源別商談分析レポート
Siebel レポートガイド
9- 2 3
Reports.book
24 ページ
２００１年４月２７日　金曜日　午前１１時２７分
レポートでのグラフの使用
例‐グラフを使用したレポートの作成
9- 2 4
Siebel レポートガイド
バージョン 6.0
Reports.book
1 ページ
２００１年４月２７日　金曜日　午前１１時２７分
スマートレポート
10
この章について . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-2
概要 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-2
スマートレポートの目的 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-2
標準のスマートレポート . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-4
ビジュアル特性 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-6
レポート構造と主要コンポーネント . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-10
価値の高さの指標 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-14
サーモメータ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-16
最小値、最大値、トリガー値の取得 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-18
データ値の取得 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-20
ダッシュボードのサブページ上でのサーモメータの配置 . . . . . . . . . . . . . 10-23
Siebel 生成グラフのスマートレポートへの転送 . . . . . . . . . . . . . . . . . . . . 10-25
バージョン 6.0
Siebel レポートガイド
10 - 1
Reports.book
2 ページ
２００１年４月２７日　金曜日　午前１１時２７分
スマートレポート
この章について
この章について
J
本章では、グラフを含む特殊フォーマットのレポートであるスマートレポートに
ついて説明します。その目的、機能方法について説明し、実行プロセスを説明し
た後、実際にスマートレポートを作成するプロセスを、例を使って紹介します。
この章を読めば、サーモメータや組織図などの特殊な Siebel グラフコンポーネン
トを独自のデザインで使用し、設定し、拡張する上で役立ちます。
概要
J
Siebel スマートレポートは、比較的上級の管理者ユーザーのニーズを満たすため
にデザインされた一連のレポートです。ここでは、その目的について説明した
後、標準のスマートレポートとその説明をリストし、一般的なビジュアル特性に
ついて提示しながら説明します。
スマートレポートの目的
J
アプリケーションソフトウェアを使用して作成する典型的なレポートは、複数
ページにわたる長いデータのリストであることが多く、重要な情報をすばやく見
つける方法がありません。こうしたレポートは一般的に、非管理クラスの従業員
や中級管理者にとって有用ですが、上級管理者ユーザーには、単にデータを並べ
ただけのレポートではなく、高度なビジュアル機能を実現することにより、意思
決定に必要な重要な情報を抽出できるレポートが必要です。
ある組織では、上級レベルの管理者は Siebel eBusiness Applications との主要な対
話形式としてレポートを使用し、それらのレポートにはデータへの一般的なアク
セス方法が提供されています。そのようなユーザーに対して、強力で柔軟性のあ
る直観的に使える、豊富な機能を備えたレポートを提供することが重要です。
Siebel スマートレポートは、上級管理者ユーザーがすばやく状況を特徴づけ、さ
まざまな問題を分析し、適切なアクションを実行できるように支援します。
たとえば、営業員、セールスマネージャ、コールセンターマネージャは、各自の
営業実績を、推奨される最善の方法と照らして測定し、動向を分析し、適切なア
クションをとるためにスマートレポートを使用できます。
10 - 2
Siebel レポートガイド
バージョン 6.0
Reports.book
3 ページ
２００１年４月２７日　金曜日　午前１１時２７分
スマートレポート
概要
スマートレポートは、総合的な情報からスタートして、徐々に詳細情報へと進む
ように構成されています。その内容は、3 つのセクションまたは情報カテゴリー
に分けられます。
バージョン 6.0
„
ダッシュボードセクション
スマートレポートの最初のセクションはダッシュボードです。ダッシュボー
ドには、ユーティリティと価値の高さの重要な測定に対する直観的なグラフ
指標が含まれます。これによって、検討中の状況、つまり商談を進める価値
があるか、パイプラインが良好かなどをすばやく測定できます。
„
概要セクション
重要な問題を識別したら、概要セクションに進んでそれらの問題を分析しま
す。これらのセクションには、分析に役立つチャートや図が含まれます。た
とえば概要セクションには、商談に関する主要な意思決定者を識別できる組
織図、ターゲットが見つからない危機的状況にある地域を正確に指摘するの
に役立つ Pipeline vs. Quota チャートなどが含まれます。
„
詳細セクション
問題を分析したら、その下にある詳細セクションをドリルダウンして、適切
なアクションを取ります。詳細セクションはたいてい、従来の標準レポート
と類似したフォーマットで情報を提供します。マネージャは、重要な意思決
定者を、主要な決定項目への取り組みに当たらせたり、注意が必要なパイプ
ラインの商談を識別したりできます。
Siebel レポートガイド
10 - 3
Reports.book
4 ページ
２００１年４月２７日　金曜日　午前１１時２７分
スマートレポート
概要
標準のスマートレポート
J
表 10-1 に、Siebel アプリケーションで使用できる標準のスマートレポートを示
します。
表 10-1
標準の Siebel スマートレポート (1/2)
名前
説明
データ階層
商談戦略の詳細
商談に関連するすべての詳細につ
いて説明します。商談の相対的な
重要性、クローズの見込み、これ
までに取られたステップ、計画ア
クションについての情報が含まれ
ます。
ダッシュボードは、取引サイズ、
購買影響力、クローズの見込み、
競合会社の活動、ステージ / マイ
ルストーンを集計します。
取引先に関連するすべての詳細に
ついて説明します。取引先の過去
および将来の売上、満足度、組織
階層、サービスリクエストに関す
る情報が含まれます。
ダッシュボードは、過去の売上、
パイプライン売上、顧客満足度、
競合会社の活動を集計します。
取引先概要
パイプライン分析
10 - 4
Siebel レポートガイド
現在のパイプラインの分析。履歴
情報を使用して、今後の 4 四半期
で予想される売上金額を判断し、
同期間の売上目標との比較方法を
決定します。
概要セクションと詳細セクション
は、次の領域に提供されています。
担当者、製品、競合会社、意思決
定基準、主要営業活動、全営業活
動、メモ。
概要セクションと詳細セクション
は、次の領域に提供されています。
売上分析 ( 確定およびパイプライ
ン )、現在の商談、担当者詳細、
インストール済み製品、顧客満足
度、オープンサービスリクエスト
( 重大度別 )、キャンペーン / 活動。
ダッシュボードは、当四半期の予
想売上と今後の 4 四半期の予想売
上を集計します。
概要セクションと詳細セクション
は、パイプライン売上と商談詳細
に提供されます。
バージョン 6.0
Reports.book
5 ページ
２００１年４月２７日　金曜日　午前１１時２７分
スマートレポート
概要
表 10-1
標準の Siebel スマートレポート (2/2)
名前
説明
データ階層
売上予想概要
当期の実績と、今年度の残りの期
間に対する見通しを測定します。
売上予想を行うすべての商談に関
する詳細情報が含まれます。
ダッシュボードは、当四半期確定
売上、通年配送売上、売上予想額
( パイプライン、予想、コミット
済み、確定 ) を集計します。
概要セクションと詳細セクション
には、実績 vs 目標、部下の売上予
想ロールアップ、商談詳細 ( ク
ローズ済み )、商談詳細 ( コミット
済み )、商談詳細 ( 予想 )、商談詳
細 ( パイプライン ) が含まれます。
売上目標概要
サービスリクエスト推移分析
取引先サービス詳細
当期および今年度の、売上目標に
対する実績を測定します。確定売
上およびパイプライン売上を追跡
して、四半期目標が達成可能かど
うかを判断します。
ダッシュボードは、当期売上およ
び通年売上を集計します。
現在オープンしているサービスリ
クエストの推移を分析します。実
績を証明する次の 3 つの価値を追
跡します。オープンしているサー
ビスリクエスト数、コール量、過
去数か月での解決にかかった平均
時間
ダッシュボードは、オープン時間
( 現在の SR)、オープン SR 数、
コール量、平均解決時間を集計し
ます。
取引先に関するすべてのサービス
関連情報を集計します。現在の
オープンサービスリクエスト、顧
客満足度、取引先に関するサービ
スリクエスト解決履歴に関する情
報が含まれます。
概要セクションと詳細セクション
には、部下の売上予想別、商談
( クローズ済み ) 別、商談 ( オープ
ン ) 別の売上が含まれます。
概要セクションと詳細セクション
には、オープンサービスリクエス
ト ( 重大度別 )、クローズサービス
リクエスト ( 重大度別 ) が含まれ
ます。
ダッシュボードは、売上、オープ
ン SR、顧客満足度を集計します。
最初の概要セクションには、重大
度分布、重大度別推移、SR サブ状
況、顧客満足度に関する概要グラ
フが含まれます。また、重大度別
クローズ回数の概要セクションも
あります。
重大度別オープンサービスリクエ
ストをリストする詳細セクション
が 1 つあります。
バージョン 6.0
Siebel レポートガイド
10 - 5
Reports.book
6 ページ
２００１年４月２７日　金曜日　午前１１時２７分
スマートレポート
概要
ビジュアル特性
J
スマートレポートには、特定ビューの [ レポート ] メニューに示されるようにラ
ベルが付けられています。たとえば、[ 商談 ( 個人 )] ビューの [ レポート ] メ
ニューでは、[ スマートレポート商談 ] は図 10-1 のように表示されます。
図 10-1
10 - 6
[ 商談 ( 個人 )] ビューの [ レポート ] メニュー
Siebel レポートガイド
バージョン 6.0
Reports.book
7 ページ
２００１年４月２７日　金曜日　午前１１時２７分
スマートレポート
概要
図 10-2 に示すように、スマートレポート商談レポートの最初のページは、商談
戦略詳細レポートとも呼ばれています。
図 10-2
バージョン 6.0
商談戦略詳細レポート
Siebel レポートガイド
10 - 7
Reports.book
8 ページ
２００１年４月２７日　金曜日　午前１１時２７分
スマートレポート
概要
備考 : 商談詳細レポートという名前は混乱しやすいので、注意が必要です。[ ス
マートレポート商談 ] メニューオプションは Opportunity Report オブジェクト定
義と Opdet.rod デザインファイルに対応しています。[ 商談詳細 ] メニューオプ
ションは Opportunity-Summary オブジェクト定義と Opsum.rod デザインファイル
に対応しています。これら 2 つは異なるレポートです。最初のレポートは多数の
グラフを含む商談用のスマートレポートで、後のレポートは各商談に関する担当
者、製品、活動、その他の詳細情報を提供するテキストレポートです。この章で
は、商談戦略詳細レポートという名前はスマートレポートを指し、商談詳細レ
ポートという名前はテキストレポートを指します。
スマートレポートに固有の 2 つの重要なグラフ要素について、次に説明します。
10 - 8
„
価値の高さの指標
上向き、下向き、右向き、または左向きの矢印アイコンは、レポートで分析
される 1 つ以上の基準に基づく商談、取引先などの価値を示します。矢印の
方向は、サーモメータにより測定される値がトリガーを上回るか、下回るか
によって異なります。
„
サーモメータ
垂直および水平方向に部分的に埋められた矩形グラフがサーモメータと呼ば
れます。
Siebel レポートガイド
バージョン 6.0
Reports.book
9 ページ
２００１年４月２７日　金曜日　午前１１時２７分
スマートレポート
概要
サーモメータは 4 つのパラメータによって定義されます。
„
測定 サーモメータにより測定される数量。この数量値によって、矩形の
塗りつぶされる高さが決まります。
„
最小 矩形の底部が示す値。
„
最大 矩形の頂部が示す値。
„
トリガー 測定値が対比されるベンチマーク。価値の高さの指標は、測定
値がトリガーを上回るか下回るかによって異なります。
サーモメータの設定の詳細については、10-16 ページの「サーモメータ」を
参照してください。
バージョン 6.0
Siebel レポートガイド
10 - 9
Reports.book
10 ページ
２００１年４月２７日　金曜日　午前１１時２７分
スマートレポート
レポート構造と主要コンポーネント
レポート構造と主要コンポーネント
J
スマートレポートは標準の Siebel レポートと比べると、かなり複雑な構造を持っ
ています。スマートレポートの高度なレポートデザインコンポーネントの階層
が、図 10-3 に示されています。
Report Design
Main Sequential Section
LOV Loading Report Sections
Main Report Section
Main Report Datastream
Page Header
Subreports Sequential Section
Data Loading and Sorting Report Sections
Dashboard Parallel Section
Dashboard Graphics Report
Sections
Dashboard Text Report Section
Dashboard Subpage
Non-Dashboard Subreport Sections
図 10-3
10 - 1 0
スマートレポートのコンポーネント階層
Siebel レポートガイド
バージョン 6.0
Reports.book
11 ページ
２００１年４月２７日　金曜日　午前１１時２７分
スマートレポート
レポート構造と主要コンポーネント
10-10 ページの図 10-3 に示されたデザインコンポーネントは次のとおりです。
バージョン 6.0
„
メイン順次セクション
これはすべての主要なレポートセクションの親コンポーネントです。これに
よって、子セクションが連続して実行されます。
„
LOV ロードレポートセクション
これは最初に実行されるレポートセクションです。これらのレポートセク
ションの目的は、各サーモメータの最高値、最低値、平均値 ( またはトリ
ガー ) を変数リスト (LOV) テーブルから取得することです。たとえば、取引
先概要スマートレポートでは、過去の売上、パイプライン、顧客満足度の
サーモメータに対してそれぞれ 1 つの LOV ロードセクションが存在します。
これらの各レポートセクションは、特定の LOV タイプに対応する変数リスト
テーブルからレコードを取得します。詳細については、10-18 ページの「最
小値、最大値、トリガー値の取得」を参照してください。
„
メインレポートセクション
このレポートセクションは、最初のデータ収集セクションとページリスト以
外のすべてのスマートレポートのデザインコンポーネントを保有しています。
その子には、主要レポートデータストリーム、スマートレポートのページ
ヘッダー、ダッシュボードとさまざまなサブレポートを処理する順次セク
ションがあります。
„
メインレポートデータストリーム
このデータストリームはレポートのマスターデータストリームであり、商談
スマートレポートの商談レコード、取引先スマートレポートの取引先レコー
ドなどを提供します。これは、データ供給ライブラリファイル内のマスター
データストリームのデータ行を使用します。
„
ページヘッダー
このコンポーネントは、スマートレポートのページヘッダーを定義します。
ページヘッダーでは、他の標準レポートと同じように、それぞれの主要エン
ティティの名前 ( 取引先、商談など ) が表示されます。エンティティに関す
る特定の集計値も表示されます。スマートレポートのページヘッダーの特性
は、エンティティの価値の高さの指標も表示することです。価値の高さの指
標の設定については、10-14 ページの「価値の高さの指標」に説明されてい
ます。
Siebel レポートガイド
1 0- 1 1
Reports.book
12 ページ
２００１年４月２７日　金曜日　午前１１時２７分
スマートレポート
レポート構造と主要コンポーネント
„
サブレポート順次セクション
このセクションには、主要レポートとサブレポートのさまざまなレポートセ
クションが含まれ、それらのセクションの順次処理が実行されます。これら
のセクションには、データソートセクション、ダッシュボードセクション、
レポート内のダッシュボードに続くサブレポートのセクションがあります。
„
データロードとレポートセクションのソート
これらのレポートセクションは、順次セクションの一番最初に、実際にレ
ポート行とグラフを生成するセクションの前に表示されます。データのロー
ドとセクションのソートによって、現在のマスターレコードに必要な詳細
データを取得し、処理します。このデータは、データ供給ライブラリファイ
ル内のさまざまな詳細データストリームから取得されます。
このステージでアクセスした詳細データストリームは、グローバルメモリ構
造にデータを保存します。多くの場合、保存前にデータのソートまたはマー
ジが行われます。グローバルメモリを保存する必要のない詳細データスト
リーム ( 取引先概要レポートの担当者、製品、活動のデータストリームなど )
は、それらが使用されるレポートセクションの前に含める必要はありません。
„
ダッシュボードパラレルセクション
パラレルセクションには、同じページの異なるフローに横並びに表示される
ことが多い複数のレポートセクションが含まれます。サーモメータやその他
のグラフとテキストを横並びに表示するダッシュボードセクションを作成す
るには、パラレルセクションが必要です。パラレルセクションの子は、ダッ
シュボードに表示されるグラフとテキストのレポートセクションです。
„
ダッシュボードグラフィックレポートセクション
レポートセクションは、ダッシュボード内の個々のグラフィック要素に対応
しています。それぞれがデータストリームを持ち、データフィルタを持つも
のもあります。また、それぞれがコンテンツフレームを持っています。コン
テンツフレームの子としてグラフコンポーネントまたはサーモメータフレー
ムのどちらかが含まれます。
サーモメータフレームは ssSmart.rol ライブラリ内の ss サーモメータコンポー
ネントから導出されます。サーモメータフレーム内の OnRow メソッドは、
親ライブラリサーモメータ内でそれに対応するメソッドに必要な値を計算し、
次の 4 つのパラメータを受け渡します。MinimumValue、MaximumValue、
TriggerDataValue、DataValue。これらの 4 つの値に基づいて、サーモメータが
描かれます。サーモメータラベル、トリガーラベル、塗りつぶしの色は、
サーモメータフレームのプロパティで指定します。サーモメータの設定につ
いては、10-16 ページの「サーモメータ」を参照してください。
10 - 1 2
Siebel レポートガイド
バージョン 6.0
Reports.book
13 ページ
２００１年４月２７日　金曜日　午前１１時２７分
スマートレポート
レポート構造と主要コンポーネント
サーモメータではなくグラフが表示された場合 ( 商談戦略詳細レポートや取
引先概要レポートの競合会社活動グラフなど )、コンテンツフレームには、
第 9 章「レポートでのグラフの使用」に説明されるように設定された、
AcDetailGraph コントロールまたは ssSummaryGraph コントロールが配置され
ます。
バージョン 6.0
„
ダッシュボードテキストレポートセクション
このセクションには、テキストのマスターレポート情報に関するデータスト
リームとコンテンツフレームが含まれます。ダッシュボード内のレポートテ
キストは 1 つのマスターレコードから取得されます。たとえば、取引先概要
レポートのダッシュボードテキストレポートセクションには取引先レコード
のフィールドが印刷されます。このセクションのデータストリームは、デー
タ供給ライブラリファイル内のマスターデータストリームです。コンテンツ
フレームにはサーモメータとその他のダッシュボードグラフ用にブランクス
ペースが用意されています。ただし、これらのスペースは、このコンテンツ
フレームではなくダッシュボードのサブページを使用して配置されます。
„
ダッシュボードのサブページ
サブページによって、セクション内のビジュアル要素の物理的なレイアウト
を構築します。ダッシュボードのサブページでは、ダッシュボードパラレル
セクションのレイアウトを指定します。サーモメータ、ダッシュボードグラ
フ、テキストレポートセクションの位置は、サブページでそれぞれのフロー
を定義し、位置を決めることによって設定します。通常、テキストレポート
セクションのフローはサブページ全体を占め、他のフローはそれぞれ、領域
の一部分を占めます。
„
非ダッシュボードのサブレポートセクション
概要セクションおよび詳細セクションを構成するサブレポートは、レポート
内でダッシュボードパラレルセクションの後に連続して表示されます。これ
らのサブレポートは、それぞれデータストリームとコンテンツセクションを
持つ通常のサブレポートとして設定されます。ただし、データはメモリ構造
( すでにデータのロードとソートセクションでロードされている ) から取得さ
れ、データフィルタを使用してソートまたはマージされる場合があります。
また、スマートレポートでは、Siebel アプリケーション内で生成され、レ
ポートに受け渡された組織図やタイムラインなどのグラフィックを使用しま
す。詳細については、10-25 ページの「Siebel 生成グラフのスマートレポート
への転送」に説明されています。
Siebel レポートガイド
1 0- 1 3
Reports.book
14 ページ
２００１年４月２７日　金曜日　午前１１時２７分
スマートレポート
価値の高さの指標
価値の高さの指標
J
価値の高さの指標は、スマートレポートの最初のページの右上に表示され、ペー
ジヘッダーで設定されます。この指標は、レポートで分析される 1 つ以上の基準
に基づく商談、取引先などの価値を示す上向き、下向き、右向き、または左向き
の矢印アイコンで構成されます。矢印の方向は、サーモメータによって測定され
た値がそれぞれのトリガーを上回るか下回るかによって決まります。図 10-4 に
は 3 つの価値の高さの指標が示されています。
図 10-4
上向き、横向き、下向きの価値の高さの指標
価値の高さの指標は、ssSmart.rol ライブラリ内で事前に定義された次の 3 つのイ
メージコンポーネントの 1 つから導出されます。ssOrderOfMeritUpImage、
ssOrderOfMeritDownImage、ssOrderOfMeritPushImage。ページヘッダーコンポー
ネントの Finish メソッド内のコードによって ( それぞれのターゲットに関連する
すべてのサーモメータの状態から )、矢印の方向が、上、下、または左右のいず
れかに決定されます。
たとえば、取引先概要では、ページヘッダーコンポーネントは
ssOrderOfMeritHeader1 です。Finish メソッドに次のコードが表示されます。
ArrowDirection = "DOWN"
IfCustomerSatisfactionAboveTarget And
PipelineThermometerAboveTarget Then
ArrowDirection = "UP"
End If
If PastRevenueThermometerAboveTarget And Not
PipelineThermometerAboveTarget Then
ArrowDirection = "PUSH"
End If
このレポートの場合、価値の高さの指標の方向は、2 つのサーモメータ、過去の
売上、およびパイプラインに基づいて決定します。これら 2 つのターゲットで
は、矢印の方向は上向きです。過去の売上がターゲットを上回り、パイプライン
がターゲットを下回る場合、矢印の方向は左右です。パイプラインに関係なく、
過去の売上がターゲットを下回る場合、矢印の方向は下向きです。
10 - 1 4
Siebel レポートガイド
バージョン 6.0
Reports.book
15 ページ
２００１年４月２７日　金曜日　午前１１時２７分
スマートレポート
価値の高さの指標
2 つの xxAboveTarget 変数の論理値を生成するコードは、10-20 ページの「デー
タ値の取得」に説明されるように、それぞれのサーモメータの OnRow メソッド
に格納されています。
ページヘッダーの Finish メソッドのコードによって、使用する矢印の方向が決定
され、ArrowDirection 変数に UP、DOWN、PUSH のいずれかが受け渡されます。
ページヘッダーの親ライブラリコンポーネント (ssOrderOfMeritHeader) 内の
Finish メソッドのコードによって、ssSmart.rol ライブラリ内のイメージコンポー
ネントと C:¥Siebdev¥rptsrc¥enu¥lib に保存されたビットマップファイルを使用し
て、適切な方向の矢印イメージがロード、生成されます。
バージョン 6.0
Siebel レポートガイド
1 0- 1 5
Reports.book
16 ページ
２００１年４月２７日　金曜日　午前１１時２７分
スマートレポート
サーモメータ
サーモメータ
J
サーモメータの一部は、スマートレポートのダッシュボードセクションにある矩
形グラフによって占められます。典型的なサーモメータを図 10-5 に示します。
トリガー
ラベル
水銀柱
サーモメータラベル
図 10-5
サーモメータのパーツ
サーモメータフレームは ssSmart.rol ライブラリ内の ssThermometer コンポーネン
トから下位分類されて導出されます。サーモメータを実行するために必要なほと
んどの機能は、すでに ssThermometer ライブラリコンポーネントで定義されてい
ます。カスタムのサーモメータを定義するには、ssThermometer コンポーネント
をレポートセクションのフレームに追加し、3 つのプロパティを設定します。次
に、4 つの値を計算するコードを書き込み、それらをグローバル変数として親コ
ンポーネントのメソッドに受け渡します。
サーモメータコンポーネントで設定する 3 つのプロパティは次のとおりです。
10 - 1 6
„
Color
サーモメータの水銀柱の色。ダッシュボード内のそれぞれのサーモメータは、
水銀柱に異なった色を使用します。
„
Label
サーモメータの下に表示されるラベルのテキスト。
„
TriggerLabel
サーモメータの左横のトリガー目盛りマークの左側に表示されるラベルのテ
キスト。
Siebel レポートガイド
バージョン 6.0
Reports.book
17 ページ
２００１年４月２７日　金曜日　午前１１時２７分
スマートレポート
サーモメータ
ssThermometer ライブラリコンポーネントに受け渡される 4 つのパラメータは、
次のとおりです。
„
DataValue
表示されるパラメータの値。この値によって水銀柱の高さが決まります。た
とえば、取引先の過去の売上を示すサーモメータでは、現在の取引先の過去
の売上値によって、全取引先の最小値および最大値に対する相対的な高さが
表示されます。ほかの 3 つのパラメータとは異なり、このパラメータは、レ
ポートの作成対象である特定エンティティに対して計算されます — この場合
は、全取引先ではなく、1 つの取引先です。
„
MinimumValue
全エンティティ内のこのエンティティに対する最小値 ( 取引先、商談など )
サーモメータフレームの一番下の値を決定します。
„
MaximumValue
全エンティティ内のこのエンティティに対する最大値。サーモメータフレー
ムの一番上の値を決定します。
„
TriggerDataValue
このエンティティのデータ値が、同種のエンティティに対して設定された
ターゲットを上回るか、下回るか、あるいは満たすかを判断する値です。過
去の売上の例では、トリガーデータ値は、トリガー目盛りマークの最大値お
よび最小値に相対する高さを示します。
これらの 4 つの値は、サーモメータコンポーネントの OnRow メソッドで受け渡
されます。レポートデザイン ( 最上位 ) オブジェクトで定義されたグローバル
変数として、親ライブラリサーモメータ、ssThermometer 内の対応するメソッド
に受け渡されます。これらの 4 つのパラメータと、サーモメータコンポーネン
トで指定したテキストおよび色のプロパティに基づいて、サーモメータが描か
れます。
サーモメータを設定する大部分の作業は、最小値、最大値、およびトリガーを全
レコードから取得し、現在のレコードからデータ値を取得することです。サーモ
メータも、ダッシュボードのサブページのフローとして配置する必要がありま
す。これらの設定については、別の項で説明します。
バージョン 6.0
Siebel レポートガイド
1 0- 1 7
Reports.book
18 ページ
２００１年４月２７日　金曜日　午前１１時２７分
スマートレポート
サーモメータ
最小値、最大値、トリガー値の取得
J
サーモメータの最小値、最大値、トリガー値を決定するために、さまざまな技術
が用意されています。これらの値は、レポート全体と同種の全エンティティを通
じて一定です。たとえば、取引先概要における過去の売上サーモメータの最小
値、最大値、トリガー値は、全取引先に対して一定です。
多くのサーモメータの場合、定数値は Siebel アプリケーションの変数リスト管理
で管理されます。過去の売上サーモメータでは、これらの定数は
TARGET_ACCNT_LIFE_REV タイプで設定されます。最小値は Target Low
フィールド、最大値は Target High フィールド、トリガー値は Order フィールド
でそれぞれ設定されます。変数リストの設定の詳細については、『Siebel アプリ
ケーション管理ガイド』を参照してください。
Siebel アプリケーションの変数リストテーブルでの設定は、データ供給ライブラ
リファイルによるビジネスコンポーネントレコードの受け渡しと同じように、
データストリームを介して Actuate レポートに伝達されます。LOVdatastream で
は適切なデータストリームは、データ供給ライブラリファイルではなく、
ssSmart.rol ライブラリの ssList_Of_ValuesQuery データストリームコンポーネント
から下位分類されます。
ssList_Of_ValuesQuery データストリームコンポーネントは、すべての LOV デー
タストリームに対して下位分類されます。LOV データストリーム間の唯一の違
いは、検索条件である名前 — 必要な LOV タイプにアクセスするための方法と
Fetch メソッドのロジックです。
過去の売上サーモメータの LOV レポートセクションがその典型例です。このレ
ポートセクションの構造は、図 10-6 に示されています。
seqMain
rptPastRevenueListOfValues
qryPastRevenueListOfValues
ssList_Of_ValuesDataRow
図 10-6
10 - 1 8
LOV データロードレポートセクションの構造
Siebel レポートガイド
バージョン 6.0
Reports.book
19 ページ
２００１年４月２７日　金曜日　午前１１時２７分
スマートレポート
サーモメータ
このレポートセクションには、次のコンポーネントが含まれます。
„
レポートセクション
LOV データをロードするレポートセクション。この場合は、
rptPastRevenuListOfValues— は、LOV データストリームを保有するだけの目的
で使用します。このようなレポートセクションは、それぞれの LOV データス
トリームを定義するために用意されています。通常はサーモメータごとに 1
セットの最小値、最大値、ターゲット値の各セットに対して、1 つの LOV
データストリームが存在します。
„
データストリーム
LOV データストリーム。この場合は、qryPastRevenuListOfValues— は
ssSmart.rol ライブラリ内の ssList_Of_ValuesQuery コンポーネントから下位分
類されます。データストリームは、SearchSpec プロパティと Fetch メソッド
のコードで設定します。
„
SearchSpec プロパティ このプロパティのテキストによって、1 組の定数
を提供する LOV レコードを取得する方法が指定されます。このプロパ
ティは LOV レコードの Type フィールドに基づいています。過去の売上
サーモメータの場合、データをロードするデータストリーム内の検索条件
式は、次のようになります。
[Type] = 'TARGET_ACCNT_LIFE_REV'
„
Fetch メソッド Fetch メソッド内のコードは、どのフィールドが LOV レ
コードの最大値、最小値、ターゲット値を提供し、必要な変換計算を実行
するかを指定します。取得された値は、あるサーモメータに対する 1 組の
定数に定義されているレポートデザインオブジェクト内のグローバル変数
に受け渡されます。過去の売上サーモメータの場合、Fetch メソッドには
次のコード行が含まれます。
PastRevenueAverage = Val ( aRow.ssOrder_By )
PastRevenueHigh = Val ( aRow.ssTarget_High )
PastRevenueLow = Val ( aRow.ssTarget_Low )
„
バージョン 6.0
データ行
データ行コンポーネントは常に ssList_Of_ValuesDataRow です。このコンポー
ネントは、データストリームコンポーネントが下位分類によってレポートデ
ザインに作成されたときにそのデータストリームコンポーネントに含められ
ます。データ行には、Siebel アプリケーションの LOV テーブルのレコード構
造に対応する 1 組の入力変数が含まれます。
Siebel レポートガイド
1 0- 1 9
Reports.book
20 ページ
２００１年４月２７日　金曜日　午前１１時２７分
スマートレポート
サーモメータ
データ値の取得
J
過去の売上サーモメータの例 (Acsum.rod 、取引先概要レポート ) では、データ
値として、現在の取引先の商談に関する過去の売上の合計を使用します。この
データ値を取得するためのコンポーネントとロジックについて、説明します。
データ値を取得するためのコンポーネントは、レポート構造の 2 つのエリアで生
成されます。
„
商談レコードの配列は、後でアクセスできるように、データをロードするレ
ポートセクションの 1 つにロードされます。
„
ダッシュボードレポートセクションは関連する商談レコードを合計し、
DataValue パラメータ内のその合計をサーモメータコンポーネントに受け渡し
ます。
商談レコード配列をロードするためのコンポーネントは、図 10-7 に示されるよ
うに、rptCollectOpportunitiesAndThreats レポートセクションの、secMain が開始
する付近に存在します。
secMain
rptCollectOpportunitiesAndThreats
ftrCollectOpportunities
ssOpportunityQuery_1
図 10-7
商談配列ロードのためのコンポーネント
このレポートセクションは 2 つのグローバル配列 ( 最高位のレポートデザインオ
ブジェクトに変数として関連付けられている )、PastOpportunityArray、および
PipelineOpportunityArray をロードします。この 2 つのグローバル配列はいずれ
も、現在の取引先の商談レコードを保有しますが、それぞれ異なる基準を満たし
ています。最初のグローバル配列は、後で、該当するサーモメータのデータ値を
取得するためにレポートロジックで使用します ( 後のグローバル配列は別のサー
モメータ、thermoPipeline に使用します )。
10 - 2 0
Siebel レポートガイド
バージョン 6.0
Reports.book
21 ページ
２００１年４月２７日　金曜日　午前１１時２７分
スマートレポート
サーモメータ
このレポートセクションを供給するデータストリーム、ssOpportunityQuery_1 は、
レポートのデータ供給ライブラリファイル内にあるサブレポートデータストリー
ムです。
レポートセクションの処理ロジックは、フィルタコンポーネント、
ftrCollectOpportunities の Start メソッドおよび Fetch メソッドに格納されていま
す。Start メソッドは、2 つの配列を空にします。Fetch メソッドは、指定した基
準と一致する商談データストリームのレコードを 2 つの配列にソートします。
PastOpportunityArray のレコードは確度 ( パーセント ) が 100％です。
PipelineOpportunityArray のレコードは確度 ( パーセント ) が 100％未満で、ク
ローズ日がレポートの実行日より後です。
メモリに保存されている商談レコードに基づいて現在の取引先の過去の売上を
決定するためのコンポーネントとロジックは、ダッシュボードパラレルセク
ション (parDashboard) の rptPastRevenueThermometer レポートセクションに格納
されています。このレポートセクションと子コンポーネントは、図 10-8 に示さ
れています。
parDashboard
rptPastRevenueThermometer
qryPastRevenue
rowPastRevenueThermometer
frmPastRevenue
thermoPastRevenue
図 10-8
バージョン 6.0
サーモメータレポートセクションコンポーネント
Siebel レポートガイド
1 0- 2 1
Reports.book
22 ページ
２００１年４月２７日　金曜日　午前１１時２７分
スマートレポート
サーモメータ
10-21 ページの図 10-8 に示されたコンポーネントは次のとおりです。
10 - 2 2
„
レポートセクション
サーモメータレポートセクション、rptPastRevenueThermometer には、メモリ
に保存された商談レコードから、取引先の過去の売上合計を抽出するための
データストリームとデータ行のコンポーネントが含まれます。また、サーモ
メータコンポーネント thermoPastRevenue を保有するコンテナフレーム、
frmPastRevenue も含まれます。サーモメータコンポーネントは、プロパティ
設定およびパラメータ変数に受け渡された値に基づいて、サーモメータを作
成します。
„
データ行
データ行コンポーネント、rowPastRevenueThermometer は variable—
PastRevenue を保有しています。データ行とデータストリームがサーモメータ
に対して生成する必要があるのは、この値を持つ 1 つの行だけです。
„
データストリーム
データストリームコンポーネント内の Start メソッドと Fetch メソッドは、
PastOpportunityArray メモリ構造内に保存された商談レコードを処理します。
この配列に対して Iterator の PastRevenueIterator が設定され、それぞれの商談
レコードの ssFunctionalRevenue の値が PastRevenue 変数に加算されます。
データストリームによって DataValue 変数としてサーモメータに提供される
値は、この変数値です。
„
コンテンツフレーム
frmPastRevenue フレームは標準のコンテンツフレームで、サーモメータコ
ンポーネントをレポート構造に組み込みます。それ以外の目的では使用し
ません。
„
サーモメータ
thermoPastRevenue コンポーネントは 1 つのサーモメータで、ssSmart.rol ライ
ブラリ内の ssThermometer ライブラリコンポーネントから導出されます。
Color、Label、TriggerLabel のプロパティは、サーモメータのこれらの特性を
設定するために thermoPastRevenue で設定します。OnRow メソッド
(thermoPastRevenue およびその親、ssThermometer に格納されたコード ) は、
データストリームにより生成された 1 つの行を取得し、メソッドの入力パラ
メータ、DataValue として PastRevenue 値を受け渡します。その他の入力パラ
メータ、MinimumValue、MaximumValue、TriggerDataValue は、10-18 ページ
の「最小値、最大値、トリガー値の取得」に説明されるように、前のロジッ
クから取得されます。
Siebel レポートガイド
バージョン 6.0
Reports.book
23 ページ
２００１年４月２７日　金曜日　午前１１時２７分
スマートレポート
サーモメータ
OnRow メソッドのもう 1 つの役割は、DataValue と TriggerDataValue を比較し
て、PastRevenueThermometerAboveTarget に対して TRUE または FALSE のい
ずれかの値を取得することです。このブール値変数と、その他のサーモメー
タでのそれに対応する値は、取引先のページの一番上に示される価値の高さ
の指標の矢印方向を決定するために、共に使用されます。
ダッシュボードのサブページ上でのサーモメータの配置
J
ページは、レポート内ページのビジュアルデザインを指定するコンポーネントで
す。ページコンポーネントは主に、ページの印刷可能な領域を決定するフロー、
場合によってはグラフ、ラベル、さまざまなコントロールを含むフローで構成さ
れます。レポート実行時に、Actuate によってデータを表示するフレームがビル
ドされます。各フレームが作成されると、Actuate によって、現在のページ上で
そのフレームがフローに配置されます。フレームをフローの左端に合わせて一番
上から順に配置されます。フレームが現在のフローよりも長い場合、Actuate に
よってそのフレームは、同じページ、または別のページにある次のフローの一番
上に配置されます。Siebel レポートの主要なページレイアウトは、PageList コン
ポーネントの PageStyle 子コンポーネントで指定されます。
レポートデザインにおける各セクションは、オプションでサブページに関連付け
ることができます。サブページは、アクティブページのフローに適合する点以外
は、ページと同じです。アクティブページとは、サブページを開始した時に生成
しているレポートのページです。ページと同様、サブページには、1 つ以上のフ
ローが含まれ、フレームとコントロールを含められます。
サブページは通常、ページの中にあるコンテンツセクションのページスタイルを
変更する場合に使用します。スマートレポートの場合、サブページは、サーモ
メータ、グラフ、レポートテキストをダッシュボード内で配置するときに使用し
ます。ダッシュボードの実行に使用するようなパラレルセクションでは、サブ
ページの各フローは、パラレルセクションにある 1 つのレポートセクションに対
応しています。この対応付けを実行するには、パラレルセクション内の各レポー
トセクションコンポーネントの FlowName プロパティにフローの名前を入力しま
す。通常このプロパティは、パラレルセクションでレポートセクションとサブ
ページフローを組み合わせる以外の目的では使用しません。
バージョン 6.0
Siebel レポートガイド
1 0- 2 3
Reports.book
24 ページ
２００１年４月２７日　金曜日　午前１１時２７分
スマートレポート
サーモメータ
図 10-9 に、取引先概要のダッシュボードパラレルセクションにおけるレポート
セクションとサブページフローが示されています。
parDashboard
rptCompetitiveActivity
rptPastRevenueThermometer
rptPipelineThermometer
rptMainDashboard
rptCustomerSatisfactionThermometer
subDashboard
flowMainDashboard
flowCompetitiveActivity
flowPastRevenueThermometer
flowPipelineThermometer
flowCustomerSatisfactionThermometer
図 10-9
10 - 2 4
ダッシュボードパラレルセクション構造
Siebel レポートガイド
バージョン 6.0
Reports.book
25 ページ
２００１年４月２７日　金曜日　午前１１時２７分
スマートレポート
Siebel 生成グラフのスマートレポートへの転送
特殊な ssSmart.rol コンポーネントではなく、標準のサブページコンポーネント
とフローコンポーネントを使用します。サブページコンポーネントは、[ ページ
レイアウト ] ツールバーから、追加するセクションにドラッグします。次に、手
動でサイズハンドルをドラッグして、サイズを変更します。フローは、[ ページ
レイアウト ] ツールバーからサブページエリアにドラッグして、サイズを変更
し、配置します。フローのサイズは、サーモメータ、グラフ、レポートテキス
ト、その他に含めるものすべてと、関連ラベルを内包できる大きさにします。ま
た、標準のスマートレポートのテキストレポートフローのサイズが、スペースを
最大限に使用するようにサブページ全体を占める場合でも、フローが重複しない
ようにします。
Siebel 生成グラフのスマートレポートへの転送
J
スマートレポートの特殊なグラフには、AFC および ssCustom のグラフクラスを
使用して定義するには複雑すぎるものがあります。これらのグラフは、Siebel ア
プリケーションで生成してから、OLE の自動化 ( または同様のアプリケーショ
ン間オブジェクト通信 ) を使用してビットマップとして Actuate レポートに転送
します。転送されたスマートレポートのグラフの例として、商談戦略詳細レポー
トの組織図、取引先サービス詳細レポートの 3 つのチャートの重大度分布、サー
ビスリクエストサブ状況、重大度別推移が挙げられます。
転送されたグラフでは、ssSmart.rol ライブラリのライブラリイメージコンポーネ
ントを使用します。Opdet.rod における組織図イメージ (ssOrgChartImage1) は、
ssSmart.rol のライブラリイメージコンポーネント、ssOrgChartImage から取得さ
れます。Acsvcdet.rod 内のイメージコンポーネント (imgSeverityDistribution、
imgAgingBySeverity、imgStatusAnalysis) は、ssSmart.rol の
ssOpenServiceRequestChartImage から取得されます。これらのイメージを Siebel
アプリケーションから転送するためのロジックは、ライブラリイメージコンポー
ネント (ssOrgChartImage または ssOpenServiceRequestChartImage) 内の
GetChartImage メソッドに格納されています。
Siebel アプリケーション側においてビットマップを生成するためのロジックは、
専用のビジネスサービス ( ビジネスコンポーネントやアプレットとは異なる ) ク
ラスコードに格納されています。ssOrgChartImage から取得される組織図のイ
メージコントロールは、Siebel Tools の Organization Chart Exporter ビジネスサービ
スに依存します。ssOpenServiceRequestChartImage から取得されるイメージコン
トロールはチャートビジネスサービスに依存します。
バージョン 6.0
Siebel レポートガイド
1 0- 2 5
Reports.book
26 ページ
２００１年４月２７日　金曜日　午前１１時２７分
スマートレポート
Siebel 生成グラフのスマートレポートへの転送
Siebel Tools では、専用クラスの作成や変更がサポートされていないため、Siebel
では顧客によってスマートレポートに転送されたグラフの作成および変更はサ
ポートされません。こうした機能が必要な場合は、Siebel テクニカルサービスに
連絡してください。
転送されたグラフィックを含む、組織図などのレポートは、サーバーレポート
モードやシンクライアントレポートモードとは異なる、接続クライアントレポー
トモードでのみサポートされます。
10 - 2 6
Siebel レポートガイド
バージョン 6.0
Reports.book
1 ページ
２００１年４月２７日　金曜日　午前１１時２７分
売上予想レポート
11
この章について . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-2
売上予想データ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-2
部下の反復 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-8
Period ビジネスコンポーネント . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-9
売上予想レポートプロセスの概要 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-11
期間情報のロード . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-12
売上予想ライブラリ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-13
動的データ行と foDataRow 変数 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-13
既存の売上予想レポートの検討 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-16
期間をロードするレポートセクション . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-20
個人をロードするレポートセクション . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-20
出力レポートセクション . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-30
反復データの取得 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-39
データストリームの同期化 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-41
データ反復のその他の用途 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-46
バージョン 6.0
Siebel レポートガイド
11 - 1
Reports.book
2 ページ
２００１年４月２７日　金曜日　午前１１時２７分
売上予想レポート
この章について
この章について
K
本章は、動的なデータ行、Period ビジネスコンポーネント、反復などの特殊なデ
ザイン技術を使用する売上予想レポートについて説明します。売上予想データモ
デルについて説明した後、特殊なデザイン技術の概要を紹介します。最後に、代
表的ないくつかの売上予想レポートについて詳しく説明します。
売上予想データ
K
標準的な売上予想レポートは、[ 売上予想 ] 画面のビューに用意されています。
これらのビューは、11-3 ページの図 11-1 に説明されているビジネスコンポーネン
トとリンクされている Person Forecast ビジネスオブジェクトに基づいています。
11 - 2
Siebel レポートガイド
バージョン 6.0
Reports.book
3 ページ
２００１年４月２７日　金曜日　午前１１時２７分
売上予想レポート
売上予想データ
Forecast Quote Item
Forecast Scenarios
Master Forecast
Period
Person Forecast
Opportunity Forecast
Opportunity Forecast
Detail - Wide
Opportunity Product
Forecast
Opportunity Person
Forecast
Opportunity Person
Forecast Detail - Wide
Opportunity Product
Person Forecast
Person Forecast
Detail - Wide
Oppty Product
Forecast
Oppty Product Person
Forecast
Executive
Opportunity Forecast
Executive Opportunity
Forecast Detail - Wide
Executive Oppty
Product Forecast
Executive Oppty Product
Forecast Detail - Wide
Managed Person
Forecast
M P Oppty Fcst
説明
ビジネスコンポーネント
1対多関係(ビジネス
オブジェクトコンポーネント
およびリンクを介す)
図 11-1
M P Oppty
Fcst Detail - Wide
Managed Person
Forecast Detail - Wide
Person Forecast ビジネスオブジェクトのデータモデル
バージョン 6.0
Siebel レポートガイド
11 - 3
Reports.book
4 ページ
２００１年４月２７日　金曜日　午前１１時２７分
売上予想レポート
売上予想データ
Person Forecast ビジネスオブジェクトのビジネスコンポーネントのうち、図
11-2 に示されたコンポーネントだけが実際に標準の売上予想レポートに使用さ
れます。
Master Forecast
Period
Person Forecast
Opportunity Forecast
Opportunity Product
Forecast
Oppty Product
Forecast
Executive
Opportunity Forecast
説明
Executive Oppty
Product Forecast
Managed Person
Forecast
図 11-2
11 - 4
ビジネスコンポーネント
1対多関係(ビジネス
オブジェクトコンポーネント
およびリンクを介す)
Person Forecast ビジネスオブジェクトのレポートサブセット
Siebel レポートガイド
バージョン 6.0
Reports.book
5 ページ
２００１年４月２７日　金曜日　午前１１時２７分
売上予想レポート
売上予想データ
Siebel には、次の 2 つの売上予想基本タイプ ( モデル ) が用意されています。商
談別売上予想と製品別売上予想です。商談別売上予想モデルには、さらに商談製
品別売上予想と呼ばれる製品レベルの拡張モデルがあります。これは次のように
なります。
„
商談別売上予想
商談別売上予想では、Opportunity Forecast ビジネスコンポーネントを使用し
て、それぞれの商談の売上予想額に基づいて売上予想を行います。この方法
の主な利点は単純さです。商談別売上予想では、売上予想期間における各営
業員の売上予想額の概要を知ることができます。これに対して、製品別売上
予想ではより詳細レベルの売上予想が行われます。したがって、商談別売上
予想は、ある営業員が進めている商談がどれかを知り、全体的な視点からそ
れらの商談の売上額を把握することができます。この方法の欠点の 1 つは、
商談の売上予想額を製品リストおよび予想数量のリストとして具体的に示す
ことができない点です。
„
製品別売上予想
製品別売上予想では、販売される製品の価格と数量に基づいて売上予想が行
われます。この売上予想は、Opportunity Product ビジネスコンポーネントのレ
コードを元に作成され、Oppty Product Forecast ビジネスコンポーネントのレ
コードに保存されます。
この方法の主な利点は、組織がユニットレベルで売上予想と計画を実施でき
ることです。これは通常、要件計画の目的で必要となります。商談別売上予
想が今後数か月間の組織の計画に対する総合的な予想図だけを提供するのに
対し、製品別売上予想では、計画目的で、取引先ごとに予想される販売数量
と販売価格に直接リンクできます。ただし、この方法の欠点の 1 つは、それ
ぞれの営業員が、商談別売上予想に比べてはるかに詳細な情報を追跡し、調
整する必要があることです。
„
商談製品別売上予想
商談製品別売上予想は、商談別売上予想の拡張モデルで、それぞれの商談に
関する製品レベルの売上予想を追加します。商談製品別売上予想は、製品別
売上予想と同じく、既存の商談製品レコードを元に作成されます。
商談製品別売上予想を使用すると、売上予想を行う 1 つまたは複数の商談の
詳細な製品分析が行えます。商談製品別売上予想は、商談別売上予想を使用
している場合にのみ使用でき、商談別売上予想のある行をドリルダウンする
ことにより商談製品フレームを表示できます。この機能を使用する最も代表
的な例は、組織が通常、総合的な商談レベルで売上予想を行う一方で、特定
製品の販売を追跡する場合です。
バージョン 6.0
Siebel レポートガイド
11 - 5
Reports.book
6 ページ
２００１年４月２７日　金曜日　午前１１時２７分
売上予想レポート
売上予想データ
すべての売上予想レポートで、Master Forecast、Person Forecast、Period のビジネ
スコンポーネントが使用されます。それ以外のビジネスコンポーネントは、各レ
ポートによって必要な場合と必要ない場合があります。売上予想レポートで使用
されるビジネスコンポーネントは次のとおりです。
„
Master Forecast
使用する売上予想のクラスを構築するビジネスコンポーネントです。ただし、
Master Forecast ビジネスコンポーネントに対しては、その ID フィールドの値
を取得する場合以外、データのクエリーは実行されません。この ID の値に
よって、個人売上予想レコードをマスター売上予想に関連付けることができ
ます。
„
Person Forecast
Person Forecast ビジネスコンポーネントには、マスター売上予想内に売上予想
を保有している個人に関するトップレベルの情報が含まれます。マスター売
上予想レコードに対して、特定の個人は、ある売上予想期間内にクローズす
るいくつかの、またはすべての商談に関する個人売上予想レコードを保有し
ています。部下から報告を受ける場合、それらの部下も Managed Person
Forecast ビジネスコンポーネント内のレコードとして表示されます。
„
Period
Period ビジネスコンポーネントには、他の種類の売上予想レコードで開始期
間と終了期間を指定するときに参照する、それぞれの月、四半期、年、また
はカスタム期間を定義するレコードが含まれます。
„
Opportunity Forecast
商談別売上予想での使用。それぞれのレコードには、個人売上予想に含まれ
る 1 つの商談に関する売上予想情報が保存されています。
„
Oppty Product Forecast
製品別売上予想での使用。それぞれのレコードには、個人売上予想に含まれ
る 1 つの商談に関する売上予想情報が保存されていますが、この情報は製品
価格および数量から取得されます。
備考 : 名前の商談の部分を無視すると、理解しやすくなります。
„
11 - 6
Opportunity Product Forecast
商談製品別売上予想に使用されるビジネスコンポーネントです。それぞれの
レコードには、個人売上予想に含まれる 1 つの商談の 1 製品に関する売上予
想情報が保存されています。
Siebel レポートガイド
バージョン 6.0
Reports.book
7 ページ
２００１年４月２７日　金曜日　午前１１時２７分
売上予想レポート
売上予想データ
„
Managed Person
それぞれの管理個人売上予想レコードは、個人売上予想の管理責任者に直属
または間接的な部下である個人を識別します。管理される個人は、監督者の
売上予想に反復で組み込まれる商談、製品、または商談製品レコードを保有
します。これについては 11-8 ページの「部下の反復」で説明します。
„
Executive Opportunity Forecast
個人売上予想にセットアップされた個人を指揮するすべての個人に必要な商
談別売上予想を取得するために使用されます。このビジネスコンポーネント
は基本的に、管理個人売上予想の反復を実行します。そうでない場合は、ビ
ジネスオブジェクトの操作によって反復されます。
このビジネスコンポーネントの利点は、管理個人売上予想の反復に必要な、
新規ビジネスオブジェクトの作成作業を行わずに組織階層を移動できること
です。ただし、提供されるのは個々の商談別売上予想だけで、各個人のロー
ルアップ情報が提供されないという欠点があります。
„
バージョン 6.0
Executive Opportunity Product Forecast
個人売上予想にセットアップされた個人を指揮するすべての個人に必要な製
品別売上予想を取得するために使用されます。このビジネスコンポーネント
には、Executive Opportunity Forecast と同じ利点と欠点がありますが、製品別
売上予想情報が必要な場合にのみ使用されます。
Siebel レポートガイド
11 - 7
Reports.book
8 ページ
２００１年４月２７日　金曜日　午前１１時２７分
売上予想レポート
売上予想データ
部下の反復
K
部下の売上予想レコードは個人売上予想の詳細レコードです。個人売上予想の所
有者の各個人のレポートを識別できます。部下は、上司の売上予想に反復で組み
込まれる商談、製品、または商談製品レコードを保有します。理論的には、部下
のリストに含められる人数は無制限で、図 11-3 に示されるように、レベル数の
制限なしに反復できます。
マスター売上予想
個人売上予想1
商談別売上予想
部下の売上予想1
商談別売上予想
部下の売上予想2
その他
図 11-3
部下のリストの反復
反復は、同じ 3 つのビジネスコンポーネントを使用して実行されます。その概念
は、Person Forecast ビジネスコンポーネントとその基本的なビジネスコンポーネ
ントを新たな個人に対して反復し使用することです。
そのためには、Managed Person Forecast ビジネスコンポーネントの新規の
PersonID を使用して、ビジネスオブジェクトを再実行する必要があります。
Master Forecast ビジネスコンポーネントが変更されていない場合でも、そのつど
このコンポーネントもクエリーする必要があることに注意してください。
11 - 8
Siebel レポートガイド
バージョン 6.0
Reports.book
9 ページ
２００１年４月２７日　金曜日　午前１１時２７分
売上予想レポート
売上予想データ
売上予想レポートの管理従業員階層全体で反復を実行する際に、さまざまな技術
を使用できます。標準の売上予想レポートでは、新規の Person Forecast ビジネス
オブジェクトのインスタンス化を使用します。同じマスター売上予想をクエリー
して新規の Position ID の売上予想情報を取得するように新規ビジネスオブジェ
クトを設定します。このように設定しておくと、( 現在のビューで使用されてい
る ) 元のビジネスオブジェクトを変更しないですみます。
実際には、反復は DataStream コンポーネントにハードコードされているため、
標準の売上予想レポートでは管理の 1 レベルだけが反復されます。売上予想レ
ポートをレベル数に制限なく反復するためにハードコードを使用できますが、新
規ビジネスオブジェクトをクエリーするためのシステムリソースと、DataStream
コンポーネントを再構成するプログラミング時間が必要となります。
商談別売上予想と同様、製品別売上予想も Managed Person Forecast ビジネスコン
ポーネントに含まれる情報に基づいて反復できます。どちらの場合も、反復に同
じ技術が使用されます。
Period ビジネスコンポーネント
K
すべての売上予想情報は日付に関連していますが、実際の売上予想のビジネスコ
ンポーネントに日付は含まれません。日付の代わりに期間 ID 値が使用され、こ
の値によって Period ビジネスコンポーネントのレコードを指定できます。個人
売上予想レコードには、その詳細な商談別売上予想、商談製品別売上予想、商談
製品別売上予想レコードと同様、Start Period Id フィールドと End Period Id フィー
ルドがあります。
管理者権限を持っていれば、Siebel アプリケーションの [ 期間管理 ] ビューの期
間レコードを参照できます。メニューバーから [ 画面 ] → [ アプリケーション管
理 ] → [ 期間 ] の順に選択します。
期間レコードは次のフィールドで構成されています。
バージョン 6.0
„
期間
1999 年 6 月や 2000 年度第四半期のように期間を示す名前。これは他の言語
に翻訳可能な、言語独立のキーフレーズです。
„
クローズ
TRUE の場合、期間が過ぎていることを示します。
„
開始日
期間の開始日です。
Siebel レポートガイド
11 - 9
Reports.book
10 ページ
２００１年４月２７日　金曜日　午前１１時２７分
売上予想レポート
売上予想データ
„
終了日
期間の終了日です。
„
期間タイプ
月、四半期、年、または隔週などの同じタイプの期間に分類します。
„
説明
何の期間かを説明するコメントです。
したがって、売上予想期間は開始と終了の 2 つの月、四半期、または年の間の期
間となります。たとえば、1999 年 1 月～ 6 月、1998 年第 4 四半期～ 1999 年第 3
四半期、2000 年～ 2001 年のようになります。
システム管理者は、2 週間や半月などのユーザー定義期間の任意のタイプを設定
できます。ただし、標準レポートでは次の 3 つの基本的な期間タイプだけを使用
します。月、四半期、年。
11 - 1 0
Siebel レポートガイド
バージョン 6.0
Reports.book
11 ページ
２００１年４月２７日　金曜日　午前１１時２７分
売上予想レポート
売上予想レポートプロセスの概要
売上予想レポートプロセスの概要
K
それぞれの売上予想モデルで、必要なビジネスコンポーネントに含まれる情報を
示すために、同じ基本プロセスが使用されます。既存のビジネスオブジェクト
( ビューの場合と同じ ) を使用して、マスター売上予想 ID が保存されます。この
マスター売上予想のレコードを取得するには、Person Forecast ビジネスコンポー
ネントが必要です。Position Id フィールドに基づいて、個人売上予想に必要な商
談別売上予想レコードまたは製品別売上予想レコードが取得されます。個人売上
予想に必要な管理個人売上予想レコードの直属レベルは、それぞれの Manager
Position Id フィールドに基づいて取得されます。
レポートが管理階層で反復する必要がある場合、Actuate によって、管理個人の
リスト内の各個人に基づいて異なる情報を持つ同一のビジネスオブジェクトを使
用して、新たに OLE インターフェースが作成されます。Actuate の観点から、該
当する個人の製品別売上予想レコードまたは商談別売上予想レコードに加えて、
( 管理個人売上予想レコードから取得された ) 同じマスター売上予想と新しい
Position ID を使用するように設定された、新規ビジネスオブジェクトを作成しま
した。このプロセスが、管理階層のそれぞれのレベルで反復されます。
商談製品別売上予想を使用している場合、商談別売上予想のそれぞれの商談に対
して新たにビジネスオブジェクトインスタンスが作成されます。最初のクエリー
で指定した Opportunity Forecast ビジネスコンポーネントと同じマスター売上予想
とレコードを使用して、新規ビジネスオブジェクトインスタンスがロードされま
す。それぞれの商談別売上予想に対して、すべての商談製品別売上予想レコード
が取り込まれます。
エグゼクティブワークシートの売上予想には、マスター売上予想と個人売上予想
のレコードが取得され、個人売上予想には、Executive Opportunity Forecast または
Executive Oppty Product Forecast ビジネスコンポーネントが取得されます。エグゼ
クティブワークシート売上予想によって、管理階層の各個人に関する商談別売上
予想情報または製品別売上予想情報が得られます。
バージョン 6.0
Siebel レポートガイド
1 1- 1 1
Reports.book
12 ページ
２００１年４月２７日　金曜日　午前１１時２７分
売上予想レポート
売上予想レポートプロセスの概要
期間情報のロード
K
Period ビジネスコンポーネントに含まれる情報は、売上予想レポートシステム全
般で広範囲にわたって使用されます。期間データを使用できるようにするための
最初のステップとして、Siebel アプリケーションから Actuate レポートにデータ
をインポートします。異なる期間タイプである月、四半期、年、およびカスタム
単位に関するすべての情報は、Period ビジネスコンポーネントで表示されるテー
ブルに示されています。
期間情報を効果的に使用するには、異なる期間レコードを、月、四半期、年の 3
つの検索テーブルに分ける必要があります。ssFcast ライブラリに用意されてい
る foPeriodQuery データストリームによって、この作業が実行されます。
それぞれのリストにアクセスするときに使用できる、3 つの静的変数があります。
„
lstMonth には、月別の各期間のオブジェクトが含まれます。
„
lstQuarter には、四半期別の各期間のオブジェクトが含まれます。
„
lstYear には、年別の各期間のオブジェクトが含まれます。
備考 : lst という接頭辞は first ではなく、list の略です。
それぞれのオブジェクトは、Period ビジネスコンポーネントから戻されたデータ
行から取得されます。データ行には、言語独立の期間タイプ
(Period_Type_Lov_Name)、開始日、終了日、言語に依存する ( 翻訳済みの ) 期間名
(ssPeriod_Type) の変数と、使用されないその他のいくつかの変数が存在します。
期間リストはすべて、AcSingleList タイプの標準的な Actuate リストです。
AcSingleList で使用可能な各種のメソッドとそのインテレータの AcIterator を使用
すると、リスト内でコードを使用でき、必要なすべての期間情報を取得できます。
標準の売上予想レポートを使用可能にするには、次の条件を満たす必要があり
ます。
11 - 1 2
„
Period ビジネスコンポーネントには、月、四半期、年のいずれかのタイプ値
が存在する必要があります。
„
それぞれの Forecast ビジネスコンポーネントのレコードは、同じ期間数を使用
します。たとえば、12 か月、4 四半期、1 年の期間別売上予想では、それぞ
れのレコードにちょうど 17 期間のフィールドが存在します。
Siebel レポートガイド
バージョン 6.0
Reports.book
13 ページ
２００１年４月２７日　金曜日　午前１１時２７分
売上予想レポート
売上予想レポートプロセスの概要
売上予想ライブラリ
K
1 つの主要コンポーネントライブラリと、3 つのデータストリームライブラリが
あります。これらを、売上予想レポートの作成に使用できます。ssFcast.rol ライ
ブラリがプライマリコンポーネントライブラリです。このライブラリ内のコン
ポーネントは、売上予想レポート用に用意された、標準ライブラリコンポーネン
トの特殊バージョンです。ssFcast.rol ライブラリ内のすべてのコンポーネントに
は、"fo" という接頭辞が付きます。たとえば、foDataSource はデータソースのコ
ンポーネントです。
売上予想レポート用のデータストリームライブラリは、Siebel Tools では生成でき
ません。手動コーディングによって作成します。売上予想モデルによって、3 つ
のデータストリームライブラリのうちの 1 つが売上予想レポートで使用されます。
„
Fooptyds.rol
商談別売上予想または商談製品別売上予想にデータを供給するライブラリ
„
Foprod.rol
製品別売上予想にデータを供給するライブラリ
„
Foexecds.rol
エグゼクティブワークシート商談別売上予想またはエグゼクティブワーク
シート製品別売上予想にデータを供給するライブラリ
動的データ行と foDataRow 変数
K
Forecast ビジネスコンポーネントのデータは完全に非標準化されています。言い
換えると、複数のレコード構造が統合されて、ビジネスコンポーネント数が少な
くなり、それぞれのコンポーネントのフィールド数が増えて、いくつかのカラム
データは数か所に登場することもあります。この方法には、管理ロールアップと
エグゼクティブワークシート情報の収集を効率的にするいくつかの利点がありま
す。ただし、売上予想レポートが複雑になります。
売上予想のカラム数は変数です。これは、売上予想モデルで使用される期間数が
システム管理者によって設定されるためです。標準の Actuate デザイン技術を使
用する場合、それぞれのカラムまたはフィールドを設計時に宣言する必要があり
ます。変数の静的宣言は、期間数が大きすぎる可能性があるため、実用向きでは
ありません。
バージョン 6.0
Siebel レポートガイド
1 1- 1 3
Reports.book
14 ページ
２００１年４月２７日　金曜日　午前１１時２７分
売上予想レポート
売上予想レポートプロセスの概要
単純な 12 か月の売上予想のケースでは、12 か月、4 四半期、最低 1 年、合計 17
期間が存在します。各期間の売上予想行には、売上、機能売上 ( 通貨に依存しな
い )、数量、価格情報 ( 製品別売上予想または商談製品別売上予想の場合 ) が必
要な場合があります。このケースでは、4 × 17、つまり 68 のデータカラムが必
要になります。さらに、各行には 2 つの合計カラムと、5 ～ 10 の追加の静的
データカラムが含まれます。したがって、単純な 1 年の売上予想モデルでは、レ
ポート設計者はおよそ 80 カラムのデータ行を作成する必要があります。
この状況を避けるには、売上予想データストリームで動的データ行を使用しま
す。それぞれのデータ行レコードには、月、四半期、年の期間の売上予想情報を
示す 3 つのリスト変数 ( つまり AcList クラスの変数 ) が含まれます。これらの変
数には、各期間に必要なすべての売上予想の値が含まれます。動的データ行を使
用すると、データ行に追加できる期間数は無制限になります。
それぞれの売上予想データ行には、リスト変数以外にも一般的に使用される多数
の変数が含まれています。そのいくつかは (ssFcast.rol ライブラリ内の )foDataRow
クラスで定義され、すべての売上予想データ行のスーパークラスとして使用され
ます。foDataRow クラス変数のいくつかは次のように説明できます。
„
BuildOrder
データの表示に使用されます。
„
cusEndDate
期間レコードに表示される日付範囲の最終日を識別します。foDataSource コ
ンポーネントのデータストリームメソッドのコードから生成されます。
„
cusStartDate
日付範囲の開始日を識別します。cusEndDate を参照してください。
„
lstMonth
売上予想レコードの月別の期間に対するデータを保有する配列です。データ
ストリームメソッドのコードによってロードされ、次の 5 つの配列カラムで
構成されます。FuncRevenue、Revenue、Price、Quantity、ValType。ValType は
foDataSource コードによって設定される取得フィールドで、データの表示時
に使用されます。5 つの配列カラムのセットは DynPerColumn ( 動的期間カラ
ム ) クラスで定義されます。
備考 : lst は first ではなく、list の略です。
„
11 - 1 4
lstQuarter
四半期別の期間のデータを保有する配列。前の lstMonth を参照してください。
Siebel レポートガイド
バージョン 6.0
Reports.book
15 ページ
２００１年４月２７日　金曜日　午前１１時２７分
売上予想レポート
売上予想レポートプロセスの概要
„
lstYear
年別の期間のデータを保有する配列。lstMonth を参照してください。
追加変数 ( レポートまたは売上予想モデルに固有の）は、レポートデザインで
ローカルにデータ行に追加されます。そのため、売上予想レポートのデザインと
コード化が簡易化されます。
foDataRow ライブラリコンポーネントが AcDataRow のスーパークラスによって
定義された場合でも、このライブラリコンポーネントからデータ行がレポートデ
ザインに取り込まれた後で、そのスーパークラスを foDataRow に変更する必要
があります。これは、必要なメソッドと変数が継承されるようにするためです。
また、Period_Id 変数のローカルコピーを foDataRow コンポーネントのローカル
コピーから削除して、ローカルコピーではなく、スーパークラスで宣言された期
間 ID が使用されるようにします。
前に説明したように、foDataRow コンポーネントはデフォルトで宣言された変数
を持っています。スーパークラスとして foDataRow を持つ個人売上予想のデー
タ行は、これらの変数を継承します。個人売上予想のデータ行がインスタンス化
され、データとともに配置されると、標準変数が通常の Fetch コードによって入
力されます。AcList 配列は、foDataRow から継承される他の非リスト変数と同
様、foDataSource コンポーネントのコードによって入力されます。
データ行で使用される lstMonth、lstQuarter、および lstYear の各変数は、Period
ビジネスコンポーネントからロードされる変数と混同しないようにします (11-12
ページの「期間情報のロード」で説明しています )。Period ビジネスコンポーネ
ントのリストは、期間 ID を実際の月、四半期、または年に分類するために使用
できる期間のマスターリストで、売上予想データは含まれません。期間のマス
ターリストは、その完全修飾名、たとえば foPeriodQuery::lstMonth を使用して指
定できます。売上予想データ行に表示されるリストは、DynPerColumn の要素で
構成され、foDataRow を使用して指定できます。
バージョン 6.0
Siebel レポートガイド
1 1- 1 5
Reports.book
16 ページ
２００１年４月２７日　金曜日　午前１１時２７分
売上予想レポート
既存の売上予想レポートの検討
既存の売上予想レポートの検討
K
売上予想レポートの設定についてより詳しく学習するには、このタイプの標準の
Siebel レポートを開くと役立ちます。学習目的で使用するのに最適なレポートは
月別売上予想レポートです。このレポートは [ 売上予想 ] 画面のビュー ( 通常は
[ 売上予想 ( チーム )] ビュー ) から呼び出されます。レポート出力を Siebel Sales
で、レポートデザインを Actuate Developer Workbench で検討し、両方を開いた状
態にして比較します。
月別売上予想レポートを Siebel Sales で生成するには
1 Siebel Sales を起動します。
2 タブバーから [ 売上予想 ] を選択します。
[ 売上予想 ( チーム )] ビューが表示されます。
3 メニューバーから [ レポート ] → [ 売上予想 ] の順に選択します。
11 - 1 6
Siebel レポートガイド
バージョン 6.0
Reports.book
17 ページ
２００１年４月２７日　金曜日　午前１１時２７分
売上予想レポート
既存の売上予想レポートの検討
図 11-4 に示すように、月別売上予想レポートがレポートビューアに表示され
ます。
図 11-4
月別売上予想レポート
このレポートは特定の個人に関するすべての売上予想のデータを収集し、その
データを数ページにわたって全月別売上予想、全四半期別売上予想、全年別売上
予想の順に表示します。
バージョン 6.0
Siebel レポートガイド
1 1- 1 7
Reports.book
18 ページ
２００１年４月２７日　金曜日　午前１１時２７分
売上予想レポート
既存の売上予想レポートの検討
月別売上予想レポートのレポートデザインを開くには
1 Actuate Developer Workbench を起動します。
2 メニューバーから [ ファイル ] → [ 開く ] の順に選択します。
3 [ 開く ] ダイアログボックスで、C:¥Siebdev¥rptsrc¥enu¥standard フォルダ ( ま
たはそれに相当するフォルダ ) を検索し、[Fostag.rod] を選択します。
Actuate Developer Workbench に表示される Fostag.rod レポートデザインファイル
は図 11-5 に示されています。
図 11-5
月別売上予想レポートデザイン
レポートデザインを検討し、デザイン要素をレポート出力の対応する機能と比較
し、コンポーネントを右クリックしてプロパティのリストを表示します。
11 - 1 8
Siebel レポートガイド
バージョン 6.0
Reports.book
19 ページ
２００１年４月２７日　金曜日　午前１１時２７分
売上予想レポート
既存の売上予想レポートの検討
レポートの 3 つのセクションが、連続する 2 セクションの下に構成されているこ
とを確認してください。この構成は図 11-6 に示されています。
Report Design
Data Acquisition Sequential
Section (ssSeq1)
Period Loading Report
Section (ssRptPeriod)
Period Loading DataStream
(foPeriodQuery)
Person Loading Report Section
(ssRptPersonDataStream)
Person Loading
DataStream (Person)
Output Sequential Section
(ssSeqFormattedOutput)
Output Report Section
(FormattedOutput)
Output DataStream
(PersonList)
Page Header
Content
図 11-6
単純な売上予想レポートの構造 (Fostag.rod)
Fostag.rod (ssSeq1) の最初の順次セクションには、印刷せずにデータを取得する
レポートセクションの ssRptPeriod と ssRptPersonDataStream が存在します。2 番
目の順次セクション、ssSeqFormattedOutput には、レポートセクションの
FormattedOutput— が存在します。これはグローバルリストからレコードを取り込
み、レコードを処理し、レポートの見出しと行を印刷します。3 つのレポートセ
クションの ssRptPeriod、ssRptPersonDataStream、FormattedOutput は個別のサブセ
クションで説明されています。
バージョン 6.0
Siebel レポートガイド
1 1- 1 9
Reports.book
20 ページ
２００１年４月２７日　金曜日　午前１１時２７分
売上予想レポート
既存の売上予想レポートの検討
期間をロードするレポートセクション
K
ssSeq1 の順次セクション (ssRptPeriod) の最初のレポートセクションには、Period
ビジネスコンポーネントからレコードが取り込まれます。11-12 ページの「期間
情報のロード」で説明したように、このときにマスター期間レコードがインポー
トされ、その期間レコードは 3 つの作業リスト、lstMonth、lstQuarter、lstYear に
分類されます。
子データストリームコンポーネント、foPeriodQuery の [ コンポーネントエディ
タ ] ウィンドウを開きます。[ メソッド ] タブをクリックして [Fetch method] をダ
ブルクリックします。どのように各期間レコードが取得され、日付フィールドが
再フォーマットされ、レコードが AddToList メソッドに渡されるかを確認しま
す。[Fetch method] を閉じて、[AddToList] をダブルクリックします。プログラム
コードによって、どのように期間レコードが ssPeriod_Type_Lov_Name 別に分類
され、lstMonth、lstQuarter、または lstYear リストで AddToTail 処理が実行される
かを確認します。
個人をロードするレポートセクション
K
ssSeq1 の順次セクションの 2 番目のレポートセクション (ssRptPersonDataStream)
には、Person ビジネスコンポーネントからレコードが取り込まれて、グローバル
リスト構造に保存されます。第 8 章「メモリ内のレコードのソート」に説明され
ているように、これはメモリソートレポートのプロセスと同じです。ただし、
AcList 変数は最上位のレポートデザインコンポーネントではなく、変数をロード
するデータストリームで定義されます。Person ビジネスコンポーネントから取り
込まれたそれぞれのレコードは、Person データストリームコンポーネントで定義
された gPerson リスト変数に保存されます。
Person データストリームコンポーネントの [ コンポーネントエディタ ] ウィンド
ウを開きます。[ 変数 ] タブに gPerson という名前の AcList 変数があることを確
認します。そのほかに、ssM_P_Oppty_Fcst、ssManaged_Person_Forecast、
ssOpportunity_Forecast、ssPerson_Forecast という 4 つのオブジェクト変数があり
ます。これらの変数はそれぞれ、管理された個人の商談別売上予想、管理個人売
上予想、商談別売上予想、個人売上予想の詳細リストの保存に使用されます。
11 - 2 0
Siebel レポートガイド
バージョン 6.0
Reports.book
21 ページ
２００１年４月２７日　金曜日　午前１１時２７分
売上予想レポート
既存の売上予想レポートの検討
備考 : ssRptPersonDataStream レポートセクションの Person データストリームに
は、通常はデータストリームではなくデータフィルタと考えられているデータ
ソースシンボルが使用されます。これは、すべての売上予想データストリーム
が、AcDataSource ではなく (ssFcast.rol にある )foDataSource に由来しているから
です。foDataSource コンポーネント自体、AcMemoryBuffer コンポーネントから
派生したものです。
[ クラス ] タブで、スーパークラスが AcDataStream ではなく、foDataStream であ
ることを確認します。売上予想レポートで使用されるすべてのデータストリーム
はマニュアルでコード化されています。それぞれの静的フィールドからデータを
ロードするためのデータ供給ライブラリコードは Siebel Tools で生成できますが、
それ以外のすべてのコードは、生成されたデータストリームがスーパークラスと
して foDataSource を使用するように変更されたときに継承されます。その後、開
発者がデータストリームにさまざまな変更を加えて、foDataSource スーパークラ
スで使用できる各種のメソッドを呼び出せるようにします。
次のステップは、Person データストリームのコードによって実行されます。
1 マスター売上予想データにアクセスし、後で使えるように保存される。
2 Siebel Tools により生成された標準データストリームコードを使用して、静的
データが取り込まれる。
3 動的データが取り込まれ、各データ行のリスト変数に追加される。
4 動的データを、売上予想内のあらゆる期間別に対応できるように調整する。
5 データ行がグローバルリスト変数に追加される。
6 マスター期間リストが、実際に売上予想で使用される期間に適合するように
一部削除される。
これらの各ステップの詳細について、次に説明していきます。
バージョン 6.0
Siebel レポートガイド
1 1- 2 1
Reports.book
22 ページ
２００１年４月２７日　金曜日　午前１１時２７分
売上予想レポート
既存の売上予想レポートの検討
マスター売上予想データへのアクセスと保存
Fostag.rod などの単純な売上予想レポートには、反復機能がなく、Person の詳細
な売上予想ビジネスコンポーネントは使用されません。単純なレポートでは、マ
スター売上予想を使用する必要がないので無視できます。新規ビジネスオブジェ
クトインスタンスを作成する反復売上予想では、マスター売上予想の行 ID を収
集し、保存する必要があります。そうしないと、新規ビジネスオブジェクトが同
じマスター売上予想を使用できません。反復使用されるレポートでのデータ取得
の詳細については、11-39 ページの「反復データの取得」を参照してください。
単純な売上予想レポートの次のコードについては、個人データストリームのロー
ド ( この場合は [Person]) の開始メソッドでコメントされています。
'
If (errCode = 0) And (bReExecute) Then
'
' To re-execute a current-row-only report, the active
'
' BusComp need not be disturbed.Another BusObj can
'
' be constructed just for this query.
'
If (bCurRowOnly) And (ssReport::ssBusObjectName = "") Then
'
' Cache the current row-id so it can be re-queried
'
mainRowId = ssPerson_Forecast.GetFieldValue ("Id", errCode)
'
If (errCode = 0) Then busObjName = ssBO.Name (errCode)
'
If (errCode = 0) Then Set ssPerson_Forecast = Nothing
'
If (errCode = 0) Then Set ssBO = Nothing
'
If (errCode = 0) Then Set ssBO = ssAppServer.GetBusObject
(busObjName, errCode)
'
If (errCode = 0) Then Set ssPerson_Forecast = ssBO.GetBusComp
("Person Forecast", errCode)
'
If (errCode = 0) Then ssPerson_Forecast.SetViewMode (3,
errCode)
'
End If
'
End If
静的売上予想データの取得
静的売上予想のフィールドは Siebel Tools を使用して定義され、変更されるまで
は初期データ供給ライブラリとして生成されます。これとは対照的に、動的売上
予想フィールドには期間に関連するデータが含まれ、フィールド数はさまざま
で、Quarter04Revenue などの名前を持っています。
静的売上予想フィールドは、データストリームの開始メソッドに対する
IsFieldActive コールと ActivateField コール、Fetch メソッドにおける GetFieldValue
コールのほか、さまざまなエラーテストコードを提供します。データ供給ライブ
ラリコードを変更した後は、データ供給ライブラリを自動生成したり、新しい名
前で生成することで、前に行われたコードの変更を上書きしないように注意する
必要があります。
11 - 2 2
Siebel レポートガイド
バージョン 6.0
Reports.book
23 ページ
２００１年４月２７日　金曜日　午前１１時２７分
売上予想レポート
既存の売上予想レポートの検討
再生成せずにデータストリームに静的フィールドを追加するには
1 静的フィールドを変数としてデータ行コンポーネントに追加します ( データ
ストリームとデータ行をローカルサブクラス化する必要があります )。
2 フィールドの初期化コードを開始メソッドに追加します ( テンプレートに既
存のコードを使用します )。
3 取得コードを Fetch メソッドに追加します ( もう一度、テンプレートに既存
のコードを使用します )。
一般的に、売上予想レポートに必要なほとんどの静的フィールドは、すでに標準
のデータストリームレポートに定義されています。
動的売上予想データの取得
動的売上予想データは期間に関するデータです。それぞれの売上予想に含まれる
期間数は可変で、管理者によって設定されます。動的売上予想データは Fetch メ
ソッドの実行時に取り込まれて、静的データの取得後にデータ行、lstMonth、
lstQuarter、lstYear のリスト変数の値として読み込まれます。動的データの取得
のロジックは ProcessDynamicColumns の機能にあり、Fetch メソッドによって
データストリームに呼び出されます。
ProcessDynamicColumns は、売上予想レコードの処理を行うためのさまざまな特
殊メソッドとともに、Person データストリームコンポーネントのスーパークラ
ス、ssFcast.rol ライブラリにある foDataSource にロードされます。これらのメ
ソッドの内容を参照するには、ライブラリブラウザにある ssFcast.rol を起動し
て、[ ライブラリ ] ウィンドウで [foDataSource] を右クリックし、参照したいメ
ソッドをダブルクリックします。
ProcessDynamicColumns は静的フィールドの値とともにロードされたデータ行を
取得し、期間範囲の開始日と終了日を生成し、リスト変数を配置します。特に、
次のステップが実行されます。
1 GetDateRange を呼び出し、期間開始 ID および終了 ID を、期間の開始日と終
了日の日付に変換します。
2 このローのパラメータをデータに追加して、SetOverallDates のコールによっ
てレポート全体の開始日と終了日を取得できるようにします。
3 行の lstMonth、lstQuarter、lstYear のそれぞれのリスト変数を、PopulateList の
コールによって入力します。
バージョン 6.0
Siebel レポートガイド
1 1- 2 3
Reports.book
24 ページ
２００１年４月２７日　金曜日　午前１１時２７分
売上予想レポート
既存の売上予想レポートの検討
PopulateList 機能に月、四半期、または年の値が受け渡され、どのリストが入力
されたかを示します。次のステップが実行されます。
1 新しい AcList の初期化します。
2 必要なリスト項目数を計算します。これは開始日から終了日までの間に存在
する、指定されたタイプの期間数に基づく、データの期間数です。
3 指定された期間タイプのそれぞれの動的フィールドを使用して、その期間に
関するデータを取得し、GetDynPerCol を呼び出すことによりデータを新規リ
スト項目に保存を反復します。
4 Total の引数の値によって GetDynPerCol を呼び出すことにより、合計値のリ
スト項目を追加します。
5 データ行を lstMonth、lstQuarter、または lstYear として保存するために、
AcList 構造を ProcessDynamicColumns に戻します。
初期入力データ行の一連の動的カラムがフラット構造に表示されます。それぞれ
のカラムは、期間タイプ、期間番号、および Revenue、FuncRevenue、Quantity、
または Price の接尾辞 ( 後の 2 つは製品別または商談製品別売上予想データにの
み使用 ) で構成される名前によって識別されます。月の期間タイプは Period と呼
ばれます。四半期および年のタイプは Quarter、Year と呼ばれます。これらの動
的カラム名の例は、Period01Revenue および Quarter06FuncRevenue です。この
データは処理時に動的カラムとして使用できません。
11 - 2 4
Siebel レポートガイド
バージョン 6.0
Reports.book
25 ページ
２００１年４月２７日　金曜日　午前１１時２７分
売上予想レポート
既存の売上予想レポートの検討
PopulateList コードは動的カラムデータを AcList 項目に移動します。各項目には 5
つの項目フィールド Value、FuncValue、Quantity、Price、ValType があります。
ValType はデータを直接取得せず、項目が詳細 ( 価格データと数量データを含む )
か要約かを示します。このフォームでは、データは 1 つの期間タイプのみに関す
るデータを含む 2 次元配列で示され、すぐに処理できます。この変換は図 11-7 に
示されています。
入力データ行構造
静的
静的
フィールド フィールド
1
2
Quarter01
Revenue
Quarter01
FuncRevenue
Period01
Revenue
Period01
FuncRevenue
Year01
Revenue
処理済データ行構造
静的
静的
フィールド フィールド
1
2
図 11-7
lstMonthリスト
lstQuarterリスト
lstYearリスト
M
Revenue
Func.Rev
Q
Revenue
Func.Rev
Y
Revenue
01
$x,xxxx
$x,xxxx
01
$x,xxxx
$x,xxxx
01
$x,xxxx
02
$x,xxxx
$x,xxxx
02
$x,xxxx
$x,xxxx
02
$x,xxxx
03
$x,xxxx
$x,xxxx
03
$x,xxxx
$x,xxxx
03
$x,xxxx
リストデータ変換へのフラットデータ
ProcessDynamicColumns 処理の次に、AddRow と AddRowToBuffer を呼び出しま
す。AddRow は、処理の後のデータストリームに行を追加する標準的なメソッド
です。AddRow 機能は、Position 変数とその他のマイナーな処理機能を変更すると
きに使用します。Position 変数は Actuate の組み込み変数で、取り込まれた行を追
跡するために使用します。取り込まれた最初の行の Position は「1」に設定されま
す。Position は、Fetch メソッドによって配置された各行に対して増加します。
バージョン 6.0
Siebel レポートガイド
1 1- 2 5
Reports.book
26 ページ
２００１年４月２７日　金曜日　午前１１時２７分
売上予想レポート
既存の売上予想レポートの検討
AddRowToBuffer は、AFC.rol の AcMemoryBuffer コンポーネントに表示され、
foDataSource のスーパークラスとなります。AddRowtoBuffer コールは、現在の行
を、このデータストリームに対して保存される Rows () という行のバッファに追
加するときに使用されます。これを行う理由は、すべてのデータ行は取得後に追
加処理が必要となるからです。この機能によって、取得されたそれぞれの行が後
で処理できるようにメモリに残されます。
期間別に動的データを調整する
それぞれの個人行には 1 つの売上予想が含まれます。これは月、四半期、およ
び年別に予想される一連の売上額です。これらの売上額は期間が重複している
ことがよくあります。たとえば、1 つの売上予想では、3、4、5 月の月別売上額
が予想され、別の売上予想では 4、5、6、7 月の売上額が予想さることがありま
す。これは、11-17 ページの図 11-4 に示されるように、月別売上予想レポート
出力を表示して、参照できます。同じことが、四半期と年の期間に対しても起
こります。
さまざまな期間のデータを 1 つのフォームに構成して、簡単に合計したり、1117 ページの図 11-4 に示されるような配置で表示できるようにするには、それぞ
れの個人行内の期間データリストを埋めて、それぞれの行がデータだけでなく期
間のフルセットを含むようにする必要があります。パディングのない月リスト
データは、図 11-8 に示されています。
個人売上予想 1
個人売上予想 2
lstMonthリスト
個人売上予想 3
lstMonthリスト
lstMonthリスト
Mon
Revenue
Func.Rev
Mon
Revenue
Func.Rev
Mon
Revenue
Func.Rev
Jan
$x,xxxx
$x,xxxx
Feb
$x,xxxx
$x,xxxx
Apr
$x,xxxx
$x,xxxx
Feb
$x,xxxx
$x,xxxx
Mar
$x,xxxx
$x,xxxx
May
$x,xxxx
$x,xxxx
Mar
$x,xxxx
$x,xxxx
Apr
$x,xxxx
$x,xxxx
Jun
$x,xxxx
$x,xxxx
May
$x,xxxx
$x,xxxx
Jul
$x,xxxx
$x,xxxx
図 11-8
パディングのない月データ
11 - 2 6
Siebel レポートガイド
バージョン 6.0
Reports.book
27 ページ
２００１年４月２７日　金曜日　午前１１時２７分
売上予想レポート
既存の売上予想レポートの検討
すべての未使用の期間に対して各個人行の各リストに項目を追加することによ
り、データがデータストリーム行に配列されて、計算と表示プロセスが簡単にな
ります。3 つの個人レコード内のパディングのある月リストは、図 11-9 に示さ
れています。
個人売上予想 1
個人売上予想 2
lstMonthリスト
個人売上予想 3
lstMonthリスト
Mon
Revenue
Func.Rev
Mon
Jan
$x,xxxx
$x,xxxx
Jan
Revenue
Func.Rev
Feb
$x,xxxx
$x,xxxx
Feb
$x,xxxx
$x,xxxx
Feb
Mar
$x,xxxx
$x,xxxx
Mar
$x,xxxx
$x,xxxx
Mar
Apr
Apr
$x,xxxx
$x,xxxx
Apr
$x,xxxx
$x,xxxx
May
May
$x,xxxx
$x,xxxx
Jun
Jun
May
$x,xxxx
$x,xxxx
Jun
$x,xxxx
Jul
$x,xxxx
Jul
Jul
$x,xxxx
$x,xxxx
Aug
Aug
Aug
Sep
Sep
Sep
図 11-9
Revenue
lstMonthリスト
Func.Rev
Mon
Jan
パディングのある月データ
空のリスト項目がリストに作成されます。このリスト項目は、該当する不明の期
間と Fill の ValType フィールド設定を識別する期間番号を持っています。これ
は、項目が含むデータに対する Detail または Total の値と対照的です。それぞれ
の不明の期間に対して 1 つの入力項目がリストに作成されます。
現在の個人行のリストのパディングは AdjustDynPerColLists 機能で実行され、デー
タストリーム (Person) の Fetch メソッドによって呼び出されます。
AdjustDynPerColLists は foDataSource スーパークラス内に保存されています。
gPersonList リストには引数が受け渡されます。zPersonList は Person データスト
リームコンポーネントの AcList 変数として定義されます。最初に
AdjustDynPerColLists に受け渡されたときは空で、11-28 ページの「グローバルリス
ト変数への行の追加」で説明されるように、AdjustDynPerColLists 処理の最後に、
一連の個人のレコード内の月、四半期、年の各リストのデータが入力されます。
バージョン 6.0
Siebel レポートガイド
1 1- 2 7
Reports.book
28 ページ
２００１年４月２７日　金曜日　午前１１時２７分
売上予想レポート
既存の売上予想レポートの検討
グローバルバッファー Rows () にあるすべての行の論理ループによって、個人行
が抽出され、データを持つ 3 つのリストが埋められます。リストのパディング
は、データを持つ期間の前後に存在するデータを持たない月、四半期、年の数を
計算することにより、完成します。次に、入力項目の必要数が、PadHead のコー
ルによってリストの一番上に追加され、PadTail のコールによってリストの一番
下 (Total 項目の上 ) に追加されます。
グローバルリスト変数への行の追加
AdjustDynPerColLists 機能の 2 番目の役割は、各行の月、四半期、年のリストに
データをパディングした後で、空のグローバルリスト構造、gPersonList を埋め
ることです。
行はすでにバッファーのデータソースに存在しているため、グローバルリストに
行を追加すると二度手間になります。ただし、管理個人リスト内のデータによっ
て反復クエリーが必要となる場合は、反復処理が実行できるようにグローバルリ
スト構造が必要になります。
単純な反復処理の例は、1 人のマネージャ山下と直属の部下の川中と大海の構成
です。最初のビジネスオブジェクトインスタンスによって、山下の個人売上予想
情報が戻されます。さらに、このビジネスオブジェクトは、川中と大海を示す、
詳細な管理個人売上予想にアクセスします。次に、川中と大海の個人情報を取得
するために、それぞれに対する 2 つの追加ビジネスオブジェクトがインスタンス
化されます。
データが表示されたときに、すべての個人データが 1 か所に集められているはず
です。バッファ機能をデータソースで実行する場合は、それぞれのデータソース
にアクセスしてデータを取得しなければなりません。すべてのデータがグローバ
ルリストに保存されていれば、そのリストの行にアクセスするだけですみます。
川中と大海の個人データストリームは、山下のデータソースにあるリストを示す
必要があります。この概念は 11-39 ページの「反復データの取得」に示されてい
ます。
各ビジネスコンポーネントは、売上予想行の個別リストを持っています。たとえ
ば、すべての個人売上予想は 1 つのリスト (gPersonList) に存在し、すべての商談
別売上予想は別のリスト (gOpportunityList) に存在します。それぞれのグローバ
ルリストは、foDataSource ではなく、レポートデザインのデータソースコンポー
ネントで定義された変数です。さらに、リスト変数を初期化するためのコードも
データソースの開始メソッドに表示されます。
11 - 2 8
Siebel レポートガイド
バージョン 6.0
Reports.book
29 ページ
２００１年４月２７日　金曜日　午前１１時２７分
売上予想レポート
既存の売上予想レポートの検討
gPersonList をロードするための AdjustDynPerColLists 内のコードは、各個人行の
月、四半期、年のリストを埋めるバッファのループと同じループに発生します。
個人行のパディングが完了した時点で、その個人行が gPersonList に追加されま
す。gPersonList には、最初にデータストリームに入力されたときと同じフォー
マットの個人行が含まれますが、それぞれのデータは適切に処理されてその行の
期間リストに入力され、期間リストが埋められます。
マスター期間リストの一部削除
データ取得プロセスの最後のステップで、3 つのマスター期間リストを一部削除
して、売上予想で実際に使用される期間だけを残します。マスター期間リストに
は、各期間の言語独立タイトルが含まれます。これらのタイトルは、データを表
示するときにレポートカラムタイトルとして役立ちます。
期間タイトルと期間データを関連付けるための出力レポートセクションのコード
化が複雑になるのを避けるため、マスター期間リストを一部削除します。たとえ
ば、マスター月別リストの 5 番目の行が各個人の月別データの 5 番目の行と同じ
月に使用されるようにします。
この処理は、各個人行で実行されるパディングと似ていますが、方向が逆になり
ます。このロジックは、不完全な期間データリストを埋めるのではなく、個人の
レコード内の期間範囲の前後に存在する期間をマスター期間リストから削除する
ことです。
マスターリストの一部削除のステップは、個人データストリームの終了メソッド
で実行されます。Fostag.rod のような単純な売上予想レポートには、各詳細ビジ
ネスコンポーネントの詳細レコードをロードする子データストリームはありませ
ん。ただし、それよりも複雑な売上予想レポートには存在します。個人データス
トリームの終了メソッドでのマスターデータストリームの一部削除では、一部削
除が行われる前にこれらのリストを使用するすべての処理が完了するようになっ
ています。
レポートデザインにおけるデータストリームの終了メソッドに直接コードを挿入
する必要はありません。その代わり、LastQueryToFinish プロパティが
foDataSource コンポーネントに含まれています。最初のプロパティ設定は FALSE
です。データソースの LastQueryToFinish プロパティを TRUE に設定すると、
TrimPeriodList 機能が foDataSource の終了メソッド内に呼び出されます。
Fostag.rod では、個人データソースコンポーネントのプロパティリストでこのプ
ロパティが TRUE に設定されています。1 つの入力データソースでこのプロパ
ティを TRUE に設定し、それ以外のデータソースでは FALSE に設定する必要が
あります。
バージョン 6.0
Siebel レポートガイド
1 1- 2 9
Reports.book
30 ページ
２００１年４月２７日　金曜日　午前１１時２７分
売上予想レポート
既存の売上予想レポートの検討
foDataSource ライブラリコンポーネントのその他のプロパティ
foDataSource コンポーネントの他の 3 つのプロパティは、売上予想データスト
リームの動作を定義するときに使用します。
„
OneRowOnly
OneRowOnly プロパティは、戻されるデータの行数を設定するために使用し
ます。一般的に、商談別、製品別、または商談製品別の詳細データを取得す
る場合、個人売上予想は 1 つのデータの行だけを戻します。複数の個人売上
予想のデータを比較する期間別売上予想では、複数の個人行が必要です。前
の例では、OneRowOnly を TRUE に設定し、あとの例では OneRowOnly を
FALSE に設定します。
„
LabelTotal
LabelTotal プロパティは、データの表示に使用します。前に説明したように、
カラムの見出しはマスター期間リストから取得される、言語独立コードです。
各期間データリストの合計リスト項目は、マスター期間リストのリスト項目
とは関連しません。英語以外の言語で売上予想レポートを実行する場合、
LabelTotal プロパティを foDataSource ライブラリコンポーネントで、Total に
相当するローカル言語に設定してください。
„
GetDetailData
GetDetailData は、製品情報 ( 数量と価格 ) を取得するために使用します。数
量および価格のリスト項目フィールドは、個人または商談別売上予想には適
用されません。効率性の理由から、これらのフィールドはデフォルトでは取
得されません。製品別または商談製品別のデータソースを扱うときは、この
プロパティを TRUE に設定して、foDataSource コンポーネントがすべての可
能なフィールドをフェッチするようにします。
出力レポートセクション
K
ssSeqFormattedOutput の順次セクションには、出力の生成に使用されるレポート
セクションが含まれます。Fostag.rod レポートの場合は、1 つのビジネスコン
ポーネントだけが必要なので、レポートの表示部分では 1 つのレポートセクショ
ンだけが使用されます。
売上予想データを表示する手順は、データを取得する際のプロセスよりはるかに
簡単です。売上予想データを表示するには、5 つのキーとなるデザイン戦略を理
解する必要があります。これらのデザイン戦略を用いて、売上予想レポートの動
作を変更します。次に、デザイン戦略のリストを示し、それぞれの役割について
簡単に説明します。
11 - 3 0
Siebel レポートガイド
バージョン 6.0
Reports.book
31 ページ
２００１年４月２７日　金曜日　午前１１時２７分
売上予想レポート
既存の売上予想レポートの検討
„
売上予想データ行の取得
レポート生成の最初のタスクは、データ取得レポートセクションに用意され
ているデータにアクセスすることです。そのために、ssFcast.rol ライブラリ内
の foListDataSource コンポーネントが使用されます。
„
動的レポートの作成
売上予想レポートは次の 3 つの異なる方法でデータを表示します。月別、四
半期別、年別。各レポートタイプのレポートのレイアウトは通常同じです。
ただ 1 つの違いは、使用されるデータ ( つまり、データ行でどの期間リスト
が使用されるか ) です。動的レポートの作成は、レポートセクションを再使
用して、期間タイプに基づいてそれぞれに異なるデータを提供します。その
際に、ssFcast.rol ライブラリ内の foSeq コンポーネントが使用されます。
„
動的カラムの作成
最初に取得されたときの売上予想データ行に含まれる期間数は不明です。各
期間は通常、印刷されたレポート上の 1 つのカラムに対応しています。カラ
ムを表示するには、カラムをデザイン時に作成するか、実行時に動的に作成
する必要があります。デザイン時に必要なカラム数を予測することは、実用
的とはいえません。売上予想レポートは比較的単純な技術を使用して、標準
のテキストコントロールを変更し、動的にレポートを複製したり、即座に新
しいカラムを作成したりできるようにします。その場合に、foTxtV と
foTxtHeaderV のコンポーネントが使用されます。
„
カラムラッピング
カラムラッピングを使用すると、複数のページにまたがるカラムを持つレ
ポートが Actuate によって表示されます。この機能は、foSeq および foTxtV
のコンポーネントに組み込まれています。
„
リスト変数に含まれるデータの集計
標準の Actuate レポートでは、簡単に集計データを表示するコントロールを作
成できます。データは、リスト変数内のリスト項目に埋め込まれているので
はなく、各データ行の単純なフィールドに入っているからです。データがリ
スト変数の項目内にある場合、合計を実行するには特別なコード化が必要で
す。ssFcast.rol ライブラリには、ある期間のデータの集計を簡易化するように
設計された foTxtSumV および foSumFrm のコンポーネントが含まれています。
それぞれのデザイン戦略の実施について、次のサブセクションで説明します。
バージョン 6.0
Siebel レポートガイド
1 1- 3 1
Reports.book
32 ページ
２００１年４月２７日　金曜日　午前１１時２７分
売上予想レポート
既存の売上予想レポートの検討
リストからの売上予想データフローの取得
データ取得セクションに用意された、各ビジネスコンポーネント用のそれぞれの
売上予想データリストはデータ行で構成されています。したがって、リスト内を
移動し、それぞれの行を現在のデータストリームに割り当てるのは簡単です。こ
の技術は頻繁に使用されるため、すぐにアクセスできるように、
foListDataSource コンポーネントにカプセル化されています。
それぞれの出力レポートセクションは、ssFcast.rol 内の foListDataSource から下位
分類されたデータストリームを使用します。Fostag.rod (FormattedOutput) 内の出力
レポートセクションが 1 つの場合、このデータストリームは PersonList です。
スーパークラスの Fetch メソッドはレポートデザイン時に上書きされて、コード
が追加されます。このコードはアクセスするリストを識別し、Set
Fetch=Super::Fetch 式の curList パラメータにある名前を受け渡します。標準の
Actuate ビルドプロトコルによって、ビルドのプロセス時に Fetch が呼び出され
ます。foListDataSource の Fetch メソッドは上書きされ、パラメータとしてリス
ト変数を受け取ることができます。
スーパークラスの Fetch ロジックによって、Position 変数により識別された指定
リスト内の行が取り込まれます。Position は 1 からスタートし、AddRow が呼び
出されるたびに増加します。AddRow メソッドが呼び出された後、AddToBuffer
も呼び出されて、今後発生しうる処理のために行が保存されます。
動的レポートの作成
一般的に、売上予想レポートは一度に 1 つの期間タイプのデータの月別データ、
四半期別データ、または年別データだけを表示します。基本的なレポートレイア
ウトは、すべてのレポートで共通しています。ただ 1 つの違いは、表示される期
間タイプです。同じレポートセクションが 3 回実行されます。lstMonth、
lstQuarter、lstYear の各リストのデータを使用します。
これを実行するために、3 つのレポートセクションを使用できます。この技術の
欠点は、それぞれ 3 つのコントロールタイプが存在することです ( 出力レポート
セクションも 3 倍になるため、複雑な売上予想レポートでは煩雑になります )。
レポートセクションの動作を変更すれば、動的に再作成し、各データタイプを 1
回だけ表示するようにできます。この機能は、レポートセクションを含む順次セ
クションで実行できます。
11 - 3 2
Siebel レポートガイド
バージョン 6.0
Reports.book
33 ページ
２００１年４月２７日　金曜日　午前１１時２７分
売上予想レポート
既存の売上予想レポートの検討
ssFcast ライブラリ内の foSeq コンポーネントはこの動作を実行するように設計さ
れています。NewContent メソッドは、順次セクションのコンテンツスロットに
存在するレポートセクションをインスタンス化するためのメソッドです。通常、
順次セクションにはレポートセクションのリストがあり、それぞれを順に、一度
に 1 つずつビルドします。このデフォルトの動作は、同じコンポーネントを 3 回
ビルドするように変更されます。foSeq コンポーネントは、レポートデザインを
変更することなくこの機能を実行できます—この機能はレポートデザインに組み
込まれています。
NewContent コード内のコードを変更して、カスタムの動作を作成できます。デ
フォルトの動作を変更したい開発者は、既存の foSeq コンポーネントを変更する
か、まったく異なる動作を使用して新たに順次セクションを作成できます。
期間タイプは、グローバル変数、ReportPeriod を介して、順次セクションとレ
ポートセクション間で伝達されます。グローバル変数は、[ ファイル ] → [Basic
ファイルのインクルード ] オプションを使用して売上予想レポートデザインに
ロードされた ssFcast.bas モジュールで宣言されます。次の変数は、順次セクショ
ンとレポートセクション間での情報伝達に使用されます。
„
NextColPosition
いくつのカラムが処理されたかを判断するときに使用されます。
„
StartCol
すでに処理されたカラム数に基づいて、開始するカラムを決定します。
„
ReportPeriod
レポート期間として月、四半期、または年を設定します。
動的カラムの作成
データコントロールの動的な生成は複雑なプロセスですが、レポートを作成する
必要はありません。プロパティ設定を除いて、既存のコントロールセットを変更
せずに使用できます。ここでは、コントロールのハイレベルの役割について説明
した後、コントロールの動作を変更するためのプロパティの使用について説明し
ます。
バージョン 6.0
Siebel レポートガイド
1 1- 3 3
Reports.book
34 ページ
２００１年４月２７日　金曜日　午前１１時２７分
売上予想レポート
既存の売上予想レポートの検討
売上予想レポートで使用される基本的な動的データコントロールは 2 つありま
す。foTxtV コントロールは、実際のデータ値を参照するときに使用し、
foTxtHeaderV コントロールはヘッダー情報を表示するときに使用します。これ
らのコントロールの動作は似ています。動的データコントロールの処理ステップ
は次のとおりです。
1 デザイン時に 1 つのコントロールがフレーム内に配置されます。このコント
ロールのプロパティ ( サイズ、色、フォントなど ) は、このコントロールを
基に動的に作成される他のコントロールに適用されます。
2 BuildFromRow メソッドでは、順次セクションによりグローバル変数セットに
基づいてグローバルデータ行リストが選択されます。
3 BuildFromList メソッドは、データ行リストが選択されると呼び出されます。
BuildFromList メソッドでは、リスト内の情報に基づいて DataValue の値が設
定されます。
4 データ行リスト内により多くの項目が存在する場合は、AddNewColumn メ
ソッドが呼び出されます。AddNewColumn メソッドによって、フレーム内に
カラムを追加する余地があるかどうかがチェックされます。フレームに余地
がある場合は、元のデータコントロールと同一の新しいコントロールが作成
され、フレーム内に配置されます。
5 BuildFromList メソッドは新しいデータコントロール上に呼び出されて、プロ
セスが反復されます。
6 フレームにコントロールを追加する余地がない場合は、ビルドされた最後の
カラムが元のコントロールに戻されます。次に、元のコントロールからこの
番号がグローバルロケーションに移動します。順次セクションで、このグ
ローバルロケーション内のデータが使用され、同じデータソースでもう一度
レポートセクションを実行する必要があるかどうかが判断されます。
foTxtV コントロールは、DynPerColumn 要素内の売上金額を参照するように設計
されています。foTxtHeaderV コントロールは、適切なマスター期間リストを使
用して、言語独立の期間名を取得するように設計されています。
11 - 3 4
Siebel レポートガイド
バージョン 6.0
Reports.book
35 ページ
２００１年４月２７日　金曜日　午前１１時２７分
売上予想レポート
既存の売上予想レポートの検討
開発者は、3 つのプロパティレベルの変数を設定して、動的データコントロール
の動作を変更することができます。
„
AddToSumList
このプロパティは、動的期間リストに含まれるデータの集計値を作成すると
きに使用します。詳細は 11-37 ページの「リスト変数に含まれるデータの集
計」に説明されています。
„
IsDetailReport
このプロパティは価格、数量、売上データを表示するときに使用します。
IsDetailReport が TRUE に設定されると、foTxtVQuantity および foTxtVPrice と
いうデータコントロールが検索されます。これらのコントロールは foTxtV コ
ントロールとともに複製されます。foTxtV コントロールと同様、数量コント
ロールおよび価格コントロールのすべてのプロパティが動的に作成されたコ
ントロールに複製されます。
„
UseFunctionalValue
このプロパティは、同じコンテキストで複数の通貨が表示されている場合に
使用します。UseFunctionValue が TRUE に設定されると、表示されるデータ
は標準の売上金額ではなく、機能的な売上金額となります。機能的な売上は、
マシンのロケール設定に基づいて決定されます。
動的コントロールのプロパティ設定は、元の設定を模倣します。元のコント
ロールをフレームに配置して、適切な表示形式にフォーマットします。コント
ロールのサイズ、フォント、色は動的に作成されたすべてのコントロールで維
持されます。
Fostag.rod には、ページヘッダーとレポート本文のフレームにおける標準の動的
データコントロールの使用例が用意されています。DynamicRevenueHeader は、
ページヘッダーコントロール、foTxtV1 はレポート行の動的コントロールです。
レイアウトペインで、コントロールのサイズ、フォント、背景色の変更を試すこ
とができます。
Fopprod.rod には、詳細情報 ( 価格と数量 ) を表示する最も単純なレポートが用意
されています。Fopprod.rod と Foprods.rod のそれぞれの動的データコントロール
を比較して、商談製品別売上予想と製品別売上予想のレポートの違いを確認して
ください。特に、データコントロールを含むヘッダーコントロールのサイズに注
意してください。
バージョン 6.0
Siebel レポートガイド
1 1- 3 5
Reports.book
36 ページ
２００１年４月２７日　金曜日　午前１１時２７分
売上予想レポート
既存の売上予想レポートの検討
数量と価格の Content スロットデータコントロールは重複しません。売上コント
ロールは、3 つのコントロールの幅と同じサイズに設定されます。ヘッダーコン
トロールは、数量と価格を表示する場合に 3 つのすべてのコントロールが同じ
Position を持ち、異なる幅で右詰め表示するように設定されます。基本的に、こ
のコントロールは重複します。
Foexop.rod レポートには、リストデータ集計の典型例が含まれています。データ
集計に使用されるフレームは標準フレームと異なることに注意してください。動
的データの集計を作成する場合、コントロールで AddToSumList プロパティが
TRUE に設定され、foSumFrm フレームは集計データが表示されるフレームの中
で使用されます。
カラムラッピング
売上予想レポートには、幅が複数ページにわたるものもあります。これは売上予
想データの特性によるものです。どの期間タイプを指定した場合も、表示できる
期間数は無制限なため、レポートで表示できるカラム数は制限されません。
複数ページにわたるレポートの作成機能は、順次セクション (foSeq) コンポーネ
ントとテキストコントロールの foTxtV クラスを使用して実行できます。基本プ
ロセスは次のとおりです。
1 foSeq コンポーネントにより、どの行からスタートするかが foTxtV コンポーネ
ントに伝えられます。期間が未処理の場合は、カラム 1 からスタートします。
2 foTxtV コントロールでは、すべての期間を表示し終わるか、フレームのス
ペースがなくなるまで、フレームにコンポーネントが追加されていきます。
3 foTxtV コントロールは、追加するスペースがないカラム番号を foSeq セク
ションに通知するか、すべての期間が表示された場合にゼロ値を戻します。
4 foSeq コンポーネントによって、別の連続レポートセクションが作成されま
す。すべての期間が表示されると、NextColPosition = 0 および foSeq が次の期
間タイプに移動します。すべての期間が表示されていない場合は、同じ期間
のレポートが新しいカラム番号から作成されます。
11 - 3 6
Siebel レポートガイド
バージョン 6.0
Reports.book
37 ページ
２００１年４月２７日　金曜日　午前１１時２７分
売上予想レポート
既存の売上予想レポートの検討
foSeq 内の NewContent メソッドのコードからわかるように、2 つの変数はカラム
の位置と関係があります。StartCol は、レポートで扱われるカラム番号です。
NextColPosition は、レポートが失敗した個所を判別するために使用されるカラム
です。どちらの変数もグローバルな領域で使用され、ssFcast.rol ライブラリに関
連付けられた ssFcast.bas ファイルで宣言されます。変数はフレーム、コントロー
ル、または順次セクション上で使用することが望まれますが、ページヘッダーお
よびページフッターのフレームで使用する場合は、これらのコンポーネント間の
通信が難しくなることがあります。
foTxtV コンポーネントでは、StartCol 変数を使用して、処理を開始する個所が判
断されます。StartCol は、BuildFromRow メソッドで参照されます。また、コン
トロールの DataValue が設定された場合は、BuildFromList メソッドでも使用され
ます。AddNewColumn メソッドでは、別のコントロールを追加できるかどうか、
フレームのサイズが確認されます。
フレームに余地がない場合は、フレームに入りきれなかったカラム番号に
NextColPosition が設定されます。次に、foSeq セクションで、このカラム番号が
StartCol の位置として使用されます。
この技術では、幅にカラムが追加されるたびに各ページのすべての静的変数が反
復されます。レポートの最初のページに静的カラムのいくつか、またはすべてを
表示させる場合、StartCol 値を参照する静的コントロールにコードを追加する必
要があります。
StartCol が 1 よりも大きい場合、コントロールが表示されないように、
DetachFromContainer メソッドが呼び出されます。さらに、表示される静的カラ
ム数に従ってその Position.X 値が変更されるように、foTxtV BuildFromRow メ
ソッドのコードが変更されます。
リスト変数に含まれるデータの集計
レポート出力生成の最後のフェーズでは、データを集計します。一般的に、売上
予想レポートのデータは集計されません。商談別売上予想を実行する場合、すべ
ての商談の合計は、個人に対するロールアップ値と同等ではありません。一方、
個人売上予想には個人のロールアップ値が含まれ、それには、売上予想の変更や
他の売上予想 ( 管理個人売上予想や商談製品別売上予想など ) の情報を含められ
ます。
エグゼクティブ商談別売上予想の場合、ロールアップ値は使用できません。ロー
ルアップ値を概算する唯一の方法は、Actuate で使用可能な Sum () 関数を使用し
て、フレームの前または後のいずれかに合計を作成することです。
バージョン 6.0
Siebel レポートガイド
1 1- 3 7
Reports.book
38 ページ
２００１年４月２７日　金曜日　午前１１時２７分
売上予想レポート
既存の売上予想レポートの検討
フィールド名としてデータを使用できないため、結果が複雑になることがありま
す。通常、集計機能は Sum ("FieldName") として機能します。売上予想レポート
では、ValueExp プロパティは Sum ("ListName.GetAt(Period Num).Value") とほぼ同
じように表示される必要があります。このプロパティは Actuate ではサポートさ
れません。
それに変わるものとして、AddToSumList というプロパティが foTxtV コンポーネ
ントに追加されています。このプロパティが TRUE に設定されると、すべての
フィールドの値がグローバルリストに追加されます。
これらの値の合計には、foSumFrm コンポーネントと foTxtSumV コンポーネント
を使用してアクセスできます。これらのコンポーネントは、foTxtV コンポーネ
ントまたは foTxtHeaderV コンポーネントと同じ方法で使用します。ただ 1 つの
違いは、これらのコンポーネントがすでにグローバルリストに追加されている値
を表示する点です。
備考 : foSumFrm コンポーネントを使用せずに foTxtSumV コンポーネントを使用
することはできません。これら 2 つのコンポーネントは同時に使用する必要があ
ります。
既存の標準レポートでは、この機能は、UseFunctionalValue プロパティに基づい
て Value フィールドまたは FunctionalValue フィールドを合計するときにのみ使用
します。同様のロジックを用いて、数量フィールドの合計、平均価格フィールド
などをサポートするようにグローバルローを変更できます。これを実行する技術
については、本書では扱いません。熟練した開発者がこのプロセスを実行する際
には、BuildFromList メソッドに含まれるコードを参考にしてください。
11 - 3 8
Siebel レポートガイド
バージョン 6.0
Reports.book
39 ページ
２００１年４月２７日　金曜日　午前１１時２７分
売上予想レポート
反復データの取得
反復データの取得
K
反復データの取得は、さまざまなビジネスコンポーネントをドリルダウンする
ときに使用します。管理個人リストを反復実行する場合、必要な情報を収集す
るために既存のビジネスオブジェクトを使用することはできません。Actuate
は、Siebel ビジネスオブジェクトを動的にインスタンス化し、必要な情報を収
集します。
例として、上司の商談別売上予想 ( サンプルデータベースの KAKIMOTO) の場合
が挙げられます。KAKIMOTO は SIDE と YUEDA の部下の 2 つの売上予想レポー
トを保有し、SIDE と YUEDA はさらに部下の売上予想レポートを保有していま
す。KAKIMOTO の売上予想を実行した場合、KAKIMOTO 自身の売上予想に加え
て KAKIMOTO の部下全員の売上予想レポートが表示されるのが理想的です。
これを実現するには、次のプロセスを実行します。
1 現在のビジネスオブジェクトを使用して、KAKIMOTO の個人売上予想、商
談別売上予想、管理個人売上予想を取得します。
2 KAKIMOTO の管理個人売上予想の各個人に対して、個人売上予想、商談別
売上予想、管理個人売上予想を取得する必要があります。これが、反復の第
1 レベルです。
3 KAKIMOTO の部下に対して管理個人売上予想を使用し、KAKIMOTO の間接
的な部下に関する個人売上予想、商談別売上予想、管理個人売上予想の情報
を取得します。これが、反復の第 2 レベルです。
4 反復レベルは理論的には、必要なだけ増やせます。
重要な点は、新規のビジネスオブジェクトをインスタンス化して、管理階層をド
リルダウンすることです。元のビジネスオブジェクトが各個人に使用されると、
次のいずれかの状況が発生します。ロジックが元のビジネスオブジェクトからな
くなるか、管理階層を追跡するためにコードの大部分を作成しなければならなく
なります。
必要に応じて新たにビジネスオブジェクトを作成することによって、この問題を
解消し、Actuate レポートにおけるロジックを最小に保つことができます。
Actuate レポート内のロジック数を削減するために、Siebel ビジネスオブジェク
トとビジネスコンポーネントのロジックが使用されます。
バージョン 6.0
Siebel レポートガイド
1 1- 3 9
Reports.book
40 ページ
２００１年４月２７日　金曜日　午前１１時２７分
売上予想レポート
反復データの取得
例に戻ると、ステップ 2 で実行されるアクション (KAKIMOTO の部下の売上予
想レポートに関する個人、商談別、管理個人の売上予想情報の収集 ) は、レポー
トデザインのどこかに配置する必要があります。Actuate において、情報を収集
する際に必要なロジックが最も少なくてすむ個所は、KAKIMOTO の管理下の個
人の売上予想が入力される各行です。
KAKIMOTO の管理個人売上予想に戻されるそれぞれのレコードタイプに対し
て、レポートセクションを追加します。このレポートセクションで、Person
Forecast ビジネスオブジェクトのインスタンスを新たに作成する個人売上予想
データストリームを使用します。このインスタンスは、KAKIMOTO の管理下の
個人売上予想で示される個人と同じ個人を指定するように設定されます。これを
実行するデータストリームは、新規のビジネスオブジェクトを作成するロジック
を含むため、元の個人売上予想のデータストリームとは異なります。この理由か
ら、このデータストリームは recPerson ( 反復用 ) データストリームと呼ばれま
す。これは反復の一般的なロジックで、使用する構造のレベルは必要に応じて増
やせます。
月別商談レポート、Fooppty.rod は 1 つのレベルで反復されます。このレポート
は図 11-10 に示されています。
図 11-10
11 - 4 0
月別商談レポートのデザイン
Siebel レポートガイド
バージョン 6.0
Reports.book
41 ページ
２００１年４月２７日　金曜日　午前１１時２７分
売上予想レポート
反復データの取得
PersonSubQueries の順次セクションから構成の反復を開始して、
recManagedPersonRpt のコンテンツスロットに配置することによって、このレ
ポートを 2 レベルに変更できます。
問題は Master Forecast ビジネスオブジェクトです。このビジネスオブジェクトは
デフォルト動作で必要な機能を果たすため、これまで説明しませんでした。反復
クエリーでは、Master Forecast ビジネスオブジェクトによって問題が生じること
があります。たとえば、2 つのマスター売上予想、Master A と Master B が存在す
るとします。
これまで、Master Forecast ビジネスオブジェクトと常に同期化する既存のビュー
の Person ビジネスオブジェクトを使用してきました。マスター売上予想が
Master B の場合、Siebel ビューによって、Master B のマスター売上予想が Person
Forecast ビジネスオブジェクトで使用されることが確認されます。新たに Person
Forecast ビジネスオブジェクトを作成した場合、どちらのマスター売上予想を使
用するかを明確に決定する機能が何もありません。デフォルトでは、マスター売
上予想リストの最初のマスター売上予想である Master A が選択されます。新規
ビジネスオブジェクトでは使用する個人だけでなく、使用するマスター売上予想
も同期化する必要があります。
データストリームの同期化
K
このセクションでは、反復のシナリオでアクセスする異なるビジネスコンポーネ
ントのデータストリームを同期化する技術について説明します。
グローバル変数の使用
2 つのデータストリーム間の直接通信を構築するのは困難です。スコープ、ライ
フサイクルなどの問題によって、複雑になるためです。望ましいメソッドは、こ
のデータの伝達に有効なグローバル変数を作成することです。
売上予想レポートでは、特定の個別値をグローバルに使用できるようにして、
データストリームコンポーネント間で受け渡しができるようにしておくと便利な
場合がよくあります。この特定のケースでは、管理個人売上予想の行 ID とマス
ター売上予想の行 ID を共有することが望まれます。このプロセスを簡易化する
には、動的なグローバル値のリストを使用します。
バージョン 6.0
Siebel レポートガイド
1 1- 4 1
Reports.book
42 ページ
２００１年４月２７日　金曜日　午前１１時２７分
売上予想レポート
反復データの取得
このリストのそれぞれの値は設定時に名前が付けられます。値は次の構文を使用
します。
SetGlobalValue (ValueName, Value)
次の構文を使用してリストから値が取得されます。
Stringexp = GetGlobalValue (ValueName)
この技術を使用すると、最初の個人売上予想を実行するときにマスター売上予想
ID を保存できます。また、クエリーから各行を取得するときに管理個人売上予
想 ID を保存できます。この技術を使用すると、多数の個別のグローバル変数を
作成する必要がなくなります。
マスター売上予想の同期化
マスター売上予想 ID を保存するコードは、開始メソッド内の個人売上予想に格
納されています。次のコードの一部分は関連コードを示してます。
ssAppServer = ssReport::ssiSiebelServer ' vy 01/18/00
If ((bStatus = True) And (ssAppServer = 0)) Then
ssAppServer = ssConnect (ssReport::ssOLEServer)
ssReport::ssiSiebelServer = ssAppServer ' vy
If (ssAppServer = 0) Then
Start = False
Exit Function
End If
bStatus = False
If Not (ssAppServer = 0) Then
ssBO = ssModelGetBusObject (ssAppServer,
ssReport::ssBusObjectName)
ssReport::ssActiveBusObject = ssBO
¥¥¥¥ ssiSiebelServer maintains AppServer object ID globally to not
connect to it multiple time
11 - 4 2
Siebel レポートガイド
バージョン 6.0
Reports.book
43 ページ
２００１年４月２７日　金曜日　午前１１時２７分
売上予想レポート
反復データの取得
示されるように、最初に Person ビジネスオブジェクトが設定された後、マス
ター売上予想 ID が保存されます。次に示すように、SetMasterForecastID は、
SetGlobalValue のコールを簡易化する、foDataSource スーパークラスでのメソッ
ドです。
Function SetMasterForecastID (ssBO As Integer) As Integer
dim ssMaster_Forecast As Integer
dim tempMFID As String
ssMaster_Forecast = ssBusObjGetBusComp (ssBO, "Master Forecast")
If (errCode = 0) Then
tempMFID = ssBusCompGetFieldValue (ssMaster_Forecast, "Id")
SetGlobalValue ("MasterForecastID", tempMFID)
SetMasterForecastID = errCode
End Function
マスター売上予想 ID が設定され、後は、recPerson に作成された新規の Person ビ
ジネスオブジェクトが適切なマスター売上予想 ID を使用するようにするだけで
す。recPerson の開始メソッドで、次のコードによってこの機能が実行されます。
' * Need to set the MasterForecastID and ReExecute the Query
dim MasterForecastId As String
dim ssMaster_Forecast As Integer
If (errCode = 0) Then ssMaster_Forecast = ssBusObjGetBusComp (ssBO,
"Master Forecast")
If (errCode = 0) Then ssBusCompInvokeMethod (ssMaster_Forecast,
"SetIgnoreMaxCursorSize", "Y")
If (errCode = 0) Then
MasterForecastId = GetGlobalValue ("MasterForecastID")
ssBusCompSetSearchSpec (ssMaster_Forecast,"Id",
MasterForecastId)
If (errCode = 0) Then
ssBusCompExecuteQuery2 (ssMaster_Forecast, 1, True)
End If
End If
示されるように、コードにより Master Forecast ビジネスコンポーネントが作成さ
れ、次に、グローバルロケーションに保存された行 ID を使用して、そのビジネ
スコンポーネント上で検索条件が設定されます。
バージョン 6.0
Siebel レポートガイド
1 1- 4 3
Reports.book
44 ページ
２００１年４月２７日　金曜日　午前１１時２７分
売上予想レポート
反復データの取得
マスター売上予想 ID に関して考慮すべきもう 1 つの点は、11-22 ページの「マ
スター売上予想データへのアクセスと保存」で説明されるように、生成された特
定量の標準のコードについてコメントする必要があるということです。
管理個人売上予想から個人売上予想への同期化
次に、recPerson データストリームの実行時に、適切な個人に対して個人売上予
想が取得されるようにします。これは、マスター売上予想の同期化と同様、2 か
所のコードを変更することにより実行します。最初に、管理個人売上予想のコー
ドを変更して、管理された個人の行 ID がグローバルスペースに保存されるよう
にする必要があります。次に recPerson データストリームで、Person Forecast ビジ
ネスコンポーネントでの検索条件を設定します。
ManagedPerson データストリームの Fetch メソッドでは、取得されたデータだけ
が、管理された各個人の行 ID となります。次に示すように、このデータは取得
されるとグローバルロケーションに保存されます。
If (bStatus = True) And (errCode = 0) Then
Set custDataRow = NewDataRow
If (errCode = 0) Then
custDataRow.ssId = ssBusCompGetFieldValue (theBC, "Id")
'** Set Value to be used in Recursive Query
SetGlobalValue ("PersonRowID", custDataRow.ssID)
次に、ManagedPerson データストリームにより取得された各行に対して、
PersonSubQueries 順次セクションが実行されます。この順次セクションには、
recPerson データストリームを実行する recPersonRpt というレポートセクション
が含まれます。recPerson データストリームは、管理個人売上予想により取得さ
れた個人を参照する必要があります。
11 - 4 4
Siebel レポートガイド
バージョン 6.0
Reports.book
45 ページ
２００１年４月２７日　金曜日　午前１１時２７分
売上予想レポート
反復データの取得
マスター売上予想と同様、これは、Person ビジネスコンポーネント上でソート条
件を設定することにより実行できます。これは、次に示されるように、コードの
ReExecute2 の部分が開始メソッドの一番下で実行された時点で実行されます。
' Re-execute business components as necessary
bReExecute = True
mainRowId = GetGlobalValue ("PersonRowID")
If (errCode = 0) Then ssBusCompSetViewMode (ssPerson_Forecast, 3)
If (errCode = 0) Then ssBusCompInvokeMethod (ssPerson_Forecast,
"SetIgnoreMaxCursorSize", "Y")
If (errCode = 0) Then
If (bReExecute) Then
If (bCurRowOnly) And (mainRowId <> "") Then
ssBusCompSetSearchSpec (ssPerson_Forecast, "Id", mainRowId)
If (errCode = 0) Then
ssBusCompExecuteQuery2 (ssPerson_Forecast, 1, True)
Elseif (bUpdateLinks) Then
ssBusCompInvokeMethod (ssPerson_Forecast, "UpdateLinks", "")
End If
End If
示されるように、このコードは常に実行する必要があるので、bReExecute の値
が TRUE に設定されます。実際にはこの変数をすべて無視できますが、デザイ
ンの目的の 1 つは、コードをできるだけ最初に生成されたコードに近い状態に保
つことです。コードでは、管理個人売上予想に保存された PersonRowID を取得
し、新たなクエリーで検索条件として使用します。
すべてのコードは一般的なものです。したがって、recPerson データストリーム
は必要に応じて多数のレベルに何回でもネストさせることができます。新たに
PersonSubQueries を ( 既存の PersonSubQueries と同じコンポーネンとともに )
recManagedPersonRpt のコンテンツスロットに追加することによって、2 レベル
の反復を実行できます。
バージョン 6.0
Siebel レポートガイド
1 1- 4 5
Reports.book
46 ページ
２００１年４月２７日　金曜日　午前１１時２７分
売上予想レポート
反復データの取得
データ反復のその他の用途
K
Siebel 売上予想レポートでは、データ反復をさまざまな方法で使用できます。そ
の 1 つは、商談製品別売上予想情報を深く掘り下げる方法です。商談製品別売上
予想では、Opportunity ビジネスコンポーネントと Opportunity Product ビジネスコ
ンポーネントを取得するために、Opportunity Forecast ビジネスオブジェクトが使
用されます。
このプロセスは、管理個人の反復技術と似ていますが、1 レベルでしか反復しま
せん。基本プロセスは次のとおりです。
1 商談行 ID がグローバルに保存されます。
2 新規の Opportunity ビジネスオブジェクトがインスタンス化されます。
3 検索条件の機能と保存された行 ID を使用して、Opportunity ビジネスコン
ポーネントが、適切な商談を指定するように設定されます。
4 Opportunity Product ビジネスコンポーネントが、Opportunity ビジネスコン
ポーネントとの関係に基づいて取得されます。
このプロセスによって、Actuate の構造ペインに表示されるコンポーネントの外
観が複雑になりますが、概念上は簡単なプロセスです。管理個人の反復と同様、
新規のデータストリームの reOpportunity が作成されます。このデータストリー
ムは、Opportunity ビジネスコンポーネント上で ExecuteQuery2 を実行する前に、
適切なマスター売上予想 ID と適切な商談 ID を検索するように設計されていま
す。コードの変更個所は、recPerson データストリームで行われた変更個所と同
じです。
11 - 4 6
Siebel レポートガイド
バージョン 6.0
Reports.book
1 ページ
２００１年４月２７日　金曜日　午前１１時２７分
サーバーベースおよび
シンクライアントのレポート機能
12
この章について . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-2
サーバーベースのレポート機能 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-3
システムの概要 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-4
ユーザーインターフェースとプロセスフロー . . . . . . . . . . . . . . . . . . . . . . . . 12-5
Siebel のレポート管理ビュー . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-9
ユーザー管理ビュー . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-9
プロフィールビュー . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-13
スケジュールリクエストビュー . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-15
完了リクエストビュー . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-17
アクティブリクエストビュー . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-20
エクスプローラビュー . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-21
レポート ( 個人 ) ビュー . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-23
Actuate Server の機能 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-25
Actuate Administrator Desktop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-25
ReportCast . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-26
シンクライアントのレポート機能 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-29
バージョン 6.0
Siebel レポートガイド
12 - 1
Reports.book
2 ページ
２００１年４月２７日　金曜日　午前１１時２７分
サーバーベースおよび シンクライアントのレポート機能
この章について
この章について
L
この章では、日時を指定してレポートを実行したり、定期的にレポートを実行す
るためのスケジュール機能を持つ、サーバーベースのレポート機能について説明
します。サーバーベースのレポート機能では、レポート作成プログラムをレポー
トサーバーに格納しておくことにより、適切なアクセス権を持つ複数のユーザー
がこれを使用できます。
この章では、Siebel シンクライアント環境でのレポートの実行プロセスについて
も説明します。
サーバーモードのレポート機能をユーザーが使用できるようにするには、該当す
るサーバーコンピュータにレポートサーバーコンポーネントをインストールする
必要があります。インストールプロセスについては、
『Siebel インストールガイ
ド』を参照してください。
12 - 2
Siebel レポートガイド
バージョン 6.0
Reports.book
3 ページ
２００１年４月２７日　金曜日　午前１１時２７分
サーバーベースおよび シンクライアントのレポート機能
サーバーベースのレポート機能
サーバーベースのレポート機能
L
サーバーベースのレポート機能を使用すると、ユーザーは、クライアントマシン
上ではなく、レポートサーバー上でレポートを実行できます。サーバーベースの
レポート機能とクライアントベースのレポート機能は、次の点が異なります。
„
クライアントベースのレポート機能は、ユーザーが専用クライアント ( シンク
ライアントやリモートクライアントではない ) を使用しており、必要なレ
ポートが 1 件 ( あるいは、2、3 件 ) のみで、レポート作成プログラムを他の
ユーザーと共有する必要がない場合に適しています。
„
サーバーベースのレポート機能は、シンクライアントから実行できます。ま
た、レポート出力のスケジュール (1 回または定期的 )、複数ユーザー間での
レポート作成プログラムの共有、および Web サーバー上でのレポート出力の
安全な配布が可能です。接続クライアントでは、大規模なレポートの処理中
に別の作業を実行できます。
サーバーベースのレポート機能は、Actuate Software Corporation の 3 つの製品を
Siebel eBusiness Applications のクライアントおよびサーバー環境に統合すること
により実現されました。3 つの製品とは、e.Reporting Server、Administrator
Desktop および ReportCast です。これらの製品について簡単に説明します。
„
Actuate e.Reporting Server
基礎を形成するソフトウェアであり、セキュアファイルシステム構造におけ
るレポート作成プログラムの格納とレポート出力を実現する Actuate Report
Encyclopedia を実行します。
„
Actuate Administrator Desktop
これは、Report Encyclopedia のユーザープロフィールとユーザーグループの
保守を行うために管理者が使用するアプリケーションです。一部の管理作業
は、Siebel の管理ビューからも実行できます。
„
Actuate ReportCast
このソフトウェアは、Web サーバーと Report Encyclopedia のインターフェー
スを提供します。これにより、ユーザーは Web ブラウザを使用して Report
Encyclopedia のレポートにアクセスできます。
これらの製品の詳細については、Actuate のマニュアルセットで説明しています。
Actuate のマニュアルには役立つ情報が記載されているので、システム管理者は
この章と併せて参照してください。エンドユーザー機能についてはすべて Siebel
eBusiness Applications インターフェースにより提供されるので、管理者以外の
ユーザーはこの章に記載されている説明を理解するだけで十分です。
バージョン 6.0
Siebel レポートガイド
12 - 3
Reports.book
4 ページ
２００１年４月２７日　金曜日　午前１１時２７分
サーバーベースおよび シンクライアントのレポート機能
サーバーベースのレポート機能
システムの概要
L
サーバーベースのレポート機能では、レポートサーバーコンポーネントを使用す
ることにより、レポートの実行や格納をリモートで行うことができます。レポー
トを実行すると、Siebel Server から現在のデータが抽出され、これを使用してレ
ポートが生成されます。専用クライアントのユーザーは、レポートサーバーにリ
クエストを行います。このリクエストに従い、指定された時刻に Object Manager
のデータを使用して、レポートが生成されます。レポートの .ROI ファイルは
Actuate Report Encyclopedia に格納されており、Siebel eBusiness Applications のレ
ポート管理ビューからアクセスできます。必要に応じて、システムプリンタに送
信することもできます。
サーバーベースのレポート機能 ( 専用クライアントの場合 ) を図 12-1 に示します。
Siebel Server
Object Manager
レポートサーバー
OMU Translation
Layer
専用Siebelクライアント
保存された
クライアン
ト状況情報
RS API
(レポートサーバーAPI)
Actuate
レポートビューア
Actuate e.Report
Server
.ROI
ファイル
システム
プリンタ
図 12-1
サーバーベースのレポート機能 ( 専用クライアントの場合 )
リクエスト発行以降のクライアント状況に関する情報 ( 現在のビュー、クエ
リー、表示、検索条件、およびソート条件 ) が、Actuate の RS API を介してレ
ポートサーバーに伝えられます。レポートが生成されると、この保存済みの状況
情報が確認され、ユーザーが受け取るデータが、クライアントモードのレポート
機能を使用した場合と同じデータであることが保証されます。
シンクライアントの場合のシステムフローについては、12-29 ページの「シンク
ライアントのレポート機能」を参照してください。
12 - 4
Siebel レポートガイド
バージョン 6.0
Reports.book
5 ページ
２００１年４月２７日　金曜日　午前１１時２７分
サーバーベースおよび シンクライアントのレポート機能
サーバーベースのレポート機能
ユーザーインターフェースとプロセスフロー
L
ユーザーは、Siebel アプリケーションの [ レポート ] メニューから新規レポート
を実行します。第 1 章「Siebel レポート」で説明したように、利用可能なレポー
トリストの内容は、ユーザーの現在のビューによって異なります。[ レポート ]
メニューからユーザーがレポートを選択すると、ダイアログボックスが表示さ
れ、ただちにローカルマシンにレポートを生成するか、あるいはサーバーモード
のレポート機能を使ってレポートサーバーへのリクエストとしてレポートを生成
するかの指定が求められます。このダイアログボックスを図 12-2 に示します。
図 12-2
[ レポートの実行 ] ダイアログボックス
次の 2 つのオプションがあります。
バージョン 6.0
„
今実行する
専用クライアントの場合は、このオプションを選択すると、レポートはただ
ちに生成されてクライアントコンピュータに表示されます。これを、クライ
アントモードのレポート機能といいます。シンクライアントの場合は、この
オプションを選択すると、レポートの即時生成リクエストがレポートサー
バーに送信されます。レポートの準備が完了すると、Web ブラウザが起動さ
れてレポートが表示されます。
„
後で実行する
専用クライアントの場合もシンクライアントの場合も、このオプションは、
日時を指定してレポートを 1 回生成する、または定期的にレポートを生成す
る必要があることを示します。これを、サーバーモードのレポート機能とい
います。必要に応じて、レポートをシステムプリンタに送信できます。レ
ポートをプリンタに送信してもしなくても、.ROI ファイルはレポートサー
バーの Report Encyclopedia に保存されます。これにより、レポートを実行し
たユーザーや適切なアクセス権を持つ他のユーザーは、Siebel アプリケー
ションのレポート管理ビューを使用して、後でこのレポートにアクセスでき
ます。
Siebel レポートガイド
12 - 5
Reports.book
6 ページ
２００１年４月２７日　金曜日　午前１１時２７分
サーバーベースおよび シンクライアントのレポート機能
サーバーベースのレポート機能
ユーザーが [ 今実行する ] を選択した場合は、追加のダイアログボックスは表
示されず、6.0 以前のバージョンの Siebel アプリケーションで実行した場合と同
様にリクエストが処理されます。ユーザーが [ 後で実行する ] を選択した場合
は、図 12-3 に示すような [ スケジュールレポート ] ダイアログボックスが表示
されます。
図 12-3
[ スケジュールレポート ] ダイアログボックス
[ スケジュールレポート ] ダイアログボックスを使用すると、ユーザーは、次に
示すレポートリクエストのパラメータを指定できます。
12 - 6
„
レポートを 1 回だけ生成するか、あるいは定期的に生成するかの指定
„
レポートをシステムプリンタに送信するかどうか、および ( 送信する場合は )
宛先プリンタの指定
„
Report Encyclopedia のファイル構造におけるレポートの保存場所の指定
Siebel レポートガイド
バージョン 6.0
Reports.book
7 ページ
２００１年４月２７日　金曜日　午前１１時２７分
サーバーベースおよび シンクライアントのレポート機能
サーバーベースのレポート機能
[ スケジュールレポート ] ダイアログボックスには、次のフィールドがあります。
„
日付
1 回かぎりのレポートの場合は、レポートを生成する日付を指定します。定
期的レポートの場合は、第 1 回目のレポートを生成する日付を指定します。
„
時間
レポート生成の時刻を指定します。
備考 : このダイアログボックスに入力した日付と時間は、クライアントマシ
ンのシステム日付 / 時間ではなく、レポートサーバーの日付と時間を表しま
す。レポートサーバーとクライアントマシンのタイムゾーンが異なる場合は、
設定内容に基づいて、スケジュールした日付および時間 ( レポートサーバー
のタイムゾーンで計算 ) にレポート生成が開始されます。
„
繰り返しチェックボックス
レポートを 1 回だけ生成するか、定期的に生成するかを指定します。チェッ
クボックスをオンにした場合はレポートが定期的に生成され、オフにした場
合は 1 回だけ生成されます。
„
頻度ピックリスト
定期的レポートにのみ適用されます。レポートの実行頻度 ( 毎月、毎週、毎
日、年 4 回など ) を指定します。[ 日付 ] フィールドに指定した日付に基づい
て、次回以降の実行日が計算されます。
„
有効期限
定期的レポートに適用されます。ここに指定した日付以降、レポートは実行
されません。
„
レポートサーバー日付
レポートサーバーのローカル日付を表す、読み込み専用のフィールドです。
„
レポートサーバー時間
レポートサーバーのローカル時刻を表す、読み込み専用のフィールドです。
„
レポート名
レポート実行ごとに生成される、Report Encyclopedia の .ROI ファイルのパス
名を指定します。パス名は、次の形式で指定します。
¥folder¥reportname.roi
バージョン 6.0
Siebel レポートガイド
12 - 7
Reports.book
8 ページ
２００１年４月２７日　金曜日　午前１１時２７分
サーバーベースおよび シンクライアントのレポート機能
サーバーベースのレポート機能
folder には、必要に応じてサブフォルダを指定できます。[ レポート名 ]
フィールドのデフォルト値には、ユーザーのデフォルトである Report
Encyclopedia フォルダ名 ([ プロフィール ] ビューで指定 ) に続けてレポート生
成プログラムと同じレポート名が指定されています。ユーザーはデフォルト
以外のフォルダを宛先フォルダとして指定できます。その場合は、Report
Encyclopedia 内に存在するフォルダであること、およびユーザーリストによ
りアクセス権を付与されているフォルダであることが条件になります。
„
終了時にレポートを印刷するチェックボックス
このチェックボックスをオンにすると、レポート実行後に、指定されたシス
テムプリンタにレポートが出力され、Report Encyclopedia にレポートの .ROI
ファイルが保存されます。オフにした場合、レポートは Report Encyclopedia
だけに保存されます。
„
プリンタ名ピックリスト
実行時のレポート出力に使用するプリンタを選択できます。ユーザープロ
フィールに指定されているデフォルトのプリンタが、初期設定値として表示
されます。レポートサーバーで管理されている一連のプリンタが、利用可能
なプリンタとして表示されます。
レポート生成後、ユーザーは、[ 完了リクエスト ]、[ レポート ( 個人 )]、[ エク
スプローラ ] の各ビューでレポート出力 (.ROI ファイル ) を参照したり出力する
ことができます。詳細については、12-9 ページの「Siebel のレポート管理
ビュー」を参照してください。12-26 ページの「ReportCast」で説明しているよ
うに、Web ブラウザを使用して該当する Web サーバーにアクセスすることによ
り、レポートを参照することもできます。
12 - 8
Siebel レポートガイド
バージョン 6.0
Reports.book
9 ページ
２００１年４月２７日　金曜日　午前１１時２７分
サーバーベースおよび シンクライアントのレポート機能
Siebel のレポート管理ビュー
Siebel のレポート管理ビュー
L
この項では、Siebel アプリケーションのレポート管理画面に表示されるさまざま
なビューについて説明します。この内の 1 つは、ユーザーのアクセス権を管理す
るために (Actuate Administrator Desktop に加えて ) 管理者が使用します。その他
のビューはエンドユーザーが使用します。これらのビューによりユーザーは、レ
ポート生成ジョブの結果を取得したり、ユーザー自身や他のユーザーが所有する
完成済みレポート ( どのレポートにアクセスできるかはアクセス権によって決ま
る ) にアクセスしたり、ユーザー自身が所有するレポートへのアクセス権を他の
ユーザーに付与したり、パスワードやデフォルト値を管理したりできます。
ユーザー管理ビュー
L
このビューは、管理者が使用します。このビューを使用すると、管理者は、
Siebel eBusiness Applications の従業員レコードからユーザー ID を Actuate
Administrator Desktop に転送し、レポートサーバーのユーザー ID として使用でき
ます。ユーザーは、レポートサーバーのユーザー ID によって Report
Encyclopedia へのアクセスを許可されます。通常、ユーザーは、Siebel アプリ
ケーションのレポート管理ビューから Report Encyclopedia にアクセスします。
ユーザーが Siebel アプリケーションから Report Encyclopedia にアクセスできるよ
うにするには、以前にレポートサーバーで管理されていたユーザー ID とパス
ワードが必要です。
レポートサーバーのアカウントは、Siebel アプリケーションと同じユーザー ID
およびブランクパスワードを使用して作成されます。12-13 ページの「プロ
フィールビュー」で説明しているように、ユーザーは [ プロフィール ] ビューを
使用して、このパスワードを後で変更できます ( パスワードは必ず変更してくだ
さい )。ユーザー ID とパスワードは暗号化されて Siebel Database に格納され、必
要に応じてレポートサーバーに渡されます。Web サーバーに格納されているレ
ポートに ReportCast から直接アクセスする場合を除き、ユーザー ID とパスワー
ドをユーザーが直接使用することはありません。ReportCast については、12-26
ページの「ReportCast」で説明しています。
このビューでは、管理者はユーザー ID を個別に転送することも、リスト全体を
転送することもできます。Actuate Administrator Desktop でレポートサーバーの
ユーザー ID を 1 つずつ作成する方法と比べて、[ ユーザー管理 ] ビューには、レ
ポートサーバーのアカウントを一括作成できるので大幅に時間を節約できるとい
う利点があります。このビューを使用すると、ユーザー ID の入力ミスにより
Siebel Database のユーザー ID と一致しないという問題を排除できます。
バージョン 6.0
Siebel レポートガイド
12 - 9
Reports.book
10 ページ
２００１年４月２７日　金曜日　午前１１時２７分
サーバーベースおよび シンクライアントのレポート機能
Siebel のレポート管理ビュー
管理者は、最初に Actuate Administrator Desktop で管理用のユーザー ID を作成し
ます。このユーザー ID を使用することで、管理者は管理者権限で Actuate
Administrator Desktop にログインできると同時に、Siebel eBusiness Applications の
[ ユーザー管理 ] ビューにアクセスできるようになります。通常、その他のユー
ザー ID は [Admin Sync] ビューで作成するため、これ以降は、Actuate
Administrator Desktop はユーザーアクセスグループの保守のみに使用します。
管理者が [ 画面 ] メニューまたはビューバーから [ ユーザー管理 ] ビューを選択
すると、レポートサーバーのユーザー ID とパスワードの入力を求めるダイアロ
グボックスが表示されます。レポートサーバーでは、このユーザーにレポート
サーバーでの管理者権限があるかどうかを確認し、適切な権限がない場合には
[ ユーザー管理 ] ビューへのアクセスを拒否します。
同期の結果、Siebel アプリケーションと同じユーザー ID を持つアカウントがレ
ポートサーバー上で作成されます。また、アカウント名と同じ名前でデフォルト
のフォルダがレポートサーバーに作成されます。このとき、ユーザーには、この
フォルダに対する読み込み、書き込み、および実行などの基本的な権限が付与さ
れます。
12 - 1 0
Siebel レポートガイド
バージョン 6.0
Reports.book
11 ページ
２００１年４月２７日　金曜日　午前１１時２７分
サーバーベースおよび シンクライアントのレポート機能
Siebel のレポート管理ビュー
[ ユーザー管理 ] ビューを図 12-4 に示します。
図 12-4
[ ユーザー管理 ] ビュー
このビューには、次のようなリストカラムとボタンがあります。
バージョン 6.0
„
姓リストカラム
従業員テーブルに格納されている、ユーザーの名前 ( 姓 )。
„
名リストカラム
従業員テーブルに格納されている、ユーザーの名前 ( 名 )。
Siebel レポートガイド
1 2- 1 1
Reports.book
12 ページ
２００１年４月２７日　金曜日　午前１１時２７分
サーバーベースおよび シンクライアントのレポート機能
Siebel のレポート管理ビュー
12 - 1 2
„
ログイン名リストカラム
従業員テーブルに格納されている、各ユーザーの Siebel ユーザー ID。
„
肩書リストカラム
従業員の役職名。
„
全て同期ボタン
このボタンをクリックすると、表示されているすべてのユーザー ID が Siebel
eBusiness Applications から Actuate Administrator Desktop に転送されます。クエ
リーの実行によってリスト項目が限定されていないかぎり、これにはすべて
の従業員のログインが含まれます。クエリーによって限定されている場合に
は、表示されているユーザー ID だけが転送されます。
„
一つ同期ボタン
このボタンをクリックすると、現在強調表示されているユーザー ID だけが
Actuate Administrator Desktop に転送されます。
Siebel レポートガイド
バージョン 6.0
Reports.book
13 ページ
２００１年４月２７日　金曜日　午前１１時２７分
サーバーベースおよび シンクライアントのレポート機能
Siebel のレポート管理ビュー
プロフィールビュー
L
このビューを使用すると、エンドユーザーは、レポートサーバーで使用している
自分のパスワードを変更したり、レポート出力用としてデフォルトのプリンタや
ファイルシステムフォルダを指定したりできます。[ プロフィール ] ビューを図
12-5 に示します。
図 12-5
[ プロフィール ] ビュー
バージョン 6.0
Siebel レポートガイド
1 2- 1 3
Reports.book
14 ページ
２００１年４月２７日　金曜日　午前１１時２７分
サーバーベースおよび シンクライアントのレポート機能
Siebel のレポート管理ビュー
このビューのアプレットには、次の 5 つのフィールドがあります。
12 - 1 4
„
レポートサーバーのログイン名
このフィールドには、現在ログインしているユーザーのログイン名が表示さ
れます。このフィールドは読み込み専用です。
„
レポートが生成されるレポートサーバーのデフォルトフォルダー
レポート出力の格納に使用する、Report Encyclopedia におけるユーザーのデ
フォルトのフォルダです。デフォルトでは、このフォルダはユーザー ID と同
じ名前を持ち、Report Encyclopedia のルートレベルに置かれています。ユー
ザーは、ルートレベルにある、自分のユーザー ID と同じ名前を持つフォルダ
へのアクセス権を同期プロセス中に取得します。ユーザーは、初期設定され
ているルートレベルのデフォルトフォルダ以外のフォルダをデフォルトとし
て指定できますが、指定するフォルダが Report Encyclopedia 内にすでに作成
されていること、およびユーザーがそのフォルダへのアクセス権を持ってい
ることが条件になります。
„
レポートリクエストを印刷するデフォルトプリンター
実行時にレポート出力用として使用するデフォルトのプリンタです。このプ
リンタ名は、ユーザーがレポートをスケジュールするときに、最初に [ レ
ポートの実行 ] ダイアログボックスに表示されます。その時点で、ユーザー
は必要に応じて別のプリンタを選択できます。[ プロフィール ] ビューには、
デフォルトのプリンタとして選択できるプリンタのリストが表示されますが、
このリストはレポートサーバーから取得されます。
„
レポートサーバーの現在のパスワードの入力
ここにパスワードを入力すると、Actuate Administrator Desktop の対応するパ
スワードを変更できます。パスワードの変更は、ユーザーが [ プロフィール ]
ビューを終了したときに有効になります。
Siebel レポートガイド
バージョン 6.0
Reports.book
15 ページ
２００１年４月２７日　金曜日　午前１１時２７分
サーバーベースおよび シンクライアントのレポート機能
Siebel のレポート管理ビュー
„
新パスワードの入力
Siebel Database に格納されているパスワードが古くなった場合には、この
フィールドに現在のパスワードを入力できます。
注意 : デフォルトでは、レポートサーバーのユーザー ID の作成
時に、各ユーザーにブランクのレポートサーバー用パスワードが
割り当てられます。各ユーザーは、[ プロフィール ] ビューを使
用して、このブランクのパスワードをブランク以外の秘密のパス
ワードに変更する必要があります。これによって、ユーザーが
Siebel eBusiness Applications からレポートサーバーにアクセスす
る場合にはセキュリティ上の影響はありませんが、レポートサー
バーに直接アクセスする場合にセキュリティが損なわれます。
スケジュールリクエストビュー
L
[ スケジュールリクエスト ] ビューには、処理待機中のレポートリクエストが表
示されます。この中には、日時を指定して実行がスケジュールされている定期的
レポートも含まれます。表示されるのは、現在のユーザーのレポートジョブだけ
です。このビューの機能は、プリントキューウィンドウと似ており、予定されて
いるレポートジョブに関する情報が表示されます。
このビューは、[ リクエスト ] という単独のアプレットで構成されます。このア
プレットは、スケジュールされている各レポートジョブについて、レポートが当
初スケジュールされたときに [ レポートの実行 ] ダイアログボックスに入力され
た情報を表示します。
[ スケジュールリクエスト ] ビューを図 12-6 に示します。
バージョン 6.0
Siebel レポートガイド
1 2- 1 5
Reports.book
16 ページ
２００１年４月２７日　金曜日　午前１１時２７分
サーバーベースおよび シンクライアントのレポート機能
Siebel のレポート管理ビュー
図 12-6
[ スケジュールリクエスト ] ビュー
12 - 1 6
Siebel レポートガイド
バージョン 6.0
Reports.book
17 ページ
２００１年４月２７日　金曜日　午前１１時２７分
サーバーベースおよび シンクライアントのレポート機能
Siebel のレポート管理ビュー
[ リクエスト ] アプレットには、次のリストカラムがあります。
„
レポート名
実行するレポート作成プログラムの名前。
„
次の開始時間
スケジュールされているレポートの実行を開始する日付と時刻。
„
繰返し
定期的レポートの場合はチェックマークが付きます。1 回かぎりのレポート
の場合、チェックマークは付きません。
„
頻度
1 回かぎりのレポートの場合は NA ( 該当せず ) です。定期的レポートの場合
は、Weekly、Monthly などの値が入ります。
完了リクエストビュー
L
[ 完了リクエスト ] ビューには、終了、失敗、または中止したレポートリクエス
トの状況に関する情報が表示されます。終了した ( 成功した ) 各リクエストへの
ハイパーリンクもあります。このビューには、ログインしているユーザー自身の
リクエストだけが表示されます。
このビューは、レポートサーバーのレポート出力にアクセスできる 3 つのビュー
の 1 つです。残りの 2 つは、[ レポート ( 個人 )] ビューと [ エクスプローラ ]
ビューです。この 2 つについては、それぞれ 12-23 ページの「レポート ( 個人 )
ビュー」および 12-21 ページの「エクスプローラビュー」で説明しています。
[ 完了リクエスト ] ビューは、補助的な機能としてレポート出力を提供しますが、
このビューの主な目的は、リクエストの結果に関する情報を提供することです。
バージョン 6.0
Siebel レポートガイド
1 2- 1 7
Reports.book
18 ページ
２００１年４月２７日　金曜日　午前１１時２７分
サーバーベースおよび シンクライアントのレポート機能
Siebel のレポート管理ビュー
[ 完了リクエスト ] ビューを図 12-7 に示します。
図 12-7
[ 完了リクエスト ] ビュー
12 - 1 8
Siebel レポートガイド
バージョン 6.0
Reports.book
19 ページ
２００１年４月２７日　金曜日　午前１１時２７分
サーバーベースおよび シンクライアントのレポート機能
Siebel のレポート管理ビュー
このビューには、次のリストカラムがあります。
バージョン 6.0
„
状況
値は成功または失敗であり、リクエストの結果によって決まります。
„
レポート名
リクエストが成功した場合、レポート出力 (.ROI) ファイルの名前とパスが、
色付きのハイパーリンクテキストとしてここに表示されます。ハイパーリン
クをクリックすると、レポートビューアまたは Web ブラウザのウィンドウで
レポートが開きます。どちらのウィンドウが使用されるかは、ユーザーがこ
のビューにアクセスしている環境 ( 専用クライアントまたはシンクライアン
ト ) によって決まります。
„
完了
レポートが終了したまたは中止された日付と時刻。
„
ページ
レポートが成功した場合には、生成されたレポートのページ数。
„
バージョン
定期的レポートの場合に、このリクエストに対応するレポート出力のバー
ジョン番号。リクエストに基づいてレポートが生成されるたびに、順番に次
のバージョン番号が割り当てられます。同じリクエストに対応するさまざま
なレポート実行の出力は、バージョン番号によって識別されます。最も大き
な数値のバージョンが、最新のバージョンです。
„
状況詳細
レポート実行が失敗した場合には、ここに失敗の理由についての説明が入り
ます。
Siebel レポートガイド
1 2- 1 9
Reports.book
20 ページ
２００１年４月２７日　金曜日　午前１１時２７分
サーバーベースおよび シンクライアントのレポート機能
Siebel のレポート管理ビュー
アクティブリクエストビュー
L
このビューは、現在生成処理中のレポートのリストです。このビューを使用する
と、大規模なレポートの進捗状況をチェックできます。リストが空の場合もあり
ます。
[ アクティブリクエスト ] ビューを図 12-8 に示します。
図 12-8
[ アクティブリクエスト ] ビュー
12 - 2 0
Siebel レポートガイド
バージョン 6.0
Reports.book
21 ページ
２００１年４月２７日　金曜日　午前１１時２７分
サーバーベースおよび シンクライアントのレポート機能
Siebel のレポート管理ビュー
[ アクティブリクエスト ] ビューには、次のリストカラムがあります。
„
レポート名
出力生成中のレポート生成プログラムの名前。
„
開始時刻
レポート生成を開始した日付と時刻。
エクスプローラビュー
L
[ エクスプローラ ] ビューでは、エクスプローラのようなインターフェースを使
用して、レポートサーバーにあるレポート出力ファイルの名前が階層的に表示さ
れます。表示されるのは、ユーザーがアクセス権を持っているレポートだけで
す。[ レポート ( 個人 )] ビューと同様、このビューを使用すると、ユーザーは
Siebel アプリケーションからレポートサーバー上のレポート出力ファイルにアク
セスすることができ、レポートサーバーに直接アクセスする必要がありません。
備考 : [ エクスプローラ ] ビューは、シンクライアント環境では利用できません。
シンクライアント環境の場合、レポート出力ファイルにアクセスするには、ユー
ザーは [ レポート ( 個人 )] ビューを使用する必要があります。
[ エクスプローラ ] ビューのツリー ( 左側 ) アプレットには、レポートサーバー
のフォルダが階層的に表示されます。最上位 ( ルート ) フォルダは、スラッシュ
(/) で表されます。ルートの 1 つ下のレベルのサブフォルダは、ユーザーアカウ
ント名に対応しています。この最上位レベルのサブフォルダには、管理者定義の
サブフォルダが作成されている場合があります。ツリーアプレットで任意のフォ
ルダをクリックすると、そのフォルダに格納されているすべてのレポートがリス
ト ( 右側 ) アプレットに表示されます。
バージョン 6.0
Siebel レポートガイド
1 2- 2 1
Reports.book
22 ページ
２００１年４月２７日　金曜日　午前１１時２７分
サーバーベースおよび シンクライアントのレポート機能
Siebel のレポート管理ビュー
[ エクスプローラ ] ビューを図 12-9 に示します。
図 12-9
[ エクスプローラ ] ビュー
12 - 2 2
Siebel レポートガイド
バージョン 6.0
Reports.book
23 ページ
２００１年４月２７日　金曜日　午前１１時２７分
サーバーベースおよび シンクライアントのレポート機能
Siebel のレポート管理ビュー
リストアプレットには、次のリストカラムがあります。
„
名前
ここには、サブフォルダ名またはレポート出力 (.ROI) ファイルの名前が色付
きのハイパーリンクテキストとして表示されます。フォルダ名の場合、ハイ
パーリンクをクリックしたときの動作は、ツリー内でそのフォルダに移動す
ることと同じです。レポート名の場合は、ハイパーリンクをクリックする
と、レポートビューアまたは Web ブラウザのウィンドウでレポートが開き
ます。どちらのウィンドウが使用されるかは、ユーザーがこのビューにアク
セスしている環境 ( 専用クライアントまたはシンクライアント ) によって決
まります。
„
最終更新日
このバージョンを生成したレポート実行の日付と時刻。
„
ページ
生成されたレポートのページ数。
レポート ( 個人 ) ビュー
L
[ エクスプローラ ] ビューと同様、[ レポート ( 個人 )] ビューを使用すると、
Siebel アプリケーションからレポート出力ファイルにアクセスできます。ただ
し、[ レポート ( 個人 )] ビューではレポート出力レコードが階層構造のリストと
して表示されない点が [ エクスプローラ ] ビューとは異なります。[ レポート
( 個人 )] ビューは、シンクライアントユーザーも専用クライアントユーザーも使
用できます。
[ レポート ( 個人 )] ビューには、現在のユーザーがアクセス権を持っているレ
ポート出力ファイルが表示されます。また、各レポート出力ファイルを利用でき
る役割とユーザーの名前も表示されます。主要アプレットである [ レポート ] に
は、レポート出力ファイルが表示されます。従属アプレットである [ 保管場所役
割 ] と [ ユーザー ] ( 画面下部 ) には、[ レポート ] アプレットで現在強調表示さ
れているレポートへのアクセス権を持つ役割とユーザーが表示されます。
[ レポート ] アプレットではレコードが非階層的に表示されるため、[ レポート名 ]
リストカラムには、レポート名だけではなく、各レポートの完全パス名が表示さ
れます。各フォルダおよびサブフォルダに格納されているすべてのレポート出力
ファイルが、一度にすべて表示されます。
バージョン 6.0
Siebel レポートガイド
1 2- 2 3
Reports.book
24 ページ
２００１年４月２７日　金曜日　午前１１時２７分
サーバーベースおよび シンクライアントのレポート機能
Siebel のレポート管理ビュー
[ レポート ( 個人 )] ビューを図 12-10 に示します。
図 12-10
12 - 2 4
[ レポート ( 個人 )] ビュー
Siebel レポートガイド
バージョン 6.0
Reports.book
25 ページ
２００１年４月２７日　金曜日　午前１１時２７分
サーバーベースおよび シンクライアントのレポート機能
Actuate Server の機能
[ レポート ] アプレットには、次のリストカラムがあります。
„
レポート名
ここには、レポート出力 (.ROI) ファイルの完全パス名が色付きのハイパーリ
ンクテキストとして表示されます。ハイパーリンクをクリックすると、レ
ポートビューアまたは Web ブラウザのウィンドウでレポートが開きます。ど
ちらのウィンドウが使用されるかは、ユーザーがこのビューにアクセスして
いる環境 ( 専用クライアントまたはシンクライアント ) によって決まります。
„
Report ID
Report Encyclopedia でインデックスとして使用される一意の内部識別番号。
„
バージョン
現在のユーザーに対応するレポートのバージョンを表す数値。(1 つのレポー
ト生成プログラムから ) 同じ名前のレポートが生成されるたびに、順番に次
のバージョン番号が出力ファイルに割当てられます。最も大きな数値のバー
ジョンが、最新のバージョンです。
„
最終更新日
このバージョンを生成したレポート実行の日付と時刻。
„
ページ
生成されたレポートのページ数。
Actuate Server の機能
L
Actuate e.Reporting Server、Actuate Administrator Desktop、および Actuate
ReportCast に固有の情報については、Actuate のマニュアルで説明しています。
ここでは、Siebel ユーザーに関連する問題について簡単に説明します。
Actuate Administrator Desktop
L
Siebel 管理者は Actuate Administrator Desktop で管理用パスワードを作成し、この
パスワードを使用して、ファイルシステムフォルダ、ユーザーアカウント、ロー
ルリスト、およびユーザーアクセスリストを管理します。12-9 ページの「ユー
ザー管理ビュー」で説明したように、管理者は、最初に [ ユーザー管理 ] ビュー
を使用して、各ユーザーのユーザーアカウントとデフォルトのフォルダを一括で
作成します。
バージョン 6.0
Siebel レポートガイド
1 2- 2 5
Reports.book
26 ページ
２００１年４月２７日　金曜日　午前１１時２７分
サーバーベースおよび シンクライアントのレポート機能
Actuate Server の機能
カスタムフォルダ、ユーザーリスト、およびロールリストは、Actuate
Administrator Desktop で直接管理する必要があります。管理者は、フォルダおよ
び各レポートへのユーザーリストとロールリストの割当にも、Actuate
Administrator Desktop を使用します。
Actuate Administrator Desktop の詳細については、Actuate マニュアルセットの
『Administering the Report Encyclopedia』を参照してください。
ReportCast
L
レポートサーバーへのログインアクセス権を持つユーザーは、Siebel eBusiness
Applications の外からでも、Web ブラウザを使用してレポートを参照できます。
この機能は Actuate サーバーのコンポーネントの 1 つである ReportCast によって
実現されます。企業などでは、ユーザーが Siebel アプリケーションのない環境で
特定のレポートにアクセスする必要があるときに、この機能を利用できます。
Siebel クライアントアプリケーションを起動せずに、レポートに直接アクセスす
ることを希望するユーザーもいます。
ログイン同期によって作成されたユーザー ID と、その後にユーザーが [ プロ
フィール ] ビューで指定したパスワードを使用すると、Siebel アプリケーション
のレポート管理ビューから、あるいはブラウザを使って Web サーバーにアクセ
スすることにより、ユーザーは一連のフォルダおよびレポートにアクセスできま
す。参照できる内容は、どちらのアクセス方法を使用しても同じです。Siebel ア
プリケーションからレポートにアクセスする場合は、パスワードが自動的に渡さ
れるので、ユーザーはパスワードを入力する必要がありません。Web サーバー
からアクセスする場合は、ユーザーはユーザー ID とパスワードを入力しなけれ
ばなりません。
ユーザーの環境に Siebel アプリケーションがない場合、管理者は Actuate
Administrator Desktop でそのユーザー用のアカウントを手動で作成する必要があ
ります。このようにユーザーのアカウントを管理することによって、ユーザーは
Siebel アプリケーションのユーザーと同じように Web サーバーからレポートに
アクセスできるようになります。
12 - 2 6
Siebel レポートガイド
バージョン 6.0
Reports.book
27 ページ
２００１年４月２７日　金曜日　午前１１時２７分
サーバーベースおよび シンクライアントのレポート機能
Actuate Server の機能
Web ブラウザでレポート出力を表示した様子を図 12-11 に示します。
図 12-11
Web ブラウザに表示されたレポート出力
Web サーバーからレポートにアクセスする場合、ユーザーが該当する URL に移
動すると、ユーザー ID とパスワードの入力を求めるプロンプトが表示されま
す。ユーザーがフォルダに移動した場合はそのフォルダ内のレポートがリスト表
示され、.ROI ファイルに移動した場合はその .ROI ファイルが開かれます。レ
ポートを選択すると .ROI フォーマットから .DHTML フォーマットへの自動変換
が行われるので、ブラウザでレポートを参照できます。
バージョン 6.0
Siebel レポートガイド
1 2- 2 7
Reports.book
28 ページ
２００１年４月２７日　金曜日　午前１１時２７分
サーバーベースおよび シンクライアントのレポート機能
Actuate Server の機能
レポートファイルの URL は次の形式になります。
http://servername/acweb/hostname/reportname.roi;version
この URL 表現には、次のパラメータがあります。
servername
ReportCast ソフトウェアが置かれている Web サーバーです。
hostname
Report Encyclopedia の名前。この名前は、レポートサーバー
のホストマシンの名前と同じです。
reportname
開く .ROI ファイルの名前 ( フォルダ名を含む )。
version
このレポートの該当するバージョンのバージョン番号。
ReportCast の詳細については、『Actuate ReportCast Online Documentation』を参照
してください。
12 - 2 8
Siebel レポートガイド
バージョン 6.0
Reports.book
29 ページ
２００１年４月２７日　金曜日　午前１１時２７分
サーバーベースおよび シンクライアントのレポート機能
シンクライアントのレポート機能
シンクライアントのレポート機能
L
リリース 6.0 から、レポート機能を Windows のシンクライアントで利用できる
ようになりました。レポートリクエストの生成とレポート出力へのアクセスは、
Siebel のシンクライアントの場合も専用クライアントの場合も機能的にほぼ同じ
です。ただし、次の点が異なります。
„
レポートの実行ダイアログボックス
シンクライアント環境では、ユーザーがこのダイアログボックスで [ 今実行
する ] オプションを選択した場合、実際にはローカルマシン上でレポートの
生成と実行は行われません。代わりに、レポートリクエストが即時処理とし
てレポートサーバーに送信されます。Siebel アプリケーションは、レポート
生成プロセスの完了を検出するまで、継続的にサーバーのポーリングを実行
します。レポート生成が完了すると、Web ブラウザの子ウィンドウが開いて、
レポート出力が表示されます。
[ あとで実行する ] オプションの動作は、シンクライアントの場合も専用クラ
イアントの場合も同じです。
バージョン 6.0
„
エクスプローラービュー
このビューは、Siebel シンクライアントでは利用できません。同じ機能が提
供される [ レポート ( 個人 )] ビューを使用してください。
„
レポート ( 個人 ) ビュー
Siebel シンクライアントでは、クライアントモード ([ 今実行する ] オプショ
ン ) で開始された場合もサーバーモードで開始された場合も、このビューに
レポートが表示されます。接続クライアントの場合、このビューには、サー
バーモードのレポートだけが表示されます。
Siebel レポートガイド
1 2- 2 9
Reports.book
30 ページ
２００１年４月２７日　金曜日　午前１１時２７分
サーバーベースおよび シンクライアントのレポート機能
シンクライアントのレポート機能
12 - 3 0
Siebel レポートガイド
バージョン 6.0
Reports.book
1 ページ
２００１年４月２７日　金曜日　午前１１時２７分
既存のカスタムレポートの
バージョン 6.0 への移行
13
この章について . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-2
ssSiebel.bas ライブラリ関数 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-3
オブジェクトに対する整数型参照 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-4
メソッド名の接頭辞 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-5
ssBusComp 接頭辞 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-5
ssModel 接頭辞 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-6
ssBusObj 接頭辞 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-7
InvokeMethod . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-7
メッセージボックス . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-8
CreateObject . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13-9
バージョン 6.0
Siebel レポートガイド
13 - 1
Reports.book
2 ページ
２００１年４月２７日　金曜日　午前１１時２７分
既存のカスタムレポートの バージョン 6.0 への移行
この章について
この章について
M
6.0 より前のバージョンの Siebel eBusiness Applications 用として作成された Siebel
カスタムレポートは、レポートサーバーでは正しく実行されません。カスタムレ
ポートの Actuate Basic コードを変更して、レポートサーバー環境との互換性を
実現する必要があります。この章では、このコードに適用する必要がある変更に
ついて説明します。
6.0 より前のバージョンの環境では、レポート機能は同じクライアントマシンに
置かれている Siebel アプリケーションと Actuate ソフトウェアの間で OLE オー
トメーションを直接利用していました。レポートサーバーとシンクライアントで
は、このようなやりとりを行うことはできません。
この代わりとして、プラットフォームに依存せずにオブジェクトにアクセスでき
るよう、ライブラリメソッドが提供されています。カスタム設計およびライブラ
リファイルでは、オブジェクトの変数は対応するオブジェクトを参照する整変数
に置き換え、オブジェクトのメソッドはスタンドアロンのメソッドに置き換える
必要があります。詳細については、以降の項で説明します。
6.0 以降のバージョンの Siebel Tools でデータ供給ライブラリファイルを生成する
と、生成されたファイルには、新しいライブラリメソッドを使用する、アップグ
レード済みのデータアクセスロジックが含まれています。カスタムレポートが定
義されている場合は、Siebel Tools 6.0 でデータ供給ライブラリファイルを再生成
する必要があります。そうしないと、サーバーモードやシンクライアントモード
のレポート機能を使用できません。
備考 : 専用クライアントのクライアントモードでは、Siebel Tools 6.0 で再生成し
なくても、カスタムレポートのデータ供給ライブラリを引き続き使用できます。
13 - 2
Siebel レポートガイド
バージョン 6.0
Reports.book
3 ページ
２００１年４月２７日　金曜日　午前１１時２７分
既存のカスタムレポートの バージョン 6.0 への移行
ssSiebel.bas ライブラリ関数
ssSiebel.bas ライブラリ関数
M
バージョン 6.0 では、ssSiebel.bas という Actuate Basic のファイルに定義されてい
るライブラリ関数を使用して、Siebel と Actuate ソフトウェアとの間のやりとり
が行われます。ssSiebel.bas はバージョン 6.0 の ssSiebel.rol ライブラリにロードさ
れているので、明示的に設計ファイルに組み込む必要がありません。ssSiebel.bas
の関数によって、レポートと Siebel Application Server との間には、システムに依
存しない、使い易いインターフェースが提供されます。6.0 より前のバージョン
のレポート機能では、ssSiebel.bas の関数を使用できるのは一部のロールに限定
されていました。このライブラリファイルのロールが拡張されて、オブジェクト
のインターフェース関数が含まれるようになりました。
ssSiebel.bas では、オブジェクトのインターフェース関数は、すべてのレポート
( 標準レポートおよびカスタムレポート ) からの Siebel Application Server への唯
一のインターフェースとして設計されています。標準レポートの場合、必要な変
更はすでに適用されており、Siebel アプリケーションのアップグレード時にアッ
プグレード済みのファイルがインストールされます。カスタムレポートの場合、
通常は、データ供給ライブラリファイルを Siebel Tools で再生成し、そのレポー
ト設計を Actuate Developer Workbench で再コンパイルすると、レポートサーバー
で実行できるようになります。
カスタムレポートは、クライアントモードのレポート機能では正常に動作します
が、サーバーモードのレポート機能では動作しません。この場合、Microsoft
Windows に固有のオブジェクトインターフェース関数呼び出しはすべて、
ssSiebel.bas のオブジェクトインターフェース関数呼び出しに置き換える必要が
あります。
バージョン 6.0
Siebel レポートガイド
13 - 3
Reports.book
4 ページ
２００１年４月２７日　金曜日　午前１１時２７分
既存のカスタムレポートの バージョン 6.0 への移行
ssSiebel.bas ライブラリ関数
オブジェクトに対する整数型参照
M
ssSiebel.bas の関数は、Siebel Application Server の 4 つの基本オブジェクトであ
る、モデル、ビジネスオブジェクト、ビジネスコンポーネント、およびプロパ
ティセットを抽象化します。この 4 つのオブジェクトにアクセスするには、
ssSiebel.bas の関数を使用する必要があります。レポートは、これらのオブジェ
クトに対してタイプ Integer ( 整数型 ) の参照を使用します。
備考 : モデルとは、インターフェースによって公開される最上位オブジェクトへ
のハンドルです。OLE/COM の場合、モデルは SiebelApplicationServer です。
PropertySet オブジェクトについては、
『Siebel オブジェクトインターフェース』
で説明しています。
タイプ Object の変数は、すべてタイプ Integer に変更する必要があります。
ssSiebel.bas の関数は、これらの整数型参照を引数としてとることで、これらの参
照を使用してオブジェクトにアクセスしたり、オブジェクトを操作したりします。
整数型の値は、オートメーションまたは C++ オブジェクトへのハンドルです。
ssAppServer、ssBO、theBC および AppServer などの変数は、オブジェクト変数か
ら整変数に変換されます。例を次に示します。
Set theBC = ssManaged_Person_Forecast
.
.
ssManaged_Person_Forecast.InvokeMethod (...)
これは、次のように変更されます。
theBC = ssManaged_Person_Forecast
.
.
ssBusCompInvokeMethod (ssManaged_Person_Forecast, ...)
この例では、すべての変数がタイプ Integer に変換されるため、独自のメソッド
を持つオブジェクトとしては使用できなくなります。代わりに、オブジェクトの
操作には、ssSiebel.bas に固有のメソッド ( この例では ssBusCompInvokeMethod)
が使用されます。代替メソッドについては、13-5 ページの「メソッド名の接頭
辞」で説明しています。
変数が整数型なので、比較式では「is Nothing」の代わりに「= 0」を使用する必
要があります。
13 - 4
Siebel レポートガイド
バージョン 6.0
Reports.book
5 ページ
２００１年４月２７日　金曜日　午前１１時２７分
既存のカスタムレポートの バージョン 6.0 への移行
メソッド名の接頭辞
メソッド名の接頭辞
M
ビジネスコンポーネント、フィールド、ビジネスオブジェクトおよびアプリケー
ションサーバーに関するメソッドには、ピリオド (.) で区切ってオブジェクト変
数を指定することができなくなりました。すでに説明したように、オブジェクト
変数は整数型の参照変数に変わりました。ssSiebel.bas で提供されるスタンドア
ロンのメソッドの新機能は、オブジェクトのメソッドによって実行されていた機
能と同じです。これらのメソッドの名前は Siebel Object Interfaces の場合と同じで
すが、ssBusComp、ssBusObj または ssModel という接頭辞が付きます。
ssBusComp 接頭辞
M
API のメソッドでビジネスコンポーネントの変数または名前を使用するときは、
接頭辞 ssBusComp を持つ代替メソッドを使用します。たとえば、FirstRecord は
ssBusCompFirstRecord になり、SuppressNotification は
ssBusCompSuppressNotification になります。例を次に示します。
theBC.FirstRecord (errCode)
これは、次のように変更されます。
ssBusCompFirstRecord (theBC)
引数リストの指定されたメソッドの場合は、リストの最後の errCode 引数が削除
され、リストの先頭にビジネスコンポーネントの整数型引数が追加されます。例
を次に示します。
theBC.GetFieldValue ("City", errCode)
これは、次のように変更されます。
ssBusCompGetFieldValue (theBC, "City")
ビジネスコンポーネント変数など、特定のビジネスコンポーネントに対する参照
は、次のように、最初の引数として引数リストに挿入されます。
ssOpportunity.SuppressNotification (errCode)
これは、次のように変更されます。
ssBusCompSuppressNotification (ssOpportunity)
バージョン 6.0
Siebel レポートガイド
13 - 5
Reports.book
6 ページ
２００１年４月２７日　金曜日　午前１１時２７分
既存のカスタムレポートの バージョン 6.0 への移行
メソッド名の接頭辞
フィールドメソッドにも、接頭辞 ssBusComp が採用されます。フィールド名と
して最初の引数が追加され、errCode 引数は削除されます。例を次に示します。
ssAccount.SetSearchExpr (searchSpec, errCode)
これは、次のように変更されます。
ssBusCompSetSearchExpr (ssAccount, searchSpec)
別の例を示します。
ssAccount.SetViewMode (ssReport::ssViewMode, errCode)
これは、次のように変更されます。
ssBusCompSetViewMode (ssAccount, CInt (ssReport::ssViewMode))
2 つ目の例では、ビューモード ( 表示 ) の設定を示しています。ビューモードは、
ユーザービュー、管理者ビューなどに明示的に設定できます。詳細については、
『Siebel オブジェクトインターフェース』の「SetViewMode」を参照してくださ
い。ssBusCompSetViewMode 関数では、ssViewMode には整数型の値が想定されま
すが、ssReport のパラメータの値はストリング型なので、変換する必要がありま
す。
ssModel 接頭辞
M
AppServer 関連のメソッドには、接頭辞 ssModel が付きます。errCode 引数は削除
され、最初の引数としてアプリケーションサーバー名または変数が新たに追加さ
れます。例を次に示します。
ssAppServer.ActiveBusObject (errCode)
これは、次のように変更されます。
ssModelActiveBusObject (ssAppServer)
別の例を示します。
ssAppServer.GetBusObject (ssReport::ssBusObjectName, errCode)
これは、次のように変更されます。
ssModelGetBusObject (ssAppServer, ssReport::ssBusObjectName)
13 - 6
Siebel レポートガイド
バージョン 6.0
Reports.book
7 ページ
２００１年４月２７日　金曜日　午前１１時２７分
既存のカスタムレポートの バージョン 6.0 への移行
メソッド名の接頭辞
ssBusObj 接頭辞
M
ビジネスオブジェクトに関連するメソッド名には、接頭辞 ssBusObj が付きます。
errCode 引数は削除され、最初の引数としてビジネスオブジェクト名または変数
が新たに追加されます。例を次に示します。
busObjName = ssBO.Name (errCode)
これは、次のように変更されます。
busObjName = ssBusObjGetName (ssBO)
別の例を示します。
ssBO.GetBusComp ("Account", errCode)
これは、次のように変更されます。
ssBusObjGetBusComp (ssBO, "Account")
InvokeMethod
M
ビジネスコンポーネントでは、InvokeMethod の代わりに
ssBusCompInvokeMethod が使用されます。appServer や ssAppServer の場合は、
ssModelInvokeMethod が InvokeMethod の代わりとして使用されます。どちらの場
合も、errCode パラメータは使用されなくなりました。
ビジネスコンポーネントでメソッドを呼び出す場合の例を次に示します。
theBC.InvokeMethod ("Account Status", errCode)
これは、次のように変更されます。
ssBusCompInvokeMethod (theBC, "Account Status")
アプリケーションサーバーでメソッドを呼び出す場合の例を示します。
AppServer.InvokeMethod (parameters)
これは、次のように変更されます。
ssModelInvokeMethod (parameters)
バージョン 6.0
Siebel レポートガイド
13 - 7
Reports.book
8 ページ
２００１年４月２７日　金曜日　午前１１時２７分
既存のカスタムレポートの バージョン 6.0 への移行
メッセージボックス
メッセージボックス
M
レポートでは、
エラーのレポートにメッセージボックスがよく使用されます。
メッ
セージボックスはクライアントマシンの Windows プラットフォームだけに関連し
ており、レポートサーバーでバッチモードのレポートを生成している場合、この
機能は使用できません。ssSiebel.bas では、オペレーティングシステムに依存せず
に、レポートが実行されている環境に適した動作でエラーレポートを生成する関
数が提供されます。
.ROL ファイルおよび .ROD ファイルのメソッドコードでは、MsgBox 関数の代わ
りに ssDisplayMessage または ssProcessLastError が使用されます。どちらが使用さ
れるかは、AppServer 変数が使用されているかどうかによって決まります。情報
ストリングを表示するメッセージボックスで ssDisplayMessage を使用する例を示
します。
MsgBox (string)
これは、次のように変更されます。
ssDisplayMessage (string)
AppServer または ssAppServer 変数を使用するメッセージボックスで
ssProcessLastError 関数を使用する例を示します。
MsgBox ssAppServer.GetLastErrText ()
これは、次のように変更されます。
ssProcessLastError (ssAppServer, "", "")
ssProcessLastError 関数の構文は、次のとおりです。
ssProcessLastError (object_integer, pre_message_string,
post_message_string)
13 - 8
Siebel レポートガイド
バージョン 6.0
Reports.book
9 ページ
２００１年４月２７日　金曜日　午前１１時２７分
既存のカスタムレポートの バージョン 6.0 への移行
CreateObject
CreateObject
M
CreateObject は ssConnect に変更されます。ssiSiebelServer は、接続の追跡記録を
行うグローバル整変数です。例を次に示します。
If (ssAppServer is Nothing) Then
Set ssAppServer = CreateObject (ssReport::ssOLEServer)
If (ssAppServer is Nothing) Then
Start = False
Exit Function
End If
End If
これは、次のように変更されます。
ssReport::ssiSiebelServer = ssConnect (ssReport::ssOLEServer)
If (ssReport::ssiSiebelServer = 0) Or (errCode <> 0) Then
ssDisplayMessage ("Login Failed!")
Exit Sub
End If
バージョン 6.0
Siebel レポートガイド
13 - 9
Reports.book
10 ページ
２００１年４月２７日　金曜日　午前１１時２７分
既存のカスタムレポートの バージョン 6.0 への移行
CreateObject
13 - 1 0
Siebel レポートガイド
バージョン 6.0
Reports.book
1 ページ
２００１年４月２７日　金曜日　午前１１時２７分
Actuate 以外のソフトウェア製品を使用した
Siebel レポート
14
この章について . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-2
Microsoft Access レポートの設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-3
Siebel Tools でのレポートの定義 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-4
Siebel.mdb ファイルの作成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-6
Microsoft Access 用 ODBC データソースの設定 . . . . . . . . . . . . . . . . . . . . . . . 14-6
設定ファイルの内容の追加または変更 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-8
カスタムデータベースファイルの作成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-9
Siebel アプリケーションからのレポートの呼び出し . . . . . . . . . . . . . . . . . . 14-13
Microsoft Excel レポートの設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-14
Siebel Tools でのレポートの定義 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-15
区切りテキスト用 ODBC データソースの設定 . . . . . . . . . . . . . . . . . . . . . . . 14-17
Seagate Crystal Reports の設定 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14-18
Siebel OLE DB Provider を介したレポート用データへのアクセス . . . . . . 14-19
バージョン 6.0
Siebel レポートガイド
14 - 1
Reports.book
2 ページ
２００１年４月２７日　金曜日　午前１１時２７分
Actuate 以外のソフトウェア製品を使用した Siebel レポート
この章について
この章について
N
Siebel アプリケーションでは、Actuate 以外のサードパーティ製レポート用ソフト
ウェア製品を使用してレポートを作成することもできます。このレポート機能を
Siebel オープンレポートアーキテクチャといいます。データを .MDB ファイルと
して Microsoft Access のテーブルにエクスポートしたり、区切りテキストとして
テキストファイルにエクスポートしたりできます。Microsoft Access、Microsoft
Excel、および Seagate Crystal Reports などのアプリケーションは、ビューの [ レ
ポート ] メニューから開くことができます。[ レポート ] メニューオプションが適
切に設定されている場合、このオプションを選択すると、( レポートビューアの
代わりに)呼び出されたアプリケーションに生成されたレポートが表示されます。
必要に応じて、Actuate のレポートと Actuate 以外のレポートを 1 つのアプリケー
ションおよび 1 つのビューに同時に表示することができます。あるビューにおけ
るある [ レポート ] メニューオプションは、
対応するレポートおよびビューレポー
トオブジェクトの定義に従って、1 つのレポートソフトウェア製品に固有のもの
です。
この章では、Microsoft Access および Microsoft Excel のレポートの設定について
説明し、Seagate Crystal Reports の設定プロセスについても簡単に説明します。ま
た、Siebel OLE DB Provider を介して Siebel ビジネスコンポーネントをレポート
に使用する方法についても説明します。
備考 : オープンレポートアーキテクチャは、データのエクスポート、およびエク
スポートしたデータに基づくレポート作成のためのインターフェースをサポート
しています。Siebel では、このインターフェースを介したレポート作成におい
て、特定のサードパーティ製ソフトウェアやバージョンのサポートを保証しませ
ん。この章で紹介するサンプルは例として挙げたものであり、特定のソフトウェ
アのバージョンをサポートしていることを示すものではありません。
14 - 2
Siebel レポートガイド
バージョン 6.0
Reports.book
3 ページ
２００１年４月２７日　金曜日　午前１１時２７分
Actuate 以外のソフトウェア製品を使用した Siebel レポート
Microsoft Access レポートの設定
Microsoft Access レポートの設定
N
Siebel アプリケーションから Microsoft Access のレポートを呼び出すと、Siebel レ
ポートビューアの代わりに Microsoft Access アプリケーションが開いて、
Microsoft Access アプリケーションのウィンドウにレポートが表示されます。
Microsoft Access で表示された Siebel レポートを図 14-1 に示します。
図 14-1
Microsoft Access で表示されたパイプラインレポート
バージョン 6.0
Siebel レポートガイド
14 - 3
Reports.book
4 ページ
２００１年４月２７日　金曜日　午前１１時２７分
Actuate 以外のソフトウェア製品を使用した Siebel レポート
Microsoft Access レポートの設定
このレポート動作の設定およびレポートの実行は、主に次のステップで構成され
ます。
„
Siebel Tools でレポートを定義する。
„
すべてのレポートで使用する Siebel.mdb ファイルを作成する。
„
Access レポート用の ODBC ドライバを設定する。
„
設定ファイルの内容を追加または変更する。
„
レポート用のカスタムデータベースファイルを作成する。
„
Siebel アプリケーションからレポートを呼び出す。
次に、これらの各ステップについて詳しく説明します。
Siebel Tools でのレポートの定義
N
Access レポートでのレポートオブジェクトの定義は Actuate レポートの場合とほ
ぼ同じですが、次に示す一部のプロパティの設定が異なります。子フィールド、
サブレポート、サブレポートフィールドオブジェクトの定義はどちらの環境でも
同じように使用できます。Access レポートの場合は、次のプロパティを設定す
る必要があります。
14 - 4
„
Name
レポート名。この値は、ビューレポートオブジェクトの定義で参照されます。
Access レポートの場合は、Name プロパティにハイフン文字を使用できませ
ん。既存の Actuate レポートをコピーして Access レポートとして使用する場
合、名前にハイフンが含まれているときはハイフンを除去してください。ま
た、.MDB ファイルに定義するマクロ名は、Siebel Tools での名前と完全に一
致している必要があります。
„
Access Base DB Name
Access レポートのデザインが定義されている、Access データベースファイル
( カスタムデータベースともいう ) の名前。カスタムデータベースを
C:¥Siebel¥reports フォルダ ( あるいはこれに相当するシステムフォルダ ) に作
成し、このデータベースの名前を Access Base DB Name プロパティに入力し
ます。このデータベースファイルには、Siebel.mdb でレポートを生成すると
きに使用するレポートデザインおよびマクロ仕様が定義されています。14-9
ページの「カスタムデータベースファイルの作成」を参照してください。
Siebel レポートガイド
バージョン 6.0
Reports.book
5 ページ
２００１年４月２７日　金曜日　午前１１時２７分
Actuate 以外のソフトウェア製品を使用した Siebel レポート
Microsoft Access レポートの設定
„
Business Component
レポートの基礎データとして使用するビジネスコンポーネントの名前。
„
Class
CSSAccessReport に設定します。これにより、Actuate その他のレポートでは
なく、Access レポートであることが指定されます。
„
Current Record Only
使用方法は、Actuate レポートの場合と同じです。
„
Dynamic View
TRUE に設定します。Access レポート機能では、静的レポートはサポートさ
れません。
„
Export System Fields
TRUE に設定します。
„
Menu Text
使用方法は、Actuate レポートの場合と同じです。
„
Search Specification と Sort Specification
指定は任意です。使用方法は、Actuate レポートの場合と同じです。
変更を適用するには、レポジトリをコンパイルして、結果の .SRF ファイルを
C:¥Siebel¥objects ( あるいはこれに相当するシステムフォルダ ) にコピーする必要
があります。
バージョン 6.0
Siebel レポートガイド
14 - 5
Reports.book
6 ページ
２００１年４月２７日　金曜日　午前１１時２７分
Actuate 以外のソフトウェア製品を使用した Siebel レポート
Microsoft Access レポートの設定
Siebel.mdb ファイルの作成
N
Siebel アプリケーションで使用する、Siebel.mdb という名前のスクラッチパッド
データベースファイルを作成する必要があります。これは、Access データベー
スファイルであり、最初は空です。
このファイルの名前は、Siebel.mdb でなければなりません。Siebel.mdb は、
Microsoft Access で作成することも、ODBC データソースの定義時に [ODBC デー
タソースアドミニストレータ ] ウィンドウで [ 作成 ] ボタンをクリックして生成
することもできます。通常、Siebel.mdb は C: ドライブのルートディレクトリに
置かれていますが、必要に応じて、他の場所に置くこともできます。ただし、
ODBC データソースが Siebel.mdb を指すように適切に設定する必要があります。
Siebel アプリケーションは、Siebel.mdb データベースを使用して、テーブルの作
成およびテーブルへのデータの挿入を行うことにより、現在のレポートを生成し
ます。レポートの生成では、レポート用としてカスタムデータベースファイルに
定義したデザイン、および指定したすべてのマクロが使用されます。
各レポートの実行中に、Siebel.mdb の既存のテーブル、レポートデザイン、およ
びマクロは、生成されるレポートのテーブル、レポートデザインおよびマクロで
オーバーライトされます。レポート出力を保存しておく場合や別のユーザーに送
信する場合は、実行後に Siebel.mdb ファイルをコピーして別の名前で保存でき
ます。Siebel.mdb の内容は、次にレポートを実行したときにオーバーライトされ
ます。
Microsoft Access 用 ODBC データソースの設定
N
Siebel アプリケーションから Microsoft Access を開いて、レポート用として
Siebel.mdb ファイルにレコードをエクスポートできるようにするには、Access 用
の ODBC データソースを作成し、これを適切に設定する必要があります。
備考 : Access レポートの場合、レポートオブジェクト定義の ODBC Source Name
プロパティは使用しないので、空白にしておく必要があります。ただし、
Microsoft Windows で ODBC データソースを設定する必要があります。
14 - 6
Siebel レポートガイド
バージョン 6.0
Reports.book
7 ページ
２００１年４月２７日　金曜日　午前１１時２７分
Actuate 以外のソフトウェア製品を使用した Siebel レポート
Microsoft Access レポートの設定
Access レポート用 ODBC ドライバを設定するには
1 [ スタート ] メニューから、[ 設定 ] → [ コントロールパネル ] → [ODBC デー
タソース ] の順に選択します。
これにより、次に示すような [ODBC データソースアドミニストレータ ] ダイ
アログボックスが開きます。
このダイアログボックスには、使用中のクライアントコンピュータに定義さ
れている既存の ODBC データソースがリスト表示されます。ここでは、新し
いデータソースを追加したり、既存のデータソースの設定を変更することが
できます。
2 [ODBC データソースアドミニストレータ ] ウィンドウで、Microsoft Access 用
のデータソースがあるかどうかを確認します。
Microsoft Access 用のデータソースは、[ ドライバ ] カラムの値が Microsoft
Access Driver (.mdb) になっています。
3 Microsoft Access 用のデータソースがない場合は、[ 追加 ] をクリックし、
「Microsoft Access Driver」を選択して [ 完了 ] をクリックします。
4 [ODBC Microsoft Access セットアップ ] ウィンドウが表示されます。データ
ソース名および説明を指定します。
バージョン 6.0
Siebel レポートガイド
14 - 7
Reports.book
8 ページ
２００１年４月２７日　金曜日　午前１１時２７分
Actuate 以外のソフトウェア製品を使用した Siebel レポート
Microsoft Access レポートの設定
5 Siebel.mdb ファイルが存在する場合は、[ 選択 ] をクリックし、[ データベー
スの選択 ] ウィンドウでこのファイルの場所を指定します。
Siebel.mdb ファイルが存在しない場合は、[ 作成 ] ボタンをクリックし、
[ データベースの新規作成 ] ウィンドウでデータベース名とその保存場所を指
定します。14-8 ページの「設定ファイルの内容の追加または変更」に説明し
ているように、後で設定ファイルの指定で使用できるように、データソース
名を控えておいてください。
6 [ODBC データソースアドミニストレータ ] ダイアログボックスを閉じます。
設定ファイルの内容の追加または変更
N
Siebel アプリケーションから Microsoft Access のレポートを開けるようにするに
は、各クライアントコンピュータで Siebel アプリケーション用の設定 (.CFG)
ファイルで 2 つのパラメータを設定する必要があります。この 2 つのパラメータ
について説明します。
„
AccessDir
このパラメータは、Microsoft Access ソフトウェア実行可能プログラム
Msaccess.exe が置かれているディレクトリを示します。構文は次のとおりです。
AccessDir = "Access_path¥Msaccess.exe"
たとえば、Msaccess.exe 実行可能プログラムが C:¥Program Files¥Microsoft
Office¥Office に置かれている場合、このパラメータ行は次のようになります。
AccessDir =
"C:¥Program Files¥Microsoft Office¥Office¥Msaccess.exe"
„
ReportsODBCDataSource
このパラメータは、Siebel.mdb ファイルにアクセスするために Siebel アプリ
ケーションで使用する ODBC データソースを示します。構文は次のとおり
です。
ReportsODBCDataSource = "ODBC_datasource"
このとき、ODBC_datasource は、14-6 ページの「Microsoft Access 用 ODBC
データソースの設定」で指定したデータソースの名前です。
14 - 8
Siebel レポートガイド
バージョン 6.0
Reports.book
9 ページ
２００１年４月２７日　金曜日　午前１１時２７分
Actuate 以外のソフトウェア製品を使用した Siebel レポート
Microsoft Access レポートの設定
カスタムデータベースファイルの作成
N
定義した Access レポートごとに、1 つのカスタムソースデータベースファイル
を作成する必要があります。
Access レポート用の各レポートオブジェクト定義は、(Access Base DB Name プロ
パティで ) カスタムデータベースファイルを指し示します。カスタムデータベー
スファイルには、ユーザー定義のレポートデザインおよびマクロが定義されてい
ます。各 Access レポート定義ごとに、1 つのカスタムデータベースファイルを
作成します。カスタムデータベースには、レポートを開いて最大化するためのレ
ポートデザインとマクロが定義されています。レポートデザインとマクロについ
て、次に説明します。
レポートデザイン
レポートデザインは、生成されるレポートのフォーマットを定義します。
Microsoft Access のカスタムデータベースファイルの [ レポート ] タブで、新しい
レポートオブジェクトを作成します。
カスタムデータベースファイルでレポートデザインを作成するには
1 カスタムデータベースファイルを開き、[ レポート ] タブをクリックします。
2 [ 新規作成 ] ボタンをクリックします。
3 [ レポートの新規作成 ] ダイアログボックスで、次の値を入力し、[OK] をク
リックします。
バージョン 6.0
„
デザインオプションのリストから、[ デザインビュー ] オプションを選択し
ます。
„
[ 基になるテーブル / クエリーの選択 ] テキストボックスに、レポートへの
データの取り込み元となるビジネスコンポーネントの名前を ( 大文字小文
字を区別して ) 入力します。
Siebel レポートガイド
14 - 9
Reports.book
10 ページ
２００１年４月２７日　金曜日　午前１１時２７分
Actuate 以外のソフトウェア製品を使用した Siebel レポート
Microsoft Access レポートの設定
次に示すようなレポートデザインウィンドウが表示されます。
4 メニューバーから、[ ファイル ] → [ 上書き保存 ] を選択します。[ 名前を付
けて保存 ] ダイアログボックスで、対応するレポートオブジェクト定義の
Name プロパティの値と完全に一致する名前をレポート名として指定し、
[OK] をクリックします。
5 [ 表示 ] → [ ツールボックス ] を選択して、ツールボックスを表示します。
6 [ 表示 ] → [ レポートヘッダー / フッター ] を選択して、ヘッダーセクション
とフッターセクションを表示します。
7 選択範囲を示す四角形をドラッグ操作により広げることにより、レポート領
域全体を強調表示します。[ 表示 ] → [ プロパティ ] の順に選択し、[ 書式 ] タ
ブの [ 幅 ] プロパティを「9"」に設定します。
14 - 1 0
Siebel レポートガイド
バージョン 6.0
Reports.book
11 ページ
２００１年４月２７日　金曜日　午前１１時２７分
Actuate 以外のソフトウェア製品を使用した Siebel レポート
Microsoft Access レポートの設定
8 [ ラベル ] ツールを選択し、レポートヘッダーラベル用として十分なサイズの
四角形をドラッグ操作により [ レポートヘッダー ] セクションに作成します。
ラベルコントロールにレポートヘッダーテキスト ( たとえば、「取引先リス
ト」) を入力します。[ プロパティ ] ウィンドウの [ すべて ] タブでラベルコ
ントロールの名前を入力し、適切なフォント設定を選択します。たとえば、
20 ポイントの Times New Roman で色は 128 ( 栗色 )、[ フォント太さ ] は「太
字」に設定します。
9 [ ページヘッダー ] セクションで、各カラムのヘッダーのラベルコントロール
をドラッグ操作により作成します。各ラベルコントロールにラベルテキスト
を入力し、[ プロパティ ] ウィンドウの [ すべて ] タブで適切なフォント設定
( たとえば、10 ポイントの太字 Arial) を選択します。
10 [ ページヘッダー ] セクションのカラムヘッダーのラベルコントロールの下
に、[ 直線 ] ツールを使用して実線を引きます。
11 ウィンドウペイン境界をドラッグすることにより、[ 詳細 ] セクションの高さ
をテキストコントロール 1 つ分の高さに縮めます。
12 [ 詳細 ] セクションで、各レポートフィールド用のテキストボックスコント
ロールをドラッグ操作により作成します。[ データ ] タブの [ コントロール
ソース ] プロパティに、エクスポートしたフィールドの名前 ( 対応するレ
ポートフィールドオブジェクト定義と同じ名前を使用 ) を入力します。適切
なフォントサイズに設定 ( たとえば、9 ポイントの Times New Roman) します。
13 [ ページフッター ] セクションに、[ 直線 ] ツールを使用して、水平線を追加
します。水平線の下に、テキストボックスコントロールを 2 つ追加します。
左側は日付と時刻用で、右側はページ番号用です。日付と時刻用のテキスト
ボックスには、[ コントロールソース ] の値として「=Now ()」と入力します。
ページ番号用のテキストボックスには、次の [ コントロールソース ] 値を入
力します。
"Page " & [Page] & " of " & [Pages]
14 [ レポートフッター ] セクションを縮めて高さ 0 にします。
15 メニューバーから [ ファイル ] → [ 上書き保存 ] を選択し、レポートデザイン
を保存します。
バージョン 6.0
Siebel レポートガイド
1 4- 1 1
Reports.book
12 ページ
２００１年４月２７日　金曜日　午前１１時２７分
Actuate 以外のソフトウェア製品を使用した Siebel レポート
Microsoft Access レポートの設定
Microsoft Access のデザインウィンドウに Siebel レポートが表示された例を図
14-2 に示します。
図 14-2
デザインウィンドウに表示された取引先リストレポート
レポートデザインの作成と変更については、Microsoft Access のマニュアルセッ
トを参照してください。
14 - 1 2
Siebel レポートガイド
バージョン 6.0
Reports.book
13 ページ
２００１年４月２７日　金曜日　午前１１時２７分
Actuate 以外のソフトウェア製品を使用した Siebel レポート
Microsoft Access レポートの設定
レポートを開いて最大化するためのマクロ
このマクロにより、Siebel アプリケーションでデータベースファイルを開いたと
きに、レポートが最大化されて開くことが保証されます。カスタムデータベース
ファイルの [ マクロ ] タブでは、レポートオブジェクト定義と同じ名前を持つ 2
段階ステップマクロを作成します。このマクロは、次の 2 つのステップで構成さ
れます。
„
OpenReport
このマクロステップには Report Name 引数と View 引数があります。Report
Name の設定は、マクロ名および対応するオブジェクト定義と一致する必要
があります。View 引数は「Print Preview」に設定します。
„
Maximize
このマクロステップには、引数はありません。
備考 : Access レポート用のオブジェクト定義の Name プロパティおよび Access で
の対応するマクロ名には、ハイフンを使用しないでください。
Siebel アプリケーションからのレポートの呼び出し
N
Access レポートは、ビューレポートオブジェクト定義の設定に基づいて、
ビューの [ レポート ] メニューオプションから呼び出します。この呼び出しで
は、次の手順が実行されます。
1 Microsoft Access アプリケーションのウィンドウが開きます。
2 Siebel.mdb データベースファイルに宛先テーブルが作成され、このテーブル
にビジネスコンポーネントのレコードが挿入されます。
3 [Microsoft Access] ウィンドウ内でレポートが開かれて、参照したり印刷した
りできるようになります。
後でレポートが必要になったり、受取人 ( 別のユーザー ) に送信する場合には、
生成されたレポートが格納されている .MDB ファイルに別の名前を付けて保存
できます。レポートデータが格納されている .MDB ファイルのテーブルは、
Siebel アプリケーションから次に Access レポートを実行したときに削除される
ので、現在のレポートインスタンスが消去されないように .MDB ファイルを別
の名前で保存する必要があります。
バージョン 6.0
Siebel レポートガイド
1 4- 1 3
Reports.book
14 ページ
２００１年４月２７日　金曜日　午前１１時２７分
Actuate 以外のソフトウェア製品を使用した Siebel レポート
Microsoft Excel レポートの設定
Microsoft Excel レポートの設定
N
Siebel アプリケーションから Microsoft Excel レポートを呼び出すと、Microsoft
Excel アプリケーションが開いて、Microsoft Excel アプリケーションのウィンド
ウにレポートが表示されます。Microsoft Excel にレポートが表示されている様子
を図 14-3 に示します。
図 14-3
Siebel アプリケーションから呼び出された Microsoft Excel レポート
14 - 1 4
Siebel レポートガイド
バージョン 6.0
Reports.book
15 ページ
２００１年４月２７日　金曜日　午前１１時２７分
Actuate 以外のソフトウェア製品を使用した Siebel レポート
Microsoft Excel レポートの設定
このレポートの動作の設定および実行は、主に次のステップで構成されます。
„
Siebel Tools でレポートを定義する。
„
Excelおよびその他の区切りテキストレポート用のODBCドライバを設定する。
„
Siebel アプリケーションからレポートを呼び出す。
次に、これらの各ステップについて詳しく説明します。
Siebel Tools でのレポートの定義
N
Excel レポートでのレポートオブジェクトの定義は Actuate や Access のレポート
の場合とほぼ同じですが、次に示す一部のプロパティの設定が異なります。子
フィールドオブジェクトの定義は、さまざまな環境で同じように使用できます。
Excel では、サブレポートはサポートされていません。Excel レポートの場合は、
次のプロパティを設定する必要があります。
„
Name
レポート名。この値は、ビューレポートオブジェクトの定義で参照されます。
„
Business Component
レポートの基礎データとして使用するビジネスコンポーネントの名前。
„
Class
CSSReport に設定します。これにより、Excel、Crystal Reports など、Actuate
および Access 以外のすべてのレポートソフトウェアで使用される区切りテキ
ストフォーマットでデータをエクスポートすることが指定されます。
„
Command Line
このプロパティ内のテキストには、DOS プロンプトから実行した場合に、生
成された区切りテキスト (.CSV) ファイルを Microsoft Excel で開くためのコマ
ンドラインが入ります。コマンドラインの構文は次のとおりです。
Excel_executable_path¥Excel.exe textfile_path¥textfile_name
バージョン 6.0
Siebel レポートガイド
1 4- 1 5
Reports.book
16 ページ
２００１年４月２７日　金曜日　午前１１時２７分
Actuate 以外のソフトウェア製品を使用した Siebel レポート
Microsoft Excel レポートの設定
textfile_path の値は、C:¥Siebel¥bin ( あるいは使用中のコンピュータの該当す
るディレクトリパス ) です。たとえば、Microsoft Excel が C:¥Program
Files¥Microsoft Office¥Office にインストールされており、生成されたテキスト
ファイルが Activitylist.csv (Exported Table プロパティで指定 ) の場合、コマン
ドラインは次のようになります。
C:¥Program Files¥Microsoft Office¥Office¥Excel.exe
C:¥Siebel¥bin¥Activitylist.csv
備考 : コンパイル済みの .SRF ファイルに基づいて Excel レポートを実行する
場合、各ユーザーのコンピュータには、Command Line プロパティで指定され
ている場所に Microsoft Excel がインストールされている必要があります。別
の場所に Microsoft Excel がインストールされている場合は、レポートオブ
ジェクト定義でインストール場所に対応した Command Line 値を使用して、
個別の .SRF ファイルをコンパイルする必要があります。
„
Current Record Only
使用方法は、Actuate レポートの場合と同じです。
„
Dynamic View
TRUE に設定します。Excel レポート機能では、静的レポートはサポートされ
ません。
„
Export System Fields
TRUE に設定します。
„
Exported Table
このプロパティ設定には、生成する .CSV ( コンマ区切りテキスト ) ファイル
の名前を指定します。ファイル名は、次に示すように、パス付きまたはパス
なしで指定できます。
„
14 - 1 6
Without the path
ファイルは、C:¥Siebel¥bin ディレクトリに作成されます。[ODBC データ
ソースアドミニストレータ ] ウィンドウの [ 代わりに現在のディレクトリ
を使う ] チェックボックスを TRUE ( オン ) に設定する必要があります。
Siebel レポートガイド
バージョン 6.0
Reports.book
17 ページ
２００１年４月２７日　金曜日　午前１１時２７分
Actuate 以外のソフトウェア製品を使用した Siebel レポート
Microsoft Excel レポートの設定
„
With the path
ファイルは、指定したパスに作成されます。[ODBC データソースアドミ
ニストレータ ] ウィンドウの [ 代わりに現在のディレクトリを使う ]
チェックボックスを FALSE ( オフ ) に設定する必要があります。
„
Menu Text
使用方法は、Actuate レポートの場合と同じです。
„
ODBC Source Name
14-17 ページの「区切りテキスト用 ODBC データソースの設定」で説明して
いるように、Excel その他の区切りテキストのレポートに使用する ODBC
データソース名を指定します。
„
Search Specification と Sort Specification
指定は任意です。使用方法は、Actuate レポートの場合と同じです。
変更を適用するには、レポジトリをコンパイルして、この結果として生成された
.SRF ファイルを C:¥Siebel¥objects ( あるいはこれに相当するシステムフォルダ )
にコピーする必要があります。
区切りテキスト用 ODBC データソースの設定
N
Excel レポート用の ODBC ドライバの定義プロセスは、14-6 ページの「Microsoft
Access 用 ODBC データソースの設定」で説明している Access レポートの場合と
ほぼ同じです。ただし、Excel その他の区切りテキストレポートの場合は、有効
なドライバが Microsoft Access Driver (.mdb) ではなく、Microsoft Text Driver (.txt,
.csv) であること、および宛先データベースファイルを指定する必要がない点が
異なります。
備考 : Microsoft Excel Driver (.xls) というドライバ名のデータソースは使用しない
でください。Siebel アプリケーションではカンマ区切り形式 (.CSV) ファイルが
生成されますが、.XLS ファイル用のデータソースは、レポート生成という点で
は Siebel アプリケーションに対応していません。
Excel レポートを生成する各ユーザーのコンピュータで、Microsoft Text Driver に
基づいてデータソースを作成します。このとき、データソース名は、レポートオ
ブジェクト定義の ODBC Source Name プロパティの値に一致させます。
バージョン 6.0
Siebel レポートガイド
1 4- 1 7
Reports.book
18 ページ
２００１年４月２７日　金曜日　午前１１時２７分
Actuate 以外のソフトウェア製品を使用した Siebel レポート
Seagate Crystal Reports の設定
Seagate Crystal Reports の設定
N
Crystal Reports では、Microsoft Excel レポートの場合と同じようなプロセスでレ
ポートを生成できます。Crystal Reports と Excel レポートには、次のような共通
点と相違点があります。
„
どちらの場合も、Microsoft Text Driver (.txt, .csv) に基づくデータソースを使用
してデータが渡されます。
„
どちらの場合も、レポートオブジェクト定義の Class の設定は CSSReport です。
CSSCrystalReport クラスは、現在のところ eBusiness アプリケーションでの使
用をサポートしていません。CSSReport を使用してください。
„
Crystal Reports の場合、Command Line プロパティには、実行可能プログラムと
してレポート名を指定します。Excel レポートの場合、このプロパティにはア
プリケーションソフトウェア名を指定します。Crystal Reports の場合、
Command Line プロパティの構文は次のとおりです。
Crystal_report_path¥report_name.exe
Crystal_report_path の値は、C:¥Siebel¥reports ( あるいは使用中のコンピュー
タの該当するディレクトリパス ) です。たとえば、生成された区切りテキス
トレポートファイルが Accountlist.txt (Exported Table プロパティで指定 ) の場
合、コマンドラインの設定は次のようになります。
C:¥Siebel¥reports¥Accountlist.exe
„
生成された区切りテキストファイルの名前は、パス付きまたはパスなしで、
Exported Table プロパティに指定します。得意先リストの例の場合、この値
( パスなし ) は次のようになります。
Accountlist.txt
„
Excel レポートの場合、パス名の指定は任意ですが、パスを指定する場合も指
定しない場合も、この設定は次に示すように [ODBC データソースアドミニ
ストレータ ] ウィンドウの [ 代わりに現在のディレクトリを使う ] チェック
ボックスの設定と一致させる必要があります。
„
14 - 1 8
Without the path
ファイルは、C:¥Siebel¥bin ディレクトリに作成されます。[ODBC データ
ソースアドミニストレータ ] ウィンドウの [ 代わりに現在のディレクトリ
を使う ] チェックボックスを TRUE ( オン ) に設定する必要があります。
Siebel レポートガイド
バージョン 6.0
Reports.book
19 ページ
２００１年４月２７日　金曜日　午前１１時２７分
Actuate 以外のソフトウェア製品を使用した Siebel レポート
Siebel OLE DB Provider を介した レポート用データへのアクセス
„
With the path
ファイルは、指定したパスに作成されます。[ODBC データソースアドミ
ニストレータ ] ウィンドウの [ 代わりに現在のディレクトリを使う ]
チェックボックスを FALSE ( オフ ) に設定する必要があります。
Siebel OLE DB Provider を介した
レポート用データへのアクセス
N
Siebel OLE DB Provider は、Siebel ビジネスコンポーネントを仮想の OLE DB テー
ブルとして扱う、読み込み専用のオブジェクトです。外部の OLE DB 対応アプ
リケーション (Microsoft Excel や Microsoft Access など ) を介して Siebel OLE DB
Provider に接続すると、Siebel Database からクエリーを実行してピボットテーブ
ル、グラフその他の適切なデータコントロールにデータを取り込む場合と同じよ
うに、動的にデータを参照できます。
OLE DB Provider 方式は、通常の方法を使って Siebel Tools に Access や Excel のレ
ポートを実装することの代替方式として使用できます。OLE DB には、Siebel
Tools における従来のレポート定義と比べて、プラス面とマイナス面があります。
Siebel OLE DB Provider を介して Access または Excel のレポートを設定する方法
については、『Siebel eBusiness Application Integration (EAI) ガイド』を参照してく
ださい。
バージョン 6.0
Siebel レポートガイド
1 4- 1 9
Reports.book
20 ページ
２００１年４月２７日　金曜日　午前１１時２７分
Actuate 以外のソフトウェア製品を使用した Siebel レポート
Siebel OLE DB Provider を介した レポート用データへのアクセス
14 - 2 0
Siebel レポートガイド
バージョン 6.0
Reports.book
1 ページ
２００１年４月２７日　金曜日　午前１１時２７分
ライブラリリファレンス
A
この付録について . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-3
ssCustom ライブラリ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-3
テキストコントロール . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-3
売上情報の表示 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-6
日付情報の表示 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-7
CanGrow プロパティ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-9
チェックボックステキストコントロール . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-9
パーセントテキストコントロール . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-9
ラベルコントロール . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-10
フレームコントロール . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-11
ページリストおよび子コンポーネント . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-11
その他のコントロール . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-13
ラインコントロール . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-13
セクションコンポーネント . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-14
ssSiebel ライブラリ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .A-15
baseCur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-16
baseDate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-16
baseDateDisplay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-16
baseFlow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-17
baseFlow1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-17
baseFrm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-18
baseGrp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-18
baseInt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-19
baseLbl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-19
baseLblSiebel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-19
バージョン 6.0
Siebel レポートガイド
A-1
Reports.book
2 ページ
２００１年４月２７日　金曜日　午前１１時２７分
ライブラリリファレンス
baseLineControlr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-20
basePage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-20
basePageList . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-21
basePageNoDisplay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-21
basePrintBy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-22
baseReport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-22
baseReportHeader . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-23
baseReportTitle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-23
baseRpt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-24
baseRptCreateBy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-24
baseSeq . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-24
baseSubPage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-25
baseTxt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-25
A-2
Siebel レポートガイド
バージョン 6.0
Reports.book
3 ページ
２００１年４月２７日　金曜日　午前１１時２７分
ライブラリリファレンス
この付録について
この付録について
A
この付録には、ssCustom ライブラリと ssSiebel ライブラリのライブラリコンポー
ネントに関するリファレンス情報が収録されています。
ssCustom ライブラリ
A
ssSiebel ライブラリのコンポーネントは、ssCustom ライブラリでサブクラス化さ
れています。ssCustom ライブラリのコンポーネントは、ssCustom 内でさらにサ
ブクラス化されることがあります。
ssSiebel ライブラリのコンポーネントにはすべて base という接頭辞が付加されま
す。ssCustom ライブラリでサブクラス化された派生コンポーネントには、ss とい
う接頭辞が付加されます。ssCustom ライブラリに追加される ssTxt の派生コン
ポーネントにはすべて、接頭辞 ssTxt が付加されます。
このコンポーネント関係は、ラベルコントロール、日付コントロール、フレーム
コントロールにも当てはまります。ssReport や ssPageList などの複合オブジェク
トで使用する表記規則は多少異なります。basePage は ssPage ( 横置き ) に対する
スーパークラスで、ssPage は ssPagePortrait のスーパークラスです。複合オブ
ジェクトを変更するときは注意してください。
テキストコントロール
A
次のコンポーネントは、テキストの表示に使用します。
バージョン 6.0
„
ssTxt
基本テキストコントロール。
„
ssTxtB
太字テキストコントロール。
„
ssTxtBI
太字斜体テキストコントロール。
„
ssTxtBIueBack
太字テキストコントロール ( 青色の背景に白色のテキスト )。
Siebel レポートガイド
A-3
Reports.book
4 ページ
２００１年４月２７日　金曜日　午前１１時２７分
ライブラリリファレンス
ssCustom ライブラリ
„
ssTxtChkBox
チェックボックスコントロール。
„
ssTxtP
パーセントテキストコントロール。
„
ssTxtS
小さなテキストコントロール。
„
ssTxtSB
小さな太字テキストコントロール。
„
ssTxtSBI
小さな太字斜体テキストコントロール。
„
ssTxtSectionHead
セクションヘッドテキストコントロール。
„
ssTxtSectionHeadM
栗色セクションヘッドテキストコントロール。
„
ssTxtSNoRepeat
カレンダーレポートで使用する小さなテキストコントロール。
„
space
( 複数のテキストセクションを整列させるときの ) スペースコントロール。
Actuate では、OLE オートメーションを使用して、Siebel Application Server から
データを取得します。このアーキテクチャを初めて実行すると、データは、数値
や日付情報を含めて、すべてストリングデータタイプのフォーマットで転送され
ます。baseTxt コントロールは、ストリングデータの表示に最適なメソッドです。
Actuate では、ユーザーに意識されることなく、ストリングデータを別のコント
ロールタイプに変換できます。たとえば、使用しているコントロールが日付コン
トロールの場合、ストリングデータは日付データタイプに変換されます。ただ
し、複数の言語がサポートされている環境など、状況によっては、この暗黙的な
変換メソッドが日付や数値のデータに対して適切ではない場合があります。図
A-1 を参照してください。
A-4
Siebel レポートガイド
バージョン 6.0
Reports.book
5 ページ
２００１年４月２７日　金曜日　午前１１時２７分
ライブラリリファレンス
ssCustom ライブラリ
ROI - レポートページ
Actuate
Report
Factory
フェッチ
データ行
ストレージ変数 ストリング
変換なし
優先された
ssTxt
ストリングデータタイプ
明示的変換
優先された
ssDate
ストリングデータタイプ
暗黙的変換
優先されない
非AcTextControlスーパーの
非ストリングデータタイプ
OLE
Siebel App
Server
Siebel DB
図 A-1
Siebel Applications における Actuate コントロールの生成プロセス
A-5 ページの図 A-1 は、Actuate コントロールにデータが挿入されるまでのス
テップを示しています。OLE インターフェース経由で渡されたデータはすべて、
ストリングデータとして DataRow 変数に配置されます。ROI ページにコント
ロールのインスタンスを生成するときに、Actuate では、行からデータを取り出
して各種コントロールに挿入します。
表示データがストリングである場合、変換は行われません。これにより、複数の
言語に対して最適なサポートを提供できます。
日付情報と売上情報の場合では、処理方法が異なります。Siebel は、それぞれに
適した方法を開発しています。
バージョン 6.0
Siebel レポートガイド
A-5
Reports.book
6 ページ
２００１年４月２７日　金曜日　午前１１時２７分
ライブラリリファレンス
ssCustom ライブラリ
売上情報の表示
A
Siebel Tools でデータストリームを作成する場合、各フィールドはストリング
データタイプの DataRow 変数にマッピングされます。Siebel アプリケーション
でフィールドが通貨として定義されている場合、次の 2 つのストリング変数が
Siebel Tools によって DataRow にマッピングされます。
„
ssFieldName
„
ssFieldName_Formatted
標準的な売上には、フィールドの値がストリング形式 (「1243」や「1000000」)
で設定されます。フォーマットされた売上では、各レコード (「$1,243」や
「£1.000.000」) の通貨に適したフォーマット情報がフィールドの値に設定されま
す。データ計算の必要がない場合は、データフィールドをこのようにフォーマッ
トすると、見やすくなります。
テキストコントロールによって複数行のデータの合計を表す場合は、フォーマッ
トしていない売上金額を使用します。この合計算出機能では、データを合計する
前に、明示的にストリング情報を数値データタイプに変換する必要があります。
この変換は、次のように、ValueExp プロパティで実行できます。
Sum (Val(ssRevenueField))
Actuate では、フォーマットされたデータを合計することができないため、特に
指定しないかぎり、このようなデータ表現はフォーマットされません。
Siebel Application Server で InvokeMethod 機能を使うと、テキストコントロールは
どの通貨単位にも対応できます。コントロールの Finish メソッドに次のコードサ
ンプルを設定すると、テキストを適切にフォーマットできます。
Dim errCode As Integer
Dim aServer As Object
' Get a handle to the AppServer
Set aServer = ssSales_OrderQuery::ssAppServer
If aServer Is Nothing then
MsgBox "Failed to get handle to AppServer "
End If
' Tell the AppServerve that you want to use the USD currency code
' To use the default user currency pass an empty string ""
aServer.InvokeMethod ("SetCurrencyCode", "USD", errCode)
A-6
Siebel レポートガイド
バージョン 6.0
Reports.book
7 ページ
２００１年４月２７日　金曜日　午前１１時２７分
ライブラリリファレンス
ssCustom ライブラリ
' Now get the formatted currency string.First send the unformatted
' currency as a string.Based on the currency code previously set, the
' appropriate formatted currency will be returned as a string.
DataValue = aServer.InvokeMethod ("FormatCurrency", Str(DataValue),
errCode)
複数の通貨単位を計算するには、Siebel Tools で .ROL を定義するときに、レポー
トのフィールドやサブレポートのフィールドに、実売上 ( 機能通貨で表した売上
値 ) と機能通貨コード ( たとえば USD) を設定します。複数の通貨単位の計算例
については、標準レポートの営業員別パイプラインレポート (PIPEREP) を参照
してください。
日付情報の表示
A
日付情報は売上情報より複雑です。通貨情報と同様に、レポートオブジェクトの
各フィールドはデータ行で次の 2 つの変数にマッピングされます。
„
ssDateFieldName
標準的なフィールドでは、Siebel の内部日付を表すフォーマットである
「MM/DD/YY HH:MM:SS」の形式で表示されます。
„
ssDateFieldName_Formatted
フォーマットされたフィールドは、データ取得に使用するビジネスコンポー
ネント用として指定したフォーマットで表示され、マシンのロケール設定が
使用されます。システムの短縮日付フォーマットを使って日付を画面に表示
する場合、DataRow 変数には、マシンのロケール設定に応じて「31/12/01」
、
「12/31/01」
、「01/12/31」のいずれかのフォーマットでデータが設定されます。
ここで重要なのは、ストリングの場合、特にフォーマット作業を行うことな
く ssTxt コントロールを使って表示できるということです。Date_Formatted 情
報に ssDate コントロールを使おうとすると、Actuate Developer Workbench ま
たは Siebel アプリケーション内で致命的なエラーが発生します。
備考 : フォーマットされた日付情報を使用する場合は、ssTxt を使用してくだ
さい。
月名、日付、年号を省略せずに表示 ( 例 : March 24, 2000) するには、ssDate を使
用します。
バージョン 6.0
Siebel レポートガイド
A-7
Reports.book
8 ページ
２００１年４月２７日　金曜日　午前１１時２７分
ライブラリリファレンス
ssCustom ライブラリ
ssDate コントロールでは、設定済みの内容を使用して、ストリング日付表現を明
示的に強制変換します。ストリングはストリングフォーマットに戻され、Format
プロパティに定義されているフォーマットで表示されます。ストリングに何も設
定されていない場合は、フレームからコントロールが外され、データは表示され
ません。
標準レポート内で使用される定義済み日付フォーマットは、5 種類あります。こ
のうち、ssDate、ssDateLongDate、および ssDateShortDate には、マシンの地域の
ロケール設定に基づく日付設定が使用されます。ssDateHNNAP と
ssDateMMMMDDYYYY にはハードコードしたフォーマットストリングが使用さ
れ、特殊なフォーマットで表示されます。日付のライブラリコンポーネントは次
のとおりです。
„
ssDate
短縮日付および標準時刻。
„
ssDateHNNAP
AM または PM を使用した時刻 ( 例 : 12:55 AM)。
„
ssDateLongDate
長い日付フォーマット ( 地域の設定 )。
„
ssDateMMMMDDYYYY
テキスト形式の月名を使用した日付 ( 例 : February 24, 2000)。
„
ssDateShortDate
短縮日付 ( 地域の設定 )。
ssCustom ライブラリの日付フォーマットは、日付コントロールの Format プロパ
ティを変更することで修正できます。ssDate からサブクラス化すると、新しい日
付フォーマットを追加できます。短縮日付または長い日付の表示を変更するに
は、マシンの地域設定を変更します。
A-8
Siebel レポートガイド
バージョン 6.0
Reports.book
9 ページ
２００１年４月２７日　金曜日　午前１１時２７分
ライブラリリファレンス
ssCustom ライブラリ
CanGrow プロパティ
A
CanGrow プロパティは、すべての ssTxt コントロールと ssDate コントロールに使
用できます。
チェックボックステキストコントロール
A
ssTxtChkBox コントロールではブール値情報が表示されます。TrueCondition が
TRUE の場合は、チェックマークが表示されます。TrueCondition では、コント
ロールの DataValue と TrueCondition プロパティのストリング式が比較されます。
値が一致すると条件が TRUE となり、チェックマークが表示されます。
TrueCondition は、TrueCondition プロパティの値により調整できます。このプロ
パティのデフォルト値は「Y」です。
ssTxtChkBox コントロールでは、Monotype Sorts フォントを使用してチェックマー
クが表示されます。Monotype Sorts フォントがローカルマシンにないときは、
TRUE 条件の場合は 3 が表示され、FALSE 条件の場合は "" ( 空ストリング ) が表
示されます。制御コードは、コントロールの OnRow メソッドで調整できます。
パーセントテキストコントロール
A
パーセントテキストコントロールは、割合を表すためにストリング数値データを
表示する場合に使用します。パーセントストリングの表示におけるさまざまな規
則を表 A-1 に示します。
表 A-1
パーセントデータ変換
入力値
出力値
0
0
3.0
3%
3.3
3.3%
データをフォーマットするために使用するコードは OnRow メソッドにありま
す。このコードを編集することにより、コントロールとコントロールの子の動作
を変更できます。
バージョン 6.0
Siebel レポートガイド
A-9
Reports.book
10 ページ
２００１年４月２７日　金曜日　午前１１時２７分
ライブラリリファレンス
ssCustom ライブラリ
ラベルコントロール
A
ssCustom ライブラリには、次のラベルコンポーネントがあります。
„
ssLblB
太字ラベルコントロール。
„
ssLblBI
太字斜体ラベルコントロール。
„
ssLblHead
ヘッダーラベルコントロール。
„
ssLblHeadBlack
ヘッダーラベルコントロール。
„
ssLblQuotation
引用ラベルコントロール。
„
ssLblSB
小さな太字ラベルコントロール。
„
ssLblSBI
小さな太字斜体ラベルコントロール。
„
ssLblSectionHead
セクションヘッダーラベルコントロール。
ラベルコントロールにより、設定済みの固定テキストストリングが表示されま
す。各コントロールのテキストを変更するには、コンポーネントエディタのウィ
ンドウで Text プロパティを修正するか、コントロールをダブルクリックして直
接修正します。
さまざまな種類のラベルコントロールを使用しても、レポートライブラリ全体で
容易にメンテナンスを行うことができます。たとえば、ssTxt コントロールの
font.FaceName プロパティを修正するだけで、すべてのテキストコントロールの
フォントを変更できます。また、ssLblHead コントロールの関連プロパティを変
更するだけで、レポートの行ヘッダーをすべて変更できます。
ssCustom ライブラリのコントロールは、意図的に汎用化 / 簡略化されています。
小さな太字ラベルコントロール (ssLblB) のフォントサイズには任意のサイズを設
定できますが、標準レポートでは小さなフォントサイズである 8 ポイントに設定
します。
A-1 0
Siebel レポートガイド
バージョン 6.0
Reports.book
11 ページ
２００１年４月２７日　金曜日　午前１１時２７分
ライブラリリファレンス
ssCustom ライブラリ
フレームコントロール
A
フレームコンポーネントには、次の種類があります。
„
ssFrmRecordSeparator
行がある横置きフレーム。
„
ssFrmBlueBack
背景が青色の横置きフレーム。
„
ssFrmBlueBackP
背景が青色の縦置きフレーム
„
ssFrmGrayBack
背景が灰色の横置きフレーム
„
ssFrmGrayBackP
背景が灰色の縦置きフレーム。
ssFrm コントロールはすべて、baseFrm クラスを継承します。CanGrow 機能
(CanGrow = TRUE) を使用しているテキストコントロールのコンテナとなるフ
レームは、baseFrm タイプか、baseFrm から派生するタイプでなければなりませ
ん。baseFrm タイプでないと、実行時エラーが発生します。
レポートが縦置き方向に設計されている場合は、縦置きモードフレームを使用し
ます。
ページリストおよび子コンポーネント
A
ページコントロールは、Siebel レポートライブラリの中で、最も複雑な機能であ
るといえます。特に指定しないかぎり、Siebel レポートでは ssPageList コント
ロールが使用されます。pageList コントロールは、すべてのページのリストを保
持するコンテナコントロールです。各ページは、インスタンス化されるときに永
続オブジェクトとしてリストに追加されます。
ページリストコンポーネントを使用すると、横置きモードや縦置きモードなど、
目的のカスタムページレイアウトでページを追加できます。Siebel レポートに
は、出荷時に 2 つの基本ページスタイルである、横置きスタイル (ssPage) と縦置
きスタイル (ssPagePortrait) が添付されています。
バージョン 6.0
Siebel レポートガイド
A-1 1
Reports.book
12 ページ
２００１年４月２７日　金曜日　午前１１時２７分
ライブラリリファレンス
ssCustom ライブラリ
横置き ( デフォルト ) から縦置きに切り替えるには、ssPageList コンポーネント
の下にある ssPage コンポーネントをクリックし、[ 削除 ] をクリックします。
ssPage コンポーネントが消去され、そのコンポーネントのあった場所にスペース
ができます。ライブラリから ssPageList コンポーネントに、ssPagePortrait コン
ポーネントをドラッグアンドドロップします。
これで、レポートに縦置きスタイルページが使用されます。レポートに使用する
フレームが縦置きサイズになっていることを確認してください。
別のページレイアウトを作成するには、basePage コンポーネントからサブクラス
化します。既存コントロールを使用しない新しいページを最初から作成するに
は、AcSimplePageList コントロールから直接サブクラス化します。
縦置きスタイルコントロールはすべて、横置きコントロールの属性を継承しま
す。既存のページレイアウトを修正するには、ssPage レイアウトを変更してか
ら、ssPagePortrait コンポーネントを変更する必要があるかどうかを判断します。
ssPage コンポーネントと ssPagePortrait コンポーネントに関するその他のコント
ロールはすべて、ssSiebel ライブラリコンポーネントから直接継承されます。
ページコントロールコンポーネントの継承は、次のように行われます。
A-1 2
„
basePageList → ssPageList
„
basePage → ssPage → ssPagePortrait
„
baseFlow → ssFlow → ssFlow1 → ssFlowP
„
baseReportHeaderBar → ssReportHeaderBar → ssTitleBarP
„
basePrintBy → ssPrintBy → ssPrintByP
„
baseDateDisplay → ssDateDisplay → ssDateDisplayP
„
basePageNoDisplay → ssPageNoDisplay → ssPageNoDisplay
„
baseRptCreateBy → ssRptCreateBy → ssRptCreateByP
„
baseReportTitle → ssReportTitle → ssReportTitleP
„
baseLblSiebel → ssLblSiebel → ssLblSiebelP
Siebel レポートガイド
バージョン 6.0
Reports.book
13 ページ
２００１年４月２７日　金曜日　午前１１時２７分
ライブラリリファレンス
ssCustom ライブラリ
その他のコントロール
A
次のコントロールは ssCustom ライブラリに配置されており、将来拡張できるよ
うになっています。これらのコントロールは、現バージョンでは標準レポートに
使用されていません。
„
ssCur
通貨コントロール。
„
ssCurB
太字通貨。
„
ssFloat
浮動コントロール。
„
ssInt
整数コントロール。
„
ssSubPage
サブページ。
„
ssImageControl
変更なしの画像コントロール。将来のサポートに備えて配置されています。
画像コントロールは、画面にビットマップ画像を表示するために使用します。
„
ssSummaryGraph
Y ラベルサポートを拡張したグラフコントロール Siebel アプリケーションで
使用するグラフコントロールが、Y ラベルのコントロールを強化できるよう
に修正されました。
ラインコントロール
A
ラインコントロールは直接的に動作します。プロパティレベルを変更すると、コ
ントロールの動作や見た目が変わります。
バージョン 6.0
„
LineControlP
縦置きスタイルの幅を指定したラインコントロール。
„
DblLine
二重ラインコントロール。
Siebel レポートガイド
A-1 3
Reports.book
14 ページ
２００１年４月２７日　金曜日　午前１１時２７分
ライブラリリファレンス
ssCustom ライブラリ
セクションコンポーネント
A
条件付きセクションおよび並列セクションには、特別な役割があります。
„
ssConditionalSection
条件付きセクション。条件付きセクションコントロールを使用すると、実行
時の条件に基づき、2 つのフレームのどちらかが選択されるように定義でき
ます。この機能は、見積りコンフィギュレーションレポートに表示されます。
„
ssParallelSection
並列セクション。通常、フレームはページに順次配置されます。並列セク
ションでは、1 ページに複数のフレームを同時 ( すなわち並列 ) に配置できま
す。並列セクションの使い方の詳細については、Actuate の製品マニュアルを
参照してください。
グループ、順次、レポートの各セクションコントロールでは、すべてのプロパ
ティとメソッドを ssSiebel ライブラリのスーパークラスから直接そのまま継承し
ています。
A-1 4
„
ssGrp
グループセクション。
„
ssSeq
順次セクション。
„
ssRpt
レポートセクション。
Siebel レポートガイド
バージョン 6.0
Reports.book
15 ページ
２００１年４月２７日　金曜日　午前１１時２７分
ライブラリリファレンス
ssSiebel ライブラリ
ssSiebel ライブラリ
A
Actuate Foundation Class (AFC) ライブラリで一般的に使用されるコンポーネント
はすべて、ssSiebel ライブラリに拡張されました。次の項では、ssSiebel ライブ
ラリにあるすべてのコンポーネントを示し、各コンポーネントの変更内容につい
て説明します。
図 A-2
バージョン 6.0
ssSiebel ライブラリ
Siebel レポートガイド
A-1 5
Reports.book
16 ページ
２００１年４月２７日　金曜日　午前１１時２７分
ライブラリリファレンス
ssSiebel ライブラリ
baseCur
A
スーパークラス
AcCurrencyControl
プロパティ
Font.FaceName
Font.Size
メソッド
なし
変数
なし
備考
Arial
10
既存の標準レポートでは使用しませんが、完全を期すため、また将来
の使用に備えて、ライブラリに格納されています。A-3 ページの
「ssCustom ライブラリ」で説明しているように、baseTxt から派生した
コンポーネントを使用すると、現在のフィールドを表示できます。
baseDate
A
スーパークラス
baseTxt
プロパティ
なし
メソッド
OnRow
変数
なし
備考
「MM/DD/YY HH:MM:SS」という標準的な日付ストリングを、連続日
付のデータタイプに変換します。次に、その日付データを、現在のロ
ケール設定に従ったストリングにフォーマットします。ストリングが
空白の場合は幅が 0 になります。
baseDateDisplay
A-1 6
A
スーパークラス
baseTxt
プロパティ
LabelPrefix
ValueExp
メソッド
Finish
変数
LabelPrefix
LabelSuffix
Siebel レポートガイド
"Date "
Format (Now(),
"Short Date"
PropertyProperty
StringString
バージョン 6.0
Reports.book
17 ページ
２００１年４月２７日　金曜日　午前１１時２７分
ライブラリリファレンス
ssSiebel ライブラリ
備考
レポートの実行日を表示します。ロケール設定で指定されている Short
Date フォーマットを使用します。baseDateDisplay は、次のように、
LabelPrefix ストリングと labelSuffix ストリングの値を連結します。
LabelPrefix & Format (Now(), "Short Date") & LabelSuffix
baseFlow
A
スーパークラス
AcTopDownFlow
プロパティ
Position, Size
メソッド
AddHeader
変数
なし
備考
AddHeader メソッドは、CanGrow 機能をサポートするように修正され
ました。
baseFlow1
バージョン 6.0
A
スーパークラス
baseFlow
プロパティ
なし
メソッド
なし
変数
なし
備考
フローは、データ行の情報が表示される、各ページの領域を表しま
す。baseFlow1 は、将来的な柔軟性を提供するためにサブクラス化さ
れました。
Siebel レポートガイド
A-1 7
Reports.book
18 ページ
２００１年４月２７日　金曜日　午前１１時２７分
ライブラリリファレンス
ssSiebel ライブラリ
baseFrm
A
スーパークラス
AcFrame
プロパティ
Size
AlternateColor
AlternateLines
メソッド
AdjustAssociatedControl
AdjustControlPositions
AdjustSize
BindToFlow
GrowFrame
Start
変数
AlternateColor
AlternateLines
MostRecentContainer
MostRecentFlow
OriginalSize
RowNumber
SomeThingGrew
備考
baseFrm は、CanGrow 機能をサポートするように修正されました。
CanGrow 機能には、ユーザーレベルの調整を行うことはできません。
Property
Property
Property
Public
Public
Public
Public
AcColor
Integer
AcReportComponent
AcFlow
AcSize
Integer
Boolean
baseFrm には、代替ライン色をサポートするための修正も行われまし
た。ラインの色を変更するには、AlternateLines プロパティに、0 より
大きい整数を設定します。たとえば、AlternateLines を「1」に設定す
ると、ラインの色が 1 行おきに変わります。代替ラインの色は、
AlternateColor を設定することにより制御します。
baseGrp
A-1 8
A
スーパークラス
AcTopDownFlow
プロパティ
Page.ShowHeaderOnFirst
メソッド
StartFlow
StartGroup
変数
なし
備考
baseGrp は、CanGrow 機能をサポートするように修正されました。
Siebel レポートガイド
True
バージョン 6.0
Reports.book
19 ページ
２００１年４月２７日　金曜日　午前１１時２７分
ライブラリリファレンス
ssSiebel ライブラリ
baseInt
A
スーパークラス
AcIntegerControl
プロパティ
Font.FaceName
Font.Size
メソッド
なし
変数
なし
備考
既存の標準レポートでは使用しません。
Arial
10
baseLbl
A
スーパークラス
AcLabelControl
プロパティ
Font.Size
メソッド
なし
変数
なし
10
baseLblSiebel
バージョン 6.0
A
スーパークラス
AcImageControl
プロパティ
FileName
メソッド
なし
変数
なし
備考
Siebel の企業ロゴを表示します。FileName を変更すると、レポートに
別の企業ロゴを配置できます。
"..¥lib¥ssLogo.bmp"
Siebel レポートガイド
A-1 9
Reports.book
20 ページ
２００１年４月２７日　金曜日　午前１１時２７分
ライブラリリファレンス
ssSiebel ライブラリ
baseLineControlr
A
スーパークラス
AcLineControl
プロパティ
Position
EndPosition
メソッド
Start
変数
なし
basePage
A
スーパークラス
AcPage
プロパティ
Size.Height
メソッド
なし
変数
なし
備考
レポートのページサイズを指定します。デフォルトでは、横置きモー
ドになります。ssCustom ライブラリでは縦置きモードも利用できます。
8.27
basePage では、ページのサイズが A4 でも 8.5x11 でもレポートを表示
できるよう、次に示すようにこの 2 つのサイズの共通項を使用します。
8.5 x 11
A4
Siebel Actuate Reports
高さ
8.5
8.27
8.72
幅
11
11.69
11
主に A4 サイズのページでレポートを出力する場合は、ssCustom ライ
ブラリの Position 変数を修正すると、データをページ中央に配置でき
ます。
A-2 0
Siebel レポートガイド
バージョン 6.0
Reports.book
21 ページ
２００１年４月２７日　金曜日　午前１１時２７分
ライブラリリファレンス
ssSiebel ライブラリ
basePageList
A
スーパークラス
AcSimplePageList
プロパティ
LabelMidString
LabelPrefix
PageStyle
PageXofX
cstr_PageNoObject
メソッド
AddFrameToFlow
Finish
SetPageXofX
Start
変数
cstr_PageNoObject
LabelMidString
LabelPrefix
LabelSuffix
PageXofX
備考
basePageList コンポーネントの主な特長として、PageXofX プロパティ
が挙げられます。PageXofX が TRUE の場合は、cstr_PageNoObject で
指定したコンポーネントによって、次のストリングが表示されます。
" of "
"Page "
basePage
True
ssPageNoDisplay
Property
Property
Property
Property
Property
String
String
String
String
Boolean
"LabelPrefix & curPageNum & LabelMidString & TotalPages & LabelSuffix"
デフォルト表示は、Page X of Y となります。ここで、X は現在のペー
ジ番号、Y は合計ページ数を表します。cstr_PageNoObject は、ページ
番号が入るコンポーネントの名前です。
basePageNoDisplay
バージョン 6.0
A
スーパークラス
baseTxt
プロパティ
なし
メソッド
なし
変数
なし
備考
basePageNoDisplay は空白のコントロールであり、
basePageList.PageXofX コードで埋められます。
Siebel レポートガイド
A-2 1
Reports.book
22 ページ
２００１年４月２７日　金曜日　午前１１時２７分
ライブラリリファレンス
ssSiebel ライブラリ
basePrintBy
A
スーパークラス
baseTxt
プロパティ
LabelPrefix
メソッド
Finish
変数
LabelPrefix
LabelSuffix
備考
basePrintBy は、Siebel クライアントから渡されたパラメータを使っ
て、レポートを実行するユーザー名を表示します。レポートのユー
ザー名がクライアントから渡されなかった場合は、ローカルオペレー
ティングシステムのユーザー名が表示されます。ページ番号コント
ロールと同様、basePrintBy コントロールは、LabelPrefix、UserName、
LabelSuffix を連結して、次のように 1 つのストリングにします。
"Printed By "
PropertyProperty
StringString
"LabelPrefix & UserName & LabelSuffix"
baseReport
A-2 2
A
スーパークラス
AcReport
プロパティ
Content
PageList
メソッド
Start
変数
pubReportTitleg
ssBusObjectName
ssOLEServer
ssReportName
ssReportTitle
ssSearchSpec
ssUserName
ssViewMode
Siebel レポートガイド
baseRpt
basePageList
Public Variable
Parameter
Parameter
Parameter
Property
Parameter
Parameter
Parameter
String
String
String
String
String
String
String
String
バージョン 6.0
Reports.book
23 ページ
２００１年４月２７日　金曜日　午前１１時２７分
ライブラリリファレンス
ssSiebel ライブラリ
備考
baseReport コンポーネントは、すべての Siebel レポートに必須です。
レポートの作成時、これらのパラメータが Siebel クライアントからレ
ポートに渡されます。パラメータの定義が不適切であると、レポート
は実行されません。
ssReportTitle プロパティを使うと、レポジトリにあるレポートオブ
ジェクト定義には関係なく、ユーザーがレポート名を設定できます。
レポートタイトルがレポートヘッダーに表示されます。ssReport オブ
ジェクトでレポートタイトルを修正することで、言語をカスタマイズ
したり、企業独自の名称に変更したりできます。
Start メソッドにより、ssReportTitle 変数の値が pubReportTitle 変数に
移されます。これにより、レポートのどこからでもこの値にアクセス
できるようになります。
baseReportHeader
A
スーパークラス
baseLbl
プロパティ
なし
メソッド
なし
変数
なし
備考
BaseReportHeader は塗りつぶされた黒いバーであり、どのレポートで
も一番上に表示されます。
baseReportTitle
バージョン 6.0
A
スーパークラス
baseLbl
プロパティ
なし
メソッド
Finish
変数
なし
備考
baseReportTitle コントロールは、ssReport ( 一番上のオブジェクト ) の
ssReportTitle プロパティに指定されているレポート名を検索し、その
データをレポートヘッダーに表示します。
Siebel レポートガイド
A-2 3
Reports.book
24 ページ
２００１年４月２７日　金曜日　午前１１時２７分
ライブラリリファレンス
ssSiebel ライブラリ
baseRpt
A
スーパークラス
AcReportSection
プロパティ
Page.ShowHeaderOnFirst
Page.ShowFooterOnLast
メソッド
BuildOnePass
StartFlow
StartGroup
変数
FirstRowFetched
備考
baseRpt は、テキストコントロールにおいて、CanGrow 機能をサポー
トするように修正されました。
True
True
Public
Boolean
baseRptCreateBy
A
スーパークラス
baseLbl
プロパティ
Text
メソッド
なし
変数
なし
備考
baseRptCreateBy はラベルストリングであり、すべてのレポートに共通
するテキストメッセージを追加するために使用されます。
"Report Created by Siebel Software"
baseSeq
A-2 4
A
スーパークラス
AcSequentialSection
プロパティ
TocAddComponent
TocAddContents
メソッド
なし
変数
なし
Siebel レポートガイド
True
True
バージョン 6.0
Reports.book
25 ページ
２００１年４月２７日　金曜日　午前１１時２７分
ライブラリリファレンス
ssSiebel ライブラリ
baseSubPage
A
スーパークラス
AcSubpage
プロパティ
なし
メソッド
なし
変数
なし
baseTxt
A
スーパークラス
AcTextControl
True
プロパティ
CanGrow
CharacterWrap
Font.FaceName
Font.Size
TextPlacement.MultiLine
TextPlacement.WordWrap
True
True
Arial
10
True
TextWordWrap
メソッド
BuildFromRow
GetFormattedText
GetText
GrowControl
変数
AssociatedControl
CanGrow
CharacterWrap
ControlAdjusted
OriginalSize
備考
デフォルトでは、どの Siebel のテキストコントロールも、コントロー
ル内のテキストがすべて表示されるように拡大できます。この機能
は、CanGrow プロパティと CharacterWrap プロパティを修正すること
によって変更できます。
Property
Property
Property
Public
Public
String
Boolean
Boolean
Boolean
AcSize
コントロールのサイズが大きくなると、新しいコントロールサイズに
合わせて、その入れ物 ( フレーム ) が調整されます。さらに、調整さ
れたコントロールの下にあるすべてのコントロールが調整されて、適
切なスペースが生成されます。
AssociatedControl プロパティでラベルコントロールの名前を指定する
と、ラベルコントロールとテキストコントロールの間に、永続的な関
連付けを定義できます。
バージョン 6.0
Siebel レポートガイド
A-2 5
Reports.book
26 ページ
２００１年４月２７日　金曜日　午前１１時２７分
ライブラリリファレンス
ssSiebel ライブラリ
A-2 6
Siebel レポートガイド
バージョン 6.0
Reports.book
1 ページ
２００１年４月２７日　金曜日　午前１１時２７分
メソッドリファレンス
B
DataStream 機能 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .B-2
DataStream の必須メソッド . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .B-2
Start メソッド . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-3
Fetch メソッド . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-6
Delete メソッド . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-9
バージョン 6.0
Siebel レポートガイド
B-1
Reports.book
2 ページ
２００１年４月２７日　金曜日　午前１１時２７分
メソッドリファレンス
DataStream 機能
DataStream 機能
B
Actuate では、データストリームという用語はレポートにデータを送るコンポー
ネントの集合を指します。Siebel ではデータへのアクセスは OLE を介して行わ
れるため、クエリーは Actuate 環境外で実行されます。データストリームは、
OLE インターフェースの作成と、フォーマットしたデータ行をレポートデザイ
ンに送る役割を担います。Siebel Tools は OLE オートメーションを実行するのに
必要な変数を定義します。この変数の値は、レポートデザインの要件によって決
定されます。datastream 変数とその種類や機能を、表 B-1 に示します。
表 B-1
Siebel データストリーム変数
変数
種類
機能
SsAppServer
Integer
データストリームの Start メソッドで作成します。値は
Siebel アプリケーションのアクティブなサーバーに設定
します。
ssBO
Integer
Start メソッドで作成します。アクティブなビジネスコン
ポーネントの値が入ります。
SsBusCompName
Integer
マスタービジネスコンポーネントの値を保持し、Siebel
クライアントでアクティブなビューに使用します。
DataStream の必須メソッド
B
Siebel の基本レポートでは、次に示すデータストリームの 3 つの必須メソッドが
使用されます。
„
Start
„
Fetch
„
Delete
各メソッドについては、次の項で説明します。
B-2
Siebel レポートガイド
バージョン 6.0
Reports.book
3 ページ
２００１年４月２７日　金曜日　午前１１時２７分
メソッドリファレンス
DataStream の必須メソッド
Start メソッド
B
Start メソッドには、大きな 2 つの役割があります。データ行を使用するために
必要な OLE インターフェースを作成することと、必要なフィールドをアクティ
ブにすることです。Start メソッドは、マスターデータストリームからのみ呼び
出すことができます。サブレポートで同じビジネスオブジェクトを使用する場
合、サブレポートの ( 子 ) データストリームでは、親 ( マスター ) データスト
リームで作成されたインターフェースが使用されます。同様に、Start メソッド
によってフィールドがアクティブになるため、すべての子フィールドも、マス
ターデータストリームによってアクティブにされます。
備考 : コードは、サブレポートで異なるビジネスコンポーネントを使用する場合
でも、レポートの生成中に画面が変更されないように記述されています。
次のコードサンプルは、Acreview レポートの ssAccountQuery のデータストリー
ムコンポーネントで Start メソッドを呼び出すところから始まっています。
Function Start () As Boolean
Dim bCurRowOnly As Boolean
Dim bReExecute
As Boolean
Dim bUpdateLinks As Boolean
Dim bStatus
As Boolean
Dim mainRowId
As String
Dim busObjName
As String
bCurRowOnly = True
bReExecute
= False
bUpdateLinks = False
errCode
= 0
mainRowId
= ""
busObjName
= ""
bStatus = Super::Start ()
If (bStatus = False) Then
Start = False
Exit Function
End If
ssAppServer = ssReport::ssiSiebelServer
If (ssAppServer = 0) Then
ssAppServer = ssConnect (ssReport::ssOLEServer)
ssReport::ssiSiebelServer = ssAppServer
If (ssAppServer = 0) Or (errcode <> 0) Then
Start = False
Exit Function
バージョン 6.0
Siebel レポートガイド
B-3
Reports.book
4 ページ
２００１年４月２７日　金曜日　午前１１時２７分
メソッドリファレンス
DataStream の必須メソッド
End If
End If
ssBO = ssModelGetBusObject
(ssAppServer,ssReport::ssBusObjectName, errCode)
ssReport::ssActiveBusObject = ssBO
End If
If (errCode = 0) Then Set ssAccount = ssBusObjGetBusComp (ssBO,
"Account")
' Now actually setup the main report BusComp
' Now actually setup the main report BusComp
If (errCode = 0) And (ssReport::ssSearchSpec <> "") And ((Not
bCurRowOnly) Or
(ssReport::ssBusObjectName <> "")) Then ssAccount.SetSearchExpr
(ssReport::ssSearchSpec, errCode)
If (errCode = 0) And (ssReport::ssBusObjectName <> "") And
(ssReport::ssViewMode
<> "") Then ssAccount.SetViewMode (ssReport::ssViewMode, errCode)
If (errCode = 0) Then ssAccount.ActivateField ("Account Status",
errCode)
' Now actually setup the main report BusComp
If (errCode = 0) And (ssReport::ssSearchSpec <> "") And ((Not
bCurRowOnly) Or
(ssReport::ssBusObjectName <> "")) Then ssAccount.SetSearchExpr
(ssReport::ssSearchSpec, errCode)
If (errCode = 0) And (ssReport::ssBusObjectName <> "") And
(ssReport::ssViewMode
<> "") Then ssAccount.SetViewMode (ssReport::ssViewMode, errCode)
If (errCode = 0) Then ssAccount.ActivateField ("Account Status",
errCode)
' Now actually setup the main report BusComp
If (errCode = 0) And (searchSpec <> "") And ((Not bCurRowOnly) Or
(ssReport::ssBusObjectName <> "")) Then ssBusCompSetSearchExpr
(ssAccount, searchSpec)
If (errCode = 0) Then ssBusCompSetSortSpec (ssAccount, "Name")
If (errCode = 0) And (ssReport::ssBusObjectName <> "") And
(ssReport::ssViewMode <> "") Then ssBusCompSetViewMode (ssAccount,
CInt (ssReport::ssViewMode))
If (errCode = 0) Then ssBusCompActivateField (ssAccount, "Account
Status")
If (errCode = 0) Then ssBusCompActivateField (ssAccount, "City")
If (errCode = 0) Then ssBusCompActivateField (ssAccount,
"Competitor")
If (errCode = 0) Then ssBusCompActivateField (ssAccount,
"Country")
B-4
Siebel レポートガイド
バージョン 6.0
Reports.book
5 ページ
２００１年４月２７日　金曜日　午前１１時２７分
メソッドリファレンス
DataStream の必須メソッド
If (errCode = 0) Then ssBusCompActivateField (ssAccount,
"Description")
If (errCode = 0) Then ssBusCompActivateField (ssAccount,
"Industry")
If (errCode = 0) Then ssBusCompActivateField (ssAccount,
"Location")
If (errCode = 0) Then ssBusCompActivateField (ssAccount, "Main
Fax Number")
If (errCode = 0) Then ssBusCompActivateField (ssAccount, "Main
Phone Number")
If (errCode = 0) Then ssBusCompActivateField (ssAccount, "Name")
If (errCode = 0) Then ssBusCompActivateField (ssAccount, "Parent
Account Name")
If (errCode = 0) Then ssBusCompActivateField (ssAccount, "Postal
Code")
If (errCode = 0) Then ssBusCompActivateField (ssAccount, "State")
If (errCode = 0) Then ssBusCompActivateField (ssAccount, "Street
Address")
If (errCode = 0) Then ssBusCompActivateField (ssAccount,
"Synonym")
If (errCode = 0) Then ssBusCompActivateField (ssAccount, "Type")
' Re-execute business components as necessary
If (errCode = 0) Then ssBusCompInvokeMethod (ssAccount,
"SetIgnoreMaxCursorSize", "Y")
If (errCode = 0) Then
If (bReExecute) Then
If (bCurRowOnly) And (mainRowId <> "") Then
ssBusCompSetSearchExpr (ssAccount, "Id = """ + mainRowId + """")
If (errCode = 0) Then ssBusCompExecuteQuery2 (ssAccount, 1,
True)
Elseif (bUpdateLinks) Then
ssBusCompInvokeMethod (ssAccount, "UpdateLinks", "")
End If
End If
' Process errors and return
If (errCode = 0) Then
bStatus = True
Else
bStatus = False
ssProcessLastError (ssAppServer, "", "")
End If
Start = bStatus
End Function
バージョン 6.0
Siebel レポートガイド
B-5
Reports.book
6 ページ
２００１年４月２７日　金曜日　午前１１時２７分
メソッドリファレンス
DataStream の必須メソッド
この時点で、Siebel ビジネスコンポーネント ( この場合は「Account」) が Actuate
の作業対象となり、OLE インターフェースが呼び出されます。Siebel クライアン
トのアクティブなビューに表示されるビジネスオブジェクトのフィールドがアク
ティブになり、datarow オブジェクトに使用できます。
Fetch メソッド
B
Fetch メソッドでは次の 3 つの機能を実行します。
„
最初に、ビジネスオブジェクトの単一行への OLE インターフェースを配置
する。
„
次に、データ行の空のインスタンスを生成する。
„
最後に、ビジネスコンポーネントの OLE インターフェースでメソッドを呼び
出すことにより、データ行にデータを挿入する。
次のコードサンプルは、Acreview レポートの ssAccountQuery の datastream コン
ポーネントで Fetch メソッドを呼び出すところから始まっています。
Function Fetch () As AcDataRow
Dim
Dim
Dim
Dim
bStatus
bCurRowOnly
custDataRow
theBC
As
As
As
As
Boolean
Boolean
ssAccountDataRow
Integer
errCode = 0
bStatus = False
bCurRowOnly = False
theBC = ssAccount
If (bCurRowOnly = True) Then
If (Position = 1) Then
bStatus = True
End If
Else
If (Position = 1) Then
bStatus = ssBusCompFirstRecord (theBC)
If (errCode = 0) And (baseReport::bSetForward)
ssBusCompInvokeMethod (theBC, "SetForwardOnly", "")
Else
bStatus = ssBusCompNextRecord (theBC)
B-6
Siebel レポートガイド
Then
バージョン 6.0
Reports.book
7 ページ
２００１年４月２７日　金曜日　午前１１時２７分
メソッドリファレンス
DataStream の必須メソッド
End If
End If
If (bStatus = True) And (errCode = 0) Then
Set custDataRow = NewDataRow
If (errCode = 0) Then custDataRow.ssAccount_Status =
ssBusCompGetFieldValue (theBC, "Account Status")
If (errCode = 0) Then custDataRow.ssCity =
ssBusCompGetFieldValue (theBC, "City")
If (errCode = 0) Then custDataRow.ssCompetitor =
ssBusCompGetFieldValue (theBC, "Competitor")
If (errCode = 0) Then custDataRow.ssCountry =
ssBusCompGetFieldValue (theBC, "Country")
If (errCode = 0) Then custDataRow.ssDescription =
ssBusCompGetFieldValue (theBC, "Description")
If (errCode = 0) Then custDataRow.ssIndustry =
ssBusCompGetFieldValue (theBC, "Industry")
If (errCode = 0) Then custDataRow.ssLocation =
ssBusCompGetFieldValue (theBC, "Location")
If (errCode = 0) Then custDataRow.ssMain_Fax_Number =
ssBusCompGetFormattedFieldValue (theBC, "Main Fax Number")
If (errCode = 0) Then custDataRow.ssMain_Phone_Number =
ssBusCompGetFormattedFieldValue (theBC, "Main Phone Number")
If (errCode = 0) Then custDataRow.ssName =
ssBusCompGetFieldValue (theBC, "Name")
If (errCode = 0) Then custDataRow.ssParent_Account_Name =
ssBusCompGetFieldValue (theBC, "Parent Account Name")
If (errCode = 0) Then custDataRow.ssPostal_Code =
ssBusCompGetFieldValue (theBC, "Postal Code")
If (errCode = 0) Then custDataRow.ssState =
ssBusCompGetFieldValue (theBC, "State")
If (errCode = 0) Then custDataRow.ssStreet_Address =
ssBusCompGetFieldValue (theBC, "Street Address")
If (errCode = 0) Then custDataRow.ssSynonym =
ssBusCompGetFieldValue (theBC, "Synonym")
If (errCode = 0) Then custDataRow.ssType =
ssBusCompGetFieldValue (theBC, "Type")
' Now retrieve the system fields
If (errCode = 0) Then custDataRow.ssId = ssBusCompGetFieldValue
(theBC, "Id")
If (errCode = 0) Then custDataRow.ssCreated =
ssBusCompGetFieldValue (theBC, "Created")
If (errCode = 0) Then custDataRow.ssCreated_Formatted =
ssBusCompGetFormattedFieldValue (theBC, "Created")
バージョン 6.0
Siebel レポートガイド
B-7
Reports.book
8 ページ
２００１年４月２７日　金曜日　午前１１時２７分
メソッドリファレンス
DataStream の必須メソッド
If (errCode = 0) Then custDataRow.ssCreated_By =
ssBusCompGetFieldValue (theBC, "Created By")
If (errCode = 0) Then custDataRow.ssUpdated =
ssBusCompGetFieldValue (theBC, "Updated")
If (errCode = 0) Then custDataRow.ssUpdated_Formatted =
ssBusCompGetFormattedFieldValue (theBC, "Updated")
If (errCode = 0) Then custDataRow.ssUpdated_By =
ssBusCompGetFieldValue (theBC, "Updated By")
Set Fetch = custDataRow
AddRow (Fetch)
Else
Set Fetch = Nothing
End If
If (errCode <> 0) Then
ssProcessLastError (ssAppServer, "", "")
End If
End Function
この例では、bStatus の値によって、最初のデータ行の位置が定義されます。
bStatus が True であると、戻される値がなくなるまで custDataRow によって行が
渡されます。SetForwardOnly メソッドにより、すべての行が処理されます。この
際、重複行は渡されません。すべてのデータはストリングとして戻されるため、
ビジネスコンポーネントの OLE インターフェース変数に、2 つのメソッド－
GetFieldValue ( あらゆるデータタイプが対象 ) と GetFormattedFieldValue( 日付や
通貨など、フォーマットが必要なデータタイプが対象 ) －が呼び出されることに
なります。GetFieldValue と GetFormattedFieldValue についての説明を表 B-2 に示
します。
表 B-2
B-8
GetFieldValue と GetFormattedFieldValue
メソッド
説明
GetFieldValue
未処理データ値を取得する。日付フォーマットは mm/dd/yy
hh:mm:ss。数値と通貨はストリングとして処理する。数値の
合計にも使用できる。
GetFormattedFieldValue
Siebel クライアントで指定したフォーマットを使用する。各
通貨フィールドが「1,234.34」の場合に、デフォルトで呼び
出される。
「01/12/31」形式の日付フィールドの場合に、デ
フォルトで呼び出される。数値の合計には使用できない。
Siebel レポートガイド
バージョン 6.0
Reports.book
9 ページ
２００１年４月２７日　金曜日　午前１１時２７分
メソッドリファレンス
DataStream の必須メソッド
備考 : この 2 つのメソッドは、直接呼び出すことができなくなりました。代わり
に、ssBusCompGetFieldValue および ssBusCompGetFormattedFieldValue として呼び
出します。この 2 つのメソッドは ssSiebel.bas に実装されており、前述のメソッ
ドを呼び出します。
Delete メソッド
B
Delete メソッドでは、データストリームオブジェクトを消去してシステムリソー
スを解放します。次の例では、カスタムコードを追加した後で、スーパークラス
に対して Delete メソッドを実行しています。ssAcount により、その子である
データストリームを削除した後で、(EnableNotify により ) サーバーに制御を戻し
ています。
次のコードサンプルは、Acreview レポートの ssAccountQuery の datastream コン
ポーネントで Delete メソッドを呼び出すところから始まっています。
Sub Delete ()
Dim errCode As Integer
If Not (ssAccount = 0) Then ssBusCompInvokeMethod (ssAccount,
"SetIgnoreMaxCursorSize", "N")
ssAccount = 0
ssBO
= 0
ssAppServer = 0
Super::Delete ()
End Sub
レポートでは、詳細、サマリー、関連データを表示するため、複数のレポートセ
クションをネストすることがよくあります。レポートセクションごとに 1 つの
datastream コンポーネントが必要ですが、そのデータストリームもネストするこ
とが理想的です。こうすることで、マスターのデータストリームが子に対して
Start 処理と Delete 処理を実行できるため、作業効率も改善されます。
マスターデータストリームの役割は次のとおりです。
バージョン 6.0
„
サーバーの呼び出し処理を行う OLE インターフェースを作成する。
„
マスター自身のフィールドと子のフィールドをアクティブにする。
Siebel レポートガイド
B-9
Reports.book
10 ページ
２００１年４月２７日　金曜日　午前１１時２７分
メソッドリファレンス
DataStream の必須メソッド
„
ソート条件を満たすためにクエリーの再実行が必要かどうかを判断する。
„
マスター自身およびすべての子を削除する。
子データストリームの役割は次のとおりです。
„
DataRows を取り出す。
„
必要に応じてフィールドをフォーマットする。
„
ソート条件を実行する。
備考 : マスターとなるデータストリームの名前には、数字が付加されることはあ
りません。
B-1 0
Siebel レポートガイド
バージョン 6.0