検証をしていたところ、SharePoint Designer 2013 で SharePoint Online のサイトを開けなくなる現象にぶち当たったので、その原因と解決策をメモしておきます。
どういう現象かというと、SharePoint Designer 2013 を起動し、「サイトを開く」から SharePoint Online に接続しようとすると下記のような認証要求が表示され、何を入力しても認証要求が繰り返し表示されるというものです。
または、下記のようなエラーが表示されることもあります。
それでは解決策です。
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
ところが先ほど確認してみたところ、このコマンドでもモダン サイトを作成できるようになっていたのでメモしておきます。
ターゲット リリース（旧先行リリース）テナントの『Office 365 グループに接続された SharePoint Online モダン チーム サイト』では、「コネクタ」という分類の Web パーツが利用できるようになっています。「Asana」「GitHub」「RSS」「Stack Overflow」「Trello」「Wunderlist」などのほか、「O365 コネクタ」を選択すると、「Visual Studio Team Services」「Zendesk」「Heroku」「Jenkins」などなど、これまで Office 365 グループや Microsoft Teams で利用できていたような数多くのコネクタを SharePoint のページに追加できるようです。
今回の記事では、その中でも汎用性が高い「Incoming Webhook」のコネクタを試してみます。
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/
（2019/1/23 追記）サポートチームのサンプルに改訂版が出ていました。
[改訂版] SharePoint Online HTTP 調整 (応答コード : 429) 対策の増分バックオフ リトライ
https://blogs.technet.microsoft.com/sharepoint_support/2018/11/09/powershell-csom-sample-code-for-spo-http-429-incremental-backoff-retry-2/
もうひとつの回避策は、HTTP リクエストに決められた命名規則の User Agent を含めることとあります。リファレンスには「適切に装飾されたトラフィックは、不適切な装飾を施したトラフィックより優先されます。」とあるので、制限される頻度を低くできる可能性があるのだと思います。
というわけで、PowerShell で CSOM を扱うときにどのように User Agent を含めたら良いかについてメモしておきます。
SharePoint Online のモダン UI リストやライブラリの機能にも新機能がいろいろと実装されてきていますが、最近新たに実装された「プロパティの一括編集」が便利だったのでご紹介します。
こうした一見地味なのですが、ちょっとした使い勝手の上がる機能は嬉しいですね。