Oracle Database 9.2以上がインストールされ、データベースにOracle Spatialが構成されていること。

Oracle Application Express 3.1がダウンロードおよび構成されていること。

ここからOEHR Sample Objectsパッケージ・アプリケーションをダウンロードして、Oracle Application Express 3.1インスタンスにインポートしていること。

このチュートリアルを実行するために必要なファイルを含むapexnf.zipファイルをダウンロードおよび解凍していること。

このチュートリアルの前に、『Oracle Application Express 3.1のインタラクティブ・レポートの構築およびカスタマイズ』および『Oracle Application Express 3.1のBLOBデータの定義および表示』チュートリアルを実行する必要があります。

または、Oracle Application Expressのパッケージ・アプリケーションとして、Oracle by Example（OBE）のNew Featuresアプリケーションをインポートできます。 apexnf.zipファイルをダウンロードおよび解凍して、blobobe_packagedapp.sqlパッケージ・アプリケーション・ファイルをインポートしてください。 また、OEHR_EMPLOYEES表を変更して、BLOBデータをロードする必要があります。 PHOTO_LOCディレクトリを作成してファイルを配置するために、dog.gifファイルが格納された場所のパスを指定するようaddblobdata.sqlスクリプトを変更します。スクリプト・ファイルをダウンロードおよび解凍した場所から、SQL*Plusセッションを開いて、次のコマンドを実行します。

connect system
grant create any directory to <workspace name>;

connect <workspace name>
@addblobdata

New Featuresアプリケーション・ページへ移動します。 「Create Page」をクリックします。

「Blank Page」をクリックします。

「Next」をクリックします。

NameにSend Email Attachmentと入力して、「Next」をクリックします。

デフォルト値を受け入れて、「Next」をクリックします。

「Finish」をクリックします。

ページが作成されました。 次に、リージョンを追加する必要があります。 「Edit Page」をクリックします。

Regionsの下のCreateアイコン「」をクリックします。

「HTML」アイコンをクリックします。

「HTML」アイコンを再度クリックします。

TitleにEmail Attachmentと入力して、「Create」をクリックします。

ページとリージョンが作成されました。 次の項では、添付ファイルのある電子メールを送信するために、入力する必要があるアイテムを作成します。

Itemsの下のCreateアイコン「」をクリックします。

複数のアイテムを作成する必要があるので、「Create Multiple Items using Drag and Drop Layout」リンクを選択します。

「Create Multiple Items >」をクリックします。

Textアイコン「」を選択して、最初の行にドラッグ・アンド・ドロップします。 Item NameにP<#>_EMAIL、LabelにEmail Addressと入力します。

2行目にTextアイコン「」をドラッグ・アンド・ドロップします。 Item NameにP<#>_FROM、LabelにFromと入力します。

次のように残りのアイテムを作成して、「Next」をクリックします。

「Apply Changes」をクリックします。

「P<#>_IMAGE」リンクを選択します。

「LOV」タブを選択します。

添付ファイルとして選択し、電子メールで送信する従業員の画像リストを設定します。 次のLOVの定義を入力して、「Apply Changes」をクリックします。 注：画像列の長さが0ではないということを以下のコードで確認します。該当する場合、画像列からBLOBが選択されます。

select filename||'</br>'||
       decode(nvl(dbms_lob.getlength(photo),0),0,null,
              '<img src="'||apex_util.get_blob_file_src('P3_PHOTO',employee_id)
                ||'" height="128" width="128" />') img,
       employee_id r
 from oehr_employees 
where mimetype like 'image%' 
order by 1

すべてのアイテムが定義されました。 次の項では、添付ファイルのある電子メールを受信者に送信するボタンとプロセスを作成します。

Buttonsの下の「Create」アイコンをクリックします。

デフォルト値を受け入れて、「Next」をクリックします。

「Create a button displayed among this region's items」を選択し、「Next」をクリックします。

名前にP<#>_SEND_EMAIL、LabelにSend Email、RequestにEMAILと入力します。 Button Styleに「HTML Button」を選択して、「Create Button」をクリックします。

