ヘッダーをスキップ
Oracle® Fusion Middleware Oracle WebLogic Server Application Adapter for PeopleSoftユーザーズ・ガイド
11g リリース1(11.1.1.3.0)
B61416-01
  目次へ移動
目次
索引へ移動
索引

前
 
次
 

C コンポーネント・インタフェースの使用

この付録では、Oracle Application Adapter for PeopleSoftを使用してコンポーネント・インタフェースを新規作成または既存のコンポーネント・インタフェースを変更する方法について説明します。また、これらのコンポーネント・インタフェースにセキュリティを適用し、テストする方法についても説明します。

内容は次のとおりです。

コンポーネント・インタフェースを使用する前に、セキュリティを適用し、テストする必要があります。

コンポーネント・インタフェースのセキュリティ保護およびテスト後は、APIを生成する必要があります。詳細は、付録A「コンポーネント・インタフェースAPIの生成」を参照してください。


注意:

この項は、ユーザーに役立つ補足情報を提供することを目的としており、PeopleSoftドキュメントを代用するものではありません。PeopleSoftコンポーネント・インタフェースに関する完全情報および最新情報は、PeopleSoftシステムのPeopleSoftオンライン・ライブラリを参照してください。

この付録の内容は以下のとおりです。

プロパティの操作

コンポーネント・インタフェースは、PeopleSoftアプリケーション・デザイナを使用して作成します。アプリケーション・デザイナの詳細は、PeopleSoftドキュメントを参照してください。

プロパティはコンポーネント・ビューのレコードから追加できます。公開しないコンポーネント・インタフェース内のプロパティは削除できます。プロパティの名前変更は、プロパティをクリックし、再度クリックして新規の名前を入力して行います。プロパティ名を変更した場合、コンポーネント・インタフェースでは基になるコンポーネント名ではなく新規の名前で参照できます。

プロパティには様々なアイコンが付きます。たとえば、EMPLIDには、基になるレコードからのキー・レコードであることを示すアイコンが付きます。NAMEには、基になるレコードからの代替のキー・フィールドであることを示すアイコンが付きます。プロパティのアイコンの完全なリストは、PeopleBooksのドキュメントを参照してください。

新規コンポーネント・インタフェースの作成

コンポーネント・インタフェースを作成するには:

  1. PeopleSoftアプリケーション・デザイナを開きます。

  2. ファイルメニューから新規を選択します。

    図C-1に示すように、新規ダイアログが表示されます。

    図C-1 新規ダイアログ

    新規ダイアログ
    「図C-1 新規ダイアログ」の説明

    次のステップを実行します:

    1. コンポーネント・インタフェースを選択します。

    2. OKをクリックします。

      図C-2に示すように、コンポーネント・インタフェースのソース・コンポーネントの選択ダイアログが表示されます。

    図C-2 コンポーネント・インタフェースのソース・コンポーネントの選択ダイアログ

    ソース・コンポーネントを選択します。
    「図C-2 コンポーネント・インタフェースのソース・コンポーネントの選択ダイアログ」の説明

  3. コンポーネント・インタフェースの基礎として使用するコンポーネントを強調表示し、選択をクリックします。

    図C-3に示すように、アプリケーション・デザイナダイアログが表示されます。

    図C-3 アプリケーション・デザイナダイアログ

    アプリケーション・デザイナダイアログ・ボックス
    「図C-3 アプリケーション・デザイナダイアログ」の説明


    注意:

    コンポーネント・インタフェースが大きい場合は、コンポーネント・プロパティを手動で公開します。

  4. プロパティを表示しないでコンポーネント・インタフェースを作成し、コンポーネント・プロパティを手動で公開するには、いいえをクリックします。

    次のステップを実行します:

    1. 左ペインから関連フィールドを右ペインにドラッグします。

    2. 実行する様々なファンクションを選択するには、図C-4に示すように、右または左ペインのうち、いずれかアクティブなペインを右クリックします。

      ファンクションの全リストについては、PeopleBooksのドキュメントを参照してください。

  5. コンポーネント・インタフェースを作成し、基になるコンポーネント・インタフェースにのプロパティを表示するには、はいをクリックします。

    図C-4 アプリケーション・デザイナコンポーネント・インタフェース

    コンポーネント・インタフェース
    「図C-4 アプリケーション・デザイナ・コンポーネント・インタフェース」の説明

標準メソッド

コンポーネント・インタフェースの標準メソッドは、次のとおりです。

  • Create

  • Find

  • Get

  • Save

