18.1 データ・ロード機能によるアプリケーションの作成

エンド・ユーザーがアクセスできる任意のスキーマ内にある表にデータを動的にインポートできる、データ・ロード機能を持つアプリケーションを作成します。

データをインポートするには、エンド・ユーザーは、ファイルからデータをアップロードするか、エンド・ユーザーがウィザードに直接入力したデータをコピー・アンド・ペーストするデータ・ロード・ウィザードを実行します。

• データ・ロード・ウィザードの作成について
  
• データ・ロード・ウィザードの作成
  
• データ・ロード・ページの再作成
  
• データ・ロード定義の編集
  

関連項目:

Oracle Application Expressエンド・ユーザー・ガイドの「データ・ロード・ウィザードの例」(データ・ロード・ウィザードの使用の詳細)

18.1.1 データ・ロード・ウィザードの作成について

データ・ロード・ウィザードを作成するには、アプリケーション開発者がページの作成ウィザードでデータ・ロード・ページを作成します。データ・ロード・ウィザードの作成プロセスで、開発者はアップロード表とその一意の列、表参照およびデータ・トランスフォーメーション・ルールを指定できます。

注意:

データ・ロード・ウィザードは、何十万ものデータ行をロードするようには設計されていません。データ・ロード・ウィザードを使用してこの大量のデータをロードすることは可能ですが、大量のデータ・ファイルの転送およびロードの両方でパフォーマンスの問題が発生する可能性があります。Oracle SQL DeveloperおよびOracle SQL*Loaderのようなツールの方が、大量のデータのロードに適しています。

データ・ロード・ウィザードの実装には、次のサポートが含まれます。

• 表の定義: この定義は、一意のキー列を持つデータ・アップロード表の名前を指定します。

• データ・トランスフォーメーション・ルール - インポート・データを大文字や小文字に変更するといったトランスフォーメーションのフォーマットを行うために、データ・トランスフォーメーション・ルールを定義する必要があります。たとえば、インポート・ファイルに大文字と小文字の両方の列データが含まれ、アップロード表ではすべて大文字であることが必要な場合、大文字のみをターゲット列に挿入するようにデータ・トランスフォーメーション・ルールを定義できます。

• 表参照 - インポート・ファイルの既存データを別の表のデータにマッピングする必要がある場合、表参照を指定してマッピングを実行します。たとえば、インポート・ファイルにはDEPTNO列に部門名が含まれているが、アップロード表ではその列に数値が必要な場合、表参照ルールを使用して、別の表でその部門名に対応する部門番号を探します。

• 列名の別名 - 開発者がエンド・ユーザーに表の列名を公開したり、エンド・ユーザーにすべての列を公開することを望まない状況が数多くあります。このような状況では、公開する必要がある列の別名を作成できます。

• 同時実行性の管理 - 複数のユーザーが同時にデータをアップロードする場合、開発者は追加の列を使用して、基礎となる表のデータ・バージョンを追跡できます。データ・ロード・ウィザードでは、この列を使用して、別のユーザーが同時に同じデータを使用しているかどうかを確認し、エンド・ユーザーに伝えます。これは、定期的に更新される表にアップロードする場合に特に重要です。

• 複数のスプレッドシート列 - アップロードされるスプレッドシートに複数の列があり、開発者がその列を連結して1つの表の列にアップロードすることが必要な状況が数多くあります(スプレッドシートのFirstNameおよびLastNameをEMP表のENAMEにアップロードするなど)。

• 検証のスキップ - 検証ステップをスキップすることで、大量のレコードをアップロードする際のデータ・ロードのパフォーマンスを向上できます。何千ものレコードをアップロードする場合、エンド・ユーザーは、各レコードの検証に関心がないことがあります。各レコードが新規レコードとして挿入されることが確実な場合は、データ・ロード・プロセスで重複をチェックする必要はありません。

新たに生成されたデータ・ロード・ウィザードは4つのページで構成され、ユーザーはファイルからの、またはコピー・アンド・ペーストによるデータのアップロード、データおよび表のマッピングの定義、データの検証、および最終的な表へのデータのアップロードを行うことができます。開発者は後で、「共有コンポーネント」、「データ参照」、「データ・ロード定義」にアクセスして、表参照やデータ・トランスフォーメーション・ルールなどのデータ・ロード・ウィザードの定義を編集できます。

サポートされるデータ型

データ・ロード・ウィザードは、次のデータ型をサポートしています。

• VARCHAR2

• DATE

• TIMESTAMP

• NUMBER

サポートされないデータ型

データ・ロード・ウィザードは、次のデータ型をサポートしません。

• ラージ・オブジェクト(BLOBおよびCLOB)

• 複合型(XMLTYPEおよびSDO_GEOMETRY)

• CHAR

関連項目:

• 「データ・ロード・ウィザードの作成」

• 「データ・ロード定義の編集」

18.1.2 データ・ロード・ウィザードの作成

