カスタム SMTP モジュールの構成

カスタム SMTP モジュールは、基本的な設定を追加して、アプリケーションから直接電子メールを送信できるようにします。

手紙を送信するためのフォームをアプリケーションに表示するには、不足している設定と必要な要素を追加する必要があります。アクションのアルゴリズムは次のようになります。

1. レターフォームが配置されるページまたはウィンドウを追加します。
2. モジュールを接続し、SMTP サーバーのパラメーターとユーザー名とパスワードをモジュールに追加します。
3. モジュール関連のビジネスプロセス、エンドポイント、フォームを作成します。

例として、Gmail メール サービスを使用して Web アプリケーションでこれを行う方法を示しましょう。

ページを作成

エディターに移動し、投稿元の新しいページを作成します。ページの名前 (「タイトル」)、そのアドレス (「ページ URL」)、およびメッセージを送信できるユーザーのグループ (「グループの表示」) を示します。 「保存」をクリックします。

変更を保存し、モジュール ブロックに移動します。

モジュールの追加と構成

[マーケットプレイス] タブでカスタム SMTP モジュールを見つけ、[インストール] ボタンをクリックしてアプリケーションに追加します。

アプリケーションにインストールされているすべてのモジュールが配置されている [インストール済み] タブに移動し、[カスタム SMTP] ボックスをクリックして設定を開きます。モジュールに関する基本情報と、アプリケーションからモジュールを削除するためのボタンが左側に表示されます。右側には、入力する必要があるフィールドがあります。

1. フィールド「ログイン」と「パスワード」に、メッセージを送信するメールボックスのデータを入力します。
2. SMTP 接続設定を指定します。これらは電子メール サービスごとに異なります。デフォルトでは、Gmail 設定がモジュールに追加されます。
3. [差出人名] フィールドに、レターの受信者に表示される名前を入力します。

重要！ 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 フォルダーの宛先に表示されます。

指示に従ってすべてを行ったにもかかわらず、エラーが発生したか、手紙が「スパム」フォルダに入ったことを確認せずに、テクニカル サポートのテレグラム チャネルに連絡してください。