Forguncy 8 オンラインヘルプ
Forguncyの使い方 / サーバーオブジェクト / コマンド(サーバーサイド) / メール送信(サーバーサイド)
このトピックで
    メール送信(サーバーサイド)
    このトピックで

    宛先やメールの内容を指定してメールを送信します。基本的なプロパティは通常コマンドのメール送信と同様ですが、メール本文にて使用できるキーワードが制限されていることや、添付ファイルにパスを直接指定できるなどの違いがあります。

    参考:このコマンドを使用する前にメールサーバー(SMTP送信サーバー)を設定しておく必要があります。

    • アプリケーションの開発環境の場合、Forguncy Serverの運用環境の場合のいずれも、メール送信サーバーの設定を参照して設定してください。

    プロパティ名

    説明

    差出人

    送信者の電子メールアドレスを入力します。設定できる値は以下のとおりです。

    • 送信者となる電子メールアドレスの文字列。文字列で「taro.yamada@example.com」のように指定します。

      表示名を設定したい場合には、「"山田 太郎"<taro.yamada@example.com>」のように指定します。

    • フォーム認証のユーザーの「ユーザー名」

    • をクリックして、数式、およびパラメーター名を使用できます。

    • キーワードは以下のものが使用できます。
      • %CurrentUser% : ログインしているユーザー

    宛先

    受信先のメールアドレスを入力します。設定できる値は以下のとおりです。

    • 受信者となる電子メールアドレスの文字列

      複数の宛先を指定する場合、メールアドレスをカンマ(,)で区切るかたちで指定します。たとえば、abc@example.comとdef@example.comの2つの宛先を指定する場合、以下のようになります。

      abc@example.com,def@example.com

    • フォーム認証のユーザーの「ユーザー名」

      複数の宛先を指定する場合、メールアドレスをカンマ(,)で区切るかたちで指定します。たとえば、TaroとHanakoの2つのユーザー名を宛先に指定する場合、以下のようになります。

      Taro,Hanako

    • をクリックして、数式、およびパラメーター名を使用できます。

    • キーワードは以下のものが使用できます。

      • %CurrentUser%:ログインしているユーザー

    をクリックすることで、テーブルからクエリー条件を指定して送信先を取得できます。

    件名

    メールの件名を入力します。設定できる値は以下のとおりです。

    • 件名となる文字列。

    • をクリックして、件名に数式、およびパラメーター名を使用できます。

    • キーワードは以下のものが使用できます。 「メール本文の編集...」をクリックして表示された画面右側のキーワードのリストから、「ユーザーに関するキーワード」、「日付に関するキーワード」。

    本文

    メールの本文を入力します。設定できる値は以下のとおりです。

    • 本文となる文字列。

    • 送信されるメールはHTML形式のメールになるため、文字列には一般的なHTML形式メールで使用できるタグが使えます。たとえば、改行したい場合は、<br>や<p>が使用できます (例)=A1&"です。<br>改行しました。"

    • 「本文に数式を使用する」にチェックを入れると、本文を数式、およびパラメーターを利用して記載できます。

      ただし、本チェックを有効にした場合、メール本文すべてを数式で記述する必要がある点にご注意ください。数式でない値が入力されている場合、本チェックは自動で無効となります。

    • キーワードは以下のものが使用できます。

      「メール本文の編集...」をクリックして表示された画面右側のキーワードのリストにあるすべてのキーワード。

    メール本文の編集

    右側のキーワードのリストを選択して、本文に含めることができます。

    「本文に数式を使用する」を設定していない場合にも、本文中に数式を含めることができます。例えば本文中に[=A1 + 1]や、[=TEXT(TODAY(), "yyyy-MM-dd")]のように「[]」で数式を囲うことで使用できます。
    もし[=]といった文字を扱いたい場合は、直前に「¥」を半角文字で記載します。
    例)\[=\]             

    ページを選択する場合、ドメイン名の設定を行うことで、運用環境で公開したアプリケーションのページリンクを正しく埋め込むことができます。詳細は全般設定(サーバー管理ポータル)を参照してください。

    [詳細設定を表示...]をクリックすることで次の設定を行えます。

    プロパティ名

    説明

    CC

    CCのメールアドレスを指定します。複数のCCを指定する場合、メールアドレスをカンマ(,)で区切るかたちで指定します。をクリックして、数式、およびパラメーターの入力も可能です。

    をクリックすることで、テーブルからクエリー条件を指定して送信先を取得できます。

    BCC

    BCCのメールアドレスを指定します。複数のBCCを指定する場合、メールアドレスをカンマ(,)で区切るかたちで指定します。をクリックして、数式、およびパラメーターの入力も可能です。

    をクリックすることで、テーブルからクエリー条件を指定して送信先を取得できます。

    添付ファイル

    テーブルの画像型、または添付ファイル型の値を設定する、もしくはサーバーからアクセス可能なファイルパスを設定することで、それらのファイルをメールの添付ファイルとして送信できます。 複数の添付ファイルがある場合は、「|」で区切ります。 たとえば、「C:\temp\1.txt|C:\temp\2.txt」や「=param1&"|"&param2」のような記載が可能です。

    重要度

    メールの重要度を「低」、「標準」、「高」の3種類から指定します。指定した重要度がどのように扱われるかは、受信するメールソフトによって異なります。Forguncyでは以下のヘッダー項目をメールに付加しています。

    • X-Priority

    • Priority

    • Importance

    テキスト形式で送信

    本チェックオプションをチェックした場合、プレーンテキスト形式のメールが送信されます。チェックしていない場合、HTML形式のデータとテキスト形式のデータの両方を持つマルチパートメールが送信されます。既定値は無効です。

    送信するメール本文、もしくは本文の一部を、セル参照などを使用してWebページ上からの入力を可能としているアプリケーションの場合、HTML形式ではなくテキスト形式での送信とすることを推奨します。詳細はセキュリティに関する推奨事項を参照してください。

    注意:[宛先]、[CC]、[BCC]に指定されたメールアドレスのうち、1つ以上のメールアドレスが不正な形式でなければ、メールの送信処理はエラーや警告の表示なしに行われます。この動作は、アプリケーション稼働後に追加されたユーザーアカウントのメールアドレスが誤っていることで、既存の処理が行われなくなってしまうことを回避するための意図した製品の動作です。

    リターンコード

    リターンコード

    説明

    1

    [宛先]が未設定

    2

    メール送信処理において例外が発生