カスタム SMTP モジュールは、基本的な設定を追加して、アプリケーションから直接電子メールを送信できるようにします。
手紙を送信するためのフォームをアプリケーションに表示するには、不足している設定と必要な要素を追加する必要があります。アクションのアルゴリズムは次のようになります。
- レターフォームが配置されるページまたはウィンドウを追加します。
- モジュールを接続し、SMTP サーバーのパラメーターとユーザー名とパスワードをモジュールに追加します。
- モジュール関連のビジネスプロセス、エンドポイント、フォームを作成します。
例として、Gmail メール サービスを使用して Web アプリケーションでこれを行う方法を示しましょう。
ページを作成
エディターに移動し、投稿元の新しいページを作成します。ページの名前 (「タイトル」)、そのアドレス (「ページ URL」)、およびメッセージを送信できるユーザーのグループ (「グループの表示」) を示します。 「保存」をクリックします。
変更を保存し、モジュール ブロックに移動します。
モジュールの追加と構成
[マーケットプレイス] タブでカスタム SMTP モジュールを見つけ、[インストール] ボタンをクリックしてアプリケーションに追加します。
アプリケーションにインストールされているすべてのモジュールが配置されている [インストール済み] タブに移動し、[カスタム SMTP] ボックスをクリックして設定を開きます。モジュールに関する基本情報と、アプリケーションからモジュールを削除するためのボタンが左側に表示されます。右側には、入力する必要があるフィールドがあります。
- フィールド「ログイン」と「パスワード」に、メッセージを送信するメールボックスのデータを入力します。
- SMTP 接続設定を指定します。これらは電子メール サービスごとに異なります。デフォルトでは、Gmail 設定がモジュールに追加されます。
- [差出人名] フィールドに、レターの受信者に表示される名前を入力します。
重要！ Gmail 経由でメッセージを送信するには、Google アカウントでサードパーティ アプリケーションを有効にする必要があります。
モジュールとは何か、モジュールを更新およびカスタマイズする方法の詳細については、ドキュメント を参照してください。
忘れずに変更を保存してください。
ビジネスプロセス、エンドポイント、フォームの作成
ビジネス プロセス、 エンドポイント、およびフォームは相互に関連する要素であり、一貫して設定することが重要です。相互に対話することで、アプリケーションの構成が完了し、メッセージを送信するためのフォームがページに表示されます。
これらの要素の詳細については、 ドキュメントを参照してください。
ビジネスプロセス
[ビジネス ロジック] タブに移動し、ボタンをクリックして、新しいビジネス プロセスを作成します。
プロセスの名前 (必須)、その説明 (オプション) を入力し、[作成] ボタンをクリックします。
エディター内の各ビジネス プロセスは、ブロック (さまざまな機能を担当する構成要素) に視覚的に分割されます。新しいプロセスが作成されると、その中に「開始」と「終了」が自動的に表示されます。追加できる他のすべてのブロックが左側に表示されます。
インストール後、「カスタム SMTP」モジュールにより、「カスタム SMTP: 電子メールの送信」がこのリストに追加されました。このブロックをビジネス プロセスに含めるには、マウス ポインタを使用してエディタ フィールドにドラッグします。 [カスタム SMTP: 電子メールの送信] ウィンドウが表示されます。そのフィールドには、今後のメッセージ送信フォームの内容が依存する変数が含まれています。
- 「件名」 - 手紙の件名。
- 「本文」 - 手紙のテキストを含むフィールド。
- 「宛先」 - 受信者のアドレス。
- 「Cc」 - コピーを送信するためのアドレス。
- 「差出人名」 - 送信者の名前。
- 「Bcc」はブラインドカーボンコピーの送信先です。
ここで、"Start"、"Custom SMTP: Send Email"、および "End" をリンクして、これらが 1 つのビジネス プロセスを構成していることを示す必要があります。
1. マウス ポインタを「開始」ブロックの「開始」フィールドに移動し、マウスの左ボタンを押したまま、「カスタム SMTP: 電子メールの送信」ブロックの「受信」フィールドにスワイプします。ブロック。
2. 同様に、"Custom SMTP: Send Email" ブロックの "Out" フィールドと "End" ブロックの "End" フィールドの間にリンクを作成します。
ここで、「開始」ブロックで、新しいフィールド (変数) を作成し、それらを「カスタム SMTP: 電子メールの送信」ブロックの変数に関連付ける必要があります。 「開始」ブロックに追加したフィールドは、メッセージ送信フォームに表示されます。コピーとブラインド コピーを送信しないと仮定すると、「開始」ブロックには次のフィールドが含まれます。
- 「送信者」（送信者の名前） - from_name に関連付けられています。
- 「アドレス」（送信先） - 「宛先」に関連付けられています。
- 「件名」（トピック）; - 「サブジェクト」に関連付けられています (異なるブロックの変数名は同じ場合があります)。
- 「メッセージ」（手紙のテキスト） - 「本文」に関連付けられています。
変数をバインドするには、それらの型が互いに一致している必要があります。変数のタイプは、それが含まれているブロックをクリックして編集メニューを開くことで表示できます。
ブロックのフィールドでは、各変数の横にアイコンがあり、その色と形状はタイプに応じて異なります - それらを簡単にナビゲートできるようにします。この例では、2 種類の変数があります。
- 「Subject」、「body」、および「from_name」は「String」型です。
- To、cc、および bcc は Email Array タイプです。
変数の作成
「開始」ブロックで最初の変数を作成するには、それをクリックします。リストが表示されます (空の場合)。 「+」をクリックします。
開いたウィンドウで、変数の名前を入力します: name "sender", type "String". 「作成」をクリックします。
同様に「住所」「件名」「メッセージ」を追加します。 「開始」ブロックの変数のリストは次のようになります。
それらをカスタム SMTP の対応する変数にリンクします: 電子メールの送信ブロック:
これは、変数間の関係が最終的にどのように見えるかです。変更を保存し、エンドポイントの作成に進みます。
終点
[エンドポイントの作成] をクリックします。[ビジネス ロジック] タブの設定が表示されます。ここでは、次の設定を指定する必要があります。
- 「エンドポイント ルート」 - その機能を理解するためのエンドポイントの名前。
- 「エンドポイント グループ」 - 配置されるグループの名前。
- 「リクエスト タイプ」 - 「POST」を選択します。
- 「ビジネス プロセス」 - 作成した send_email ビジネス プロセスを選択します。
次に、「ミドルウェア」タブに移動します。
[ミドルウェア] タブで、このエンドポイントでアクションを実行する (したがって、関連するビジネス プロセスを起動する) 権限を構成する必要があります。つまり、アプリケーションからメールを送信できるユーザーを指定します。これを行うには、「Token Auth」認可トークンの設定を変更する必要があります。
注意！この設定が変更されない場合、すべてのユーザーがメールを送信する権利を持ちます!
「Token Auth」の横にある歯車アイコンをクリックします。開いたウィンドウでセレクターをオンにし、[許可されたグループ] フィールドで [管理者] グループ (またはアクセスを許可するその他のグループ) を選択します。 「保存」をクリック
[作成] をクリックして、エンドポイントを保存します。
メッセージ送信プロセスが構成されます。これで、メッセージ送信フォームの視覚的表現を作成できます。
形
フォームを作成するには、Web アプリケーション エディターに戻り、前に作成したタブに戻ります。 Form 要素をページ キャンバスにドラッグします。
開いたウィンドウで [レコードの作成] をクリックすると、使用可能なエンドポイントのリストが [レコードの保存先] フィールドに表示されます。作成したエンドポイントを選択します。 「割り当て」をクリックします。
作成したシェイプがキャンバスに表示されます。歯車の画像をクリックして、その設定に移動します。
「Look & Fee」タブで、「Title」フィールドにフォームのタイトルを入力します。ここでは、外観を変更したり、設定で記録されている名前を確認したりすることもできます。
[データ] タブ - フォームのモードとエンドポイントに関する情報。また、ここでは、フィールドを相対的に移動して、フィールドの位置を変更できます。
フィールドを論理的な順序で並べます: 送信者、アドレス、件名、メッセージ。各フィールドの詳細設定 (名前など) を変更するには、横にある歯車のアイコンをクリックします。 「保存」をクリックして変更を保存します。
フォームにボタンを追加する
フォームを機能させるには、送信確認ボタンを追加する必要があります。 「ボタン」要素を使用します - マウスポインタでフォームの下の領域にドラッグします。
クリックしてボタン設定を開きます。 [ルック アンド フィール] タブで、[ラベル] (アプリケーションで表示されるボタンの名前) と [名前] (設定で表示される名前) を変更します。
[トリガー] タブで、onClick トリガーにアクションを追加します。[ターゲット] フィールドでフォームを選択し、[アクション] フィールドで [フォームの送信] を選択します。 「保存」をクリックします。
保存・公開・検証
行ったすべての変更を保存して公開し、[アプリケーションに移動] アイコンをクリックします。
メッセージを送信するためのデータを入力します。送信者フィールドを空のままにすると、モジュール設定で入力した名前が自動的に追加されます。アクセスできる任意の電子メール アドレスにテスト メッセージを送信します。
送信後、確認メッセージが表示され、指定されたデータを含むレターが Inbox フォルダーの宛先に表示されます。
指示に従ってすべてを行ったにもかかわらず、エラーが発生したか、手紙が「スパム」フォルダに入ったことを確認せずに、テクニカル サポートのテレグラム チャネルに連絡してください。
