Oracle® Fusion Applications拡張性ガイド 11g リリース1 （11.1.3） B69967-01

目次

次へ

次へ

1 Oracle Fusion CRM Applicationsの拡張性

この章の内容は次のとおりです。

CRMアプリケーションの拡張: 準備

CRMアプリケーションの拡張: 操作

Oracle Fusion CRM アプリケーション・コンポーザを使用したOracle Fusion CRMアプリケーションのカスタマイズ: 説明

オブジェクトの定義: 説明

オブジェクト関連: 説明

フィールドの定義: 説明

フィールド・タイプ

ページの定義: 説明

作業領域の作成: 説明

サブタブ: 説明

ツリー・ノード: 説明

ボタンおよびリンク: 説明

CRMオブジェクトに関する保存済検索: 説明

カスタム・オブジェクトの保護: 説明

Groovyスクリプト: 説明

Groovyスクリプト: 例

Groovyスクリプトでサポートされているクラスとメソッド: 説明

カスタム・オブジェクトのインポートとエクスポート: 説明

Oracle Fusion CRMアプリケーションの拡張に関するFAQ

CRMアプリケーションの拡張: 準備

Oracle Fusion CRM アプリケーション・コンポーザは、Oracle Fusion CRMのアプリケーションのカスタマイズや拡張ができる唯一のツールです。Oracle Fusion CRMのどのアプリケーションを拡張・カスタマイズするときも、事前にOracle Fusion Applications拡張性ガイドを読み、どのような拡張ができ、どのようなツールが使用できるかを確認してください。

Oracle Fusion Applications拡張性ガイドでは、Oracle Fusion CRMに限らず、あらゆるOracle Fusionのアプリケーションについて順を追ってカスタマイズの方法を紹介しています。そのガイドをご覧になったら、次にOracle Fusion CRM拡張ガイドにも目を通し、アプリケーション・コンポーザを使用したOracle Fusion CRMのアプリケーションの拡張とカスタマイズの方法をよく理解してください。

はじめに: Oracle Fusion Applications拡張性ガイドを読む

• Oracle Fusion Applications拡張性ガイドを参照し、アプリケーションの変更に利用できるツールを確認します。また、Sandbox ManagerやCustomization Managerの使用方法など、カスタマイズの開発ライフサイクルについても確認します。
  Oracle Fusion Applicationsのカスタマイズと拡張の紹介の項を参照してください。
• Oracle Fusion Applications拡張性ガイドでは、ページ、オブジェクト、レポート、セキュリティのカスタマイズなど、主なカスタマイズのタスクも紹介しています。
  ビジネスユーザーのカスタマイズと拡張の項を参照してください。
• Oracle Fusion Applications拡張性ガイドをご覧になった後、アプリケーション・コンポーザの使用方法を詳しく説明しているOracle Fusion CRM拡張ガイドにも目を通してください。

CRMアプリケーションの拡張: 操作

Oracle Fusion CRM アプリケーション・コンポーザは、アプリケーション開発者だけでなくビジネス・アナリストや管理者にもOracle Fusion CRMのアプリケーションのカスタマイズや拡張を可能にするブラウザ・ベースの設定ツールです。CRMアプリケーション以外ではアプリケーション開発者しかできないようなデータ・モデルの変更を行います。たとえば、新しいオブジェクトと関連フィールドを作成し、そのオブジェクトとフィールドをユーザーに表示する「企業ページ」を作成することができます。アプリケーション・コンポーザは、design time at runtime tool、つまり、CRMアプリケーションから直接アプリケーション・コンポーザにナビゲートし、変更を行い、アプリケーションにサイン・バックしなくてもリアルタイムでほとんどの変更がすぐに反映されていることを確認することができます。カスタム・フィールドの作成などのデータ・モデルの変更を行ったときは、再認証しないとそれらの変更を見ることはできません。

パターン・ベースのアプリケーション設計

アプリケーション・コンポーザは、標準的な設計パターンやウィザードを利用してビジネス・アナリストがカスタマイズの複雑さを感じなくてすむようにします。事業が求める（オブジェクト・モデルの拡張、レイアウトの変更などの）アプリケーションの変更に集中することができ、アプリケーション・コンポーザがunderlyingオブジェクトのアーティファクトを作成します。

ランタイム時に、「ナビゲータ・メニュー」を使用し、ツールカテゴリで「アプリケーション・コンポーザ」を選択し、任意のCRMアプリケーションからアプリケーション・コンポーザにアクセスします。アプリケーション・コンポーザで最初に表示されるのは、すべてのカスタマイズ・オプションへのエントリ・ポイントである主要「概要」ページです。

アプリケーション・コンポーザの「概要」ページからは、次のようなアプリケーションの変更を行うことができます。

• 新しいフィールドの追加によるオブジェクトのカスタマイズ、またはまったく新しいオブジェクトの作成。

• 二つのオブジェクト間の外部キーの関係の作成。

• あるオブジェクトについて新しく作成したフィールドの表示による企業ページのカスタマイズ、または新しく作成したオブジェクトのまったく新しい作業領域の作成。

  企業ページ上でのサブタブまたはツリー・ノードによるオブジェクト関係の表示。

• 特定のオブジェクトまたは複数オブジェクト間のトリガー、検証ルール、ワークフローなどのアプリケーション・ロジックの書き込み。

• カスタム・オブジェクトの機能およびデータレベル・セキュリティの実装。

• カスタム・レポート用オブジェクトの有効化。

はじめに: アプリケーション・コンポーザの概要ページ

アプリケーション・コンポーザにアクセスするには、CRM管理者の職務ロールでログインします。 その上で、「ナビゲータ・メニュー」のツールカテゴリで「アプリケーション・コンポーザ」を選択し、主要「概要」ページにナビゲートします。

主要「概要」ページから「アプリケーション」選択リストでカスタマイズしたいアプリケーションを選択します。 その後は、

• オブジェクト・ツリーでカスタマイズしたいオブジェクトを選択するか、「新規」アイコンをクリックして新しいオブジェクトを作成します。

  
  
  

• 主要「概要」ページのリンク（ローカル領域）でカスタマイズのタスクを選択します。

  または「共通設定」ペインのリンクを利用します。

  
  
  

CRMの別のアプリケーションをカスタマイズするときは、「アプリケーション」選択リストで目的のアプリケーションに変更します。

Oracle Fusionアプリケーションの拡張性

アプリケーション・コンポーザは、Oracle Fusion CRMのアプリケーションのカスタマイズと拡張ができる唯一のツールです。 Oracle Fusionアプリケーション全体で実行できる拡張オプションの詳細については、Oracle Fusion Applications拡張性ガイドをご覧ください。

Oracle Fusion CRM アプリケーション・コンポーザを使用したOracle Fusion CRMアプリケーションのカスタマイズ: 説明

Oracle Fusion CRM アプリケーション・コンポーザでは、一連のタスク・フローでOracle Fusion CRMアプリケーションをユーザーのニーズに従ってカスタマイズ・拡張することができます。たとえば、既存の標準オブジェクトの新規フィールドの作成、その新規フィールドのオブジェクト作業領域への表示を行うことができます。また、新しいカスタム・オブジェクトと関連フィールドを作成した上で、そのオブジェクトとフィールドをユーザーに表示する作業領域を作成することもできます。利用できるタスク・フローは、カスタマイズしようとしているCRMアプリケーションによって異なります。この項では、各CRMアプリケーションで使用可能なCRM アプリケーション・コンポーザのタスク・フローを一覧表で紹介します。

この項では、次のCRMアプリケーションの拡張性を紹介します。

• Oracle Fusion Common CRM

• Oracle Fusion Customer Center

• Oracle Fusion Marketing

• Oracle Fusion Sales

• Oracle Fusion Sales Catalog

個々のアプリケーションのアプリケーション・コンポーザでの操作方法は、個々の製品の実装ガイドにも紹介しています。

Oracle Fusion Common CRM

Oracle Fusion Common CRMアプリケーションには、カスタム・オブジェクトを作成することはできません。

Oracle Fusion Common CRMの標準オブジェクトについては、アプリケーション・コンポーザで次のことができます。

Oracle Fusion Customer Center

Oracle Fusion Customer Centerアプリケーションには、カスタム・オブジェクトを作成することができます。

Oracle Fusion Customer Centerの標準オブジェクトについては、アプリケーション・コンポーザで次のことができます。

Oracle Fusion Marketing

Oracle Fusion Marketingアプリケーションには、カスタム・オブジェクトを作成することができます。

Oracle Fusion Marketingの標準オブジェクトについては、アプリケーション・コンポーザで次のことができます。

Oracle Fusion Sales

Oracle Fusion Salesアプリケーションには、カスタム・オブジェクトを作成することができます。

Oracle Fusion Salesの標準オブジェクトについては、アプリケーション・コンポーザで次のことができます。

Oracle Fusion Sales Catalog

Oracle Fusion Sales Catalogアプリケーションには、カスタム・オブジェクトを作成することはできません。

Oracle Fusion Sales Catalogの標準オブジェクトについては、アプリケーション・コンポーザで次のことができます。

オブジェクトの定義: 説明

Oracle Fusion CRM アプリケーション・コンポーザで使用可能なカスタマイズのオプションの中で代表的なものにCRMアプリケーションのオブジェクト・モデルの拡張があります。既存のオブジェクト（標準オブジェクト）に新しいフィールドを追加してCRMオブジェクトをカスタマイズしたり、まったく新しいオブジェクト（カスタム・オブジェクト）を作成します。標準オブジェクトはCRMアプリケーションに事前に設定されているオブジェクトで、アプリケーション・コンポーザでカスタマイズすることができます。カスタム・オブジェクトはアプリケーション・コンポーザで新規に作成するオブジェクトです。トップ・レベル・オブジェクト（親のないオブジェクト）でも子オブジェクト（親のコンテキスト内で作成されるオブジェクト）でも作成することができます。

CRMアプリケーションのオブジェクト・モデルのカスタマイズ、拡張を行うときは、事前に次のアプリケーション・コンポーザにおけるオブジェクト・モデル拡張時の操作をよく理解してください。

• オブジェクト・ツリーの参照

• カスタム・オブジェクトの作成

• オブジェクト概要ページの使用

• オブジェクト属性の編集

• 子オブジェクト、関連オブジェクトの表示

• カスタム・オブジェクトの削除

CRM アプリケーション・コンポーザのオブジェクト・ツリー

CRMアプリケーション実行時に「ナビゲータ・メニュー」で「アプリケーション・コンポーザ」を開きます。アプリケーション・コンポーザで最初に表示されるのは、すべてのカスタマイズ・オプションへのエントリ・ポイントである主要「概要」ページです。

主要「概要」ページでは、左のペインにオブジェクト・ツリーが表示され、アプリケーションの既存のオブジェクトの構成をツリー形式で参照することができます。 このオブジェクト・ツリーは、標準オブジェクトもカスタム・オブジェクトも、最新のアプリケーションの構成を反映しています。

オブジェクト・ツリーの使用方法:

1. 「ナビゲータ・メニュー」でツールカテゴリから「アプリケーション・コンポーザ」を選択します。

2. 主要「概要」ページでアプリケーション選択リストから「アプリケーション」を選択します。

   
   
   

3. 標準、カスタムにかかわらず、個々のオブジェクト・ノードについて、オブジェクトのフィールドや、オブジェクトを表示する企業ページなどのオブジェクト詳細を表示、編集して拡張を行います。

   
   
   

   ヒント

   オブジェクト・ツリー最上部の「新規」アイコンをクリックすると、新しいカスタム・オブジェクトを作成することができます。

   標準、カスタムのどちらのオブジェクトについても、次の詳細を表示、編集することができます。

   • フィールド

     オブジェクトに新しいフィールドを追加します。

   • ページ

     オブジェクトを表示するページを変更します。

   • ボタンおよびリンク

     企業ページにボタンまたはリンクを追加します。

   • サーバー・スクリプト

     オブジェクトのレコードの動作を制御するアプリケーション・ロジックを記述します。

   • 保存済検索

     オブジェクトに関する保存済検索を定義します。

   カスタム・オブジェクトの場合は、次の詳細も表示、編集することができます。

   • セキュリティ

     オブジェクトとそのレコードに関する機能、データ・レベル・セキュリティを実装します。

カスタム・オブジェクトの作成

新しいカスタム・オブジェクトを作成するときは、まずアプリケーション・コンポーザの主要「概要」ページでアプリケーションを選択します。新しいカスタム・オブジェクトは選択したアプリケーションに属します。アプリケーション選択後は、次のように操作します。

1. 主要「概要」ページのオブジェクト・ツリーまたはローカル領域で「カスタム・オブジェクト」のノードまたはリンクを選択します。

   それによって表示される要約表で「新規」アイコンをクリックします。

2. あるいは、オブジェクト・ツリー最上部の「新規」アイコンをクリックします。

3. カスタム・オブジェクトのプライマリ識別属性を記入します。

   1. 表示ラベル

      オブジェクトのユーザー・フレンドリなラベルであり、オブジェクトの作業領域のデフォルト・ページのタイトルにもなります。

   2. 複数ラベル

      オブジェクトをサブタブなどのマスター・ディテール・ページのディテール・セクションに表示するときに使用するラベルです。

   3. レコード名

      オブジェクトのレコード名フィールドの表示ラベルを指定します。レコード名フィールドには、レコードの「名前」が保存されます。たとえば、商談オブジェクトでは、商談の名前がこのフィールドに保存されます。したがって、カスタム・オブジェクトを作成しているときは、レコード名フィールドを「商談名」に設定します。

      通常、このフィールドでは、プライマリ・ユーザーが認識可能なオブジェクトの識別子、つまり、ランタイム・ユーザーが概要ページから詳細ページまでドリルダウンするときの識別子を設定します。

   4. オブジェクト名

      オブジェクトの内部名です。

   5. 摘要

オブジェクト概要ページの使用

オブジェクト概要ページは、標準またはカスタム・オブジェクトの高レベルの概要を表示します。 オブジェクトのプライマリ属性のほか、（ある場合は）子オブジェクトや関連オブジェクトのリストも表示します。

オブジェクト概要ページの開き方:

1. 主要「概要」ページでアプリケーションを選択します。

2. オブジェクト・ツリーで標準またはカスタム・オブジェクトを選択します。

3. あるいは、主要「概要」ページのオブジェクト・ツリーまたはローカル領域で「標準オブジェクト」もしくは「カスタム・オブジェクト」のノードまたはリンクを選択し、表示される要約表でオブジェクトを選択し、「編集」アイコンをクリックします。

オブジェクト概要ページでできること:

• 先に説明したオブジェクトのプライマリ属性の編集。

• 選択したオブジェクトについて作成されている親子の関連の表示。

  このページでは、新しい子オブジェクトを作成し、暗黙的に新しい親子の関連を作成することもできます。

• 選択したオブジェクトについて作成されている親子以外の関連の表示。

オブジェクトの属性の編集

作成したオブジェクトの属性をオブジェクト概要ページで編集することができます。

オブジェクトの属性の編集方法:

1. 主要「概要」ページでアプリケーションを選択します。

2. 主要「概要」ページのオブジェクト・ツリーまたはローカル領域で「標準オブジェクト」もしくは「カスタム・オブジェクト」のノードまたはリンクを選択します。

3. 表示される要約表でオブジェクトを選択し、「編集」アイコンをクリックして、オブジェクト概要ページにナビゲートします。

4. オブジェクト概要ページで「編集」をクリックします。

   • 必要に応じて、オブジェクトの表示ラベル、複数ラベル、摘要、レコード名を変更します。

   • オブジェクト名とAPI名は、オブジェクト作成後に変更することはできません。

     カスタム・オブジェクトのAPI名は、論理名のあとに_cを付けて自動的に付けられます。API名は、オブジェクトのビジネス・ロジックを書込むときに式エディタで作成するGroovy式で使用します。

子・関連オブジェクトの表示

オブジェクト概要ページは、（ある場合は）オブジェクトについて作成されている子オブジェクトや関連オブジェクトのリストも表示します。 このページでは、新しい子オブジェクトを作成することもできます。

• 子オブジェクトは親オブジェクトとともにカスケード削除される関係にあるオブジェクトです。つまり、親オブジェクトを削除すると、その子はすべて自動的に削除されます。子オブジェクトは親オブジェクトのコンテキスト外には存在せず、独自の作業領域も持ちません。子オブジェクトとして作成したオブジェクトは、親オブジェクトに変更することはできません。

• 関連オブジェクトは、1つのオブジェクトが削除されても相互に独立して存在することができます。関連オブジェクトは、親子としてではなく、トップ・レベル・オブジェクト同士の外部キー・ベースの関連でつながっています。このような関連には、参照関連、動的選択リスト関連などがあります。

  関連オブジェクトは、現在のオブジェクトと1対多または多対1の関連を持つことができます。なお、オブジェクトはそれ自体と関連し、そのオブジェクトの階層をモデル化することができます。この場合は、そのオブジェクト自体がオブジェクト概要ページに関連オブジェクトとして表示されます。たとえば、部門オブジェクトとサブ部門オブジェクトはそのように表示されます。

  注意

  このようなタイプの関連は、このページでは作成しません。関連の管理は、アプリケーション・コンポーザの主要「概要」ページから開ける「関連」ページから行います。あるいは、あるオブジェクトについて別のオブジェクトから選択リストの値を導出する動的選択リスト・フィールドを作成し、動的選択リスト関連を作成します。

