Report Engine ヘルプ

①メニュー

【新規作成】

新規テンプレートを作成します。サムネイルをクリックしてテンプレートを指定します。

ブランク

A4やB5などの定型サイズの空テンプレートが用意されています。

ビジネス帳票

見積書や請求書などのテンプレートのサンプルが用意されています。

フォームサンプル

フォームテンプレートのサンプルが用意されています。

【名前変更】

指定したテンプレートのテンプレート名を変更します。テンプレート管理一覧のマイフォルダにあるテンプレートを指定し、【名前変更】をクリックします。テンプレート名はSalesforceにアップロードする際のVisualforceページ名になります。日本語、"-"、数字で始まる名前などのVisualforceページ名として使用できない文字は使用できません。

【削除】

指定したテンプレートを削除します。テンプレート管理一覧のマイフォルダにあるテンプレートを指定し、【削除】をクリックします。一度削除したテンプレートは元に戻すことはできません。

【コピー】

指定したテンプレートの複製を作成します。テンプレート管理一覧のマイフォルダにあるテンプレートを指定し、【コピー】をクリックします。

②テンプレート管理

保存されているテンプレートがフォルダ内に一覧表示されます。一覧にあるフォルダは以下の通りです。

【マイフォルダ】 / 【すべて】

現在のユーザが作成したすべてのテンプレートが表示されます。

【マイフォルダ】 / 【最近使用したテンプレート】

最近作成、または保存したテンプレートが表示されます。

【共有フォルダ（読み取り専用）】

同じ組織（同じCID）内各ユーザの「テンプレートを共有する」が有効なテンプレートが表示されます。ここに表示されるテンプレートは【コピー】のみ可能です。

③テンプレート詳細

テンプレート管理一覧で指定したテンプレートの詳細が表示されます。

テンプレート名

テンプレートの名前（SalesforceにアップロードするVisualforceページ名）が表示されます。

作成日

新規作成またはコピーした日時が表示されます。

更新日

最後に保存した日時が表示されます。

【編集】

編集画面を開きます。レイアウトを変更する場合にクリックします。

テンプレートを共有する

同じ組織（同じCID）内でテンプレートを共有する場合にチェックを入れます。チェックを入れると、同じ組織のすべてのユーザはこのテンプレートを共有フォルダから複製できるようになります。

④設定

【ヘルプ】

ヘルプ画面を開きます。

【設定】

言語の切り替えをします。（日本語/ 英語）

【ログアウト】

OPROARTS Designerからログアウトします。

①メニュー

【ファイル】

保存

編集したテンプレートを保存します。

自動保存

定期的にテンプレートを自動保存します。

保存して閉じる

テンプレートを保存して編集画面を閉じます。

閉じる

編集画面を閉じます。

マッピングへ進む

マッピング画面へ進みます。

【編集】

取消

直前に行った操作を取り消して元に戻します。

やり直し

取り消した操作をもう一度適用します。

切り取り

レイアウト上で選択されたコンポーネントを切り取ります。

コピー

レイアウト上で選択されたコンポーネントをコピーします。

貼り付け

コピーされたコンポーネントを貼り付けます。

削除

レイアウト上で選択されたコンポーネントを削除します。

【表示】

プロパティ

プロパティの表示 / 非表示を指定します。

フォームコンポーネント

フォームコンポーネントの表示 / 非表示を指定します。

操作パレット

操作パレットの表示 / 非表示を指定します。

エクスプローラ

エクスプローラーの表示 / 非表示を指定します。

デザインビュー

デザインビューの表示 / 非表示の設定と倍率を指定します。

補助線

ガイド線の表示 / 非表示を指定します。

視覚効果

コンポーネントの追加、削除時のフェード効果などの視覚効果の有効 / 無効を指定します。

②コンポーネント

レイアウト上に配置してデザインを行うための部品です。配置したコンポーネントの詳細設定はプロパティで行います。

③フォームコンポーネント

レイアウト上に配置してデザインを行うための部品です。（HTML用のテンプレートのみ使用可能）配置したコンポーネントの詳細設定はプロパティで行います。

④プロパティ

レイアウト上に配置したコンポーネントの設定をします。ここでは共通のプロパティ項目を説明します。各コンポーネントのプロパティはコンポーネント、またはフォームコンポーネントをご覧ください。

【全般】

コンポーネントの名前（識別名）の指定や配置位置の確認ができます。

名前

