オントロジーの構築アクションタイプ副次的効果通知の設定

注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。

通知を設定する

このチュートリアルでは、通知を伴うアクションを設定する方法を説明します。

Alert オブジェクトの Priority プロパティを更新し、その Alert オブジェクトのプロパティとして格納されている Assignee(Foundry ユーザー)にも通知するアクションを使用します。チュートリアルに沿って進めるには、次のものをあらかじめ設定しておく必要があります。

  • 適切なプロパティを持ち、アクションで編集できるように設定されたオブジェクト
  • オブジェクトの1つと、新しい優先度を含むパラメーターを受け取り、指定されたオブジェクトの優先度プロパティを更新するアクション。以前にアクションの入門チュートリアルに沿って進めた場合は、すでに設定されているはずです。

オブジェクトの管理をはじめて行う場合は、オブジェクトタイプを設定する方法を参照してください。

前提条件

入門チュートリアルを完了する

このチュートリアルは、アクションの入門チュートリアルをすでに完了していることを前提としています。

オブジェクトタイプに担当者プロパティを追加する

このチュートリアルでは、Alert オブジェクトに Case Managers という名前のプロパティが必要です。このプロパティには、現在割り当てられているユーザーの Foundry ユーザーIDを格納します。通常、アクションを使用してワークフローを構築している場合は、アプリケーションのユーザーセレクターコンポーネントを使用してユーザーIDを取得し、格納できます。これらは Foundry 内のどこに表示される場合でも、完全なユーザー名として表示されます。

通知を追加する

まず、チケットの優先度を更新するアクションに移動します。ルールセクションで新しいルールを追加を選択し、続いて通知を選択します。通知を追加するための設定ダイアログが開きます。

受信者の設定

受信者を設定する

この例では、編集中の Alert オブジェクトのプロパティとして格納されている担当者に通知を送信します。そのために、受信者ドロップダウンで「オブジェクトパラメーターのプロパティから受信者を指定」を使用します。アクションのパラメーターとして利用可能な Alert オブジェクトを選択し、プロパティの選択を求められたら Case managers プロパティを選択します。

選択したオブジェクトパラメーターとプロパティが、設定の受信者セクションに表示されるはずです。受信者は常に Foundry ユーザーIDでなければならないことに注意してください。このプロパティに文字列のメールアドレスなど、ほかのものが含まれている場合、通知は送信されません。

テスト時には、まず受信者をハードコードしたアクションを設定すると、ロジックと通知の内容が想定どおりに設定されているかを検証できます。

ハードコードされた受信者

その他の受信者設定オプションについて詳しくはこちら。

通知の内容を設定する

次に、受信者の名前を呼びかけに使用し、Alert オブジェクトの変更前と変更後の優先度を内容に含めるように通知をカスタマイズして、通知の内容を設定します。通知設定の例を以下に示します。

まず、内容の選択肢から「テンプレート」を選択します。これは内容を設定する最も簡単な方法で、コードを書く必要はありません。

件名には、任意のメッセージを入力します。パラメーターへの参照を追加するには、スラッシュ / を追加し、ドロップダウンリストから目的のパラメーターを選択します。選択したものがオブジェクトパラメーターの場合は、参照するプロパティの選択を求められます。

本文には、受信者の名前を呼びかけに使用し、変更を行ったユーザーを示し、変更前と更新後のステータスを伝えるテキストを入力します。

件名のオブジェクト参照と同様に、ドロップダウンリストから「受信者」、「現在のユーザー」、および任意のパラメーターを選択すると、それらのユーザー属性への適切な参照を生成できます。

より複雑な要件を満たす通知の内容を生成する方法を確認する。

リンクを設定する

最後に、Object Explorer 内の指定した Alert の Object View へのリンクを追加します。「Object View」を選択し、ドロップダウンからチケットのオブジェクトパラメーターを選択します。次に、リンクボタンのラベルとして「チケットを表示」を追加します。

これで、通知設定全体を保存する準備ができました。

設定全体

設定可能なその他の種類のリンクについて詳しくはこちら。

テスト通知を送信する

確認するには、自分自身を担当者とするテストアラートを作成します。続いて、アクションを実行するには、アクションのドキュメントで説明されているように、Object Explorer または Workshop モジュールのボタンからアクションを利用できるようにする必要があります。

テスト用の変更を行うと、プラットフォーム内のプッシュ通知と、Foundry ユーザープロフィールに指定されているメールアカウントへのメール通知の両方が届くはずです。プラットフォーム内の通知とメール通知のプレビューは、どちらも通知設定ビュー内に表示されます。

メールが届かない場合は、メール通知やプラットフォーム内の通知が無効になっている可能性があります。これは、ユーザー設定の通知で確認できます。

次のステップ

  • 受信者がメールでの通知の受信を選択した場合に使用するカスタムコンテンツなど、ほかの任意機能を探索します。
  • 関数を使用して、受信者や内容に関する複雑なロジックを設定します。