基になるコンポーネント内にあるメソッドのみを使用できます。たとえば、基になるコンポーネントにAdd機能が含まれていない場合、Createは使用できません。

使用可能なメソッドの表示または変更

使用可能なメソッドを表示または変更するには:

  1. 図C-5に示すように、コンポーネント・インタフェースのプロパティダイアログが表示されます。

    図C-5 コンポーネント・インタフェースのプロパティダイアログ

    コンポーネント・インタフェースのプロパティダイアログ・ボックス
    「図C-5 コンポーネント・インタフェースのプロパティダイアログ」の説明

  2. 標準メソッドタブをクリックします。

  3. 希望のメソッドを選択します。

コンポーネント・インタフェースのセキュリティ保護

コンポーネント・インタフェースのテストを開始する前に、セキュリティを設定する必要があります。

PeopleSoftバージョン8.1x用コンポーネント・インタフェースのセキュリティの構成

次の項で、2層および3層モードのPeopleSoftバージョン8.1用コンポーネント・インタフェース・セキュリティの構成方法について説明します。

コンポーネント・インタフェース・セキュリティを構成するには:

図C-6 コンポーネント・インタフェース・セキュリティ・オプション

コンポーネント・インタフェース・セキュリティダイアログ・ボックス
「図C-6 コンポーネント・インタフェース・セキュリティ・オプション」の説明

  1. 図C-6に示すように、使用メニューから、権限リストコンポーネント・インタフェースの順に選択し、更新/表示をクリックします。

    図C-7に示すように、権限リストダイアログが表示されます。

    図C-7 権限リストダイアログ

    権限リストダイアログ・ボックス
    「図C-7 権限リストダイアログ」の説明

    セキュリティを設定する前に、権限リストを確認する必要があります。

  2. 関連する権限リストを選択し、OKをクリックします。

    権限リストの詳細は、PeopleBooksのドキュメントを参照してください。

    図C-8に示すように、権限リストペインが表示されます。

    図C-8 権限リストペイン

    権限リスト
    「図C-8 権限リスト」ペイン」の説明

  3. 作成した新規コンポーネント・インタフェースを挿入します。

  4. 編集をクリックします。

    コンポーネント・インタフェースを選択すると、ユーザー定義メソッドを含む、すべての使用可能なメソッドが表示されます。この特定の権限リストに完全アクセスまたは部分的なアクセスが含まれるようにする必要があるかを指定できます。

    図C-9に示すように、「ALLPORTL」権限リストではすべてのメソッドに対して完全アクセスがあります。

    図C-9 「ALLPORTL」権限リスト

    「ALLPORTL」権限リスト
    「図C-9 「ALLPORTL」権限リスト」の説明

  5. 希望のアクセス・レベルを選択します。

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

PeopleSoftバージョン8.4以降用コンポーネント・インタフェースのセキュリティの構成

次の項で、PeopleSoftバージョン8.4以降用コンポーネント・インタフェース・セキュリティの構成方法について説明します。

インタフェース・セキュリティを構成するには:

図C-10 コンポーネント・インタフェース・セキュリティの構成

コンポーネント・インタフェース・セキュリティ
「図C-10 コンポーネント・インタフェース・セキュリティの構成」の説明

  1. 図C-10に示すように、PeopleToolsセキュリティユーザー・プロファイル権限とロールの順に展開し、権限リストをクリックします。

  2. 検索をクリックします。

    権限リストの検索ペインが表示されます。

  3. 図C-11に示すように、関連する権限リストを選択します。

    図C-11 権限リストペイン

    権限リストペイン
    「図C-11 権限リストペイン」の説明

  4. サインオン回数タブの横の右矢印をクリックします。

    図C-12に示すように、コンポーネント・インタフェースタブが表示されます。

    図C-12 コンポーネント・インタフェースタブ

    コンポーネント・インタフェースタブ
    「図C-12 コンポーネント・インタフェースタブ」の説明

  5. コンポーネント・インタフェースタブをクリックします。

  6. コンポーネント・インタフェースリストに新規の行を追加するには、「+」をクリックします。

    図C-13に示すように、表示されるフィールドにコンポーネント・インタフェースの名前を入力します。

    図C-13 コンポーネント・インタフェースの名前フィールド

    コンポーネント・インタフェースの名前フィールド
    「図C-13 コンポーネント・インタフェースの名前フィールド」の説明

  7. コンポーネント・インタフェースの名前を入力し、編集をクリックします。

    図C-14に示すように、この例ではコンポーネント・インタフェース「AR_ITEM_AGENT」を使用しています。

    図C-14 コンポーネント・インタフェースの権限ウィンドウ

    「AR_ITEM_AGENT」コンポーネント・インタフェース
    「図C-14 コンポーネント・インタフェースの権限ウィンドウ」の説明

  8. リストから、各メソッドの希望のアクセス・レベルを選択します。

  9. OKをクリックします。

    図C-15に示すように、権限リストウィンドウが表示されます。

    図C-15 権限リストウィンドウ

    アクセス・レベル
    「図C-15 権限リストウィンドウ」の説明

  10. 右ペインで下へスクロールし、保存をクリックします。