コンポーネントの識別名を指定します。変更後【OK】ボタンをクリックして変更できます。※マッピングデータが保存されているテンプレートのコンポーネントの名前を変更すると、そのコンポーネントへのマッピング情報が正しく復元されませんのでご注意ください。

座標

コンポーネントの位置を「（左上端X座標,左上端Y座標） - （右下端X座標,右下端Y座標）」の形式で表示します。

可視

コンポーネントを可視状態（有効）にする場合はチェックを入れます。

【フレーム】

枠線（境界線）や背景色を設定できます。

枠線

コンポーネントの枠線を指定します。上下左右別の指定が可能です。

枠線幅

枠線の幅を指定します。

枠線カラー

枠線の色を指定します。カラーパレットで選択後、右下の【○】ボタンをクリックして設定します。

背景色

背景色を指定します。カラーパレットで選択後、右下の【○】ボタンをクリックして設定します。

透過

背景色を透明にする場合にチェックを入れます。

【フォント】

コンポーネントのフォントを指定します。

フォント名

フォントを指定します。PDFページを出力する場合は[PDF]または[多言語PDF]サポートのフォントを、HTMLページを出力する場合は[HTML]または[多言語HTML]サポートのフォントを選択します。※日本語に対応しているのは多言語をサポートするフォントのみです。それ以外のフォントでは、日本語の文字は表示されません。

サイズ

文字サイズを指定します。

カラー

背景色を指定します。カラーパレットで選択後、右下の【○】ボタンをクリックして設定します。

文字飾り

文字スタイルを指定します。太字、イタリック、取り消し線、下線から指定できます。

⑤レイアウト

デザインを行う用紙イメージです。コンポーネントをレイアウト上に配置してデザインを作成します。

⑥エクスプローラ

レイアウト上に配置したコンポーネントの一覧が表示されます。最下部のコンポーネントから順に前面に表示されます。コンポーネント名を指定して【上へ】【下へ】をクリックすると、コンポーネントを背面 / 前面へ移動させることができます。マッピング画面でもここの最上部のコンポーネントから順に表示されますので、分かりやすい順序にすることをお奨めします。

⑦デザインビュー

編集中のレイアウトのサムネイルを表示します。

⑧操作

操作のための基本的なコマンド（「元に戻す」や「保存する」など）を表示します。

①メニュー

【ファイル】

デザイナへ戻る: マッピング画面を閉じて編集画面に戻ります。

【表示】

デザインビュー: デザインビューの表示・非表示の設定、表示倍率を指定します。

②指示画面

段階ごとにマッピングの指示が出ます。

[1st] Salesforceにログイン

Salesforceの現在のセッションでログインするか、認証情報を入力してログインします。通常は現在のセッションでログインします。※マッピング情報が保存されている場合、その情報を復元することができます。復元すると、マッピング情報が自動的に入力され、そのまま[完了]まで進みます。

[2nd] マッピングする親オブジェクトを選択

ページのコンポーネントとマッピングする（紐付ける）オブジェクトを選択します。

[3rd] 動的コンポーネントとフィールドの紐付け

動的コンポーネントのマッピング（オブジェクト項目との紐づけ）を行います。

[4th] 明細にマッピングする子オブジェクトを選択

DatasetTableまたはHorizontalDatasetTableで繰り返し表示させる動的コンポーネント（同コンポーネントのバンドに配置されている動的コンポーネント）にマッピングする子オブジェクト（[2nd]で指定したオブジェクトと主従関係または参照関係にあるオブジェクト）を指定します。

[5th] 明細の動的コンポーネントとフィールドの紐付け

繰り返し表示させる動的コンポーネントのマッピングを行います。[3rd]で「子オブジェクトの集計結果」を指定した項目もここでマッピングします。

[完了] 完了と確認

マッピング情報を確認して、問題なければ【保存】をクリックします。保存すると、マッピング情報が保存され、次回マッピング時にその情報を復元することができます。そして、Visualforceページへの変換画面になります。

タブをクリックすると、その段階のマッピング画面に移動することができます。マッピングを戻ってやり直したい場合などに使用します。

矢印アイコンは、指示画面の開閉ができます。Webブラウザが小さく操作がし難い場合は指示画面を閉じることをお勧めします。

③Salesforce.com

Salesforceのオブジェクトやフィールドの一覧が表示されます。

④マッピング

Salesforce.comの中から、使用するオブジェクトをドラッグアンドドロップで指定します。

