従業員ドキュメント管理 (EDM) FAQ - Support and Troubleshooting

従業員ドキュメント管理 (EDM) FAQ .ns-kb-css-body-editor-container { p { font-size: 12pt; font-family: Lato; color: #000000; } span { font-size: 12pt; font-family: Lato; color: #000000; } h2 { font-size: 24pt; font-family: Lato; color: black; } h3 { font-size: 18pt; font-family: Lato; color: black; } h4 { font-size: 14pt; font-family: Lato; color: black; } a { font-size: 12pt; font-family: Lato; color: #00718F; } a:hover { font-size: 12pt; color: #024F69; } a:target { font-size: 12pt; color: #032D42; } a:visited { font-size: 12pt; color: #00718f; } ul { font-size: 12pt; font-family: Lato; } li { font-size: 12pt; font-family: Lato; } img { display: block; max-width: ; width: auto; height: auto; } } 従業員ドキュメント管理 (EDM) FAQ

従業員ドキュメント管理 (EDM) は、一元化されたストレージスペースとすべての従業員ドキュメントの完全なビューを提供します。 EDM 一括インポート機能は、外部のサードパーティ製クラウドベースのストレージまたはローカルネットワークディレクトリーから従業員ドキュメント管理に従業員ドキュメントをコピーします。インポートに関連する問題が最も多く見られますが、この KB では EDM に関連するすべての問題について説明します。

EDM 製品ドキュメント: https://docs.servicenow.com/bundle/utah-employee-service-management/page/product/human-resources/concept/hr-employee-doc-management.html

一括インポート製品ドキュメント: https://docs.servicenow.com/bundle/utah-employee-service-management/page/product/human-resources/concept/edm-bulk-uploads.html

一括インポート構成/実装ガイド: https://www.servicenow.com/community/hrsd-articles/employee-document-management-bulk-import-functionality/ta-p/2309316

その他の便利なリンク:

EDM Implementation Guidance and Best Practice (記事) EDM コミュニティリソースページ

EDM の一般的な問題と解決策:

1.インポートキャプチャステップが次のエラーで失敗しました:

添付ファイルの作成に失敗しました:HTTP 応答の取得に失敗しました

また、MID サーバーログに次のエラーが表示されます: Unbuffered entity enclosing request cannot be repeated

これは、MID サーバーの「AttachmentSink」API がインスタンスにファイルをアップロードしていない MID サーバー権限の問題である可能性があります。MID サーバーユーザーには、次のロールが必要です:

sn_hr_ef.admin ロール

又は

sn_hr_ef.document_import ロールおよび sn_hr_ef.document_writer ロール

2.インポート検証ステップがエラーで返されます:

構成テストは失敗しました。構成値を変更して、もう一度やり直してください。 エラー:認証情報タグ [sn_hr_ef.file_import] を持つタイプ [SSH パスワード、SSH 秘密鍵] の認証情報が見つかりませんでした

これは、ssh 認証情報が設定/検証されていないか、正しい MID サーバーがインポートで使用されていないことを意味します。

1)sshクレデンシャルが成功したことを確認します-#3:SSH接続関連の問題をデバッグする方法を参照してください

2) ECC キューをチェックして、適切な MID サーバーが使用されているかどうかを確認します (通常、顧客は SSH 構成で MID サーバーをセットアップしています) - これについては、特定の MID サーバーを使用するために必要な変更に関する #4 を参照してください

3.ssh接続関連の問題をデバッグする方法。

「接続できません。ステータスはTCP_CONNECTION_DROPPEDです」というエラーが表示された場合は、次の手順に従ってデバッグしてください

MID サーバーホスト上の opnessh や putty などの SSH クライアントを介して SSH サーバーへの接続を確立してみて、機能するかどうかを確認してください 2.サーバーのセキュリティ ログを調べて、特定の問題を見つけることができるかどうかを確認します。/var/log/secure には良い情報があることが多いです。 3.SSH サーバーでデバッグログを有効にします。openssh の場合、これは通常、/etc/ssh/sshd_config を編集し、loglevel=debug3 を設定し、sshd を再起動することを意味します。次に、「/var/log/secure」のログを確認します 4.mid.ssh.debug=true、mid.log.level=debug を使用してデバッグモードで起動し、問題を再現してから、エージェントログを確認することもできます。MID サーバーデバッグパラメーターの詳細については、以下を参照してください。 https://docs.servicenow.com/bundle/utah-servicenow-platform/page/product/mid-server/reference/mid-server-parameters.html#d2631379e776 5.ポート 22 が開いており、ファイアウォールがポート 22 を許可するように構成されていることを確認します。

