メール送信 | Forguncy 10 オンラインヘルプ

メール送信

このトピックで

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

参考：このコマンドを使用する前にメールサーバー（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>改行しました。" 「本文に数式を使用する」にチェックを入れると、本文を数式、およびパラメーターを利用して記載できます。ただし、本チェックを有効にした場合、メール本文すべてを数式で記述する必要がある点にご注意ください。数式でない値が入力されている場合、本チェックは自動で無効となります。キーワードは、「メール本文の編集...」をクリックして表示された画面右側のすべてが使用できます。本文では、テキスト、数式、キーワード、HTMLタグをサポートしています。ヒント：メール本文の編集ダイアログでは以下の機能をサポートしています。「 [= 」を入力すると、数式と変数のスマートヒントが表示されます。「 [% 」を使用すると、キーワードのヒントが表示されます。 HTMLタグの自動補完をサポートしています。右クリックすると、書式設定やその他の操作ができます。
メール本文の編集	右側のキーワードのリストを選択して、本文に含めることができます。「本文に数式を使用する」を設定していない場合にも、本文中に数式を含めることができます。例えば本文中に[=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つ以上のメールアドレスが不正な形式でなければ、メールの送信処理はエラーや警告の表示なしに行われます。この動作は、アプリケーション稼働後に追加されたユーザーアカウントのメールアドレスが誤っていることで、既存の処理が行われなくなってしまうことを回避するための意図した製品の動作です。

ヒント：以下の条件を満たす場合、メールの受信者は送信元ユーザーのフルネームを確認できます。

サーバー管理ポータルで作成したユーザーにフルネームが設定されている
メールサーバーの「送信（SMTP）サーバー」が設定されている

リターンコード

リターンコード	説明
1	［宛先］が未設定
2	メール送信処理において例外が発生