実装ガイド › 実装 › 成果物の作成（契約マネージャ） › レポートの作成方法 › 自由形式レポート

自由形式レポート

自由形式レポートを使用すれば、ユーザは CA Business Service Insight のデータベースまたは CA Business Service Insight サーバから接続を介してアクセスできる他の外部データ ソースから SQL クエリに基づいたレポートを生成できます。 また、これには、Excel、Access、Lotus Notes、テキスト ファイルなどの ODBC を介してアクセスできる他の種類のデータ ソースも含まれます。自由形式レポートは、ビジネス ロジックのコマンド Tools.SaveRecord と Tools.SaveFields によって作成されたデータに基づいた統計レポートを設定するために一般的に使用されます。

自由形式レポートでは、選択したデータベースに接続文字列を介して接続します。また、クエリ文字列を使用して、データベースに対して SQL クエリを実行します。 パラメータを両方の文字列に追加して、動的レポートを生成することができます。これによってユーザは、データベースに接続するためのユーザ名やパスワードなどの、クエリに含める特定の値を入力または選択できます。

自由形式レポートは、［レポート ウィザード］を使用して生成されたレポートと同様に、［グラフ］、［データ］、および［フィルタ］タブ内に表示されます。

注： 自由形式レポートには、列が最初の列を除いてすべて数値の場合にのみグラフを含めることができます。 最初の列のデータは X 軸タイトルに使用されます。 列名は他のタイトルに使用されます。

自由形式レポートは、データベースおよび開いている SQL クエリへの直接アクセスを使用するという理由で、メンテナンスに問題があります。 自由形式レポートのソースとして役立つ基となるデータに影響を与えないように十分に注意してください。 レポートが外部データ ソースから生成される場合、それらのデータ ソースが、自由形式のデータ レポートに責任を負う契約マネージャにまず意見を求めずに変更されないことを保証するために、通知プロセスを設定することをお勧めします。

自由形式レポートの作成時に留意する必要がある全般的な情報。

• 国際的な日付形式の問題のために、ビジネス ロジック内にカスタムの計算式を作成することによって、日付の正確な形式を指定することが多くの場合役立ちます。 これにより、日付が常に同じ形式の文字列に変換され、また米国と EU の日付形式の問題が回避されます。 これは、Tools.SaveFields コマンドまたは Tools.SaveRecord コマンドを介して T_SLALOM_OUTPUTS テーブルに書き込まれる日付に対して使用してください。 サンプルの計算式を以下に示します。

Function FormatDate(DateField)

    If DateField = "" Then
      FormatDate = ""
    Else
      Dim PeriodYear, PeriodMonth, PeriodDay, PeriodHour,
  PeriodMinute, Periodsecond
      PeriodYear    = DatePart("yyyy",DateField)
      PeriodMonth   = DatePart("m",DateField)
      PeriodDay     = DatePart("d",DateField)
      PeriodHour    = DatePart("h",DateField)
      PeriodMinute  = DatePart("n",DateField)
      Periodsecond  = DatePart("s",DateField)
      FormatDate  = PeriodDay&"/"&PeriodMonth&"/"&PeriodYear& _
 " "&PeriodHour&":"&PeriodMinute&":"&Periodsecond
    End If
End Function

• ビジネス ロジックのイベント ハンドラからの「time」パラメータ、または eventDetails オブジェクトからのタイム スタンプを使用する場合は、常にタイム ゾーンのシフトの影響に注意してください。 テーブルに書き込まれた際の日付がローカル時間ではなく UTC 時間である場合があることに注意してください。 これを修正するために、Tools.GetLocaleTime() 関数を使用することがに必要になる場合があります。
• 外観をカスタマイズするには、これまでどおりレポート デザイナのユーティリティ（自由形式レポートでグラフを生成する場合）を使用できます。
• 自由形式レポートの PDF エクスポート オプションは、自由形式の設定画面の［レポート パラメータ］セクションを使用してカスタマイズ可能です。 ページ レイアウト（横、縦）などのもの
• HTML をレポート内に埋め込んで、ハイパーリンクの追加、または列と行の色/フォントや表示設定の変更などのような別の機能を実行することができます。
• データベース ビュー（Oracle の機能）を T_SLALOM_OUTPUTS テーブル上に作成して、レポートに必要な SQL を簡略化できます。
• レポートにパラメータを指定する場合、それらを次のものを含むいくつかの方法で設定することができます： 自由形式テキスト、数値（検証）、パスワード（非表示文字 - DB 接続へのパスワードに役立つ）、日付（提供される日付ピッカ ユーティリティを使用）およびリスト（リストに入力するために SQL ステートメントを指定して作成）
• 自由形式レポートの SQL セクションに指定されたパラメータ値は、「@」記号が前に付いたパラメータ名と置換する必要があります。 つまり @PARAM1。 値が文字列の場合、このパラメータ値の前後に引用符を使用することが必要になる場合があります。