4.一括インポートジョブの MID サーバーを指定するにはどうすればよいですか?

1.新しい独自の機能を作成します。

MID サーバー:> 機能 /nav_to.do?uri=%2Fecc_agent_capability_list.do%3Fsysparm_userpref_module%3D0de137980a0006bc653cf70209afd11f%26sysparm_clear_stack%3Dtrue

2.一括インポートに使用する MID サーバーの [機能] 関連リストに新しい機能を追加します。また、MID サーバーから [すべて] 機能を削除します。SSH 機能が追加されていることを確認してください

3.Update ef_LocalFileCapture::findMidServerForConfig メソッド

行 'var serverList = String(new sn_automation.AutomationAPI().selectUpMidServers(null, [host], null)).split(',');' を次のコードで置き換えます

var capabilities = [{機能: 'EdmBulkImport'}]; var serverList = String(new sn_automation.AutomationAPI().selectUpMidServers(null, [host], capabilities)).split(',');

4.[オーケストレーション] から [アクティビティデザイナーアクティビティ] リストから [テスト構成] アクティビティデザイナーアクティビティを更新します > (a) [チェックアウト] ボタンをクリックします (b) [実行コマンド] タブで、[必要な MID サーバー機能] フィールドに [EdmBulkImport] 機能を追加します。 (c) 変更を保存して公開する

5.[オーケストレーション] から [ファイル名を取得] アクティビティデザイナーのアクティビティを更新します -> [アクティビティデザイナーアクティビティ] からリストに移動します (a) [チェックアウト] ボタンをクリックします (b) [実行コマンド] タブで、[必要な MID サーバー機能] フィールドに [EdmBulkImport] 機能を追加します。 (c) 変更を保存して公開する

または

MID 選択基準の新しいアプリケーションを追加し、そのアプリケーションをテストしたい MID サーバーにのみ関連付けることができます。これにより、対応するアプリケーションが関連付けられている MID を選択するための MID セレクターが作成されます。

5.Windows ベースの MID サーバーを EDM インポートに使用できますか?ファイルサーバーはどうですか?

MID サーバーは、Windows または Linux サーバー上に配置できます。OOB の例では、MID サーバーとファイルサーバーはどちらも Linux です。その他の方法やアプローチには、カスタム開発が必要です。

6.保持期間/ポリシーの作成が期待どおりに機能していないようです。ドキュメントが想定どおりに消去されていません。

スケジュール済みジョブの「別のユーザーとして実行」ユーザーには、「sn_hr_ef.admin」ロールが必要です。「sn_hr_ef.admin」ロールを「別のユーザーとして実行」ユーザーに付与すると、スケジュール済みジョブが実行され、消去と通知のフローが正常に機能します。

7.従業員ドキュメントアップロードのカスタム UI ページでは、ドキュメントビューアーを使用した PDF 以外の表示はサポートされていません。

これは拡張です。EDMが最初に開発されたとき(ロンドン)、ドキュメントビューアはPDF形式のみをサポートしていました。

回避策/解決策: 1.他のドキュメントタイプの [表示] ボタンを表示するには、[従業員ドキュメントのアップロード] UI ページで canView プロパティを true に更新する必要があります。

2.この ACl の条件ビルダーにもう 1 つの OR クエリを追加します (a10c0618dbcac4102207f1471d96192f)

table_name= sys_attachment

8.インポートキャプチャステージステップが次のエラーで失敗しました:「ファイルのキャプチャステップを完了できません。エラーの詳細:添付ファイルの作成に失敗しました:HTTP 応答の取得に失敗しました」と表示され、ECC キューに「定義されたセンサーがありません」というエラーが表示されます。

設定されたユーザー (SSH 認証情報のユーザー名) には、アドミンアクセス権が必要です。これは、システム設定を使用して簡単に確認できます。 https://docs.servicenow.com/bundle/utah-employee-service-management/page/product/human-resources/concept/edm-bulk-uploads.html

