添付ファイルの設定

アプリケーション処理フローへの添付ファイルの追加

次に、PeopleSoft アプリケーションで使用するために添付ファイルを定義するステップを示します。

1. 添付ファイル承認 ID の定義

   添付ファイルの編集または表示に必要な承認レベル アクセスを指定します。

2. 承認エントリ ID の定義

   添付ファイル オブジェクト タイプの添付ファイル、メモ、または URL を指定し、添付ファイルにアクセスできるユーザー ロールを指定します。承認 ID をロールに割り当てることによって、各ユーザー ロールのアクセス レベルを指定します。

3. 添付ファイル設定 ID の定義

   共通添付ファイル、URL、またはドキュメント定義、および添付ファイルを表示できるロールを追加します。

4. キーの設定

   添付ファイルをコンテキスト内のアプリケーションに統合します。添付ファイルの定義後、これらを任意の PeopleSoft アプリケーションに統合でき、コンテキストは、フレームワークを使用する製品によって異なります。キーの設定ページを使用すると、必須の各適用条件にマップするアプリケーション データ フィールドを定義できます。

   1. 適用条件の設定

      適用条件には、関連アプリケーションのフィールドに対応する値がロードされます。コンテキスト バリエーションを定義するには、アプリケーション フレームワークを使用して、アプリケーションに基づいてコンテキストのキー プロンプト テーブルまたはビューおよびキー プロンプト フィールドを定義します。これらのキーは、任意の数のテーブルから取得でき、異なる環境で使用できる代替設定 ID を指定するために、アプリケーション レベルのデータ構造にレコード キーとして定義される汎用文字フィールドとして実装されます。

   2. 保存キーの設定

      ドキュメント定義である添付ファイル設定 ID に対して、ドキュメント定義を起動するための保存レコードを作成し、ユーザーが追加した添付ファイルをアプリケーション データの特定の行に保存する必要があります。

      添付ファイルが属しているデータの行を区別するためには、ドキュメント定義に対して保存キーを定義します。各アプリケーションでは、使用するキーの数を 1 から N まで決定し、アプリケーション デザイナではそのアプリケーション独自のレコードと、添付ファイルに関連する共通フィールドを格納するためのサブ レコードを作成できます。作成された保存レコードは、キー フィールド定義を自動的に取得して保存キー ラベルを選択するために、オブジェクト オーナー ID と サブ ID に関連付ける必要があります。

      保存レコードの作成後、それをオブジェクト オーナー ID および添付ファイル サブ ID に関連付け、フィールド ラベルを選択します。保存レコード定義の名前の入力時に、キー フィールドは、レコードに定義されたキー位置によって正しい順序で自動的に取得されます。

5. 定義の管理

   定義済みの適用条件に基づいて、有効な設定 ID のリストが取得されます。さらに、定義 ID と有効日を使用して、データベースから添付ファイルが選択されます。

6. 添付ファイル フレームワークの実装

   添付ファイル フレームワークを実装するには、PeopleSoft に用意されている HR_ATTACHMENTS アプリケーション パッケージのアプリケーション クラス メソッドを使用します。標準のアプリケーション パッケージには 2 つのクラスがあります。Attachment_Data アプリケーション クラスを使用すると、全てのリンク ラベル、全ての設定 ID、および定義済みの添付ファイルへのリンクを含む全てのグループ ボックスに対するエントリを含むオブジェクトを作成できます。Attachment_UI アプリケーション クラスを使用すると、添付ファイルのユーザー インターフェイスを管理できます。

『PeopleTools: PeopleCode Developer's Guide』 および 『PeopleTools: PeopleCode API Reference』を参照してください。

承認オプション

削除オプション

ユーザーが既存の添付ファイル、メモ、または URL を削除した際のシステムの処理を決定するオプションを選択します。[削除済としてマーク] を選択すると、オブジェクトは添付ファイルとして引き続き表示されますが、オブジェクトのステータスは[削除済] となり、選択できません。このオプションを使用すると、削除した添付ファイルを追跡できます。[データベースから削除] を選択すると、オブジェクトはデータベースから完全に削除されます。

承認の定義

[承認の定義] リージョンのフィールドを使用して、ロールを添付ファイル承認 ID に関連付けることによってロールが実行できる操作を指定します。ロール名を選択し、各行で有効な承認 ID を選択します。各ロールに割り当てることができる承認 ID は 1 つのみですが、複数のロールで同じ承認 ID を共有できます。

承認済ロール

添付ファイルまたは URL へのアクセス権を付与するロールを入力します。ロールが選択されていない場合は、使用可能な全てのロールがリンクを表示できます。このリージョンは、[添付ファイル タイプ] が [添付ファイル] または [URL] の場合にのみ表示されます。

ドキュメント定義

ユーザーが添付ファイルとしてアップロードできる定義済承認エントリのリストを入力します。[ドキュメント定義] リージョンは、[添付ファイル タイプ] が [ドキュメント定義] の場合にのみ表示されます。

