Employee Document Management の一括インポートをソースドキュメントリポジトリで設定する

  • リリースバージョン: Washingtondc
  • 更新日 2024年02月01日
  • 読む20読むのに数分
  • 従業員ドキュメントインポート設定を使用して、ソースドキュメントリポジトリの識別と通信を行います。ソースドキュメントリポジトリは、現在従業員ドキュメントが格納されている場所です。

    始める前に

    必要なロール:sn_hr_ef.admin、sn_hr_ef.document_import

    このタスクについて

    ソースドキュメントリポジトリから従業員ドキュメントを移動する前に、以下の操作が必要です。
    • ドキュメントをプルする元のリポジトリのタイプを識別します。
    • ドキュメントをプルする元のリポジトリから URL と資格情報を識別します。または、ドキュメントをプルする元のディレクトリーを識別します。
    • ソースリポジトリとEmployee Document Management間の通信が確立されていることをテストします。

    手順

    1. 移動先 すべて > HR 管理 > 一括インポート > 構成のインポート.
    2. フォームのフィールドに入力します。
      表 : 1. 従業員ドキュメントのインポート設定
      フィールド 説明
      名前 従業員ドキュメントの一括アップロード設定を識別する、説明的な名前です。
      ソースタイプ 従業員ドキュメントを移動する元のソースを識別します。
      • ローカル:ソースの従業員ドキュメントリポジトリはローカルです。
      • URL:ソースの従業員ドキュメントリポジトリはクラウドベースです。
      ホスト

      [ソースタイプ] から [ローカル] を選択すると表示されます。

      プルする元のローカルソース従業員ドキュメントリポジトリの IP アドレスです。

      ローカルディレクトリーからプルする場合、ソースの IP アドレスは MID Server を経由して接続されます。

      URL [ソースタイプ] から [URL] を選択すると表示されます。

      クラウドベースのドキュメントリポジトリである、ソーススサードパーティの URLです。

      ディレクトリー プルする元のローカルソース従業員ドキュメントリポジトリ内のディレクトリーです。

      ローカルのソースのタイプには、再帰的なディレクトリー構造を指定できます。

      クラウドベースの (URL) ソースタイプのサードパーティには、ルートディレクトリーのみを指定できます。

      注:
      クラウドベースリポジトリのサードパーティに複数のディレクトリーがある場合、それぞれに個別の従業員ドキュメントインポート設定が必要です。[クローンの構成] ボタンを使用すると、簡単にクローンを作成できます。
      ステージングレコードの状態 従業員ドキュメントに挿入される前に、インポートされた従業員ドキュメントステージングレコードに割り当てられたステータスです。
      • ドラフト:従業員ドキュメントに挿入する前に、ステージングレコードを検証できます。
        注:
        マッピング設定を調整する際は、[ドラフト] ステータスをテスト環境でデフォルトとして使用します。[ドラフト] ステータスの従業員ドキュメントは、キャプチャステップで処理する前に、[準備完了] に変更する必要があります。
      • 準備完了:従業員ドキュメントのステージングレコードが正確であり検証の必要がない場合に、このステータスを使用します。発生したエラーは、引き続き解決できます。検証が完了しない場合、ステータスはエラーに変更されます。
        注:
        テスト後にマッピング設定にエラーがない場合、実稼働環境のデフォルトとして [準備完了] ステータスを使用します。[準備完了] ステータスの従業員ドキュメントは、キャプチャステップで自動的に処理されます。
      資格情報エイリアス 資格情報または接続レコードにラベルを付ける、接続と資格情報のエイリアス ID です。資格情報エイリアスは、ローカルソースドキュメントリポジトリへの接続に必要です。

      資格情報エイリアスは、ローカルソースドキュメントリポジトリから設定されます。

      ローカルドキュメントリポジトリにアクセスするための資格情報は、インスタンスに保存され、エイリアスのタグが付きます。

      ドメイン Domain Separation を介して自動で入力され、従業員ドキュメント一括アップロードを設定している特定のドメインを識別します。
      ログマッピング ステージングフェーズ中に、システムログにデバッグステートメントを出力することを示します。

      ログマッピングは、マッピングのデバッグを容易にします。テストフェーズ中に最初に一括インポートを設定する場合に推奨します。

      注:
      資格情報とエイリアスの詳細については、「認証情報、接続、およびエイリアスの概要」を参照してください。

      Domain Separation の詳細については、「ドメイン分離と HR Service Delivery」を参照してください。

    3. [保存]、[送信]、または [更新] を選択します。
      [従業員ドキュメントのインポートソース] タブと [従業員ドキュメントのインポートマップ] タブが表示されます。

    インポート設定の作成または編集

    従業員ドキュメントをインポートするには、ローカルドキュメントリポジトリまたはサードパーティ製のクラウドベースのリポジトリから、Employee Document Management にソース従業員ドキュメントをマップします。

    始める前に

    必要なロール:sn_hr_ef.document_import

    このタスクについて

    ローカルドキュメントリポジトリでは、名前のマッピングは、ファイル名からファイルのメタデータを取得します。

    手順

    1. [従業員ドキュメントのインポート設定] フォームで、[従業員ドキュメントのインポートマップ] タブをクリックします。
    2. [新規] または既存のインポート設定をクリックします。
    3. フォームに入力します。
      表 : 2. 従業員ドキュメントのインポートマップ
      フィールド 説明
      設定 従業員ドキュメントのインポート設定の名前です。「Employee Document Management の一括インポートをソースドキュメントリポジトリで設定する」を参照してください。
      マッピングタイプ ソースドキュメントリポジトリ内のソース従業員ドキュメントを検索する方法を定義します。
      • フィールド:ソースドキュメントに関する情報アレイ内で、マップするアレイの特定部分を識別することを示します。
      • 値:マッピング対象のソースドキュメントに関する情報アレイ内で、特定の用語を識別していることを示します。
      正規表現 ソースリポジトリから含めるファイルを識別する正規表現の文字列です。

      たとえば、(\w+)_(\w+)_(\w+).(\w+) は、英数字、アンダースコア、ピリオドを含むファイル名と一致します。アレイ内の情報の特定部分が識別されると、その部分をマップできます。

      既存の命名規則が一貫しているほど、ソースリポジトリから従業員ドキュメントを見つけやすくなります。

      置換 Employee Document Management にインポートするときに、ソース従業員ドキュメントに含める情報です。
      たとえば、ソース従業員ドキュメントのアレイに学校があるとします。ドキュメントタイプの成績証明書を、同等の新しい値にしようとしています。次のように入力します。
      • 置換:成績証明書
      • マップ済みの要素:docType
      • ソース要素:学校
      注:
      置換する値の定義に正規表現を使用することもできます。正規表現を使用する場合は、正規表現テストサイトを使用して、正しい解析であることを確認します。
      マップ済みの要素 取得するメタデータフィールドと作成された最終ステージングレコードに含まれる値を定義します。

      ソース従業員ドキュメントをマッピングする、インポートドキュメントステージング [sn_hr_ef_import_staging] テーブルのフィールドです。

      ベースシステムでは、ソース従業員ドキュメントをマップできる次のフィールドを提供します。
      • docType:ドキュメントタイプ
      • fileName:ファイル名
      • employee:従業員名
      ソース要素 Employee Document Management にマッピングする、ローカルかサードパーティ製のクラウドベースのリポジトリのフィールドまたは値です。

      たとえば、ソースファイル名に従業員の名前が含まれている場合、従業員の名前をソース要素として使用することができ、従業員のマップ済み要素を使用できます。

      フィルターの正規表現 ソース従業員ドキュメントリポジトリのアレイ内で検出された文字と一致する正規表現のシーケンスです。このフィールドを使用して、ソース従業員ドキュメントの識別を絞り込みます。
      フィルターフィールド 正規表現と一致するファイルがインポートされたときに、ソースリポジトリから返された情報のアレイ内で検出された特定の文字を探します。
      注:
      置換する値の定義に正規表現を使用することもできます。正規表現を使用する場合は、正規表現テストサイトを使用して、正しい解析であることを確認します。

      マップする情報を絞り込むには、このフィールドを使用します。

      たとえば、「first_last_xxx.pdf (abel_tuter_tuition.pdf)」のフォーマットのファイル名を持つファイルのみをインポートするには、以下のようにします。
      • 正規表現:(\w+)_(\w+)_(\w+).(\w+)
      • マップ済み要素:fileName
      • ソース要素:fileName
      • フィルターフィールド:.pdf
      ファイル名の例
      ファイル名の例は、abel_tuter_tuition.pdf です。
      ソースリポジトリからファイル名を検索し、抽出することについては、次の例を参照してください。
      インポートマップ - ファイル名
      インポートマップは、「fileName」というソース要素を探しています。
      インポートマップは、このソース要素を「fileName」というマップ済みの要素に変換しようとしています。
      正規表現は、ファイル名のフォーマット「first_last_xxx.pdf」を探しています。
      従業員名のファイル名の例
      ファイル名から従業員名が抽出されます。従業員名はEmployee Document Managementの要件です。
      インポートマップ - 従業員名
      インポートマップは、「fileName」というソース要素を探しています。
      インポートマップは、このソース要素を「employee」というマップ済みの要素に変換しようとしています。
      正規表現は、ファイル名のフォーマット「first_last_tuition.pdf (\w+)_(\w+)_(\w+).(\w+)」を探しています。
      これは元のファイル名を「first.last ($1.$2)」で置き換えます。
      ドキュメントタイプのファイル名の例
      ファイル名からドキュメントタイプが抽出されます。ドキュメントタイプはEmployee Document Managementの要件です。
      インポートマップ - docType
      インポートマップは、「fileName」というソース要素を探しています。
      インポートマップは、このソース要素を「docType」というマップ済みの要素に変換しようとしています。
      正規表現は、ファイル名のフォーマット「first_last_tuition.pdf (\w+)_(\w+)_(\w+).(\w+)」を探しています。
      これは docType 「tuition ($3)」を作成します。
    4. [送信] または [更新] をクリックします。

    確認のソース手順の作成または編集

    従業員ドキュメントインポートジョブを使用して、検証のソース手順を作成します。検証は、ローカルディレクトリーまたはサードパーティ製のクラウドベースのドキュメントリポジトリと、Employee Document Management の間の接続を検証するために必要です。検証のソース手順は、処理が予定されているソース従業員ファイルがあるかどうかについても確認します。

    始める前に

    必要なロール:sn_hr_ef.admin、sn_hr_ef.document_import

    このタスクについて

    ベースシステムでは、モデルとして使用できる検証のソース手順のサンプルを提供します。

    手順

    1. 移動先 すべて > HR 管理 > 構成のインポート.
    2. 既存のインポート設定レコードをクリックします。
    3. [従業員ドキュメントのインポートソース] タブで、既存の検証のソース手順または [新規] をクリックします。
    4. フォームに入力するか、フォームを編集します。
      表 : 3. 従業員ドキュメントのインポートソース - 検証
      フィールド 説明
      設定 従業員ドキュメントの一括アップロード設定を識別する、説明的な名前です。
      ソースの手順 インポートジョブを構成するインポート手順です。[検証] を選択します。

      検証:従業員ドキュメントのインスタンスとソースリポジトリ (サードパーティ製クラウドベースまたはローカル) 間の接続が正しく設定され、通信が可能であることを確認します。

      インポートタイプ ソースの手順を動作させるインポートタイプです。ソースの手順を動作させる方法を選択できます。
      • サブフロー:インポートステップを動作させる他のワークフローによって起動するワークフローです。「サブフローとして使用されるワークフロー」を参照してください。
      • フローアクション:インポートの手順を動作させる [Flow Designer] アクションです。「Flow Designer」を参照してください。
      • ワークフロー:複数手順のプロセスを提供する自動化の方法です。「ワークフロー」を参照してください。
      • スクリプト:インポートステップの自動化に使用します。「スクリプト」を参照してください。
      アプリケーション インポートソースが使用されているアプリケーションです。
      ドメイン Domain Separation を介して自動で入力され、従業員ドキュメント一括アップロードを設定している特定のドメインを識別します。
      サブフロー

      アクション

      Workflow

      スクリプト

      インポートタイプに基づいてソースの手順を起動する、サブフロー、フローアクション、ワークフロー、またはスクリプトです。たとえば、インポートタイプとしてフローアクションを使用する場合、以前に作成したアクションを選択する [アクション] ドロップダウンが表示されます。
    5. [送信] または [更新] をクリックします。
    6. [開始の構成を確認する] 関連リンクをクリックして検証ジョブを開始します。
      従業員ドキュメントのインポートジョブ タブが表示され、キューに格納 ステータスの検証ジョブがそこに表示されます。
    7. フォームを再ロードして、インポートの手順が検証されたかどうか確認します。
      [検証済み] は、資格情報が正しくディレクトリーが有効なことを示し、ディレクトリー内で検出されたソース従業員ファイルの数を表示します。

    ステージディレクトリールックアップのソース手順の作成または編集

    従業員ドキュメントインポートジョブを使用して、ステージディレクトリーのソース手順を作成します。

    始める前に

    必要なロール:sn_hr_ef.admin、sn_hr_ef.document_import

    このタスクについて

    ステージディレクトリーは、ローカルまたはサードパーティ製のクラウドベースのドキュメントリポジトリからソース従業員ドキュメントを見つけるために必要です。この手順は、解析済みデータを含む各ファイルのファイル名の解析、およびステージングテーブルのレコード作成にマッピングも使用します。

    ベースシステムでは、モデルとして使用できるステージ - ディレクトリーのソース手順のサンプルを提供します。

    手順

    1. 移動先 すべて > HR 管理 > 構成のインポート.
    2. 既存のインポート設定レコードをクリックします。
    3. [従業員ドキュメントのインポートソース] タブで、既存のステージ - ディレクトリーのソース手順または [新規] をクリックします。
    4. フォームに入力するか、フォームを編集します。
      表 : 4. 従業員ドキュメントのインポートソース - ステージ - ディレクトリー
      フィールド 説明
      設定 従業員ドキュメントの一括アップロード設定を識別する、説明的な名前です。

      名前は従業員ドキュメントのインポート構成に由来します。「Employee Document Management の一括インポートをソースドキュメントリポジトリで設定する」を参照してください。

      ソースの手順 インポートジョブを構成するインポート手順です。ステージ - ディレクトリーを選択します。

      ステージ - ディレクトリー:ソースリポジトリからの従業員ドキュメントの場所とマッピングが正しくなるようにします。

      インポートタイプ ソースの手順を動作させるインポートタイプです。ソースの手順を動作させる方法を選択できます。
      • サブフロー:インポートステップを動作させる他のワークフローによって起動するワークフローです。「サブフローとして使用されるワークフロー」を参照してください。
      • フローアクション:インポートの手順を動作させる [Flow Designer] アクションです。「Flow Designer」を参照してください。
      • ワークフロー:複数手順のプロセスを提供する自動化の方法です。「ワークフロー」を参照してください。
      • スクリプト:インポートステップの自動化に使用します。「スクリプト」を参照してください。
      アプリケーション インポートソースが使用されているアプリケーションです。
      ドメイン Domain Separation を介して自動で入力され、従業員ドキュメント一括アップロードを設定している特定のドメインを識別します。
      サブフロー

      アクション

      Workflow

      スクリプト

      インポートタイプに基づいてソースの手順を起動する、サブフロー、フローアクション、ワークフロー、またはスクリプトです。たとえば、インポートタイプとしてフローアクションを使用する場合、以前に作成したアクションを選択する [アクション] ドロップダウンが表示されます。
    5. [送信] または [更新] をクリックします。

    ステージファイルのソース手順の作成または編集

    従業員ドキュメントインポートジョブを使用して、ステージファイルのソース手順を作成します。ステージファイルは、サードパーティ製のクラウドベースのドキュメントリポジトリからのソース従業員ドキュメントをステージングするために必要です。

    始める前に

    必要なロール:sn_hr_ef.admin、sn_hr_ef.document_import

    このタスクについて

    ベースシステムでは、モデルとして使用できるステージ - ファイルのソース手順のサンプルを提供します。

    手順

    1. 移動先 すべて > HR 管理 > 構成のインポート.
    2. 既存のインポート設定レコードをクリックします。
    3. [従業員ドキュメントのインポートソース] タブで、既存のステージ - ファイルのソース手順または [新規] をクリックします。
    4. フォームに入力するか、フォームを編集します。
      表 : 5. 従業員ドキュメントのインポートソース - ステージ - ファイル
      フィールド 説明
      設定 従業員ドキュメントの一括アップロード設定を識別する、説明的な名前です。

      名前は従業員ドキュメントのインポート構成に由来します。「Employee Document Management の一括インポートをソースドキュメントリポジトリで設定する」を参照してください。

      ソースの手順 インポートジョブを構成するインポート手順です。ステージ - ファイルを選択します。

      ステージ - ファイル:ソースリポジトリの従業員ドキュメントの場所とマッピングが正しくなるようにします。

      インポートタイプ ソースの手順を動作させるインポートタイプです。ソースの手順を動作させる方法を選択できます。
      • サブフロー:インポートステップを動作させる他のワークフローによって起動するワークフローです。「サブフローとして使用されるワークフロー」を参照してください。
      • フローアクション:インポートの手順を動作させる [Flow Designer] アクションです。「Flow Designer」を参照してください。
      • ワークフロー:複数手順のプロセスを提供する自動化の方法です。「ワークフロー」を参照してください。
      • スクリプト:インポートステップの自動化に使用します。「スクリプト」を参照してください。
      アプリケーション インポートソースが使用されているアプリケーションです。
      ドメイン Domain Separation を介して自動で入力され、従業員ドキュメント一括アップロードを設定している特定のドメインを識別します。
      サブフロー

      アクション

      Workflow

      スクリプト

      インポートタイプに基づいてソースの手順を起動する、サブフロー、フローアクション、ワークフロー、またはスクリプトです。たとえば、インポートタイプとしてフローアクションを使用する場合、以前に作成したアクションを選択する [アクション] ドロップダウンが表示されます。
    5. [送信] または [更新] をクリックします。
    6. [ジョブのステージングを開始する] 関連リンクをクリックします。
      ステージングジョブは、ソースドキュメントディレクトリーとソースファイルがステージングできることを確認します。[従業員ドキュメントのインポートジョブ] タブが表示され、[キューに格納] ステータスのステージのインポート手順がそこに表示されます。
    7. フォームを再ロードして、ステージのインポート手順が完了されたかどうか確認します。
      [従業員ドキュメントステージング] タブが表示されます。ステージングテーブル内のすべてのソースドキュメントを表示でき、必要に応じて修正することができます。「ステージングテーブルの従業員ドキュメントの修正」を参照してください。
    8. ステータスが [ドラフト] のステージング済みのドキュメントを [準備完了] に変更します。
      ステージング済みのドキュメントを キャプチャ 手順で選択するには、[準備完了] ステータスである必要があります。[ドラフト] ステータスのすべてのステージング済みのドキュメントをチェックし、[選択した行のアクション] から [インポートの準備完了] を選択するか、特定のステージング済みドキュメントを開き、[インポートの準備完了] を選択することで、ステータスを変更できます。

    キャプチャのソース手順の作成または編集

    従業員ドキュメントインポートジョブを使用して、キャプチャのソース手順を作成または編集します。キャプチャは、ローカルまたはサードパーティ製のクラウドベースのドキュメントリポジトリからソース従業員ドキュメントをインポートするために必要です。

    始める前に

    必要なロール:sn_hr_ef.admin、sn_hr_ef.document_import

    このタスクについて

    ベースシステムでは、モデルとして使用できるキャプチャのソース手順のサンプルを提供します。ローカルドキュメントリポジトリの例では、利用可能なサンプルスクリプトを提供します。

    手順

    1. 移動先 すべて > HR 管理 > 構成のインポート.
    2. 既存のインポート設定レコードをクリックします。
    3. [従業員ドキュメントのインポートソース] タブで、既存のキャプチャのソース手順または [新規] をクリックします。
    4. フォームに入力するか、フォームを編集します。
      表 : 6. 従業員ドキュメントのインポートソース - キャプチャ
      フィールド 説明
      設定 従業員ドキュメントの一括アップロード設定を識別する、説明的な名前です。

      名前は従業員ドキュメントのインポート構成に由来します。「Employee Document Management の一括インポートをソースドキュメントリポジトリで設定する」を参照してください。

      ソースの手順 インポートジョブを構成するインポート手順です。

      [検証] を選択します。

      キャプチャ:ソースリポジトリの従業員ドキュメントが Employee Document Management にインポートされるようにします。

      インポートタイプ ソースの手順を動作させるインポートタイプです。ソースの手順を動作させる方法を選択できます。
      • サブフロー:インポートステップを動作させる他のワークフローによって起動するワークフローです。「サブフローとして使用されるワークフロー」を参照してください。
      • フローアクション:インポートの手順を動作させる [Flow Designer] アクションです。「Flow Designer」を参照してください。
      • ワークフロー:複数手順のプロセスを提供する自動化の方法です。「ワークフロー」を参照してください。
      • スクリプト:インポートステップの自動化に使用します。「スクリプト」を参照してください。
      アプリケーション インポートソースが使用されているアプリケーションです。
      ドメイン Domain Separation を介して自動で入力され、従業員ドキュメント一括アップロードを設定している特定のドメインを識別します。
      サブフロー

      アクション

      Workflow

      スクリプト

      インポートタイプに基づいてソースの手順を起動する、サブフロー、フローアクション、ワークフロー、またはスクリプトです。たとえば、インポートタイプとしてフローアクションを使用する場合、以前に作成したアクションを選択する [アクション] ドロップダウンが表示されます。
    5. [送信] または [更新] をクリックします。
      検証の設定とステージングジョブが正常に実行された後、キャプチャジョブを実行します。
    6. [キャプチャジョブの開始] 関連リンクをクリックします。
      キャプチャジョブは、Employee Document Management にソースドキュメントをインポートします。[従業員ドキュメントのインポートジョブ] タブが表示され、[キューに格納] ステータスのステージのインポート手順がそこに表示されます。
    7. フォームを再ロードして、ステージのインポート手順が完了し、ステータスが [完了] になっているかどうか確認します。