Exchange アカウント間の切り替え時に署名を自動的に更新する

複数の Exchange アカウントを使用する場合のメッセージへの正しい署名の適用が、イベント ベースのアクティブ化機能にOnMessageFromChangedイベントとOnAppointmentFromChangedイベントを追加することで簡単になりました。 OnMessageFromChanged イベントは、構成中のメッセージの From フィールドのアカウントが変更されたときに発生し、OnAppointmentFromChanged イベントは、構成中の会議の開催者が変更されたときに発生します。 これらのイベントにより、署名アドインの機能がさらに拡張され、次の機能が可能になります。

• 各アカウントにカスタム署名を適用する利便性をユーザーに提供します。
• メールボックス代理人が複数のメールボックスからの送信メッセージと会議出席依頼をより正確かつ効率的に管理できるようにします。
• ユーザーのメッセージと予定が、organizationのコミュニケーションとマーケティング ポリシーを満たしていることを確認します。

次のセクションでは、[差出人] フィールドのメール アカウントが変更されたときにメッセージの署名を自動的に更新するように、OnMessageFromChanged イベントを処理するイベント ベースのアドインを開発する方法について説明します。

サポートされているクライアントとプラットフォーム

次の表に、 OnMessageFromChanged イベントと OnAppointmentFromChanged イベントをサポートするクライアントとサーバーの組み合わせを示します。 該当するイベントのタブを選択します。

前提条件

チュートリアルをテストするには、少なくとも 2 つの Exchange アカウントが必要です。

環境を設定する

Office アドイン用 Yeoman ジェネレーターを使用してアドイン プロジェクトを作成する Outlook クイック スタートを完了します。

マニフェストを構成する

イベント ハンドラーを実装する

イベント ハンドラーは、 OnNewMessageCompose イベントと OnMessageFromChanged イベントに対して構成する必要があります。 onNewMessageComposeHandler関数は、既定のメッセージがまだ現在のアカウントで構成されていない場合に、新しく作成されたメッセージに署名を追加します。 [From]\(元\) フィールドのアカウントが変更されると、onMessageFromChangedHandler関数は、この新しく選択したアカウントに基づいて署名を更新します。

1. 同じクイック スタート プロジェクトから ./src ディレクトリに移動し、 launchevent という名前の新しいフォルダーを作成します。

2. ./src/launchevent フォルダーに、 という名前の新しいファイル launchevent.js作成します。