9.以下は、EDM インポートの問題に関するデバッグのヒントです。

従業員ドキュメントのインポート設定でディレクトリ値を指定する場合、値はホームディレクトリからの相対値である必要があります。完全パスが「~/Documents/import」の場合、ディレクトリの値は「Documents/import」である必要があります 「mid.show.queries」プロパティパラメーターを設定して、MID サーバーのログ記録をオンにします。 詳細はこちら - https://docs.servicenow.com/bundle/utah-servicenow-platform/page/product/mid-server/reference/mid-server-parameters.html#d2430021e1603 MID サーバーログ、エージェントログ、ラッパーログを確認します glide.http.log_debug システムプロパティを追加/オンにする ECC キューを確認します。 ECC キュー レコードには、MID サーバーとの間で送受信されたコマンドに関する情報が含まれています。ECC キューの詳細を読むか、MID サーバーのトラブルシューティングに関するヘルプ情報を参照してください。 https://docs.servicenow.com/bundle/utah-it-operations-management/page/product/discovery/reference/r_DiscoveryStatusECCQueue.html?cshalt=yes https://docs.servicenow.com/bundle/utah-servicenow-platform/page/product/mid-server/reference/r_MIDServerTroubleshooting.html?cshalt=yes

10.インポートキャプチャジョブが「無効な uri」エラーで失敗する

ファイル名にスペースが含まれている場合、キャプチャプロセスで「java.lang.IllegalArgumentException:無効なuri」HTTPエラーが発生し、これらのファイルのECCキュー応答に確認できます。 解決策: KB0965070 から回避策 。 この問題は Paris で発生し、Orlando で修正されています。

11.一括インポートジョブをデバッグするためのヒント:

ファイルサーバーおよびインスタンスとの通信に使用する MID サーバーをセットアップします。 [人事管理 ->一括インポート] -[>インポート構成] に移動します 目的の構成を編集し、[ステージングレコードのステータス] を [準備完了] に設定します その後、ファイルをインポートするには、次の手順に従います。 UI アクション [構成の検証を開始] をクリックすると、認証情報の検証手順と MID サーバーからファイルサーバーへの接続が開始されます 接続に関するエラーが発生した場合は、ステージングステップの前に解決する必要があります。 ステージングステップ:認証情報の検証に合格した場合は、[ジョブのステージングを開始] UI アクションをクリックします。成功すると、このジョブは、転送する準備ができているファイルに関するメタデータを取得します。 ステージングステップが成功した場合は、[キャプチャジョブを開始] をクリックします ここでの注意:ステータスを「準備完了」に変更したため、キャプチャジョブはすべての「準備完了」ファイルを取得し、ファイルサーバー - > MID サーバーおよび MID サーバー - > インスタンスからsys_Attachmentテーブルにダウンロードします。 ジョブが失敗した場合、失敗した各ファイルはエラー状態になり、エラーは右端の [ドキュメントステージング] 関連リスト関連リストで確認できます。

12.一部の従業員ドキュメントレコードの PDF 添付ファイルが自動的に削除されています。

プラットフォームのスケジュール済みジョブ「PDF 生成ユーティリティプラグインによって生成された変換済みドキュメントをクリーンアップ」から PDF 添付ファイルが削除される可能性があります

テーブルに対して次のクエリを実行しますsys_pdf_generation_status 次を含むレコードの場合: 保持期間sys_property「com.snc.documentviewer.retention_days_converted_file」よりも「sys_updated_on」 (デフォルトは 7 日前) 完了の「conversion_status」 および null 以外のconverted_attachment_id 次に、それらの添付ファイルを削除し、「sys_pdf_generation_status」レコードのステータスを「期限切れ」に更新しようとします

回避策: 1)7日前にファイルが削除されないようにするには、保持sys_propertiesの値を増やします:com.snc.documentviewer.retention_days_converted_file。

/nav_to.do?uri=sys_properties.do?sys_id=に移動しますa23429377323230070128f758bf6a733 [値] フィールドを 7 より大きい値に設定します

又は

2) スケジュール済みジョブ PDF 生成ユーティリティプラグインによって生成された変換済みドキュメントをクリーンアップ」を無効にします