Document Routing Agent を Windows サービスとして実行する

  • [アーティクル]

Document Routing Agent には、実行モードを選択できるオプションが含まれています。 このプロセスは、デスクトップ アプリケーションまたは Microsoft Windows サービスのいずれかとして実行できます。 アプリケーションは、Windows サービスとして実行されるとき、コンピューターの再起動後に自動的に起動することができます。 また、特定のユーザー アカウントのセキュリティ コンテキストで実行するように構成することもできます。 この機能拡張により、顧客はネットワーク プリント サーバーなどのセキュリティで保護されたドメイン リソースでドキュメント ルート指定エージェントをホストできます。

この記事では、正しい実行モードを選択するのに役立つ重要な情報を提供します。

サービス アプリケーション

アプリケーションはユーザーがデスクトップ上で連携するプログラムです。 サービスは、バックグラウンドで実行され、アクティブなウィンドウを持たないプロセスです。 ドキュメント回覧エージェントは現在、両方の実行モードをサポートしています。 他方ではなくそのモードを選択する理由、およびサービスとしてのプロセスの実行に関連するステップを理解しておくことが重要です。 Windows サービスの詳細については、Windows サービス アプリケーションの概要 を参照してください。 バックグラウンド サービスとしてドキュメント回覧エージェントを実行する主な利点を次に示します。

  • コンピューターを再起動すると自動的にサービスが開始されるように設定できます。 ユーザー操作は必要ありません。
  • サービスは、バックグラウンドで実行されます。 通知領域で実行される有効なアプリケーションはありません。
  • このサービスは、ユーザーがキャッシュされた資格情報を使用してサインインせずに、ドキュメントをルーティングできます。

ドキュメント回覧エージェントを Windows サービスとして実行することには多くの利点がありますが、制限もあります。 次のセクションでは、カスタムのページ マージンを必要とする小切手などのドキュメント レポートの処理に影響する問題について説明します。

カスタム マージンを要求するドキュメント

ドキュメント回覧エージェントが Windows サービスとして実行されるときは、ユーザー設定の余白を必要とする小切手などのドキュメント レポートをネットワーク プリンターに直接印刷することはできません。 代わりに、このドキュメント回覧エージェントは自動的にこれらのドキュメントをターゲット フォルダーに転送します。 アプリケーションの設定ダイアログ ボックスにある新しいコンフィギュレーション プロパティで、カスタム マージンを必要とするドキュメント レポートの対象となる場所を定義できます。

Document Routing Agent は、デスクトップ アプリケーションとして実行されるときは、Adobe Reader の活用を続行して、財務と運用で選択されている共有プリンター デバイスにドキュメントをスプールします。 カスタムの余白を設定したドキュメントを印刷する必要があるシナリオを処理するには、ドキュメント ルーティング エージェントを複数の場所にインストールすることをお勧めします。 デスクトップ アプリケーション モードで実行されるドキュメント ルーティング エージェントでのみ、これらのドキュメントを処理するプリンターをインストールします。 または、実行後のプロセスを使用してターゲット ディレクトリ内のファイルを取得し適切な方法でそれらを指示します。

最新ビルドのインストール

  1. 現在の Document Routing Agent 構成ファイルのコピーを保存します。 このファイルは、C:\Users\<UserID>\AppData\Local\Microsoft\Microsoft Dynamics 365 Finance Document Routing\Microsoft.Dynamics.AX.Framework.DocumentRouting.config にあります。このパスでは、<UserID>は、Document Routing Agent がインストールされた Active Directory Domain Services (AD DS) のユーザー名です。

  2. ドキュメント回覧エージェントの現在のバージョンをアンインストールします。

  3. ネットワーク印刷を有効にするために Document Routing Agent をインストールするの手順に従って、Document Routing Agent の最新バージョンをインストールします。

    メモ

    この時点でアプリケーションをインストールしますが、まだ実行しないでください。

  4. 手順 1 では、構成ファイルをコピーし、次のディレクトリに貼り付けます。c:\ProgramData\Microsoft\Microsoft Dynamics 365 Finance Document Routing。 このステップにより、Document Routing Agent アプリケーションの新しいバージョンに以前のすべての構成設定が使用されていることを保証できます。

  5. Document Routing Agent を実行します。

  6. Microsoft Entra ID (Azure AD) または財務と運用アプリの資格情報を使用してログインします。

  7. 適切なメニュー項目をクリックして、設定およびプリンターを表示して確認します。

