SharePoint Online のモダン ページを利用すると、ユーザーが自由にページのレイアウトを作成したり必要な Web パーツを配置したりといったことが簡単にできます。
しかし一方で、何かしら “ちょっと” カスタマイズしたいなと思ったときには SharePoint Framework を利用して Web パーツの作成が必要だったりなど、その “ちょっと” が難しくなってもいます。
従来であればコンテンツ エディタ Web パーツやスクリプト エディタ Web パーツを利用して JavaScript などで “ちょっと” のカスタマイズができたのですが、残念ながらこうした機能はモダン ページでは提供されていません。
というわけで、これはどうにかならないものかなーと思い、調べたり試行錯誤したりと模索しています。
早く使えないかなと期待していた「View formatting」という機能がターゲット リリースのテナントで利用できるようになっていました。機能の日本語名は「ビューの書式設定」のようですね。
これまでも利用できていた「Column formatting（列の書式設定）」は、文字通り「列」の表示形式を JSON により指定できるものでしたが、この「View formatting（ビューの書式設定）」では、リストやライブラリに登録された「行」つまりは「アイテム」の表示形式を同じく JSON で指定できるものになっています。
ちなみに、Column formatting を試したときの記事は下記のリンク先です。
SharePoint Online モダン リストの Column formatting を試してみた
https://idea.tostring.jp/?p=3163
これにより、モダン リストにおけるビューの表現力がグッと高まると思います。さっそく試してみましょう。
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 を呼んでみたいと思います。