クリアコード年表アプリをOutlookのアドインにしました #cc20th

設立20周年を記念するこのイベントではクリアコード年表公開！#cc20thとアナウンスがあったように、コンテンツの1つとして「クリアコード年表」というアプリを公開しています。

「クリアコード年表」は、クリアコードが設立以来どのようにフリーソフトウェアとビジネスを両立してきたかを、タイムラインで表示するものです。

今回、クリアコード年表アプリの機能の一つとして、年表アプリをOutlookのアドイン化して、Outlook上で表示できるようにしましたので、導入方法についてご紹介します。

Officeアドインとは

OutlookのOfficeアドイン開発を紹介したククログ記事でも紹介していますが、Officeアドインとは、マニフェストファイル（XMLまたはJSON形式）+ Webアプリで構成された、Microsoft Office向けのアドインです。マニフェストファイルおよびWebアプリは以下の役割を果たします。

マニフェストファイル
- アドインのメタデータ、UIの拡張ポイント（リボンボタン等）、WebアプリのURLを定義
Webアプリ
- 実際の動作のロジックを提供
- HTTPSサーバー上にホスト
- 内容はHTML/JavaScript/CSSなどで一般的なWebアプリとして作成
- Office.jsを使い、Officeの操作を行う

Officeクライアントはマニフェストファイルを読んで、指定されたWebアプリをロードし、実行します。

クリアコード年表アドインでは、クリアコード年表アプリのサーバー上にアドイン用のWebアプリもホストしています。

Outlookへクリアコード年表アドインをインストールする

以下の手順でOutlookへクリアコード年表アドインを追加できます。

メールサーバーはオンプレミス版のExchange Server、Microsoft 365を含むクラウド版のExchange Onlineのいずれかである必要があります。

インストール方法

マニフェストファイルをダウンロードします
- 以下のURLにアクセスし、マニフェストファイル（cc-20th-anniversary-timeline.manifest.xml）をダウンロードします
- https://20th.clear-code.com/cc-20th-anniversary-timeline.manifest.xml
マニフェストファイルをOutlookにサイドロードします
- https://aka.ms/olksideload にアクセスします
  - Outlook on the webの「Outlook用アドイン」ダイアログが起動します
- 個人用アドイン -> カスタムアドイン -> カスタムアドインの追加から、先程ダウンロードしたマニフェストファイルを追加します
- CC20thTimelineというアドインが追加されます
アドインを起動します
- メールの閲覧時などに、リボンのアドイン -> その他のアプリを開きます
- クリアコード年表アプリがダイアログで起動します

アンインストール方法

マニフェストファイルをOutlookからアンインストールします
- https://aka.ms/olksideload にアクセスします
  - Outlook on the webの「Outlook用アドイン」ダイアログが起動します
- 個人用アドイン -> カスタムアドインの一覧から CC20thTimeline を選択し、「…」（その他のオプション）メニューの「削除」を実行します

さいごに

今回は、クリアコード年表アプリをOutlookのアドインとして導入する方法を紹介しました。マニフェストファイルおよびWebアプリ側の実装のコードは自由なライセンスで公開しています。

ぜひ皆さんのクリアコードにまつわるエピソードを年表アプリにコメントしてみてください。

年表アプリは、https://20th.clear-code.com/ にて公開しています。

また、今回ご紹介したように、クリアコードではOutlook向けのアドイン開発を行っています。 Outlookのアドインの開発・サポートをご希望の場合、お気軽にお問い合わせよりご連絡ください。

申し込みは https://clear-code.connpass.com/event/393654/ から行えます。 ↩

ククログ

Officeアドインとは

Outlookへクリアコード年表アドインをインストールする

インストール方法

アンインストール方法

さいごに

関連情報