3. コード エディターで ./src/launchevent/launchevent.js ファイルを開き、次の JavaScript コードを追加します。

   /*
    * Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
    * See LICENSE in the project root for license information.
    */
   
   // The OnNewMessageCompose event handler that adds a signature to a new message.
   function onNewMessageComposeHandler(event) {
       const platform = Office.context.platform;
       const signature = "<i>This is a sample signature.</i>";
   
       // On supported platforms, check if a default Outlook signature is already configured.
       if (platform !== Office.PlatformType.Android && platform !== Office.PlatformType.iOS) {
           Office.context.mailbox.item.isClientSignatureEnabledAsync({ asyncContext: { event: event, signature: signature } }, (result) => {
               if (result.status === Office.AsyncResultStatus.Failed) {
                   console.log(result.error.message);
                   return;
               }
   
               // Add a signature if there's no default Outlook signature configured.
               const signatureEnabled = result.value;
               if (signatureEnabled === false) {
                   const event = result.asyncContext.event;
                   const signature = result.asyncContext.signature;
                   setSignature(signature, event);
               }
           });
       } else {
           setSignature(signature, event);
       }
   }
   
   // The OnMessageFromChanged event handler that updates the signature when the email address in the From field is changed.
   function onMessageFromChangedHandler(event) {
       const item = Office.context.mailbox.item;
       const signatureIcon =
       "iVBORw0KGgoAAAANSUhEUgAAACcAAAAnCAMAAAC7faEHAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAAzUExURQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAKMFRskAAAAQdFJOUwAQIDBAUGBwgI+fr7/P3+8jGoKKAAAACXBIWXMAAA7DAAAOwwHHb6hkAAABT0lEQVQ4T7XT2ZalIAwF0DAJhMH+/6+tJOQqot6X6joPiouNBo3w9/Hd6+hrYnUt6vhLcjEAJevVW0zJxABSlcunhERpjY+UKoNN5+ZgDGu2onNz0OngjP2FM1VdyBW1LtvGeYrBLs7U5I1PTXZt+zifcS3Icw2GcS3vxRY3Vn/iqx31hUyTnV515kdTfbaNhZLI30AceqDiIo4tyKEmJpKdP5M4um+nUwfDWxAXdzqMNKQ14jLdL5ntXzxcRF440mhS6yu882Kxa30RZcUIjTCJg7lscsR4VsMjfX9Q0Vuv/Wd3YosD1J4LuSRtaL7bzXGN1wx2cytUdncDuhA3fu6HPTiCvpQUIjZ3sCcHVbvLtbNTHlysx2w9/s27m9gEb+7CTri6hR1wcTf2gVf3wBRe3CMbcHYvTODkXhnD0+178K/pZ9+n/C1ru/2HAPwAo7YM1X4+tLMAAAAASUVORK5CYII=";
   
       // Get the currently selected From account.
       item.from.getAsync({ asyncContext: event }, (result) => {
           if (result.status === Office.AsyncResultStatus.Failed) {
               console.log(result.error.message);
               return;
           }
   
           // Create a signature based on the currently selected From account.
           const name = result.value.displayName;
           const options = { asyncContext: { event: result.asyncContext, name: name }, isInline: true };
           item.addFileAttachmentFromBase64Async(signatureIcon, "signatureIcon.png", options, (result) => {
               if (result.status === Office.AsyncResultStatus.Failed) {
                   console.log(result.error.message);
                   return;
               }
   
               // Add the created signature to the mail item.
               const signature = "<img src='cid:signatureIcon.png'>" + result.asyncContext.name;
               const event = result.asyncContext.event;
               setSignature(signature, event);
           });
       });
   }
   
   // Sets the custom signature and adds it to the mail item.
   function setSignature(signature, event) {
       Office.context.mailbox.item.body.setSignatureAsync(
           signature,
           { asyncContext: event, coercionType: Office.CoercionType.Html },
           (result) => {
               if (result.status === Office.AsyncResultStatus.Failed) {
                   console.log(result.error.message);
                   return;
               }
   
               console.log("Successfully added signature.");
               const event = result.asyncContext;
               event.completed();
           }
       );
   }
   
   // IMPORTANT: To ensure your add-in is supported in Outlook, remember to
   // map the event handler name specified in the manifest to its JavaScript counterpart.
   Office.actions.associate("onNewMessageComposeHandler", onNewMessageComposeHandler);
   Office.actions.associate("onMessageFromChangedHandler", onMessageFromChangedHandler);
   

コマンド HTML ファイルを更新する

1. ./src/commands フォルダーから、commands.htmlを開きます。

2. 既存の スクリプト タグの下に次のコードを追加します。

   <script type="text/javascript" src="../launchevent/launchevent.js"></script>
   

3. 変更内容を保存します。

Webpackの機能設定を更新する

1. プロジェクトのルート ディレクトリから、 webpack.config.js ファイルを開きます。

2. config オブジェクト内のplugins配列を見つけて、配列の先頭に次の新しいオブジェクトを追加します。

   new CopyWebpackPlugin({
     patterns: [
       {
         from: "./src/launchevent/launchevent.js",
         to: "launchevent.js",
       },
     ],
   }),
   

3. 変更内容を保存します。

試してみる

1. プロジェクトのルート ディレクトリで次のコマンドを実行します。 npm startを実行すると、ローカル Web サーバーが起動し (まだ実行されていない場合)、アドインがサイドロードされます。

   npm run build
   

   npm start
   

   注:

   • Yeoman ジェネレーターを初めて使用して Office アドインを開発すると、既定のブラウザーでウィンドウが開き、Microsoft 365 アカウントにサインインするように求められます。 サインイン ウィンドウが表示されない場合、サイドローディングまたはログイン タイムアウト エラーが発生した場合は、npm startをもう一度実行する前に、atk auth login m365を実行します。

   アドインが自動的にサイドロードされなかった場合は、「 Outlook アドインをサイドロードしてテストする 」の手順に従って、Outlook でアドインを手動でサイドロードします。

2. 任意の Outlook クライアントで、新しいメッセージを作成します。 既定の Outlook 署名が構成されていない場合は、アドインによって新しく作成されたメッセージに追加されます。 モバイル デバイスの Outlook では、既定の署名が構成されている場合でも、アドインによってサンプル署名が追加されます。

   

3. 該当する場合は、[ From ] フィールドを有効にします。 有効にする方法のガイダンスについては、「 メール メッセージの送信に使用するアカウントを変更する」の「From ボタンが表示されない理由」セクションを参照してください。