標準またはカスタム・オブジェクトの子オブジェクトの作成:

1. オブジェクトのオブジェクト概要ページにナビゲートします。

2. 「子オブジェクトの作成」ボタンをクリックします。子オブジェクトの作成方法はカスタム・オブジェクトの作成方法と同じです。ただし、

   • 現在のオブジェクトは自動的に親オブジェクトとして表示されます。

   • 子コレクション名フィールドを指定し、後でGroovyスクリプトを書込むときに使用できる子オブジェクト・レコードの集合の内部名を指定します。

カスタム・オブジェクトの削除

アプリケーション・コンポーザは標準オブジェクトの削除もカスタム・オブジェクトの削除もサポートしません。不必要なオブジェクトがあるときは、オプションで摘要にそのオブジェクトは使用しない旨のノートを入力することができます。

オブジェクト関連: 説明

関連は、2つのオブジェクトが外部キーによって関連付けられた状態をさし、2つのオブジェクトのデータの間に関係があることを意味します。この関係は子または関連オブジェクト・サブタブ、あるいはツリー・ノードを利用して「企業ページ」に表示することができます。Oracle Fusion CRM アプリケーション・コンポーザを使用すると、同じアプリケーション内の2つのオブジェクト間に1対多の関連を作成し、一方のオブジェクトのプライマリ識別子が他方のオブジェクトの表に保存されるようにすることができます。関連が存在していなければ、「1」のオブジェクトの詳細ページまたはツリーに表示されるサブタブまたはツリー・ノードに「多」のオブジェクトを表示することはできません。たとえば、1つのアカウントに関連付けられるサービス要求が複数存在することがあります。特定のアカウントに関連付けられたサービス要求のリストをそのアカウントの詳細ページのサブタブとして表示するには、まずそのアカウントとサービス要求のオブジェクトの間に1対多の関連を作成しなければなりません。これらの関連は、子オブジェクトまたは動的選択リストを作成することにより、暗黙的に作成することができます。あるいは、「関連の作成」ページで明示的に作成します。

オブジェクト間の関連を作成するときは、事前にアプリケーション・コンポーザにおける関連作成プロセスについて次の点を確認してください。

• 関連タイプ

• 参照関連の作成

• サブタブまたはツリー・ノードの追加

• 多対多の関連

関連タイプ

1対多の関連には4つのタイプが存在:

• 親子関連

  親子関連は、カスタム・オブジェクトがトップ・レベル・オブジェクトの子として作成されたときに暗黙的に作成されます。

  これは、子オブジェクトを作成すると、特に親のコンテキストにおいて作成されます。子オブジェクトは、独自の作業領域を持たず、親オブジェクトが削除されると、削除されます。

  親子関連は、親オブジェクトのオブジェクト概要ページに表示されます。親子関連が存在すれば、子オブジェクトは親のオブジェクト概要ページの「子オブジェクト」リージョンにリスト表示されます。トップ・レベル・オブジェクトは数多くの子オブジェクトを持つことができます。

  また、子オブジェクトのオブジェクト概要ページで親子関連を見ることもできます。親子関連が存在すれば、子のオブジェクト概要ページのオブジェクト情報リージョンに親オブジェクトがリスト表示されます。子オブジェクトは1つの親オブジェクトしか持つことができません。

  「関連」ページでは、親子関連から暗黙的に作成される関連も見ることができます。関連名は自動的に生成されます。

• 選択リスト関連

  選択リスト関連は、動的選択リスト・フィールドを作成したときに2つのオブジェクトの間に暗黙的に作成されます。

  選択リスト関連はオブジェクトのオブジェクト概要ページに表示されます。選択リスト関連が存在すれば、オブジェクト概要ページの「関連オブジェクト」リージョンに関連オブジェクトがリスト表示されます。

  動的選択リストは他のオブジェクトの実データから移入される値リストを含むフィールドです。たとえば、「企業ページ」に、ユーザーに特定の部門の人事担当者を指定させる動的選択リストを表示させたいとします。その人事担当者選択リストは、部門オブジェクトに追加するフィールドですが、値リストは従業員オブジェクトから実際の従業員によって移入されます。

  トラブル・チケットに関する選択に使用可能なアカウントのリストを作成する先の例では、1つのアカウントを複数のトラブル・チケットに結びつけることができます。作成される関連はアカウントとトラブル・チケットの間の1対多の関連であり、これにより、ユーザーがトラブル・チケットの表にアカウントの識別子を保存することが可能になります。この関連では、アカウント・オブジェクトがソース・オブジェクト、トラブル・チケット・オブジェクトがターゲット・オブジェクトになります。そこで、ランタイム時にソース・オブジェクトがシステムから削除されることがあれば、この動的選択リストは内部に値を持たないことになります。

  後で、そのアカウントの詳細ページに、1つのアカウントについて、それに関連するトラブル・チケットをすべて表示する関連オブジェクト・サブタブを表示させたいときは、この関連オブジェクト・サブタブは、動的選択リストを作成したときにすでに関連が作成されているので、作成することができます。

  これらのオブジェクトは関連オブジェクトで、親子オブジェクトではありません。関連オブジェクトは現在のオブジェクトが削除されても削除されません。

  動的選択リスト関連から暗黙的に作成される関連は、「関連」ページでも見ることができます。関連名は自動的に生成されます。

  注意

  一般に、動的選択リストを作成すると、暗黙的に1つの選択リスト関連を作成することになります。例外は、CRMオブジェクトと共通オブジェクト、つまりリソース、組織担当者、組織プロファイル、所在地との間で動的選択リストを作成した場合です。この場合は、関連が暗黙的に作成されることはありません。

• 参照関連

  動的選択リストを使用して2つのオブジェクトの間に関連を作成するかわりに、この関連を参照関連として手動で作成することもできます。

  参照関連は、「関連の作成」ページを使用して2つのトップ・レベル・オブジェクトの間に明示的に作成されます。

  参照関連はオブジェクトのオブジェクト概要ページに表示されます。参照関連が存在すれば、オブジェクト概要ページの「関連オブジェクト」リージョンに関連オブジェクトがリスト表示されます。

  先の例の場合、部門の企業ページに人事担当者の選択リストを表示する必要がなく、従業員の詳細ページに部門のサブタブを追加したい場合には、従業員と部門オブジェクトの間に手動で、従業員をソース・オブジェクト、部門をターゲット・オブジェクトとする参照関連を作成します。これにより、部門サブタブの作成が可能になります。しかし、このような参照関連では、部門の企業ページで使用できる、対応する人事担当者選択リストは自動的に作成されません。また、手動で関連を作成してしまうと、その関連を再利用して選択リストを作成することもできません。つまり、参照関連を作成するときは、事前に選択リストの必要性をよく検討する必要があります。

• 標準関連

  標準関連は、Oracle Fusion CRMアプリケーションによってすでに2つの標準オブジェクトの間に作成されている関連です。

  標準関連は、オブジェクトのオブジェクト概要ページでも見ることができます。標準関連が存在すれば、オブジェクト概要ページの「関連オブジェクト」リージョンに関連オブジェクトがリスト表示されます。

参照関連の作成

「関連の作成」ページを利用して、2つのトップ・レベル・オブジェクトの間の外部キー・ベースの1対多の関連を作成します。明示的に作成する関連は、参照関連ともいいます。

子オブジェクトや動的選択リストを作成しても外部キー・ベースの1対多の関連を作成することができます。これらの暗黙的関連については、関連トピックで説明します。

同じアプリケーション内の2つのトップ・レベル・オブジェクトの関連の明示的作成:

1. 「共通設定」ペインで「関連」を選択します。

2. 「関連」ページで「新規」アイコンをクリックします。

   
   
   

3. ソース・オブジェクトとターゲット・オブジェクトを選択します。

   
   
   

   子オブジェクトは、ソース・オブジェクトにもターゲット・オブジェクトにもなります。

   ノート、顧客対応、タスクなどの共通コンポーネントは、ソース・オブジェクトとしてもターゲット・オブジェクトとしても選択することはできません。

   通常、関連は同じアプリケーション内の2つのオブジェクトの間で作成します。ただし、次のような共通オブジェクトはターゲット・オブジェクトとして選択することができます。

   • 取引先コミュニティ・リソース

   • 取引先コミュニティ組織担当者

   • 取引先コミュニティ組織プロファイル

   • 取引先コミュニティ所在地

   一度関連を作成したら、ソース・オブジェクトもターゲット・オブジェクトも編集することはできません。

   この関連はターゲット・オブジェクトに外部キー詳細を保存するフィールドを追加します。ソース・オブジェクトが削除されても、ターゲット・オブジェクトのレコードはシステムに残ります。

4. 関連名と摘要を入力します。

   関連名は、関連を作成したら編集することはできません。

5. 必要に応じて、ソース・オブジェクトの詳細ページのサブタブで、あるいはツリー・ノードとしてターゲット・オブジェクトを追加します。

サブタブまたはツリー・ノードの追加

オブジェクト間の関連を作成したら、「1」のオブジェクトの詳細ページまたはツリーに表示されるサブタブまたはツリー・ノードに「多」のオブジェクトを表示させることができます。

オブジェクトの詳細ページまたはオブジェクトにサブタブまたはツリー・ノードを追加するときは、オブジェクトのページ概要ページから「子オブジェクト」または「関連オブジェクト」サブタブを追加することを選択します。アプリケーション・コンポーザが現在のオブジェクトとソース・オブジェクトとして関連を持つ任意のターゲット・オブジェクトに基づいてサブタブまたはツリー・ノードを追加します。サブタブ、ツリー・ノードについては、関連トピックを参照してください。

多対多の関連

オブジェクトは多対多の関連も持つことができます。たとえば、複数の従業員が1つのサービス要求に取り組んでいる場合が考えられます。また、1人の従業員が複数のサービス要求に取り組む場合も考えられます。このシナリオでは、サービス要求と従業員のオブジェクトの間に多対多の関連を作成し、両方のオブジェクトからの関連レコードが交差表にプライマリ識別子を保存するようにします。

アプリケーション・コンポーザを利用した多対多の関連の作成:

1. 一方のオブジェクトの子オブジェクトを作成し、その子オブジェクトを両方のオブジェクトのレコード識別子を保存する交差表として利用します。

   たとえば、あるサービス要求オブジェクトの子として、そのサービス要求のメンバー・オブジェクトを作成します。そのメンバー・オブジェクトの表は、サービス要求識別子を外部キーとして記録します。

2. 作成した子オブジェクトに、多対多の関連における他方のオブジェクトを関連オブジェクトとする動的選択リストを追加します。

   たとえば、そのメンバー・オブジェクトに従業員を関連オブジェクトとする動的選択リストサポート担当者を作成します。アプリケーション・コンポーザは自動的に、従業員をソース・オブジェクトとし、サービス要求メンバーをターゲット・オブジェクトとする基礎関連を作成します。このサービス要求メンバー・オブジェクトの表は、従業員識別子を外部キーとして記録します。

このサービス要求メンバー・オブジェクトの表は2つの外部キーを記録します。1つはサービス要求オブジェクトのもので、もう1つは従業員オブジェクトのものです。これで多対多の関連が可能になります。次のようなこともできます。

• サービス要求の詳細ページへの子サブタブの作成。このサブタブには、特定のサービス要求に取り組んでいるすべての従業員が表示されます。

• 従業員の詳細ページへの関連オブジェクト・サブタブの作成。このサブタブには、どの従業員も複数のサービス要求に取り組む可能性があるので、1人の従業員が取り組んでいるすべてのサービス要求が表示されます。

フィールドの定義: 説明

Oracle Fusion CRM アプリケーション・コンポーザでは、標準、カスタム・オブジェクトに新規フィールドを追加してCRMアプリケーションのオブジェクト・モデルを拡張することができます。標準オブジェクトには標準フィールドがあります。標準フィールドはCRMアプリケーションの標準オブジェクトに割り当てられたフィールドです。オブジェクトに追加するフィールドはカスタム・フィールドといいます。カスタム・フィールド作成時には、アプリケーション・コンポーザが選択可能なフィールド・タイプを提示します。たとえば、チェック・ボックス・タイプや長いテキスト・タイプのフィールドを作成できます。オブジェクトのカスタム・フィールドを作成して「企業ページ」に表示するときは、アプリケーション・コンポーザが自動的に基礎オブジェクトのアーティファクトを作成し、それらの新規フィールドについても完全にWebサービスをサポートします。アプリケーション・コンポーザはオブジェクト・モデルの拡張のインポート、エクスポートもしやすくします。

CRMアプリケーションのオブジェクト・モデルのカスタマイズ、拡張を行うときは、事前にアプリケーション・コンポーザにおけるフィールド編集の次の操作を確認してください。

• オブジェクトへのフィールドの追加

• フィールドの削除

オブジェクトへのフィールドの追加

「フィールド」ページを使用してオブジェクトの標準およびカスタム・フィールドのリストを確認し、カスタム・フィールドを作成します。CRMオブジェクトは最大625までフィールドを持つことができます。

オブジェクトの「フィールド」ページの表示:

1. 主要「概要」ページの「アプリケーション」選択リストでアプリケーションを選択します。

2. オブジェクト・ツリーの「標準オブジェクト」または「カスタム・オブジェクト」ノードを選択し、オブジェクトのリストを展開します。

3. オブジェクトを選択し、ツリー階層をさらに展開します。

4. 「フィールド」ノードを選択し、「フィールド」ページへナビゲートします。

「フィールド」ページでの操作:

• 標準フィールド

  オブジェクトの標準フィールドのリストを確認し、必要に応じてフィールドの表示ラベルとヘルプ・テキストを修正します。

  標準フィールドのリストには、オブジェクトのすべての固有フィールドと、次のようなシステム・フィールドが表示されます。

  • CreatedBy

  • CreationDate

  • Id

  • LastUpdateDate

  • LastUpdatedBy

  • RecordName

  これらのシステム・フィールドは、作成するカスタム・オブジェクトにも、他のフィールドとともに含まれます。

• カスタム・フィールド

  標準またはカスタム・オブジェクトについて特にCRM実装用に作成されているカスタム・フィールドのリストを確認し、新しいカスタム・フィールドを作成します。

  カスタム・フィールドを作成するときは、「フィールド」ページのカスタム・フィールド表で「新規」アイコンを選択します。 新規フィールドを作成するときは、アプリケーション・コンポーザが選択可能なフィールド・タイプを表示します。

  • テキスト

  • 長いテキスト

  • 番号

  • 日付

  • 日時

  • チェック・ボックス

  • 比率

  • 通貨

  • 算式

  • 固定選択リスト

  • 動的選択リスト

フィールドの削除

アプリケーション・コンポーザはオブジェクトからの標準またはカスタム・フィールドの削除をサポートしません。 不必要なフィールドがあるときは、オプションでフィールドの摘要にそのフィールドは使用しない旨のノートを入力することができます。

フィールド・タイプ

フィールドのタイプとプロパティ: 説明

カスタム・フィールドを作成するときは、標準的なフィールド・タイプの中からタイプを選択します。どのタイプにも標準的なプロパティがあります。特定のタイプに固有のプロパティもあれば、複数のタイプに共通したプロパティもあります。たとえば、どのフィールド・タイプを選択しても、そのフィールドを「企業ページ」に表示するときの表示ラベルは指定しなければなりません。

オブジェクトに新規フィールドを作成するときは、次の点を理解してください。

• 作成可能な標準フィールドのタイプ

• フィールドについて指定しなければならない共通のフィールド・プロパティ

• フィールド・タイプと他のコンポーネントの関係

フィールド・タイプ

オブジェクトに新規フィールドを作成するときは、Oracle Fusion CRMアプリケーション・コンポーザが選択可能な標準フィールド・タイプを表示します。

作成可能なフィールドのタイプは次のとおりです。

• テキスト

  文字、数字、記号を組合せて入力することができます。このフィールド・タイプは254文字までに制限されます。

• 長いテキスト

  文字、数字、記号を組合せて入力することができます。このフィールド・タイプは32,000文字まで入力可能です。

• 番号

  このフィールドには数値を入力することができます。

• 日付

  日付を入力するかカレンダーから日付を選択することができます。

• 日時

  日付を入力するかカレンダーから選択し、時刻を入力することができます。フィールド作成時に、日付、時刻、その両方のいずれを表示するかを選択します。

• チェック・ボックス

  レコードのtrue、falseの属性を示すチェック・ボックスを選択することができます。

• 比率

  比率を入力することができます。比率の記号はシステムが自動的に付加します。

• 通貨

  通貨金額を入力することができます。

• 固定選択リスト

  FND参照タイプから移入された静的値のリストから選択することができます。

• 動的選択リスト

  他のオブジェクトのレコードのセットから移入された値のリストから選択することができます。

• 算式

  算式フィールドは、ランタイムCRMアプリケーションにおいて、算式フィールドの定義に含まれるGroovyベースの式を使用して計算されるフィールドです。ランタイム・アプリケーションのユーザーが更新しない読取り専用フィールドです。ただし、アプリケーションの論理を書込むと、これらのフィールドを直接更新することができます。

共通フィールド・プロパティ

カスタム・フィールドを作成するときは、まずフィールド・タイプを選択します。作成するのはチェック・ボックス・フィールドですか、算式フィールドですか、長いテキストフィールドですか？フィールドを作成したら、フィールド・タイプを変更することはできません。指定するフィールド・タイプによって、フィールド作成時に定義しなければならないフィールド・プロパティが変わります。他のフィールド・タイプと共通のプロパティもありますが、それ以外のプロパティは個々のフィールド・タイプ固有のものです。