次のセクションでは、Windows サービスの実行モードを選択するための詳細な手順を説明します。

既定の実行モードの変更

既定では、ドキュメント回覧エージェントはデスクトップ アプリケーションとして実行されます。 プロセスを Windows サービスとして実行するには、[ドキュメント ルーティング エージェントをインストールしてネットワーク プリンタ デバイスを有効にする] のプロセスに精通していることを確認してください。 その後次のタスクをコンパイルします。

ドキュメント回覧エージェントの実行モードを更新

  1. デスクトップ アイコンを使用してドキュメント回覧エージェントを起動します。
  2. サインイン オプションを選択し、Azure AD 資格情報を使用してログインします。
  3. リボンで、設定を選択します。
  4. Windows Service として実行オプションを有効にします。
  5. ユーザー設定の余白を持つドキュメントに生成される PDF ファイルの対象となるフォルダーを提供します。
  6. OK を選択し、Document Routing Agent ウィンドウを閉じます。

Windows サービスのコンフィギュレーションおよび開始

  1. Windows で、Service Manager を開始します。

  2. 一覧で、Microsoft Dynamics 365 Finance ドキュメント回覧サービスを選択します。

  3. 名前を右クリックし、プロパティ を選択します。

  4. ログオンタブで、この勘定オプションを選択し、サービスを実行するために使用される AD DS 資格情報を入力します。

    メモ

    選択したアカウントは共有ネットワーク デバイスにアクセスできる必要があります。 Windows サービスを実行するのに使用する Windows ドメイン アカウント (またはローカル コンピューター アカウント) は、ドキュメント回覧エージェントのデスクトップ アプリケーションを開始するアカウントと同じである必要があります。

  5. OK を選択します。

  6. サービスを開始します。

ドキュメント回覧エージェントは現在 Windows サービス アプリケーションとして実行されています。

ヒントのトラブルシューティング

ネットワーク プリンターの接続を確認します。

  • 有効なアカウントにネットワーク プリンターへの十分なアクセス権があることを確認します。
  • メモ帳または別のローカル アプリケーションを使用して、ユーザー アカウントがネットワーク デバイスに正常に印刷できることを確認します。

セキュリティ ロールの確認

  • ドキュメント ルート指定クライアントのインストールに使用されるアプリケーション リンクにアクセスするには、ユーザーはドキュメント ルート指定クライアントのセキュリティ ロールの一部である必要があります。

サービス アカウントのアクセス権を確認します。

  • ネットワーク デバイスにアクセスできるドメイン アカウントとして DocumentRoutingService サービスが実行されていることを確認します。

Azure サービス トークンを更新

  • Document Routing Agent が Windows サービスとして実行されている間は Azure 認証トークンを 90 日おきに更新する必要があります。 サービス トークンを更新するには、クライアントを起動し、メニュー項目を使用してサインアウトし、再びサインインします。

リモート アクセス用の共有プリンターを無効にします

  • Microsoft リモート デスクトップを使用してホスト マシンに接続するときは、ローカル リソース タブのローカル デバイスとリソース セクションで、 プリンター オプションがオフになっていることを確認します。

イベント ログを確認

  1. ホスト コンピューターで、イベント ビューアーを開始します。
  2. アプリケーションとサービス ログ>Microsoft>Dynamics>AX-DocumentRouting でログを確認します。