データ・ロード・ウィザードを作成するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
2. アプリケーションを選択します。
3. 「ページの作成」をクリックします。
4. 「ページの作成」で、次のステップを実行します。
   1. ユーザー・インタフェース: ページのユーザー・インタフェースを選択します(オプション)。
      この属性は、古いテーマを使用し、デスクトップおよびモバイル・ユーザー・インタフェースが定義されているアプリケーションに対してのみ表示されます。
   2. ページ・タイプ: 「コンポーネント」→「データのロード」を選択します。

      ヒント:

      コンポーネント・ページは、ページ・レベルの機能を提供し、指定されたアプリケーション内でレポート、フォーム、チャート、カレンダなどを複数回追加できます。機能ページは、アプリケーション・レベルの機能を提供し、アプリケーションごとに1回のみ追加できます。

5. 「データ・ロード表」で、次のステップを実行します。
   1. データ・ロード定義: 新規に作成するか、既存のデータ・ロード定義を再利用するかを選択します。
   2. 定義名 - このデータ・ロード定義の名前を入力します。
   3. 所有者: フォームの基になる表の所有者を選択します。
   4. 表名: データのロードに使用する表を選択します(アップロード表とも呼ばれます)。
   5. 一意列1: データ・ロードの処理で一意の主キー列として使用する列名を指定します。最大3個の一意キー列を定義できます。
   6. 大/小文字区別 - 選択した一意キー列で大/小文字を区別するかどうかを指定します。デフォルトでは、これは「いいえ」に設定されます。
   7. 追加の一意列を定義します。最大3個の一意キー列を定義できます。
   8. 「次へ」をクリックします。
6. トランスフォーメーション・ルールの追加(オプション)で、次を指定して「追加」をクリックします。
   1. トランスフォーメーション・ルールを作成するための列の選択: トランスフォーメーション・ルール定義の基になる列を選択し、右に移動します。
   2. ルール名: このトランスフォーメーション・ルールの名前を入力します。
   3. 順序: トランスフォーメーション・ルールの順序を指定します。これによって実行の順序が決まります。
   4. タイプ: 実行するトランスフォーメーション・ルールのタイプを選択します。
   5. 選択したトランスフォーメーション・タイプに基づいて追加の詳細を指定します。
   6. 「トランスフォーメーションの追加」をクリックします。
   7. 「次へ」をクリックします。
7. 「表参照」で、次のステップを実行します。
   1. 列の新規表参照の追加(オプション): 表参照定義の基になる列を指定します。
   2. 参照表の所有者 - 参照表の所有者を選択します。
   3. 参照表名 - この表参照定義に使用される表を指定します。
   4. 戻り列: 表参照で戻される列の名前を選択します。この値は、指定されたロード列に挿入されるもので、通常、外部キー・リレーションシップの親のキー値です(例: DEPTNO)。
   5. アップロード列 - エンド・ユーザーによって戻り列のかわりにアップロードされる列の名前を選択します。これは、参照表の表示値を含む列です(例: DNAME)。
   6. アップロード列2: 必要に応じて、戻り列を一意に識別するためにアップロードされる2番目の列の名前を選択します。たとえば、州コードを一意に識別するには、州名および国をアップロードする必要がある場合があります。
   7. アップロード列3: 戻り列を一意に識別するためにアップロードされる3番目の列の名前を選択します。
   8. 「参照の追加」をクリックして参照定義を追加します。さらに表参照を追加するには、前の手順を繰り返します。 
   9. 「次へ」をクリックして、参照の作成を終了します。
8. 「ページ属性」で、次のステップを実行します。
   1. ページ名: 各ステップのページ名を入力します。
   2. ページ番号: 各ステップのページ番号を入力します。
   3. ページ・モード - ページ・モードを指定します。詳細は、フィールドレベル・ヘルプを参照してください。
   4. ブレッドクラム - ページでブレッドクラム・ナビゲーション・コントロールを使用するかどうか、およびどのブレッドクラム・ナビゲーション・コントロールを使用するかを選択します。
   5. 「次へ」をクリックします。
9. 「ナビゲーション・メニュー」で、次のステップを実行します。
   1. ナビゲーションのプリファレンス: このページをどのようにナビゲーション・メニューに統合するかを選択します。詳細は、フィールドレベル・ヘルプを参照してください。
   2. 「次へ」をクリックします。
10. 「ボタンとブランチ」で、データ・ロード・ウィザードのページのボタンに使用するブランチを指定します。
    1. 新規ボタン・ラベル: 「次へ」ボタンに表示するテキストを入力します。
    2. 「戻る」ボタン・ラベル: 「前」ボタンに表示するテキストを入力します。
    3. 「取消」ボタン・ラベル: 「取消」ボタンに表示するテキストを入力します。
    4. 「取消」ボタンでブランチするページ - ユーザーが「取消」をクリックしたときの、ブランチ先のページ番号を指定します。
    5. 「終了」ボタン・ラベル - 「送信」ボタンに表示するテキストを入力します。
    6. ページへの「終了」ボタン・ブランチ: ブランチ先のページの番号を指定します。アプリケーション内の同じページまたは他のいずれのページにもブランチできます。
    7. 「作成」をクリックします。
