注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。
通知効果
Automate アプリケーションでは、条件が満たされたときに、プラットフォームのほかのユーザーに通知を自動送信できます。
通知は、プラットフォーム内で直接送信する方法と、メールとして送信する方法の2通りで送信できます。内容は固定で定義することも、関数を使用して動的に決定することもできます。また、通知には PDF やインラインの添付ファイルを含めることもできます。このページでは、通知の受信者、内容、添付ファイルのオプションについて説明します。
オブジェクトのグループ化
「影響を受けるオブジェクト」を公開する条件を使用する場合、通知を送信する前にこれらのオブジェクトをどのようにグループ化するかを選択できます。
「影響を受けるオブジェクト」を公開する条件は、次のとおりです。
すべてのオブジェクトに対して1回実行する
複数のオブジェクトが同時に条件をトリガーした場合、各受信者には通知が1件だけ送信されます。
以下のスクリーンショットの例では、3個の異なるサポートチケットオブジェクトが自動化をトリガーし、1件の通知が送信されます。関数ベースの通知では、3個すべてのオブジェクトを含むオブジェクトセットにアクセスできます。
オブジェクトのグループごとに1回実行する
複数のオブジェクトが同時に条件をトリガーした場合、選択したプロパティでオブジェクトがグループ化されます。グループごとに1件の通知が各受信者に送信されます。
グループ化は、プロパティ値の完全一致に基づいて行われます。配列型のプロパティの場合、同じグループにまとめるには、値が順序も含めて完全に一致している必要があります。
以下の例では、3個の異なるサポートチケットオブジェクトが同時に自動化をトリガーします。2個のオブジェクトはカテゴリー請求に属し、1個はテクニカルサポートに属しています。
- グループ化プロパティとしてカテゴリーが選択されているため、請求グループ用とテクニカルサポートグループ用の2件の通知が送信されます。
- 1件目の通知では、関数ベースの通知から、請求のサポートチケットオブジェクト2個を両方含むオブジェクトセットにアクセスできます。
- 2件目の通知では、関数ベースの通知から、テクニカルサポートのオブジェクトを含むオブジェクトセットにアクセスできます。
オブジェクトごとに1回実行する
複数のオブジェクトが同時に条件をトリガーした場合、オブジェクトごとに1件の通知が送信されます。
たとえば、3個のサポートチケットオブジェクトが自動化をトリガーした場合、サポートチケットごとに個別の通知が送信されます。関数ベースの通知では、個々のオブジェクトとそのプロパティ値にアクセスできます。
受信者
通知を設定する際には、まず通知の受信者を定義する必要があります。受信者には Foundry のユーザーまたはグループを指定でき、固定の受信者リスト、またはオブジェクトのプロパティを使用した動的な定義のいずれかで定義します。
自動化から通知を受信するには、受信者に次の権限が必要です。
- 自動化に対する閲覧者以上の権限。これは固定の受信者と動的に定義された受信者の両方に必要です。
- 自動化をトリガーするオブジェクトのインスタンスに対する閲覧者権限。
- トリガーとなるオブジェクトタイプがマルチデータソースオブジェクトタイプの場合、オブジェクトのインスタンスのすべてのプロパティに対する閲覧者権限。
- 関数ベースの通知で関数の実行時にアクセスする、すべてのオブジェクトのインスタンスに対する閲覧者権限。
上記の要件は、アクティブなユーザーと事前登録済みのユーザーの両方に適用されます。
自動化を手動で実行すると、トリガー条件はバイパスされます。そのため、手動実行時にはトリガーとなるオブジェクトに対する権限は確認されません。
固定の受信者リスト
通知の受信者を定義する1つ目の方法は、固定で受信者を固定リストとして指定することです。リストを定義するには、対応するテキストフィールド内をクリックし、受信者にするユーザーまたはグループを選択します。
オブジェクトのプロパティを使用した動的な受信者の定義
2つ目の方法は、「影響を受けるオブジェクト」のプロパティを使用して通知の受信者を動的に定義することです。この設定オプションには、効果の入力を公開するオブジェクトセット条件が必要です。
動的な受信者の定義では、ユーザーIDまたはグループIDを含むオブジェクトのプロパティを指定し、実行時に通知の受信者を決定できます。そのため、オブジェクトのプロパティタイプは String または Array of String である必要があります。
以下の例では、契約オブジェクトタイプに対して、オブジェクトが変更される条件を定義します。次に、ユーザーIDの配列を含む契約所有者プロパティを使用して、通知の受信者を定義できます。
コンテンツ
通知のコンテンツを定義する方法は、通常の通知と関数により生成された通知の2つです。
通知は受信者ごとに表示されるため、表示されるコンテンツはユーザーによって異なる場合があります。
通常の通知
通常の通知には、通知のコンテンツを直接指定できるインターフェースコンポーネントが用意されています。見出しとメッセージは必ず入力してください。必要に応じて、URL リンクも変更できます。デフォルトでは、URL リンクはプラットフォーム内の通知へのリンクで、メールにのみ表示されます。
メールの詳細設定を使用して、メール用に異なる値を設定することもできます。デフォルトでは、プラットフォーム内の通知用に上記で指定した見出し、メッセージ、URL リンクの値が使用されます。必要に応じて、メールの詳細設定で HTML を使用することもできます。
自動化でデータセット条件を使用する場合、メールの詳細設定にはデータセットプレビューを追加も表示されます。このオプションを有効にすると、データセットの最大50行がメール本文に含まれます。必要に応じて列を選択することもできます。
コンテンツを追加するときに、/ キーを使用すると、通知をテンプレートとして扱うためのメニューが開きます。受信者の名前などの値は、通知の送信時に置き換えられます。オブジェクトセットを監視していて、オブジェクトごとに実行が選択されている場合は、関連するオブジェクトプロパティの現在の値と以前の値もテンプレートの値として選択できます。ただし、以前のプロパティ値はライブ監視を使用している場合にのみ利用可能です。
加えたすべての変更は、設定コンポーネントの右側にライブプレビューで表示されます。
最後に、通知の添付ファイルを定義できます。
関数により生成された通知
通常の通知を使用する代わりに、通知のコンテンツを動的に生成する関数を使用できます。これは、通常の通知では対応できない通知の要件がある場合にのみ使用してください。
カスタム通知関数を作成するには、関数のドキュメントの手順に従います。関数は Notification または Notification | undefined を返す必要があります。undefined が返されると、Automate は通知をスキップします。関数のロジックでこの仕組みを使用して、通知を送信するかどうかを条件に応じて決めることができます。
通知関数を作成して公開したら、通知の効果で使用できます。まず、関数とバージョンを選択します。その後、インターフェースが更新され、関数の定義に応じて必要な入力が表示されます。
条件の効果の入力と受信者を使用する
入力パラメーターのデータ型によっては、固定値を指定するだけでなく、特別な効果の入力を使用できる場合があります。次の効果の入力がサポートされています。
- 受信者：
User型の関数入力に使用でき、通知の表示対象となる受信者を関数に渡します。 - 条件の効果の入力： 条件が効果の入力を公開している場合、その効果の入力をここで使用できます。関数パラメーターのデータ型は、公開されている効果の入力のデータ型と一致している必要があります。条件が公開するデータ型は、条件の種類と実行モードによって異なります。
以下の例では、受信者の入力と、契約の変更という条件の効果の入力を使用して、受信者と、自動化をトリガーした該当オブジェクトに合わせたカスタム通知を作成する方法を示しています。
添付ファイル
通知の効果を設定して、Notepad ドキュメント、Notepad テンプレートドキュメント、または Contour ダッシュボードから生成された添付ファイルを通知メールに含めることができます。添付ファイルは、実行時に受信者ごとに自動生成されます。
添付ファイルのセクションで + 選択を選択し、Notepad ドキュメント、Notepad テンプレート、または Contour ダッシュボードを選択します。次に、添付ファイルのファイル名を指定します。選択したリソースの種類によっては、次のセクションで説明するように、さらに値を指定する必要があります。
添付ファイルごとに、次のオプションも設定できます。
- インライン表示： この切り替えを有効にすると、ドキュメントを個別の PDF 添付ファイルとして送信する代わりに、画像としてメール本文に直接埋め込みます。
- 添付ファイルの表示ロケール： 添付ファイルの表示に使用するロケールを選択します。これにより、Contour および Notepad ファイルを表示する際の日付、数値、テキストの表示方法が変わる場合があります。
Notepad テンプレート
Notepad テンプレートを使用すると、通知の効果の実行時に Notepad ドキュメントを動的に生成し、PDF としてエクスポートできます。これは、Notepad テンプレートの入力を通じて行われます。Notepad テンプレートの入力を使用すると、生成ステップで Notepad ドキュメントに値を渡すことができます。Notepad テンプレートの機能については、テンプレートのドキュメントで詳しく説明しています。
Notepad テンプレートとテンプレートのバージョンを選択すると、必要な Template 入力が表示されます。Automate アプリケーションでは、Notepad テンプレートの入力に固定値と条件の効果の入力を渡すことができます。テンプレートがオブジェクトまたはオブジェクトセットのテンプレート入力を公開していて、条件が同じ型の条件の効果の入力を公開している場合は、その条件の効果の入力をテンプレートに渡すことができます。
Notepad テンプレートは、オブジェクトまたはオブジェクトセットのテンプレート入力について、オブジェクトタイプの情報を公開しません。指定するオブジェクトの値のタイプが一致していることを、ご自身で確認してください。
下の画像は、サポートチケットの概要という Notepad テンプレートを通知の効果にアタッチした例です。サポートチケットというテンプレート入力は、オブジェクトがセットに追加されたという条件が公開する新しいサポートチケットという条件入力に接続されています。そのため、条件がトリガーされるたびに、条件をトリガーしたオブジェクトが使用され、テンプレートからドキュメントの PDF が生成されます。