カスタム・フィールドについて定義することができる共通のフィールド・プロパティを、フィールド構成ページのそれらが表示されるリージョンや、それらのプロパティの設定が必須のフィールド・タイプとともに下表に示します。新規フィールドを作成するときは、この表で定義しなければならない共通プロパティを確認してください。

フィールド・タイプと他のコンポーネントの関係

オブジェクトに新規フィールドを作成するときは、アプリケーション・コンポーザが標準フィールド・タイプだけに制限します。選択可能なフィールド・タイプはすでにCRM Extensibility Frameworkの他のコンポーネントと統合されていて、CRM実装のカスタマイズ、拡張を行うときに最大限可能な柔軟性を提供します。

• すべてのフィールド・タイプがAPIデータ型に対応しており、個々のフィールド・タイプがcustomfield_cなどのAPI名を持っています。

  式エディタを使用してサーバー・スクリプトを書くときは、この_cのフィールド名を使用してフィールドを参照してください。

• すべてのフィールド・タイプがWebサービスのXSDペイロードに対応しています。

• すべてのフィールド・タイプがアプリケーション・コンポーザのインポート、エクスポート機能を利用したインポートODIマッピングに対応しています。

• ほとんどのフィールド・タイプがレポート用カスタム・サブジェクト領域の作成に使用可能なフィールドに対応しています。対応していないのは、長いテキスト、チェック・ボックス、算式フィールドです。

テキスト・フィールド: 説明

Oracle Fusion CRM アプリケーション・コンポーザでは、標準、カスタム・オブジェクトに新規フィールドを追加してCRMアプリケーションのオブジェクト・モデルを拡張することができます。標準、カスタム両オブジェクトに追加できるフィールド・タイプの1つにテキスト・フィールドがあります。テキスト・フィールドはランタイム・アプリケーションのユーザーが文字、数字、記号の組合せを入力できるフィールドです。

テキスト・フィールドのプロパティ

テキスト・フィールドを作成するときは、表示ラベル、フィールド名など、ほかのフィールド・タイプと共通のプロパティの値を指定します。また、テキスト・フィールドに特有のプロパティの値も指定します。

次のプロパティは複数のフィールド・タイプに共通のものです。

次のプロパティはテキスト・フィールドなど一部のフィールド・タイプ固有のものです。

その他のテキスト・フィールドの仕様

このフィールド・タイプには、ほかに次のような仕様が定められています。

• データ型はVARCHAR2（254文字）。

• フィールドは1つのオブジェクトにつき625まで。625フィールドのうち350フィールドがテキスト、チェック・ボックス、固定選択リスト、動的選択リスト用。

長いテキスト・フィールド: 説明

Oracle Fusion CRM アプリケーション・コンポーザでは、標準、カスタム・オブジェクトに新規フィールドを追加してCRMアプリケーションのオブジェクト・モデルを拡張することができます。標準、カスタム両オブジェクトに追加できるフィールド・タイプの1つに長いテキスト・フィールドがあります。長いテキスト・フィールドはランタイム・アプリケーションのユーザーが文字、数字、記号の組合せを入力できるフィールドです。このフィールド・タイプは32,000文字まで入力可能です。

長いテキスト・フィールドのプロパティ

長いテキスト・フィールドを作成するときは、表示ラベル、フィールド名など、ほかのフィールド・タイプと共通のプロパティの値を指定します。また、長いテキスト・フィールドに特有のプロパティの値も指定します。

次のプロパティは複数のフィールド・タイプに共通のものです。

次のプロパティは長いテキスト・フィールドなど一部のフィールド・タイプに特有のものです。

その他の長いテキスト・フィールドの仕様

このフィールド・タイプには、ほかに次のような仕様が定められています。

• データ型はCLOB。

• フィールドは1つのオブジェクトにつき625まで。625フィールドのうち25フィールドが長いテキスト・フィールド用。

• 長いテキスト・フィールドは、カスタム・サブジェクト領域ではサポートされません。つまり、カスタム・レポートには長いテキスト・フィールドを追加することができません。

数値フィールド: 説明

Oracle Fusion CRM アプリケーション・コンポーザでは、標準、カスタム・オブジェクトに新規フィールドを追加してCRMアプリケーションのオブジェクト・モデルを拡張することができます。標準、カスタム両オブジェクトに追加できるフィールド・タイプの1つに数値フィールドがあります。数値フィールドはランタイム・アプリケーションのユーザーが数値を入力できるフィールドです。

数値フィールドのプロパティ

数値フィールドを作成するときは、表示ラベル、フィールド名など、ほかのフィールド・タイプと共通のプロパティの値を指定します。また、数値フィールドに特有のプロパティの値も指定します。

次のプロパティは複数のフィールド・タイプに共通のものです。

次のプロパティは数値フィールドなど一部のフィールド・タイプ固有のものです。

その他の数値フィールドの仕様

このフィールド・タイプには、ほかに次のような仕様が定められています。

• データ型はNUMBER。

• フィールドは1つのオブジェクトにつき625まで。625フィールドのうち200フィールドが数値、通貨、比率用。

• 先行ゼロはとる。

日付フィールド: 説明

Oracle Fusion CRM アプリケーション・コンポーザでは、標準、カスタム・オブジェクトに新規フィールドを追加してCRMアプリケーションのオブジェクト・モデルを拡張することができます。標準、カスタム両オブジェクトに追加できるフィールド・タイプの1つに日付フィールドがあります。日付フィールドはランタイム・アプリケーションのユーザーが日付を入力するかカレンダーから選択することができるフィールドです。このフィールドのタイプには、時間成分がありません。

日付フィールドのプロパティ

日付フィールドを作成するときは、表示ラベル、フィールド名など、ほかのフィールド・タイプと共通のプロパティの値を指定します。

次のプロパティは複数のフィールド・タイプに共通のものです。

その他の日付フィールドの仕様

このフィールド・タイプには、ほかに次のような仕様が定められています。

• データ型はTIMESTAMP。

• フィールドは1つのオブジェクトにつき625まで。625フィールドのうち50フィールドが日付、日時フィールド用。

• カスタム・レポート用のカスタム・サブジェクト領域を作成するときは、このタイプのフィールドを日付レべリング用に選択することができます。

日時フィールド: 説明

Oracle Fusion CRM アプリケーション・コンポーザでは、標準、カスタム・オブジェクトに新規フィールドを追加してCRMアプリケーションのオブジェクト・モデルを拡張することができます。標準、カスタム両オブジェクトに追加できるフィールド・タイプの1つに日時フィールドがあります。 日時フィールドはランタイム・アプリケーションのユーザーが日付を入力するかカレンダーから選択し、時刻を入力することができるフィールドです。日付と時刻、またはそのどちらか一方だけを表示することができます。

日時フィールドのプロパティ

日時フィールドを作成するときは、表示ラベル、フィールド名など、ほかのフィールド・タイプと共通のプロパティの値を指定します。また、日時フィールドに特有のプロパティの値も指定します。

次のプロパティは複数のフィールド・タイプに共通のものです。

次のプロパティは日時フィールドなど一部のフィールド・タイプ固有のものです。

その他の日時フィールドの仕様

このフィールド・タイプには、ほかに次のような仕様が定められています。

• データ型はTIMESTAMP。

• フィールドは1つのオブジェクトにつき625まで。625フィールドのうち50フィールドが日付、日時フィールド用。

• カスタム・レポート用のカスタム・サブジェクト領域を作成するときは、このタイプのフィールドを日付レべリング用に選択することができます。

• このフィールド・タイプは時間帯変換が可能です。

チェック・ボックス・フィールド: 説明

Oracle Fusion CRM アプリケーション・コンポーザでは、標準、カスタム・オブジェクトに新規フィールドを追加してCRMアプリケーションのオブジェクト・モデルを拡張することができます。標準、カスタム両オブジェクトに追加できるフィールド・タイプの1つにチェック・ボックス・フィールドがあります。チェック・ボックス・フィールドはランタイム・アプリケーションのユーザーがレコードのtrue、falseの属性を示すチェック・ボックスを選択することができるフィールドです。

チェック・ボックス・フィールドのプロパティ

チェック・ボックス・フィールドを作成するときは、表示ラベル、フィールド名など、ほかのフィールド・タイプと共通のプロパティの値を指定します。

次のプロパティは複数のフィールド・タイプに共通のものです。

その他のチェック・ボックス・フィールドの仕様

このフィールド・タイプには、ほかに次のような仕様が定められています。

• データ型はVARCHAR2。

• フィールドは1つのオブジェクトにつき625まで。625フィールドのうち350フィールドがテキスト、チェック・ボックス、固定選択リスト、動的選択リスト用。

• チェック・ボックス・フィールドは、カスタム・サブジェクト領域ではサポートされません。つまり、カスタム・レポートにはチェック・ボックス・フィールドを追加することはできません。

比率フィールド: 説明

Oracle Fusion CRM アプリケーション・コンポーザでは、標準、カスタム・オブジェクトに新規フィールドを追加してCRMアプリケーションのオブジェクト・モデルを拡張することができます。標準、カスタム両オブジェクトに追加できるフィールド・タイプの1つに比率フィールドがあります。比率フィールドはランタイム・アプリケーションのユーザーが比率を入力できるフィールドです。入力した数値にはアプリケーション・コンポーザが自動的に比率の記号を付加します。

比率フィールドのプロパティ

比率フィールドを作成するときは、表示ラベル、フィールド名など、ほかのフィールド・タイプと共通のプロパティの値を指定します。また、比率フィールドに特有のプロパティの値も指定します。

次のプロパティは複数の比率タイプに共通のものです。

次のプロパティは比率フィールドなど一部のフィールド・タイプ固有のものです。

その他の比率フィールドの仕様

このフィールド・タイプには、ほかに次のような仕様が定められています。

• データ型はNUMBER。

• フィールドは1つのオブジェクトにつき625まで。625フィールドのうち200フィールドが数値、通貨、比率用。

• 比率の記号はアプリケーション・コンポーザが自動的に付加します。

通貨フィールド: 説明

Oracle Fusion CRM アプリケーション・コンポーザでは、標準、カスタム・オブジェクトに新規フィールドを追加してCRMアプリケーションのオブジェクト・モデルを拡張することができます。標準、カスタム両オブジェクトに追加できるフィールド・タイプの1つに通貨フィールドがあります。通貨フィールドはランタイム・アプリケーションのユーザーが通貨金額を入力できるフィールドです。

通貨フィールドのプロパティ

通貨フィールドを作成するときは、表示ラベル、フィールド名など、ほかのフィールド・タイプと共通のプロパティの値を指定します。また、通貨フィールドに特有のプロパティの値も指定します。

次のプロパティは複数のフィールド・タイプに共通のものです。

次のプロパティは通貨フィールドなど一部のフィールド・タイプ固有のものです。

その他の通貨フィールドの仕様

このフィールド・タイプには、ほかに次のような仕様が定められています。

• データ型はNUMBER。

• フィールドは1つのオブジェクトにつき625まで。625フィールドのうち200フィールドが数値、通貨、比率用。

  注意

  通貨フィールドはそれぞれ2つの数値タイプの列を使用し、一方の列に金額を保存し、もう一方の列に入力された金額の通貨コードから企業通貨コードへの通貨換算レートの計算結果を保存します。

• CRMオブジェクトには、通貨換算を助けるために次のフィールドが含まれます。これらのフィールドは、オブジェクトのCRMアプリケーションが通貨フィールドの作成を許可する場合に、CRMオブジェクトに自動的に追加され、CRMアプリケーションの企業通貨設定から導出されます。

  • 通貨コード

    あるオブジェクトについてすべての通貨フィールドに適用される通貨コードです。

  • 企業通貨コード

  • 通貨換算レート・タイプ

  通貨フィールドの通貨換算は、次のように行われます。

  • ランタイム時に、ユーザーが通貨金額を入力します。

  • ユーザーがそのレコードを保存すると、次のような処理が行われます。

    • 通貨金額が当該オブジェクトについて指定された通貨コードを使用して保存されます。

    • CRMアプリケーションが、そのオブジェクトの通貨コード、企業通貨コード、通貨換算レート・タイプ、それに（指定があれば）通貨フィールドの指定された換算日を使用して通貨換算レートを計算します。

      入力された金額以外には、入力された金額の通貨コードから企業通貨コードへの換算レートの計算結果だけが保存されます。

    • 後でこの通貨コードまたは換算日を変更すると、CRMアプリケーションがそのレコードの通貨換算レートを再計算します。

固定選択リスト: 説明

Oracle Fusion CRM アプリケーション・コンポーザでは、標準、カスタム・オブジェクトに新規フィールドを追加してCRMアプリケーションのオブジェクト・モデルを拡張することができます。 標準、カスタム両オブジェクトに追加できるフィールド・タイプの1つに固定選択リストがあります。 固定選択リストはFND参照タイプから移入される静的値のリストを含むフィールドです。 ランタイム時に、ユーザーはフィールドの定義に応じて、このフィールドから1つまたは複数の値を選択することができます。

固定選択リストのプロパティ

固定選択リストを作成するときは、表示ラベル、フィールド名など、ほかのフィールド・タイプと共通のプロパティの値を指定します。 また、固定選択リストに特有のプロパティの値も指定します。

次のプロパティは複数のフィールド・タイプに共通のものです。

次のプロパティは固定選択リストなど一部のフィールド・タイプ固有のものです。

値リスト・リージョンの使用

固定選択リストの値はFND参照タイプから移入されます。この選択リストに値を表示させたい参照タイプを選択します。参照タイプの選択はフィールド作成時にしかできません。

あるいは、新しい参照タイプを作成し、それに新しい値を追加します。参照タイプを入力し、「編集」アイコンを選択して既存の値を修正することもできます。

選択に使用可能なFND参照タイプのセットは、この固定選択リストのオブジェクトに（製品コードを介して）関連付けられた参照タイプと、CRM実装用に作成されたすべてのカスタム参照タイプに制約されます。

ランタイム時にこの固定選択リストに表示される実際の値は、この固定選択リストを親固定選択リストに関連付けることによって制約することができます。親固定選択リストで選択された値は、この固定選択リストに表示される値を導出します。たとえば、ユーザーがトラブル・チケットを作成できる「企業ページ」上でトラブル・チケット・タイプ指定用と、トラブル・チケット領域指定用の2つの選択リストが見えるようにしたいとします。ユーザーが「タイプ」選択リストから「ハードウェア」を選択した場合、「エリア」選択リストはトラブル・チケットをログすることができるハードウェア・オプションのみのリストを含んでいるはずです。

このため、親フィールド値の選択肢ごとの制約リストチェック・ボックスを選択し、親フィールドを選択した上で、親参照タイプとこのフィールドの参照タイプの間で値をマップします。

上記の操作は次の手順で行います。

1. 「タイプ」固定選択リストを定義します。

2. 「エリア」固定選択リストを定義します。

3. 親フィールド値の選択肢ごとの制約リストチェック・ボックスを選択し、親フィールド「タイプ」を選択します。

4. 最後に、「タイプ」と「エリア」参照タイプの間で値をマップします。

   たとえば、「エリア」参照タイプの値セットの中の、デスクトップ、ラップトップといった関連ハードトップの値をすべて「タイプ」参照タイプの「ハードウェア」の値にマップします。

その他の固定選択リストの仕様

このフィールド・タイプには、ほかに次のような仕様が定められています。

• データ型はVARCHAR2（1500）。

動的選択リスト: 説明

Oracle Fusion CRM アプリケーション・コンポーザでは、標準、カスタム・オブジェクトに新規フィールドを追加してCRMアプリケーションのオブジェクト・モデルを拡張することができます。標準、カスタム両オブジェクトに追加できるフィールド・タイプの1つに動的選択リストがあります。 動的選択リストは他のオブジェクトの実データから移入される値リストを含むフィールドです。たとえば、「企業ページ」に、ユーザーに自分たちがトラブル・チケットをログしているアカウントを指定させる動的選択リストを表示させたい場合、「アカウント名」選択リストのフィールドをトラブル・チケット・オブジェクトに追加することになりますが、値リストはアカウント・オブジェクトから実際の名前で移入されます。

動的選択リストを作成するときは次の点を確認してください。

• 指定しなければならないフィールド共通のプロパティのセットと動的選択リスト特定のプロパティ

• リスト・データ・ソース、追加リスト表示値、追加リスト検索フィールドリージョンで使用可能なオプション

• 動的選択リストの作成によって暗黙的に作成される関連

動的選択リストのプロパティ

動的選択リストを作成するときは、表示ラベル、フィールド名など、ほかのフィールド・タイプと共通のプロパティの値を指定します。また、動的選択リストに特有のプロパティの値も指定します。

次のプロパティは複数のフィールド・タイプに共通のものです。

次のプロパティは動的選択リストなど一部のフィールド・タイプ固有のものです。

リスト・データ・ソース、追加リスト表示値、追加リスト検索フィールドリージョンの使用

動的選択リストを定義するときは、次のリージョンを利用してランタイム時に値リストに表示されるデータを決定します。