4. [ 元] を選択し、別の Exchange アカウントを選択します。 または、[差出人>その他のEmailアドレス] を選択して、Exchange メール アドレスを手動で入力します。 更新された署名がメッセージに追加され、前の署名が置き換えられます。

   

5. ローカル Web サーバーを停止してアドインをアンインストールする場合は、該当する手順に従います。

   • サーバーを停止するには、次のコマンドを実行します。 npm startを使用した場合は、次のコマンドもアドインをアンインストールする必要があります。

     npm stop
     

   • アドインを手動でサイドロードした場合は、「 サイドロードされたアドインを削除する」を参照してください。

アドインのトラブルシューティング

イベント ベースのアクティブ化アドインのトラブルシューティング方法のガイダンスについては、「 イベント ベースおよびスパムレポート アドインのトラブルシューティング」を参照してください。

ユーザーにデプロイする

他のイベント ベースのアドインと同様に、OnMessageFromChangedイベントとOnAppointmentFromChanged イベントを使用するアドインは、organizationの管理者が展開する必要があります。 Microsoft 365 管理センターを使用してアドインをデプロイする方法のガイダンスについては、「イベントを使用してアドインをアクティブ化する」の「アドインをデプロイする」セクションを参照してください。

イベントの動作と制限事項

OnMessageFromChangedイベントとOnAppointmentFromChanged イベントはイベント ベースのアクティブ化機能を通じてサポートされるため、このイベントの結果としてアクティブ化するアドインにも同じ動作と制限が適用されます。 詳細については、「 イベント ベースのアクティブ化の動作と制限事項」を参照してください。

これらの特性に加えて、アドインがこれらのイベントに対してアクティブ化する場合にも、次の側面が適用されます。

• OnMessageFromChanged イベントはメッセージ作成モードでのみサポートされますが、OnAppointmentFromChanged イベントは予定作成モードでのみサポートされます。
• Outlook on the web、Windows (新規およびクラシック)、モバイル デバイスでは、OnMessageFromChanged イベントのみがサポートされます。
• OnMessageFromChangedイベントとOnAppointmentFromChanged イベントでは、Exchange アカウントのみがサポートされます。 ユーザーが [From or organizer]\(元または開催者\) フィールドで Exchange 以外のアカウントに切り替えた場合、Outlook クライアントは、以前に選択したアカウントによって設定された署名を自動的にクリアします。
• Outlook クライアントに応じて、構成中のメッセージでは、[ 差 出人] フィールドドロップダウン リストから Exchange アカウントが選択されるか、フィールドに手動で入力されます。 モバイル デバイス上の Outlook では、[ From ] フィールド ドロップダウン リストからのアカウントの選択のみがサポートされます。 構成中の予定では、開催者フィールドのドロップダウン リストから Exchange アカウントが選択されます。
• Outlook on the web、Windows (新規およびクラシック) と Mac では、OnMessageFromChangedイベントとOnAppointmentFromChanged イベントは、代理人と共有メールボックスのシナリオをサポートします。 これらのシナリオは、モバイル デバイスの Outlook ではサポートされていません。
• OnAppointmentFromChanged イベントは、Microsoft 365 グループの予定表ではサポートされていません。 ユーザーが Exchange アカウントから開催者フィールドの Microsoft 365 グループ予定表アカウントに切り替えた場合、Outlook クライアントは Exchange アカウントによって設定された署名を自動的にクリアします。
• [開始] または [開催者] フィールドで別の Exchange アカウントに切り替えると、以前に選択したアカウントのアドイン (存在する場合) が終了し、新しく選択したアカウントに関連付けられているアドインが読み込まれると、OnMessageFromChangedまたはOnAppointmentFromChanged イベントが開始されます。
• Outlook on the web、Windows (新規およびクラシック) と Mac では、メール アカウントエイリアスがサポートされます。 現在のアカウントのエイリアスが [From or organizer]\(元またはオーガナイザー\) フィールドで選択されている場合、アカウントのアドインを再読み込みせずに、OnMessageFromChangedまたはOnAppointmentFromChanged イベントが発生します。Emailアカウントエイリアスは、モバイル デバイスの Outlook ではサポートされていません。
• [From]\(開始\) または [開催者] フィールドドロップダウン リストが誤って開かれた場合、または [開始] または [開催者] フィールドに表示されるのと同じアカウントが再選択されると、OnMessageFromChangedまたはOnAppointmentFromChangedイベントが発生しますが、アカウントのアドインは終了または再読み込みされません。

関連項目

• イベントを使用してアドインをアクティブ化する
• イベント ベースのアドインの AppSource リスト オプション