コンポーネント・インタフェースのテスト

Oracle Application Adapter for PeopleSoftでは、PeopleSoftメタデータおよびコンポーネント・インタフェースが使用されるため、新規または変更されたコンポーネント・インタフェースに対応できます。アダプタでは、論理的および有効であること以外に、コンポーネント・インタフェースに関する想定は行われません。各コンポーネント・インタフェースは、アダプタのソースとして使用される前にテストされる必要があります。

ユーザーまたはPeopleSoftのアップグレードによって、基になるアプリケーションが変更され、それによりコンポーネント・インタフェースが無効になった場合、アダプタによって使用される前に無効なコンポーネント・インタフェースを修復する必要があります。

コンポーネント・インタフェースをテストするには:

  1. アプリケーション・デザイナで、ツールメニューからコンポーネント・インタフェースのテストを選択します。

    図C-16に示すように、コンポーネント・インタフェースのテスターダイアログが表示されます。

    図C-16 コンポーネント・インタフェースのテスターダイアログ

    コンポーネント・インタフェースのテスターダイアログ・ボックス
    「図C-16 コンポーネント・インタフェースのテスターダイアログ」の説明

  2. 必要に応じて、コンポーネント・インタフェースのテスターダイアログをクリックして、前面に出します。

  3. 次のいずれかのメソッドを使用して、コンポーネント・インタフェースをテストします。

    • Findメソッドを使用してコンポーネント・インタフェースをテストするには、「Find」をクリックします。

      図C-17に示すように、基になるコンポーネントに該当するすべてのエントリがコンポーネント・インタフェースのテスター - 検索結果ダイアログに表示されます。エントリ数が30を超える場合はメッセージが表示されます。

      図C-17 コンポーネント・インタフェースのテスター - 検索結果ダイアログ

      コンポーネント・インタフェースのテスター - 検索結果ダイアログ・ボックス
      「図C-17 コンポーネント・インタフェースのテスター - 検索結果ダイアログ」の説明

    • 検索結果ダイアログの左ペインで、フィールドを1つ選択します。

    • この特定のフィールドに関連するデータを表示するには、選択したアイテムを取得をクリックします。

      図C-18に示すように、検索結果ダイアログが表示されます。

      図C-18 検索結果ダイアログ

      結果の変更
      「図C-18 検索結果ダイアログ」の説明

    • セキュリティ設定で許可されている場合、各フィールドの値を変更できます。

  4. Getメソッドを使用してコンポーネント・インタフェースをテストするには、次のステップを実行します:

    1. 既存のキーを入力します(1つまたは複数)。

    2. 既存アイテムの取得をクリックします。

      入力したキーの公開済プロパティが表示されます。更新アクセスが指定されている場合、値を変更できます。

    または、図C-19に示すように、Createメソッドを使用してもテストできます。

    図C-19 「コンポーネント・インタフェースのテスター」ダイアログ

    Createメソッド
    「図C-19 コンポーネント・インタフェースのテスターダイアログ」の説明

    次のステップを実行します:

    1. すべての必要なキー値を入力します。

    2. 新規作成をクリックします。

      Createキーに有効な値を入力すると、図C-20に示すように、表の名前およびデフォルト値をの展開後、ペインにJOBCODEデータが表示されます。

      図C-20 JOBCODEデータ

      JOBCODEデータ
      「図C-20 JOBCODEデータ」の説明

      この時点でフィールドを変更できます。変更内容はコンポーネントの基になるビジネス・ロジックに対して検証されます。

    3. 変更が完了したら、ペインの最上部のアイテムを右クリックします。

  5. 変更内容を保存するには、保存をクリックします。

    レコードの作成に使用されたキーは、Getメソッドとともにデータの表示に使用できます。次の例に示すように、追加されたデータは、PeopleSoftコンポーネントで表示できます。有効日はデフォルト値の1つです。

これで、コンポーネント・インタフェースのテストが完了しました。コンポーネント・インタフェースを使用する前に、APIを生成する必要があります。詳細は、付録A「コンポーネント・インタフェースAPIの生成」を参照してください。