• リスト・データ・ソースリージョン

  
  
  

  • 関連オブジェクト

    動的選択リストの値は他のオブジェクトのデータから移入されます。まず関連オブジェクトを選択し、次にリスト選択表示値選択リストを使用して、自身のオブジェクトのフィールドに表示させたい関連オブジェクトのフィールドを選択します。関連オブジェクトの選択はフィールド作成時にしかできません。

    注意

    選択に使用可能なオブジェクトのセットは、トップ・レベル・オブジェクトのみに制約されます。子オブジェクトを関連オブジェクトとして選択することはできません。

    この例では、関連オブジェクトを「アカウント」とします。

    ヒント

    作成した動的選択リストの関連オブジェクトは「フィールド」ページで容易に確認することができます。フィールドページには、選択されているオブジェクトの標準、カスタム両フィールドの要約が表示されます。動的選択リストを作成したら、関連オブジェクトが「タイプ」列に表示されます。この例では、フィールド・タイプは選択リスト（動的） <アカウント<となります。

  • リスト選択表示値

    リスト選択表示値選択リストは、ランタイム時に動的選択リスト内に第1列として表示される関連オブジェクトのフィールドです。これは、ユーザーが適切な選択を行うために利用する関連オブジェクトのプライマリ・フィールドです。この例では、このフィールドは「名前」のようなものになります。

  • データ・フィルタ

    データ・フィルタを利用すると、ランタイム時に動的選択リスト内に表示されるデータのセットをさらに精緻化することができます。

    この例では、特定のリージョン以外のアカウントをフィルタで排除します。

• 追加リスト表示値リージョン

  
  
  

  動的選択リストに表示する追加のフィールドを選択すると、選択リストの外観および操作感をさらに向上させることができます。

  追加リスト表示値シャトルを利用してランタイム時に表示される動的選択リストに関連オブジェクトのフィールドを追加します。 これらの追加フィールドは、ユーザーの選択リストからの選択をしやすくします。シャトルには、すでに追加リスト表示値選択リストで選択しているフィールドは含まれません。

  選択できる追加フィールドの数に制限はありません。

• 追加リスト検索フィールドリージョン

  
  
  

  関連オブジェクトのどのフィールドを動的選択リストの「検索と選択」ダイアログの検索基準に追加することができるかを指定することができます。

  追加リスト検索値シャトルを使用して動的選択リストの「検索と選択」ダイアログに関連オブジェクトのフィールドを追加し、ランタイム時に検索...リンクを使用してアクセスできるようにします。 シャトルには、すでに追加リスト表示値選択リストで選択しているフィールドは含まれません。

  選択できる追加フィールドの数に制限はありません。

暗黙的関連の作成

あるオブジェクトについて、関連オブジェクトに基づく動的選択リストを作成するときは、暗黙的に、現在のオブジェクトを「多」、関連オブジェクトを「1」とする1対多の外部キー関連を作成することになります。この暗黙的な関連の作成により、「1」のオブジェクトの詳細ページに「多」のオブジェクトの関連オブジェクト・サブタブを追加することができます。これらの暗黙的に作成される選択リストの関連は「関連」ページで見ることができます。

トラブル・チケットに関する選択に使用可能なアカウントのリストを作成する先の例では、1つのアカウントを複数のトラブル・チケットに結びつけることができます。作成される関連はアカウントとトラブル・チケットの間の1対多の関連であり、これにより、ユーザーがトラブル・チケットの表にアカウントの識別子を保存することが可能になります。この関連では、アカウント・オブジェクトがソース・オブジェクト、トラブル・チケット・オブジェクトがターゲット・オブジェクトになります。そこで、ランタイム時にソース・オブジェクトがシステムから削除されることがあれば、この動的選択リストは内部に値を持たないことになります。

後で、そのアカウントの詳細ページに、1つのアカウントについて、それに関連するトラブル・チケットをすべて表示する関連オブジェクト・サブタブを表示させたいときは、この関連オブジェクト・サブタブは、動的選択リストを作成したときにすでに関連が作成されているので、作成することができます。

その他の動的選択リストの仕様

このフィールド・タイプには、ほかに次のような仕様が定められています。

• データ型はVARCHAR2（1500）。

算式フィールド: 説明

Oracle Fusion CRM アプリケーション・コンポーザでは、標準、カスタム・オブジェクトに新規フィールドを追加してCRMアプリケーションのオブジェクト・モデルを拡張することができます。標準、カスタム両オブジェクトに追加できるフィールド・タイプの1つに算式フィールドがあります。算式フィールドは、ランタイムCRMアプリケーションにおいて、算式フィールドの定義に含まれるGroovyベースの式を使用して計算されるフィールドです。たとえば、従業員の年間のボーナス金額を計算する式などを書込みます。

算式フィールドのプロパティ

算式フィールドを作成するときは、表示ラベル、フィールド名など、ほかのフィールド・タイプと共通のプロパティの値を指定します。また、算式フィールドに特有のプロパティの値も指定します。

次のプロパティは複数のフィールド・タイプに共通のものです。

次のプロパティは算式フィールドなど一部のフィールド・タイプ固有のものです。

式エディタと依存選択リストの使用

依存選択リストを使用して、他のフィールドの値が変更されたときに（書込んだ式を使用して）フィールドを自動的に再計算するかどうかを指定します。

ランタイム時にフィールドの値を計算する式を書込む式エディタを使用します。

たとえば、従業員の年間ボーナス金額の値を計算している式は、従業員の給与が変化したときに、その金額を自動的に再計算するように設定することができます。そうすることで、ボーナスのフィールドは、給与が変化すると、ユーザーが従業員のレコードをリフレッシュしなくても、すぐに新しいボーナス金額を反映するようになります。

また、商談用の正しい顧客電話番号を決定している式は、商談の顧客アカウントが変化したときに、自動的に電話番号をリセットするように設定することができます。そうすることで、電話番号のフィールドは、顧客アカウントが変化すると、ユーザーが商談レコードをリフレッシュしなくても、すぐに新しい電話番号を反映するようになります。

その他の算式フィールドの仕様

このフィールド・タイプには、ほかに次のような仕様が定められています。

• データ型は「算式タイプ」プロパティで設定します。

• 算式フィールド・タイプは、カスタム・サブジェクト領域ではサポートされません。つまり、カスタム・レポートには算式フィールドを追加することはできません。

• 算式フィールドでは、検索ができません。

ページの定義: 説明

CRMアプリケーションのオブジェクト・モデルを拡張したら、次にその新しいオブジェクトとフィールドを「企業ページ」に表示させます。CRMにおける「企業ページ」のカスタマイズと作成は、オブジェクトの表示に使用可能なページを標準ページ・タイプだけに限定し、単純化されています。トップ・レベルのCRMオブジェクトには、それぞれ概要ページ、作成ページ、詳細ページがあり、それらを総称して作業領域と呼んでいます。新規フィールド作成時には、Oracle Fusion CRMアプリケーション・コンポーザが作業領域構成ページを表示し、そこでそのフィールドを表示用に追加することができます。また、作業領域ウィザードでカスタム・オブジェクトとそのフィールド用に新しい作業領域を作成することもできます。この標準ページ・タイプと構成ページとウィザードを利用したページ作成プロセスの組合せにより、オブジェクト・モデルの拡張を迅速かつ容易にユーザーに表示することができるようになっています。

CRMアプリケーションのページのカスタマイズ、新規作成を行うときは、事前にこのアプリケーション・コンポーザにおける「企業ページ」作成プロセスについて次の点を確認してください。

• ページ概要ページの使用

• ページ・タイプの違い

• ページの定義

• 作業領域の作成

• ページのオブジェクトの保護

• Oracleコンポーザによるページのカスタマイズ

ページ概要ページの使用

ページ概要ページは、1つのオブジェクトに関する標準的な「企業ページ」のセットの概要を提示します。

ページ概要ページの開き方:

1. 主要「概要」ページでアプリケーションを選択します。

2. オブジェクト・ツリーで標準またはカスタム・オブジェクトを選択します。

3. 「ページ」ノードを選択します。

   
   
   

   注意

   構成可能なページを持つのはトップ・レベル・オブジェクトだけです。子オブジェクトは親オブジェクトのコンテキスト外には存在せず、独自の作業領域も持ちません。

ページ概要ページでできること:

• すでにオブジェクトがユーザーに表示されているページの確認とフィールドの追加または削除によるそのカスタマイズ

• まだページのセットが作成されていなかったオブジェクトに関する作業領域と総称される新しいページのセットの作成

• オブジェクトの詳細ページにおける1つまたは複数のサブタブの作成と表示

• オブジェクト・モデルの拡張の異なるインタフェースへの複製: Oracle Fusion Mobile Sales搭載モバイル・デバイスへのレンダリング

  モバイル・ページの構成プロセスでも、作業領域の作成プロセスと同様に、ウィザードを使用してモバイル・ページに追加するカスタム・フィールドや関連オブジェクトを選択することができます。モバイル・ページ・ウィザードを開始するには、「モバイル・ページ」タブを選択します。

ページ・タイプの違い

標準ページ・タイプのセット（概要ページ、作成ページ、詳細ページ）には、トップ・レベルのCRMオブジェクトをすべて表示することができます。

• 概要ページ

  概要ページは特定のオブジェクトに関するレコードのリストを提示し、ユーザーがデータを見て管理するCRMアプリケーションの出発点になります。ユーザーはランタイム時に「ナビゲータ・メニュー」からオブジェクトの概要ページを開きます。

  注意

  概要ページを持つのはトップ・レベル・オブジェクトだけです。他のオブジェクトの子として作成されたオブジェクトは、概要ページを持ちません。

  概要ページには、2つのリージョンがあります。

  • 要約表

    要約表はオブジェクト・レコードのリストを表示します。ユーザーは、セキュリティの設定に応じて、オブジェクトの作成、編集、削除、または既存レコードへのドリルダウンができます。

    ヒント

    オプションで保存済検索を定義し、ランタイム時にユーザーがそれを選択すると、要約表に表示されるレコードを絞れるようにすることもできます。

  • ローカル検索リージョン

    ローカル検索リージョンは要約表の上に表示されます。ユーザーは検索基準を入力し、要約表に表示されるレコードを絞ることができます。

• 作成ページ

  作成ページは、ユーザーがオブジェクトに関する新規レコードを作成できる企業ページです。ユーザーは、セキュリティの設定に応じて、「新規」アイコンのクリック、または要約表のツールバーの「処理」メニューの「新規」の選択によって、作成ページにアクセスします。

• 詳細ページ

  「詳細」ページは、ユーザーがオブジェクトに関する詳細を見ることができる「企業ページ」です。 ユーザーは、セキュリティの設定に応じて、「編集」アイコンのクリック、または要約表のツールバーの「処理」メニューの「編集」の選択によって、「詳細」ページにアクセスします。また、ユーザーは要約表のオブジェクト・レコード名をクリックしても「詳細」ページにアクセスすることができます。

  「詳細」ページはデフォルト要約と詳細要約の両方を含むことができます。デフォルト要約はプライマリ・オブジェクト・フィールドを含み、常にユーザーに表示されます。詳細要約はオブジェクトの追加フィールドを含みます。デフォルト要約と詳細要約の両方に同じフィールドを追加することはできません。

  「詳細」ページはオブジェクト・レコードに関連する情報も含むことができ、これはサブタブに表示されます。たとえば、商談の「詳細」ページには、顧客担当者や過去の注文のリストを表示するサブタブを含めることができます。

ページの定義

トップ・レベルCRMオブジェクトはすべて標準ページ・タイプに表示することができるので、どのページ・タイプにもフィールドの表示、非表示を切り換える独自の構成ページがあります。新しいオブジェクトとフィールドを作成したら、ページ概要ページにナビゲートしてください。ページ概要ページには、オブジェクトの既存の作業領域に関する構成ページへのハイパーリンクがあります。たとえば作成ページへの新規フィールドの追加など、オブジェクトの作業領域のページのカスタマイズを行うときは、この構成ページを利用します。

ページ概要ページから開ける構成ページの使用:

• 「ナビゲータ・メニュー」

  カスタム・オブジェクトの場合のみ、ランタイム時に「ナビゲータ・メニュー」に表示されるオブジェクト・ラベルを指定します。指定するラベルはユーザーがこの作業領域へナビゲートするときに選択するものになります。

  
  
  

• 概要ページ

  概要ページには2つのリージョンがあり、それぞれ個別に構成ページを持ちます。

  • 要約表

    
    
    

    1. 要約表に列として表示したいフィールドを選択します。

    2. ユーザーに別のユーザーに要約表のレコードにアクセスすることを認める権限を持たせたい場合は、「アクセス権限の許可」チェック・ボックスを選択します。

    3. 事前に要約表を作成していた場合は、それにカスタム・ボタンを追加します。

  • ローカル検索

    
    
    

    1. カスタム・オブジェクトの場合のみ、ローカル検索リージョンに検索基準フィールドとして表示したいフィールドを選択します。

       ローカル検索は2列のリージョンとしてフォーマットされていますが、選択に使用可能なフィールドのリストは1列で表示されます。まず1列目に表示されるフィールドを最初のフィールドとして選択し、次に2列目に表示されるフィールドを2番目のフィールドとして選択し、3番目のフィールドはまた1列目で選択するというようになります。

       注意

       フィールド作成時には、カスタム・オブジェクトについて検索基準として表示するフィールドに索引付けすることを検討してください。

• 作成ページ

  
  
  

  1. オブジェクトの作成ページに表示したいフィールドを選択します。

     選択するフィールドには、オブジェクトの必須フィールドが含まれている必要があります。

     作成ページは3列のページとしてフォーマットされていますが、選択に使用可能なフィールドのリストは1列で表示されます。まず1列目に表示されるフィールドを最初のフィールドとして選択し、次に2列目に表示されるフィールドを2番目のフィールドとして選択し、3列目に表示されるフィールドを3番目のフィールドとして選択し、4番目のフィールドはまた1列目で選択するというようになります。

• 詳細ページ

  
  
  

  1. デフォルト要約と詳細要約の両リージョンなど、オブジェクトの「詳細」ページに表示したいフィールドを選択します。

     ヒント

     詳細要約はユーザーがこのページまでナビゲートするときに折畳まれている可能性があるので、デフォルト要約にプライマリ・オブジェクト・フィールドを含めます。

     「詳細」ページは3列のページとしてフォーマットされていますが、選択に使用可能なフィールドのリストは1列で表示されます。まず1列目に表示されるフィールドを最初のフィールドとして選択し、次に2列目に表示されるフィールドを2番目のフィールドとして選択し、3列目に表示されるフィールドを3番目のフィールドとして選択し、4番目のフィールドはまた1列目で選択するというようになります。

  2. 事前に「詳細」ページを作成していた場合は、それにカスタム・ボタンを追加します。

  3. ページ概要ページでは、詳細ページに表示するサブタブも構成することができます。サブタブには、オブジェクト・レコードに関連する情報を含めます。たとえば、商談の「詳細」ページには、顧客担当者や過去の注文のリストを表示するサブタブを含めることができます。「詳細」ページへのサブタブの追加については、関連トピックで説明します。

     オブジェクトが関連ページをサブタブではなくツリーを利用して表示している場合は、オブジェクトのツリーに追加するツリー・ノードを構成することができます。サブタブと同様、ツリー・ノードのデータも、他のオブジェクト、あるいは現在のOracle Fusion CRMアプリケーション以外のまったく別のソースから導出することができます。オブジェクトのツリーへのツリー・ノードの追加については、関連トピックで説明します。

作業領域の作成

トップ・レベル・カスタム・オブジェクトは、ただ作成しただけなら、まだそれをユーザーに表示するランタイムCRMアプリケーションにページを持ちません。 このようなカスタム・オブジェクトを作成したら、そのオブジェクトに属するレコードをユーザーに表示するページのセットを作成しなければなりません。

アプリケーション・コンポーザでは、ウィザードを利用してこれらのページ（作業領域）を作成するプロセスを段階的に案内します。作業領域の作成については、関連トピックで説明します。

子オブジェクトには、作業領域を作成しないでください。

ページのオブジェクトの保護

カスタム・オブジェクトとフィールドを作成したら、次にそれをユーザーが見る「企業ページ」に表示させます。そこで必要になるのが、ランタイム時にオブジェクトのデータにアクセスする権限の管理です。デフォルトでは、オブジェクトとそのレコードはアプリケーションで指定されたデフォルト職務ロールしか見ることも編集することもできません。追加のアクセス権は、アプリケーション・コンポーザのセキュリティ・ポリシー構成ページで個々のオブジェクト、ロールについて手動で設定します。

子オブジェクトなどのカスタム・オブジェクトへのアクセスの制限に使用可能なセキュリティ・オプションについては、関連トピックで説明します。

Oracleコンポーザによるページのカスタマイズ

新しいページのセットを作成し、CRMアプリケーションに付属の既成のページを編集したら、Oracleコンポーザを使用してもう一度これらのページを編集することはできません。

作業領域の作成: 説明

カスタム・オブジェクトは、ただ作成しただけでは、まだそれをユーザーに表示するランタイムCRMアプリケーションにページを持ちません。トップ・レベル・カスタム・オブジェクトを作成したら、それをユーザーに表示する「企業ページ」のセット（作業領域）を作成しなければなりません。CRMオブジェクトはすべて、概要ページ、作成ページ、詳細ページで構成される作業領域に表示することができます。Oracle Fusion CRMアプリケーション・コンポーザでは、ウィザードを利用してこのオブジェクト作業領域作成のプロセスを段階的に案内します。作業領域を作成したら、あとはいつでもオブジェクトのページ概要ページにナビゲートし、作業領域構成ページを使用してその「企業ページ」のカスタマイズを続けることができます。 子オブジェクトには、作業領域を作成しないでください。モバイル・デバイス用の表示ページを作成、修正するときは、同じオブジェクトのページ概要ページから起動できる専用の「モバイル・ページ」ウィザードを使用します。

