コメントとレビューのスレッド
セル、テキスト、レコード、要素に質問を紐付け、返信と解決状態でレビュー結果を追跡します。
コメントは議論をコンテンツのそばに保ちます。レビュー担当者は数値、段落、図形の問題を指摘し、作成者や他の参加者は同じスレッドで返信できます。外部チャットに議論を分散させず、文脈を共有できます。
質問から結論まで
- 対象を指定：セル、選択テキスト、レコード、要素、ページ位置にコメントし、コンテンツへの参照を保持します。
- スレッドで議論：最初のコメントと返信をまとめ、作成者、時刻、本文を表示します。
- 解決または再開：修正後に解決済みにします。追加対応が必要なら、議論を残したまま再開できます。
コメントパネルでは、すべて、未解決、解決済み、自分に関連する議論を絞り込めます。解決は削除とは異なり、判断の経緯を後から確認できます。
製品別のコメントと注釈
スクリーンショットは英語の Northstar リリースプロジェクトです。Facade API で実際のエディターに作成し、フロントエンドのコメントと注釈を示しています。画像をクリックすると拡大できます。
Sheets
セルに議論を紐付け、予算の数値のそばで予測の定義、費用、承認を確認します。複数スレッド、連続した返信、解決済みのグループを表示しています。セルには range.addCommentAsync() を使います。画像、グラフ、図形へのコメントには対応する描画コメント連携が必要です。
Docs
選択したテキスト範囲にコメントして、契約条項、提案書、公開日などをレビューします。カードに引用を残し、テキスト編集中はコメント装飾が位置を維持します。例では公開日、指標の定義、旧手順の置き換えを議論しています。document.getTextRange(...).createCommentAsync() を使います。
Slides
スライドの要素、または自由な位置にコメントできます。要素コメントはテキストボックス、画像、グラフなどの安定した ID を参照し、位置コメントはページ内の正規化座標を使います。例は公開目標とレイアウトのレビューです。slide.createElementCommentAsync() と slide.createPositionCommentAsync() を使います。
Relational Table
コメントはレコード ID に紐付き、現在の表示行番号に依存しません。引き継ぎ、顧客対応、検収の確認に使えます。リリース管理表に担当者の議論、承認待ち事項、レコードのコメントマークを表示しています。record.createCommentAsync() を使います。
Canvases
図形などの要素、またはボードの指定位置にコメントします。要素コメントはオブジェクトを参照し、位置コメントはボード座標を保持します。顧客調査、開発の引き継ぎ、公開リスクをフロー上で議論しています。board.createElementCommentAsync() と board.createPositionCommentAsync() を使います。
PDF：ページ注釈
PDF は現在、ハイライト、下線、取り消し線、波線、インクによるページ注釈を提供します。保存可能な PDF 注釈オブジェクトであり、上記の返信・解決可能なスレッドとは異なります。例では公開日と検収条件をマークし、旧承認手順を取り消しています。page.insertAnnotation() を使います。
導入方法
フロントエンド：製品のコメントと UI プラグインを登録し、共通と製品固有の /facade エントリーをインポートします。製品のメソッドで対象を紐付け、replyCommentAsync()、updateCommentAsync()、resolveCommentAsync() などの共通 API で議論を操作します。resolved: false で再開します。PDF は専用の注釈 API を使います。
共有の議論：基本の共同編集に加えて Comment Service、Comment Endpoint、独立したデータベースアダプターを導入し、フロントエンドのリモートデータソースを設定します。本文書は内容に追従するアンカーを保持し、Comment Service は本文、返信、解決状態を保存して文書ルームに更新を配信します。コメントパッケージと Comments サンプルを参照してください。
コメント権限は本文編集とは独立して設定できます。アプリケーションの ID とサーバーの認可は権限と認可を参照してください。
このガイドはいかがですか？