コメント

コメントウィジェットは、Workshop モジュール内での共同作業を可能にします。

リファレンス

コメント内でオブジェクトに言及するために、リファレンスを使用することができます。リファレンスはインタラクティブで、選択すると、ツールチップで言及されたオブジェクトのプロパティを表示したり、モジュール内でイベントをトリガーしたり（モーダルを開く、オブジェクトビューを表示するなど）します。

以下に、コメントウィジェットでリファレンスを設定して使用する例を示します：

パーミッション

コメントは別々のオブジェクトではなく、親オブジェクトに直接紐づいています。オブジェクトエクスプローラには表示されず、コメントウィジェットを使用してのみ表示することができます。オントロジーでコメントを検索可能にするには、以下のセクションを参照してください。

コメントは親オブジェクトのパーミッションに従いますので、オブジェクトにアクセスできる場合は、その下に新しいコメントを表示し、投稿することができます。これは、制限付きビューも自動的にサポートされます。また、何かを誤って投稿した場合は、自分のコメントを削除することもできます。

細かいパーミッションについて

医療機関の例を使って、より細かいパーミッションについて調査してみましょう。医療機関は patient オブジェクトに行レベルのパーミッションを設定することができ、基本的なフィールドのみが管理者に表示され、医師は基本的なフィールドと敏感なフィールドの両方を見ることができます。管理者が医師が敏感なフィールドに残したコメントを閲覧するのを防ぐために、医療機関は PatientSensitiveComments という別のプロキシオブジェクトを作成します。これにより、モジュール内に2つのコメントスレッドを持つことができ、一つは patient オブジェクトに直接あるコメントスレッドで、管理者と医師の両方に表示され、もう一つはプロキシオブジェクト PatientSensitiveComments 上のコメントスレッドで、医師のみが閲覧可能です。

(高度な操作) オントロジーでコメントを検索可能にする

Action Logを有効にすることで、オントロジー内にコメントの履歴を保存することができます。これを行うには、コメント後に実行するアクションをオンにし、オントロジーへ移動して コメントテキスト、親オブジェクト、現在のユーザー などのフィールドを設定します。または、専用のオブジェクトタイプを作成してコメントを保存し、Action Log では実現できないコメントの削除をミラーリングする、より複雑なミラーリングを行うことができます。

Action Logに Comment text を追加する前に考慮すべきいくつかのことがあります：

• 親オブジェクトが制限付きビューとして設定されていて、行レベルのパーミッションが変更可能なフィールドを参照している場合は、注意が必要です。なぜなら、Action Log は追記のみであるためです。例えば、チケットに Sensitivity level というフィールドがあり、その値が Public から Legal only に変更された場合でも、Action Log にすでに保存されているコメントには前の値 Public が含まれます。オントロジーレイヤーにコピーしたコメントが親オブジェクトのパーミッションに従うようにするためには、専用の Ticket Comment オブジェクトを作成し、チケットの Sensitivity level を変更するアクションを設定して、Ticket Comment オブジェクトに保存されているコメントの Sensitivity level も更新するようにすべきです。
• Action Log は、Comments ウィジェットのようにコメントのリッチテキスト表示を表示しません。

通知

オブジェクトにコメントをすると、自動的に他のユーザーがそのオブジェクトにコメントをするときの通知を受け取るように登録されます。コメントでユーザーをメンションすると、そのユーザーにも通知が送られ、そのオブジェクトに対する今後のコメントの通知を受け取るように登録されます。通知はユーザーにメールで送信され、Foundry の通知インボックスに表示されます。

通知はワークフローの強化として考えるべきであり、ユーザーに未解決のアクションがあることを知らせる唯一の方法であってはなりません。ユーザーは、Workshop アプリケーションで自分に割り当てられたタスクを インボックスビューで見ることができるべきです。

デフォルトの通知

Comments ウィジェットは、デフォルトで通知が有効になっています。デフォルトの通知には、コメントが残されたオブジェクトの オブジェクトビューへのリンクが含まれます。ユーザーがリンクをクリックしたときにコメントを見ることができるようにするためには、Comments ウィジェットを持つ Workshop モジュールでバックアップされた オブジェクトビューを設定する必要があります。通知テキストをカスタマイズするため、または Workshop アプリケーションへのリンクを含めるためには、カスタム通知の指示に従ってください。

カスタム通知

カスタム通知を送信するためには、「デフォルトの通知を送信」を無効にし、「コメント後に実行するアクション」を設定し、そのアクションが通知の副作用を持つようにします。詳しくは、アクション通知ドキュメンテーションを参照してください。Comments ウィジェットは Users to notify や Comment text など、アクションに渡すことができる特別な値を提供します。これらを使って、簡単にカスタム通知を作成することができます。Workshop アプリケーションの特定の位置へのリンクを含めるためには、promoted variableを設定します。以下の例は、カスタム通知を設定する方法を示しています：

1. オントロジーでアクションを設定し、以下のフィールドを使用します

   

2. 次に、アクションルールに通知の副作用を追加します

   

3. 送信されるべき通知を設定します

4. Comments ウィジェットで Users to notify と Comment text を渡すアクションを設定します

   

添付ファイル

親オブジェクトの下またはコメントの直下に、ファイルや画像などの添付ファイルをアップロードすることができます。コメントの下にアップロードされた添付ファイルは、Comments ウィジェットでのみ表示され、ドラフトドキュメントやイテレーションに最適です。小さい添付ファイルのみをアップロードすることをお勧めします。大きい添付ファイルをアップロードすると、アップロードに時間がかかりますし、200 MB の制限があります。大きい添付ファイルは、親オブジェクトに直接アップロードすることを推奨します。

Action Log

Comment ウィジェットは、関連するオブジェクトに対して行われたコメントとアクションを一つの統一されたフィードで表示することができます。Action Log についての詳細は こちらをご覧ください。

よくある質問

アクションが発生したときに自動的にコメントを作成することは可能ですか？

Comments ウィジェットは、コメントと共に Action Log エントリを一般的なフィードで表示することができますので、自動化された「コメント」は Action Log エントリとして表現されるべきです。

Object Explorer の Comments Helper からのコメントを Workshop の Comments ウィジェットで表示することは可能ですか？

Object Explorer の Comments Helper からのコメントは、Workshop の Comments ウィジェットで表示または再利用することはできません。