従業員ドキュメント管理 (EDM) のトラブルシューティングと FAQ<!-- /*NS Branding Styles*/ --> .ns-kb-css-body-editor-container { p { font-size: 12pt; font-family: Lato; color: var(--now-color--text-primary, #000000); } span { font-size: 12pt; font-family: Lato; color: var(--now-color--text-primary, #000000); } h2 { font-size: 24pt; font-family: Lato; color: var(--now-color--text-primary, black); } h3 { font-size: 18pt; font-family: Lato; color: var(--now-color--text-primary, black); } h4 { font-size: 14pt; font-family: Lato; color: var(--now-color--text-primary, black); } a { font-size: 12pt; font-family: Lato; color: var(--now-color--link-primary, #00718F); } a:hover { font-size: 12pt; color: var(--now-color--link-primary, #024F69); } a:target { font-size: 12pt; color: var(--now-color--link-primary, #032D42); } a:visited { font-size: 12pt; color: var(--now-color--link-primary, #00718f); } ul { font-size: 12pt; font-family: Lato; } li { font-size: 12pt; font-family: Lato; } img { display: ; max-width: ; width: ; height: ; } } 従業員ドキュメント管理 (EDM) および EDM 一括インポート機能に関する一般的な問題をトラブルシューティングします。EDM は、すべての従業員ドキュメントの一元化されたストレージと完全なビューを提供します。一括インポート機能は、外部のサードパーティ製クラウドベースのストレージの場所またはローカルネットワークディレクトリーから従業員ドキュメント管理に従業員ドキュメントをコピーします。 この記事では、一括インポートのトラブルシューティングに焦点を当てて、EDM の一般的な問題について説明します。 この記事の内容: インポートエラー インポートキャプチャに失敗しました:HTTP 応答の取得に失敗しましたインポートキャプチャに失敗:定義されたセンサーがありませんインポートキャプチャに失敗しました:無効な URIインポートの検証に失敗:認証情報が見つかりません 構成 一括インポート用の MID サーバーの指定Windows ベースの MID サーバーの互換性 接続性とデバッグ SSH 接続の問題のデバッグEDM インポートの問題のデバッグのヒント一括インポートジョブをデバッグするためのヒント ドキュメント管理 保持ポリシーがドキュメントを消去しないドキュメントビューアーは PDF 以外のファイルをサポートしていませんPDF 添付ファイルが自動的に削除されました インポートキャプチャに失敗しました:HTTP 応答の取得に失敗しました エラーメッセージ： 「添付ファイルの作成に失敗しました:HTTP 応答の取得に失敗しました」MID サーバーログに「バッファリングされていないエンティティを囲む要求を繰り返すことはできません」と表示されます 原因: これは MID サーバーの権限の問題です。MID サーバー上の AttachmentSink API は、インスタンスにファイルをアップロードできません。 解決策:次のいずれかのロール構成を MID サーバーユーザーにアサインします。 sn_hr_ef.admin ロール または、次の両方を行います。 sn_hr_ef.document_import ロールsn_hr_ef.document_writer ロール インポートキャプチャに失敗:定義されたセンサーがありません エラーメッセージ： 「ファイルのキャプチャ手順を完了できません。エラーの詳細: 添付ファイルの作成に失敗しました: HTTP 応答の取得に失敗しました"ECC キューに「定義されたセンサーがありません」と表示されます 原因:構成されたユーザー (SSH 認証情報のユーザー名) にはアドミンアクセス権がありません。 解決策:SSH 認証情報ユーザーにアドミンアクセス権があることを確認します。検証手順については、「 EDM 一括インポートを参照してください。 インポートキャプチャに失敗しました:無効な URI エラーメッセージ:「java.lang.IllegalArgumentException: Invalid uri」(ECC キュー応答に表示) 原因:ファイル名にスペースが含まれているため、キャプチャプロセスが失敗します。 解決策:この 既知のエラー記事 に記載されている回避策を適用します。 注:この問題は Paris リリースで発生し、Orlando で修正されています インポートの検証に失敗:認証情報が見つかりません エラーメッセージ:「構成テストに失敗しました。構成値を変更して、もう一度やり直してください。エラー:認証情報タグ [sn_hr_ef.file_import] を使用した [SSH パスワード,SSH 秘密鍵] タイプの認証情報が見つかりません 原因:SSH 認証情報が正しく構成されていないか、インポートで正しい MID サーバーが使用されていません。 ソリューション: SSH 認証情報が設定され、機能していることを確認します。「 SSH 接続の問題のデバッグを参照してください。ECC キューをチェックして、正しい MID サーバーが使用されていることを確認します。「 一括インポート用の MID サーバーの指定を参照してください。 一括インポート用の MID サーバーの指定 一括インポートジョブを処理する MID サーバーを指定するには、次のいずれかの方法を使用します。 方法 1: カスタム機能を作成する 新しい一意の機能を作成します。 MID サーバー > 機能 に移動します。(直接 URL:/nav_to.do?uri=%2Fecc_agent_capability_list.do%3Fsysparm_userpref_module%3D0de137980a0006bc653cf70209afd11f%26sysparm_clear_stack%3Dtrue) 一括インポートに使用する MID サーバーに新しい機能を追加します。 MID サーバー レコードを開きます。[機能] 関連リストで、新しい機能を追加します。MID サーバーから [すべて] 機能を削除します。SSH 機能が追加されていることを確認します。 ef_LocalFileCapture::findMidServerForConfig メソッドを更新します。次の行を置き換えます。var serverList = String(new sn_automation.AutomationAPI().selectUpMidServers(null, [host], null)).split(',');でvar capabilities = [{capability: 'EdmBulkImport'}];var serverList = String(new sn_automation.AutomationAPI().selectUpMidServers(null, [host], capabilities)).split(',');テスト構成アクティビティを更新します。 オーケストレーション > アクティビティデザイナーのアクティビティに移動します。テスト構成アクティビティを開きます。[チェックアウト] を選択します。[実行コマンド] タブで、[必要な MID サーバー機能] フィールドに EdmBulkImport を追加します。保存して公開します。 ファイル名を取得アクティビティを更新します。 オーケストレーション > アクティビティデザイナーのアクティビティ に移動します。ファイル名を取得アクティビティを開きます。[チェックアウト] を選択します。[実行コマンド] タブで、[必要な MID サーバー機能] フィールドに EdmBulkImport を追加します。保存して公開します。 方法 2:アプリケーションベースの MID 選択を使用する MID 選択基準に新しいアプリケーションを追加し、使用する MID サーバーにのみ関連付けます。次に、MID セレクターは、対応するアプリケーションを含む MID サーバーを選択します。 Windows ベースの MID サーバーの互換性 EDM インポートに Windows ベースの MID サーバーを使用できますか?ファイルサーバーについてはどうでしょうか? MID サーバーは、Windows または Linux のいずれかで実行できます。デフォルトの構成例では、MID サーバーとファイルサーバーの両方が Linux を使用します。その他の構成にはカスタム開発が必要です。 SSH 接続の問題のデバッグ 「接続できません、ステータスが TCP_CONNECTION_DROPPED」というエラーが表示された場合は、次の手順を使用してデバッグします。 OpenSSH や PuTTY などの SSH クライアントを使用して、MID サーバーホストから SSH 接続をテストします。サーバーのセキュリティログを確認します。/var/log/secureファイルには、多くの場合、有用な情報が含まれています。SSH サーバーでデバッグログを有効にします。 OpenSSH の場合は、 /etc/ssh/sshd_config を編集し、 loglevel=debug3 を設定します。sshd を再起動します。/var/log/secure でログを確認します。 MID サーバーをデバッグモードで起動します。 mid.ssh.debug=true および mid.log.level=debug を設定します。問題を再現します。エージェントログを確認します。詳細については、「 MID サーバーパラメーター (製品ドキュメント) を参照してください。 ポート 22 が開いており、ファイアウォールがポート 22 でのトラフィックを許可していることを確認します。 EDM インポートの問題のデバッグのヒント EDM インポートの問題をデバッグするには、次のヒントを使用します。 ディレクトリパス構成 従業員ドキュメントのインポート設定でディレクトリー値を指定するときは、ホームディレクトリーを基準にしたパスを使用します。たとえば、完全パスが ~/Documents/import の場合は、ディレクトリー値として「Documents/import」と入力します。 ログを有効化 mid.show.queries プロパティパラメーターを設定して、MID サーバーのログ記録を有効にします。詳細については、「 MID サーバーパラメーター」を参照してください。HTTP デバッグログ記録を有効にするには、 glide.http.log_debug システムプロパティを設定します。MID サーバーのエージェントとラッパーのログを確認します。 ECC キューを確認する ECC キューレコードには、MID サーバーとの間で送受信されるコマンドに関する情報が含まれています。詳細については、以下を参照してください。 ディスカバリーステータス ECC キューMID サーバーのトラブルシューティング 一括インポートジョブをデバッグするためのヒント 一括インポートジョブをデバッグするには、次のプロセスを使用します。 前提条件 ファイルサーバーおよびインスタンスと通信するように MID サーバーを設定します。 構成 HR 管理 > 一括インポート > インポート構成に移動します。目的の構成を開きます。ステージングレコードステータス を 準備完了 に設定します。 デバッグプロセス 構成の検証を開始を選択します。これにより、認証情報とファイルサーバーへの MID サーバー接続性が検証されます。続行する前に、接続エラーを解決してください。検証に合格した場合は、 ジョブのステージングを開始するを選択します。これにより、転送の準備ができているファイルに関するメタデータが取得されます。ステージングが成功した場合は、[キャプチャジョブの開始]を選択します。ステータスが [準備完了] に設定されているため、このジョブはすべての準備完了ファイルをファイルサーバーから MID サーバーにダウンロードし、次に MID サーバーからインスタンス (添付ファイル [sys_attachment] テーブル) にダウンロードします。ジョブが失敗した場合は、[ドキュメントステージング] 関連リストを確認します。失敗した各ファイルには、エラーの詳細とともにエラーステータスが表示されます。 保持ポリシーがドキュメントを消去しない 症状:保持期間またはポリシーを作成した後、ドキュメントが想定どおりに消去されません。 原因:スケジュール済みジョブの「別のユーザーとして実行」ユーザーに必要なロールがありません。 解決策:スケジュール済みジョブの「別のユーザーとして実行」ユーザーに sn_hr_ef.admin ロールを割り当てます。このロールを追加すると、スケジュール済みジョブが正しく実行され、消去と通知のフローが想定どおりに機能します。 ドキュメントビューアーは PDF 以外のファイルをサポートしていません 症状: 従業員ドキュメントアップロードのカスタム UI ページでは、ドキュメントビューアーを使用した非 PDF ファイルの表示がサポートされていません。 原因: EDMが最初に開発されたとき(Londonリリース)、ドキュメントビューアはPDF形式のみをサポートしていました。この制限はベースシステムに残ります。 回避策： [従業員ドキュメントのアップロード] UI ページで canView プロパティを true に更新します。これにより、他のドキュメントタイプの [表示] ボタンが表示されます。ACL の条件ビルダーで sys_id a10c0618dbcac4102207f1471d96192f を使用して OR クエリを追加します。 table_name = sys_attachment PDF 添付ファイルが自動的に削除されました 症状:従業員ドキュメントレコード内の PDF 添付ファイルは自動的に削除されます。 原因:プラットフォームのスケジュール済みジョブ [PDF 生成ユーティリティによって生成された変換済みドキュメントをクリーンアップ] によって、これらの添付ファイルが削除されます。 ジョブは、PDF 生成ステータス [sys_pdf_generation_status] テーブルで次の基準を満たすレコードのクエリを実行します。 sys_updated_on が保持期間 (デフォルト: 7 日間) よりも古いconversion_status が完了しましたconverted_attachment_id が null ではありません このジョブは、一致する添付ファイルを削除し、ステータスを期限切れに更新します。 回避策: 次のいずれかのオプションを使用します。 オプション 1: 保持期間を延長する システムプロパティ > すべてのプロパティ に移動します。com.snc.documentviewer.retention_days_converted_fileを検索します。値 フィールドに 7 より大きい数値を設定します。 オプション 2:スケジュール済みジョブを無効にする スケジュール済みジョブの無効化:PDF 生成ユーティリティプラグインによって生成された変換済みドキュメントをクリーンアップします。 関連リンク 製品ドキュメント 従業員ドキュメント管理の概要 EDM 一括インポートの概要 従業員ドキュメント管理の一括インポート機能 (コミュニティ) その他のリソース EDM 実装ガイダンス (コミュニティ)EDM コミュニティリソースページ