⑤フィールドマッピング

テンプレート上の各コンポーネントに紐付ける、Salesforceのフィールドをドラッグアンドドロップで指定します。

コンポーネント名

コンポーネントのプロパティで設定したコンポーネント名を表示します。

タイプ

コンポーネントの種類を表示します。

マッピングデータ

紐付けるオブジェクト項目を指定します。項目を複数指定することによる連結表示や、ユーザデータやSalesforce Expressionとの混在も可能です。繰り返し項目の集計結果を表示する場合、「子オブジェクトの集計結果」を指定します。

集計関数（[5th]のみ）

マッピング項目の集計結果を表示させたい場合、集計内容に応じた集計関数を指定します。[3rd]で「子オブジェクトの集計結果」を指定することで、繰り返し以外のコンポーネントに集計結果を表示させるようここで設定することもできます。

初期値（[3rd]フォームコンポーネントのみ）

初期値をユーザデータ、Salesforce Expression、またはそれが格納されているオブジェクト項目を指定します。

⑥デザインビュー

レイアウトのサムネイルを表示します。動的なコンポーネントはハイライト表示されます。フィールドをマッピングするときは、フィールドマッピングで指定したコンポーネントのみハイライト表示され、位置を確認しながら作業できます。

⑦その他のデータ

Salesforce上にない値や、組織情報の値を表示します。フィールドマッピングのマッピングデータ列にドラッグアンドドロップします。

【システムデータ】

本製品のシステム項目を指定するときに用います。

• 日時: 現在の日時を表示します。
• ページ番号: 現在のページ番号を表示します。
• 総ページ数: 総ページ数を表示します。

【ユーザデータ】

固定文字列を追加したい場合に用います。

例）顧客名項目の後ろに「 様」表示したい場合

顧客名 様

【Salesforce Expression】

マージフィールドシンタックス（Visualforce上でオブジェクト項目やメソッドの出力を指定するためのもの）を指定するときに用います。Salesforce組織やユーザ情報の表示、項目のデータ内容に応じた表示内容の変更など、上記にない項目の表示や条件指定などを行いたい場合に使用します。記述方法や使用できる関数などについては、SalesforceのVisualforceに関するドキュメントをご覧ください。

例１）現在ログイン中のユーザの名字を表示させたい場合

{!$User.LastName}

例２）オブジェクト（API名: Exp__c）の住所項目（API名: Address__c）が空欄のときに「ご住所: 」を表示しない場合

{!IF(Exp__c.Address__c == null,'','ご住所: ')}

【集計結果】（[3rd]のみ）

繰り返し項目の集計結果を表示する場合、「子オブジェクトの集計結果」を指定します。指定したコンポーネントは、[5th]で繰り返し項目とマッピングできます。レポートヘッダやフッタなどに商品金額の合計などを集計して表示したい場合に用います。

⑧フォーマット

数値や金額、日付のデータ型フィールドの表示形式を指定します。フィールドマッピングのフォーマット列にドラックアンドドロップします。

【数値の形式】

数値、通貨型のフィールドの値の表示形式を指定します。

【日付時刻の形式】

日付、日付/時間型のフィールドの値の表示形式を指定します。

【ユーザ指定の形式】

形式を独自に設定する場合に用います。ダブルクリックして表示形式を入力し、フォーマット列にドラックアンドドロップします。

⑨集計関数

集計したい項目の集計関数列にドラッグアンドドロップで配置します。[5th]で設定します。

COUNT

繰り返しデータの数を表示します。

MAX

指定した繰り返し項目の最大値を表示します。

MIN

指定した繰り返し項目の最小値を表示します。

AVG

指定した繰り返し項目の平均値を表示します。

SUM

指定した繰り返し項目の合計値を表示します。

Visualforceページへの変換・アップロード

マッピングを保存すると、Visualforceページへの変換画面になります。以下の流れでVisualforceページを生成し、Salesforceへアップロードします。

1. Visualforceページの出力形式を指定します。

   PDF出力用のVisualforceページへ変換

   PDF出力用ページを作成する場合に選択します。フォームコンポーネントやPDF非対応のフォントを使用している場合、HTMLライセンスの場合は選択できません。

   HTML出力用のVisualforceページへ変換

   HTML出力用ページを作成する場合に選択します。

   ページにSalesforceタブを表示する

   HTML出力用の場合にのみ選択できます。ページにSalesforceのタブを表示する場合にチェックを入れます。

   ページにSalesforceサイドバーを表示する

   HTML出力でタブを表示する場合にのみ選択できます。Salesforceのサイドバーを表示する場合にチェックを入れます。

   ページのタイトルを指定する

   HTML出力でタブを表示する場合にのみ指定できます。ページのタイトルを指定します。

