generic-email
アダプタの使用
電子メールアダプタ(generic-email
)は、SMTP サーバーを使用して電子メールを送信するための基本機能を提供することで、ワークフローにレポートの要素を追加します。1.0.0 アダプタバージョンでは、送信
アクティビティを使用して、ワークフロー定義内で定義されたメッセージを含む電子メールを送信できます。
generic-email
アダプタの取得
CWM 1.1 ソフトウェアパッケージをダウンロードしてください。cwm.v1.1.generic.email.v1.0.0.tar.gz
ファイルは、パッケージ内に含まれています。
アダプタのインストール
アダプタをインストールするには、オペレータガイドのアダプタのインストール方法に関する指示に従ってください。
SMTP リソースとシークレットの作成
ワークフロー内での電子メールメッセージの定義の詳細に進む前に、リソースとシークレットを CWM に追加する必要があります。後でワークフロー内でそれらを参照する必要があります。
シークレットの追加
手順
ステップ 1 |
CWM で、[管理(Admin)] -> [シークレット(Secrets)] タブに移動します。 |
ステップ 2 |
[シークレットの追加(Add Secret)] をクリックします。 |
ステップ 3 |
[新しいシークレット(New secret)] ビューで、次を指定します。
|
ステップ 4 |
シークレットタイプを選択すると、[シークレットタイプの詳細(Secret type details)] セクションに一連の追加フィールドが表示されます。次のフィールドに入力します。
|
ステップ 5 |
[シークレットの作成(Create Secret)] をクリックします。 |
リソースの追加
手順
ステップ 1 |
CWM で、[管理(Admin)] -> [リソース(Resources)] タブに移動します。 |
ステップ 2 |
[リソースの追加(Add Resource)] をクリックします。 |
ステップ 3 |
[新しいリソース(New resource)] ウィンドウで、次を指定します。 |
ステップ 4 |
[リソースの作成(Create a Resource)] をクリックします。 |
ワークフローでの送信
アクティビティの定義
ワークフローでアダプタの送信
アクティビティを使用する方法を学習します。
アクティビティ参照の設定
CWM では、アダプタの 送信
アクティビティは、generic.email.smtp.Send
と呼ばれます。ワークフローを定義する場合は、functions
の operations
パラメータの値として指定する必要があります。
"functions": [
{
"name": "smtp.send",
"operation": "generic.email.v1.0.0.smtp.Send"
}
]
(注) |
|
actions
での電子メールメッセージの定義
ワークフローの状態の一部として電子メールを送信するアクションを定義できるようになりました。
アクションで使用可能な入力パラメータは次のとおりです。
フィールド | タイプ | ラベル | 説明 | |
---|---|---|---|---|
from | string | 送信者の電子メールアドレス | ||
to | string | repeated | 受信者の電子メールアドレスのリスト | |
cc | string | repeated | cc 受信者の電子メールアドレスのリスト | |
bcc | string | repeated | bcc 受信者の電子メールアドレスのリスト | |
subject | string | 電子メールのタイトル | ||
text | string | テキストとしての電子メール本文 | ||
html | string | html としての電子メール本文 |
次に示すように、SendEmail
のサンプルアクションを定義する arguments
内で、使用可能なフィールドを input
キー/値ペアとして使用します。
"states":[
{
"name":"EmailState",
"type":"operation",
"end": true,
"actions": [
{
"name": "SendEmail",
"functionRef": {
"refName": "smtp.send",
"arguments": {
"input": {
"to": ["recipient1@address.com", "recipient2@address.com"],
"from": "sender@address.com",
"text": "Hello, this is some placeholder email text.",
"subject": "A test email from CWM"
},
"config": {
"resourceId": "emailResource"
}
}
}
}
]
}
]
条件に基づいて電子メールアクションをトリガーする場合は、スイッチの状態を使用し、その中に dataConditions
パラメータを定義できます。詳細については、スイッチの状態に関するサーバレスワークフロー仕様のドキュメントを参照してください。