鍋綿ブログ

C#・SharePoint・SharePoint Framework・Office365を中心に扱うブログです。

Microsoft Teams向けにViva Connectionsが来たぞー!

2021年3月31日、兼ねてから楽しみにしていたViva Connectionsの設定手順が公開されました!早速試してみましたので機能概要と設定手順をご紹介します。

 

 

機能概要

f:id:micknabewata:20210401152232p:plain

SharePoint ホーム サイトが表示される

Viva ConnectionsはTeamsのアプリになっています。アプリ内にはSharePoint ホーム サイトが表示されます。MicrosoftのページではSharePointのアプリバーが表示されるような説明があるのですが、2021年4月1日時点では表示方法が分かりませんでした。また、ページ上部の検索バーはSharePoint ホーム サイトの検索(= SharePoint全体の検索)機能になると説明されていましたが、今のところTeamsの検索機能のままですね。

設定手順

1. SharePoint Online管理シェルのインストール

後述の2, 3の手順で必要です。

こちらを参照してインストールを行います。

尚、SharePoint Client Component SDKをインストールしているとSharePoint Online管理シェルが実行できない事象がありますのでご留意ください。

2. SharePoint ホーム サイトの設定

Viva Connectionsで表示できるサイトはSharePoint ホーム サイトのみです。

こちらの記事を参照してホーム サイトを設定します。

3. PowerShellスクリプトのダウンロード

こちらからPowerShellスクリプトをダウンロードします。

4. Teamsアプリのパッケージを作成

ダウンロードしたPowerShellスクリプトを実行します。実行には管理者権限が必要です。

例えばコマンド プロンプトを管理者実行で起動し、以下のように行います。

f:id:micknabewata:20210401145650p:plain

実行例

コマンドを実行すると色々と聞かれますので必要な情報を入力します。

f:id:micknabewata:20210401145747p:plain

SharePoint ホーム サイトのURL

f:id:micknabewata:20210401145842p:plain

Teams上でのアプリ表示名

f:id:micknabewata:20210401145945p:plain

Teamsアプリの短い説明

f:id:micknabewata:20210401150020p:plain

Teamsアプリの長い説明

f:id:micknabewata:20210401150052p:plain

個人情報保護ポリシーの提示をするページのURL

f:id:micknabewata:20210401150157p:plain

アプリ利用規約の提示をするページのURL

f:id:micknabewata:20210401150231p:plain

アプリの発行元に表示する組織名

f:id:micknabewata:20210401150344p:plain

アプリの発行元組織の公式ページURL

f:id:micknabewata:20210401150500p:plain

アプリのアイコン画像の選択(192×192と32×32の2サイズ分)

5. Teamsアプリのパッケージをアップロード

PowerShellコマンドの実行が終わるとデスクトップにzipファイルが出来上がります。これをTeams管理センターでアップロードするわけですが・・ちょっと待った!このままだとなんだか2バイト文字が文字化けしてしまいます・・

f:id:micknabewata:20210401150912p:plain

アプリ名が文字化けしている・・

これをTeamsにインストールすると、やっぱりアプリ名が化けていました。これを回避するには、出来上がったzipファイルを一度解凍し、中身のmanifest.jsonファイルの文字コードをUTF8に変え、再度圧縮します。これをTeams管理センターにアップロードします。

f:id:micknabewata:20210401151606p:plain

Teams管理センター > アプリの管理 でアップロード

6. セットアップ ポリシーでユーザーに配布

Teams管理センターのセットアップポリシーでアプリをユーザーに配布します。

f:id:micknabewata:20210401151751p:plain

Teams管理センター > セットアップ ポリシーで配布

 

以上で設定は終わりです。設定が反映されるまでしばらくかかります。

 

設定してみて分かったこと

SharePoint ホーム サイトではナビゲーションをきちんと設定するべき

Viva Connectionsでは、ブラウザやTeamsの戻るボタンで前の画面に戻れません。ナビゲーションをきちんと設定し、すぐに必要なページに移動できるように気を付ける必要があります。

アプリのアイコン(192×192)は白で絵や文字を書き、背景は透過処理するべき

大きいアイコンはTeamsのストアで表示されます。絵や文字は白でないと見づらくなります。画像はpngにし、透過処理をしましょう。

f:id:micknabewata:20210401154134p:plain

黒で書いてしまった例

アプリのアイコン(32×32)は#616161の線画で背景は透過処理すると標準アプリっぽい

標準アプリのアイコンとテイストを合わせると良い感じです。塗りつぶしなしの線画にし、透過処理をするとそれらしくなります。標準アプリの線の色は#616161でした。

f:id:micknabewata:20210401154507p:plain

黒の塗りつぶしにしてしまった例

マニフェストファイルをUTF8にしないと文字化ける

これは設定手順にも書きましたが、PowerShellで作ったままのzipだと文字化けします。。。