2. Visualforceページに変換され、ソースが表示されます。生成したVisualforceページの取得やアップロードができます。

   【クリップボードにコピー】

   ページのソースをクリップボードにコピーします。

   【ファイルに保存】

   ページをファイルでダウンロードします。

   【アップロードを開始する】

   ページをSalesforceにアップロードします。

3. アップロード完了後、完了メッセージが表示されます。【プレビュー】をクリックするとアップロードしたページをプレビューします。

画像データを取得できる項目の作り方

データ型「数式」の項目にIMAGE関数を利用することで、この関数で指定された画像を動的画像の画像コンポーネントにマッピングすることができます。項目の作成方法は以下のようになります。

1. Salesforceの設定ページから画像項目を作成するオブジェクトを開き、カスタム項目を作成します。
2. データ型は「数式」を選択します。
3. 数式の戻り値のデータ型は「テキスト」を選択します。
4. 数式に以下のように指定します。

   IMAGE(画像URLまたはそれが格納される項目, 代替文字列)

   例: 画像のURLにURL型の画像URLの項目（ImgUrl__c）を、代替文字列にテキスト項目（Descrip__c）を指定する場合

   IMAGE(ImgUrl__c, Descrip__c)

5. 残りの設定を行い、保存します。

無記入でのエラーメッセージ表示

項目無記入でエラーメッセージを表示させる場合、項目を必須にします。設定方法は以下のようになります。

1. Salesforceの設定ページから該当のオブジェクトを開き、必須にするカスタム項目を編集します。
2. 「値の入力を必須にする」にチェックを入れ、保存します。

指定条件でのエラーメッセージ表示

項目の値が一定以下の場合にでエラーにするなど、条件を指定してエラーメッセージを表示させる場合、入力規則を使用します。設定方法は以下のようになります。

1. Salesforceの設定ページから該当のオブジェクトを開き、設定する標準項目またはカスタム項目を開きます。
2. 入力規則を新規作成します。
3. ルール名、エラー条件数式、エラーメッセージを入力します。
4. エラー表示場所を指定します。Messageコンポーネントにエラーメッセージを表示させる場合、「項目」を選択し、編集中の項目を選びます。

URLによるVisualforceページ呼び出しボタン（上級者向け）

作成したVisualforceページはURLでも呼び出すことができます。その場合、カスタムボタンまたはリンクに以下のようにURLとオブジェクトIdを指定します。

/apex/ページ名?id={!オブジェクトAPI名.id}

例: ページpdfQuoteを現在の商談（API名: Opportunity）オブジェクトのデータで開く場合。

/apex/pdfQuote?id={!Opportunity.id}

フォームデータ保存後のリンク先の指定（上級者向け）

saveメソッドにより保存後、標準ではオブジェクトの参照ページ（通常はオブジェクトデータの詳細ページ）へジャンプします。保存後のリンク先を指定する場合、カスタムコントローラを定義します。※この方法は、Apexクラスが使えるEnterpriseエディション、Performanceエディション、またはDeveloperエディションでのみ可能です。

1. Salesforce設定ページの[アプリケーションの設定]|[開発]|[Apexクラス]を開き、Apexクラスを新規作成します。
2. Apexクラスを以下のように記述して、保存します。（これは、保存後のリンク先をpageAfterSaveページにしたい場合です。）

   public class AfterSaveExtension {
     ApexPages.StandardController controller;
   
     public AfterSaveExtension(ApexPages.StandardController controller) {
       this.controller = controller;
     }
   
     public PageReference save() {
       controller.save();
   
       PageReference pr = Page.pageAfterSave;
       pr.getParameters().put('id', controller.getId());
       return pr;
     }
   }
   

3. [アプリケーションの設定]|[開発]|[ページ]を開き、設定するページを編集します。
4. ページの先頭行にあるapex:pageタグの「extensions」に、先ほど作成したApexクラス名を以下のように追加して、保存します。

   <apex:page standardController="オブジェクトAPI名"
     extensions="AfterSaveExtension, OPROARTS020.MultiContactTemplateController"
     showHeader="false" sidebar="false">