ターゲット リリース（旧先行リリース）テナントの『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/
もうひとつの回避策は、HTTP リクエストに決められた命名規則の User Agent を含めることとあります。リファレンスには「適切に装飾されたトラフィックは、不適切な装飾を施したトラフィックより優先されます。」とあるので、制限される頻度を低くできる可能性があるのだと思います。
というわけで、PowerShell で CSOM を扱うときにどのように User Agent を含めたら良いかについてメモしておきます。
SharePoint Online のモダン UI リストやライブラリの機能にも新機能がいろいろと実装されてきていますが、最近新たに実装された「プロパティの一括編集」が便利だったのでご紹介します。
こうした一見地味なのですが、ちょっとした使い勝手の上がる機能は嬉しいですね。
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 に華やかなサンプルがありますが、そのサンプルを迷いなく利用したり、ちょっと手を加えて自分好みにカスタマイズしていくためにも、基礎を抑えながら動作を見ていきたいと思います。
それでは、さっそく試してみましょう。
SharePoint Online では、Office 365 グループに接続されたチーム サイトや、今年登場したコミュニケーション サイトなど、「モダン サイト」と呼ばれる新しい SharePoint のサイトがあります。（従来のサイトは「クラシック サイト」と呼ばれるようになりました）このモダン サイトを利用する場合でも、やはりサイトの色使いとして企業のブランド カラーを反映させたいななどと思われる方もいるかと思います。
こうしたテーマ（色合い）は、モダン サイトにアクセスした状態で「歯車アイコン」をクリックすると、「外観の変更」へアクセスでき、あらかじめ定義されたテーマを選択することができます。
今回はここに独自に定義したテーマを追加してみたいと思います。
オーランドで開催されている Microsoft の年次大型イベントである Microsoft Ignite 2017 に参加しています。オーランドはリゾート地のためか、雰囲気がのんびりとしていて良いですね。さて、初日と 2 日目が終わって、SharePoint 関連のアップデートも数多く（ホントに多くて追いきれない）発表されています。3 日目以降でも、発表された機能の少し詳細な紹介や Deep Dive なセッションが続くのですが、まずは、どういったものが発表されたかを振り返りたいと思います。
すべては紹介しきれませんので、会場での反応が良かったものをまずはざっと紹介していきたいと思います。