カスタム・オブジェクトに新規作業領域を作成するときは、事前にアプリケーション・コンポーザにおける作業領域作成プロセスについて次の点を確認してください。

• 作業領域ウィザードの使用

• 「ナビゲータ・メニュー」の構成

• ローカル検索リージョンの構成

• 概要ページと作成ページの構成

• 詳細ページの構成

作業領域ウィザードの使用

ページ概要ページで既存の作業領域のページを構成するときと同じナビゲーション・パスを使用してウィザードを起動します。ただし、まだオブジェクトについて作業領域が作成されていないときは、作業領域構成ページへのハイパーリンクは表示されません。ページ概要ページには、作業領域ウィザードを起動するハイパーリンクだけが表示されます。

作業領域ウィザードの起動:

1. 主要「概要」ページでアプリケーションを選択します。

2. オブジェクト・ツリーで標準またはカスタム・オブジェクトを選択します。

3. 「ページ」ノードを選択します。

   注意

   構成可能なページを持つのはトップ・レベル・オブジェクトだけです。子オブジェクトは親オブジェクトのコンテキスト外には存在せず、独自の作業領域も持ちません。

4. 作業領域ウィザードを起動するハイパーリンクを選択します。

「ナビゲータ・メニュー」の構成

カスタム・オブジェクトの作業領域を作成するときは、ランタイム時に「ナビゲータ・メニュー」に表示されるオブジェクト・ラベルを指定しなければなりません。指定するラベルはユーザーがこの作業領域へナビゲートするときに選択するものになります。

このページでは、次のようなこともできます。

• オブジェクト・ラベルを表示するメニュー・カテゴリの選択

• 選択したメニュー・カテゴリ内の「ナビゲータ・メニュー」項目の位置の調整

  たとえば、新たに作成したオブジェクト・ラベルを移動させ、リストの先頭に表示させます。

カスタム・オブジェクトの作業領域を作成したら、再認証しなくても「ナビゲータ・メニュー」に作業領域ラベルが自動的に表示されます。

ローカル検索リージョンの構成

ローカル検索リージョンに検索基準として表示したいフィールドを選択します。ローカル検索リージョンはオブジェクトの概要ページの要約表の上に表示されます。このリージョンへのフィールドの追加はオプションです。

1. ローカル検索リージョンに検索基準フィールドとして表示したいフィールドを選択します。

   ローカル検索リージョンは2列のリージョンとしててフォーマットされていますが、選択に使用可能なフィールドのリストは1列で表示されます。まず1列目に表示されるフィールドを最初のフィールドとして選択し、次に2列目に表示されるフィールドを2番目のフィールドとして選択し、3番目のフィールドはまた1列目で選択するというようになります。

概要ページと作成ページの構成

作業領域の概要ページとオブジェクトの作成ページに表示したいフィールドを選択します。

1. オブジェクトの概要ページの要約表に列として表示したいフィールドを選択します。

2. 要約表のドリルダウン列を選択します。

   ドリルダウン列は、ユーザーがクリックしてオブジェクト・レコードの詳細ページまでドリルダウンすることができる要約表の列です。要約表のドリルダウン列は、作業領域作成後には変更することができません。

3. ランタイム時にユーザーに別のユーザーに要約表のレコードにアクセスすることを認める権限を持たせたい場合は、「アクセス権限の許可」チェック・ボックスを選択します。

4. 事前に要約表を作成していた場合は、それにカスタム・ボタンを追加します。

5. オブジェクトの作成ページに表示したいフィールドを選択します。

   選択するフィールドには、オブジェクトの必須フィールドが含まれている必要があります。

   作成ページは3列のページとしてフォーマットされていますが、選択に使用可能なフィールドのリストは1列で表示されます。まず1列目に表示されるフィールドを最初のフィールドとして選択し、次に2列目に表示されるフィールドを2番目のフィールドとして選択し、3列目に表示されるフィールドを3番目のフィールドとして選択し、4番目のフィールドはまた1列目で選択するというようになります。

詳細ページの構成

オブジェクトの詳細ページに表示したいフィールドを選択します。

1. デフォルト要約と詳細要約の両リージョンなど、オブジェクトの詳細ページに表示したいフィールドを選択します。

   ヒント

   詳細要約はユーザーがこのページまでナビゲートするときに折畳まれている可能性があるので、デフォルト要約にプライマリ・オブジェクト・フィールドを含めます。

   詳細ページは3列のページとしてフォーマットされていますが、選択に使用可能なフィールドのリストは1列で表示されます。まず1列目に表示されるフィールドを最初のフィールドとして選択し、次に2列目に表示されるフィールドを2番目のフィールドとして選択し、3列目に表示されるフィールドを3番目のフィールドとして選択し、4番目のフィールドはまた1列目で選択するというようになります。

2. 事前に詳細ページを作成していた場合は、それにカスタム・ボタンを追加します。

3. 折畳まれる可能性のある詳細要約では、「添付の許可」チェック・ボックスを選択し、ランタイム詳細ページで添付機能を有効にします。

サブタブ: 説明

トップ・レベルCRMオブジェクトには、作業領域の一部として必ず詳細ページがあります。詳細ページを構成するときは、オプションで、現在のオブジェクトに関連するが、他のオブジェクト、またはまったく現在のOracle Fusion CRMアプリケーション以外の別のソースから導出された詳細を表示することができます。これは詳細ページにサブタブを追加し、サブタブ・データのソースを指定することによって行います。Oracle Fusion CRMアプリケーション・コンポーザのオブジェクトのページ概要ページから標準またはカスタム・オブジェクトの詳細ページにサブタブを追加します。

オブジェクトの詳細ページにサブタブを追加するときは、事前にアプリケーション・コンポーザにおけるサブタブ作成プロセスについて次の点を確認してください。

• 詳細ページの使用

• サブタブの追加

• サブタブのタイプ:

  • 子または関連オブジェクト・サブタブ

  • コンテキスト・リンク・サブタブ

  • 共通コンポーネント・サブタブ

  • Webコンテンツ・サブタブ

詳細ページの使用

詳細ページは、ユーザーがオブジェクトに関する詳細を見ることができる企業ページです。ユーザーは、セキュリティの設定に応じて、「編集」アイコンのクリック、または要約表のツールバーの「処理」メニューの「編集」の選択によって、詳細ページにアクセスします。また、ユーザーは要約表のオブジェクト・レコード名をクリックしても詳細ページにアクセスすることができます。

詳細ページはデフォルト要約と詳細要約の両方を含むことができます。デフォルト要約はプライマリ・オブジェクト・フィールドを含み、常にユーザーに表示されます。詳細要約はオブジェクトの追加フィールドを含みます。デフォルト要約と詳細要約の両方に同じフィールドを追加することはできません。

詳細ページはオブジェクト・レコードに関連する情報も含むことができ、これはサブタブに表示されます。たとえば、商談の詳細ページには、顧客担当者や過去の注文のリストを表示するサブタブを含めることができます。

サブタブの追加

オブジェクトのページ概要ページからオブジェクトの詳細ページにサブタブを追加します。詳細ページは事前に存在していなければなりません。初めて作業領域を作成するときにサブタブを追加することはできません。

既存の詳細ページへのサブタブの追加:

1. 主要「概要」ページでアプリケーションを選択します。

2. オブジェクト・ツリーで標準またはカスタム・オブジェクトを選択します。

3. 「ページ」ノードを選択します。

   注意

   構成可能なページを持つのはトップ・レベル・オブジェクトだけです。 子オブジェクトは独自の作業領域を持ちません。

4. ページ概要ページで「詳細ページ」リージョンの「サブタブの作成」アイコンをクリックし、オブジェクトの詳細ページに表示する1つまたは複数のサブタブを作成します。

5. 追加したいサブタブのタイプを選択します。

   
   
   

子または関連オブジェクト・サブタブ

関連は2つのオブジェクトの間の外部キーによる結び付きをさします。アプリケーション・コンポーザを使用すると、同じアプリケーション内の2つのオブジェクトの間に1対多の関連を作成することができます。関連が作成されたら、「1」のオブジェクトの詳細ページに表示されるサブタブに「多」のオブジェクトを表示することができます。たとえば、1つのアカウントに関連付けられるサービス要求が複数存在することがあります。特定のアカウントに関連付けられたサービス要求のリストをそのアカウントの詳細ページのサブタブとして表示するには、まずそのアカウントとサービス要求のオブジェクトの間に1対多の関連を作成しなければなりません。この場合、アカウントがソース・オブジェクト、サービス要求がターゲット・オブジェクトになります。この関連は、サービス要求オブジェクトの表にアカウントの識別子を追加します。

アプリケーション・コンポーザでは、1つの子オブジェクトまたは3種類の関連オブジェクトの詳細ページにサブタブを追加することができます。これにより、次の4種類の1対多の関連を作成することができます。

• 親子関連

  親子関連は、カスタム・オブジェクトがトップ・レベル・オブジェクトの子として作成されたときに暗黙的に作成されます。

  たとえば、アカウントの詳細ページにサブアカウントのサブタブが作成されるようにしたい場合、サブアカウント・オブジェクトをアカウント・オブジェクトの子として作成することができます。この関連では、サブアカウント・オブジェクトの表にアカウントの識別子が追加されます。

• 選択リスト関連

  選択リスト関連は、動的選択リスト・フィールドを作成したときに2つのオブジェクトの間に暗黙的に作成されます。

  たとえば、従業員の詳細ページに部門のサブタブを作成できるようにする場合は、部門オブジェクトについて、従業員を関連オブジェクトとする動的選択リスト人事担当者を作成します。アプリケーション・コンポーザが自動的に基礎関連を作成し、従業員がソース・オブジェクト、部門がターゲット・オブジェクトになります。この関連は、部門オブジェクトの表に従業員の識別子を追加し、従業員の詳細ページに部門サブタブを作成することを可能にします。個々の人事担当者は会社の複数の部門を担当することがあるので、このサブタブは1人の人事担当者が管理することができるすべての部門を表示します。

• 参照関連

  参照関連は、関連の作成ページを使用して2つのトップ・レベル・オブジェクトの間に明示的に作成されます。

  先の例で言うと、部門の企業ページに人事担当者の選択リストを表示する必要がなく、従業員の詳細ページに部門のサブタブを追加したい場合、この場合には、従業員と部門オブジェクトの間に手動で、従業員をソース・オブジェクト、部門をターゲット・オブジェクトとする参照関連を作成します。 これにより、部門サブタブの作成が可能になります。しかし、このような参照関連では、部門の企業ページで使用できる、対応する人事担当者選択リストは自動的に作成されません。また、手動で関連を作成してしまうと、その関連を再利用して選択リストを作成することもできません。つまり、参照関連を作成するときは、事前に選択リストの必要性をよく検討する必要があります。

• 標準関連

  標準関連は、Oracle Fusion CRMアプリケーションによってすでに2つの標準オブジェクトの間に作成されている関連です。

既存の詳細ページへの子または関連オブジェクト・サブタブの追加:

1. ページ概要ページで「サブタブの作成」アイコンをクリックします。

2. 「子または関連オブジェクト」を選択します。

   
   
   

3. 子または関連オブジェクトサブタブ構成ページでの操作:

   1. すべての関連オブジェクトのリストからサブタブに表示する関連オブジェクトを選択し、サブタブの表示ラベルを選択します。

   2. ランタイム時にサブタブに表示される「新規」および「削除」ボタンを非表示にすることができます。

      子オブジェクトのサブタブでは、「編集」ボタンも非表示にすることができます。

   3. 子オブジェクト・サブタブの場合は、ランタイム時にサブタブに権限管理ボタンを表示するかどうかを指定します。

      ランタイム時にユーザーがオブジェクト・レコードを選択してこのボタンをクリックすると、選択したレコードに対して別のユーザーが持つアクセス・レベルを指定することができます。

   4. ランタイム時にサブタブの要約表に表示したいフィールドとリンクを選択します。

      子オブジェクト・レコードまたは関連オブジェクト・レコードをリスト表示するメイン要約表についてフィールドとリンクを構成することができます。

   5. ランタイム時にサブタブに表示させたいボタンを選択します。

      注意

      このリージョンは、事前にこのオブジェクト用のボタンを作成していた場合にのみ表示されます。

   6. ランタイム時にサブタブの詳細フォームに表示させたいフィールドを選択します。

      要約表の下に表示される詳細フォームのフィールドを構成することができます。サブタブのオブジェクトが子オブジェクトなら、ユーザーはランタイム時にこの詳細フォームに子オブジェクト・データを入力することができます。必須フィールドは必ずこのセクションに含めてください。

      サブタブのオブジェクトが関連オブジェクトなら、ユーザーはサブタブ・オブジェクトの既存のレコードをページのマスター・オブジェクトに関連付けることができます。ただし、新しい関連オブジェクトのレコードを作成するときは、ユーザーはそのオブジェクト自体の作成ページでそれを行わなければなりません。

コンテキスト・リンク・サブタブ

コンテキスト・リンク・サブタブは任意のトップ・レベル・オブジェクトからのフィルタ処理されたレコードのリストを表示し、このフィルタは通常、現在のオブジェクトからのランタイム値に基づいています。オブジェクトは現在のオブジェクトに関連している必要はありません。コンテキスト・リンク・サブタブは読取り専用です。

既存の詳細ページへのコンテキスト・リンク・サブタブの追加:

1. ページ概要ページで「サブタブの作成」アイコンをクリックします。

2. 「コンテキスト・リンク」を選択します。

   
   
   

3. 「コンテキスト・リンク」サブタブ構成ページでの操作:

   1. サブタブに表示するオブジェクトを選択し、サブタブの表示ラベルを選択します。

   2. 選択したオブジェクトの検索基準のセットを使用して、ランタイム時に表示されるレコードのリストを、ランタイム値が現在のオブジェクトのレコードのランタイム値と一致するものに制約することができます。

      ヒント

      値はリテラル値、または現在のオブジェクトのレコードのランタイム値あるいは現在のオブジェクトの親レコードのランタイム値から導出された値になります。

      検索基準に固定選択リスト・フィールドが含まれていれば、参照コード内容ではなく、参照コードを使用して固定選択リストのランタイム値を指定しなければなりません。

   3. ランタイム時にサブタブの読取り専用要約表に表示したいフィールドを選択します。

      子オブジェクト・レコードまたは関連オブジェクト・レコードをリスト表示するメイン要約表のフィールドを構成することができます。

   4. ランタイム時にサブタブの読取り専用詳細フォームに表示したいフィールドを選択します。

      要約表の下に表示される詳細フォームのフィールドを構成することができます。

共通コンポーネント・サブタブ

共通コンポーネント・サブタブは、カスタム、トップ・レベル・オブジェクトに関連する選択されたコンポーネントのリストを表示する「ノート」、「タスク」、「顧客対応」、または「約束」サブタブを追加します。個々のコンポーネントは、あらゆるOracle Fusion CRMアプリケーションで共有される標準ユーザー・インタフェース（UI）を持っています。すべての（「約束」以外の）共通コンポーネントに合わせてそのようなUIをカスタマイズするには、共通アプリケーションのもとで適切なオブジェクトを選択した上で、オブジェクトのナビゲーション・ツリーで「ページ」ノードを選択し、作業領域構成ページにアクセスします。

ランタイム時には、ユーザーはこれらのサブタブにアクセスして、オブジェクト・レコードに結び付いた共通コンポーネント・レコードを作成することができます。たとえば、あるユーザーは1つのサービス要求レコードに関する顧客対応を記録することができます。

• ノート

• タスク

• 顧客対応

• 約束

既存の詳細ページへの共通コンポーネント・サブタブの追加:

1. ページ概要ページで「サブタブの作成」アイコンをクリックします。

2. 「共通コンポーネント」を選択します。

   
   
   

3. 共通コンポーネントサブタブ構成ページで、詳細ページにサブタブとして追加したい共通コンポーネントのタイプを選択します。

Webコンテンツ・サブタブ

Webコンテンツ・サブタブはオブジェクトの詳細ページの上に外部Webサイトを表示します。 Webコンテンツは、対象のURLを構築するように定義した式の結果です。

たとえば、担当者、詳細ページでは、担当者の所在地を表示するGoogleマップを追加したい場合があるかもしれません。Google Maps APIはURLが一定の方式でフォーマットされていると想定します。この場合には、「担当者所在地」、担当者郡市区、担当者都道府県といったフィールドを使用して式を書きます。その上で、そのURLをGoogle Maps APIに渡します。

既存の詳細ページへのWebコンテンツ・サブタブの追加:

1. オブジェクトの詳細ページに表示する1つまたは複数のサブタブを作成するために、ページ概要ページで「サブタブの作成」アイコンをクリックします。

2. 「Webコンテンツ」を選択します。

   
   
   

3. Webコンテンツサブタブ構成ページでサブタブの表示ラベルを入力した上で、サブタブのWebコンテンツを取得するURLを定義します。

   必要に応じて、式エディタを使用して必要なURL式を構築します。

構築する式は、次の条件を満たしていなければなりません。

• HTTPプロトコルを使用する。

• 必要に応じて、パラメータとして、あるいはユーザー変数として、現在のオブジェクトからのフィールド値を含む。