関連フィールド

[関連フィールド] タブをクリックして、キー プロンプト テーブルおよびキー プロンプト フィールドに関連するフィールドを行ごとに選択します。

添付ファイル

Attachment_Data アプリケーション クラス GetAttachmentLink メソッド

GetAttachmentLink メソッドは、有効日とコンテキスト キーの配列を使用してデータベースから設定 ID を取得します。次に、これらのエントリは、ロール名でさらにフィルタするためにスタンドアロン行セットにロードされます。

GetAttachmentLink メソッドは次のパラメータを受け入れます。

メソッドによって、リンク ラベル、設定 ID、および現在のユーザーがアクセスできるグループ ボックスの全てに対するエントリを含む配列オブジェクトが返されます。

現在のユーザーのロールを検出または取得するオプションは、&Roles、%Component、または %UserID に渡される値に応じて 2 つあります。

1. システムでは、フィルタを実行するために、%UserId および %Component 変数を使用して各コンテンツ参照とユーザー ID に対する有効なロール名が全て検出されます。

2. &Roles の文字列の配列を使用すると、配列内のロール名のみがフィルタに考慮されます。

Attachment_Data アプリケーション クラス SameAttachmentSetup メソッド

SameAttachmentSetup メソッドは次のパラメータを受け入れます。

メソッドによってブール値 (True/False) が返されます。

システムでは、&EfftDt および &cKeys が使用され、現在のコンテキスト キーの値を使用して、設定 ID が取得されます。システムでは、&EfftDt および &oKeys が使用され、コンポーネントが前回保存されたときのコンテキスト キーの値を使用して設定 ID が取得されます。%UserId および %Component システム変数を使用すると、フィルタを実行するために各コンテンツ参照とユーザー ID に対する有効なロール名が全て検出されます。&Roles の文字列の配列を使用すると、配列内のロール名のみがフィルタに考慮されます。次に、これらのエントリは、比較のために配列にロードされます。現在の設定 ID が以前の設定 ID と同じである場合、メソッドは値 True を返します。戻り値が True の場合、この機能を実装する予定の製品では、無効な添付ファイルを削除するかまたはデータベースに残すかを選択できます。

Attachment_UI アプリケーション クラス Attachment_UI (コンストラクタ) メソッド

このメソッドに含まれるステートメントは、クラスの初期化を提供し、Attachment_UI クラスの新規オブジェクトのインスタンスを作成します。

Attachment_UI (コンストラクタ) メソッドは次のパラメータを受け入れます。

戻りパラメータは使用できません。

Attachment_UI アプリケーション クラス GetAttachmentType メソッド

設定 ID および有効日は、添付ファイル設定テーブルから添付ファイル タイプを取得するために使用されます。

GetAttachmentType メソッドは次のパラメータを受け入れます。

メソッドによって、添付ファイル タイプが次のいずれかの文字列値で返されます。

• URL 添付ファイル タイプの場合は <001> です。

• ATTACHMENT 添付ファイル タイプの場合は <002> です。

• DOCUMENT DEFINITION 添付ファイル タイプの場合は <003> です。

Attachment_UI アプリケーション クラス OpenAttachment メソッド

システムでは、設定 ID 値 (&hCnfgID) と有効日 (&hEffDt) が使用され、GetAttachmentType メソッドを使用して PS_HR_ATT_CNFG_TBL から添付ファイル タイプが取得されます。添付ファイル タイプが[添付ファイル] または [URL] の場合は、指定した添付ファイルまたは URL が新しいウィンドウで開きます。それ以外の場合、ユーザーは添付ファイル ユーザー インターフェイス – (コンポーネント: HR_ATT_DD) に移動します。ユーザーがコンポーネントを開くことができるように、対応する保存キー レコードおよび保存キー フィールド ラベルが定義されていることを確認します。

OpenAttachment メソッドは次のパラメータを受け入れます。

メソッドによって、正常に追加された添付ファイル レコードの数を示す数値が返されます。

Attachment_UI アプリケーション クラス DelAttachments メソッド

DelAttachments メソッドは次のパラメータを受け入れます。

メソッドによって、ハイパーリンク ラベル、設定 ID、および現在のユーザーがアクセスできるグループ ボックスの全てに対するエントリを含む配列が返されます。

Attachment_UI アプリケーション クラス ExistAttachments メソッド

ExistAttachments メソッドは次のパラメータを受け入れます。

メソッドによってブール値 (True/False) が返されます。

標準のテキスト カタログ エントリ

添付ファイルの標準テキスト カタログ エントリを表示するには、次の手順に従います。

1. テキスト カタログの更新ページに移動します。select ([HCM 基本設定], then select [共通定義], then select [テキスト カタログとノートパッド], then select [テキスト カタログの更新])

2. [オブジェクト オーナー ID] フィールドに HHR、[サブ ID] フィールドに ATT と入力します。

3. [検索] をクリックして、添付ファイルのテキスト カタログのリストを表示します。