| パラメータ名 | データ型 | 説明 | 備考 |
|---|---|---|---|
| CountEnabled | 真偽値 | メール送信前のカウントダウンを有効化する | |
| CountAllowSkip | 真偽値 | カウントダウンのダイアログの「いますぐ送信」ボタンを有効化する | |
| CountSeconds | 数値 | 送信までのカウントダウン秒数 | |
| SafeBccEnabled | 真偽値 | To/CCに一定数以上のドメインが含まれている場合に警告する | |
| SafeBccThreshold | 数値 | SafeBccEnabledで警告対象となるドメインの数 | |
| SafeBccReconfirmationThreshold | 数値 | SafeBccEnabledで再警告対象となるドメインの数 | |
| MainSkipIfNoExt | 真偽値 | 宛先が社内のみの場合は確認をスキップする | |
| AppointmentConfirmationEnabled | 真偽値 | 予定表で予定を送信する場合にも警告する | |
| SafeNewDomainsEnabled | 真偽値 | 返信の宛先に今まで含まれていなかったドメインのアドレスが追加された場合に警告する | |
| DelayDeliveryEnabled | 真偽値 | 遅延送信を有効化する | 確認完了後にメールを下書きに移動し、指定された秒数経過後に送信する。 スケジュール送信で送信日時が指定されていた場合、スケジュール送信の日時を優先する。 |
| DelayDeliverySeconds | 数値 | 送信までの遅延秒数 | |
| FixedParameters | 文字列 | ユーザーによる上書きを禁止するパラメータの一覧 | FixedParameters=CountEnabled,CountAllowSkip のようにカンマ区切りでパラメータ名を指定する 本パラメータ一覧の他に TruestedDomains（社内ドメイン・アドレス） UnsafeDomains（注意が必要なドメイン・アドレス） UnsafeFiles（注意が必要なファイル） が指定可能。 |
- Microsoft 365 developer programへの参加
- https://learn.microsoft.com/ja-jp/office/developer-program/microsoft-365-developer-program
- OutlookのWindowsクライアントもダウンロードしておく
- Adminセンター->Admin->Subscriptions->Microsoft 365 E5 Developer 試用版->Download and install softwareからダウンロードする
- Go
- Node.jsおよびnpm
- Officeアドインのライブラリを配布するCDNのドメインへのアクセス許可を行う（ネットワーク機器などでアクセスが禁止されている場合のみ）
- ドメイン: appsforoffice.microsoft.com
- リポジトリのホームに移動し、
build.batを実行する- アドイン用サイトをビルドする。成果物の静的サイト用ファイルはdistフォルダに作成される。
これは、以下の処理を実行している。
npm install- npmの必要なモジュールをインストール（リポジトリのモジュールが更新された場合には再実行）
nxp webpack- JavaScriptをまとめつつ、リリース用フォルダのdistフォルダに成果物の静的サイト用ファイルを出力する
- リポジトリのホームに移動し、管理者権限のコマンドプロンプトから
build-web-server.batを実行するlocal-web-server-keysフォルダにローカルHTTPSサーバー用の自己署名証明書を作成する。- 自己署名証明書を信頼されたルート証明機関の証明書としてインポートする
local-web-serverフォルダにHTTPSサーバーのexeおよび必要なキーファイルを作成する（local-web-server-keysフォルダからのコピー）
これは、以下の処理を実行している。
実際の処理はbuild-and-import-keys.batおよびbuild-web-server.batを参照のこと。
go run tools\generate_cert\generate_cert.go --host 127.0.0.1- 自己証明書およびサーバー秘密鍵用の作成
copy cert.pem cert.crt- 自己署名証明書をインストール可能な形式に変更
certutil -addstore ROOT cert.crt- 自己署名証明書を信頼されたルート証明機関の証明書としてインポートする
go build tools\https_server\https_server.go
パーソナルHTTPS Webサーバーの仕様は以下の通り。
ファイル名: https_server.exe
引数: --root Webサーバーのルートパスを指定する。デフォルトは.\web
概要: --rootで指定されたパスをhttps://127.0.0.1:10041でホスティングする。
https_server.exeと同じフォルダにkey.pem（サーバー用秘密鍵）とcert.pem（自己署名証明書）が必要。
tests\run-test-serverに移動し、管理者権限のコマンドプロンプトからrun-test-server.batを実行する。
実行すると、以下の処理を実行する。
- アドインの静的サイトファイルを
distに作成 - 自己署名証明書およびサーバー秘密鍵がなければ作成
- 自己署名証明書のインポート
- パーソナルHTTPS Webサーバーのビルド
distをtests\run-test-server\webにコピー- テスト用の設定ファイル
tests\run-test-server\configsをtests\run-test-server\webにコピー - パーソナルHTTPS Webサーバーで
tests\run-test-server\webをホスティング
run-test-server.batを実行中に、src配下への変更をtests\run-test-server\webに自動で反映したい場合、
別のコマンドプロンプトを開き、本リポジトリのルートで以下のnpmコマンドを実行する。
npm run watch:run-test-server
上記のコマンドを実行すると、10秒ごとにsrcの変更を監視し、変更があればリビルドしてtests\run-test-server\webに出力する。
上記コマンド実行時、証明書のインポートを求められた場合はインポートすること。
本アドインが開くダイアログはポップアップウィンドウの形を取るため、Web UIを利用する場合はブラウザーのポップアップブロック機能によってダイアログがブロックされる恐れがある。 ダイアログが確実に開かれるようにするため、事前にポップアップブロック機能の例外を登録しておく。
- Edgeの場合：
edge://settings/content/popupsでhttps://outlook.office.com:443を許可リストに登録する。 - Chromeの場合：
chrome://settings/content/popupsでhttps://outlook.office.com:443を許可リストに登録する。 - Firefoxの場合：
about:preferences#privacyの「許可設定」→「ポップアップウィンドウをブロックする」→「許可サイト」でhttps://outlook.office.com:443を許可リストに登録する。
- 以下のいずれかの方法でアドイン追加ページを呼び出す
- デスクトップアプリ
- 「テスト用にパーソナルHTTPS Webサーバーを起動する」の手順を実施し、Webサーバーを起動する
- Windowsクライアント版のOutlookを起動する
- [ファイル]->[アドインの管理]を選択する
- Webアプリ
- https://aka.ms/olksideload にアクセスする
- デスクトップアプリ
- Webブラウザで[Outlook 用アドイン]ページが開く
- [個人用アドイン]->[カスタムアドイン]->[カスタムアドインの追加]を選択する
- [ファイルから追加]を選択する
flex-confirm-mail-outlook-webリポジトリのFlexConfirmMail.manifest.xmlを指定する- [カスタムアドイン]にFlexConfirmMailが追加される
何らかのメールを送信しようとしたときに「FlexConfirmMail が要求を処理しています」というメッセージや、「FlexConfirmMail」というタイトルのダイアログが表示されれば正しくインストールできている。
なお、現状では、設定用のリボンのボタンなども存在しない。 設定はWebサーバーのconfigsフォルダー配下のファイルを直接編集する。
F12で開発者ツールを開くことができるので、ログやデバッガーで動作を確認する。 アドインのHTMLやJavaScriptが読み込まれるのは、実際にアドインが使用されるときであるのに注意。 例えば、メール送信時のアドインは、メールを送信したときに呼び出される。
FlexConfirmMailの警告ダイアログなど、すべてHTMLで実装されているページについては、F12で開発者ツールを開くことができる。 以降はWeb版と同様にデバッグが可能。
また、以下の手順にしたがい、フレームワークを利用したデバッグをすることも可能。 本プロジェクトの場合、Node.jsでのデバッグとなる。
https://learn.microsoft.com/ja-jp/office/dev/add-ins/testing/debug-add-ins-overview