• 静的文字列はダブル・クォーテーション・マークで囲む。

  例: "http://www.abc.com/"

次に例を示します。

def myURL1 = adf.util.GlobalEncodeField(ContactAddress_c)
def myURL2 = adf.util.GlobalEncodeField(ContactCity_c)
def myURL3 = adf.util.GlobalEncodeField(ContactState_c)
def myfinalURL = "http://maps.google.com/maps?hl=en&q=" + myURL1 + "+" + myURL2 + "+" + myURL3
return(myfinalURL)

ツリー・ノード: 説明

「販売アカウント・プロファイル」「パートナ」オブジェクトなど、一部のCRM標準オブジェクトは、ツリーを使用してその関連ページを表示します。オブジェクトの作業領域を構成するときは、オプションでそのオブジェクトのツリーにツリー・ノードを追加し、ツリー・ノード・データのソースを指定することによって、現在のオブジェクトに関連する詳細を表示することができます。ツリー・ノード・データは、他のオブジェクト、あるいは現在のOracle Fusion CRMアプリケーション以外のまったく別のソースから導出することができます。Oracle Fusion CRMアプリケーション・コンポーザのオブジェクトのページ概要ページから標準オブジェクトのツリーにツリー・ノードを追加します。

オブジェクトのツリーにツリー・ノードを追加するときは、事前にアプリケーション・コンポーザにおけるツリー・ノード作成プロセスについて次の点を確認してください。

• ツリー・ノードの追加

• ツリー・ノードのタイプ:

  • 子または関連オブジェクト・ツリー・ノード

  • コンテキスト・リンク・ツリー・ノード

  • Webコンテンツ・ツリー・ノード

ツリー・ノードの追加

オブジェクトのページ概要ページからオブジェクトのツリーにツリー・ノードを追加します。

オブジェクトのツリーへのツリー・ノードの追加:

1. 主要「概要」ページでアプリケーションを選択します。

2. オブジェクト・ツリーで「販売アカウント・プロファイル」または「パートナ」の標準オブジェクトを選択します。

3. 「ページ」ノードを選択します。

   注意

   ツリー・ノードを追加できるのはトップ・レベル・オブジェクト「販売アカウント・プロファイル」と「パートナ」だけです。

4. オブジェクトのツリーに1つまたは複数のツリー・ノードを作成するためにページ概要ページで「ツリー・ノードの作成」アイコンをクリックします。

5. 追加したいツリー・ノードのタイプを選択します。

   
   
   

子または関連オブジェクト・ツリー・ノード

関連は2つのオブジェクトの間の外部キーによる結び付きをさします。アプリケーション・コンポーザを使用すると、同じアプリケーション内の2つのオブジェクトの間に1対多の関連を作成することができます。関連が作成されたら、「1」のオブジェクトのツリーに表示されるツリー・ノードに「多」のオブジェクトを表示することができます。たとえば、1つのパートナに関連付けられる担当者が複数存在することがあります。特定のパートナに関連付けられた担当者のリストをそのパートナのツリーにツリー・ノードとして表示するには、まずそのパートナと担当者のオブジェクトの間に1対多の関連を作成しなければなりません。この場合、パートナがソース・オブジェクト、担当者がターゲット・オブジェクトになります。この関連では、担当者オブジェクトの表にパートナの識別子が追加されます。

アプリケーション・コンポーザでは、1つの子オブジェクトまたは3種類の関連オブジェクトのツリーにツリー・ノードを追加することができます。これにより、次の4種類の1対多の関連を作成することができます。 詳しくは、オブジェクト関連の関連トピックで説明しています。

• 親子関連

• 選択リスト関連

• 参照関連

• 標準関連

既存のツリーへの子または関連オブジェクト・ツリー・ノードの追加:

1. ページ概要ページで「ツリー・ノードの作成」アイコンをクリックします。

2. 「子または関連オブジェクト」を選択します。

   
   
   

3. 「子または関連オブジェクト」ツリー・ノード構成ページでの操作:

   1. ツリー・ノード・カテゴリを選択し、ツリー・ノード・ラベルを入力します。

   2. ツリー・ノード・ページに表示されるすべての関連オブジェクトのリストから関連オブジェクトを選択します。

   3. 新しいツリー・ノードの位置を設定します。

   4. 必要に応じて、ランタイム時にツリー・ノードに表示される「新規」および「削除」ボタンを非表示にすることができます。

      子オブジェクトのツリー・ノードでは、必要に応じて「編集」ボタンも非表示にすることができます。

   5. 子オブジェクト・ツリー・ノードの場合は、ランタイム時にツリー・ノード・ページの要約表に権限管理ボタンを表示するかどうかを指定します。

      ランタイム時にユーザーがオブジェクト・レコードを選択してこのボタンをクリックすると、選択したレコードに対して別のユーザーが持つアクセス・レベルを指定することができます。

   6. ランタイム時にツリー・ノード・ページの要約表に表示したいフィールドとリンクを選択します。

      子オブジェクト・レコードまたは関連オブジェクト・レコードをリスト表示するメイン要約表についてフィールドとリンクを構成することができます。

   7. ランタイム時にツリー・ノード・ページに表示させたいボタンを選択します。

      注意

      このリージョンは、事前にこのオブジェクト用のボタンを作成していた場合にのみ表示されます。

      「販売アカウント・プロファイル」オブジェクトの場合は、ツリー・ノード・ページにボタンを追加することはできません。

   8. ランタイム時にツリー・ノード・ページの詳細フォームに表示させたいフィールドを選択します。

      要約表の下に表示される詳細フォームのフィールドを構成することができます。ツリー・ノードのオブジェクトが子オブジェクトなら、ユーザーはランタイム時にこの詳細フォームに子オブジェクト・データを入力することができます。 必須フィールドは必ずこのセクションに含めてください。

      ツリー・ノードのオブジェクトが関連オブジェクトなら、ユーザーはツリー・ノード・オブジェクトの既存のレコードをページのマスター・オブジェクトに関連付けることができます。ただし、新しい関連オブジェクトのレコードを作成するときは、ユーザーはそのオブジェクト自体の作成ページでそれを行わなければなりません。

コンテキスト・リンク・ツリー・ノード

コンテキスト・リンク・ツリー・ノードは任意のトップ・レベル・オブジェクトからのフィルタ処理されたレコードのリストを表示し、このフィルタは通常、現在のオブジェクトからのランタイム値に基づいています。オブジェクトは現在のオブジェクトに関連している必要はありません。コンテキスト・リンク・ツリー・ノード・ページは読取り専用です。

オブジェクトのツリーへのコンテキスト・リンク・ツリー・ノードの追加:

1. ページ概要ページで「ツリー・ノードの作成」アイコンをクリックします。

2. 「コンテキスト・リンク」を選択します。

   
   
   

3. 「コンテキスト・リンク」ツリー・ノード構成ページでの操作:

   1. ツリー・ノード・カテゴリを選択し、ツリー・ノード・ラベルを入力します。

   2. ツリー・ノード・フィルタの名前を入力します。

   3. ツリー・ノード・ページに表示するオブジェクトを選択します。

   4. 新しいツリー・ノードの位置を設定します。

   5. 必要に応じて、選択したオブジェクトの検索基準のセットを使用して、ランタイム時に表示されるレコードのリストを、ランタイム値が現在のオブジェクトのレコードのランタイム値と一致するものに制約することができます。

      ヒント

      値はリテラル値、または現在のオブジェクトのレコードのランタイム値あるいは現在のオブジェクトの親レコードのランタイム値から導出された値になります。

      検索基準に固定選択リスト・フィールドが含まれていれば、参照コード内容ではなく、参照コードを使用して固定選択リストのランタイム値を指定しなければなりません。

   6. ランタイム時にツリー・ノード・ページの読取り専用の要約表に表示したいフィールドを選択します。

      子オブジェクト・レコードまたは関連オブジェクト・レコードをリスト表示するメイン要約表のフィールドを構成することができます。

   7. ランタイム時にツリー・ノード・ページの読取り専用の詳細フォームに表示させたいフィールドを選択します。

      要約表の下に表示される詳細フォームのフィールドを構成することができます。

Webコンテンツ・ツリー・ノード

Webコンテンツ・ツリー・ノード・ページは企業ページの上に外部Webサイトを表示します。Webコンテンツは、対象のURLを構築するように定義した式の結果です。

たとえば、担当者ツリー・ノード・ページでは、担当者の所在地を表示するGoogleマップを追加したい場合があるかもしれません。Google Maps APIはURLが一定の方式でフォーマットされていると想定します。この場合には、「担当者所在地」、担当者郡市区、担当者都道府県といったフィールドを使用して式を書きます。その上で、そのURLをGoogle Maps APIに渡します。

オブジェクトのツリーへのWebコンテンツ・ツリー・ノードの追加:

1. オブジェクトのツリーに1つまたは複数のツリー・ノードを作成するためにページ概要ページで「ツリー・ノードの作成」アイコンをクリックします。

2. 「Webコンテンツ」を選択します。

   
   
   

3. Webコンテンツツリー・ノード構成ページでの操作:

   1. ツリー・ノード・カテゴリを選択し、ツリー・ノード・ラベルを入力します。

   2. 新しいツリー・ノードの位置を設定します。

   3. ツリー・ノード・ページのWebコンテンツを取得するURLを定義します。

      必要に応じて、式エディタを使用して必要なURL式を構築することができます。

構築する式は、次の条件を満たしていなければなりません。

• HTTPプロトコルを使用する。

• 必要に応じて、パラメータとして、あるいはユーザー変数として、現在のオブジェクトからのフィールド値を含める。

• 静的文字列はダブル・クォーテーション・マークで囲む。

  例: "http://www.abc.com/"

次に例を示します。

def myURL1 = adf.util.GlobalEncodeField(ContactAddress_c)
def myURL2 = adf.util.GlobalEncodeField(ContactCity_c)
def myURL3 = adf.util.GlobalEncodeField(ContactState_c)
def myfinalURL = "http://maps.google.com/maps?hl=en&q=" + myURL1 + "+" + myURL2 + "+" + myURL3
return(myfinalURL)

ボタンおよびリンク: 説明

標準またはカスタム・オブジェクトの作業領域を構成するときは、作業領域の一定の場所にカスタム・ボタンまたはリンクを追加することができます。ボタンは、所定の動作の実行、またはユーザーのランタイム・アプリケーション内の別のページ、あるいはまったく別のWebサイトへのナビゲートを行うことができます。リンクは別のWebサイトへの切り換えを行います。Webサイトは、ユーザーのファイアウォールの内側にある場合もあれば、外側にある場合もあります。たとえば、概要ページから企業のWebサイトへ静的リンクを設けたい場合や、既存の「トラブル・チケット」が個別に管理したほうがよい、より深刻な「事件」にエスカレートしたときのように、要約表にボタンを設け、ユーザーがランタイム時にそれをクリックして、選択した行から新しいタイプのレコードを作成できるようにしたい場合に、ボタンやリンクを設けるときは、まずオブジェクトについてボタンまたはリンクを定義します。次に、Oracle Fusion CRMアプリケーション・コンポーザの作業領域構成ページを使用して、概要ページまたは詳細ページにボタンやリンクを追加します。

ボタンまたはリンクの追加

ボタンまたはリンクの作成ページからボタンまたはリンクを追加します。

ボタンまたはリンクの追加:

1. 主要「概要」ページでアプリケーションを選択します。

2. オブジェクト・ツリーで標準またはカスタム・オブジェクトを選択します。

3. 「ボタンおよびリンク」ノードを選択します。

   
   
   

ボタン

ボタンを定義するときは、そのボタンがランタイム時にクリックされたら何をするかを指定します。そのために、ボタンのソースがURLかスクリプトかを示します。

ソースがURLであれば、静的URLをダブル・クォーテーション・マークで囲んで入力することができます。また、式エディタを使用してURLを定義すると、式エディタがこのオブジェクトのフィールドへのアクセスを提供し、URLの構築を支援します。このオブジェクトが親またはソース・オブジェクトとの関連を持つ場合は、オプションでコンテキストを変更し、別のオブジェクトのフィールドへアクセスしてURLを定義します。

ソースがスクリプトなら、「メソッド名」選択リストから事前定義されたオブジェクト関数を選択するか、式エディタを使用して新しいオブジェクト関数を作成することができます。

オブジェクトについてボタンを定義したら、そのボタンをそのオブジェクトの作業領域の様々な場所へ追加することができます。

• 概要ページの要約表

• 詳細ページのデフォルト要約

• 詳細ページのサブタブの要約表

• 子オブジェクトのツリー・ノード・ページの要約表

• 商談オブジェクトの詳細ページの収益表

リンク

リンクを定義するときは、静的URLを入力するか、式エディタを使用してURLを構築することができます。

静的URLはダブル・クォーテーション・マークで囲んでください。また、式エディタを使用してURLを定義すると、式エディタがこのオブジェクトのフィールドへのアクセスを提供し、URLの構築を支援します。このオブジェクトが親またはソース・オブジェクトとの関連を持つ場合は、オプションでコンテキストを変更し、別のオブジェクトのフィールドへアクセスしてURLを定義します。

オブジェクトについてリンクを定義したら、そのリンクをそのオブジェクトの作業領域の様々な場所へ追加することができます。リンクは、フィールドを追加できるときはいつでも追加することができます。追加できる場所には、次のようなところがあります。

• 概要ページの要約表の列

• 詳細ページのデフォルト要約

• 詳細ページのサブタブの要約表の列

• 詳細ページのサブタブの要約表の下の詳細フォーム

• 子オブジェクトのツリー・ノード・ページの要約表の列

• 商談オブジェクトの詳細ページの収益表の列

CRMオブジェクトに関する保存済検索: 説明

保存済検索は、ランタイム時にユーザーが標準またはカスタム・オブジェクトの概要ページに適用することができる事前定義された検索基準のセットです。概要ページは要約表で1つのオブジェクトに関する記録のリストを提示し、これがCRMアプリケーションでユーザーがデータを見て管理する出発点となります。ユーザーが特定のデータ・セット（たとえば、トップ10の商談）に特に強い関心を持つよう、そのオブジェクトについて保存済検索を定義することができます。ランタイム時に、ユーザーは「保存済検索」選択リストから1つの「保存済検索」を選択し、要約表に表示されるレコードのリストを絞り込むことができます。また、新しい保存済検索を作成し、保存済検索のリストをパーソナライズすることもできます。

CRMオブジェクトの保存済検索を定義するときは、事前にOracle Fusion CRMアプリケーション・コンポーザにおける保存済検索定義のプロセスについて次の点を確認してください。

• ランタイム時の保存済検索

• 保存済検索の定義

ランタイム時の保存済検索

保存済検索のリストは、概要ページの要約表の上の「保存済検索」選択リストで見ることができます。

保存済検索のリストには、管理者が定義した保存済検索のほかに、ユーザーがパーソナライズを使用して自分で定義した個人的な保存済検索も含まれています。保存済検索はアルファベット順に表示され、パーソナライズしたものはあとに表示されます。

管理者があるオブジェクトについて定義した保存済検索は、そのオブジェクトの概要ページへの機能的セキュリティ・アクセスを持つユーザーおよびロールなら、誰でも使用可能です。

保存済検索の定義

あるオブジェクトに関する保存済検索は、そのオブジェクトの保存済検索の作成ページで定義します。ランタイムCRMアプリケーションでは、トップ・レベル・オブジェクトだけが概要ページを持つので、保存済検索はトップ・レベル・オブジェクトについてのみ定義されます。

オブジェクトの保存済検索の定義:

1. 主要「概要」ページでアプリケーションを選択します。

2. オブジェクト・ツリーで標準またはカスタム・オブジェクトを選択します。

3. 「保存済検索」ノードを選択します。

4. オブジェクトの保存済検索の作成ページで、保存済検索の表示ラベルを入力します。

   表示ラベルは「保存済検索」選択リストに表示されるラベルです。

5. 保存済検索の内部名と摘要を入力します。

   名前は、指定した表示ラベルに基づき、スペースをアンダースコアに置き換えて、自動的に生成されます。たとえば、「Top Ten Opportunities」と指定すると、自動的に「Top_Ten_Opportunities」として移入されます。

6. 含めたい検索基準を指定します。

   検索条件は、次の基準を使用して、最大4つまで入力することができます。

   • 一致基準、AllまたはAnyを指定します。

     • Allは複数の条件をANDでつなぎます。

     • Anyは2つの条件をORでつなぎます。

       条件が3つ以上あるときは、Anyを選択することはできません。

   • フィールド名

     検索基準として含めたい重要なオブジェクト・フィールドを指定します。

     長いテキスト、算式フィールドは、保存済検索では使用できません。

     ヒント

     パフォーマンス向上のため、保存済検索に含めるフィールドは索引付けしておきます。フィールドには、最初に作成したときに索引付けをします。

   • 演算子

     選択に使用可能な演算子の値は、選択したフィールドのタイプによって異なります。

     この表は、個々のフィールド・タイプについて、選択に使用可能な演算子と入力することができる値を示しています。

     
     

     フィールド・タイプ	使用可能な演算子	使用可能な値
     番号 チェック・ボックス 比率	Equal to Greater than Greater than or equal to Is blank Is not blank Less than Less than or equal to Not equal to	リテラル値を入力します。 注意 比率フィールドについては、比率を100で割って、検索基準として入力するリテラル値を計算してください。たとえば、保存済検索で150%を条件としたいときは、1.5と入力します。
     動的選択リスト テキスト 固定選択リスト 通貨	Contains Does not contain Ends with Equal to Is blank Is not blank Not equal to Starts with	リテラル値を入力します。 ヒント 固定選択リスト・フィールドについては、参照コード内容ではなく、参照コードを入力しなければなりません。
     日付 日時	After Before Equal to Is blank Is not blank Not equal to On or after On or before	次のものを入力します。 リテラル値 日付関数 日数、月数、または年数は、現在の日付の前もしくはあとに指定します。

   • 値

     指定した値は、ランタイム時に検索基準として、オブジェクト・レコードに対して適用されます。

     上の表を参照してください。