ボタンが作成されました。 これによって、ボタンを押すと起動するプロセスを作成できます。 Page ProcessingのProcessesで「Create」アイコンをクリックします。

「PL/SQL」プロセス・カテゴリをクリックします。

NameにEMAIL with Attachmentsと入力して、「Next」をクリックします。

PL/SQL Page Processリージョンに次のコードを入力します。 注：現在ページ4で作業していない場合、4から現在のページ番号に変更してください。 たとえば、ページ5で作業している場合、P4_IMAGEをP5_IMAGEに変更します。 次に、「Next」をクリックします。

DECLARE
    l_id number;
    l_index number;
    l_vc_arr2    APEX_APPLICATION_GLOBAL.VC_ARR2;
BEGIN
  l_id := APEX_MAIL.SEND( 
             p_to => :P4_EMAIL, 
             p_from => :P4_FROM, 
             p_subj => :P4_SUBJECT, 
             p_body => :P4_BODY);
  l_vc_arr2 := APEX_UTIL.STRING_TO_TABLE(:P4_IMAGE);
  FOR i_index IN 1..l_vc_arr2.count LOOP 
    FOR c1 in  (select filename, photo, mimetype from oehr_employees 
      where employee_id = l_vc_arr2(i_index)) loop
      APEX_MAIL.ADD_ATTACHMENT( p_mail_id    => l_id,
                                p_attachment => c1.photo,
                                p_filename   => c1.filename,
                                p_mime_type  => c1.mimetype);
    END LOOP c1;
  END LOOP i_index;
  COMMIT;
END; 

このプロセスのPL/SQLコードでは、既存の機能であるAPEX_MAIL.SENDを使用して、メインの電子メールを作成します。ただし、添付ファイルのある電子メールに関連したIDを取得することになります。 コロン区切りの文字列として、:P4_IMAGESに格納されている選択したイメージのIDが、組込みのAPEX_UTIL.STRING_TO_TABLEによって文字列から表に変換され、この表が配列にロードされます。 元表（OEHR_EMPLOYEES）から選択した各イメージの詳細情報を取得します。1つずつ新しいプロシージャ（APEX_MAIL.ADD_ATTACHMENT）が実行され、選択したイメージが元の電子メールに添付されます。

注：ここではテキスト本文を使用しています。テキストが書式化されたHTMLの場合、p_body_htmlを使用して送信します。

Success MessageとFailure Messageを入力して、「Next」をクリックします。

When Button Pressedに「P4_SEND_EMAIL」を選択して、「Create Process」をクリックします。

また、プロセスの完了時に成功メッセージを含むようブランチを変更する必要があります。 デフォルトではこのオプションは選択されていません。 Branchesの下の「Go to Page」リンクを選択します。

「include process success message」チェック・ボックスを選択して、「Apply Changes」をクリックします。

ブランチが正しく変更されました。 次の項では、ページを実行してテストします。 『Oracle Application Express 3.1のBLOBデータの定義および表示』チュートリアルでデータベースに1つの画像だけを追加したので、Send Emailページをテストする前に別の画像を追加します。 Maintain Employee Informationのページ番号（ほとんどの場合2）を選択して、「Go」をクリックします。

「Run」をクリックして、このページを実行します。

別の従業員の「Edit」アイコンを選択して、Employee Detailsページへ移動します。

Photoの「Browse...」をクリックします。

前提条件にあるダウンロードしたapexnf.zipファイルのリストから「flowers-01_small.gif」ファイルを選択し、「Open」をクリックします。 「Apply Changes」をクリックします。

これで、Send Email Attachmentsページを実行できます。 開発者ツールバーにある「Application」リンクをクリックします。

「Send Email Attachments」ページを選択します。

「Run Page」をクリックします。

電子メール・アドレス、Fromの電子メール・アドレス、Subjectを入力し、「dog.gif」および「flowers-01_small.gif」のチェック・ボックスを選択して、Message Bodyに文字を入力します。 「Send Email」をクリックします。

電子メールが正しく送信されたことを確認します。

受信した電子メールは次のイメージのようになります。