SharePoint リストのコメント機能とは？

2020年の11月頃に追加されたSharePointリストの機能です。

アイテムに対してコメントを残すことができて、さらに最近のアップデートでユーザーにメンションする機能も追加されました。

詳しくは TAICHIさんの黒いブログで解説されているのでチェックしてください。

art-break.net

＠メンション

コメントでは＠XXXX の形式で複数のユーザーにメンションすることができます。

メンションされたユーザーにはコメント本文とコメントへのリンク入りで、メール通知が送られます。

※差出人はコメントした人。メールボックスにも送信済みとして入っている。

本題：Power Automate からのコメントとメンション送信

さて、このコメントですが、SharePoint REST API を利用して取得・追加が可能です。

Uriは以下の形式です。

_api/web/lists/GetByTitle('<List Title>')/items(<ItemID>)/Comments()

ここではリストをタイトルから取得していますが、lists(<List GUID>)/items(<ItemID>) でリストとアイテムを特定してもよいと思います。

とにかくポイントとしては、1アイテムに Nコメントなのでアイテムを特定してからコメントにアクセス です。

Power Automate でコメントを操作するためには「Send an HTTP request to SharePoint」のアクションを使います。

取得するだけであれば Method を GET とすればOKです。

普通のコメント

普通の (?) コメントを送信する場合には送信するBodyを以下の形式にします。

{ "text":"Test Comment \n New line"}

改行は \n でも、decodeUriComponent('%0A')でもどちらでも反映されていました。

メンション付きコメント

メンション付きのコメントは少しBodyが特殊です。

{
    "text": "@mention{0} test \n @mention{1} test2",
    "mentions": [
        {
            "email": "chris@example.com",
            "name": "Chris"
        },
        {
            "email": "david@example.com",
            "name": "David"
        }
    ]
}