カスタム・オブジェクトの保護: 説明

カスタム・オブジェクトとフィールドを作成したら、次にそれをユーザーが見る企業ページに表示させます。そこで必要になるのが、ランタイム時にオブジェクトのデータにアクセスする権限の管理です。デフォルトでは、オブジェクトとそのレコードはアプリケーションで指定されたデフォルト職務ロールしか見ることも編集することもできません。追加のアクセス権は、Oracle Fusion CRMアプリケーション・コンポーザのセキュリティ・ポリシー構成ページを使用して手動で設定します。セキュリティ・ポリシーは、オブジェクトのデータにアクセスする権限を持つユーザー、および彼らに認められたアクセスのタイプを指定します。たとえば、あるユーザーは表示専用のアクセスを認められているのか、それとも、オブジェクトのレコードを作成、更新することも認められているのか、ということです。オブジェクトのセキュリティ・ポリシーは、ユーザーが属するロールにそのオブジェクトのデータにアクセスできる権限を与えることによって定義します。あるいは、複数のカスタム・オブジェクトにわたってアクセス・レベルを指定することによって、ロールについてのセキュリティ・ポリシーを定義します。

セキュリティ・ポリシーを定義するときは、事前にアプリケーション・コンポーザにおけるカスタム・オブジェクト・セキュリティ・プロセスについて次の点を確認してください。

• オブジェクトの保護

• ロールの保護

• 機能セキュリティとデータ・セキュリティの有効化

• CRMアプリケーション・コンポーザとOracle Authorization Policy Manager（APM）

• デフォルト・セキュリティ設定

オブジェクトの保護

オブジェクト中心のポリシーの定義ページは、特定のCRM職務ロールにマップする企業レベルの職務ロールのリストを表示します。このページを使用して、1つまたは複数の職務ロールについてセキュリティ・ポリシーを指定することにより、トップ・レベルまたは子カスタム・オブジェクトへのアクセスを管理します。これを行うと、対応するロールを持つユーザーは、定義したセキュリティ・ポリシーに応じてカスタム・オブジェクトとそのデータにアクセスすることができます。

オブジェクト中心のポリシーの定義ページへのアクセス:

1. 主要「概要」ページでアプリケーションを選択します。

2. オブジェクト・ツリーでカスタム・オブジェクトを選択します。

3. 「セキュリティ」ノードを選択します。

   あるいは、ロール中心のポリシーの定義ページから、カスタム・オブジェクトを選択します。

   
   
   

オブジェクト中心のポリシーの定義ページからは、次のことができます。

• ロールの機能セキュリティを有効にする。

• ロールのデータ・セキュリティを有効にする。

• ユーザーに対して、ランタイム時に所定のロールを持つユーザーに、特定のレコードへのアクセスを認めることを許可する。

ロールの保護

ロール・セキュリティページは、特定のCRM職務ロールにマップする企業レベルの職務ロールのリストを表示します。ロールを選択して「ポリシーの定義」ボタンをクリックし、CRM実装用のカスタム・オブジェクトのリストを表示するロール中心のポリシーの定義ページにナビゲートします。 このページを使用して、1つまたは複数のトップ・レベルまたは子カスタム・オブジェクトについてセキュリティ・ポリシーを指定することにより、対応するロールを持つユーザーのアクセスを管理します。これを行うと、対応するロールを持つユーザーは、定義したセキュリティ・ポリシーに応じてカスタム・オブジェクトと関連データにアクセスすることができます。

ロール中心のポリシーの定義ページへのアクセス:

1. 主要「概要」ページでアプリケーションを選択します。

2. 「共通設定」ペインで「ロール・セキュリティ」ノードを選択します。

   あるいは、主要「概要」ページのローカル領域でロール・セキュリティハイパーリンクを選択します。

   あるいは、オブジェクト中心のポリシーの定義ページからロールを選択します。

   
   
   

3. 「ポリシーの定義」ボタンをクリックします。

   
   
   

ロール中心のポリシーの定義ページからは、次のことができます。

• カスタム・オブジェクトの機能セキュリティを有効にする。

• カスタム・オブジェクトのデータ・セキュリティを有効にする。

• ユーザーに対して、ランタイム時に所定のロールを持つユーザーに、特定のレコードへのアクセスを認めることを許可する。

• 関連ロールを見る（ある場合）。

  関連ロールがオブジェクトの横に表示されると、選択したロールが関連ロールからそのオブジェクトへのアクセスを継承しています。関連ロールにドリルダウンすると、そのセキュリティ・ポリシーを見ることができます。

機能セキュリティとデータ・セキュリティの有効化

セキュリティ・ポリシーは、対応するロールを持つユーザーがあるオブジェクトとそのレコードに対して持つアクセスのタイプを指定します。アクセスには、機能セキュリティのほかにデータ・セキュリティも含まれます。セキュリティ設定は、セキュリティ・ポリシーをオブジェクトについて定義しても、ロールについて定義しても、同じです。

ポリシーの定義ページでは、表の最初の4列が機能セキュリティを管理し、全体としてオブジェクトに適用されます。

• 作成

  対応するロールを持つユーザーは、オブジェクトのレコードを作成することができます。

• 表示

  対応するロールを持つユーザーは、オブジェクトの作業領域ページを表示することができます。

• 更新

  対応するロールを持つユーザーは、オブジェクトのレコードを更新することができます。

• 削除

  対応するロールを持つユーザーは、オブジェクトのレコードを削除することができます。

表の次の4列はデータ・セキュリティを管理します。

• すべて表示

  対応するロールを持つユーザーは、オブジェクトのレコードを表示することができます。

• すべて更新

  対応するロールを持つユーザーは、オブジェクトのレコードを更新することができます。

最後の列には「アクセス権の付与」チェック・ボックスがあります。 ランタイム時には、このチェック・ボックスの選択でオブジェクトの集約表の権限管理ボタンの表示を制御します。 ランタイム時に、対応するロール（または管理ロール）を持つユーザーがオブジェクト・レコードを選択してこのボタンをクリックすると、選択したレコードに対して別のユーザーが持つアクセス・レベルを指定することができます。

CRMアプリケーション・コンポーザとOracle Authorization Policy Manager（APM）

Oracle Authorization Policy Manager（APM）は、Oracle Fusionのアプリケーション全般にわたり、ロールに基づいてアクセスを制御するセキュリティ・ポリシーを管理します。しかし、アプリケーション・コンポーザのオブジェクト中心およびロール中心ポリシーの定義ページでは、カスタム・オブジェクトについてセキュリティ・ポリシーを定義します。 これはAPMの対象外です。

APMの対象外のセキュリティ・ポリシーを定義するため、このセキュリティ・ポリシーは後でAPM内で修正することはできません。このため、カスタム・オブジェクトに関するセキュリティ・ポリシーはすべてアプリケーション・コンポーザだけを使用して修正します。

デフォルト・セキュリティ設定

デフォルトでは、トップ・レベル・カスタム・オブジェクトは、いずれかのCRMアプリケーションでデフォルト職務ロールを指定されたユーザーにしか、表示、編集することはできません。その他の職務ロールには、必要に応じて、手動で追加のアクセス権を付与しなければなりません。たとえば、Oracle Fusion Salesでカスタム・オブジェクトを作成した場合は、自動的にそのオブジェクトへのアクセスを認められるのはSalesでデフォルト職務ロールを指定されたユーザーだけになります。このため、ユーザーに生産環境の中で正式にカスタマイゼーションへのアクセスを認める前に、まず自分でオブジェクトとそのページにアクセスし、テストを行ってください。

この表は、CRMアプリケーションによって提供されるデフォルト職務ロールを示しています。

子オブジェクトは親オブジェクトからセキュリティ設定を継承しません。カスタム子オブジェクトを作成した場合には、デフォルトの職務ロールのセットにその子オブジェクトへのアクセス権が認められます。つまり、子オブジェクトは次のようなデフォルトの職務ロールを持つユーザーにしか、表示、編集することはできません。

Groovyスクリプト: 説明

Groovyは、Oracle Fusion CRMアプリケーション・コンポーザが深くサポートしているJavaプラットフォーム用の標準的な動的スクリプト言語です。この項では、アプリケーション・コンポーザを通してアプリケーションのカスタマイゼーションの質の向上にお役立ていただけるように、Groovyスクリプトの概略を説明します。

Groovyスクリプトをアプリケーションのカスタマイゼーションでご使用になる前に、次のトピックに目を通してください。

• 用語の説明

• アプリケーション・コンポーザで考えられる様々なGroovyスクリプト使用のコンテキスト

関連トピック「Groovyスクリプト: 例」も参照し、書ける各種のGroovyスクリプトの例を確認してください。

詳しくは、My Oracle Support（https://support.oracle.com）の「Developer's Guide to Scripting in Oracle Fusion CRM Application Composer」をご覧ください。

• Groovyの基礎

• Groovyをアプリケーションで最大限に活用するためのヒントとテクニック

  ヒントとテクニックのところでは、式エディタとの連用性についても簡単に触れています。式エディタはGroovyスクリプトを書くところであり、組込み関数、オブジェクト・フィールド、あるいは関数名の挿入を容易にする式パレットも含んでいます。

用語の説明

このドキュメントでは、全般にターム・スクリプトを使用してランタイム時にOracle ADFフレームワークが実行する1行または複数行のGroovyコードを記述しています。ひたすら短いスクリプトが求められることもよくあります。

たとえば、CommissionPercentageフィールドの値が40%を超えないことを検証するときは、次のような1行スクリプトを使用することがあります。

return CommissionPercentage < 0.40

実際には、returnキーワードは常にスクリプトの最終行に暗示されるので、この1行スクリプトは、returnキーワードを省略してうまく短縮することができます。

CommissionPercentage < 0.40

これよりやや複雑なロジックでは、スクリプトが条件付き処理を求めることがあります。たとえば、手数料比率の上限を営業担当の職務等級が3以下のときは40%とするが、それ以上のときは60%とするとします。スクリプトは次のように少し長くなります。

if (JobGrade <= 3) {
  return CommissionPercentage < 0.40
}
else {
  return CommissionPercentage < 0.60
}

複雑な検証ルールや再利用可能な関数のような他の目的のために書くスクリプトは、ニーズによっては複数ページにまたがることがあります。

Groovyスクリプトを必要とするコンテキストが通常は短い（多くの場合1行の）スクリプトを使用するときは、それを式と呼んで、そのことを強調しますが、基本的にターム・スクリプトと式は置き換え可能なものです。1行式が使用できるところは、常に必要が生じたときに複数行のスクリプトを使用するコンテキストとしても有効です。短い式、複数行のスクリプトに限らず、自由に使用できるシンタックスや機能は変わりません。自分のコードがそれを使用するコンテキストに対して適切なタイプの値を返すことだけに注意を払っていればよいのです。次の各セクションでは、問題のスクリプトに対する期待戻り値データ型を中心に見ていきます。

アプリケーションでGroovyを使用する場合

既存のオブジェクトをカスタマイズしたり、新しいカスタム・オブジェクトを作成したりしていると、様々なコンテキストでGroovyスクリプトを使用する場面があります。

次のようなことを行う式を与えるときは、より短いスクリプトを書きます。

• カスタム算式フィールドの値を計算する

• カスタム・フィールドのデフォルト値を計算する

• カスタム・フィールドを条件付きで更新可能にする

• カスタム・フィールドを条件付きで必須にする

• オブジェクト・ワークフローを実行する条件を定義する

次のようなものを定義するときは、一般にやや長めのスクリプトを書きます。

• フィールド・レベルの検証ルール

• オブジェクト・レベルの検証ルール

• デフォルト処理を補完するトリガー

• グローバル関数の中のユーティリティ・コード

• オブジェクト関数の中の再利用可能な動作

複数の異なるコンテキストから同じコードを呼び出すことが予想されれば、グローバル関数またはオブジェクト関数の中に再利用可能なコードを書き、それをいずれかのスクリプトで呼び出すことができます。「グローバル」という名前からわかるように、この関数はいかなるオブジェクトのスクリプトからも、また、他のグローバル関数からも呼び出すことができます。オブジェクト関数は、同じオブジェクトの中のスクリプトによって呼び出すことができ、ユーザー・インタフェースのボタンでもトリガーすることができます。

これらの用法の具体的な例については、関連トピック「Groovyスクリプト: 例」を参照してください。

Groovyスクリプト: 例

Groovyは、Oracle Fusion CRMアプリケーション・コンポーザが深くサポートしているJavaプラットフォーム用の標準的な動的スクリプト言語です。アプリケーション・コンポーザを通してGroovyを使用すると、アプリケーションのカスタマイゼーションの質を向上させることができます。この項では、アプリケーションでサポートされている様々なコンテキストの中でのGroovyの簡単な使用例を紹介します。

カスタム算式フィールドの値を計算する式を与える

集計フィールド、またはオプションの初期集計値を持つ過渡値ホルダを必要としている場合は、算式フィールドを使用します。

1. 読取り専用の集計フィールドの場合

算式フィールドはデフォルトで読取り専用の集計フィールドになっています。与えた計算式のランタイム評価の結果の値を表示します。フィールド作成または編集ページの「依存」マルチセレクト・リストを使用すると、式が依存するフィールドの名前を設定することができます。それにより、集計値は依存フィールドの値が変化すれば、動的に更新されるようになります。 算式フィールドの式の期待戻り値データ型は、指定した算式フィールド・タイプ（数値、日付、テキスト）と対応していなければなりません。

たとえば、カスタムのTroubleTicketオブジェクトを考えてみましょう。DaysOpenという算式フィールドを追加すると、次の式で集計値を与えることができます。

(today() - CreationDate) as Integer /* truncate to whole number of days */

2. オプションの集計された初期値を持つ過渡値ホルダの場合

エンド・ユーザーが集計値を上書きできるようにしたいときは、算式を更新可能にします。更新可能な算式フィールドは、ユーザーが上書きするまで式がフィールドの値を与える「過渡値ホルダ」です。ユーザーが値を上書きすれば、オブジェクトは現在のトランザクションの間そのユーザーが入力した値を記憶し、検証ルールやトリガーが参照できるようにします。更新可能な算式フィールドに1つまたは複数の依存フィールドを設定した場合は、依存フィールドのいずれかの値が変化すると、算式の値は集計値に戻ることに注意してください。ユーザーが値を入力するまで初期値がnullの過渡値フィールドにしたい場合は、単に更新可能な算式にフィールドに算式を与えないようにします。

カスタム・フィールドのデフォルト値を計算する式を与える

あるオブジェクトについて新しい行を作成したときは、デフォルト値を設定しないかぎり、カスタム・フィールドの値はデフォルトでnullになります。 適切なタイプのリテラル・デフォルト値、あるいは新しい行のデフォルト値を計算する式を与えることができます。 デフォルト値の式は新しい行が作成されたときに評価されます。フィールドのデフォルト値の式の期待戻り値データ型は、フィールドのタイプ（数値、日付、テキストなど）に対応していなければなりません。

たとえば、TroubleTicketオブジェクトでは、カスタムのCallbackDateフィールドを検討します。作成3日後に新しいトラブル・チケットに関するコールバックをデフォルトに戻したい場合は、次のようなデフォルト式を与えることができます。

CreationDate + 3

カスタム・フィールドを条件付きで更新可能にする式を与える

1. カスタム・フィールドを条件付き更新可能にする式を与えるには:

カスタム・フィールドは更新可能または読取り専用にすることができます。デフォルトでは、算式フィールド以外のフィールドはすべて更新可能です。また、条件付きで更新可能な式を設定することもできます。その場合は、そのフィールドを表示しているページがレンダリングまたはリフレッシュされるたびに評価が行われます。この式の期待戻り値データ型はbooleanです。1つのフィールドに1つの式を定義する場合は、依存リストを設定し、条件付き更新可能な式が依存するフィールドの名前を指定することもできます。これにより、条件付き更新可能なフィールドは、ユーザーがその条件付き更新可能な式が依存するフィールドの値を変えたときに、適宜、インタラクティブに有効、無効を切り換えます。

たとえば、「ステータス」、「調整」のフィールドを持つカスタムのTroubleTicketオブジェクトを考えてみます。ユーザーが処理済トラブル・チケットの調整フィールドを編集するのを防ぎたいとします。これを行うためには、「調整」フィールドの条件付き更新可能な式を次のように設定します。

Status_c != 'Closed'

この式を設定したら、次にMy Oracle Support（https://support.oracle.com）の「Developer's Guide to Scripting in Oracle Fusion CRM Application Composer」の「Understanding When to Configure Field Dependencies」の説明に従って「調整」フィールドが「ステータス」フィールドに依存することを指定しなければなりません。これにより、トラブル・チケットが処理済になったとき、あるいは処理済のトラブル・チケットが再びオープンにされたときに、適宜、「調整」フィールドが有効または無効になるようになります。

