Microsoft からの先月末のアナウンスによると、いよいよ既存の（すでに作成済みの）SharePoint Online チーム サイト（クラシック表示）に、Office 365 グループを接続できるようになるとのことで、さっそく試してみたので記録を残しておきます。
アナウンスは、下記のリンク先ですね。
Rolling out: tenant admin tools to connect existing SharePoint team sites to new Office 365 Groups
https://techcommunity.microsoft.com/t5/SharePoint-Blog/Rolling-out-tenant-admin-tools-to-connect-existing-SharePoint/ba-p/188750
それでは実際にやってみましょう。
Microsoft Flow にある SharePoint コネクタを見ていたところ「コンテンツの承認状態を設定します」というアクションを見つけました。はは～ん、これで SharePoint のドキュメント ライブラリに保存されたドキュメントの承認ワークフローを作れば良いんだな？と思い試してみたところ、ちょいと工夫が必要そうだったのでメモを残しておきます。
ちなみに、「コンテンツの承認状態を設定します」アクションのドキュメントは下記のリンク先ですね。
SharePoint – Connectors | Microsoft Docs – Set content approval status
https://docs.microsoft.com/ja-jp/connectors/sharepointonline/#set-content-approval-status
SharePoint Online を利用していると、リストに格納されたアイテムが 5,000 件を超えることも珍しくありません。こうしたリストのアイテムを PowerShell の CSOM で扱おうと思うと、5,000 件の壁にぶつかります。
これは、SharePoint Online からは一度に 5,000 件より多いアイテムを取得できないためです。ではどうするかというと、5,000 件の制限の範囲内で小分けにしてアイテムを取得していきます。ページングというやつですね。
ではさっそくスクリプトを見ていきましょう。
SharePoint Online 管理シェルからサイト コレクションを作成するには、みなさんご存知の通り New-SPOSite を利用するわけですが、つい先日までは、このコマンドでは SharePoint Online のモダン サイトを作成することができませんでした。
そのため、下記の記事のように REST API を利用して作成を試みていたわけです。
SharePoint Online の新しいコミュニケーション サイトは REST API で作成できるらしい
https://idea.tostring.jp/?p=3257
ところが先ほど確認してみたところ、このコマンドでもモダン サイトを作成できるようになっていたのでメモしておきます。
SharePoint Online は、CSOM や REST API の呼び出しにスロットリングが設けられており、頻繁にリクエストを送っているとサーバー側から実行が制限されてしまいます。どのくらいの頻度でリスエストを送ると制限されるのかについては、情報が公開されていないので悩むところではあるのですが…、この制限を超えるとサーバーからは「429」または「503」のコードが返ってきます。
この制限の回避策についてはリファレンスが公開されています。
SharePoint Online で調整またはブロックを回避する
https://docs.microsoft.com/ja-jp/sharepoint/dev/general-development/how-to-avoid-getting-throttled-or-blocked-in-sharepoint-online
回避策のひとつは、制限されることを前提にしたリトライ処理をあらかじめ組み込んでおくことです。PowerShell での実装については、以前に Microsoft のサポートチームがブログで書いてくれていますね。
PowerShell サンプル : SharePoint Online HTTP 調整 (応答コード : 429) 対策の増分バックオフ リトライ
https://blogs.technet.microsoft.com/sharepoint_support/2016/10/08/powershell-csom-sample-code-for-spo-http-429-incremental-backoff-retry/
もうひとつの回避策は、HTTP リクエストに決められた命名規則の User Agent を含めることとあります。リファレンスには「適切に装飾されたトラフィックは、不適切な装飾を施したトラフィックより優先されます。」とあるので、制限される頻度を低くできる可能性があるのだと思います。
というわけで、PowerShell で CSOM を扱うときにどのように User Agent を含めたら良いかについてメモしておきます。
PowerShell を使ってサイト作成を自動化や簡略化しようとした時に、SharePoint Online Management Shell（SharePoint Online 管理シェル）を使うことが多いのですが、どうやらこの管理シェルからはモダン UI の新しいコミュニケーション サイトは今のところ作成できないようです。
なんとかならないかなー？と、検索してみたことろ、どうやら REST API では新しいコミュニケーション サイトを作成する操作が提供されているようで、下記のようなリファレンスを見つけました。
Creating SharePoint Communication Site using REST
https://docs.microsoft.com/en-us/sharepoint/dev/apis/communication-site-creation-rest
というわけで、さっそく PowerShell からこの REST API を呼んでみたいと思います。
この記事は、Office 365 Advent Calendar 2017 に参加しています。
Office 365 Advent Calendar 2017
https://adventar.org/calendars/2585
SharePoint Server 2013 以降や、SharePoint Online の “クラシック UI” のリストで利用できる JS リンクを使って、列に入力された値に応じて行の色を変える方法です。
JS リンクの OnPostRender を利用する方法でイルミネート・ジャパン・ブログさんに記事がありますが、こちらのサンプルではリストのクイック編集モードに対応していないようでしたので、クイック編集モードに対応するように少しだけ書き足してみました。
[SharePoint Online/SharePoint Server 2013] JS リンクでリストビューに条件付き書式設定 | イルミネート・ジャパン ブログ
https://crieilluminate.wordpress.com/2016/01/26/sharepoint-onlinesharepoint-server-2013-js-%E3%83%AA%E3%83%B3%E3%82%AF%E3%81%A7%E3%83%AA%E3%82%B9%E3%83%88%E3%83%93%E3%83%A5%E3%83%BC%E3%81%AB%E6%9D%A1%E4%BB%B6%E4%BB%98%E3%81%8D%E6%9B%B8%E5%BC%8F/
とは言っても、ほんの数行書き足しただけです。
先行リリースの機能として SharePoint Online のモダン リストに新たに追加された Column formatting という機能を試してみました。この機能は、Excel でいうとセルの条件付き書式のような機能となっており、列に入力された値に応じて文字の色を変えたり、アイコンを表示したりといったカスタマイズが行えます。下図のサンプルは、Microsoft さんのものを拝借しました。
こうしたカスタマイズは従来のリストでは JS リンクといった機能を利用して実現できましたが、Column formatting はそれのモダン リスト版となっており、JS リンクと同様に簡単にカスタマイズが行えるようになっています。後述の GitHub に華やかなサンプルがありますが、そのサンプルを迷いなく利用したり、ちょっと手を加えて自分好みにカスタマイズしていくためにも、基礎を抑えながら動作を見ていきたいと思います。
それでは、さっそく試してみましょう。