11. 「ページの保存と実行」をクリックして、データ・ロード・ウィザードをテストします。

ヒント:

データ・ロード・ウィザード・ページの作成後、変更が必要な場合は、次の項で説明するように、データ・ロード定義を削除するのではなく、新規ページを再作成することをお薦めします。

関連項目:

• データ・ロード・ページの再作成

• ページ・デザイナでのページの編集

18.1.3 データ・ロード・ページの再作成

データ・ロード・ウィザード・ページの変更が必要な場合は、データ・ロード定義を削除しないで、新規ページを再作成することをお薦めします。

データ・ロード定義を削除しないでデータ・ロード・ウィザード・ページを再作成するには、次のステップを実行します。

1. データ・ロード定義ページにナビゲートします。
   1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。
   2. アプリケーションを選択します。
   3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

      共有コンポーネント・ページが表示されます。

   4. 「データ参照」で、「データ・ロード定義」をクリックします。
2. 再作成するデータ・ロード定義をクリックします。

   データ・ロード表の詳細ページが表示されます。

3. 「タスク」で、「データ・ロード・ページの再作成」をクリックします。

   「データ・ロード・ウィザードの作成」のページ属性ページが表示されます。

4. ページごとに、該当する属性を編集し、「次へ」をクリックします。

   属性の詳細は、フィールドレベル・ヘルプを参照してください。

5. 「確認」をクリックします。

18.1.4 データ・ロード定義の編集

データ・ロード定義は、アプリケーションのデータ・ロード・ウィザードで使用されるデータ・ロード表、表ルールおよび参照表で構成されます。データ・ロード表は、データをアップロードするデータ・ロード・プロセスで使用するために選択された、スキーマ内の既存の表です。

データ・ロード定義を編集するには、次のステップを実行します。

1. データ・ロード定義ページにナビゲートします。
   1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。
   2. アプリケーションを選択します。
   3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

      共有コンポーネント・ページが表示されます。

   4. 「データ参照」で、「データ・ロード定義」をクリックします。
2. 編集するデータ・ロード定義をクリックします。

   データ・ロード表の詳細ページが表示されます。属性の詳細は、フィールドレベル・ヘルプを参照してください。

3. 「データ・ロード定義」で、次のように入力します。

   • 名前 - データ・ロード定義の名前。

   • データ・ロード表: データ・ロード表名を編集し、一意の列を追加、削除または編集します。

   • 一意列1 - データ・ロードの処理で一意の主キー列として使用する列名。

   • 大/小文字区別 - 選択した一意キー列1で大/小文字を区別するかどうかを指定します。デフォルトでは、これは「いいえ」に設定されます。

   • 一意列2 - 選択した表の一意キーの定義が、2つ以上の列から構成される複合キーの場合、この列名が、データ・ロードの処理中に2番目の一意キーの列として使用されます。

   • 大/小文字区別 - 選択した一意キー列2で大/小文字を区別するかどうかを指定します。デフォルトでは、これは「いいえ」に設定されます。

   • 一意列3 - 選択した表の一意キーの定義が、2つ以上の列から構成される複合キーの場合、この列名が、データ・ロードの処理中に3番目の一意キーの列として使用されます。

   • 大/小文字区別 - 選択した一意キー列3で大/小文字を区別するかどうかを指定します。デフォルトでは、これは「いいえ」に設定されます。

   • 検証のスキップ - データ・ロードのステップの1つとして、アップロード対象のレコードに実行されるアクションを検証します。検証をスキップするには、「はい」を選択します。

4. 「トランスフォーメーション・ルール」には、以前定義したトランスフォーメーション・ルールがリストされます。

   • 新規ルールを作成する手順は、次のとおりです。

     1. 「トランスフォーメーション・ルールの作成」をクリックします。

     2. 属性を編集します。

        属性の詳細は、フィールドレベル・ヘルプを参照してください。

     3. 「作成」をクリックします。

   • 既存のルールを編集する手順は、次のとおりです。

     1. ルール名をクリックします。

     2. 属性を編集します。

     3. 「変更の適用」をクリックします。

5. 表参照では、インポート・ファイルのデータを別の表にあるデータにマッピングします。

   • 表参照を新規作成するには、次のステップを実行します。

     1. 「表参照の作成」をクリックします。

     2. 属性を編集します。

     3. 「作成」をクリックします。

   • 既存の表参照を編集するには、次のステップを実行します。

     1. 列名をクリックします。

     2. 属性を編集します。

     3. 「変更の適用」をクリックします。

6. 列名の別名では、別名を定義して、ユーザーがアップロードする列を正しく識別できるようにします。

   列名の別名を追加するには、次のステップを実行します。

   1. 「LOVの編集」をクリックします。

   2. 属性を編集します。

   3. 「作成」をクリックします。

7. 「同時実行性列名」で、同時実効性管理に使用する列を選択します。

   同時実行性により、開発者は、基礎となる表のデータ・バージョンを確認するための列を選択できます。これは、定期的に更新される表にアップロードする場合に特に重要です。

8. 「変更の適用」をクリックします。