2. カスタム・フィールドを条件付きで必須にする式を与えるには

カスタム・フィールドはオプションにも必須にもすることができます。 デフォルトでは、オプションになっています。 また、条件付きで必須にする式を設定することもできます。 その場合は、そのフィールドを表示しているページがレンダリングまたはリフレッシュされるたび、また、オブジェクトが検証されたときに評価が行われます。この式の期待戻り値データ型はbooleanです。1つのフィールドに1つの式を定義する場合は、依存リストを設定し、 条件付き更新可能な式が依存するフィールドの名前を指定することもできます。 これにより、条件付き必須フィールドは、ユーザーがその条件付き必須式が依存するフィールドの値を変えたときに、適宜、インタラクティブに必須であることを示す表示の表示、非表示を切り換えます。

たとえば、「優先度」、「調整」のフィールドを持つカスタムのTroubleTicketオブジェクトを考えてみましょう。 優先度は1〜5の整数で表し、1が解決しなければならない問題の種類が最も重大だとしましょう。優先度1または2のトラブル・チケットに調整が必要であることを強制するには、この「調整」フィールドの条件付き必須式を次のように構成します。

Priority_c <= 2

この式を設定したら、次に「Developer's Guide to Scripting in Oracle Fusion CRM Application Composer」の「Understanding When to Configure Field Dependencies」の説明に従って「調整」フィールドが「優先度」フィールドに依存することを指定しなければなりません。これにより、優先度2以上のトラブル・チケットが作成されたとき、あるいは、既存のトラブル・チケットの優先度が3から2に上がったときには、「調整」フィールドが必須になります。

フィールド・レベルの検証ルールの定義

1. フィールド・レベルの検証ルールを定義するには

フィールド・レベルの検証ルールは、標準またはカスタム・フィールドに定義することができる制約です。対応するフィールドに値がセットされるたびに評価が行われます。ルールが実行されるときは、フィールドにはまだ値が割り当てられておらず、このルールが割当成功を見届けるゲートキーパーとなります。記述する式（または長いスクリプト）は、値が有効かどうかを示すboolean値を返さなければなりません。ルールがtrueを返し、同じフィールドの他のフィールド・レベル・ルールもすべてtrueを返せば、フィールド割り当ては成功となります。ルールがfalseを返せば、それでフィールド割り当ては発生せず、無効なフィールドがUI上でハイライト表示され、事前に設定されていたエラー・メッセージがエンド・ユーザーに表示されます。この場合、割り当ては失敗となるので、フィールドは現在の値（それまでの値がnullなら、おそらくnull）を保持しますが、WebページのUIコンポーネントがユーザーに無効入力を確認して訂正し、もう一度試行することを認めます。スクリプトはキーワードnewValueを使用して、検証に合格したら割り当てられる新しい値を参照します。既存のフィールド値を参照するには、キーワードoldValueを使用します。フィールド・レベル・ルールは、強制するルールがセットされる新しい値にのみ依存しているときに適切なものになります。キーワードnewValueとoldValueを挿入するには、式パレットの「キーワード」タブを利用することができます。

たとえば、「優先度」フィールドを持つカスタムのTroubleTicketオブジェクトを考えてみます。入力された数値が1〜5の整数であることを検証するため、フィールド・レベル検証ルールは次のようにします。

newValue == null || (1..5).contains(newValue as Integer)

2. オブジェクト・レベルの検証ルールを定義するには

オブジェクト・レベルの検証ルールは、いかなる標準またはカスタム・オブジェクトについても定義することができる制約です。 フレームワークがオブジェクトの検証を試みるたびに評価が行われます。これは、1つの行から別の行へナビゲートするときや、オブジェクトへの変更が保存されるときに、Webフォームで変更が発行されると、実行されます。オブジェクト・レベルのルールを使用してオブジェクト内の複数のフィールドに依存する条件を強制します。これにより、ユーザーが値を割り当てる順序にかかわらず、ルールは一貫して強制されます。記述する式（または長いスクリプト）は、値が有効かどうかを示すboolean値を返さなければなりません。ルールがtrueを返し、同じオブジェクトの他のオブジェクト・レベル・ルールもすべてtrueを返せば、オブジェクト検証は成功となります。ルールがfalseを返せば、それでオブジェクトの保存は阻止され、事前に設定されていたエラー・メッセージがエンド・ユーザーに表示されます。

たとえば、「優先度」と「割当先」のフィールドを持つTroubleTicketオブジェクトがあり、後者のフィールドは「タイプ」フィールドがスタッフ・メンバーの「担当者」オブジェクトを参照する動的選択リストだったとします。優先度1または2のトラブル・チケットはスタッフ・メンバーに割り当てられないと保存できないようになっていることを検証するオブジェクト・レベルのルールは次のようになります。

 // Rule depends on two fields, so must be written as object-level rule
if (Priority_c <= 2 && AssignedTo_Id_c == null) {
  // Signal to highlight the AssignedTo field on the UI as being in error
  adf.error.addAttribute('AssignedTo_c')
  return false;
}
return true; 

グローバル関数の中のユーティリティ・コードの定義

グローバル関数は複数のオブジェクトが共有を望むコードに有効です。グローバル関数を呼び出すには、関数名にadf.util.の接頭辞を付けます。 関数を定義するときは、戻り値を指定し、オプションでcallerが起動時にパスインすることを求められる型付きパラメータを1つまたは複数指定することもできます。関数戻り値やパラメータの型で最も一般的なものには、次のようなものがあります。

• String: テキスト値

• Boolean: true、falseの論理値

• BigInteger: 任意精度の整数

• BigDecimal: 任意精度の小数

• Date: 時間成分オプションの日付値

• List: 秩序あるオブジェクトの集合

• Map: 無秩序な名前/値のペアの集合

• Object: すべてのオブジェクト

さらに、関数は戻り値がないことを示す戻り値データ型voidも定義することができます。

たとえば、次の2つのグローバル関数は、Groovyスクリプトのブロックの始まりをログしたり、診断メッセージをログしたりする標準的なヘルパー・ルーチンを定義します。「Developer's Guide to Scripting in Oracle Fusion CRM Application Composer」の例では、それらを利用しています。

この表は、Groovyスクリプトのブロックの始まりをログするグローバル関数の設定方法を示しています。

// Log the name of the script
println("[In: ${scriptName}]")

この表は、診断メッセージをログするグローバル関数の設定方法を示しています。

// Log the message, could add other info
println(message)

オブジェクト関数の中の再利用可能な動作の定義

オブジェクト関数は、あるオブジェクトに特定のビジネス・ロジックを閉じ込めるコードに有効です。オブジェクト関数は、同じオブジェクトに関連する他の任意のスクリプト・コードから、名前で呼び出すことができます。さらに、ユーザー・インタフェースのボタンまたはリンクでも起動することができます。サポートされる戻り値データ型やオプションのパラメータ型は（前述の）グローバル関数と同じです。

たとえば、「担当者」カスタム・オブジェクトについて下記のようなupdateOpenTroubleTicketCount()オブジェクト関数を定義することができます。これは、診断メッセージを標準的なフォーマットでログし、カスタムGroovyスクリプトのブロックの始まりを合図する前記のlogStart()グローバル関数を呼び出すことによって始まります。 これは、（「Developer's Guide to Scripting in Oracle Fusion CRM Application Composer」の「Accessing the View Object for Programmatic Access to Business Objects」に紹介されている）newView()組込み関数を呼び出し、トラブル・チケットのプログラムによるアクセスのための表示オブジェクトにアクセスし、また別の（「Developer's Guide to Scripting in Oracle Fusion CRM Application Composer」の「Simplifying Most Common View Criteria Creation with a Global Function」に紹介されている）グローバル関数applyFilter()を呼び出し、フィルタをかけて、現在の担当者のIDに関連し、現在のステータスが処理中または「待機中」のトラブル・チケットを検索します。そして最後に、getEstimatedRowCount()を呼び出し、フィルター基準に合致するトラブル・チケットの数を取得します。

この表は、「担当者」カスタム・オブジェクトに関するupdateOpenTroubleTicketCount()オブジェクト関数の設定を示しています。

adf.util.logStart('updateOpenTroubleTicketCount')
// Access the view object for TroubleTicket programmatic access
def tickets = newView('TroubleTicket_c')
// Use a global function to apply a query filter to Trouble Ticket
// view object where Contact_Id = Id of current Contact and
// Status is either 'Working' or 'Waiting'
adf.util.applyFilter(tickets,[Status_c:['Working','Waiting'],
                              Contact_Id__c:Id])
// Update OpenTroubleTickets field value
setAttribute('OpenTroubleTickets_c',tickets.getEstimatedRowCount())

デフォルト処理を補完するトリガーの定義

トリガーは、標準またはカスタム・オブジェクトに関するデフォルト処理ロジックを補完するために書くことができるスクリプトです。 次のようなトリガーが使用可能です。

• After Create: オブジェクトの新しいインスタンスが作成されたときに実行されます。 オブジェクトの1つまたは複数のフィールドにプログラムによるデフォルト値を割り当てるために使用します。

• Before Modify: エンド・ユーザーが既存のクエリー行の永続的フィールド最初に修正するときに実行されます。

• Before Invalidate: 既存のオブジェクトの最初の永続的フィールドが修正されたときに実行されます。 子の行が作成、削除、または修正されたときに有効な親オブジェクトに対して実行されます。

• Before Remove: オブジェクトの削除が試行されたときに実行されます。 falseを返して行の削除を阻止し、オプションでトリガー・エラー・メッセージを表示します。

• Before Insert in Database: 新しいオブジェクトがデータベースに挿入される前に実行されます。

• After Insert in Database: 新しいオブジェクトがデータベースに挿入される前に実行されます。

• Before Update in Database: 新しいオブジェクトがデータベースに挿入される前に実行されます。

• After Update in Database: 新しいオブジェクトがデータベースに挿入される前に実行されます。

• Before Delete in Database: 新しいオブジェクトがデータベースに挿入される前に実行されます。

• After Delete in Database: 新しいオブジェクトがデータベースに挿入される前に実行されます。

• Before Commit in Database: 現在のトランザクションで現在のオブジェクトに関する変更（挿入、更新、削除）が永続化される前に実行されます。

• After Commit in Database: 現在のトランザクションで現在のオブジェクトに関する変更（挿入、更新、削除）が永続化される前に実行されます。

• Before Rollback in Database: 現在のオブジェクトに関する変更（挿入、更新、削除）が元に戻される前に実行されます。

• After Rollback in Database: 現在のオブジェクトに関する変更（挿入、更新、削除）が元に戻される前に実行されます。

たとえば、トラブル・チケットが作成または修正されるたびに必ず更新を求められるOpenTroubleTicketsフィールドを持つ「担当者」オブジェクトを考えてみます。TroubleTicketオブジェクトに前述のupdateOpenTroubleTicketCount()オブジェクト関数を起動する次の2つのトリガーを作成することができます。

この表は、TroubleTicketオブジェクトに関するトリガーの設定を示しています。

adf.util.logStart('After_Insert_Set_Open_Trouble_Tickets')
// Get the related contact for this trouble ticket
def relatedContact = Contact_Obj_c
// Update its OpenTroubleTickets field value
relatedContact?.updateOpenTroubleTicketCount()

この表は、TroubleTicketオブジェクトに関するトリガーの設定方法を示しています。

// Get the related contact for this trouble ticket
def relatedContact = Contact_Obj_c
// Update its OpenTroubleTickets field value
relatedContact?.updateOpenTroubleTicketCount()

Groovyスクリプトでサポートされているクラスとメソッド: 説明

Groovyは、Oracle Fusion CRMアプリケーション・コンポーザが深くサポートしているJavaプラットフォーム用の標準的な動的スクリプト言語です。この項では、Groovyスクリプトでサポートされているクラスとメソッドを紹介します。

クラスとメソッド

Groovyスクリプトを書くときは、下表にまとめたクラスやメソッドだけをご使用ください。ほかのクラスやメソッドを使用しても最初はうまくいくかもしれませんが、いずれコードを新しいバージョンに移すとき、実行時例外をスローすることになります。このため、Groovyコードはここに示したクラスやメソッドを忠実に守って書くことを強くお勧めいたします。どのクラスについても、表に示したメソッド名のほか、次のメソッドも許容されています。

• equals()

• hashCode()

• toString()

一方、次のメソッドはどのオブジェクトについても認められていません。

• finalize()

• getClass()

• getMetaClass()

• notify()

• notifyAll()

• wait()

カスタム・オブジェクトのインポートとエクスポート: 説明

Oracle Fusion CRMアプリケーション・コンポーザで作成したカスタム・オブジェクトのインポートやエクスポートをサポートするため、まずファイル・ベースインポートでも一括エクスポートでも求められるオブジェクト・アーティファクトを生成する必要があります。

Oracle Fusionのインポート/エクスポート・プロセス

Oracle Fusionでは、オブジェクト・データのインポートとエクスポートを可能にする2つのプロセス、ファイル・ベース・インポートと一括インポートが存在します。

ファイル・ベース・インポートは、外部テキストまたはxmlファイルからインタフェース表へ、さらにインタフェース表からターゲット・アプリケーション表へのデータのインポートをサポートします。

一括エクスポートは、CRMオブジェクトから1つのオブジェクトに関するフルセットのレコードの抽出として、また、増分抽出としても、大量のデータを抽出します。システムは、抽出したデータでカンマまたはタブ区切りのファイルを作成し、それが実行されたバッチ・レコードに添付され、ユーザーにとって使用可能になります。

カスタム・オブジェクトのインポート/エクスポートの有効化

アプリケーション・コンポーザを使用して行うオブジェクト・モデルの拡張では、これらのインポート/エクスポート・プロセスで求められるアーティファクトは作成されません。たとえば、ファイル・べース・インポートはOracle Data Integrator（ODI）を活用します。

したがって、オブジェクト・モデルの拡張が終わったら、拡張を登録するために必要なアーティファクトを生成し、インポート/エクスポートに使用可能にします。

カスタム・オブジェクト・データのインポート/エクスポートの有効化:

1. 主要「概要」ページでアプリケーションを選択します。

2. 「共通設定」ペイン、または主要「概要」ページのローカル領域で「インポートおよびエクスポート」リンクを選択します。

3. インポートおよびエクスポートページで「生成」ボタンをクリックします。

インポート/エクスポート用にオブジェクト・モデルの拡張を有効にしたら、ツールメニューで設定および保守を選択し、タスク名で検索した次のタスクを利用し、ファイル・ベース・インポートと一括エクスポートのプロセスをスケジュールすることができます。

• カスタム・オブジェクトのインポートをスケジュールするときは、「ファイル・インポート・アクティビティの管理」タスクを選択します。

  カスタム・オブジェクト・データのインポートのために最初にファイル・ベース・インポートを設定しておくには、「ファイル・インポート・オブジェクトの管理」と「ファイル・インポート・マッピングの管理」のタスクを選択します。

  注意

  カスタム子オブジェクトは親オブジェクトの一部としてインポートされます。

• カスタム・オブジェクトのエクスポートをスケジュールするには、「エクスポート・プロセスのスケジュール」タスクを選択します。

  注意

  トップ・レベル・カスタム・オブジェクトも子カスタム・オブジェクトも独立したエクスポート可能なオブジェクトとして使用可能です。

Oracle Fusion CRMアプリケーションの拡張に関するFAQ

固定選択リストと動的選択リストはどこが違いますか？

固定選択リストと動的選択リストは、どちらもランタイム時に値リストを持つフィールドを生成するところに究極の目的がある点では似ています。しかし、固定選択リストの値リストは、FND参照タイプから導出されます。

動的選択リストの値リストは、既存のオブジェクトの実データから導出されます。

Oracle ComposerとOracle Fusion CRMアプリケーション・コンポーザはどこが違いますか？

Oracle Composerは、ランタイム時にすべてのOracle Fusionアプリケーションにわたってユーザー・インタフェースの変更を行うものです。Oracle Fusion CRMトランザクション・ページ（ダッシュボード以外）では、Oracle Composerを使用して領域の拡大・折畳み、表の列の表示や並び順の設定、保存済検索の作成・編集を行うことができます。Oracle Fusion CRMダッシュボードでは、リージョンの表示・非表示・移動、リソース・カタログからの新しいコンテンツの追加など、追加のカスタマイズを行うことができます。

Oracle Fusion CRMアプリケーション・コンポーザもランタイム時にユーザー・インタフェースの変更を行うことができます。しかし、アプリケーション・コンポーザを使用して行うことができるユーザー・インタフェースの変更の種類はまったく異なります。とりわけ、アプリケーション・コンポーザを使用するときに主に焦点になるのは、実質的なオブジェクト・モデルの変更です。たとえば、新しいビジネス・オブジェクトと関連フィールドを作成した上で、ユーザーにそのオブジェクトとフィールドを表示する新しいアプリケーション・ページを作成することができます。オブジェクト・モデルをこのようなかたちで拡張するのはOracle Fusion CRMアプリケーションでしかできません。また、アプリケーション・コンポーザでは、リソース・カタログにアクセスしてページに新しいコンテンツを追加することはできません。

この表は、Oracle Composerとアプリケーション・コンポーザの主な違いを示しています。

前へ 次へ

Copyright ©  2011, Oracle and/or its affiliates. All rights reserved. 法律上の注意点

目次